简体中文 · English · 更新日志 · 版本概要

DeepSeek Harness 的 MCP、技能、子智能体、提示词、记忆与归档会话，都收在一个面板里。把它们配成一套，就是**场景**——点一下整套切换，退出按快照还原。 ```sh dsh plugin --profile web add dsh-plugin-tool-management@latest # 浏览器版 dsh plugin --profile desktop add dsh-plugin-tool-management@latest # 桌面版 ``` 装完浏览器硬刷新（Cmd/Ctrl+Shift+R）或重启桌面应用，打开 **设置 → 工具管理**。桌面版先打开过一次应用并完全退出，再执行命令；装到的不是最新版，多半是镜像延迟或 pnpm 的 `minimumReleaseAge`，改用确切版本号（`@0.X.X`）即可绕开。 --- ## 核心亮点

一键换场景每个场景存一份完整档案：MCP、技能、子智能体、记忆、快捷提示词、提示词预设、模型工具表。进入即整套切换，退出按快照还原。	在对话里控制打 `/` 打开「工具」段：进出场景、启停六个域，点一下直接生效。菜单不关，输入框也不留命令字。	三种作用域全部全局 / 按工作区 / 按会话。默认每个对话各一份设置——同一个项目里的两个对话，可以同时跑两套环境。
Agent 反向控制 26 条模型工具覆盖六个域：列、读、建、改、删、启停、进场景、派子智能体。写操作弹确认卡；关掉的工具不在 schema 里，模型完全看不到。	兼容页是总控台版本与能力体检、访问令牌、生效层级、六个域的注入开关、模型工具表、侧栏入口，都在这一页。	一个面板，八个页签场景 / MCP / 技能 / 子智能体 / 提示词 / 记忆 / 会话 / 兼容，不再在六处设置之间来回找。

## 演示

