dsh-armory — 军械库 / Armory

中文 | English

DeepSeek Harness 的一体化管理看板：MCP · 技能 · 专家 · 插件 · 工具账本 · 四大市场，浏览、搜索、一键安装、一键召唤。 fork 自 Imzl-zl/dsh-mcp-manager-ui（MIT），现已扩展为完整军械库。

最新 v2.4.2：文档版——README（中 / 英）与实机功能对齐：三个入口席位与六种档位、悬浮按钮怎么隐藏、看板打开时它如何自动让位，以及 v2.4.1 的 SkillHub 详情修正都写进来了；运行代码与 v2.4.1 完全相同。详见 更新日志。

一键安装

# npm（推荐：免构建授权，装完即用）
dsh plugin --profile web add dsh-armory

# GitHub
dsh plugin --profile web add github:2026heshao/dsh-armory

装完重启 DSH，侧栏顶部「全局面板」里点 大肥鱼军械库（或在右下角悬浮按钮、左侧栏底部入口，三个席位见下文）。桌面端装在 desktop profile 时把 --profile web 换成 --profile desktop。

它解决什么

界面预览

看板五个主要分类页各一张（Windows 桌面端实拍，浅色主题）。2.0.0 新增的「插件」页与 OAuth 授权流程暂无截图：

MCP — 全局管理面板

全局 / 项目双作用域切换，行内启停；全局与各项目之间可以同名共存、各自独立连接：

MCP — 连接详情

传输方式、连接参数、调用超时、配置来源一目了然，下方是该服务器注册的工具清单（本例 170 个，展开可看完整输入 JSON Schema）：

工具裁缝 — 工具使用账本

30 天窗口四张指标卡（调用总次数 / 出现过的工具 / 零调用 MCP 工具 / 整体错误率），逐工具列出调用、错误、错误率、Schema 上下文税与最后使用时间，底部常驻裁缝建议。默认显示全部工具与真实调用次数，需要时点「只看零调用（N）」收窄。指标卡下方是第二条趋势：按天采样日志里每次请求真实下发的工具清单（request/header）并算出它的税，同时给出「窗口内下发清单变过几次」和最近一次的时间；说明栏还会在本机日志短于所选窗口时直接印出「窗口 N 天，读到的调用记录只跨 M 天」，让「数字几天没变」这件事在屏幕上就能归因：

工具表下方新增技能账本：按 skill 工具调用参数里的技能名统计调用 / 错误 / 最后使用，并把当前注册表中零调用的技能补成 0 行——哪些技能注册了却一次没被调用，一眼可见。参数里没有技能名的调用单独计数上屏；注册表不可用时只列出日志里出现过的技能，不伪造 0。

专家 — 已召唤清单

每个召唤的专家 / 专家团一张卡片：绑定技能、详情、送还；团队型专家在详情弹层里有「团队编制」区块（每位成员的职责与人设路径）：

市场 — 三处直连

连接器（WorkBuddy 官方分发 316 个；可安装的标「可安装」，CLI 型 / 需 token 注入的如实标「仅展示」并给出原因）：

技能（SkillHub 公开 API，19 万+ 技能；搜索 + 排序 + 分页，已装的标「已安装」可一键卸载）：

专家（WorkBuddy 专家中心 429 位 / 15 个行业；分类筛选 + 关键词搜索，卡片直接「召唤」）：

功能

