dsh-armory — 军械库 / Armory

中文 | English

DeepSeek Harness 的一体化管理看板：MCP 服务器 · 技能 · 专家 · 插件 · 工具使用账本 · 四大市场（WorkBuddy 连接器 316 个 / 内置精选 47 个 / SkillHub 技能 19 万+ / WorkBuddy 专家 429 位 / CodeBuddy 官方插件 + DSH 社区清单），浏览、搜索、一键安装、一键召唤。 本项目 fork 并改写自 Imzl-zl/dsh-mcp-manager-ui（MIT，原项目仅 MCP 管理），现仓库为 2026heshao/dsh-armory， 从纯 MCP 管理面板升级为 MCP + 技能 + 专家 + 插件 + 市场 + 工具账本 看板。

v2.0.0 起：新增「插件」页（三个来源）、MCP OAuth 一键授权、安装凭据引导、安装状态账本、技能看板六大分类。详见 更新日志。 v2.1.0 起：社区插件点开即可就地读 README（按需拉取 + 7 天落盘缓存 + javascript: 伪协议链接降级），并修掉「秒开快照顶掉真实目录」「更新探测误报失败」两处。详见 更新日志。

一键安装

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

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

装完重启 DSH，侧栏顶部「全局面板」里点 技能 · MCP · 专家（或右下角悬浮按钮）。桌面端装在 desktop profile 时把 --profile web 换成 --profile desktop。

它解决什么

痛点	本插件的做法
MCP 配置要手改 YAML，改完不知道连没连上	可视化面板：状态、工具 Schema、启停、重连，全局与项目双作用域，项目级改完即对存活会话生效
装技能要去各处翻 SKILL.md 仓库	市场直连：SkillHub 19 万+ 技能、WorkBuddy 316 个连接器、47 个一手核实的内置服务，搜索/筛选/一键安装，逐文件 sha256 校验
每个 MCP 的工具描述都在吃上下文 token，零调用的工具白白占位	工具裁缝：扫描本机会话日志统计每个工具的调用/错误/延迟，死工具清单一键禁用
从 Claude/Cursor/VS Code 迁移要逐条抄配置	自动检出 11 种客户端的本机配置，预览后一键导入
插件散在宿主自带、CodeBuddy 官方、社区清单三处，格式与可装性各不相同	插件页：三个来源并进一个可搜索目录并标明可装性，安装统一走宿主 pluginManager，装完明确提示需重启
远端 MCP 要 OAuth，而官方 client 只认静态 headers，只能手搓 token	一键授权：按 RFC 9728/8414/7591/7636/8707 走完发现 → 注册 → PKCE → 回调 → 换 token，回调通道三级降级（loopback / 粘贴回调地址 / 手贴 token），到期自动刷新
装过的连接器、插件，过几天忘了是从哪来的	安装状态账本：~/.dsh/armory/install-state.json 记录每条的来源市场，市场页可跨页筛出已安装项，并把「本插件装的」与「别处手动配的」分开

界面预览

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

MCP — 全局管理面板

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

MCP — 连接详情

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

工具裁缝 — 工具使用账本

30 天窗口四张指标卡（调用总次数 / 出现过的工具 / 零调用 MCP 工具 / 整体错误率），逐工具列出调用、错误、错误率、Schema 上下文税与最后使用时间，底部常驻裁缝建议。默认显示全部工具与真实调用次数，需要时点「只看零调用（N）」收窄：

专家 — 已召唤清单

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

市场 — 三处直连

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

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

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

功能

