dsh-muse-code (community fork)
> Muse Code subagent provider for DeepSeek Harness — patched to work on DSH 0.2.1+.
> 让 DSH 通过 subagent_muse 工具把任务外包给 Meta 的 Muse Code CLI。
This is an unofficial fork of @pascapone/dsh-muse-code v0.1.0.
Upstream is great but pins peerDependencies to dsh-* 0.1.7-rc.2 || 0.2.1-alpha.1, so on current
DeepSeek Harness (0.2.1-rc.x) it is skipped at load time. This fork makes three minimal,
backward-compatible changes so the same plugin works on DSH 0.2.0-rc.2 and 0.2.1-rc.x.
症状 / Symptoms
装上插件、重启 DSH 后，两处报错依次出现：
① 插件被跳过（加载失败）
subagent-muse (@pascapone/dsh-muse-code): failed to import: .../lib/tool-platform.js:1
import { settleRun } from '@deepseek-ai/dsh-subagent';
SyntaxError: The requested module '@deepseek-ai/dsh-subagent' does not provide an export named 'settleRun'
② 修好导入后，工具出现但调用报错
Error: ctx.subagents.start is not a function
③ 修好上面两处后，带工具调用的回合整轮失败（这一个是网关的问题，见下文）
stream protocol error: message item `msg_...` changed phase from `final_answer` to `commentary`
根因 / Root cause
| # | 位置 | 变化 | 本仓库修法 |
|---|---|---|---|
| 1 | package.json → peerDependencies |
只允许 0.1.7-rc.2 \|\| 0.2.1-alpha.1，而宿主是 0.2.1-rc.3 |
放宽并补上预发布分支：>=0.1.7-rc.2 <0.2.0-0 \|\| >=0.2.0-rc.1 <0.3.0-0 \|\| >=0.2.1-rc.1 <0.3.0-0 |
| 2 | @deepseek-ai/dsh-subagent 的根导出 |
删除了 settleRun、resolveChildCwd |
local-compat.ts 提供语义等价的本地实现，只依赖仍存在的 assertUsableCwd |
| 3 | ctx.subagents.start(name, req) |
服务方法被移除（改为 startActivation()，需完整 {parent, maxDepth} 控制描述） |
startProviderRun()：方法不存在时退回 getProvider(name).start(req) |
第 4 类是网关侧问题，不在本插件职责内，但本仓库附带一个可选的修正代理：见
docs/phase-mismatch.md。
兼容矩阵 / Compatibility
| DSH 版本 | 状态 |
|---|---|
0.2.0-rc.2 |
✅ 应可用（未实机回归；补丁对旧导出做了保留判断） |
0.2.1-alpha.1 |
✅ 上游原本支持的版本 |
0.2.1-rc.3 |
✅ 本仓库实测通过（Windows 11 + Muse 1.3.x + 自建 OpenAI 兼容网关） |
0.3.x |
⚠️ 未验证，接口可能再次变动 |
安装 / Install
方式 A：直接从本地目录装（推荐，无需发布）
# 1) 把本目录放到固定位置，例如 %USERPROFILE%\.dsh\plugins\dsh-muse-code
# 2) 在 DSH profile 的 package.json 加依赖（path 指向本目录）：
# "dependencies": { "@stellarytoucher/dsh-muse-code": "file:../../plugins/dsh-muse-code" }
# 3) 在 profile 的 cordis.patch.yml 里插入（或直接用本目录的 cordis.patch.yml）：
# - insert:
# - id: subagent-muse
# name: '@stellarytoucher/dsh-muse-code'
# config: {}
# 4) 完全退出并重启 DSH
脚本版：pwsh -File scripts/Install-AsPlugin.ps1（幂等，会写依赖与 patch，并留备份）。
方式 B：发布到 npm 后用插件管理器
npm publish --access public # 发布到 npm 时按需改成你自己的 scope
然后在 DSH 的 Plugin Manager 里安装 @stellarytoucher/dsh-muse-code。
配置（provider 需要的字段）
- id: subagent-muse
name: '@stellarytoucher/dsh-muse-code'
config:
providerName: muse
runtime: native # auto | native | wsl（Windows 建议 native）
command: C:\Users\\AppData\Local\Programs\muse\muse.exe
provider: meta # Muse 的 provider 分支
model: muse-spark-1.3-contributor # 或你的网关/官方暴露的模型名
reasoningEffort: xhigh
approvalMode: never
env:
META_API_KEY: ''
HOME: 'C:\Users\' # 必须！否则 muse 找不到配置目录
USERPROFILE: 'C:\Users\'
NO_PROXY: 'localhost,127.0.0.1,::1'
> env 会作为子进程环境传入。HOME/USERPROFILE 缺失时 muse 直接报
> no usable config directory from XDG_CONFIG_HOME, HOME, or USERPROFILE。
开发 / Development
pnpm install --frozen-lockfile --ignore-scripts
pnpm run check # typecheck + build + 离线单测
pnpm run test:real # 需要真实 Muse 认证
pnpm run build 把根目录 *.ts 编译进 lib/。仓库里的 lib/ 是已编译产物（含补丁），
直接安装即可运行；改了源码记得重新 build 再发布。
与上游的差异 / Diff vs upstream
local-compat.ts 新增（settleRun / resolveChildCwd 兼容层）
main.ts 改：resolveChildCwd 改从 ./local-compat.js 导入
tool-platform.ts 改：settleRun 改从 ./local-compat.js 导入；
ctx.subagents.start(...) → startProviderRun(...)
package.json 改：peerDependencies 放宽；name/version/private 调整
patches/ 里是对上游 v0.1.0 的 unified diff，可 git apply 或直接作为 PR 提交。
共建 / Contributing
最有价值的还是把这三个补丁回流给上游：本仓库按“最小改动 + 向后兼容”写，
settleRun/resolveChildCwd 的实现只在旧导出缺失时才需要，上游若愿意合并，
可以用 typeof 探测包一层。欢迎 PR / issue。
许可 / License
MIT，见 LICENSE。原版权归 @pascapone/dsh-muse-code 作者所有；
本 fork 仅新增兼容层与构建产物。非官方项目，与 Meta / DeepSeek 无关。
