dsh-forge · DSH 锻造台

DeepSeek Harness 的运行时扩展套件：像 Minecraft 的 Forge 一样，为 DSH 锻造、安装、路由、编排插件。 A runtime extension suite for DeepSeek Harness — forge, install, route and orchestrate plugins the Forge way.

Topics: dsh-plugin deepseek-harness dsh cordis · 更多社区插件见 https://github.com/topics/dsh-plugin

这是什么

dsh-forge 是运行在 ~/.dsh 用户层的一整套 DSH 扩展，不 monkey-patch 任何 npm 包。核心四件套：

协作与编排层（12 个 host 插件）：

• mailbridge — 跨会话邮箱：session_list / session_read / session_send / mailbox_check，离线消息持久排队、重启后自动投递
• teamhub — Claude-Code 风格 agent 团队：captain + 成员子代理 + 依赖排序任务板 + 成员间直连消息
• llmrouter — 多厂商模型委派：model_list / model_call，一次任务丢给任意 provider/model
• modelroute — 子代理模型继承策略（永不静默升级到更贵 tier）+ 模型系列 taxonomy + plan 计费路由
• modeswitch / modsub — 会话中途切 preset；指定模型 spawn 子代理
• injector — BepInEx 式运行时注入：symlink + loader.create + 持久注册表，重启自动恢复
• dynboot / dynrestore — auto-plugins.json 动态插件重启恢复 + 页面刷新重挂客户端
• imgsub-bridge — 子代理图片消息转附件引用

动态插件（dynamic/auto-plugins.json，内联 host+client 代码）：模式下拉框、模型+等级选择器、子代理图片补丁、技能管理面板、插件市场面板，以及三条补丁型插件——subflt（子代理 report/结算通道 steer 化 + 同轮去重）、stfx（侧栏 Settings 行对齐）、steer（子代理会话 Ctrl+Enter 插话）。

为什么叫 forge

DSH 的插件生态和 Minecraft 的 mod 生态很像：一个稳定的宿主（Harness），海量第三方扩展（插件），以及把这一切管理起来的装载层。Forge 就是那层——注入（装载）、路由（兼容）、市场（分发）、锻造（创作）。

安装

推荐：npm 包（官方插件机制，含全部 host 插件）

dsh plugin --profile web add @dsh-forge/bundle

@dsh-forge/bundle 声明官方 dsh.bundle.patch manifest，dsh plugin add 会自动把它注册进 profile 的 patch 层；装完重启 DSH（dsh web）即可。需要 0.1.4+（0.1.3 及更早版本在 npm 路径下 boot 失败，为已知历史 bug）。

可选组件：任务感知路由 preset（手动复制）

cp -r presets/router-standard $DSH_HOME/.agent-presets/
# 新建会话选择「路由标准（实验性）」preset

npm bundle 不含 preset 与动态面板，需要时从源码仓库复制。

从源码安装（完整套件：host 插件 + 动态面板 + preset）

git clone https://github.com/alex04130/dsh-forge.git
cd dsh-forge
node scripts/install.mjs     # 复制到 $DSH_HOME，自动备份、幂等
# 重启 DSH（dsh web），新建会话选择「路由标准（实验性）」preset

或手动对照 bundle/、dynamic/、presets/ 目录复制；本地路径形态：dsh plugin --profile web add <path>/bundle。

可选：GitHub MCP 工具（mcpgithub*，默认不集成）

默认不集成（bundle/cordis.patch.yml 已不含 mcp-github 条目）。以下为手动可选配置， 需自备 token：

1. 本地安装 MCP server（依赖运行时目录 ~/.dsh/mcp/github-server/，不进仓库；本机 npm 全局/缓存目录可能只读，故指定 --cache /tmp/npm-cache）：

npm install --prefix ~/.dsh/mcp/github-server --cache /tmp/npm-cache \
  --no-bin-links --no-package-lock @modelcontextprotocol/server-github

2. 在 profile 的 cordis.patch.yml 里手工追加 mcp-github 条目（stdio 走 node ~/.dsh/mcp/github-server/node_modules/@modelcontextprotocol/server-github/dist/index.js， serverName=github，工具名 mcp__github__*）。