播放器起不来（登录态偶发被浏览器 CSP 拦）？[点此直接看同一个文件](https://github.com/user-attachments/assets/ff3111c3-4228-45b7-9e28-b85dc60fb6b3)。画面里每个界面都是真机截图，没有重画的 UI。背景音乐：Kevin MacLeod「Limit 70」，[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)。 ## 界面 | | | |:---------------------------------------------------------------------:|:-------------------------------------------------------------------------:| |

**场景** | MCP

**MCP** | |

**技能** |

**子智能体** | |

**提示词** |

**记忆** | |

**会话** |

页签	做什么
场景	把整套环境存成档案，一键进入 / 退出；可锁定防误改，可绑定提示词预设与模型工具表方案；删除时连同记忆进回收站。
MCP	增删改服务器、逐工具开关、给模型写备注；没在跑也能看上次见过的工具清单；导入导出，改前自动备份。
技能	按来源分组，启停 / 移除 / 导入 / 编辑；同名技能标出谁在生效，外部目录只读。
子智能体	一个人设一个 `.md`，可派活、限工具、选模型；跑完只回结果，不占你的会话记录。
提示词	多套 `AGENTS.md` 一键应用 / 取消应用，保留 5 代备份；快捷提示词从 `/` 直接贴进输入框。
记忆	场景即分组，`.md` 正文自动进上下文；导入导出、回收站、注入预算。
会话	按项目分组归档，可搜索、批量恢复；能导入 Claude Code / Cursor / Codex 的记录，导出 Markdown / JSONL。
兼容	版本与能力体检、访问令牌、生效层级、注入开关、模型工具表、侧栏入口、清理旧备份。

## 让 Agent 管这个插件六个域共 **26 条模型工具**：列清单、读正文、新建、修改、删除、启停、进出场景、应用提示词、派子智能体。 - **默认只发 6 条**（约 1.6k token/轮），其余 20 条关着。关掉不是藏起来，是**根本没进 schema**——模型看不到，也调不到。 - **按层生效**：模型默认只改当前这一层，回执会说清写的是哪一层；带 `scope: "global"` 才动全局。 - **写操作有确认卡**：停机、删除、开关落到机器级等都会先问一句；恢复动作（重启 / 还原 / 取消应用）不拦。 - **逐条可开关**：兼容页的「模型工具表」按层调整，26 条全开约 6.2k token/轮；可以按任务存成不同方案，跟场景一起切。 ## 兼容页不只是版本号： - **体检**：宿主版本、这一轮实际加载的插件版本、每个动作走原生 / 适配 / 不可用及原因。升级后哪一处悄悄失效，一眼看到。 - **访问令牌**：设置 / 关闭 / 修改 / 删除；写操作与明文密钥都走它。 - **生效层级**：全部全局 / 按工作区 / 按会话，一键切。 - **注入**：六个域各自开关、极简模式兜底注入、斜杠命令两段入口、侧栏入口。 - **模型工具表**：26 条逐条可见性，按层保存方案。 - **维护**：清理旧备份、功能总览、最近改动。

数据落在哪 · 安全边界

| 内容 | 位置 | |:------------------------------------------- |:----------------------------------------------------------------- | | MCP 定义 | `~/.dsh/cordis.patch.yml`（插件只写它；改前自动备份） | | 技能策略 / 自定义目录 | `~/.dsh/tool-management/skills-state.json` | | 技能 / 记忆 / 人设 / 预设 | `~/.dsh/tool-management/{skills,memories,subagents,prompts}/` | | 记忆索引 / 场景 / 档案 | `~/.dsh/tool-management/memories-index.json` | | 回收站（技能 / 记忆 / 人设 / 预设 / 场景） | `~/.dsh/tool-management/trash/<域>-trash/` | | 归档账本 / 保留期 | `~/.dsh/tool-management/history-*.json` | | MCP 侧车（停用表 / 已知工具 / 备注 / 设置） | `~/.dsh/tool-management/mcp-*.json` | | 注入设置（六个域开关） | `~/.dsh/tool-management/inject-settings.json` | | 模型工具表 / 作用域覆盖 | `~/.dsh/tool-management/tool-table.json` · `scope-overrides.json` | | 运行日志 / patch 备份 | `~/.dsh/tool-management/tool-management.log` · `backups/` | - **只写自己的文件**：不动技能源文件；MCP 只改 `cordis.patch.yml`，每份 patch 各留 5 份备份。 - **令牌**：设置后所有写操作与明文密钥都要 `x-dsh-token`；浏览器读写走 cookie，明文查看仍要令牌。 - **进程级边界靠令牌**：写接口默认由宿主的浏览器鉴权把关；宿主栅栏缺席时退回只查回环地址的本地判定，本机其它进程即可直连——配了访问令牌才有进程级这道门。 - **磁盘上是明文**：打码只发生在界面。MCP 的 `env` / `headers` 与插件的 `token` 在 patch 文件里始终明文，备份也不加密、不轮转。令牌门禁管不到磁盘读取，防线是文件权限。 - **删除可找回**：技能 / 记忆 / 人设 / 提示词 / 场景的删除都进回收站（会话永久删除除外），可设保留期自动清理（默认永久保留）。

## 常见问题 | 现象 | 解决 | |:--------------------- |:------------------------------------------------------------------------------------------- | | 装完没有页面 | 硬刷新浏览器；还不行就重启 DSH。 | | 模型调不到某条工具 | 兼容页 →「模型工具表」，先选对当前对话 / 工作区（出厂默认关着 20 条）。面板和脚本不受影响。 | | 升级 DSH 后动作不可用 | 兼容页看降级原因；`node scripts/doctor.mjs`，再 `node scripts/host-deps.mjs --fix`。 | | 版本对不上 | 只适配 DSH **0.2.2**（`>=0.2.2-rc.1 <0.2.3`），跨代升级要等插件同步适配；旧宿主请装 0.21.x。 | | 重复 MCP 页签 | 删掉 `cordis.patch.yml` 里的旧 loader 行，再重启。 | | 改坏配置 DSH 起不来 | 从 `~/.dsh/tool-management/backups/` 取最近的 `cordis.patch.yml.*.bak-*` 覆盖回去。 | 完整排查手册见 [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)。 ## 文档 | 文档 | 什么时候看 | |:----------------------------------------------------- |:---------------------------------------------------------------- | | [故障排查](docs/TROUBLESHOOTING.md) | 装完没页面、重复页签、升级后动作不可用、侧车损坏 | | [架构](docs/ARCHITECTURE.md) | 内容怎么进模型、同一个开关为什么两个对话不一样、改完落到哪个文件 | | [兼容矩阵](docs/COMPATIBILITY.md) | 各 DSH 版本的能力矩阵（已验证 / 未实测 / 不可用） | | [更新日志](CHANGELOG.md) · [版本概要](docs/UPDATE.md) | 每一版改了什么 | ## 开发 ```bash npm install npm run build # tsc + 同步客户端 npm test # 构建 + i18n + 契约测试 npm run doctor # 宿主兼容体检 ``` `lib/` 不入版本库，克隆后先 `npm run build`；改完重启 `dsh web` 才生效。运行时依赖只有 `fflate` 与 `js-yaml`（惰性加载），`@deepseek-ai/*` 一律用宿主那份。 ## 许可证 MIT