dsh-opencode-session
DeepSeek Harness 插件：自动为 OpenCode / OpenCode Go 提供商请求添加稳定的、按会话区分的 x-opencode-session 请求头——修复 400 MissingSessionID，并保持 OpenCode 的会话亲和性 / 提示词缓存路由正常工作。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-opencode-session@0.1.1Opencode Session 以 dsh-opencode-session 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →A DeepSeek Harness (DSH)
plugin that automatically sends the x-opencode-session request header on
model calls routed to OpenCode / OpenCode Go providers — one stable
session id per DSH conversation.
Since 2026-09-05 OpenCode's relay requires an x-opencode-session header on
API requests (tracked upstream in
deepseek-harness discussion #5495);
without it, requests fail with 400 MissingSessionID-style errors. Requests
that share the same header value are pinned to the same upstream backend,
which is also what keeps OpenCode's prompt cache warm across the turns of one
conversation.
This plugin:
x-deepseek-harness-session-id),From the npm registry (once published):
dsh plugin --profile web add dsh-opencode-session
From a local checkout:
dsh plugin --profile web add ./path/to/dsh-opencode-session
Then fully restart your dsh profile (bundle layers are read at startup). The startup log shows:
[opencode-go-session-header] active for providers [opencode, opencode-go] with mode session-id
If you run DSH from a source checkout instead, load it as an overlay:
pnpm dsh web --patch ./cordis.patch.yml.
The plugin row lives in the bundle's cordis.patch.yml; all keys are optional:
- insert:
- id: opencode-go-session-header
name: dsh-opencode-session
config:
providers: [opencode, opencode-go] # route keys to attach the header to
mode: session-id # 'session-id' | 'uuid'
debug: false
debugFile: null # optional absolute path
providers — provider route keys whose requests get the header. The
defaults cover the pi-ai catalog ids opencode and opencode-go; add your
own route key when you serve OpenCode through a custom provider name.mode
session-id (default) — header value = the DSH session id of the model
call. Unique per conversation, stable across turns, compaction, retries
and process restarts.uuid — a random UUID derived once per DSH session id (opaque; kept in
memory, so it resets when the process restarts).debug — log every streamed call that receives the header via
ctx.logger (the dsh process console).debugFile — optional absolute path. When set, every streamed call that
receives the header appends one JSON line
({"ts","provider","model","session","header","value"}) to that file —
handy when the dsh console is not visible.To override configuration in a profile without editing the package, add a
row with the same id in the profile's own cordis.patch.yml (it replaces the
whole config, so restate every key).
llm/stream waterfall. A call whose options.provider
names a configured OpenCode route and which carries a sessionId is
driven through an AsyncLocalStorage store holding the header value.globalThis.fetch is patched once. While such a store is active, the
outgoing request receives x-opencode-session: <value> (unless it already
carries the header — an existing value always wins).fetch and removes the
listener.Non-OpenCode providers, requests without a sessionId (some auxiliary
hand-built calls), and model discovery requests pass through untouched.
llm/stream
call. The one-shot model listing used by the Models page
(GET <baseURL>/models) is a separate flow and does not receive the
header; if your OpenCode endpoint also rejects that listing, open an issue.fetch. If a future DSH version swaps its network stack, the
plugin stops injecting (symptom: the 400 comes back) — uninstall then.node --check lib/index.js
npm test # local behavior tests against an echo server
The package is plain ESM JavaScript with zero dependencies; npm test runs
automatically via prepublishOnly.
npm login # once, with your npm account
npm pack --dry-run # preview exactly what lands in the tarball
npm publish # files = lib/, cordis.patch.yml, README.md
Before publishing, double-check the name is free on the npm registry and fill
in author, homepage, and repository in package.json if you like.
MIT