token 由 DSH 进程环境变量 GITHUB_PERSONAL_ACCESS_TOKEN / GITHUB_TOKEN 提供，配置文件不落密钥。

验证

npm run check（全部 host/client 代码语法自检）。运行时验证：dev_plugin_status（注入器）、skill_list（技能）、model_taxonomy（路由）、dev_router_status（思维模式路由）。

平台支持

Windows / macOS / Linux 全平台可用：

• 路径运行时派生：全部插件用 process.env.DSH_HOME || join(os.homedir(), '.dsh') 解析 DSH 家目录，无硬编码绝对路径。
• 注入与安装：scripts/install.mjs 与注入器均带 win32 junction 回退（无符号链接权限时自动降级）。
• 动态插件 shell 操作（插件市场 / session_find 等）全部改写为 node -e 跨平台实现（bash 与 pwsh 双壳安全引用），不依赖 POSIX 命令。
• 发布脚本 scripts/publish-client-packages.sh 为维护者本机专用（POSIX），不影响使用端。

已知限制

• teamhub：队长代认领的任务，成员本人无法 update（assignee 记录 memberId、鉴权用 sessionId）；team_create / team_add_member 的审批等待会串行阻塞其他 team_* 调用（P1 顺延项）。
• 市场安装的插件以宿主进程权限执行（与 dsh plugin add 同样无沙箱隔离）——只安装审查过来源的仓库；面板内已有警示横幅。

故障排查

• 装完没生效：host 插件、preset、动态清单的改动都要重启 DSH（dsh web）才生效；npm 包装完同样需重启。
• npm 包装完没有路由 preset 与动态面板：@dsh-forge/bundle 只含 host 插件与客户端包；preset 与动态面板需从源码仓库复制（见上文「可选组件」与「从源码安装」）。
• 首轮锚定/工具收窄没发生：锚定仅对 deepseek 系列模型生效（anchorApplies，默认 /^deepseek/i）；其他系列模型全程拿完整提示词与全量工具，属预期行为。
• npm 路径 boot 失败：确认装的是 @dsh-forge/bundle 0.1.4+；0.1.3 及更早版本在 npm 路径下 boot 失败（已知历史 bug）。
• 卸载：dsh plugin --profile web remove @dsh-forge/bundle 后重启；源码安装的参照 scripts/install.mjs 的落点反向删除（插件、preset、# dsh-suite:start/end 标记块）。

工具定义

本套件注册的全部模型工具，按插件分组：

截图

技能管理面板（两层视图）	插件市场	侧栏（竖排）

目录

bundle/     host 插件（cordis.patch.yml + plugins/*.mjs + @local 客户端包，可发布 dsh bundle）
dynamic/    动态插件清单（auto-plugins.json）
presets/    router-standard agent 预设
scripts/    install.mjs / check.mjs
docs/       架构文档（注入方式对比、分层规则、锚定规则、cache 规则、npm 升级风险、自研 subagent provider 设计）

架构文档

docs/ARCHITECTURE.md 记录全部设计决策：八种注入方式对比、host/preset/dynamic 分层规则、首轮锚定规则、prompt cache 规则、npm 升级风险清单、已知坑（勿在 React 插槽搬 DOM 等）。另见 工具描述规范（中文化）、工具详细定义参考、验收测试方法论、跨平台验证指南、多代理协作涌现档案、自研 subagent provider 设计（提案）、协作约定。

友情链接

• Deepseek-Harness-EAC — DeepSeek Harness 的 Windows 桌面客户端：内置 Node.js + dsh CLI、一键启动、10 套内置皮肤（EAC：Embracing All Creation 揽尽万象）。

许可与归因

MIT。改编自 dsh-router-standard、dsh-anchored-standard、dsh-routing-suite（均 MIT），详见 NOTICE。

历史：本项目原名 dsh-suite，2026-08 更名为 dsh-forge；scripts/install.mjs 的 cordis 合并标记仍保留旧拼写（# dsh-suite:start/end）以保证对已安装 profile 的幂等合并。