dsh-model-fix

修复特定模型在 DeepSeek Harness（DSH）里「流式内容正常但回合必报错」的流式收尾缺陷。

本仓库是 bitterSmilezzz/dsh-model-fix 的增强版： 在原版（muse-spark-1.2）基础上，加入了对 gpt-5.6-luna 的支持（同一缺陷，实测 2026-08-23：gpt-5.6-luna 流式/非流式响应的 finish_reason 均为 null，且流式不发 [DONE]）。

背景：缺陷根因

opencode 聚合端点（https://opencode.ai/zen/go/v1）上的 muse-spark-1.2 与 gpt-5.6-luna 实现有缺陷：流式响应正常吐出内容，但从不发送 finish_reason、也不发送 [DONE]，流直接关闭（同端点对照 deepseek-v4-flash / glm-5.2 均正常发送 finish_reason: 'stop' + [DONE]）。

DSH 的 llm-pi-ai 走 pi-ai SDK（强制 stream: true 且要求流以 finish_reason 收尾）， 于是每次对话的真实表现是：

1. 内容正常流式显示；
2. 结尾报 Stream ended without finish_reason（映射为 TRANSPORT 错误）；
3. 回合被判失败，且 TRANSPORT 在默认可重试列表里 → agent 级重试插件按 maxRetries 反复重跑整步，烧多份 token。

这与代理无关：直连与走代理的响应完全相同，换代理解决不了。

⚠️ 重要说明：无需开启 opencode 的「Allow models that train on request data」

使用 muse-spark-1.2 / gpt-5.6-luna（经 opencode-go 路由）不需要在 opencode 平台设置里 开启**「Allow models that train on request data」**。

• 该开关是 opencode 的数据训练授权：开启后你的请求数据可能被用于模型训练，属于 需要慎重对待的隐私授权，不要为了使用这些模型而开启它；
• 实测：不开启该开关，直连 https://opencode.ai/zen/go/v1 即可正常 返回内容（本插件修复的只是流式收尾缺陷，与训练授权无关）；
• 若在 opencode 设置里看到该开关，保持关闭即可；本文档所述修复不依赖它。

开关位置见下图（opencode 设置页 → 提供商区域，与「启用部署在中国的模型」相邻）：

本插件做什么

在 llm/stream waterfall 上，对匹配的模型把上述缺陷收尾为正常 stop：

• 仅当流已输出内容（text-delta / reasoning-delta / tool-call-delta）且 结尾错误代码为 TRANSPORT / STREAM_CLOSED 且错误信息明确是「缺少终止事件」 （如 Stream ended without finish_reason）时才改写；
• 真实传输故障（如 SocketError: other side closed）不受影响，照常失败；
• 无内容的空响应也照常失败，不会被误吞。

修复后 muse-spark-1.2 / gpt-5.6-luna 直连即可正常使用，无需代理、不触发重试。

安装

# 从 GitHub 安装（推荐）
npx -y @deepseek-ai/dsh plugin --profile web add github:Retr67/dsh-model-fix

# 本地路径
# dsh plugin --profile web add /path/to/dsh-model-fix

安装后重启目标 profile（如 dsh web）生效。

配置

cordis.patch.yml 中 config 两个字段：

字段	默认	说明
modelPattern	^(muse-spark|gpt-5\.6-luna)	对模型 id 测试的正则；只修复匹配的模型
providers	[]	provider 路由键白名单（如 opencode-go3）；空 = 所有 provider 中匹配的模型

- id: model-fix
  name: dsh-model-fix
  config:
    modelPattern: '^(muse-spark|gpt-5\.6-luna)'
    providers: []

只修 luna 可改为 modelPattern: '^gpt-5\.6-luna'；只想限定某个路由可加 providers: [ 'opencode-go' ]。

开发

pnpm install
pnpm verify    # typecheck + build + node --test

验证矩阵

• 单元测试：tests/fix.test.mjs 覆盖缺陷识别、内容保留、空响应放行、真实故障放行等 10 例。
• 真实端点集成验证：用 pi-ai 同款 SDK 直连 muse-spark-1.2 / gpt-5.6-luna，内容经本插件转换后 结尾由 error(Stream ended without finish_reason) 变为 {"kind":"stop"}。

致谢

• 上游：bitterSmilezzz/dsh-model-fix（MIT）
• 缺陷取证（gpt-5.6-luna）：2026-08-23 直连 opencode.ai/zen/go/v1 复现——流式 10 个 chunk 中 finish_reason 全程 null、无 [DONE]，尾部为 data: {"choices":[],"cost":"0"}； 非流式响应 finish_reason 同样为 null。