[Workaround] dsh-opencode-session — temporary plugin for OpenCode Go x-opencode-session (fixes 400 MissingSessionID)

[nobu121]

[Workaround] dsh-opencode-session — temporary plugin for OpenCode Go's x-opencode-session

OpenCode Go 自 09/05 起要求每个推理请求带稳定的 x-opencode-session 头，否则返回 400 MissingSessionID。在官方内置支持之前，我写了一个临时插件，实测可用：dsh-opencode-session（npm）。

它做什么

• 只对 opencode / opencode-go 路由的模型请求自动加 x-opencode-session: <DSH 会话 id>；
• 复用 DSH 会话 id：每个会话唯一、跨轮次/压缩/重启稳定 → 既修 400，又保留 OpenCode 的后端亲和/提示词缓存；
• 其它 provider、无会话 id 的辅助请求、已自带该头的请求一概不动；
• 零依赖、纯 ESM；DSH 0.1.2-rc.1 实测通过。

安装（需完全重启 dsh 生效）

dsh plugin --profile web add dsh-opencode-session

启动日志出现 [opencode-go-session-header] active for providers [opencode, opencode-go] with mode session-id 即生效。

说明

• 社区临时方案；等官方内置按会话的 x-opencode-session（见 Discussion #5495）后，可 dsh plugin --profile web remove dsh-opencode-session 退役。
• 欢迎反馈。

---

English:

OpenCode Go requires a stable x-opencode-session header on every inference request since 09/05, otherwise it returns 400 MissingSessionID. Until the official support lands, I wrote a temporary plugin that works: dsh-opencode-session (npm).

What it does

• Adds x-opencode-session: <DSH session id> automatically, only for opencode / opencode-go routes;
• Reuses the DSH session id — unique per conversation, stable across turns / compaction / restarts — so it both fixes the 400 and keeps OpenCode's backend affinity / prompt-cache working;
• Leaves other providers, auxiliary calls without a session id, and requests that already send the header untouched;
• Zero dependencies, plain ESM; verified on DSH 0.1.2-rc.1 with opencode-go.

Install (requires a full dsh restart)

dsh plugin --profile web add dsh-opencode-session

Startup log should show [opencode-go-session-header] active for providers [opencode, opencode-go] with mode session-id.

Notes

• Community workaround; retire it (dsh plugin --profile web remove dsh-opencode-session) once the official per-conversation header lands (Discussion #5495).
• Feedback welcome.

---

顺手安利 / Bonus: 在桌面端使用可以试试 dsh-go（DeepSeek Harness 的轻量原生窗口，约 4MB WebView、无 Chromium）。它与 dsh CLI 共用 ~/.dsh，会把 dsh 放进 PATH，Windows 上带桌面快捷方式——插件安装和 CLI 完全一致。 / On the desktop, try dsh-go (a ~4 MB native WebView window for DeepSeek Harness). It shares ~/.dsh with the dsh CLI, puts dsh on PATH, and installs a Windows shortcut — plugin installs work exactly like the CLI.

[DevTarlow]

Thanks for this! I will try it out. Right now I have just built a fix in, but after I updated I had to bring my fix back in so this should help so I don't have to keep coding the fix in.