推理等级配置 mengchiren/dsh-thirdparty-reasoning-level

DSH 第三方模型推理等级配置（火山方舟 Coding Plan）

为 DSH（DeepSeek Harness）的第三方自定义厂商配置模型推理等级的完整方案：配置模板、使用说明、以及 pi-ai 方舟兼容补丁。

背景

DSH 原生支持第三方模型推理等级，链路为：settings.yaml 声明 → 模型选择器 UI 下拉 → 按等级映射线上参数。缺的只是厂商配置里的能力声明：

- 每个模型须声明 reasoningEfforts（等级 → 线上参数值），未声明 = 不支持推理等级；
- 推理方言 compat.thinkingFormat（deepseek / qwen / openai 等）仅对 openai-completions 协议生效；
- 方舟 coding 端点须走 OpenAI 兼容面 https://ark.cn-beijing.volces.com/api/coding/v3。

文件清单

| 文件 | 说明 |
| fangzhou-coding-plan-provider.yaml | 可复用厂商配置模板（deepseek / glm / kimi 配方，含注释） |
| 使用说明.md | 完整文档：原理、验证步骤、坑位清单、迁移指南 |
| reapply-pi-ai-ark-patch.ps1 | pi-ai 方舟兼容补丁重打脚本（DSH 升级后一键重打，幂等） |
| LICENSE | MIT 许可证 |

第三方说明：本项目的补丁作用于 @earendil-works/pi-ai （MIT License）的 openai-completions 探测逻辑；补丁前的原始文件仅留作本机工作区备份，不入库。所有档位/参数结论均来自对公网端点的直接实测（2026-08-20），接入前请自行验证。

快速开始

1. 把 fangzhou-coding-plan-provider.yaml 的 fangzhou: 段粘贴进 %USERPROFILE%\.dsh\settings.yaml 的 llm-pi-ai.providers: 下（保存即热生效）；中转站厂商注意：baseURL 必须带路径前缀（如 https://xxx.com/v1）， pi-ai 会拼接 /chat/completions，缺前缀会打到网页首页导致流解析失败（报 Stream ended without finish_reason 并无限重试）；
2. 确保环境变量 FANGZHOU_API_KEY（及中转站各自的 *_API_KEY）存在；
3. 若 DSH 更新过 node_modules，运行 reapply-pi-ai-ark-patch.ps1 重打补丁并重启 DSH；
4. 打开模型选择器：deepseek 模型可选 Low/High/Max，glm-5.3 可选 Off/Low/Medium/High/Max。

推理等级速查（方舟 Coding Plan，实测/官方文档）

| 模型 | 档位 | 线上参数 |
| deepseek-v4-flash / pro | Low / High / Max | thinking:{type:"enabled"} + reasoning_effort |
| glm-5.3 | Off(low) / Low / Medium / High / Max | reasoning_effort（思考不可关闭，low≈off） |
| kimi-k2.7-code | High | enable_thinking（thinkingFormat: qwen） |
| gpt-5.x（中转站透传） | Off(minimal) / Low / Medium / High | reasoning_effort（无 max；Off 实际为 minimal） |

详见 使用说明.md（含 7 个坑位、设置页写回、GBK 乱码、agent-default-model、中转站配方与 pi-ai 严格网关补丁等注意事项）。