ouli-1242/dsh-plugin-tool-management

dsh-plugin-tool-management

npm version
License
Node
GitHub

DSH Market
awesome-dsh-plugin
dshfind
0xsline

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

DeepSeek Harness 的 MCP、技能、场景、记忆、子智能体、提示词与归档会话管理插件。八个页签：场景 / MCP / 技能 / 子智能体 / 提示词 / 记忆 / 会话 / 兼容。

dsh plugin --profile web add dsh-plugin-tool-management@latest

装完硬刷新浏览器（Cmd/Ctrl+Shift+R），设置 → 工具。插件只写自己的文件，不改技能源文件；重启与升级后配置都在。

截图

|                              |                                |
|:----------------------------:|:------------------------------:|
| 场景   | MCP      |
| 场景                     | MCP                        |
| 技能   | 子智能体 |
| 技能                     | 子智能体                   |
| 提示词 | 记忆     |
| 提示词                   | 记忆                       |
| 会话   | 兼容     |
| 会话                     | 兼容                       |

核心亮点

一句话：把「工作 / 写作 / 编程」各配成一套场景，点一下整套切换；插件管的东西，模型都看得见。

| 亮点                        | 说明                                                                                      |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| 一键换场景                  | 每个场景各配一套 MCP / 技能 / 人设 / 记忆，进入时整套切换、退出时还原；模型也能按你说的切 |
| 记忆自动送到模型眼前        | 每个场景下写几段 .md 就是它的资料库，正文自动进上下文，不用每次复制粘贴                 |
| 给 MCP 服务器写备注         | 「A 不可用时改用 B 兜底」这类话写进备注，模型每轮都看得到，会照做                         |
| 单个工具也能关              | 一台服务器里可以只停某个工具，模型看不见也调不到；「重启」只重连，不改开关状态            |
| 技能状况一眼看穿            | 哪份在生效标「首选」，被同名覆盖的标出来源                                                |
| 子智能体 = 一个文件一个角色 | 写一份角色说明就能派活；跑完只回结果、不占你的会话记录                                    |
| 提示词备好几套              | AGENTS.md 可以存多份、一键切换；场景可以各自绑一份                                      |
| 会话不再丢                  | 归档按项目分组、能搜、能批量恢复；Claude Code / Cursor / Codex 的记录能导进来             |
| 模型一定看得见              | 六个域各注入一条上下文，内容没变不重发；压制型预设下默认不注入，可在「兼容」页开          |
| 锁住就不怕手滑              | 场景可以上锁：五个域的增删改整体只读，先解锁才能改                                        |
| 删了能找回                  | 技能 / 记忆 / 人设 / 提示词 / 场景的删除都进回收站（会话永久删除是例外）                  |
| 安全、不添乱                | 只写自己的文件；密钥默认打码、看明文要令牌                                                |

快速开始

前置：DSH 已安装（dsh web 可运行），Node.js ≥ 18。

dsh plugin --profile web add dsh-plugin-tool-management@latest   # 安装 / 更新
dsh plugin --profile web remove dsh-plugin-tool-management        # 卸载

装完硬刷新浏览器，设置 → 工具 出现八栏即成功。界面改动即时生效，宿主侧改动需重启 dsh web。

也可以让模型代劳：

安装 dsh-plugin-tool-management 插件：
dsh plugin --profile web add dsh-plugin-tool-management@latest
装完提醒我硬刷新浏览器。

功能

场景与记忆

