夜雨聆风学习资料网

ARTICLE · 1366810

一切皆插件:改 DSH 的界面,为什么不用动源码

一切皆插件:改 DSH 的界面,为什么不用动源码

这两天基于 DSH 装了两个插件:DS Bot 和 Tobs。装完界面全变了,最开始下载的那份源码一行没动。

简单说,DS Bot 把界面换成了一套 Bot 工作台;Tobs 是在原生界面旁边加了一个 Bot 模式。两个都没碰源码。

「一切皆插件」这句话,真不是说说而已。

下面把它拆开讲清楚:从下载到跑出默认页面,再到装上插件,中间到底发生了什么。

一开始下载的,是一份能跑的引擎

DSH 下载下来是一份运行时,包含引擎和一份默认的 Web 界面。没有编译步骤,装完就能跑。

我把它放在 /opt/dsh。这是一份完整的东西,机器上装一次就够了,所有实例共用。

第一次运行,生成了什么

第一次运行它,会在用户目录下生成一个数据目录(默认叫 .dsh,也可以指定成别的路径)。

这个目录里大致是这些:

▸ profiles/:装配清单。每个实例一份,清单上写着加载哪些包;后来装进来的插件也放在这里

▸ sessions/:所有对话记录

▸ storages/:界面状态、工作区信息这类数据

▸ .credentials.yaml:模型密钥、cookie 签名密钥

▸ attachments/、cache/:附件和缓存

清单里只写两件事:这个实例要加载哪些包,哪些配置需要覆盖。

这里已经埋下了关键:运行时在 /opt/dsh,是固定的;清单在各自的数据目录里,是一份一份的。同一份运行时,可以配出好几个互不影响的数据目录,也就是好几个实例。

跑出默认页面时,发生了什么

启动时,程序读清单,按顺序把包加载起来:先是基础引擎,再是 Web 界面,最后是清单里列出的其它插件。加载完,起 HTTP 服务,浏览器打开就是一个能对话的经典页面。

这个页面看起来是「默认界面」,其实不是一块写死的 HTML。

它是由一组界面插件拼出来的:侧边栏是一行,设置页是一行,对话区是一行,每一行都有自己的编号。默认页面,只是这些行按默认方式装配的结果。

这就是后面一切的基础:既然每一块都有编号,就可以被替换。

加插件时,发生了什么

给 DS Bot 或 Tobs 这类插件,安装只有两步:把包装进数据目录,往清单里加一行。

但插件不是「运行时才想起自己该出现」。每个插件包自带一层补丁,声明三件事:我要不要把某一行的编号禁用掉,要不要插入自己的行,要不要覆盖某些配置。

启动时,这些补丁按顺序叠起来:插件包自带的一层,实例清单的一层,我自己的偏好再一层。叠完之后才真正加载。

所以,安装一个插件,本质上不是「往程序里塞代码」,而是「在装配清单上再加一条规则」。

一个插件,可以做到三种程度

这是最值得说的部分。同一个插件机制,能长出三种完全不同的形态。

一、在默认界面上加一个入口。

不动任何原来的一行,只插入自己的一个按钮或面板。点进去是自己的界面,退出来还是原来的 DSH。Tobs 的「Bot 模式」就是这种。

二、另外部署一套。

插件自带完整的前端,配上自己的数据目录和端口,跑起来就是另一个产品。原来的默认界面照旧,两者互不干扰。DS Bot 单独一个实例,就是这种。

三、直接把默认页面改掉。

把原生某一行的编号禁用,换成自己的行。设置页、侧边栏都可以这样被接管。原来的代码仍然在包里,只是被配置关掉了,没有删除。DS Bot 在自己的实例里就是这么干的。

同样是装一个插件,可以只借一张桌子,也可以另开一家店,还可以把店面重新装修。

所以,为什么不用动源码

因为改的不是源码,是装配:界面是插件,配置是补丁,引擎只负责把清单上的东西按顺序装起来。

源码在里面是什么角色?它只是被加载的那个包。你改的是「加载什么、怎么覆盖」,不是「包里面长什么样」。

这就是「一切皆插件」的实际含义:引擎不动,装配可变。

代价也得说清楚

一是约定会变。你的补丁按行编号和插槽去认位置,上游哪天改名或者重构,配置就失效,得跟着改一次。这不是代码冲突,是约定失效。

二是侵入越深,越要隔离。只加入口的插件,可以跟别的东西共处;把外壳整个换掉的插件,最好单独一套,否则两个都要抢同一个位置。

有些时候,源码还是得动

大部分改动停在清单和补丁里就够了,但也有绕不过去的时候。

比如为了用起来方便,我让 DSH 直接给我生成了 App 安装包——一个 WebView 壳,打开就进界面。这一步动到了前端的构建产物,它不在装配清单里,属于源码那一侧。

代价也很直接:升级会被覆盖,得重新打一次。

但这类事是少数。加插件、换界面、接渠道,绝大多数需求都在清单这一层解决。

至于具体怎么配置、怎么用,细节不在本文展开。

有兴趣的人可以自己去了解。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料