DeepSeek Harness(DSH)采用“一切皆插件”的架构,插件生态丰富但也带来了管理上的复杂性。开发者经常需要在 Web 设置界面中区分官方内置插件与用户自行安装的第三方插件,并对它们进行配置。dsh-lightweight-plugin-enhance 是一个为此场景设计的轻量级管理增强插件。
插件定位¶
本插件由 Feng-jsy 维护,采用 MIT 许可证。它主要解决 DSH 插件列表混乱的问题,在 Web 设置中清晰划分官方插件与第三方插件,并提供一键启停第三方插件的能力,同时保持核心系统的纯净。
核心功能¶
- 官方与第三方分类:系统会自动识别官方插件(作用域为
@deepseek-ai、cordis:include根组合条目、cordis:group)与第三方插件(用户通过dsh plugin add安装)。 - 分组与筛选:界面提供“全部 / 官方 / 第三方”的筛选标签,并实时显示各组的插件计数,配合搜索框使用。
- 一键启停(仅限第三方):对于第三方插件,展开卡片可查看完整模块名与 Loader 条目 ID。通过卡片上的开关,可以启用或停用插件。
- 配置生效机制:开关操作不会修改核心配置,而是直接写入用户补丁层
cordis.patch.yml。配置变更通过 HMR 约一秒后重组合,无需重启宿主服务。 - 安全与自保护:官方插件行一律拒绝开关(宿主侧判定);本插件自身也禁止开关,防止管理面板随插件一起消失。插件路由仅允许本地回环访问。
安装与启用¶
前置要求:DeepSeek Harness (DSH) 版本需 ≥ 0.1.0-rc.6。
执行以下命令安装插件:
dsh plugin --profile web add dsh-lightweight-plugin-enhance
安装后,重启 DSH 服务以加载宿主侧代码,随后刷新 Web 页面,进入 设置 -> 插件 -> 轻量插件增强 即可使用。
典型用法¶
- 进入 Web 界面的设置页面。
- 在插件列表中找到并点击“轻量插件增强”。
- 使用顶部的筛选器(如“第三方”)查看非官方插件。
- 点击任意第三方插件卡片上的开关进行启用或停用,页面刷新后配置即刻生效。
注意事项¶
- 版本兼容:必须满足 DSH ≥ 0.1.0-rc.6 才能正常工作。
- 权限与安全:该插件以当前 DSH 进程的权限运行,请确保信任其源码与许可证。路由
/plugin-enhance/*仅限本地回环访问。 - 宿主变更:插件自身的宿主代码变更需要重启服务,仅客户端(HMR)变更可刷新页面。
生态背景¶
本插件属于社区插件,与 DeepSeek 或幻方官方无从属关系。更多细节可参考 GitHub 仓库。