dsh-ocg-session-head
在终端中运行以下命令:
dsh plugin install verneuil/dsh-ocg-session-head
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 插件管理器中执行 dsh plugin install verneuil/dsh-ocg-session-head,或通过 npm 安装后重启宿主;源码与说明见 https://github.com/verneuil/dsh-ocg-session-head。
插件介绍
自 OpenCode Go 要求每次推理携带稳定的 x-opencode-session 以来,若请求里没有该头,服务会直接返回 MissingSessionID 一类错误。若你是通过 DeepSeek Harness 官方路径接入内置 opencode / opencode-go 路由,较新的 pi-ai 已经会自动带上会话头,通常不必再装插件。真正需要额外手段的,是你确实在用 OpenCode 服务,却把提供商配成自建名称:手写 baseURL、api 选 openai-completions,路由名随你取——这类自定义命名走不到内置包装,头只能由扩展补上。
dsh-ocg-session-head 只做一件事:在宿主为 llm-pi-ai 预留的 request-headers 席位里,按当前对话注入 x-opencode-session(默认名可改)。它不替换 globalThis.fetch,不用 AsyncLocalStorage,也不改写已有请求头——静态配置、官方实现和其他插件先写的头永远优先。没有 sessionId 的辅助调用会原样放过;内部出错只打警告并 fail open,不会拖垮一次推理。可配置提供商键白名单、baseURL 主机后缀白名单(二者 OR)、以及 session-id 或 uuid 两种稳定策略。
适合宿主版本不低于 0.2.2、且用自定义提供商名连 OpenCode Go 的用户。官方路径已自动带头者可忽略本插件;在更早的宿主上安装不会报错,但事件钩子不存在,行为与未装无异,适合先装插件、再升级宿主做分步验证。也适合从旧的 fetch 补丁方案 dsh-opencode-session 迁移、希望更贴近宿主契约、副作用更小的场景。
使用场景
- 自定义命名的 OpenCode 提供商对话反复出现 MissingSessionID 或 400
- 官方 opencode 路由已自动带头,仅需为自建 baseURL 的 OCG 路由补头
- 从 dsh-opencode-session 的 fetch 补丁迁移到宿主官方 request-headers 席位
适合人员
- DeepSeek Harness 0.2.2 及以上、用自定义提供商连 OpenCode Go 的开发者
- 不走官方 opencode 路由、却依赖 x-opencode-session 合规推理的用户
- 希望零全局副作用、配置校验响亮、可调试注入行为的插件维护者