dsh-pi-ai-compat（pi-ai 兼容补丁）

状态：Compatibility Patch。仅在 DeepSeek Harness 0.1.0-rc.6 与 pi-ai 0.82.1 上测试过。

dsh-pi-ai-compat 暴露了 SDK 中已存在、但无法通过 DSH rc.6 适配器 schema 配置的若干 pi-ai 兼容性控制项，并向 Models 设置页面添加了模型级推理默认值。

问题

上游 dsh-llm-pi-ai 已经支持按模型声明推理强度（reasoning effort），composer 也已经暴露了强度选择器。rc.6 的 Harness schema 没有暴露全部 pi-ai 兼容性标志，Models 设置编辑器也无法编辑推理声明。对于拒绝 developer 角色、或要求按 DeepSeek 风格回放推理内容的 OpenAI 兼容网关而言，这一点很重要。

行为

• 为 reasoningEfforts 与 defaultReasoningEffort 添加 Models 页面编辑器。
• 暴露 compat.supportsDeveloperRole，使网关可以为推理模型使用 system 而不是 developer。
• 暴露 compat.requiresReasoningContentOnAssistantMessages，供要求回传推理内容的网关使用。
• 在模型切换时保留兼容的思考块（thinking blocks）。
• 将 OpenAI Responses 的思考回放签名规范化为预期的 reasoning_content 线上字段。

非目标

本包不替换 pi-ai 适配器，不添加自适应逐轮强度控制器，不提供新的模型提供方，也不声称每个 OpenAI 兼容网关都使用相同的推理协议。它不重复上游已有的 composer 强度选择器。

机制

启动时，带版本守卫（version guard）的兼容补丁（compatibility patch）作用于以下目标：

• @deepseek-ai/dsh-llm-pi-ai@0.1.0-rc.6
• @deepseek-ai/dsh-client-ui-settings-models@0.1.0-rc.6
• @earendil-works/pi-ai@0.82.1

每个目标补丁块（hunk）都是幂等的，并有显式的逆向操作。版本策略默认是自适应（adaptive）的：当已安装副本的版本与受测版本不同，但每个锚点仍然唯一匹配时，仍会打补丁（记录为 adaptive 匹配）；锚点漂移时则以原因跳过。编程选项 strict 可恢复旧的"仅精确版本"应用行为。单个漂移副本永远不会阻塞其他目标，补丁应用在模块加载期间也绝不会抛错，因此上游升级不会破坏插件启动。在所有模式下，还原（restore）都保持严格的版本守卫。

兼容性

已在 DeepSeek Harness 0.1.0-rc.6、pi-ai 0.82.1、Node.js ^22.19.0 || >=24 与 pnpm >=10 上测试。上游升级后，请运行一次 dsh-pi-ai-compat-restore 与 verify:anchors，确认每个补丁块要么已应用、要么被有意跳过。

安装

dsh plugin --profile web add "github:xiaohj233/dsh-compat-shims#pi-ai-compat-v0.1.0&path:/packages/pi-ai-compat"

在 Windows 上，当 dsh plugin 把命令转发给 pnpm 时，cmd.exe 会拆分子目录片段中的 &；请直接使用 pnpm，并让下一次 dsh plugin 调用调和 bundle 层：

pnpm --dir %USERPROFILE%\.dsh\profiles\web add "github:xiaohj233/dsh-compat-shims#pi-ai-compat-v0.1.0&path:/packages/pi-ai-compat"
dsh plugin --profile web update