MX1syk/dsh-x-opencode-session

dsh-x-opencode-session

DSH 插件，用于向 LLM provider 请求注入动态/随机 HTTP 请求头（例如 ${uuid} 模板）——为 opencode-go 网关提供一个运行期间稳定的 x-opencode-session。

dsh-x-opencode-session 是一个 DeepSeek Harness（DSH）插件，用于向 LLM provider 请求注入动态 / 随机的 HTTP 请求头。DSH 的 pi-ai provider 只接受静态 headers 字符串——它无法表达每次运行的动态值。本插件在不改动 DSH 源码的前提下填补了这一空白。

DeepSeek Harness（DSH）插件：把动态 / 随机的 HTTP 请求头注入 LLM provider 请求，解决 DSH 的 pi-ai provider 只能配置静态 headers 字符串、无法表达“动态/随机数值”的问题。

典型场景：DSH 用 opencode-go provider（openai-completions 协议）向 OpenCode Go 网关发请求时，网关需要 x-opencode-session 会话头来做会话亲和/路由/缓存（自 2026-09-06 起缺失即 400 Model is unavailable）。静态硬编码会让所有 DSH 运行共用同一个会话 id；本插件让每个 DSH 进程（每个评测 run / 并行 runner）铸造一个唯一的随机会话 id，并在进程内保持稳定，互不串会话，且不修改任何 DSH 源码。

原理

- 包装 globalThis.fetch（当前 dsh-llm-deepseek 与 dsh-llm-pi-ai 适配器都经由全局 fetch 发请求），对 URL 命中 urlPatterns 的请求，把模板值 set() 到请求头上（覆盖同名头，包括 pi-ai 的归属 user-agent）。
- 零默认：headers 为空时插件完全惰性，不改任何请求、也不包 fetch。
- 卸载安全：仅当自己仍是当前包装器时才恢复上一个 fetch，不破坏后续包装者。
- verbose 日志自动脱敏 authorization / cookie / api-key 等凭据头。

安装

插件目前托管在 GitHub（尚未发布到 npm）：

从 GitHub 安装
dsh plugin --profile web add github:MX1syk/dsh-x-opencode-session

本地目录开发（改代码调试时）
dsh plugin --profile web add link:/path/to/dsh-x-opencode-session

配置

包自带的 cordis.patch.yml 只插入一个空 config 的插件行（惰性 no-op）。把下面的完整 config 写到 profile 的 cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml（同一 id 的补丁层会整体替换该行的 config）：

$DSH_HOME/cordis.patch.yml
- insert:
- id: dsh-x-opencode-session
name: dsh-x-opencode-session
config:
只改这些 URL 的请求（大小写不敏感的子串匹配，命中任一项即注入）
urlPatterns:
- /chat/completions
动态请求头：值 = 普通字符串，可含模板占位符
headers:
x-opencode-session: "${uuid}"            # 进程级唯一、进程内稳定
x-opencode-request: "${uuid@request}"    # 每次请求新值
x-opencode-client: "dsh"
x-opencode-project: "dsh-bench"
user-agent: "opencode/0.2.1"
默认铸造作用域：run（进程级冻结）或 request（每次请求重铸）
scope: run
verbose: false

若网关 baseURL 路径不含 /chat/completions，把网关 host 也加进 urlPatterns，例如 - console.opencode.go。

值模板语法

| 模板 | 说明 |
| --- | --- |
| ${uuid} | UUID v4 |
| ${hex:N} | N 位小写十六进制（默认 16） |
| ${alnum:N} | N 位字母数字（默认 12） |
| ${digits:N} | N 位数字（默认 8） |
| ${int:min:max} | [min, max] 内整数 |
| ${ts} | epoch 毫秒 |
| ${iso} | ISO-8601 时间 |
| ${env:NAME} | process.env.NAME 在渲染时读取 |

作用域后缀：@run（默认，进程内铸造一次并冻结）或 @request（每次请求重铸）。scope 配置项决定没有后缀的占位符的默认作用域。注意：${env:...} 在 run 作用域下首次渲染后即冻结（如需每次重读环境变量，用 @request）。

未知函数 / 非法参数（如 ${hex:0}、${int:9:3}）不会报错：保持原文发送，并在启动时告警，其余头照常生效。

与 provider 静态 headers 的取舍

- pi-ai provider profile 的 headers 只能写死静态值；本插件在其外层（fetch 层）覆盖，天然支持动态。
- 本插件可覆盖 user-agent（pi-ai 会把 profile 的 user-agent 剥离成归属 UA；fetch 层注入不受此限制），是否覆盖由你在 headers 里是否显式配置决定。
- 配置为组合层（composition entry）级别：修改需重启 DSH 生效。

本地开发与测试

node --test "tests/*.test.mjs"

- tests/templates.test.mjs：模板引擎（随机性、边界、非法 token 告警）。
- tests/wrapper.test.mjs：fetch 包装（URL 门控、头合并覆盖、run/request 作用域、卸载恢复、多层包装不被覆盖）。

用 verbose: true 观察实际注入的请求头（凭据头已脱敏）。

已知限制

- 依赖适配器通过全局 fetch 发请求（当前 DeepSeek 与 pi-ai 适配器均是）；若未来某适配器改用自定义 dispatcher 则不在覆盖范围。
- 匹配目标是完整请求 URL 的子串；如需更精确匹配，请把完整 URL 片段写进 urlPatterns。
- 多个同样包装 fetch 的插件会互相覆盖：本插件卸载时只在自己仍是当前包装器时恢复原值。