插件类型
- 插件管理(桌面端)
- 官方插件页
- 插件市场(dsh-market)

- 桌面壳插件管理不同于官方插件页,即使在应用崩溃也依旧可以处理插件的异常情况,进行卸载与删除/禁用
- 插件市场仅在安装预设插件(dsh-market)后显示,如初始化未选择,可在桌面端插件管理弹窗中出现打开预设
可选预设
预设不计入内置插件数量,也不保证适合每个任务。安装前检查维护状态、网络依赖和数据处理方式。DSH Market 等预设通过首次运行向导或插件管理的专用安装流程安装,不是向聊天 Agent 发出安装请求。
本地插件与热重载
除了从 npm 或 GitHub 安装,插件面板还能直接挂载本机的插件源码目录,适合自己开发或正在改动的插件。- 在配置 → 插件点击安装框右侧的文件夹按钮,选择包含
package.json的插件目录。 - 面板把该目录回填成
link:开头的绝对路径 spec,先给出只读预检结果,点安装后写入活动档案。 - 安装成功后按提示重启 Harness,让本地插件随档案加载。
link: 或 file: 前缀、盘符绝对路径、UNC 路径,以及 ./、../ 相对路径都按本地目录处理;相对路径以托管 dsh 的安装目录为基准。多个 spec 用逗号或空白分隔可一次安装。
本地目录安装写进档案的是
link: 声明,插件源码仍留在原位置。移动或删除该目录会让插件在下次启动时加载失败。cordis.hmr.patch.yml,再以 --patch 注入核心自带的 HMR 插件;源码改动后由核心卸载并重新加载该插件,无需重启服务。
- 只监听通过本地路径安装的插件,npm 或 GitHub 安装的插件不在其中。
- 改动开关后需要重启服务,才会重新计算监听目录。
- 没有已挂载的本地插件目录时面板会提示,且不写入补丁层。
node_modules、隐藏目录,以及cache、data目录不会被监听。
安装、更新与恢复
- 打开桌面配置 → 插件,确认活动档案、来源、版本和错误信息。
- 安装可信插件,或升级、移除不再需要的可选插件。
- 按提示重启 Harness,确认插件加载成功。
- 操作中断时使用面板显示的恢复入口;内置插件缺失时由桌面端修复。
0.2.0-rc.2,最低接受 0.1.5-rc.1;实际可选内核和插件版本仍受兼容规则限制。启动异常先保留日志,再使用明确的恢复入口,见故障排除。
开发者可阅读插件系统架构。
