请求头改写 dsh-plugins/dsh-user-agent

@dsh-plugin/dsh-user-agent

一个 DeepSeek Harness 插件，把每个发出的 HTTP 请求（LLM API 调用以及其他走全局 fetch 的流量）里的 User-Agent 改写成你指定的值，并可以在 Web 设置面板的 UA 设置 (User-Agent) 标签页里实时配置。

功能

- 改写所有走全局 fetch 的请求 —— 包括 dsh-llm-deepseek 发出的 DeepSeek / OpenAI 兼容适配器调用、Web 搜索，以及任何通过 HTTP 抓取数据的工具。配置的 UA 会覆盖调用方自己的请求头（比如 dsh-llm 的归因基线）。
- 实时设置页 —— Web GUI 设置面板里的 settings.section 标签页：开关改写、编辑 User-Agent 字符串。改动对下一个请求立即生效，不用重启。
- 标准设置集成 —— 值存放在 dsh-user-agent 用户设置命名空间里，跨会话保留，任何支持设置的界面都能编辑。
- 干净的生命周期 —— 只在插件运行期间包装 globalThis.fetch；原始 fetch 只捕获一次，在停止 / 更新 / 卸载时还原。fetch 不可用时退化为只读。

安装

这个包是 dsh bundle 插件（dsh.bundle.patch），用标准的 dsh plugin add 命令安装：

dsh plugin add @dsh-plugin/dsh-user-agent
or, with a specific profile
dsh plugin --profile web add @dsh-plugin/dsh-user-agent

然后在 Web GUI 里打开 Settings → UA 设置：打开开关，填入你想要的 User-Agent，点 保存 (Save)。

配置

插件入口（cordis.patch.yml / profile 覆盖）—— 这些值作为组合的 base 层，与用户设置区段合并：

| 字段 | 类型 | 默认值 | 含义 |
| enabled | boolean | true | 总开关；关闭时包装器直接透传。 |
| userAgent | string | DeepSeek-Harness/0.1 (+https://github.com/deepseek-ai/dsh) | 应用到每个被改写请求的 User-Agent。 |

工作原理

- 宿主侧包装 globalThis.fetch。每次调用时读取当前配置（已解析的设置作用域，没有挂载设置服务时则读组合入口），当开关打开且 UA 非空时，构造新的 Headers 并强制写入 user-agent，再交给原始 fetch。
- 浏览器侧注册 settings.section 标签页，通过连接的 ApiProxy（api.settings.describe / update）读写命名空间，与 aux / 主线 DSH 插件用的是同一套接口。

开发

npm install # dev deps + auto-installed peers
npm run build # tsc (host + client) + strip client module-ification artifact
npm test # node --test
npm pack --dry-run # inspect published contents

npm 发布

.github/workflows/npm-publish.yml 会跑质量检查（多操作系统矩阵）并发布：
- 推送到 main → 发布 X.Y.Z-dev.<run-id>，使用 next dist-tag；
- 打上 vX.Y.Z 标签（与 package.json 匹配）→ 把 X.Y.Z 发布到 latest，并附带 provenance。

许可证

MIT