• 查看每个 MCP 的状态、传输方式、连接参数与工具列表；展开工具可看完整输入 JSON Schema（必填/可选、类型、枚举、默认值与原始 JSON）
• 按传输方式（HTTP/stdio）与状态筛选，按名称/命令/URL 搜索
• 启用、禁用、重连、添加、编辑、移除；需要时用眼睛临时揭示被掩码的凭据并一键复制
• 全局 + 项目双作用域：全局写 Web profile，一次注册所有项目可用；项目写该项目 .dsh/mcp.json，只该项目会话可见；项目里还能「屏蔽」某个全局 MCP
• 两个入口，同一个面板：右下角悬浮按钮（可拖拽、记忆位置）与官方侧栏入口（展开态在「设置」上方显示「MCP」，收起成 56px 轨道时只剩图标）共享同一开关状态；面板右上角「入口」可以把两者只留一个（不能都关）
• MCP 市场：47 个逐条一手核实过的服务，分 10 类（搜索、开发工具、安全与逆向、数据库与数据、AI 与知识、浏览器自动化、云与基础设施、效率协作、文件与本地、通讯）。搜索为主操作，配分类与「只要免密钥」筛选、排序、卡片直接安装；每条如实标注免费额度与需要准备什么（密钥 / 连接信息 / 装完还得改的参数）。已配置的只识别并跳过，不覆盖
• 导入本机其他客户端的 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 两类事件，不读消息正文），统计每个工具近 7/30/90 天的调用次数、错误率与最后使用时间；同时按当前注册表估算每个工具 Schema 每轮请求占用的上下文 token。窗口内零调用的 MCP 工具自动进「死工具清单」，行内可一键禁用/启用对应服务器（复用官方写链，随时可恢复）。默认显示全部工具与真实调用次数，零调用的行以底色标出；想只看死工具时点「只看零调用（N）」切换。顶部说明栏常驻回显「显示 N/M 个工具」，避免筛选态被误读成「所有计数都是 0」。全程只读，多帧 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 子系统同一发现范围），装完即刻生效；已装的显示「已安装」，可一键卸载、重装即更新
  • 技能版权归原作者所有；两个均为第三方接口，字段可能随上游改版变化（面板顶部有常驻说明）
• 专家直连（1.9.0 新增，体验对齐 WorkBuddy 专家中心）：看板独立分类「专家」（侧栏入口同步更名「技能 · MCP · 专家」）——
  • 目录：直读 WorkBuddy 专家中心官方分发（expert_center.json，429 位专家 / 15 个行业分类，ETag 缓存在 ~/.dsh/wb-market/experts/），分类筛选 + 关键词搜索 + 详情弹层（召唤前看人设正文、捆绑技能、试试这样问）
  • 召唤 = 往 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 新增）：新增「插件」页，把三类来源并进一个可搜索、可筛选的目录，每条标明来源与可装性——
  • 官方：DSH 宿主自带组件，随宿主分发，不可单独安装（仅展示）
  • CodeBuddy 官方：ZIP 分发，解析 .codebuddy-plugin/marketplace.json 与 external_plugins/<name>/.codebuddy-plugin/plugin.json（MAX_ZIP_BYTES = 64MB，ETag 命中不重下）
  • DSH 社区：awesome-dsh-plugins 社区清单（单文件裸 JSON、五千余条，jsdelivr 主源 → fastly 备源），拉取后瘦身到 SLIM_MAX_BYTES = 3MB 再落缓存
  • 安装：统一走宿主 pluginManager.installBundle 拉取落盘，装完需重启 DSH 宿主才生效；宿主无 pluginManager / 条目无 npm 包名 / 无 repository 三种情况各自给出明确文案，不静默失败
• 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 新增）：技能按 编程开发 / 设计与创作 / 文档办公 / 效率与自动化 / 开发运维 / 未分类 六类归置，网格与列表双视图可切、可按分类过滤，常驻「显示 N / M 个 skill」；详情新增所属分类、来源目录、文件位置，可一键「复制 SKILL.md 路径」「复制 @会话引用」。看板仍是只读的（宿主只提供 listSkills / skillDetail）
• 多市场注册表（2.0.0 新增）：市场源不再硬编码，落 ~/.dsh/armory/marketplaces.json（REGISTRY_VERSION = 1），缺失或损坏回落内置默认项、首读即落盘，支持增删改；写盘一律 staging + rename 原子替换
• 社区目录秒开（2.0.0 新增）：上次成功的精简清单镜像进浏览器 localStorage（7 天 / 4MB 上限，超配额保留旧快照），首屏先渲染快照再被真实结果静默替换（0 网络 0 IPC）；源不可达时明说「显示的是本地缓存」而非给空列表
• 社区 README 预览（2.1.0 新增）：点开「插件 → DSH 社区」任意卡片，即就地拉取并渲染该仓库 README（标题 / 段落 / 列表 / 表格 / 代码块 / 引用，含 <p align="center"><img …> 横幅）——
  • 按需、只取一次：README 不进目录的瘦身缓存，点开才拉；按 README.md / readme.md / Readme.md / README.MD / README.markdown / README_EN.md 顺序试；仓库填的是 npm 包名时，先问 registry.npmjs.org 取 repository，拿到再去 GitHub 取原文
  • 限额与缓存：单次 20s 超时、正文 16 万字符上限（超了截断并在界面标注）；取到后按「仓库或 npm 包名」落盘缓存 7 天，同一插件再点秒开，断网 / 限流 / 仓库被删回落缓存并标明「这是缓存」
  • 图片与安全：http(s) 图片过 wsrv.nl 只读代理（output=webp&q=72&w=880，仅对白名单主机生效），相对路径按仓库地址还原成绝对 URL、还原不了就跳过；正文由自写解析器生成 React 元素，不碰 dangerouslySetInnerHTML，javascript: / data: / vbscript: 伪协议链接一律降级成纯文本
