前言¶
在使用 DeepSeek Harness 进行模型推理时，如果接入 OpenRouter 并需要按服务档位（service tier）区分请求费用与性能，通常需要修改原生档位配置。直接在宿主配置中修改容易影响全局，且缺乏细粒度控制。本插件通过命令行与工具接口，在不注册独立 adapter 或第二套模型目录的前提下，对原生 OpenRouter 请求进行档位控制，保持 thinking、认证、消息、工具、附件、replay、取消、超时与重试等流程走宿主原生调用链。
插件定位¶
本插件是 DeepSeek Harness 原生 OpenRouter service tier 控制插件，包名为 @shenjackyuanjie/dsh-openrouter-service-tier，由用户 shenjackyuanjie 维护。它不新增模型目录，不修改原生档位配置结构，仅通过动态定位原生 namespace 和 profile 路径，对指定模型或全局生效的档位进行覆盖与取消。
核心功能¶
插件通过命令行命令与 Agent 工具两种方式控制档位。
命令行命令¶
/openrouter-tier：查看当前原生档位。/openrouter-tier flex：设置全局 flex 档位。/openrouter-tier openai/gpt-6-luna priority：只对模型openai/gpt-6-luna应用 priority 档位。/openrouter-tier openai/gpt-6-luna omit：该模型不发送档位。/openrouter-tier omit：全局不发送档位（保存为 null）。/openrouter-tier reset：清除全局用户覆盖，恢复底层继承。/openrouter-tier openai/gpt-6-luna reset：删除该模型的有效覆盖；最后一项删除后写空数组，屏蔽底层覆盖数组。
Agent 工具¶
工具名为 openrouter_service_tier，支持 get、set、reset 操作。修改前需先 get，携带返回的原生 namespace revision 作为 expectedRevision；并发冲突会明确失败。结果只包含档位和 revision，不投影 headers 或其他连接设置。
档位语义¶
有效优先级为：精确模型覆盖 > 全局档位 > 不发送。模型 omit 会屏蔽全局档位；全局 null 不屏蔽模型显式 priority。unset 用于恢复底层继承，可能重新得到 flex；null/omit 才是显式不发送。空数组会屏蔽继承数组，清除整个数组字段则恢复底层数组。
协议值为 default、flex、priority、fast、ultrafast。fast 是 priority 别名。费用与可用性以实际服务为准，不保证按请求档位计费。宿主只在原生 OpenRouter 的 Chat Completions、Responses、Anthropic Messages 请求 body 顶层设置 service_tier，无有效档位不加 hook，不发 inherit/omit/null。
安装与启用¶
插件安装前需先为宿主应用对应的 llm-pi-ai 补丁。宿主版本为 0.2.1-rc.2 时使用 ...@0.2.1-rc.2.patch，0.2.1-rc.3 时使用 ...@0.2.1-rc.3.patch。补丁配置方式为在宿主 pnpm 项目的 patchedDependencies 中指定绝对路径：
patchedDependencies:
'@deepseek-ai/dsh-llm-pi-ai@0.2.1-rc.3': /absolute/path/to/patches/@deepseek-ai__dsh-llm-pi-ai@0.2.1-rc.3.patch
安装插件需要登录 GitHub npm registry 并具备 read:packages 权限的 classic PAT：
npm config set '@shenjackyuanjie:registry' 'https://npm.pkg.github.com' --location=user
npm login --scope=@shenjackyuanjie --auth-type=legacy --registry=https://npm.pkg.github.com
dsh plugin --profile web add @shenjackyuanjie/dsh-openrouter-service-tier@0.4.0 --ignore-scripts
首次安装需在插件管理器启用该 bundle。更换宿主或插件代码后重启 Host；之后档位设置通过原生 volatile 热更新生效。
适用场景与注意¶
本插件适合需要在 OpenRouter 场景下对模型或全局档位进行精细化控制，同时希望保持原生调用链与 thinking 能力的开发者。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。插件停用只撤回命令与工具，不清空原生档位、不移除模型。失效覆盖不会静默当作有效配置，删除失效覆盖可用于修复。
生态背景¶
DeepSeek Harness 理念是「一切皆插件」，本插件为社区贡献的模型推理插件，与 DeepSeek / 幻方无官方从属关系。
总结¶
本插件通过命令行与工具接口，在保持原生调用链的前提下，提供细粒度的 OpenRouter service tier 控制，适合需要在推理场景中按模型或全局调整档位的开发者。使用前需确保宿主版本正确并应用对应补丁。目录页：https://www.skillhub.cn/plugins/shenjackyuanjie/dsh-openrouter-service-tier
GitHub：https://github.com/shenjackyuanjie/dsh-openrouter-service-tier
