dsh-mulanci

木兰辞 · MulanCi

English | 中文

这是面向 DeepSeek Harness 的多 Agent（智能体）编排插件套件，目前以包含配套修改版 Harness 的第三方源码预览发行，并非独立的 dsh plugin add 安装包。在 WebUI 配置团队后，直接在普通聊天框下达多 Agent 任务。Harness 中选定的协调模型调用 agent_orchestra；每个外部 Agent 仍使用自己的模型和认证配置。

代码仓库 · 源码预览版 v0.1.0-preview.3 · 反馈问题

看看界面

在侧栏配置团队及各 Agent 的认证，在主聊天框下达任务。对话看板展示阶段进度、交接、结果和诊断。

这是受控浏览器测试中的逐 Agent 认证配置画面。API Key 输入框为空，端点和模型是测试占位值。保存设置不代表账号或模型连通。这张图不能证明真实多模型链路运行成功；已测范围见验证记录。

为什么叫木兰辞？

名字取自古诗《木兰诗》，亦称《木兰辞》：

东市买骏马，西市买鞍鞯。

我们为英文读者自译为：“In the eastern market, buy a fine horse; in the western market, buy a saddle and saddlecloth.” 即东市购买骏马，西市购买马鞍和鞍垫。

木兰为同一次出征，从不同地方备齐各有所用的装备。木兰辞把这份思路用于多 Agent 协作：按任务挑选各有所长的 Agent，分配规划、实现、审查或其他角色，再汇总各自的成果。角色不绑定某个品牌。Codex、Claude Code 和 AtomCode 是可选的适配对象，不是框架的全部；其他 Agent 可以通过 Harness 提供方或明确配置的 ACP（Agent Client Protocol）适配器接入。

这个版本是什么