- 场景 = 分组，记忆 = .md 文件：memories//.md，整篇正文自动注入上下文，文件名支持中文。
- 「启用」与「进入」是两件事：启用决定注入按哪个场景走（单选，全关 = 只注入「全局」与 _shared）；进入才按档案整套切换 MCP / 技能 / 人设，并把绑定的提示词写进 AGENTS.md。界面开关与 scene_manager_switch 都两轴齐动。
- 场景档案：每个场景搭配 MCP 工具集 / 技能集 / 子智能体 / 记忆（任意组合）。语义是勾的启用、没勾的停用，整段没建 = 该域全部停用；退出按进场景前的快照还原。场景内这三个域的开关照常可用，改动会同步写进档案。
- 场景锁定：锁定后 MCP / 技能 / 子智能体 / 记忆 / 提示词五个域的增删改整体只读（界面与服务端双侧拦截）；场景自身的启停、MCP 重启、导出不受影响。
- 删除场景 = 连记忆一起删：场景记录、档案与全部记忆进同一条回收站条目，恢复时按原路径整条放回；使用中的场景拒绝删除。改名会连带改目录与档案。
- 导入导出：.md / .zip（目录名 = 场景，bundle 带附件），同名跳过绝不覆盖；导出勾选记忆打包成 zip，只读源文件。
- 注入预算：默认 128 KiB，放不下的跳过并列出清单。
- 子代理会话不注入记忆：记忆是父会话的现场；子代理需要的事实应由父代理写进任务。

子智能体

- 一个文件一个人设：subagents/.md，frontmatter 全可选。output: 一行一条写"产出必须长什么样"（可检验的格式要求比一句抽象要求更容易被遵守）。
- 委派：subagent_manager_run 带人设运行、只回最终结果、不进 History。默认新起独立会话（任务要写全）；inherit: true 则继承本次会话已完成的轮次（本轮内容继承不到，此时任务仍要写全）。
- 启停与目录：停用的人设不注入、模型不可见（文件不动）；新建 / 导入 / 恢复默认停用。人设目录只列名字 + 描述；改名后场景绑定自动跟着改。
- 目录注入深度（catalogDepth）：默认 1 = 只在顶层会话注入目录，99 = 任何深度都注入。它只管目录，不限制嵌套深度（那由宿主决定）。
- 工具限制按 Agent 预设：每个预设一份白 / 黑名单（互斥）。两条要知道的行为：白名单会并回当前所有 mcp__ 工具，所以"只勾 read"拦不住暴露 shell 的 MCP 服务器；名单里的名字全都对不上时按"不限制"处理。
- 思考强度：在高级选项里与「模型」并排，档位由所选模型声明。换模型后旧档位若不在新清单里会自动清掉并告知；指定了模型时留空 = 回落到该模型的默认档位，不是沿用主会话那一档。

MCP 服务

- 增删改查、即改即生效：写入 cordis.patch.yml，改前自动备份。级别分「全局 / 应用级」，新增默认全局。
- 工具级开关：单个工具可独立停用（模型看不见也调不到），整台支持批量。
- 停着也能看清单：没在跑的服务器仍显示上次见过的工具名与描述（标「上次运行时」）；从没跑过的可以一键启动读取。
- 备注：每台服务器可写一句给模型的提示，随状态段一起注入。曾经连上过、现在连不上的服务器会列出来并标注 —— 这样模型会说"它没连上，检查一下"，而不是建议你去装一个。
- 密钥打码：默认把凭据整值打码（$VAR、!!js 这类间接引用不动；URL 查询串换成 ?），看明文要令牌。打码只管界面展示，详见「配置与安全」。
- 迁移与备份：跨项目级 / 全局迁移失败自动回滚；支持 JSON 导出导入。

技能

- 来源一览：项目级 / DSH / Agents / Codex / Claude / 自定义目录，按来源分组。
- 两组权限相反：默认来源的技能可删可停；外部目录可以停用或移除，但里面的技能文件只读。
- 移除 ≠ 停用：移除 = 连目录都不扫（文件零改动，可恢复）；停用 = 仍列出但不可调用。
- 同名谁在生效：真正生效的那份标「首选」，被覆盖的标出来源；启用被覆盖的副本会明说"这样不会生效"。
- 自定义目录 / ZIP 导入导出 / 回收站。

提示词预设

