qmy777/cordis-host-runner-inspect-upsert

cordis-host-runner-inspect-upsert —— 修复「切换模式后自动弹回默认」的兼容补丁

这个补丁修什么问题？

一句话：在 DeepSeek Harness 里，切换到某些自定义模式（如「禅道日常处理模式」）后，
界面会立刻自动弹回默认模式，看起来就像切换失败。

同一个冲突有时还会表现为：

- 项目里无法创建新对话（新建会话失败或没有反应）；
- 无法切换已有对话中的模型（对已有会话做模型操作时报错）；
- 会话恢复失败（resume failed）。

这些现象本质都是同一个原因：模式（预设）挂载失败后，相关会话的创建/恢复/操作
都跟着失败。

切换到自定义模式时，界面/接口会报出下面这类错误（只看后半段即可，其余是背景信息）：

preset "zentao-oa" failed to mount:
failed to apply loader entry tool-cordis (@deepseek-ai/dsh-tool-cordis):
Host Cordis inspect provider "Service" is already registered

其中最关键的一句是：

Host Cordis inspect provider "Service" is already registered

意思是：「Service」这个名字已经被登记过了，系统拒绝重复登记。

什么时候会遇到？

- 你的自定义模式（模式 = 一套完整的助手配置，Harness 里叫「预设 / preset」）
包含「连接 Cordis 生态」的能力（内部是 tool-cordis 插件）；
- 而系统本身启动时也注册了同样的一套能力。

两者使用的名字相同（如 Service、Event），系统内置的逻辑不允许重名，
于是一旦轮到你的模式去注册，就报错中止，模式挂载失败 → 界面弹回默认模式。

默认模式（系统自带的模式）恰好也包含同样能力，但它先启动、先注册，
所以默认模式没问题，只有后注册的自定义模式会被拒绝。

为什么会有两个一样的名字同时存在？

Harness 里同时存在多套「运行环境」（系统一套、每个自定义模式各一套），
但它们共用一个公用的「登记本」。每套环境启动时都会往这本子上登记自己的能力，
而它们登记的却是同一个名字 —— 按内置逻辑，重名 = 报错。

打个比方：一座大楼里有多套物业团队（系统团队 + 各模式团队），
但只有一栋楼的电话号码本。每支团队都想把「总机」这个号码登记成自己的分机。
旧规则是：谁先登记谁赢，后来的一律拒绝。

这个补丁做了什么？

把「后来的一律拒绝」改为「后来的顶替先来的」：

- 重复登记不再报错，后登记的内容直接覆盖旧内容，并正常继续；
- 先登记的那一方（系统）也不会因此出问题 —— 它的登记只是被「顶替」而非「误删」。

对应到上面电话本例子：任何团队登记「总机」都直接写进本子（覆盖旧记录），
不再因为重名而拦下整支团队。

改动范围极小：只调整一个注册函数（register()）的冲突处理策略，
不影响其它任何行为。

支持的 DeepSeek Harness 版本

自以下版本起记录（验证于该版本，向下兼容性未回溯验证）：

| 版本 | 提交 | 验证日期 | 说明 |
| :-- | :-- | :-- | :-- |
| 0.1.0-rc.7 | bb4ca698d6 | 2026-08-18 | 首个验证版本，实测切换「禅道日常处理模式」成功 |

对应源码目录：deepseek-harness 工作区（packages/extensions/cordis-host-runner）。

用 AI 安装（复制即用）

把下面整段文字发给你的 AI 编码助手（dsh、Claude Code、Codex 等），
它会读完本 README 并自动完成安装：

请帮我安装 cordis-host-runner-inspect-upsert 兼容补丁。
仓库位置：本仓库目录（README 所在目录）。
安装要求：
1. 读 scripts/install.mjs 与 scripts/verify.mjs 后，运行安装与自检；
2. 完成后告诉我需要重启哪个 profile 的 dsh（web / Desktop）。

提示：也可直接把本仓库的 README.md 丢给 AI 阅读，它在「安装」章节有全部细节。

安装（不改任何产品源码）

补丁以「备用副本」方式安装：把修复后的完整运行包复制到配置目录下，
Harness 加载时会优先使用这份副本，内置原包保持原封不动。

node scripts/install.mjs                 # 安装到全部 profile
node scripts/install.mjs --profile web   # 只安装到 web 这一个 profile
node scripts/verify.mjs                  # 自检安装是否成功

然后重启对应的 dsh（web / Desktop）即可生效。

profile 是什么：dsh 的不同启动形态（web、Desktop、cc-tui 等），各有独立配置目录。

验证是否修好

重启后，在界面上切换到之前失败的自定义模式，应能正常停留、不再弹回。

如何回退

rm -rf ~/.dsh/profiles//node_modules/@deepseek-ai/dsh-cordis-host-runner

删掉这份副本，重启 dsh，即恢复成 Harness 原始行为。

备注：源码直修方案（等价）

同样的改动也已直接改在 deepseek-harness 工作区的源码里
（packages/extensions/cordis-host-runner/src/inspect-registry.ts，未提交）。
用源码自行构建的话，直接用源码即可，不需要本补丁；本补丁是为「不想改源码」的部署准备的。