0.1.0-preview.3 是第三方修改的 Harness 源码发行物，不是 DeepSeek 官方版本。包内包含三个插件及配套宿主集成。木兰辞是社区项目名，内部 agent-orchestra 标识保持不变。保留既有 @deepseek-ai/* 名称是为了内部导入和来源归属，不代表社区作者拥有这些 npm 包名。本发行物不将这些包发布到 npm。

这不是可以用 dsh plugin add 单独安装的组合包。当前实现依赖宿主的 Remote 桥接、侧栏插槽、Provider 辅助代码、预设挂载及持久化会话事件目录。不支持只拿三个插件装进任意 Harness 版本，包括包版本号同为 0.1.0-rc.5 的其他构建。发布清单以 SHA-256 标识包内具体文件；原始工作目录没有可核验的 Git 提交，因此不声称基于某个官方提交。

启动独立副本

按包内声明使用 Node.js ^22.19.0 或 >=24.0.0，以及 pnpm 11.7.0。本机验证使用 Node 24。从上方发布页面获取源码预览包，用随附的 SHA-256 文件校验后解压到新目录，不要覆盖已有 Harness 安装。公开仓库和发行压缩包的源码都位于 harness 子目录。从其上一级目录执行：

cd harness
CI=true pnpm install --frozen-lockfile
pnpm run build
DSH_HOME="$PWD/.community-home" pnpm dsh web --port 3081

Windows PowerShell 使用下面的安装、构建和启动命令：

Set-Location harness
$env:CI = 'true'
pnpm install --frozen-lockfile
pnpm run build
$env:DSH_HOME = Join-Path (Get-Location) '.community-home'
pnpm dsh web --port 3081

打开 http://127.0.0.1:3081，在设置中填写自己的协调模型提供方、API Key 和模型，再添加或选择工作区。包内不含凭据和已有聊天记录。依赖需要下载，本包不是离线二进制发行物。子 Agent 默认使用这台电脑上各自原生的登录和配置：独立的 Harness 配置目录不会隔离它们自己的凭据库和权限。

在“多 Agent”里展开对应 Agent 的“认证配置”，即可单独设置 API Key、端点和模型。Codex 要求兼容 Responses 的 API 和模型；Claude 要求兼容 Messages 的 API。Claude API 模式不加载原生配置文件，包括文件中的权限和 hooks，原生模式则保留。ACP Agent 需要填写其文档规定的环境变量名。保存只代表完成配置，不代表账号连通。密码留空保留已有密钥；重置删除插件密钥并恢复原生配置。这些覆盖只作用于 Harness 启动的子进程，不改写原生登录文件。本地凭据文件为仅所有者可访问的明文，并非加密；不要上传该文件，也不要把密钥粘进普通设置。详见认证说明。

CI=true 会跳过仓库的 Git hook 安装。首次安装可能提示工作区 CLI 二进制尚不存在，随后的构建会生成它们；构建失败时不要跳过错误继续运行。

使用团队

1. 打开侧栏的多 Agent。启动扫描和重新扫描仅检查程序文件，不启动 Agent，也不消耗模型 Token。
2. 选择 Provider、角色、超时和并发数，再保存。Codex、Claude Code 和 AtomCode 已有适配器；其他 Harness Provider 和明确配置的 ACP Agent 也能接入。发现程序不代表已经登录、有余额、有模型权限或支持 ACP。
3. 在主聊天框明确下达任务，例如：“使用多 Agent：让 Codex 检查结构，Claude Code 检查测试，AtomCode 汇总两者的结论。不要修改文件。”对话中的看板会显示进度、依赖、结果和诊断。
4. 先在临时工作区运行只读任务。之后如需实现代码，再通过各 Agent 的原生权限配置明确授权。不要为了隐藏执行错误而直接开启无限制权限。

保存的角色组成顺序执行的团队。编排工具也接受显式依赖图；独立只读阶段可以并行。文件修改阶段仅在同一次执行内互斥，不会跨对话锁定工作区。阶段之间传递的是限长文本交接，不是共享 Agent 记忆。

第一次只读试用

如果需要材料齐全的练习，请使用书单检查教程（English / 中文）：内含虚构 JSON 样例、完整角色职责和核对答案，不是真实模型运行记录。有自己的临时样例项目时，再使用下方的通用练习。

准备一个不含秘密的小项目临时副本，完成协调模型及 Agent 的认证，再在“多 Agent”中为至少两个可用 Agent 分配规划和审查角色。汇总角色可选，不需要集齐所有支持的品牌。每个选中的 Agent 都需要有可用的账号权限。

逐个修改角色说明，而不只是名称：规划仅读取 README 和包清单，审查仅读取测试文档和配置，可选的汇总仅合并发现。每个角色都明确禁止改文件、安装依赖和执行项目脚本。移除不用的默认实现和验证阶段，再保存。保存的团队顺序执行；这些说明不会启用沙箱，也不会开启显式依赖图的 readOnly 调度标志。将下面的指令粘贴到主聊天框：

使用 agent_orchestra 和我保存的团队，做一次只读项目检查。规划角色读取 README 和包清单，说明项目结构；审查角色读取测试说明和测试配置，不执行测试，找出缺失或不清楚的验证步骤。如果配置了汇总角色，由它合并上述发现；否则在主对话汇总团队结果。不要修改文件、安装依赖或运行项目脚本。允许使用已配置的模型调用，不要通过工具或项目脚本访问额外的外部服务。结论附上文件路径，并明确区分已观察到的事实和仍待验证的事项。

根据结果判断，不要求模型逐字返回相同内容：

• 对话里出现编排执行及各选中阶段的状态；只有普通聊天回答不能证明调用了外部 Agent。
• 完成的阶段返回带文件引用的发现。如果阶段失败，先查看诊断及被跳过的依赖阶段，再决定是否重试。
• 最终汇总区分已观察事实与未验证假设，项目文件不应发生变化。

这是建议的首次试用练习，不代表新增了真实全链路验证。模型可能需要进一步明确提示才会选择工具。提示词里的“只读”不是安全沙箱，还应限制外部 Agent 的原生权限。模型调用可能消耗你的账号余额。

通过首次试用反馈表告诉我们哪种配置成功，或在哪一步遇到问题。提交前先脱敏诊断。如果项目对你有用，欢迎自愿点一个 Star 帮助其他开发者发现它；不点 Star 也同样欢迎反馈。

安全与限制

• 原生程序使用运行账户及 Agent 自身配置的权限。自定义 ACP 按可执行文件及 argv 数组启动，不执行 shell 表达式。只添加你信任的程序。
• ACP 权限请求默认拒绝。允许权限是明确的实例级设置，不按工作区隔离。Windows 暂不支持 ACP 批处理启动器，请使用原生可执行文件或 node.exe 加已文档化的脚本参数。
• 提示词、交接、结果及诊断保存在父对话中。不要把密钥写进任务。传输失败中的常见凭据模式会被脱敏并限长，但这不保证任意 Agent 输出都不含敏感信息。
• 外部会话是单次执行。看板显示阶段进度，不提供逐 Token 流式输出。刷新和恢复可读取已记录历史，不会续跑已经被结束的外部进程；重试会创建新执行。
• 不承诺自动迁移凭据、识别任意 CLI 协议、跨执行文件系统隔离，或真实模型必然选择工具。认证更新不提供崩溃原子性或多进程事务保证。macOS 有本机运行证据；Windows 行为有定向测试，但未经 Windows 实机认证。

排错与移除

如果程序已发现但无法运行，检查界面诊断、原生登录、模型权限、余额、可执行路径及工作区权限。协调模型的 API Key 可用不代表外部 Agent 已认证。部分分支失败时，其依赖阶段会跳过，不相关任务仍可继续。

用 Ctrl+C 停止这个副本。其 Harness 状态保存在 harness/.community-home；如需保留聊天，先归档该目录，再在不需要时移除解压副本。不要删除原生 Agent 配置目录。上面的命令不会替换全局 Harness 安装。

内容与分享

编排服务负责发现和设置；编排工具负责执行；WebUI 插件负责管理界面和看板。各自的双语 README 说明行为和配置。发行物根目录的 RELEASE-MANIFEST.json 记录源码哈希，验证记录说明验证范围。社区介绍提供英文和中文版本。旁边的 .sha256 文件校验压缩包完整性，不证明发布者身份。

包内 MIT 许可证及第三方声明保留上游归属。木兰辞由社区独立维护，不代表获得 DeepSeek 官方背书。公开仓库使用 dsh-plugin topic 便于发现；DeepSeek Harness Discussions 是上游社区入口。请通过上方项目问题链接提交可复现的问题，附上环境信息和已脱敏诊断；不要上传密钥、凭据文件或私人会话日志。

如需复现源码压缩包，验证完成后在 harness 中执行 node scripts/community/release.ts。输出位于 .artifacts/community，不会覆盖已有发行条目；再次构建时可传入一个新的输出目录参数。压缩包排除依赖和编译文件，使用者始终一起重建配套宿主及插件。