dsh-opencode-session-header
为 DeepSeek Harness (DSH) 中的 OpenCode Go 按对话注入 x-opencode-session 标头。修复 400 MissingSessionID，保持提示缓存路由的最佳状态，仅严格作用于 opencode.ai，并支持无需重启即可运行时切换。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-opencode-session-header@0.1.0Opencode Session Header 以 dsh-opencode-session-header 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Per-conversation x-opencode-session header injection for DeepSeek Harness (DSH) → OpenCode Go.
It fixes the 400 MissingSessionID rejection and keeps OpenCode's per-conversation routing / prompt-cache optimization working — scoped strictly to opencode.ai, runtime-switchable without restart, zero dependencies.
Since 2026-09-05, OpenCode Go requires a stable x-opencode-session header on every inference request (used for routing and prompt caching). DeepSeek Harness ≤ 0.1.2-rc.1 sends no such header on any adapter path, so every opencode-go model call fails:
400: {"type":"MissingSessionID","message":"Error from provider (Console Go): Request is missing x-opencode-session ..."}
Upstream fix is tracked in deepseek-harness discussion #5495 but has not shipped yet. This plugin fills the gap locally.
Static headers in settings.yaml | Global opencode_zen profile (dsh-custom-header) | This plugin | |
|---|---|---|---|
| Fixes the 400 | ✅ | ✅ | ✅ |
| Per-conversation id (cache / routing optimal) | ❌ one shared id → cache misses, slower & pricier | ✅ | ✅ real DSH session id |
| Other providers untouched | ✅ | ❌ rewrites UA + x-opencode-* on every host | ✅ opencode.ai only |
| Toggle without restart | — | — | ✅ JSON file flip |
| Extra dependencies | — | third-party plugin, client bundle | none |
dsh plugin --profile web add dsh-opencode-session-header
or from a local clone / checkout:
dsh plugin --profile web add "file:C:\path\to\dsh-opencode-session-header"
Then restart dsh web once — plugins load at boot. The startup log should show:
[dsh-opencode-session-header] loaded: header=x-opencode-session hosts=opencode.ai fallback=dsh-default
[dsh-opencode-session-header] runtime switch: <DSH_HOME>\plugins\dsh-opencode-session-header.json ({"enabled":false} disables; missing file = enabled)
State file: <DSH_HOME>/plugins/dsh-opencode-session-header.json (defaults to ~/.dsh):
{ "enabled": false }
false → injection off (all requests pass through untouched);true or file missing → injection on;Two seams, both proven inside DSH 0.1.2-rc.1:
llm/stream waterfall observer — wraps every adapter stream iteration in an AsyncLocalStorage carrying GenerateOptions.sessionId (stable per DSH conversation across turns, compaction and retries; fresh per conversation / fork / subagent).x-opencode-session only when the request host matches the allowlist (default: opencode.ai + subdomains). Value = the current session id, or the fallback id (dsh-default) outside any LLM context (e.g. model discovery). Every other host passes through byte-for-byte untouched.The fetch pipeline runs under this plugin's own Symbol.for key (mechanics vendored from @aizigao/pi-fetch-pipeline, MIT), so it coexists with other fetch-patching plugins instead of clobbering them. Header merging follows the fetch spec: whichever of init.headers / Request.headers would reach the wire is used as the merge base.
npm test # 13 assertions: injection, fallback, allowlist, runtime switch,
# concurrent-session isolation, llm/stream propagation, subdomains
0.1.2-rc.1 (npm latest at release time).fetch. If a future DSH build switches its network stack, the plugin silently stops injecting — the symptom is simply the 400 returning; uninstall then.dsh plugin --profile web remove dsh-opencode-session-header
then restart dsh web (optionally delete the switch file).
@aizigao/pi-fetch-pipeline (MIT); the fetch-layer approach on DSH was proven by dsh-custom-header (MIT) by Asaiuta.