yogeek/dsh-plugin-toggle

dsh-plugin-toggle

直接从 Settings > Plugins → Toggle 启用或禁用 DeepSeek Harness（dsh）插件，并按可折叠分类分组——不再需要手动编辑 cordis.patch.yml 并寻找正确的行。

非官方社区插件。 与 DeepSeek 无关联，也未获其认可。依据
deepseek-harness 的 CONTRIBUTING.md 分享，
该文档明确鼓励独立插件，而非向上游提交 PR（当前阶段不接受）。
dsh 本身仍处于开发者预览阶段——预计本插件依赖的内部实现会发生变化。

功能

- 在内置的 Plugin list 和 Plugin configuration 标签页旁新增一个 Toggle 标签页。
- 当前插件树组合出的每个插件都会获得一个开关，反映其实际状态
（经过所有 bundle 层和 patch 覆盖之后），并按约 11 个可折叠分类分组
（Core & Runtime、LLM & Credentials、Agent Loop、Tools、Sandbox & Permissions、Session & Storage、
Client UI 等），而不是一个长长的扁平列表。
- 切换开关时：
1. 将该插件的显式 disabled: true|false 行持久化到托管区域，
该区域追加在 profile 的 cordis.patch.yml 末尾——你在其上方的自有行和注释
绝不会被改动，而空区域会被完全移除。
2. 立即将更改应用到实时 Loader 树（ctx.loader.update），因为
web profile 默认禁用了 patch 文件热重载——切换无需重启。
- 分类默认折叠；状态按浏览器记忆（localStorage）。搜索时
仅自动展开有匹配项的分类。

安装

dsh 目前还没有插件注册表——像安装任何本地/树外插件一样安装：

git clone https://github.com/yogeek/dsh-plugin-toggle.git ~/.dsh/plugins/dsh-plugin-toggle

make it resolvable from the profile (same trick the harness itself uses for its
own installation-owned packages — see ~/.dsh/profiles/node_modules for reference)
ln -sfn ~/.dsh/profiles/node_modules ~/.dsh/plugins/node_modules

将其添加为你希望使用它的 profile（通常是 web）的链接依赖：

cd ~/.dsh/profiles/web
npm pkg set dependencies.dsh-plugin-toggle="link:$HOME/.dsh/plugins/dsh-plugin-toggle"
ln -sfn ../../../plugins/dsh-plugin-toggle node_modules/dsh-plugin-toggle

在该 profile 的 cordis.patch.yml 中注册它：

- insert:
- id: plugin-toggle
name: 'dsh-plugin-toggle'

重启一次 dsh web（加载新插件所需——web profile 不会热重载
cordis.patch.yml）。此后，切换即可实时生效，无需再重启。

工作原理

- Host 部分（lib/index.js）：一个 pluginToggle Remote 服务（TypertRemoteService），
由 dsh 的 Typert 网关通过其 SRC 标记自动发现——无需代码生成，无需重新构建
的 harness。list() 返回 profile patch 直接组合的每个条目（嵌套的
agent-preset 副本和没有稳定 id 的动态创建条目会被排除——见
已知限制）；set({ entryId, enabled }) 写入受管理的 patch 行并实时应用，
如果实时树拒绝该变更，则回滚该行。
- 浏览器部分（lib/client.js）：一个手写的 dsh.client bundle（harness 的懒加载 CJS
模块格式），贡献一个 settings.plugins.tab 插槽条目，通过现有的 /api 连接 RPC 通道
调用 Remote——不需要生成的 remote 产物或 zod schema。

已知限制

- 两个条目共享相同的原始 id 但位于不同的树深度时会被排除，而不是合并。
agent preset 内联挂载的插件（例如 include:agent-presets:tool-bash）与顶层的
include:tool-bash 是不同的 Loader 条目，仅共享模块名。切换其中一个永远不会
静默影响另一个——Toggle 标签页只列出并且只能写入由 cordis.patch.yml 顶层直接
组合的条目；其余条目会被省略，而不是显示为损坏状态。
- 被切换的条目会保持固定，由其受管理的行固定，即使底层 bundle 组合之后发生变化。
从 cordis.patch.yml 的受管理区域删除该行即可回退到组合默认值。
- 分类规则是基于条目 id 的客户端启发式规则（见 lib/client.js 中的
CATEGORY_RULES），并非来自 harness 的权威分类法。已针对真实的约 139 个条目的
web profile 组合进行测试；如果某些内容分类异常，请针对你自己的组合调整规则。
- 受保护的条目（include、plugin-toggle 本身）无法从 UI 切换。

兼容性

基于 @deepseek-ai/dsh 0.1.1-rc.1（开发者预览版）构建并测试。Remote
发现机制、loader 的 patch 语义以及 settings.plugins.tab 插槽契约
都是内部 API，目前没有稳定性保证——未来的 dsh 版本可能需要在此处进行更改。
欢迎针对本仓库提交 issue 和 PR。

许可证

MIT——见 LICENSE。