• 查看每个 MCP 的状态、传输方式、连接参数与工具列表；展开工具可看完整输入 JSON Schema（必填/可选、类型、枚举、默认值与原始 JSON）
• 按传输方式（HTTP/stdio）与状态筛选，按名称/命令/URL 搜索
• 启用、禁用、重连、添加、编辑、移除；需要时用眼睛临时揭示被掩码的凭据并一键复制
• 全局 + 项目双作用域：全局写 Web profile，一次注册所有项目可用；项目写该项目 .dsh/mcp.json，只该项目会话可见；项目里还能「屏蔽」某个全局 MCP
• 三个入口席位，六档可切：左上角「全局面板」里的大肥鱼军械库一行（宿主官方机制，与「插件」同一套）、右下角悬浮按钮（可拖拽、记忆位置）、左侧栏底部入口（展开态 42px 行、收起成轨道时是圆钮）共用同一个面板；面板右上角「入口」菜单在六档之间切换（两个 / 一个 / 三个席位），不能三个都关，悬浮按钮若是唯一入口则不可单独隐藏（2.4.1 起还能右键 / 长按悬浮按钮直接隐藏它）
• 导入本机其他客户端的 MCP 配置：自动检测 Claude Code、Codex（config.toml）、OpenCode（含 .jsonc）、pi、Claude Desktop、Cursor、Windsurf、VS Code、Gemini CLI、Roo Code 与跨工具的共享配置，逐个列出，点一条即导入；也能粘贴 Claude/Cursor/Cline/Roo 的 mcpServers 或 VS Code 的 servers JSON。写入前预览，支持「合并（同名更新）」与「替换」
• 跟随 DSH 深色/浅色主题，适配窄屏与移动宽度
• 更新提示与一键升级：有新版时在面板顶部显示可关闭的提示条（每天最多查一次，可用 DSH_ARMORY_DISABLE_UPDATE_CHECK 关闭）。点了「升级」才动，不会自动升级；升级由 DSH 官方的 pluginManager 执行，装完提示重启宿主生效。用 link: / file: / github: 装的本地开发副本不给按钮（那会把链接换成 npm 包）
• 升级后主动说一次变了什么：版本变了后第一次打开面板弹一张小卡片，列出本次更新内容，并指路新功能在哪（例如「入口」开关在面板右上角）；确认一次后不再提示，不联网、不发任何数据
• 工具裁缝（1.7.0 新增）：扫描本机会话日志（解析 tool/call / tool/result / request/header 三类事件，不读消息正文），统计每个工具近 7/30/90 天的调用次数、错误率与最后使用时间；上下文税给两个口径——按当前注册表估算的 Schema 快照（它是 Schema 长度的纯函数，只有改动注册表才会变），以及按天采样 request/header 得到的每轮真实下发清单税，两者差额非零时说明栏指出「改了没生效 / 线上下发的比注册表多」；窗口内零调用的 MCP 工具自动进「死工具清单」，行内可一键禁用/启用对应服务器（复用官方写链，随时可恢复）。默认显示全部工具与真实调用次数，零调用的行以底色标出；想只看死工具时点「只看零调用（N）」切换。顶部说明栏常驻回显「显示 N/M 个工具」，避免筛选态被误读成「所有计数都是 0」；本机日志覆盖不足窗口天数、或有条目缺时间戳（undatedCalls）时也在这里显形，不再静默。账本缓存行只读（「清空缓存」按钮已删——实测既不回收空间也不修任何事）。全程只读，多帧 zstd 日志逐帧解析、个别帧损坏跳过不中断
• WB 市场（直连安装，1.8.0 新增）：看板第四个分类，两个市场一处浏览——
  • 连接器（MCP）：直读 WorkBuddy 官方分发 ZIP（static.workbuddy.cn，与 WorkBuddy 桌面端同一数据源），316 个连接器按需解析；可安装的 242 个（streamable-http 为主），CLI 型 / 需 WorkBuddy token 注入的 74 个如实标注「仅展示」并给出原因。安装 = 把该连接器的 mcpServers 合并写入 MCP 配置，与「导入 JSON」同一链路（准入、同名跳过、entry id 预留一致），全局与项目作用域都可选；ZIP 按 ETag 缓存在 ~/.dsh/wb-market/，解压用 Node 内置 zlib，零新增运行时依赖
  • 技能（SkillHub）：直读 SkillHub 公开 API（api.skillhub.cn，19 万+ 技能），支持搜索（keyword）、排序（下载/安装/星标/评分）、分页；详情含发布方认证与安全扫描状态。安装 = 逐文件下载并按清单 sha256 校验后写入 ~/.agents/skills/（与官方 skill 子系统同一发现范围），装完即刻生效；已装的显示「已安装」，可一键卸载、重装即更新。下载量排序在当前页内本地完成（上游 sortBy=downloads 现在会挂起），其余排序照常走远程；单次请求 15 秒超时，超时文案已中文化
  • 技能版权归原作者所有；两个均为第三方接口，字段可能随上游改版变化（面板顶部有常驻说明）
