pure-craft/dsh-capability-panel

dsh-capability-panel

npm CI license

看清你的 DeepSeek Harness agent 此刻真正能触达什么——并且随时开关，按会话或按 preset。

一个面向当前对话能力面的面板：每个技能、每个 MCP 服务器、每个系统工具，都有真实的“在不在上下文里”状态，和一个从下一步模型调用就生效的开关。

会话中的能力面板:技能带加载状态、MCP 按服务器分组、每行一个开关

速查(agent 快速参考)

| | |
|---|---|
| 是什么 | DeepSeek Harness(dsh)的 web 插件:一个面板,列出当前会话的技能、MCP 服务器、系统工具及其真实的在不在上下文状态,并能逐项开关 |
| 什么时候用 | 回答“为什么 agent 不知道这个技能”;看一个加载过的技能是否挺过了剪枝/压缩;只在当前会话里关掉某个工具或 MCP 服务器;为 preset 设置默认能力集合;统计关闭后被拦截的调用次数 |
| 安装 | dsh plugin --profile web add dsh-capability-panel(然后重启 dsh) |
| 要求 | dsh web profile,dsh ≥ 0.1.2-alpha.4(更早版本可运行,但加载状态降级显示);@deepseek-ai/ peer 全部由宿主提供 |
| 数据 | $DSH_HOME/settings.yaml 的 capability-panel 命名空间;统计在 $DSH_HOME/capability-panel/stats.jsonl;loopback API /api/capability-panel |
| 包 | npm 上的 dsh-capability-panel;bundle id capability-panel |

为什么

技能“装好了”和技能“此刻在模型的上下文里”是两件事——而只有后者能回答“为什么 agent 不知道这个”。两者之间隔着上下文管理：工具结果剪枝器会截断过长的返回，压缩会把整段历史换成一条摘要。你眼看着五分钟前加载过的技能，可能已经部分或全部离开了模型的视野，而它的加载记录还永久躺在日志里，假装一切如常。

有时你也只是想让模型在这一个对话里别再碰某个工具——不是卸载插件，不是改配置文件重启，就只是这一个会话、从下一步开始。

这个插件把这两件事变成输入框右侧的一个面板。

功能

- 真实的加载状态。 每个技能报告的是模型在下一次请求里实际能看到什么：已加载（完整指令在上下文里）/ 已截断（剪枝器留下首尾、挖掉中间）/ 已挤出（被压缩整体吞掉）/ 未加载——外加累计加载次数，被挤出后重新加载的技能读作“已加载 ×2”。
- 重启不丢的会话级开关。 关掉当前会话里的一个技能、一个工具或一整个 MCP 服务器：从下一次提示组装生效，重启 dsh 后随该会话恢复，且绝不碰其他会话、绝不动对话历史。
- Preset 默认。 设置 → 能力面板，为每个 agent preset 存一份默认能力集合；之后新建或恢复的会话继承它。与会话面板同一套筛选、分组和开关——preset 默认只是起点，会话里仍然可以覆盖。
- MCP 按服务器分组。 两个服务器挂着两百个工具也能扫得过来：折叠成每服务器一行，一次开关整组。
- 离线服务器照常列出。 宿主配置里声明了、但当前没注册任何工具的 MCP 服务器（比如没启动的本地按需服务）仍会显示一行——如实标注「无已注册工具」，列出已存的关闭项，并附一个「重载」按钮立即重试连接。会话中途才注册上来的工具也会自动继承已存的默认。
- 按来源分组。 技能和 MCP 服务器在带标签的分隔线下聚类：preset 自带的条目标注它来自哪个 preset，其余显示真实目录（~/.dsh/skills、项目相对路径，过长时中间省略）——“这个技能是从哪来的”一眼即有答案。
- 一键打开源文件夹。 悬停分组分隔线会出现文件夹图标，点击即在系统文件管理器中打开该来源目录（macOS、Windows 和 freedesktop Linux）。
- 拦截计数。 模型在你关掉某项之后仍然尝试调用，面板会计数——这是“模型在凭记忆行动、开关需要更响亮的告知”的信号。
- 一键填入命令。 技能行上的纸飞机按钮把 /skill-name 放进输入框，等你自己的回车。
- 快速筛选。 按名称、描述或状态文案匹配（搜“已截断”或“truncated”都可以），命中时描述自动展开。
- 轻量。 零运行时依赖、零拷贝读取、无后台工作——面板只在打开时读一次。
- 跟随界面语言。 面板文案随宿主在中英文之间切换。

工程品质

