dsh-toolshed 工具棚
DeepSeek Harness 的工具面管理插件:MCP 服务、Skills、已归档会话,外加宿主重启 —— 一个侧边栏入口搞定。
Issues • Changelog • English • Fork 自 functy23/dsh-mcp-studio
为什么改名:早期它是上游
dsh-mcp-studio的 fork(只做 MCP / Skills);后来并入了 z1lyA/dsh-session-admin 的已归档会话管理与桌面进程级重启, 功能面与身份都变了,npm 上的dsh-mcp-studio又属原作者、发不了同名包,于是以dsh-toolshed独立立项 (插件 id / 路由前缀 / 产物 id 全部换成新名,旧版需卸载后重装)。上游 MIT 与附加条款继续适用,见 THIRD_PARTY_NOTICES.md。
📦 这是什么
Tauri 桌面版(deepseek-harness-desktop)的扩展面板功能原本分散在三个互相依赖的插件里:
| 上游包 | 作用 | 依赖 |
|---|---|---|
dsh-tauri-panel-extension |
扩展面板本体:Skills / MCP / 插件市场 三个 tab + host 路由 | dsh-tauri、dsh-tauri-ui |
dsh-tauri |
宿主/客户端框架桥:defineRoutes、defineService、definePanel、defineRegister、locale、store |
— |
dsh-tauri-ui |
面板用的组件库:Button/Chip/Modal/SegmentedControl/PanelPage/图标… | dsh-tauri |
要装 MCP 管理,就得把这三个一起装上,而且只在 Tauri 发行版里可用。
dsh-toolshed 把它们整合成一个包:上游源码原样搬运(src/panel、src/vendor/dsh-tauri、src/vendor/dsh-tauri-ui),
用构建期模块映射(src/bridge)把旧的裸包名 dsh-tauri / dsh-tauri/client / dsh-tauri-ui/client 指到本地文件,
再补上通用化所需的最小改造 —— 界面本身一行 UI 都没重写。
✨ 整合方式
src/ ← 活代码:从产物入口走得到的部分
├── panel/ ← dsh-tauri-panel-extension(原样搬运)+ 1.1.0 的会话管理
│ ├── host/ service(mcp / skills / agents / repos / restart / rmtree
│ │ / archive / pending-deletions / session-paths / session-attachments / restart-helper)、
│ │ routes(mcp / skill / import / roots / archive / host)
│ ├── client/ components(mcp-tab / mcp-editor-form / mcp-import-dialog / skills-tab
│ │ / archive-tab / restart-control / extension-panel)、
│ │ register(extension-panel / skill-creator-prefill / styles)、locales、styles、store、apis
│ └── shared/
├── vendor/
│ ├── dsh-tauri/ ← dsh-tauri(host 框架工具 + client 框架桥;Tauri 专属的 invoke/iframe 桥保留但不进产物)
│ └── dsh-tauri-ui/ ← dsh-tauri-ui(面板用到的组件与样式工具)
└── bridge/ 构建期模块映射:旧裸包名 → 本地源码
vendor-archive/ ← 走不到产物入口的 vendor 子树(Tauri 专属桥、未搬运模块的测试)
不参与构建 / typecheck / 测试,只作上游对照
产物三个文件:lib/index.js(host 半,ESM)、lib/client.js(client 半,DSH ModuleLoader CJS)与
lib/restart-helper.js(重启助手,独立进程跑:拉起它的 Host 随后会被 taskkill,内联进主 bundle 就会一起消失)。
通用化改造(三处适配 + 行为修复)
- 模块映射:
dsh-tauri、dsh-tauri/client、dsh-tauri-ui/client→src/bridge/*,因此上游源码不需要改 import。 - profile 探测(
src/panel/host/service/profile.ts):上游只认--profile开关(Tauri 壳会传), 嵌入 Web / Desktop 后必须补上DSH_PROFILE/DSH_PROFILE_DIR/ 启动参数里的<DSH_HOME>/profiles/<name>, 否则 MCP 行会写错 profile。 - 独立标识:插件 id 与路由前缀为
dsh-toolshed(/dsh-toolshed/api/*),与 Tauri 版插件、以及上游dsh-mcp-studio都不同,可共存互不覆盖。 可与 Tauri 版共存、互不覆盖。
此外还有面板行为修复(依赖新版核心的导航能力变化,见 CHANGELOG.md):
- 「新建技能」开新对话:上游只走「工作区 →
connectWorkspace开新会话」,而 0.1.7 起导航搬到了uiWorkspace。 现在按四级退级:官方sessions.create({ workspaceId })在当前会话所属工作区新建一条对话 → 适配层投影回的workspaces.connectWorkspace→ 会话不属于任何工作区时按它的cwd建 → 实在无处可建才复用活跃会话。 点一次「新建技能」不再抢走你正在写的那条对话。 - 不再随包带技能(2.6.4):
/skill-creator是一条技能,不是内置命令——宿主只把技能目录里真实存在的 条目认成/名字。上游用files: ["skills"]打包了 anthropics/skills 的skill-creator与 vercel-labs/skills 的find-skills,本仓库 2.0.x–2.6.3 也逐字节补回;2.6.4 起两个目录都移除(find-skills与~/.agents/skills/find-skills内容相同,skill-creator改由用户放进~/.agents/skills)。 后果:技能没装时,预填的/skill-creator只是普通文本(不高亮、点不开、发送后也不加载技能)—— 所以技能页会检测它是否在列,不在就把「新建技能」按钮禁用并在悬停提示里说明怎么装。 - 插件市场收编已移除(1.2.0):上游用 iframe(
window.parent !== window)才收编dshmarket,那是给 Tauri 壳用的; 1.0.5 起本插件改成「只要dshmarket发布render就嵌进市场 tab」,1.2.0 起整段移除—— 市场是独立插件、低频,占用面板标签页不划算;装了dshmarket就继续用它的设置页入口。
Tauri 专属部分(dsh-tauri/client 的 invoke / listen / iframe 消息桥、桌面侧边栏注入)保留在 vendor 里但不被引用,
所以产物不会访问 window.__TAURI__,在 Web 与 Desktop 上同样工作。
🚀 安装
装到你想用的那个 profile 上:
dsh plugin --profile web add dsh-toolshed@latest # DSH Web 版(尚未发 npm 时用下面的 link 方式)
dsh plugin --profile desktop add dsh-toolshed@latest # DSH 桌面版
包内声明了 dsh.bundle.patch,安装即自动挂载;host 半更新后重启一次 DSH,然后硬刷新浏览器(Cmd/Ctrl+Shift+R)。
关于
dsh.client.platform: web:这里的web指客户端类型(Web GUI),不是 profile 名字。 Web 与 Desktop 两个 profile 跑的都是@deepseek-ai/dsh-web-app,同一个客户端,所以两端都能用; 本插件的客户端半依赖它的官方模块(ui-layout / ui-primitives / ui-renderer / locale)。Tauri 版不在范围内:Tauri 发行版有自己的原生扩展面板插件。本仓库只是把那三个包搬过来整合成 跨端插件,产物里没有任何 Tauri 运行时依赖,也不反过来替换 Tauri 版的原生插件。
不要与
dsh-session-admin同时安装:1.1.0 已包含它的全部能力(已归档删除、待删除队列、进程级重启)。 两个插件会同时读改写同一个$DSH_HOME/session-admin/pending-deletions.json,并重复注册workspace域的domain/changed监听。升级步骤:先把本包装成link:并确认新 tab 正常,再卸载旧插件 (plugin_manager({ action: "remove_bundle", target: "dsh-session-admin" });若报bundle-in-use, 先从 profile 的dsh.profile.bundles去掉它、再删dependencies里的link:项,最后pnpm install --offline --dir <profile>收敛 lockfile)。
本地开发(link):
pnpm install && pnpm build
# ~/.dsh/profiles/<profile>/package.json
# "dependencies": { "dsh-toolshed": "link:/abs/path/to/dsh-toolshed" }
# "dsh": { "profile": { "bundles": [ ..., "dsh-toolshed" ] } }
pnpm install --dir ~/.dsh/profiles/<profile>
🧭 界面
装好后侧边栏出现 工具管理(Puzzle 图标),点开是四个 tab(顺序:技能 / 插件 / 会话 / MCP), 标签页那一行的最右侧是刷新 + 重启服务:
| Tab | 能力 |
|---|---|
| 技能 | 技能列表、按来源类别筛选(项目 / 用户 / 运行时 / 内置)、搜索、启用 / 停用、查看与编辑 SKILL.md、新建技能(在当前工作区开一条新对话并预填 /skill-creator)、删除、打开目录、刷新。来源按类别合并展示:~/.dsh/skills 与 ~/.agents/skills 都算「用户」 |
| 插件 | 只按包(npm bundle)列出当前 profile 的插件:图标 + 名称 + 一句话简介 + 版本 + 启停状态;全部 / 第三方 / 官方 三档筛选(默认第三方)、搜索(包名 / 标题 / 简介)、包级启用 / 停用、失败后撤销上次变更;右上角「插件市场」直接跳到官方插件页的发现 tab。不展示 Loader 条目——条目级的精细开关在官方插件页 |
| 会话 | 已归档会话按工作区分组(组默认折叠,点开才见该工作区的会话;无工作区的归「未关联工作区」并置底);组头 = 工作区名 + 会话数 + 该组占用 + 待删除数;全局全选跨所有组(含折叠的),每组另有组内全选 / 半选。会话行仍显示会话名 + 短 id、精确磁盘占用、文件数、子代理数;批量取消归档、批量永久删除(dry-run 计划 → 确认 → 执行)、待删除队列与取消 |
| MCP | 服务器列表(项目级 / 全局、启用状态、传输方式、URL / 命令)、新增与编辑表单、启用 / 停用、连接检查、复制片段、从其他 DSH profile 或 Claude / Cursor / Windsurf / VS Code 配置导入扫描、JSON 导出导入;写入后提示「需要重启」 |
| 右上角重启控件 | 只有一个「重启服务」(进程级)。不因为有会话在跑而禁用:只有「不是桌面应用」或「正在重启」才禁用;点它时现读一次活跃工作,title 与确认弹窗会列出重启会中断什么(运行中的会话 / 排队输入 / 后台任务各几个) |
1.2.0 起不再收编社区市场
dshmarket;2.1.0 起的「插件市场」入口打开的是官方插件页 (@deepseek-ai/dsh-plugin-market/dsh-client-ui-plugin-market只往那一页注册一个discovertab, 没有可复用的组件,所以本面板不重建它)。2.2.0 起该按钮还会自动切到那一页的「发现」tab。
技能启停沿用上游策略:写 SKILL.md 的 user-invocable 策略位,不新增旁路状态。
🔌 插件与市场入口
为什么「几百个插件」里你只装了个位数
官方 listPlugins() 列的是 Loader 条目,不是包:DSH 把自己切成了两百多个 cordis 插件条目
(本机实测 227 条,其中 dsh-base 一个包就声明了 87 条、dsh-web-app 96 条),而你自己装的只有 6 个包。
所以这个 tab 只讲包(listBundles()):一张卡片一个 npm 包,不列 Loader 条目;
默认筛选就是第三方(official === false),打开就只剩你装的那几个。
(条目级的精细开关——比如单独关掉某个内部模块——属于官方「插件」页,那里能看到包内每一行。)
- 包的数据来自官方
pluginManager.listBundles():official(官方维护 / 市场目录)、installed、enabled、version、availability,以及本地化展示元数据meta.title/meta.description/meta.icon(图标是包自带的 base64 data URL,超过 64 KiB 的不透传)。文案由运行时语言解析(ctx.locale.resolveText), 本插件不猜语言。 - 包级启停走
setBundleEnabled(name, enabled)(写 profile 的dsh.profile.bundles,也就是组合里加/减这一层), 由官方服务负责落地:保留注释与!!js表达式、原子写、文件锁——本插件不自己写 YAML。 - 结果原样透出四种结局:
applied(带 hmr 的 profile 立即生效)/restart-required(需要重启)/overridden(被更高优先级的 patch 覆盖)/failed(附官方错误码与诊断)。failed时配置文件其实已经写了,所以页面会保留一条「撤销上次变更」。 - 不可启停的包会说明原因:
management-required(插件管理本身所需)或unaddressable(当前 profile 的 patch 无法唯一定位这一项),与官方页面同一套文案。 官方包的包级开关在本面板禁用(那属于官方页的卸载 / 目录职责),第三方包才是这里的操作对象。 - 不能在这里停用
dsh-toolshed自己:官方保护集里没有它,停掉面板会当场消失且没有恢复入口, 服务层直接回 409self-management。 - 当前部署没有
pluginManager服务(没有 profile,或 DSH < 0.2.2)时如实回 503plugin-manager-unavailable,页面显示「当前部署没有插件管理服务」,而不是装作空清单。 - 可见集和官方插件页一致:官方页会隐藏一批「没有插件页」的包——别的 profile 模板用的基础组合
(
dsh-base、dsh-web-app、dsh-headless、dsh-sdk-app、dsh-sdk-minimal、dsh-acp-app)、 持久终端 bundle、worktree 工具。这些在官方页里连卡片都没有,本页同样不列出 (所以你不会看到dsh-sdk-app/dsh-sdk-minimal,它们不是「前置插件」,是 sdk/sdk-minimal 那两种 profile 模板要用的基础组合;dsh-base更是一停就起不来)。名单是官方HIDDEN_BUNDLES的镜像, 官方新增/改名时以官方页为准。
「插件市场」按钮打开的是一个**「安装插件」弹窗**(不是复刻官方「发现」页):
- 输入
包名/name@1.2.3/git+https://…/ 本地路径 / tarball URL → 「检查」→ 显示识别结果 (包名、版本、一句话简介、是不是 DSH 插件包;git / tarball 这种形式要装完才确认得了)。 - 「安装」走官方
pluginManager.installBundle()(本站不自己跑 pnpm、不自己写package.json)。 安装要执行构建脚本时官方不会装,而是回一份pendingBuilds:弹窗列出这些包名,点「允许并继续」 才带approvedBuilds再调一次。 - 结果如实显示
applied/restart-required(需要重启 DSH)或失败种类(网络、包不存在、pnpm 缺失、 脚本未批准……)加 pnpm 输出尾部,方便直接贴进 issue。 - 想看市场目录(我设的索引、搜索、详情页、版本列表)仍在官方页:弹窗底部按钮会打开官方插件页的「发现」tab。
为什么不把官方「发现」页搬进来:市场客户端只导出
apply(把它的DiscoverSection注册到官方页的plugins.tab),既没有组件也没有render();复刻一遍会跟着市场索引与详情文档的格式一起漂移。 而「输入包名直接装」这件事根本不需要市场索引——它只是官方installBundle的一层壳。
已知限制(易碎):为了把入口收敛到本面板,
register/sidebar-tweaks.ts会隐藏侧栏自带的 「插件」行(官方把它写死常驻,不会丢),并在安全时隐藏「更多」。官方ctx.slots没有「隐藏/条件注册」 能力、也不能反注册他人的槽条目,所以这是 DOM 兜底:只用语义锚点(data-slot="sidebar.panellist"、 按槽条目 label 反查的aria-label、aria-haspopup="menu"),不用构建哈希类名与 nth-child,且全程 fail-open。 官方改侧栏结构后可能藏不掉(不会报错、也不会误伤本面板那一行)。「更多」为什么不能无条件藏:官方侧栏的行过滤是「固定 + 未被取消固定的」,被取消固定的入口只出现在 「更多」菜单里、也只能在那儿重新固定,而固定状态是内存态(刷新才恢复)。藏掉「更多」等于把入口关在门后。 所以本插件只在「渲染出来的行数 ≥ 已注册的面板数」(= 一个都没被取消固定)时才藏它;一旦你取消了某个入口的 固定,「更多」会立刻自己回来给你当回收口。想彻底恢复原样,删掉
client/index.ts里那行ctx.effect(sidebarTweaksFeature, …)即可。
🗂 已归档会话管理
列表先按工作区分组:组头一行(工作区名 + 会话数 + 该组磁盘占用 + 待删除数),点开才展开该工作区的会话行;
没有工作区信息的会话归到「未关联工作区」并压在最底部。勾选不受折叠影响:右上角全选是跨全部工作区的,
每组还有一个自己的组内全选(半选状态也按该组算),组头的「已选/总数」随勾选实时变。
组顺序按工作区名排(固定用 zh-Hans-CN 排序,免得同一个列表在两台机器上顺序不同);组内保持宿主给的顺序。
DSH 只提供归档 / 取消归档,没有删除会话的接口。这个 tab 把缺失的那一步补上,并把边界条件做成显式规则:
- 只有注册表里处于归档态的会话能被操作;id 走路径白名单(
^[A-Za-z0-9][A-Za-z0-9._-]{0,199}$)。 - 仍在内存里的会话不强删:Host 只要打开过一条会话就持有 Agent 句柄,此时删日志会让后端重建无 header 的日志。
这类会话(含它们的 subagent 派生子会话)被登记到
$DSH_HOME/session-admin/pending-deletions.json, 下次 DSH 启动时在浏览器打开会话之前执行;页面显示「待删除」并支持随时取消。 - 删除范围:整棵会话日志目录
sessions/<cwd 编码>/<sessionId 编码>/(绝不截断 zstd 日志)、 投影缓存storages/session_projcache/sessions/<id>.json、绑定到该会话的定时任务、工作区槽位与归档墓碑。 - 附件(可选,默认开):先读被删会话事件得到候选
sha256:对象,再扫描其余全部会话事件 +$DSH_HOME/llm-deepseek/files-v3.json上传索引;只删除没有任何剩余引用的对象。 扫描不完整(读失败 / 超预算)时一个附件都不删,并在结果里报告原因。 - 取消归档会立刻清掉该会话的待删除意图(监听 workspace 域的
domain/changed,页面每次读取也会兜底清理)。 - 已知限制:删除后本页会刷新,但原生侧栏的会话列表可能残留到下一次页面刷新 / 重启; 多开实例时 JSON 存储域是「最后写入者获胜」,建议单实例操作。
🔄 右上角重启控件
重启是进程级实现(DSH 没有给插件暴露重启接口):点击 → 一次确认弹窗 → 写重启计划、拉起脱离进程树的助手
lib/restart-helper.js、HTTP 回复后 taskkill /T 当前 Electron 进程树,助手等旧进程退出、
单实例锁释放后以 GUI 方式重拉同一个可执行文件,页面在宿主恢复后自动重载。日志在
$DSH_HOME/session-admin/restart.log。
没有「安全闸」(2.6.0 起):不会因为「有会话在跑 / 有排队输入 / 有后台任务」而禁用或拒绝。
这些仍然会被读出来(运行中的回合、排队中的输入、running / stopping 的后台 job,已归档会话豁免),
只用于如实告诉你重启会中断什么——按钮的 title 与确认弹窗里会列成「运行中的会话 ×2、后台任务 ×1」。
点确认就执行:点之前你已经确认过没有要继续的东西了。
点「重启服务」时现读一次 GET /api/host/restart——确认弹窗打开时看到的就是当下的实情。
(2.6.1 删掉了那个独立的刷新按钮:安全闸没了之后它只影响一句提示文案的新鲜度,没有存在的必要。)
只在 DSH 桌面应用里可用(判据:ELECTRON_RUN_AS_NODE=1 + argv 含 dsh-desktop-host + 有父进程);
Web / CLI 会如实显示「不可用」——那种形态下杀了自己没人重拉,所以这条判据保留。

🌐 HTTP API
面板的客户端半与脚本共用同源路由(沿用上游的安全闸门:变更方法要求本机回环来源、Origin 与 Host 不符直接 403):
| 方法 | 路径 |
|---|---|
| GET | /dsh-toolshed/api/skills、/api/mcp、/api/skill?name=、/api/roots、/api/import/scan、/api/archived、/api/plugins、/api/host/restart |
| POST | /api/mcp、/api/mcp/toggle、/api/mcp/check、/api/mcp/copy、/api/skills/refresh、/api/skill、/api/skill/policy、/api/import/apply、/api/roots、/api/open/dir、/api/plugins/bundle/toggle、/api/plugins/inspect、/api/plugins/install、/api/host/restart、/api/archive/plan、/api/archive/unarchive、/api/archive/pending/cancel |
| DELETE | /api/mcp、/api/skill、/api/roots、/api/archive |
defineRoutes 按 (kind, path) 收敛,同一路径的多个方法只占一行 webServer.register:2.5.0 起共 22 行。
错误体统一是 { error, code }(重启被挡住时多一个 blockers 数组),面板靠 code 分支。
/api/plugins 在缺少官方 pluginManager 服务时回 503 plugin-manager-unavailable;
/api/plugins/bundle/toggle 在「停用 dsh-toolshed 自己」时回 409 self-management,
正常请求一律 200(application: 'failed' 也是 200 —— 那是业务结局,不是传输错误)。
GET /api/plugins 只返回 { bundles }:插件页以包为单位,Loader 条目不再出现在线协议里
(2.3.0 删掉了行级路由 /api/plugins/toggle)。
/api/plugins/inspect 只做识别(不改任何文件),/api/plugins/install 才会真的跑 pnpm;
后者把官方 ChangeResult 里与装包有关的部分投影出来(含 pendingBuilds 与 pnpm 输出尾部)。
🛠 开发
pnpm install
pnpm typecheck # tsc --noEmit,解析宿主真实类型(当前全绿)
pnpm build # node scripts/build.mjs → lib/index.js + lib/client.js + lib/restart-helper.js
pnpm test # node scripts/run-tests.mjs(vitest;见下方说明)
远程仓库(本项目已脱离 fork 身份,是独立仓库):
| remote | 指向 | 用途 |
|---|---|---|
origin |
z1lyA/dsh-toolshed |
本项目主仓(独立,非 fork) |
upstream |
functy23/dsh-mcp-studio |
只读参考:上游框架层的修复可以 git cherry-pick 过来 |
fork-archive |
z1lyA/dsh-toolshed-fork |
脱离 fork 前的备份,已归档(只读);确认不需要后可在 GitHub 上删除(删除需要 delete_repo 权限:gh auth refresh -s delete_repo 或网页 Settings → Danger Zone) |
本仓库没有 CI:验证依赖 DSH 宿主与 macOS 签名,跑在干净 runner 上只能验一半, 所以
typecheck/test/build一律以本地为准。
pnpm test不是裸vitest run:vite 加载的 rollup 原生绑定既没签名,DSH 自带 Node 又带 hardened runtime,两处都会让dlopen失败。包装脚本scripts/run-tests.mjs会先补一次 ad-hoc 签名, 再挑一个不带 hardened runtime 的 Node 跑 vitest(找不到会给出下一步)。旧裸包名的映射共三处,改一处要三处同改:
scripts/build.mjs(esbuild alias)、tsconfig.json(paths)、vitest.config.ts(resolve.alias)。
构建用 esbuild:DSH 运行时的 Node 开启了 macOS 库验证(library validation), rollup/rolldown 的
.node绑定因 Team ID 不同会dlopen失败。详见 AGENTS.md。
🙏 鸣谢
- deepseek-harness-desktop(Tauri 桌面版,作者 Hairyf 与贡献者)——
本项目搬运的
dsh-tauri-panel-extension、dsh-tauri、dsh-tauri-ui三个包全部来自该仓库, 界面、交互与 host 服务逻辑均为其原始实现;没有它就没有这个插件。请优先支持上游与 Tauri 桌面版。 - z1lyA/dsh-session-admin —— 「已归档」tab 与面板右上角的进程级重启 移植自该插件(含删除边界规则、待删除队列与桌面进程级重启);原始 MIT 许可与改动说明见 THIRD_PARTY_NOTICES.md。
- 官方插件开发文档:https://deepseek-harness.github.io/deepseek-harness/develop/basic/
📄 License
MIT(见 LICENSE)。搬运的上游代码同样以 MIT 发布,并附带 Additional Terms — No Commercial Secondary Development: 不得用于商业性二次开发,本项目亦以非商业开源形式分发。
No comments yet. Be the first to write one.