dsh-fast

为 DeepSeek Harness（DSH）提供当前会话的「标准 / Fast」档位切换，以及带推理等级调节的模型选择器。Fast 将一个明确配置的 provider、一个完整的 Responses URL 的请求转发到指定 Codex Responses URL，并设置 service_tier: "priority"。

兼容范围与限制

• 本版本为 0.1.0，宿主兼容范围保守限定为 DSH 0.2.1-rc.5，Web 客户端需要内置的模型选择服务 @deepseek-ai/dsh-client-ui-model-selection。其他 DSH 版本和 Desktop 客户端未验证。
• 当前只支持单 provider / 单 Responses URL → 单 Codex Responses URL。这是定向的 Responses-to-Codex 转发，不是通用供应商加速器；普通供应商、Chat Completions、自定义协议均不能据此视为已支持。
• 需要原适配器通过兼容的 Undici 7 全局 dispatcher 发起请求。绕过全局 dispatcher 的 HTTP 客户端、独立 dispatcher、Undici 8 请求链不在本版验证范围。
• Fast 只影响当前会话的后续请求，不继承到普通子会话。供应商实际是否提供优先级、是否收费或更快，由目标服务决定；切换状态本身不证明请求已命中目标或得到优先处理。
• 已用本地合成请求覆盖并发隔离、SSE、工具/图片/推理载荷保留、认证转发、取消和卸载。未通过本发布流程调用付费模型，也未做所有供应商的真实端到端验证。

安装

需要已安装 DSH 0.2.1-rc.5，以及 Node.js 22.19.0 或更新版本。插件固定依赖 undici@7.30.1 和 zod@4.6.7；宿主 peer 依赖为 @deepseek-ai/cordis@~4.0.5、@deepseek-ai/schemastery@~3.18.5。

使用 GitHub Release 的固定版本压缩包安装，不依赖 npm 发布：

dsh plugin --profile web add https://github.com/Delthin/dsh-fast/releases/download/v0.1.0/dsh-fast-0.1.0.tgz

将 web 替换为自己的 profile 名称。也可在 DSH 的插件页使用同一 URL 安装。安装后在插件页检查组合包和 fast 条目是否启用；若 DSH 提示需要重启，则重启该 profile，再刷新 Web 页面。

首次安装无需角色插件或 Fast 路由即可加载。 默认没有 provider、源 URL、目标 URL 或本机路径：标准请求仍走原适配器，模型选择器中的 Fast 入口禁用，/fast on 会明确提示尚未配置。仅填写部分路由字段时也按未配置处理。

配置 Fast 路由

在目标 profile 的 cordis.patch.yml 中为安装生成的 fast 条目添加覆盖；也可以通过支持修改条目配置的 DSH 插件界面操作：

- id: fast
  config:
    provider: my-provider
    sourceURL: https://provider.example/v1/responses
    targetURL: https://trusted-target.example/backend-api/codex/responses

示例域名不可直接使用，必须替换为自己确认支持此路由的地址。

字段	含义
provider	DSH 中已有供应商的真实 ID，不是显示名称；插件不会创建供应商或配置凭据。
sourceURL	原适配器实际 POST 的完整 Responses URL，包含路径与查询参数（如有）。不是 API base URL。只有精确匹配此地址的请求才会被转发。
targetURL	管理员明确指定且可信的 Codex Responses 目标 URL。完整配置中的 URL 必须为 HTTP(S)，不能包含用户名、密码或 fragment；无效 URL 会导致插件加载失败。
roleRunsPath	可选，已有角色插件的 runs.json 快照文件路径。默认空字符串，不读取角色文件。相对路径按 DSH 宿主进程的工作目录解析。

配置保存并由 DSH 重新加载后，打开模型选择器，在配置的供应商上切换 Fast；也可使用：

/fast on
/fast off
/fast toggle
/fast status

