dsh-tool-explorer
Verifieddsh-tool-explorer · v0.4.4 · MIT · Web UI
Management console for DeepSeek Harness: browse, install, update, edit and toggle skills; add, edit, test and monitor MCP servers. · DSH 技能与 MCP 管理控制台。
Install
dsh plugin add dsh-tool-explorer Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
- github/6pofx/dsh-tool-explorer 1 0
- github/dsh-tool-explorer/dsh-tool-explorer 0 0 archived
Tags
Creators
Readme
English | 中文
dsh-tool-explorer
DeepSeek Harness (DSH) 管理控制台：在 Web 设置页中浏览、安装、更新、编辑与启停技能，并添加、编辑、启用/禁用、测试与监控 MCP 服务器。
版本兼容
同一个版本同时支持所有受支持的 dsh 线。 设置接口围着本插件搬过三次家 —— 模块级辅助函数（0.1.0-rc.7 … 0.1.4）、取代它们的 provider 方法（0.1.5）、以及按条目 Config 生成的表单（0.2.x）—— 所以 src/settings.ts 完全不在运行时导入 @deepseek-ai/dsh-settings：只钉在没挪过的那部分，其余靠特性检测。0.2.x 上，插件导出的 Config schema 就是把偏好项放进平台设置页的入口。
| DSH | 状态 |
|---|---|
0.2.1-rc.2（当前） |
支持 —— 启动、host 路由、实时 Config 表单、client bundle 均已运行时实测 |
0.1.5-rc.2 |
支持 —— 功能一致，走 0.1.x 的设置命名空间 |
0.1.1-rc.2 |
支持 —— 启动、host 路由、设置、client bundle 已重新实测 |
0.1.0-rc.7 … 0.1.4 其余版本 |
预期可用：该线提供相同的 ctx.settings.register(ns, schema, { base }) 接口 |
宿主无 ctx.settings |
可正常加载运行；偏好项回退为组合条目中的配置 |
host 半部改动需重启 dsh web，client 半部支持热更新。dsh 升级后请重跑 dsh-mcp-client 本地补丁 —— 升级会还原官方文件。
功能
技能
- 全量目录（项目/用户/内置/插件各来源）与共享
.skill-lock.json合并展示 - 按来源分级浏览：可折叠来源树（项目 .dsh → 项目 .agents → 自定义 →
~/.dsh/skills→~/.agents/skills→ 插件 → 内置），来源下再按 provider 分组，附已加载/禁用计数；支持来源、状态筛选与平铺视图 - 搜索、详情预览、在线新建/编辑（kebab-case 校验、frontmatter 表单、Markdown 正文）
- 独立模型 / 用户调用开关：可只关模型调用（
disable-model-invocation，保留/菜单），也可只关用户调用；双关 = 完整禁用 - 可恢复回收站：删除用户根技能 → 移入
<dshHome>/skills-trash（锁文件条目快照存档）；还原可字节级恢复（含锁条目），永久删除/清空则彻底移除 - GitHub 安装：URL 解析（
owner/repo、tree 路径、#branch）、候选预览、多选/全选批量安装（同一仓库仅下载一次 tarball，逐技能独立处理冲突，失败可重试）、安装到~/.agents/skills或~/.dsh/skills、检查更新/应用（备份+回滚）、卸载 skillFolderHash与 Skills CLI（npx skills）字节级兼容
MCP
- 服务器列表：实时状态（fiber 阶段）、工具清单、各服务器工具计数
- 添加/编辑/删除（stdio + streamable-http）与启用/禁用开关 —— 全部通过 profile patch 层写入（HMR 热生效，无需重启）
- 跨 agent 导入：扫描
~/.claude.json、~/.cursor/mcp.json、~/.codex/config.toml（TOML 子集）、~/.cline/mcp_settings.json、~/.roo/mcp.json、~/.continue/mcp.json、~/.codeium/windsurf/mcp_config.json，一键导入 - 测试连接：独立 SDK 探测（不干扰运行中实例）
- 写入栅栏（expected-hash）：与手改配置并发安全
安装
已发布到 npm（v0.4.3）：
dsh plugin --profile web add dsh-tool-explorer
不需要挑版本 —— 当前版本覆盖所有受支持的 dsh 线（见 版本兼容）。0.1.5 之前的旧版本仍留在 npm 上可装，并打了 legacy dist-tag 便于固定；它只能在 DSH ≤ 0.1.4 上加载：
dsh plugin --profile web add dsh-tool-explorer@legacy # = 0.4.1，仅 DSH ≤ 0.1.4
dsh plugin 会自动 reconcile bundle。重启一次 dsh web（host 插件在启动时加载），打开 设置 → Skills 和 MCP。
本地开发
pnpm install
pnpm run typecheck # host + client 源码类型检查
pnpm run build # tsc host -> lib/，tsdown client -> client/client.js（含包装与校验）
pnpm test:self # 141 条断言：mock host CRUD、跨 agent 导入、GitHub 安装、回收站、真实 stdio 探测、设置装配
本地安装循环：
pnpm pack
dsh plugin --profile web remove dsh-tool-explorer
dsh plugin --profile web add file:G:/dsh-tool-explorer/dsh-tool-explorer-0.4.4.tgz
⚠️ 新增运行时依赖（如
tar）必须重新打包并重装 —— 只拷贝lib/不够。
参考实现
M5 功能集（来源分级浏览、独立调用开关、可恢复回收站）参考了以下社区插件（克隆在 .ref/ 下备查）：
- cheshireez/dsh-skill-hub —— 基于官方
ctx.skills注册表的 GUI 技能中枢；其.trash/重命名 + 还原 + 清空模式启发了本插件的可恢复回收站 - SeverusZh/dsh-skills-mcp-group-manager —— 分组管理与"影子 provider 过滤模型技能目录"
- BAIKAI23333/dsh-skills-manager —— 设置页技能管理器
- peiqi10086/dsh-skills-market —— 侧边栏技能面板（用户/项目/内置）+ SkillHub 商城
设计取舍：启停沿用平台文档化的 frontmatter 双开关（disable-model-invocation / user-invocable），而非 skill-hub 的 SKILL.md.disabled 重命名；回收站放在技能根之外，避免 provider watcher 观察到干扰。
目录结构
| 路径 | 用途 |
|---|---|
src/index.ts |
host 入口；从注入服务组装普通 host 对象（绝不修改 Cordis scope Proxy） |
src/routes.ts |
/dsh-tool-explorer/api/* 路由（写操作强制同源校验） |
src/mcp.ts |
MCP 管理：patch 层增删改、启停、状态推导、SDK 探测 |
src/skills.ts |
技能目录（注册表 × 锁文件 × 磁盘）、编辑/启停、独立模型/用户调用开关、frontmatter 解析（完整 YAML） |
src/skills-trash.ts |
可恢复回收站：删除入站、还原、永久删除、清空（<dshHome>/skills-trash + manifest） |
src/skills-install.ts |
GitHub 安装生态：tarball 下载（区域代理）、候选发现、锁文件 v3、CLI 兼容目录哈希 |
src/agents-mcp.ts |
跨 agent MCP 导入（JSON + Codex TOML 子集解析） |
src/patch-text.ts |
patch 层方言：解析（!!js 容错）、行级手术编辑、[] 占位符处理、原子写 |
scripts/ |
client bundle 包装/校验、自测、以及 dsh-mcp-client 本地补丁（见下；补丁工具随 npm 包一同发布） |
dsh-mcp-client 本地补丁
两个幂等补丁修复上游 dsh-mcp-client 的缺口（已上报官方讨论）。每次 dsh 升级后都要重跑 —— npm/pnpm 升级与 dshmarket 更新都会还原官方文件，两个症状随即复发：
pnpm run patch:mcp # 在仓库检出里执行
pnpm run patch:mcp:check # 只检查不写文件；缺补丁时退出码为 2
替换锚定官方原文，在 0.2.1-rc.2 上（和此前的 0.1.5-rc.2 一样）仍然精确匹配；上游若改动该区域，脚本会明确报布局变化而不会写坏文件。
如果是从 npm 安装的（没有仓库检出），补丁工具随包发布，直接用 node 指向它即可（它会自己找到 profile 里的 dsh-mcp-client）：
node "$DSH_HOME/profiles/web/node_modules/dsh-tool-explorer/scripts/patch-mcp-client.mjs"
| 补丁 | 修复的症状 |
|---|---|
startup-wait |
服务器不可达/挂起时 apply() 会永远停在 connection.ready，dsh web 因此永不打印 dsh web: http://…、也不打开浏览器（就绪提示被 loader.await() 卡住）。等待被限制为有上限（默认 3 秒，可用 DSH_MCP_STARTUP_TIMEOUT_MS 覆盖，0 表示不限制）；连接转后台继续，工具到达时照常注册。 |
stdio-stderr |
每个 stdio 服务器的 stderr 都会继承进 dsh 控制台，FastMCP banner、pino JSON 日志、Python 报错会刷屏。补丁强制 stderr: "ignore"；调试服务器时可用 DSH_MCP_STDERR=inherit 恢复官方行为。 |
参数：--check（只报告）、--profile <名称>（默认 web）、--target <路径>（只处理指定安装）。退出码：0 全部就位、1 未找到安装、2 有补丁待应用或写入失败。备份以 index.js.*.bak 保存在被修补文件旁，且始终是当前已安装版本的官方原文（上一版本残留的旧备份会被刷新），出问题时直接拷回即可。替换锚定官方原文，上游改动布局时会明确报错而不会写坏文件。
单补丁入口（旧用法）仍保留：
node scripts/patch-mcp-client-stderr.mjs
node scripts/patch-mcp-client-async.mjs
dsh 升级之后
pnpm run patch:mcp:check # 退出码 2 = 升级已还原官方文件
pnpm run patch:mcp # 重新打补丁，然后重启 dsh
两个症状就是判断依据：控制台被服务器 banner/JSON 刷屏；dsh web 页面能用但始终不打印地址行。
反馈
问题、功能建议与官方沟通渠道：
- 上文两个本地补丁已上报官方：见 DeepSeek Harness Discussions #5129——官方修复进展可以跟帖关注。
- 其他与本插件相关的问题，请在本仓库发起 issue 或 discussion。
许可证
MIT