前言¶
在 DeepSeek Harness(DSH)里开启实验性 Auto review 后,审阅模型往往仍跟会话模型绑在一起。主模型偏大、偏慢,或某一供应商出现限流、配额、网络错误时,一次审阅可能直接卡住,拖慢工具执行前的授权流程。社区维护者 pnpwin 发布的 DSH Auto Review Fallback(@pnpwin/dsh-auto-review-fallback)在官方实验性 Auto review 之上,通过 DSH 公开的 llm/stream 扩展点增加「独立审阅路由 + 最多七级有序可用性降级」,并在多种技术失败时按规则切换下一路由,正常完成(含 deny)则停止链路,由上游策略继续校验。本文根据仓库 README 与 package.json 说明其定位、能力与安装配置要点;该插件并非 DeepSeek 官方产品,Auto review 本身仍为实验能力,可在完整主机权限下授权不安全操作。
这是什么¶
DSH Auto Review Fallback 是一套 DSH 社区插件(GitHub:pnpwin/dsh-auto-review-fallback),当前发行版本 0.1.2,MIT 许可证,维护者为 pnpwin。它不打包、也不替代上游 @deepseek-ai/dsh-experimental-auto-review 的授权策略、响应解析器或工具执行门控,只扩展审阅调用时的模型选择与可用性降级逻辑。
引擎约束在 package.json 中写死为 DSH 0.2.2-rc.1,并需在该版本中启用内置实验性 Auto review。README 注明底层曾在 macOS DSH Desktop 上验证;其他 DSH 版本、平台及 CLI host 模块解析未在公开说明中确认。
核心功能¶
下面介绍插件在资料中明确列出的能力。
独立审阅模型与有序降级链¶
- 可为审阅单独指定 provider + 精确 model ID,与会话模型解耦。
- 可配置 一个主审阅路由 和最多 七个按顺序排列的 fallback。
- 每条路由可设置单次尝试超时:1–120 秒,默认 20 秒。
- 可选填该路由支持的 reasoning-effort ID;留空则使用 adapter 默认。若填写了模型不支持的 effort,视为配置错误,停止审阅,不会静默改 effort 或换模型。
- Provider 名称来自 Settings → Models 中已连接的供应商;模型列表使用 DSH 共享目录,并支持已保存的 model ID / 手动输入作为后备。
这是一套 fallback 链,不是随机负载均衡、投票,也不是「换到愿意批准的模型」。每次新审阅都从主模型开始。
默认与会话一致(Follow session)¶
默认模式为 Follow session:使用会话当前模型,沿用与自定义链相同的边界化准备与请求 framing,但没有 fallback,也不会自动选新 provider。README 说明此模式下仍会应用针对 Codex Unsupported parameter: temperature 的兼容处理,无需另装兼容插件。
与上游的关系及 Codex 兼容¶
插件基于官方 @deepseek-ai/dsh-experimental-auto-review 扩展。Codex 温度参数不兼容问题在 DeepSeek Harness Discussion #12495 中讨论;具体上游修订范围见仓库内 UPSTREAM.md。
设置界面支持英文或俄文,并使用 DSH 主题 token(package.json 中 client 注入 @deepseek-ai/dsh-client-ui-settings 等)。
降级规则(fail-closed)¶
README 用表格归纳行为,核心如下:
| 结果 | 行为 |
|---|---|
| 可识别的限流、配额、超时、网络/传输失败、部分服务端错误,或路由/模型/凭据不可用 | 停止上一路传输后,尝试下一条配置路由 |
正常完成(含 deny) |
停止链路,由上游审阅逻辑校验响应 |
| 畸形 JSON、不支持的显式选项/effort、max-tokens、策略拒绝或未知错误 | 不降级,保留上游失败/批准行为 |
| 已在文本层面完成后又出现技术错误 | 不降级,不换模型推翻已有答案 |
| 父级取消或插件卸载 | 中止,不启动下一路由 |
| 无法确认上一传输已停止 | fail-closed,不重叠发起 fallback |
| 所有路由均不可用 | 返回 AUTO_REVIEW_ROUTES_EXHAUSTED,不执行工具体 |
失败尝试会缓冲,避免部分文本泄漏到 fallback 答案;缓冲上限为 2 MiB / 20,000 chunks(README 截断处仍保留此条)。
安装与启用¶
资料说明这是 GitHub 源码包,不是 npm 发布;无依赖、无安装脚本、无构建步骤。安装后 profile 可能链接该目录,安装期间勿删除或移动;git pull 后需重启 DSH 并刷新页面,以替换缓存的 Host 代码与 Client 产物。
若曾使用本地原型 @local/dsh-auto-review-router,需先禁用/移除,不要与两个独立审阅路由器同时运行。本包使用独立设置命名空间 pnpwin-auto-review-fallback,不会自动迁移旧链配置。
README 给出的步骤:
- 获取仓库到本地目录(README 示例为
git clone https://github.com/pnpwin/dsh-auto-review-fallback.git后cd dsh-auto-review-fallback)。 - 用 Plugin Manager 或 CLI 将该目录的绝对路径安装到目标 profile:
dsh plugin --profile desktop add "$PWD"
将 desktop 换成实际 profile 名。该 profile 内的 agent 也可通过 plugin_manager 工具、action: install_bundle 与目录绝对路径安装。
- 刷新已打开的 DSH 页面,进入 Settings → Auto review。
- 在需要使用的会话中启用 Auto review。
独立测试需 Node.js 24.9.0 或更新(package.json engines.node)。
典型配置与用法¶
下面介绍 lighter reviewer 的自定义链配置,与 README 一致。
- 在 Settings → Auto review 中选择 Custom model chain(若继续跟会话模型一致,保持默认 Follow session 即可)。
- 选择主审阅 provider 与 model,按需添加或调整 fallback 顺序(最多七条)。
- Reasoning effort 仅在确认该模型支持对应 ID 时填写;不支持则会导致配置错误并停止审阅。
- 设置单次尝试超时,点击 Save。保存走 DSH 自带设置 API(含 revision/冲突检查);对新发起的审阅生效,进行中的审阅仍用快照配置。会话模型与权限模式不会被本插件改写。
若在 Models 中新增或重命名了 provider,重新打开页面或点击 Reload catalog。目录暂时不可用时,已保存或手填的 model ID 不会被清掉。
Kimi Coding 订阅应使用 kimi-coding 连接及目录中的 ID(如 kimi-for-coding、k3);moonshotai 连接走 Moonshot API,误用可能导致 HTTP 401。路由器不会静默改写 provider/model 或复制凭据。
适用场景与注意¶
适合谁: 已在 DSH 0.2.2-rc.1 上启用实验性 Auto review,希望用更小/更快的模型做审阅,或为主审阅模型配置有序、可预期的可用性备份链的开发者。分类上属于目录中的 模型推理 类插件。
安全与隐私:
- README 明确警告:社区插件,非官方产品;Auto review 为实验功能,可能授权带完整主机访问的不安全操作;更快/更小的审阅模型不等于更安全的审阅模型。
- 插件以当前 DSH 进程权限运行;安装前应自行查看源码与 MIT 许可证。
- 每一次尝试的审阅方都会收到上游审阅输入(授权策略、保留指令/历史、待执行工具参数)。fallback 到另一 provider 可能把相同数据发往另一组织,请只选择信任的端点。插件不记录审阅 prompt、生成答案、凭据或拒绝原因;路由 ID 与技术状态码可能出现在 DSH 日志中。
能力边界: 上游严格风险/决策解析器仍拥有最终决定;畸形输出或 deny 不会触发换模型。 framing 改善的是遵循度,不保证模型风险判断更可靠。v0.1.2 说明中对 GLM-5.3、Kimi K3 等 reasoning 默认值等 adapter 行为有专门兼容说明。
结尾¶
DSH Auto Review Fallback 在不动上游审阅策略的前提下,把「用哪个模型审阅」和「主路由挂了怎么办」拆成可配置的有序链,并在错误类型上坚持 fail-closed,避免用 fallback 推翻已完成的审阅结论。若你要在 Harness 里压低审阅延迟或应对供应商瞬断,可按 README 安装并在 Settings → Auto review 中配置链路与超时。