DeepSeek Harness 点新会话没反应:settings.section 槽位冲突
DeepSeek Harness(DSH)装完两个插件后,界面看起来一切正常,但点「新会话」毫无反应、会话建不出来,而且用户侧没有任何错误提示——这类故障最典型的根因是两个插件把设置页注册到了同一个 settings.section 槽位,并且用了同一个 id。 前端槽位不允许同 id 重复注册,后注册的一方会抛未捕获异常,整个 UI 初始化链路就此中断。真实报错只在崩溃日志里:Uncaught Error: list slot "settings.section" already has an entry with id "comfyui",以及 Error: dsh desktop host exited with 1073807364(#11863)。
症状链:为什么「界面能用」和「建不出会话」会同时出现
一句话结论:初始化在挂设置页那一步就断了,外框还在,但后续所有依赖初始化的动作都失效。 这条现象有几个固定特征,凑齐就可以定向:
- 界面框架正常显示:导航、面板都在,视觉上不像崩溃。
- 「新会话」点了没反应:不是报错弹窗,而是彻底无响应。
- 没有任何用户可见提示:设置页打不开也不告诉你原因,插件列表里也看不出异常。
- 两个插件单独装都正常,只有同时装才触发。
这四条的成因是同一个:注册槽位时抛出的异常没有被捕获,渲染进程的初始化流程整体中止。「界面还在」是假象,那是已渲染的框架,不是可用状态。 所以不要从「新会话按钮」这个功能点往下查,直接去日志里找未捕获异常。
第一步:翻 crash 日志拿到真实报错
关键判据是:崩溃日志里同时出现 1073807364 与 list slot ... already has an entry with id ...,看到后者才算定位到槽位冲突。 步骤:
- 打开崩溃日志目录。 Windows 桌面端路径为:
dir "$env:APPDATA\@deepseek-ai\dsh-desktop\logs\crash-*.log"
预期:列出若干 crash-<时间戳>-host.log。按修改时间取最近的一份。
2. 搜退出码。
Select-String -Path "$env:APPDATA\@deepseek-ai\dsh-desktop\logs\crash-*.log" -Pattern "1073807364"
预期:命中 Error: dsh desktop host exited with 1073807364。这一步只证明 host 异常退出,还不能确定原因。
3. 搜槽位报错原文。
Select-String -Path "$env:APPDATA\@deepseek-ai\dsh-desktop\logs\crash-*.log" -Pattern 'settings.section'
预期:命中 Uncaught Error: list slot "settings.section" already has an entry with id "comfyui" at priority 0 (registered by dsh-comfyui) — register at a different priority to shadow it (lowest renders)。
4. 读报错里的注册方信息。 这条 message 会直接写出「谁先注册」「哪个 id」「什么优先级」。本例是 dsh-comfyui 以优先级 0 注册了 comfyui,第二个同名注册撞上它。
5. 确认不是别的崩溃。 如果日志里根本没有 settings.section 这一行,就不要套用本篇结论,转去查渲染进程的其它未捕获异常。
第二步:用单装/双装对照确认是哪两个插件
一句话结论:冲突来自两个插件用了同一个裸 id,判断靠「单装正常、双装失败」的对照,而不是靠读插件功能。 步骤:
- 列出当前 profile 里的插件。
dsh plugin --profile desktop list
预期:能看到本例的 dsh-comfyui 与 dsh-short-video-studio,以及它们各自版本(0.5.5 与 1.14.1)。
-
只留一个插件,重启,点「新会话」。 预期:正常建会话。两个插件分别单独测一遍,都应该正常——这一步排除了「某个插件本身坏了」。
-
两个都装回,重启,再点「新会话」。 预期:复现无响应,日志里重新出现同一句
already has an entry with id "comfyui"。单装正常、双装失败,因果就锁死了。 -
核对两个插件的注册处。 打开插件的客户端产物看
id字段:
dsh-comfyui/client/client.js → id: 'comfyui'
dsh-short-video-studio/lib/client.js → id: 'comfyui'
预期:两个 id 完全相同。这就是冲突的直接证据:同一个槽位、同一个 id、两个注册方(#11863)。
第三步:改掉一个 id,先让界面恢复可用
一句话结论:把其中一个插件注册处的 id 改成带前缀的唯一值,重启即可让两个设置页都可用;这是用户侧已验证的临时规避。 步骤:
- 备份要改的插件文件。 目标是
dsh-short-video-studio/lib/client.js,复制一份到工作区外。 - 把
id: 'comfyui'改成唯一值。 讨论里用的是comfyui-svs,即把注册处写成id: 'comfyui-svs'。 - 重启 DSH,点「新会话」。 预期:能正常建会话,设置页能打开,两个插件的设置项都在。
- 复核日志。 预期:
crash-*.log里不再出现新的settings.section冲突记录。 - 把问题反馈给插件作者。 这个改动会在插件升级时被覆盖,属于临时手段;正确做法是作者把 id 改成带包名前缀的形式,例如
dsh-comfyui(#11863)。
为什么不是「改优先级」?报错文案里确实提到
register at a different priority to shadow it,但优先级语义是「低者渲染、同 id 覆盖」,用它来绕同 id 冲突属于钻语义空子,副作用是其中一个设置页被隐藏。改 id 才是干净的做法。
机制:槽位为什么不允许同 id 重复注册
一句话结论:槽位用 id 做唯一键,同 id 意味着「谁是那个条目」不可判定,所以实现选择直接抛错,而不是静默覆盖。 从报错文案能读出三层设计:
id是槽位内的唯一标识。 设置页、面板这类 UI 扩展点都按 id 索引,同 id 无法同时表达两个不同来源的条目。- 优先级决定渲染顺序与覆盖关系。 文案里的
at priority 0与lowest renders说明低优先级先渲染、可被更高优先级「影子化」。 - 冲突时抛错而非降级。 这是更严格的选择:宁可让初始化失败,也不让两个插件的设置页在界面上互相顶替,从而产生「设置项莫名消失」这种更难查的问题。
代价也很明显:失败点在界面初始化,不在某个具体插件的功能里,用户完全无法归因,必须翻 crash-*.log 才能看到真实报错。插件生态里「同主题插件」很常见(本例两个都做 ComfyUI),将来一定还有别的组合撞车。
该修的是哪里:跳过后来者、给出可见提示
一句话结论:正确的产品行为是重复 id 时跳过后来者并 console.warn,UI 继续可用,同时在启动或设置页给出「插件 A 与插件 B 槽位冲突」的可见提示。 讨论里提出的三条期望:
- 不中断渲染:重复 id 时跳过后来者,记录一条
console.warn,让界面保持可用。 - 可见提示:在设置页或启动时明确显示「哪个插件与哪个插件冲突」,而不是把线索埋进日志。
- 文档约束落地:插件开发文档已写明「slot id 必须带包名前缀,如
dsh-comfyui」,但文档约束没有在加载期被检查,于是裸 id 能一路注册到运行时才炸。
对用户来说,记住一句就够:「新会话无反应 + 界面正常 + 日志里 1073807364」= 先查槽位冲突,别先怀疑模型或权限。
排查这类问题时,能一眼看清「装了哪些插件、版本是多少、最近装了什么」会省掉大量来回。与其一个个翻 profile 目录和 crash 日志,不如用 DSH Plugin Hub 这类可视化插件市场:已安装列表、版本与更新状态集中在一处,判断「是不是刚装的那个插件引起的」会快很多。

排查注意事项
这类「界面假活」的问题,排查原则是:先找未捕获异常,再找功能 bug。 六条要点:
- 界面能显示不等于初始化完成,无响应往往比报错更早暴露问题。
- 崩溃日志是第一现场:
crash-*.log里的Uncaught Error才是根因,1073807364只是 host 退出的标记。 - 单装/双装对照是最省事的二分法:能快速把范围缩到「两个插件的交互」。
- 看插件产物里的
id字段,不要只看插件名;冲突发生在 id 上,不在功能上。 - 临时改 id 会被升级覆盖,要同步反馈给作者,别把它当成长期方案。
- 别用改优先级来绕同 id,那会让一个设置页被影子化,问题从「建不出会话」变成「设置项莫名消失」。
常见问题
在 DeepSeek Harness 里,先查桌面端崩溃日志,而不是在界面里找提示。典型路径是 %APPDATA%\@deepseek-ai\dsh-desktop\logs\crash-*.log,里会出现 Error: dsh desktop host exited with 1073807364,并伴随渲染进程的 Uncaught Error: list slot "settings.section" already has an entry with id "comfyui"。看到这条就能直接锁定槽位冲突。
这表示在 DeepSeek Harness 里两个插件把设置页注册到了同一个 settings.section 槽位,并且用了同一个 id。前端槽位不允许同 id 重复注册,注册时会抛未捕获异常,整个 UI 初始化链路中断,于是界面框架还在、但建会话的动作永远走不到。
因为在 DeepSeek Harness 里,冲突只在「同 id 的第二次注册」时发生。单独安装任一插件时,槽位里只有一个 comfyui 条目,注册合法;两个都装上时,后注册的一方撞到已有 id,抛错并中断初始化。判断方法是单装、双装各跑一次做对照,不要凭感觉怀疑某个插件功能有 bug。
在 DeepSeek Harness 里,用户侧能做的是临时规避:改掉其中一个插件注册处的 id,例如把 dsh-short-video-studio 的 id: 'comfyui' 改为 id: 'comfyui-svs',重启后两个设置页都可用。永久解法要插件作者各自把 id 命名空间化,按文档要求带上包名前缀,并向两个插件的作者反馈同一问题。
相关术语
- settings.section
- settings.section 是 DeepSeek Harness 前端定义的一个槽位(slot),用于让插件把自己的设置页挂进设置界面。每个注册项都需要一个 id 作为唯一标识,同 id 重复注册会抛错而不是覆盖。— https://github.com/deepseek-ai/deepseek-harness/discussions/11863
- 槽位 id 命名空间化
- 槽位 id 命名空间化是指插件注册槽位时用带包名前缀的 id(如 dsh-comfyui),避免不同插件撞同一个短名。DeepSeek Harness 的插件开发文档明确要求 slot id 必须带包名前缀,本例两个插件都用了裸 id comfyui,才产生冲突。— https://github.com/deepseek-ai/deepseek-harness/discussions/11863
- 1073807364
- 1073807364 是 DeepSeek Harness 桌面端 host 进程异常退出时记录在崩溃日志里的退出码,常见于渲染进程未捕获异常导致的连锁退出。它本身不是根因,只是「host 已经挂了」的标记,真正的错误要看同一份日志里的 Uncaught Error。— https://github.com/deepseek-ai/deepseek-harness/discussions/11863
来源
- #11863 — 插件槽位冲突导致渲染中断:settings.section 重名时 UI 整体初始化失败· deepseek-ai(GitHub Discussions)