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 包。核心四件套：

组件	能力
插件市场 + 安装器	浏览 GitHub dsh-plugin topic 社区插件，一键安装（npm 包 / 动态清单 / preset / bundle 四种形态自动识别），注入器热加载 + 持久注册表
任务感知思维模式路由（router-standard preset）	首条消息分类 spec（先计划）/ react（直接干）/ weak（模型自路由），首轮极简锚定 + 首个 tool/call 后放全量工具；锚定仅对 deepseek 系列生效
Skill 管理器	统一管理全部技能：持久化增删启停、内容预览、内置 runtime 技能（跨会话邮箱 / 模型委派 / agent 团队）收敛为一处管理，设置页面板 + 模型工具双通道
插件管理面板	实时发现宿主/注入/官方三类 loader 条目 + 动态插件运行/停止/删除，搜索 + 分区导航

协作与编排层（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 代码）：模式下拉框、模型+等级选择器、子代理图片补丁、技能管理面板、插件市场面板。

为什么叫 forge

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

安装

git clone https://github.com/alex04130/dsh-forge.git
cd dsh-forge
node scripts/install.mjs     # 复制到 $DSH_HOME，自动备份、幂等
# 重启 DSH（dsh web），新建会话选择 Router Standard (experimental) preset

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

可选：GitHub MCP 工具（mcp__github__*）

bundle/cordis.patch.yml 内置 mcp-github 条目，依赖本地运行时目录 ~/.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

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

验证

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

工具定义

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

插件	工具与用途
mailbridge（跨会话消息桥）	session_list（列出会话）、session_read（读其他会话日志）、session_send（发消息给其他会话）、mailbox_check（收取离线来信）
llmrouter（模型委派）	model_list（provider/model 目录 + byModel 反向索引）、model_call（一次性文本补全，非子代理）
modeswitch	switch_mode（当前会话中途切换 agent preset，提权需确认）
teamhub（代理团队）	team_create / team_add_member / team_create_task / team_claim_task / team_update_task / team_send_message / team_status / team_delete
modsub（子代理派发）	spawn_model_subagent（可指定 provider/model/reasoningEffort/mode，默认全继承父，提权自动审批）
injector（运行时注入）	dev_inject_plugin / dev_uninject_plugin / dev_injected_list / dev_reload_package / dev_plugin_status
modelroute（路由策略）	model_taxonomy（模型系列与档位）、model_route_status（当前路由与父路由钳制）
skillmanager + sklui（技能管理）	skill_list / skill_show / skill_add / skill_disable / skill_enable / skill_remove（持久技能，支持默认注入 / 渐进式披露）
plins（插件市场）	dev_stop_dyn_plugin（按前缀紧急停动态插件）；另有市场面板 RPC（browse / installed / install / uninstall）
sfind	session_find（按 id/标题关键字查会话，省上下文）

截图

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

目录

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 等）。另见 工具描述规范（中文化）。

友情链接

• 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 的幂等合并。