• 社区目录与更新探测修正（2.1.0）：秒开快照不再顶掉真实目录（此前快照一渲染真实结果就被丢弃，目录于是一直停在旧快照）；更新探测与目录改走同一条源链（先问这份缓存实际来自哪个源、再兜底其余源，首个拿到 ETag 的源胜出），修掉「主源不通的机器上目录能开、点检查更新却每次 probe-failed」

安装

# 从 npm 安装（推荐）
dsh plugin --profile web add dsh-armory

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

装完重启 DSH（桌面端重启应用，Web 端重启 dsh web；桌面端把 --profile web 换成 --profile desktop）。升级：npm 安装可在面板「一键升级」提示条上直接点，GitHub 安装换新版 tag 重新 add。卸载（不会删除 profile 里已有的 MCP 条目）：

dsh plugin --profile web remove dsh-armory

细节、本地开发安装与故障排查见 安装与升级。

不要把 dsh-armory 手工插进 profile 的 cordis.patch.yml、Agent preset 或额外的 --patch 文件——插件命令已经完成这件事，重复装配会明确报错。

使用

打开面板

两个入口，同一个面板：

• 右下角悬浮按钮：可拖拽移动，位置会被记住；
• 侧栏「技能 · MCP · 专家」：展开态在「设置」上方，侧栏收起成 56px 轨道时只剩图标。

面板浮在会话之上，关掉它（右上角「关闭」或 Esc）不会影响会话。

两个入口都能单独关掉：面板右上角「入口」里选 悬浮按钮 + 侧栏入口（默认）/ 仅悬浮按钮 / 仅侧栏入口。不能两个都关——面板只能从这两个入口打开，所以这是一个三选一，而不是两个独立的开关。选择存在浏览器本地（localStorage），换浏览器或清缓存要重选一次。

全局 vs 项目

顶部标签页在「全局」与各项目之间切换：

标签页	存哪	谁可见	改动何时生效
全局	Web profile 的 cordis.patch.yml	所有项目	DSH 热加载，通常立即生效
某项目	该项目 .dsh/mcp.json	只该项目会话	写盘即生效（见下）

serverName 按作用域判重：不同项目之间、全局与项目之间可以同名，各自独立连接；同一作用域内不能重名。

常用操作

在列表行或详情页里：

• 开关：启用 / 禁用（全局写 profile 补丁的 disabled，项目写 .dsh/mcp.json）；
• 重连：全局条目重载 loader 条目；项目连接会拆掉旧连接、按当前配置重建并重新投射给存活会话（mcp-client 的重连预算耗尽后必须靠它恢复）；
• 编辑 / 移除：移除只影响当前作用域；
• 屏蔽（项目页里对全局 MCP）：写 exclude，该项目的新会话不再看到它——全局实例仍在跑，所以不影响其他项目。

添加 MCP

三条路，都从面板顶部工具栏进：

1. 添加 MCP：表单填 command/args/env/cwd（stdio）或 url/headers（HTTP），可设调用超时、启动失败策略与重连策略；常用服务器有预设模板可一键套用。
2. 导入 JSON：粘贴其他客户端的配置，先预览再写入。支持「合并（同名更新）」与「替换」，字段映射与限制见 JSON 导入。
3. 内置 MCP：勾选未配置的项一次装好（Exa、Tavily、Firecrawl、Chrome DevTools、Playwright）。前三项有免密额度、不需要本地依赖；后两项是本地工具，需要 Node.js 与浏览器。已配置的项只识别并跳过，不会覆盖。

看工具与敏感值

详情页列出该 MCP 当前注册的工具；展开可看完整输入 Schema。凭据类字段默认掩码，点眼睛图标会向 Host 读取有效运行值（已解析过的环境变量）并临时显示，再点一次恢复；已显示的值可一键复制。编辑时若没实际改动输入，保存仍保留原来的引用写法，不会把密钥写回配置文件。