- 测试完备:390+ 测试,typecheck + 类型感知 lint + 100% 覆盖率门槛(语句/分支/函数/行)在 CI 上对每次 push 和 PR 强制执行。
- 失败诚实:任何一环读不到(技能注册表、会话视图、设置存储),面板显示部分数据加明确的降级提示——绝不把“读失败”伪装成“列表为空”。
- 写入不竞态:preset 默认和会话开关共享一条串行写队列,两个面板同时写也互不覆盖。
- 不拖累宿主:agent 创建监听做了完整的失败隔离——插件的任何异常都不会阻止你的会话启动。
- 本地优先，零网络:数据路由只接受 loopback,插件没有外呼、没有遥测、没有第三方服务——所有状态只留在本机的 settings.yaml 和一个 JSONL 里。
- 长会话依然秒开：6 万事件、几十 MB 日志的会话上，面板即点即开：零拷贝 surface 直读，打开时才读一次，没有轮询和后台任务。
- 历史保留式开关：开关永不改写对话历史——被关掉的能力在日志里原样保留，“已关闭”告知在每次组装时现算。每个开关都是可后悔的决定，不是不可逆的手术。
- 只走官方扩展点：全部能力来自 dsh 的正式接缝（tools.restrict、system-prompt/assemble、settings 命名空间、UI slots），没有猴子补丁，宿主升级时更不容易碎。
- 主题免费：颜色全部走宿主 design token，图标用宿主图标库——浅色/深色、语言切换都自动跟随，不需要自己维护主题。
- 国际化友好：面板文案跟随宿主界面语言（中/英），文档四种语言逐节对齐。

安装

从插件市场，或直接从仓库安装：

dsh plugin --profile web add dsh-capability-panel
或
dsh plugin --profile web add github:pure-craft/dsh-capability-panel

安装后需要重启 dsh 才生效。

要求 DeepSeek Harness 的 web profile（dsh web），dsh ≥ 0.1.2-alpha.4（加载状态经由该版本引入的 session.snapshotEvents 读取；更早版本面板仍可运行，加载状态降级显示并在 payload 中注明）。所有 @deepseek-ai/ 运行时件都由宿主以 peer 依赖形式提供——没有别的要装。

安装即用，不需要任何配置——插件没有配置项。重启后你会在两个地方看到它：

- 任意对话输入框右侧的上下文图标——点开就是会话面板
- 设置 → 能力面板——管理每个 preset 的默认能力集合

--profile web 就是 dsh web GUI 使用的配置档；如果你平时用 dsh web 启动界面，照抄命令即可。也可以在插件市场里搜索 "capability panel" 一键安装。卸载用 dsh plugin --profile web remove dsh-capability-panel；设置和统计会保留在 $DSH_HOME（见“数据存放”）。

使用

打开任意对话，点输入框右侧的上下文图标，面板向上展开。

- 顶部三个分区：技能 N / MCP N / 工具 N，各带实时计数
- 每行右侧的开关立即生效——不刷新、不重启
- 点击行本身展开描述
- 顶部筛选框匹配名称、描述或状态文案，下方有 X / Y 命中计数
- 分隔线把每个分区按来源归类：preset 自带条目显示 preset 名，其余显示磁盘上的目录——悬停分隔线查看完整路径，点击即在文件管理器中打开该文件夹
- 被关闭的行变暗，同时模型的系统提示里会被告知“用户关闭了这些能力”

run_code 是保留的 Code Mode 传输通道——注册表禁止遮罩它，所以它的开关锁定为开。

两个作用域，同一组开关：输入框里的面板绑定你眼前的会话（重启后随它恢复）；设置 → 能力面板决定之后每个会话从什么状态开始。Preset 默认在会话 agent 创建时读取——不改写 preset 文件，也不改变已经在运行的 agent。

设置 → 能力面板：每个 preset 的默认能力集合

工作原理

生而轻量。 插件零运行时依赖——React、UI 组件和全部 @deepseek-ai/* 都由宿主提供——读取也是零拷贝：加载状态来自 live session 的内存 surface（模型下一次将看到的内容），从不对持久日志重新折叠，打开面板的代价是一次引用扫描，而不是解析历史。

开关是下一次提示组装上的薄覆盖层——技能用同名影子、工具用注册表遮罩——外加一条组装时现算的“你关了什么”的告知。会话开关以会话自己的 id 持久化在插件设置命名空间里，恢复的会话恰好拿回自己的开关，对话日志永不被写入。

数据存放

- Preset 默认值与会话绑定的开关位置：$DSH_HOME/settings.yaml 的 capability-panel 命名空间（会话开关在 sessions. 下，最多保留 200 个会话、最旧的先淘汰）。宿主从不丢弃未加载插件的分节，所以卸载后它们还在，直到你手动删除该段。
- 拦截统计：$DSH_HOME/capability-panel/stats.jsonl，可直接读取：curl 'http://127.0.0.1:3080/api/capability-panel/stats'。

数据路由只接受 loopback 请求，判定依据是连接对端地址。

开发

pnpm install
pnpm dev        # watch 构建
pnpm build      # 构建 host 与 client 两半
pnpm test       # 跑测试
pnpm typecheck  # 类型检查
pnpm lint       # oxlint（含 type-aware 规则）
pnpm check      # typecheck + lint + test（100% 覆盖率门槛）
pnpm scan:dead-code  # 死代码巡检报告（仅提示，不做门禁）

改动 host 半需要重启 dsh；client 半在 dsh web 与 watch 构建同时运行时热替换。

支持

如果这个面板帮你省过一次排查，点个 star 让更多人能找到它；也欢迎顺手分享给同样在折腾 dsh 的朋友。Issue 和 PR 都欢迎——详见贡献指南。

版本变更记录见 CHANGELOG.md。

许可证

MIT