QiE2035/dsh-llm-headers
QiE2035★ 0TypeScriptLast synced: 2026-08-16
—
README excerpt
dsh-llm-headers 为 DeepSeek Harness 的自定义 LLM API 请求注入 HTTP Headers(典型用途:改写 user-agent ,例如网关要求 UA 带指定品牌字样)。 原理 DeepSeek Harness 的 LLM 适配器( dsh-llm-deepseek 、 dsh-llm-pi-ai )都通过全局 fetch 发出模型请求。本插件在加载时包装 globalThis.fetch : 仅对 URL 匹配 urlPatterns 的请求 ,把配置的 headers 逐项 set() 上去(覆盖同名头,包括适配器的强制 attribution user-agent —— 即部署者白标替换场景),其余请求原样透传。提供商无关,一次配置同时作用于所有 LLM provider。 配置不写死:插件把 Config schema 注册为 llm-headers 用户配置命名空间, Web UI 的 settings 页面会自动渲染该命名空间的编辑表单 ,修改保存后下一个请求即生效(live 热重载,无需重启)。 安装 作为 bundle(发布形态) 把本目录作为一个包安装进 profile: dsh 会追加 llm-headers 到 profile 的 bundle 层,默认配置下插件处于惰性状态( headers 为空),不会改写任何请求。 本地源码加载(开发形态) 在任一 cordis.yml (或 patch overlay)里按路径引用源码,仅用于开发调试: 配置 字段 类型 默认 说明 headers Record {} 注入的请求头;同名覆盖,空表示不注入 urlPatterns string[] ['/chat/completions'] URL 子串匹配规则,命中任一项即注入 通过 Web UI 配置 安装到含 Web 界面的 profile 后: 1. 打开 Web UI → Settings(设置)页面; 2. 「插件」→「插件配置」应看到本插件的 LLM 请求头 卡片(服务端注册已就绪); 3. 填写 headers 与 urlPatterns 保存,写入 user-settings 文档并实时生效( applies: live )。 UI 保存的值优先级高于 cordis.yml 中的 config (作为 base 层)。 通过 settings.yaml 配置(备用) 保存即热重载( applies: live ),无需重启。 开发 依赖全部来自 npm registry( @deepseek-ai/cordis 、 @deepseek-ai/schemastery 、 @deepseek-ai/dsh-settings 及构建工具),克隆后直接安装即可;其余 @deepseek-ai/ 包…
View full README on GitHub →