Fast 状态下请求其他 provider 会得到明确错误，请先切回标准档。Fast 状态下没有匹配 sourceURL 的网络请求仍会直通；请核对原适配器的真实 URL。状态接口中的 lastDelivery 仅是当前进程内的转发尝试记录，不是目标已接受请求或兑现优先级的证明。

如果卸除了路由配置，已有 Fast 会话会明确报「尚未配置」，不会静默降档；可以用 /fast off 或模型选择器切回标准档。

角色插件（可选）

不安装角色插件也能独立使用会话档位。需要和已有角色插件联动时，显式设置 roleRunsPath，例如：

- id: fast
  config:
    provider: my-provider
    sourceURL: https://provider.example/v1/responses
    targetURL: https://trusted-target.example/backend-api/codex/responses
    roleRunsPath: ./agent-roles/runs.json

同时在角色插件自己的配置中手动将 fastProviders 对齐到相同 provider ID，例如 fastProviders: [my-provider]。本插件不会安装、修改或自动同步角色插件。

角色会话档位以启动快照中的 selection.fast === true 为准，固定后不能通过 /fast 或模型选择器修改。旧快照缺少 selection.fast 时仍固定为标准档，不能从角色模板的当前值反推。角色设置的修改只作用于以后启动的新成员。文件不存在或会话不在快照中时按普通会话处理；已配置文件损坏或格式错误时会报告错误，不忽略已有快照规则。

认证与安全

Fast 保留原适配器生成的认证及业务头，只向明确配置的 targetURL 发起 Fast 上游请求，不从请求头或请求体选择目标，也不自动跟随目标的 HTTP 重定向。请求内容会发送到该目标；认证凭据也会随之转发，因此目标必须可信，并且有权接收原供应商的凭据。生产目标应使用 HTTPS。

配置完整时，插件使用带随机令牌的本机 loopback 转发端口，并清理内部控制头、连接级头。支持原链路经过本机 billion 转发器的精确 /bili/<sourceURL> 形式，先保留其处理，再转换 Codex 外层载荷；第三方转发器仍需自行审查其认证和日志策略。

插件通过已有的 llm/stream、storageDomain、sessionController、connection 和 commands 能力工作，不增加 DSH Service，也不替换全局 fetch 或原适配器。会话档位保存在 DSH 的 dsh_fast domain；转发回执只保存在内存，最多 1000 个会话，不含提示词、请求头或凭据。

开发与打包

从源码仓库准备依赖后执行（安装依赖会按包管理器设置访问注册表）：

npm install
npm run check
npm test
npm pack

prepack 会执行语法、JSON/元数据检查和定点测试。测试只使用合成数据、本机 HTTP 服务及不发网的示例 URL，不调用模型。files 白名单仅包含运行文件、locale、图标、README 和 LICENSE；测试、检查脚本、截图索引、截图、依赖目录与本地工件留在源码仓库，不进入安装包。

源码仓库：https://github.com/Delthin/dsh-fast。MIT License，版权归 Delthin。

English

dsh-fast adds per-session Standard / Fast controls and a reasoning-effort model picker for DeepSeek Harness 0.2.1-rc.5 (Web). It supports one explicitly configured provider and one exact Responses URL forwarded to one trusted Codex Responses URL with service_tier: "priority"; it does not provide universal provider support or guarantee faster service.

Install the versioned GitHub Release tarball using the command above. No npm publication is required. With no route configured, the plugin loads normally, leaves Standard calls untouched and disables/refuses Fast. Set provider, sourceURL and targetURL in the profile's fast entry to enable it. Authentication from the original adapter is forwarded to the configured target, so that target must be trusted and authorized to receive those credentials.

Roles are optional. Set roleRunsPath only for an existing role snapshot file and manually align the role plugin's fastProviders. Spawn-time selection.fast is immutable; older snapshots without it remain locked to Standard. Runtime dependencies are pinned to undici@7.30.1 and zod@4.6.7. Local synthetic tests do not invoke paid models. MIT © Delthin.