dsh-tools-manager
DSH 插件：以 tree 形式列出「插件 → 工具」，并支持全局启停单个工具。
- Tree 列出工具：按来源插件分组，展示每个插件注册的全部工具（name / description）。
- 全局启停：对任意工具一键禁用/启用，跨会话持久化，立即生效（模型不可见 + 执行被拒，两层一致）。
- UI 入口：插件页（Plugins）→ 本插件 bundle 行的「配置」入口（
plugins.row.config keyed slot，key = @huanlin/dsh-plugin-tools-manager#tools-manager，行 id 与 cordis.patch.yml insert 行 id 逐字一致；0.1.7-alpha.1 起 settings.plugin.item 退役、settings.section 独立 Tab 不再使用）。
架构
工具来源归属（tree 数据基础）
- 归因算法（零源码修改）：
- 启动时快照
ctx.tools.schemas() 作基线，归到 (baseline) 分组。
- 监听 Cordis
internal/plugin（fiber.name = 插件名）→ 维护 pendingPlugins 栈。
- 监听
tools/change（register/unregister/restriction 均触发，unfiltered）→ 对 ctx.tools.schemas() 做 diff：
- 新增工具 → 归因到栈顶（最近加载）插件；
- 移除工具 → 从归属表删除。
- 插件卸载（
internal/status DISPOSED）→ 其工具随 effect 自动注销，diff 自然移除。
全局启停（两层一致，缺一不可）
| 层 | 缝 | 实现 |
|---|
| 隐藏（模型不可见） | system-prompt/assemble（waterfall） | 过滤 assembly.tools 中 disabled 工具，返回变换后的 assembly |
| 拒执行（防绕过） | 全局 ctx.tools.guard()（plain ctx） | disabled 工具返回 reason（如 tool "X" is disabled by tools-manager: "X"） |
- 同一个
disabled: Set<string> 驱动两层，保证 prompt 与执行语义一致。
- 覆盖场景：模型直调（guard 兜底）、run_code SDK 子调用（guard 兜底）、隐藏后模型不再发起。
- 不依赖
ctx.tools.restrict()（其强制 scoped ctx，不能做全局过滤）。
持久化
disabled 列表持久化在 profile cordis.patch.yml 的 tools-manager entry Config 中（DSH 0.1.7 起；字段标 .volatile()，settings.configure({ auto: false }) 声明插件自管配置页），跨会话生效。Config：{ disabled: string[] }（Schemastery schema，默认 []）。- 运行时编辑经
settings.update('tools-manager', { disabled }) 提交，Loader 原地更新 volatile 引用，即时应用（guard/assemble 读同一份 disabled 状态，无需重启）。
Host↔Client 通道
- 宿主 HTTP 路由：
ctx.webServer.register({ kind: 'prefix', path: '/tools-manager/api', handler })。
- 接口（JSON envelope）：
POST /tools-manager/api/list → { ok, value: { plugins: [{ name, tools: [{ name, description, disabled }] }] } }POST /tools-manager/api/set body { toolName, disabled } → { ok, value: { plugins: [...] } }- 错误：
{ ok: false, error: { code, message } }
开发
pnpm install # 安装依赖（link: 指向 ~/.dsh/source/current/）
pnpm run typecheck # tsc --noEmit
pnpm test # vitest run
pnpm run build # tsc (host) + build-client.mjs (client bundle) + tsc (types)
目录结构
src/
├── index.ts # Host 入口：name, inject, apply（registry + policy + gateway）
├── config.ts # Config schema (schemastery), ResolvedConfig, resolveConfig
├── registry.ts # ToolRegistry: 归因 diff（internal/plugin + tools/change）
├── policy.ts # installPolicy: system-prompt/assemble 过滤 + tools.guard
├── settings.ts # installToolsManagerSettings: 注册 namespace，返回 bridge
├── gateway.ts # registerHttpGateway: /tools-manager/api 前缀路由（list/set）
└── client/
├── index.ts # Client 入口：plugins.row.config keyed slot 注册行配置卡片
├── row-config-key.ts # key 派生（包名#行 id）与三 id 一致性注释
├── ToolsManagerPanel.tsx # 行配置卡片（summary 一行简介 / page 工具树，inline styles）
└── prefixTree.ts # 前缀树构建工具（`__`/`_` 分割）
运行
本地安装
dsh plugin --profile web add "link:D:/Projects/deepseek-harness/dsh-tools-manager"
配置
默认配置（cordis.patch.yml）：
disabled: [] # 预置禁用的工具名列表（默认空）
运行时通过插件页本插件行配置卡片修改（plugins.row.config，注册由 configForms.whileServed 门控：行停用/Host 不供配置时入口随之消失，view:'page' 且 form 缺失时卡片显示不可用提示），持久化到 profile cordis.patch.yml 的 tools-manager entry。
检查
pnpm run typecheck && pnpm test && pnpm run build
验证 lib/ 产物：
lib/index.js — host bundle（ESM）lib/client.js — client bundle（CJS，window.__ModuleLoader__.load 包裹）lib/types/ — TypeScript 声明文件cordis.patch.yml — bundle 配置层
已知边界
| 风险 | 影响 | 缓解 |
|---|
| 归因偏移（插件运行期动态注册工具） | tree 中工具挂错插件 | 记录 Known Limitations；list 接口对未归属工具归到 (unknown) 分组 |
system-prompt/assemble 多监听时序 | 其他插件也可能变换 tools | 本项目过滤只删 disabled，next() 委托其余；序靠后仍正确 |
| guard 与 assemble 双层不同步 | 隐藏与拒执行不一致 | 单一 disabled 状态源；单测断言两缝读同一状态 |
| settings 服务缺失 | 启停不持久 | 降级为内存态（仅本次运行生效），set 返回明确错误 |
run_code 模式 | 模型经 SDK 子调用禁用工具 | guard 全局兜底拒绝；文档说明"禁用=执行不可达" |
