2022-03-13 RASA实战笔记 -- 第十章 如何阅读rasa源码

一、阅读源码前

  1. 阅读前必须熟悉rasa所用的术语,快速了解术语最佳方式就是阅读文档。熟悉之后,根据名字即可知道代码对象属于什么属于的范畴,不用仔细阅读代码即可知晓代码对象作用。
  2. 如果想知道一个软件是如何工作的,那么必须知道软件是做什么的、怎么操作,有什么输入和产出。
  • ①了解rasa各个模块做什么,怎样操作才能训练和推理,其输入输出包含什么信息
  • ② 找到rasa的系统入口(rasa通过命令行启动训练和推理,因此追踪命令行的实现,即可得到系统入口)
  1. sourcetrail -- 优秀的源代码阅读工具,跨平台,免费开源

二、阅读代码时

  1. 确定本次阅读源码的目标是什么?
  • 为了解决一个棘手的bug?
  • 扩展rasa系统?
  • 学习rasa的设计?
  1. 解决棘手bug:建议定位到具体出错的源码,搞清楚出错的代码的功能,通过调试确定出错原因,如果必要追溯至调用链
  2. 扩展rasa系统:建议首先阅读待扩展组件的调用者代码:有哪些调用者,分别调用了这类组件的哪些接口,这些接口的输入和输出是什么;然后阅读官方组件的实现源码,确保详细掌握了每个接口的作业
  3. 学习rasa的设计:建议多次反复阅读源码,逐次细化地阅读源码。
    第一次阅读源码从系统入口开始,按照非常粗的力度了解整个系统的工作流程是怎么样的调用链,其中有哪些关键的综合类,以及他们的作用。
    以后每次阅读都进一步阅读上一次没有设计的关键类,了解其内部大概的实现方式。
    由于我们的目的是学习架构设计而不是学习源码细节,因此对于同一种组件,只选择其中最简单或最具代表性的实现类进行阅读。
    另外有些组件是由深度学习算法实现的,需要结合论文才能理解,因此不建议阅读,阅读其中最简单的实现类或基类即可。
    如果遇到难以理解含义或实现过程的源码,可以通过关联这段源码的测试代码快速了解该源码的输入输出,进而理解其作用,及其工作原理。

三、阅读代码后

可以尝试在纸上或脑中回忆源码的流程,争取能够脱离源代码独立地描述清楚源码的逻辑。
在此基础上可以反思为什么官方要这样设计?优点、缺点?如果是自己设计,那些事没有考虑到的?

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,125评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,293评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,054评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,077评论 1 291
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,096评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,062评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,988评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,817评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,266评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,486评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,646评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,375评论 5 342
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,974评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,621评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,796评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,642评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,538评论 2 352

推荐阅读更多精彩内容