配置生效时机（重要）

作用域	修改后何时生效
全局	DSH 热加载，通常立即生效（含运行中的会话）
项目	写盘即生效：新增立刻挂上存活会话、删除立刻撤掉工具、改动就地重载连接（工具名不变）

项目 MCP 由本项目所有会话共用一份连接，配置写在 .dsh/mcp.json。面板保存的那一刻就会对齐到正在运行的会话，不需要重开会话，也不需要重启 Host；手工编辑该文件则在下一次会话挂载时被采纳。

连接跟配置走，不跟会话走：最后一个会话结束不会拆掉连接，它只进入空闲等待，下一次会话直接复用——这样"要用的时候"它已经就绪（这也是宿主自己的契约：工具必须在首轮之前出现）。两个旋钮写在 server 条目里：idleTimeoutMs（空闲保留多久，默认 5 分钟，0 = 永不回收）与 readyTimeoutMs（挂载时等就绪的总预算，默认 5s，0 = 不等）。字段速查与边界见 设计与限制。

状态怎么看：项目行把两件独立的事分开说，不合成一个状态。

• 连接在不在：已连接 · 当前无会话使用（连接保留，下次直接用） / 已连接 · N 个会话在用 / 连接中… / 连接失败 / 尚未建立连接（新会话自动挂载）。
• 几个会话在用：见上一行的 N 个会话在用；不再出现「待会话挂载」那种把两者压成一句、容易被读成"还没连上"的写法。

重连是必需出口：mcp-client 的自动重连有次数上限，耗尽后它会注销工具并停止，只能靠重载配置或重启宿主恢复（它的 README 明写）。项目 MCP 又不是常驻服务，所以面板的「重连」按钮会拆掉旧连接、按当前配置重建，并重新投射给存活会话。

常见问题

面板里显示「已禁用」，但模型调用报 unknown tool "mcp__xxx__..." 那个 MCP 被禁用了，所以它没有注册任何工具。在面板里点「启用」即可（全局会写 profile 补丁并热加载，项目写 .dsh/mcp.json、写盘即生效）。

那一行显示「挂载失败」「连接失败」或「作用域隔离失败」，怎么区分？ 三类是不同的事，详情页会给出具体原因：挂载失败 = 会话挂载阶段（agent/created 监听器）就没挂上（变量求值为空、failOnStartupError 下启动失败、工具注册被拒）；连接失败 = mcp-client 连不上或重连耗尽（原因取自它的日志）；作用域隔离失败 = 连接正常但工具不在共享作用域层（宿主里出现了两份 @deepseek-ai/dsh-scope）。排查与原理见 设计与限制。

项目行那些状态文案分别是什么意思？ 它们把两件独立的事分开说：连接在不在 —— 已连接 · 当前无会话使用（连接保留，下次直接用）（最后一个会话结束了，连接按空闲策略留着）/ 已连接 · N 个会话在用 · M 工具 / 连接中… / 连接失败 / 尚未建立连接（新会话自动挂载）；几个会话在用 —— 就是那句里的 N 个会话在用。旧版本的「待会话挂载」正是把这两件事压成一句，所以容易被读成"还没连上"。

怎么升级？为什么面板没提示？ 从 npm 装的直接 dsh plugin --profile web update dsh-armory 就会升小版本，也可以直接点面板提示条上的「升级」（同一件事，免去敲命令）。面板的提示条只查 GitHub Releases、每天最多一次、可关闭、不会自己动；固定 tag 安装的用户不会自动跨版本，需要用新 tag 重新 add（见 安装与升级）。

改动会不会碰到我的其他配置？ 不会。全局改动只动 profile 补丁里由 @deepseek-ai/dsh-mcp-client 声明、且由本插件管理的条目，保留其他插件条目、注释与 !!js 表达式；导入「替换」也只替换这一部分，不会删除其他 bundle 或 Agent preset 自带的 MCP。

卸载后我配置的 MCP 会消失吗？ 卸载插件不会删除 profile 里已有的 @deepseek-ai/dsh-mcp-client 条目；项目的 .dsh/mcp.json 也留在原处（它本来就是普通 JSON 文件）。

兼容性

项目	已验证
DeepSeek Harness	0.1.5-rc.1 及以上（已验证至 0.2.1-rc.2，DSH 44.7.0）
Node.js	DSH 自带/支持的运行时
平台	Windows；Linux/macOS 使用同一 DSH Web 契约

