前言¶
在使用 DeepSeek Harness 开发智能体时，调用 opencode.ai 提供的模型服务通常需要特定的请求头。手动为每个请求添加 x-opencode-session 既繁琐又容易出错。该插件旨在自动化这一过程，确保请求符合服务端要求，避免因头信息缺失导致的调用失败。
插件介绍¶
这是一个 DeepSeek Harness 插件，由 Coco-king 维护，遵循 MIT 许可证。当模型调用发往 URL 包含 opencode.ai 的服务（如 OpenCode Go / Zen 网关）时，它会自动附加 x-opencode-session 请求头。
核心功能¶
- 自动附加请求头：自动为发往 opencode.ai 的请求添加该头。
- 同一对话内固定：同一对话的所有模型请求携带同一个值。
- 不同对话互不相同：各对话之间互不干扰。
- 断开网络或重启后不变：值来自对话自身的持久标识，重启、续聊、断网重连后依然一致。
- 仅影响 opencode.ai 请求：不维护额外状态，只修改目标请求。
安装与启用¶
从 GitHub 安装：
dsh plugin --profile web add https://github.com/Coco-king/dsh-x-opencode-session.git#v0.1.0
从 Gitee 安装（国内用户可用；代码由 GitHub 自动镜像同步到 Gitee）：
dsh plugin --profile web add https://gitee.com/kkcoco/dsh-x-opencode-session.git#v0.1.0
重启 web 服务（或刷新页面 + HMR）后生效。
使用验证¶
- 使用 opencode-go 提供方的模型发起对话并正常使用。
- 通过抓包或服务端日志确认请求带上了
x-opencode-session头。 - 同一对话中多次请求值应保持一致，另开一个新对话值应不同，重启 web 后再发消息值仍与之前一致。
注意事项¶
- 值无需任何配置，自动复用对话自带会话标识。
- 不维护额外状态，仅影响 opencode.ai 请求。
- 安装前建议检查源码与许可证。
结语¶
该插件通过复用对话自带标识，解决了 opencode.ai 调用中的会话头问题。更多详情可参考 GitHub。
