内置 @earendil-works/pi-ai 0.85.1 版本过低：OpenCode Go 无法添加最新模型，请求也因缺少 x-opencode-session 被拒

[dfoa8z8a]

Summary

内置的 @earendil-works/pi-ai@0.85.1 既没有 OpenCode Go 的新模型目录，也没有 x-opencode-session 这个按会话路由所必需的请求头，导致 opencode-go 路由完全不可用：模型加不进去，加进去了请求也会被网关拒绝。

Environment

• DSH 桌面端 release 0.2.0-rc.1（Windows x64，打包 app.asar）。
• 源码 master 同样成立：packages/llm/llm-pi-ai/package.json 依赖 "@earendil-works/pi-ai": "^0.85.1"；pnpm-workspace.yaml 里 minimumReleaseAgeExclude 固定 @earendil-works/pi-ai@0.85.1 / @earendil-works/pi-telemetry@0.85.1，并带一个 0.85.1 专属 patch patches/@earendil-works__pi-ai@0.85.1.patch（该 patch 只改 dist/api/* 的 streaming 参数解析，与本文无关）。
• 路由配置（profile 的 llm-pi-ai.providers）：

opencode-go:
  apiKeyEnv: OPENCODE_GO_API_KEY
  models:
    - id: deepseek-v4.1-flash
      name: DeepSeek V4.1 Flash
      contextWindow: 1000000

Current behavior

现象 1：加不上模型。 上面这份配置保存时报

model "deepseek-v4.1-flash" needs an api; the installed catalog does not describe it

原因不是配置写法错，而是 0.85.1 的 catalog 里没有这个模型：opencode-go 这一路由的模型跨多种 wire protocol（anthropic-messages / openai-completions / openai-responses 混用），DSH 对 catalog 未描述的模型要求显式声明 api:；而 0.85.1 的 opencode-go 目录里根本没有 deepseek-v4.1-flash，于是这条配置必然失败。

现象 2：即使补上 api: openai-completions，请求仍被网关拒绝。

400: {"type":"MissingSessionID","message":"Request is missing x-opencode-session and cannot be routed efficiently. Please see https://opencode.ai/docs/go/#where-can-i-use-it"}

OpenCode Go 要求每个会话在 x-opencode-session 里带一个稳定的会话 ID。pi-ai 从 0.86.1 起才有 dist/providers/opencode-headers.js 的 withOpenCodeSessionHeader()，由它把 options.sessionId 变成该请求头；0.85.1 里 opencode-go.js 没有这层包装。DSH 侧 PiAiAdapter 一直在把 GenerateOptions.sessionId 传给 pi-ai，所以只差 pi-ai 这一层。

Measured difference（同一个打包归档，只替换 pi-ai）

用 Electron 自身的 asar reader 读取两个归档里的 opencode-go 目录：

	pi-ai 0.85.1	pi-ai 0.87.1
builtin providers	39	41
opencode-go 模型数	27	30
deepseek-v4.1-flash	缺失	存在（api=openai-completions）
dist/providers/opencode-headers.js	无	有
opencode-go.js 是否包 withOpenCodeSessionHeader()	否	是

换成 0.87.1 后的实测：

• 直连 POST https://opencode.ai/zen/go/v1/chat/completions：不带 x-opencode-session → 400 MissingSessionID；带上 → 200。
• DSH 内 opencode-go/deepseek-v4.1-flash 可正常保存并跑通主循环的工具调用。

Expected behavior

内置 pi-ai 版本应足以驱动 opencode-go（含新模型与按会话路由的必需请求头）；若确实不支持，错误信息应直接指出需要声明 api: 或升级 pi-ai，而不是留一句自相矛盾的报错。

Suggested fix

1. 把 @earendil-works/pi-ai（以及 @earendil-works/pi-telemetry）升到 ≥0.87.1，并同步 pnpm-workspace.yaml 的 minimumReleaseAgeExclude；同时确认 0.85.1 专属的 pnpm patch 是否还需要（它只影响 dist/api/* 的 streaming 参数解析）。
2. 可选增强：当路由混用多种 wire protocol 且模型不在 catalog 中时，直接在报错里给出建议的 api: 取值（例如 api: openai-completions）。

注：本仓库 Issues/PR 均未开放，按 README 的指引把报告发到 Discussions；如需要我可以把验证脚本或补丁以评论形式补上。

[dfoa8z8a]

补充具体改动。基于 master 4878cdab，git apply --check 通过。

diff --git a/packages/llm/llm-pi-ai/package.json b/packages/llm/llm-pi-ai/package.json
index e186f0c..129d3e7 100644
--- a/packages/llm/llm-pi-ai/package.json
+++ b/packages/llm/llm-pi-ai/package.json
@@ -41,7 +41,7 @@
     "@deepseek-ai/dsh-brand": "workspace:*",
     "@deepseek-ai/dsh-util-values": "workspace:*",
     "@deepseek-ai/schemastery": "workspace:~",
-    "@earendil-works/pi-ai": "^0.85.1"
+    "@earendil-works/pi-ai": "^0.87.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "workspace:~",
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index f3c6b2b..57b19e0 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -64,8 +64,8 @@ minimumReleaseAgeExclude:
   - '@deepseek-ai/libreoffice-kit-wasm@0.1.1'
   # Fresh pi-ai releases carry the model catalog updates that are the whole
   # point of bumping it; waiting out the release age would defeat that.
-  - '@earendil-works/pi-ai@0.85.1'
-  - '@earendil-works/pi-telemetry@0.85.1'
+  - '@earendil-works/pi-ai@0.87.1'
+  - '@earendil-works/pi-telemetry@0.87.1'
   - node-addon-native-custom-loader@0.1.6
   - node-addon-require-builtin-darwin-arm64@0.1.6
   - node-addon-require-builtin-darwin-x64@0.1.6

0.87.1 是本次实机验证过的版本（桌面端 0.2.0-rc.1 手工换装该版本后 opencode-go 全程可用）；0.86.1 是首个带 dist/providers/opencode-headers.js / withOpenCodeSessionHeader() 的版本，也就是能让请求带上 x-opencode-session 的最低版本。

升级时需要一并决定的一件事

pnpm-workspace.yaml 的 patchedDependencies 里还有：

'@earendil-works/pi-ai@0.85.1': patches/@earendil-works__pi-ai@0.85.1.patch

这个 patch 删掉的是 dist/api/*.js 里 block.arguments = parseStreamingJson(...) 一类赋值。我在 0.87.1 的 dist 里核对过，这些语句仍然存在（openai-completions.js:261、anthropic-messages.js:510、openai-responses-shared.js:549），所以不能当作"随版本一起过期"直接删掉：如果那段行为仍被需要，就要针对 0.87.1 重新生成同语义的 patch 并把版本键改成 0.87.1。我没有该 patch 背景的上下文，所以上面的 diff 只包含机械升级部分，这一项留给熟悉它的维护者判断。

其余工作：pnpm install 重算 pnpm-lock.yaml；minimumReleaseAgeExclude 两条必须同时改，否则新版本会被发布年龄策略挡回旧版本。

catalog 变化（同机对比两个归档，用 Electron 自身 asar reader 读取）

	pi-ai 0.85.1	pi-ai 0.87.1
builtin providers	39	41
opencode-go 模型数	27	30
deepseek-v4.1-flash	缺失	存在（api=openai-completions）
dist/providers/opencode-headers.js	无	有
opencode-go.js 是否包 withOpenCodeSessionHeader()	否	是

opencode-go 新增 deepseek-v4.1-flash、mimo-v2.6-flash、mimo-v2.6-pro、grok-4.7（同时下架 omen-alpha）；另有若干路由被上游精简（moonshotai/moonshotai-cn 10→4、zai-coding-cn 10→4、deepseek 3→2、nvidia 20→19），属于上游行为，不是本地改动造成的。

可选的报错改进

model "…" needs an api; the installed catalog does not describe it 建议直接给出可操作信息：opencode-go 的模型跨 openai-completions / anthropic-messages / openai-responses 三种协议，因此对 catalog 未描述的模型应提示显式写 api: openai-completions（并说明只写 models: 会替换整条目录而不是追加）。