- 多套 ~/.dsh/AGENTS.md 基线一键应用（下一轮对话生效），保留 5 代备份。
- 记得「最近一次应用的是哪份」：就算你手改过 AGENTS.md，也答得出来源（会注明"此后文件有变"）。
- 每条预设可写一句"这份是干什么的"，只存在插件侧、不进 AGENTS.md。
- 被引用的不能删（场景绑定 / 当前内容 / 退出场景要恢复的那一份），删除进回收站。
- 场景接管期间「应用」= 把该场景改绑到那一份（同步写进场景档案）；锁定时拒绝。

历史会话

- 按项目分组、搜索、批量恢复 / 永久删除、保留期自动清理；工作区登记被删后可一键重新登记。
- 导入 Claude Code / Cursor / Codex / 任意文本；导出 Markdown / JSONL。导出是可读转录，不是完整备份：只保留 user / assistant 的文本块，工具调用、图片、思考过程与 token 统计都不在里面。要留全量请用「归档」。

宿主兼容

- 「兼容」页：宿主版本、能力可用数、每个动作走原生 / 适配 / 不可用、降级项与原因。这一页有三个写入口：访问令牌（重启生效）、注入设置、模型工具表。
- 命令行：node scripts/doctor.mjs（体检）、node scripts/host-deps.mjs --fix（依赖对齐）。
- 压制型预设（minimal 这类）下本插件的注入默认停用（跟随预设的设计意图），可在「兼容」页按域强制打开。
- 关掉「技能」「提示词」的勾选 = 连宿主那份一起停（这两域在标准预设下由官方送，插件让位）；其余三域宿主本来就不送，勾选完全生效。
- 注入长什么样：每个域一条 ，# 板块标题 + 正文 + 一句"以本份为准"，只写"现在是什么"、不写指令。你写的内容里出现  会被转义。

数据落点

| 内容                                        | 位置                                                                      |
| ------------------------------------------- | ------------------------------------------------------------------------- |
| MCP 定义                                    | ~/.dsh/cordis.patch.yml（插件只写它；改前自动备份到 hub 的 backups/） |
| 技能策略 / 自定义目录                       | ~/.dsh/tool-management/skills-state.json                                |
| 技能 / 记忆 / 人设 / 预设                   | ~/.dsh/tool-management/{skills,memories,subagents,prompts}/             |
| 子智能体启停                                | ~/.dsh/tool-management/subagents-index.json                             |
| 回收站（技能 / 人设 / 预设 / 场景）         | ~/.dsh/tool-management/trash/{skills,subagents,prompts,scenes}-trash/   |
| 记忆回收站                                  | ~/.dsh/tool-management/memories-trash/（在 hub 根下，不在 trash/ 里） |
| 归档账本 / 保留期                           | ~/.dsh/tool-management/history-.json                                   |
| 记忆索引 / 场景 / 档案                      | ~/.dsh/tool-management/memories-index.json                              |
| MCP 侧车（停用表 / 已知工具 / 备注 / 设置） | ~/.dsh/tool-management/mcp-.json                                       |
| 注入设置（六个域开关）                      | ~/.dsh/tool-management/inject-settings.json                             |
| 模型工具表（关掉的工具 + 存下的方案）       | ~/.dsh/tool-management/tool-table.json                                  |
| 场景页界面设置（进场景前弹不弹预览卡）      | ~/.dsh/tool-management/scene-settings.json                              |
| 运行日志 / patch 备份                       | ~/.dsh/tool-management/tool-management.log · backups/                 |

插件安装目录里不存用户数据（dsh plugin update 会整体替换该目录）。备份按每份 patch 文件各留 5 份（全局与每个 profile 各自计），一次批量操作就可能把某层的 5 个槽位吃掉。

配置与安全

| 字段            | 说明                                                                                                                                           |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| token         | 访问令牌。设了之后所有写操作 + 明文密钥都要求 x-dsh-token；不设时明文接口一律关闭。也可改用环境变量 DSH_PLUGIN_TOOL_MANAGEMENT_TOKEN。 |
| tokenDisabled | true = 令牌保留在配置里但当前不生效（兼容页「关闭保护」写的就是这一行）。写操作不再要求令牌，明文查看仍然要。                                |
| maxBodyBytes  | 请求体上限，默认 88 MiB。                                                                                                                      |