• 专家直连（1.9.0 新增，体验对齐 WorkBuddy 专家中心）：看板独立分类「专家」（侧栏入口同步更名「技能 · MCP · 专家」）——
  • 目录：直读 WorkBuddy 专家中心官方分发（expert_center.json，429 位专家 / 15 个行业分类，ETag 缓存在 ~/.dsh/wb-market/experts/），分类筛选 + 关键词搜索 + 详情弹层（召唤前看人设正文、捆绑技能、试试这样问）
  • 人设来源（2.4.3）：详情与召唤按「本机覆盖 → 本机 WorkBuddy 缓存（~/.workbuddy/plugins/cache/experts/<包>/<版本>/agents/）→ 公开分发地址 → 兜底人设」取数。上游目录里约四成专家（429 位中的 185 位，例如「技能匠人」skill-smith）其实没有公开分发人设文件；本机 WorkBuddy 用过它就直接读缓存，三条正路都没有时会用专家中心公开的介绍、标签与示例问题生成一份兜底人设，正文第一段就写明「这份人设不是原文」，保证任何一位专家都能看详情、能召唤（issue #5）。
  • 召唤 = 往 profile 补丁写入一条独立 Agent 预设（@deepseek-ai/dsh-agent-preset 行，plugins 复刻内置 standard 预设、仅 persona 的 prefix 换成专家人设全文）——新建会话时选择「WorkBuddy 专家 · …」即专家接管该会话，标准工具/规划/压缩/委派原样保留；多个专家可共存，写入走既有 patch 写链（文件锁 + 版本校验 + 原子写），其余条目、注释与 !!js 表达式原样保留
  • 捆绑技能：召唤时可勾选一并安装——本机 WorkBuddy 缓存（~/.workbuddy/plugins/cache/experts/）有完整技能树就整目录复制到 ~/.agents/skills/（wbexpert__ 前缀，即刻被技能注册表发现）；无缓存时按 CDN 的 SKILL.md 单文件兜底并如实标注来源
  • 团队型专家（1.9.4 可召唤）：WorkBuddy 的 53 个「专家团」人设原本依赖 TeamCreate / Agent(name=…) 两个 DSH 没有的工具。召唤时除了写主理人预设，还会把每位成员的人设各自落成一份文件（~/.dsh/wb-market/experts/teams/<专家>/），并在主理人人设末尾追加一段运行时适配：建团队 → 无需调用（编制已在召唤时固定）；派活 → subagent（先把该成员人设 read 出来拼进 prompt），顺序 SOP 传 run_in_background: false 当场等结果；续聊用 send_message。原人设的铁律（不得代写成员产出、成员之间不直连、一切经主理人中转）原样保留。成员人设不进系统提示（否则每轮都要为 5 份人设白付上下文费），只在调度时按需读取
  • 送还 = 摘除该召唤预设、对应技能目录与团队成员人设（热加载，无需重启）
• 召唤菜单（会话内快速调用，1.9.3 增强）：会话输入框工具行右侧的看板小图标 → 「技能 / MCP / 专家」三分类，悬停展开子菜单，点一条即把引用写进输入框（技能 = /技能名、MCP = 点名 mcp__服务__*、专家 = 挂到当前会话）——
  • 每屏 6 行 + 滚动：子菜单一次显示 6 条，超出的往下滚（细滚动条跟随主题）；「管理技能 / MCP / 专家…」固定在底部，不被列表滚走
  • 最近使用置顶：刚用过的条目自动排到最前并带「最近」标记，其余保持原有顺序；最近使用记录池 40 条
  • 专家随时挂 / 换 / 摘：点一个专家即接管当前会话（包括已经聊了一半的），再点别的直接替换，点 chip 的 × 立刻取消；只影响这一个会话，不动工具目录、不写任何持久化配置
  • 显示与实效一致：挂专家后，会话标题栏显示的始终是当前真正生效的专家（宿主那条「会话创建时的预设」标签在挂载期间自动让位）；三处显示（标题栏徽章、输入框 chip、菜单）挂/换/摘后同帧同步
