dsh-ocg-session-head：为 DeepSeek Harness 补齐 OCG 会话请求头

它是做什么的？

OCG 会话头是 DeepSeek Harness（DSH）的请求头注入插件，为 OpenCode Go 路由按会话自动写入 x-opencode-session 请求头。它解决自定义 OCG 路由拿不到官方包装、推理请求因缺少会话 ID 被拒（400 MissingSessionID）的问题。插件只在宿主预留的请求头席位里写一个头，不替换全局 fetch、不使用异步上下文存储，零依赖且无全局副作用。

核心功能

• 按会话注入请求头：为每个会话生成稳定的 x-opencode-session 值，跨轮次、上下文压缩与重启保持一致。
• 双门匹配路由：按路由键白名单与 baseURL 主机后缀两条门筛选请求，二者为「或」关系，换路由键时仍有兜底。
• 两种会话模式：session-id 直接复用宿主会话 id，uuid 按会话派生进程内稳定的不透明标识，并限制映射上限、按最旧淘汰。
• 严格配置校验：未知键名、类型错误、非法头名、指向宿主归属头等情况会响亮报错并指出字段，不静默回落。
• 安全行为保证：已有同名头一律让路，无会话 id 不注入，内部异常只告警并放行，绝不打断推理。

怎么使用这个插件？

在 DSH 中启用后，插件会随宿主生命周期注册监听器，无需手动触发；默认配置即对 ocg 路由生效。需要调整时，在 profile 的 cordis.patch.yml 里按插件 id 覆盖配置，可改路由白名单、主机后缀、头名、会话模式与调试开关，注意按 id 覆盖是整体替换。验证分四步：看启动 ready 日志、打开 debug 看每次注入日志、正常对话不再出现 400、禁用插件后立刻复现 400 以反向确认。插件要求 DSH 不低于 0.2.2-rc.1，低版本上安装安全但事件不触发，可先装后升级分步验证。

报错怎么排查？

推理请求返回 400 MissingSessionID 说明会话头没有发出：先确认宿主版本满足要求，再检查路由键或 baseURL 主机是否落在白名单内，必要时打开 debug 观察注入日志。插件激活失败并提示字段名时，按提示修正配置中的非法键、类型或头名；若条目导入失败，通常是安装目标被当成了包目录而非打包产物，按官方说明改用打包文件安装。