磁盘上的明文（必读）：打码只发生在界面展示。MCP 的 env / headers 与插件自己的 token 在 cordis.patch.yml（及各 profile 副本）里始终是明文，而每次改配置前插件会把整份文件备份进 ~/.dsh/tool-management/backups/（不加密、不轮转、卸载也不回收）—— 一份密钥最多有 5 ×（含它的 patch 文件数）+ 1 份明文副本。令牌门禁管的是"谁能通过 HTTP 拿到明文"，管不到磁盘读取：真正的防线是操作系统的文件权限。清理入口：设置 → 工具 → 兼容 → 「清理旧备份」（可按层级各删最旧的 N 份，弹窗内二次确认），也可以手工删那个目录下的旧文件。

- 浏览器：读写走 cookie，不需要令牌；明文密钥（显示密钥 / 导出）要令牌。令牌在「兼容」页的「访问令牌」块管理：本次启动填一次管到 DSH 退出；写进配置文件要重启生效。
- 销毁方向一律要当场再输一次当前令牌（关闭保护 / 修改 / 删除）—— 本次启动解锁过不算，否则"能打开界面就能关掉保护"。
- curl / 脚本：带 x-dsh-token，或带浏览器 cookie。
- HTTP 状态码：除安全栅栏的 401 / 403 外，一律 HTTP 200 + { ok: false, error } —— 脚本分流请以 body.ok 为准。
- 端口转发：宿主缺 connection 服务时栅栏退到「Host 回环 + 同源」判定，本机进程伪造 Host: localhost 即可调用写 op。转发到局域网 / 公网的场景务必配令牌 —— 陌生人注入 MCP 命令等同远程执行。「选择文件夹」弹窗用的 dir-list 能列出任意绝对路径（只读），同一条前提。

常见问题

| 现象                                        | 解决                                                                                                                                                  |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| 装完没有页面                                | 硬刷新；不行重启 DSH。                                                                                                                                |
| 重复 MCP 页签                               | 删 cordis.patch.yml 里的旧 loader 行后重启。                                                                                                        |
| 改坏配置 DSH 起不来                         | 从 ~/.dsh/tool-management/backups/ 取最近的 cordis.patch.yml..bak- 覆盖回去（每份 patch 各留 5 份）。                               |
| 升级 DSH 后动作不可用                       | 设置 → 工具 → 兼容 看原因；doctor.mjs → host-deps.mjs --fix。                                                                                 |
| 模型调不到某条工具                          | 「兼容」页的模型工具表看它是不是被关了（出厂默认关着 15 条）；面板和脚本不受影响。                                                                |
| approval=never 还要确认吗                 | 不弹卡，直接放行并记日志；想问回来切回「工作区内修改」。                                                                                              |
| subagent_manager_run 报 provider 不可用   | 对应 provider 没注册：spawn（默认）/ fork（inherit）分别挂 @deepseek-ai/dsh-subagent-spawn-in-process / -fork-in-process 后重启。           |
| 场景绑了 A 人设，官方 subagent 还在跑别的 | 官方那两个是宿主的工具，本插件管不到它们的可见性；插件会把分界写进上下文 —— 贴合人设的走 subagent_manager_run，官方只在没有人设贴合或要后台跑时用。 |

开发

npm install
npm run build        # tsc + 同步客户端
npm test             # 构建 + i18n + 契约测试（纯函数不变量与宿主契约）
npm run check:i18n   # 词典自检
npm run doctor       # 宿主兼容体检

lib/ 不入版本库，克隆后先 npm run build。改完重启 dsh web 才生效。运行时依赖：fflate（导出打包）、js-yaml（写宿主补丁前的解析校验，惰性加载）；@deepseek-ai/ 一律用宿主那份。

部署注意：npm run build 的 profile 镜像清单不含 node_modules，本地联调时新增的运行时依赖（如 js-yaml）要么在 profile 侧装一份，要么接受“补丁校验跳过并上报”的降级。npm install 装到 profile 的正式安装不受影响。

许可证

MIT