• 插件市场（2.0.0 新增；2.3.x 只保留 DSH 社区）：新增「插件」页，直连 awesome-dsh-plugins 社区清单，可搜索、可筛选，每条标明可装性——
  • DSH 社区：awesome-dsh-plugins 社区清单（单文件裸 JSON、五千余条，jsdelivr 主源 → fastly 备源），拉取后瘦身到 SLIM_MAX_BYTES = 3MB 再落缓存；更新检测先经 GitHub API 把 main 解析到最新提交 SHA、再按 @<SHA> 不可变地址取数（绕开 jsdelivr 对分支地址的 12h CDN 缓存，API 不可达时回落分支地址 + ETag 条件请求）
  • 社区双源聚合（2.3.x）：在 awesome-dsh-plugins 之上聚合第二社区注册表 awesome-dsh-plugin.com（CC0，经其 npm 包 dsh-plugin-catalog 分发，jsdelivr 主备镜像）——只并入其 npm 可装 条目（git-only 不进面板），按 npm 包名与主源去重、主源优先，面板目录 ~7.2k 条且全部可安装；取数走「registry 解析 latest 版本号 → jsDelivr @<版本> 不可变地址」（与主源 SHA 机制同构），两源并行拉取、各自独立容错，任一源挂掉只少一块、不拖垮面板
  • 宿主组件：清单内属于 DSH 宿主官方分发的条目（@deepseek-ai/ 前缀）标注「宿主组件」，随宿主本体分发，不提供安装
  • 安装：统一走宿主 pluginManager.installBundle 拉取落盘，装完需重启 DSH 宿主才生效；宿主无 pluginManager / 条目无 npm 包名 / 宿主组件三种情况各自给出明确文案，不静默失败
• MCP OAuth 一键授权（2.0.0 新增）：官方 @deepseek-ai/dsh-mcp-client 的 transport 只认 requestInit.headers、没有 authProvider，所以 OAuth 必须在安装前由本插件跑完，把 authorization: Bearer <token> 静态写进 patch 的 headers，此后由本模块负责刷新——
  • 按 RFC 9728（受保护资源元数据）→ RFC 8414（授权服务器元数据）→ RFC 7591（动态客户端注册）→ RFC 7636 PKCE（只发 S256）→ RFC 8707（resource 参数）逐条实现
  • 回调通道三级降级：本地 127.0.0.1:<随机端口>/callback 自动收 code（主流实现）→ DCR 只接受自定义 scheme 时提示「粘贴完整回调地址」→ 都不通则直接「粘贴访问令牌」
  • 服务器返回 401 时自动弹出「授权 {服务器}」对话框并打开浏览器，无需用户先去找入口
• 安装凭据引导（2.0.0 新增）：安装前扫 mcpServers 里的 ${...} 占位符，弹「填写 {连接器} 的凭据」逐槽填写后「带凭据安装」；留空表示稍后自行补全，装完提示「另有 N 个占位符未填写，配置里保留原样」；无占位符的连接器直接放行
• 安装状态账本（2.0.0 新增）：~/.dsh/armory/install-state.json（INSTALL_STATE_VERSION = 1）记录每条连接器 / 技能 / 插件的 source {marketplace, url, kind}，市场页据此支持跨页筛出已安装项（技能侧仍只筛当前页，两处文案分别说明），并把「本插件装的」与「别处手动配的」分开；登记失败不影响安装，只补一句提示
• 技能看板分类（2.0.0 新增）：技能按 **编程开发 / 设计与创作 / 文档办公 / 效率与自动化 / 开发运维 / 未分类