DSH Plugins
返回列表
🧰

dsh-opencode-session-header

联网工具 更新于 2026.10.25

在终端中运行以下命令:

dsh plugin install NotKeKe/dsh-opencode-session-header

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中运行 dsh plugin install NotKeKe/dsh-opencode-session-header,或从源码地址 https://github.com/NotKeKe/dsh-opencode-session-header 安装该插件,安装后变更即生效。

插件介绍

从 2026 年 9 月初开始,OpenCode Go 对每个推理请求强制要求携带 x-opencode-session 标头,缺少该标头的请求会被直接拒绝路由。在 DSH 的常规对话中这通常不成问题——agent loop 每轮对话都会填写 session id,底层 provider 会自动据此生成标头。但那些没有 session id 的手动组装请求就没那么幸运了:内置的实验性自动审查插件正是典型例子,它的风险分类调用只携带 provider、model、system、messages 等字段,唯独没有 sessionId。于是一旦把权限切到 Auto review,每次工具执行前的审查请求都会收到 400,工具调用本身也跟着失败,整个自动化流程被卡死。

这个插件只做一件事:包装 host 进程的 globalThis.fetch,并且只在一种情况下动手——请求目标是 opencode.ai 及其子域,且请求中确实缺少 x-opencode-session 标头时,补上一个稳定的合法 token。其余情况一律不碰:已带该标头的请求(不区分大小写)原封不动,DeepSeek 官方、Anthropic、OpenAI 等其他 provider 完全不干预;URL 无法解析或出现任何异常时,直接回退到原始调用,不制造新的失败模式。之所以强调「只在缺失时补」,是因为网关只检查标头存在且格式合法,并不验证 session 是否真的注册过,所以一个进程内稳定的 token 就足够,同一 session 的多次审查请求也会共用同一个路由键。相反,如果在 provider profile 里写死一个标头也能让审查请求通过,但那会把主对话原本正确的 per-session 值一并覆盖,等于拿对话路由和缓存亲和性去交换,得不偿失。

之所以包装 fetch 而不是拦截 llm/stream,是因为 llm service 的 waterfall 虽然看起来是理想的拦截点,但最终回调用闭包捕获了 options 与 prepared 且不接受参数,监听器即使调用 next(newOptions) 也无法影响实际发出的请求,只能在更下层的 fetch 层动手。安装后无需重启即可生效,卸载时会完整还原原始 fetch,不修改任何文件、凭证或配置。这个插件适合使用 OpenCode Go provider 并开启了 Auto review 权限模式的 DSH 用户——如果你在工具执行前的审查阶段反复遇到 400 错误,而主对话又一切正常,那么它几乎就是为你准备的。需要注意的是目前没有 Config schema,若要调整目标 host 或 token 前缀,需要修改 index.js 中的 TARGET_HOSTS 与 TOKEN_PREFIX 常量;把 VERBOSE 设为 true 可以让每次注入在 host console 打印一行,便于排查问题。

使用场景

  • Auto review 审查请求被 400 拒绝、工具调用跟着失败时
  • 主对话正常但手动组装的请求缺少 session id 时
  • 需要保持原有 per-session 标头不被覆盖时

适合人员

  • 使用 OpenCode Go provider 并开启 Auto review 的 DSH 用户
  • 遇到审查阶段 400 报错、需要恢复工具执行的开发者
  • 关注对话路由与缓存亲和性不被破坏的维护者