只支持 0.1.5 起（更早的版本缺少「按注册作用域判 serverName 唯一性」与「setup 传入 agent」两个能力），不为旧版本保留降级分支。原因与依赖细节见 设计与限制。

开发

npm install --no-save yaml@2 eslint@9   # 测试与风格检查的唯一裸依赖（运行依赖全部由宿主提供）
npm test                                # 全 33 套件（与 CI / 发版门槛同一条）
npm run lint                            # ESLint：no-undef / no-unused-vars / no-empty 等
npm run test:e2e                        # 可选：用宿主补丁算法验证专家预设进入组合树
dsh --profile web --dump-config         # 看 profile 的有效配置
dsh web                                 # 起 Web 做真实操作验证

npm test 跑的是 test/run-all.mjs，依次执行 33 个独立套件（各自是独立 node 进程，任一非零退出即整体失败）。套件是显式白名单而非 node --test 自动发现——test/ 下还有带副作用的迁移脚本与需要宿主模块的端到端脚本，自动发现会误跑。

分组	套件	覆盖
账本与配置层	tool-ledger mcp-config	工具账本的 zstd/缓存/尺寸闸门；MCP 配置归一化与 patch 往返
契约与入口	contract-consistency client-entry host-import-sources	面板可调方法必须在 typert 声明 / client 契约数组 / 宿主方法集三处同时存在；三个入口「全关」不可表达；VS Code ${input:} 降级
客户端质量	client-i18n i18n-coverage error-boundary-copy persona-truncate tailor-window	中文皆包 t()；en-US 字典双向差集；崩溃详情可复制；persona 4000 预览阈值；工具裁缝时间窗四档
专家与团队	run-expert-manual session-persona team-bridge expert-card-actions recent-sort-regression	专家市场写链（真网目录 + 人设 + patch 往返，33 条断言）；会话级挂/换/摘；团队桥接；卡片按钮真值表；「最近使用」排序
升级与安装真机	upgrade-plan verify-install-info verify-host-installinfo teardown-residue	一键升级判据（本地安装 / 来源未知一律不写）；真 profile 数据下的来源判定（profile 不存在自行 SKIP）；teardown 残留诊断
市场与安装链（2.0.0）	wb-registry wb-install-state wb-auth-rules wb-connector-meta wb-plugin-market wb-awesome-market wb-install-flow wb-update-hint auth-gate-regression install-toast	多市场注册表原子写；安装状态与来源锁；令牌槽扫描与注入规则；连接器 R1/R2/R3 投影；插件清单嵌套解析；awesome 过滤/瘦身/304/双源切换；令牌替换写链；R9 更新探测五枚举；装前 401 鉴权闸；顶部安装浮层跨卸载可见
社区与前端护栏（2.1.0）	awesome-readme no-conditional-hooks	README 仓库解析（npm / GitHub URL 归一）；解析器渲染结构与 javascript: / data: 伪链接拦截；组件内禁止条件调用 Hook（React #310）
回归护栏	readme-images bugfix-armory	README 配图不回退（引用可解析 + screenshots.json 与 README 一致 + 旧图名不得复活）；市场入口强制选中与看板页重复让位

本机存在 ~/.dsh/profiles/desktop/cordis.patch.yml 时，run-expert-manual.mjs 会追加一组真实 profile 往返断言，没有则记 SKIP。

auth-gate-regression.mjs 的被测对象是运行时副本（~/.dsh/profiles/desktop/node_modules/dsh-armory/lib/），开工前做 SHA256 哈希预检，不符即中止。

CI（.github/workflows/ci.yml）与发版门槛（.github/workflows/release.yml）跑同两条命令：npm run lint + npm test，两处口径不许分叉。release.yml 另外校验 tag / package.json / lib/whats-new.js / .github/release-notes/v<version>.md 四者版本一致，才 npm publish 并建 GitHub Release；发版流程见 安装与升级。

本机若没有 yaml，npm test 会以 ERR_MODULE_NOT_FOUND 退出——test/loader.mjs 会先试标准解析，失败才回退开发机的 profile 副本（~/.dsh/profiles/desktop/node_modules），所以干净环境必须先装依赖。

文档

• 安装与升级
• JSON 导入
• 设计与限制（共享连接模型、连接状态语义、已知限制、依赖细节）
• DeepSeek Harness 官方插件发布指南

相关链接

• LINUX DO（友链）
• DeepSeek Harness
• GitHub dsh-plugin 主题

License

MIT