ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 设置改了立刻回弹:settings/rejected 排查

故障排查发布于 2026-11-03作者: DeepSeek Plugin 插件市场
DeepSeek Harnesssettings/rejectednext is not a functionCordis设置不落盘RPC 拒绝码
DeepSeek Harness 切换权限下拉或确认首启弹窗后立刻回弹,cordis.patch.yml 没有变化。真因在 HTTP 200 后的 RPC 层:settings/rejected 与 next is not a function。本文教你看拒绝码而不是状态码,并用依赖对照锁定 vendor 版本。

DeepSeek Harness(DSH)里有一类特别容易被误判成「界面卡了」的故障:你切换权限下拉、点首启弹窗的「继续」,界面短暂显示已生效,随后立刻回弹,profile 里的 cordis.patch.yml 一个字都没变,界面也不弹任何错误。 这类现象的真实原因不在前端渲染,而在写入链路的 RPC 层:/api/settings/mutate 返回 HTTP 200,但响应体里 ok: false,拒绝码 settings/rejected,message 是 next is not a function。HTTP 200 只说明请求被服务端接住了,能不能落盘要看 RPC 的 ok 与拒绝码(#11994)。

先看 RPC 拒绝码,不要停在 HTTP 200

一句话结论:设置写入失败的第一手证据是响应体里的 ok:false 与拒绝码,不是 HTTP 状态码,也不是界面上有没有红字。 据社区成员在 Windows、Node 24.13.1、全新隔离 DSH_HOME 条件下的独立复现,@deepseek-ai/dsh-base 与 @deepseek-ai/dsh-web-app 两个 bundle、patch 为 []、零第三方插件,症状依旧:预览说明点 Continue 后保持显示,提示确认状态无法保存。

取证步骤:

  1. 打开开发者工具的网络面板,把过滤条件设为 settings/mutate,然后做一次会触发写入的操作(例如把权限从「工作区内修改」切到「完全权限」)。

  2. 看这条请求的状态码。 预期:200。到这里不要停,200 只代表 HTTP 层通过。

  3. 展开响应体,找 RPC 结果字段。 预期:ok 为 false,并带一个拒绝码字段。复现中该值为 settings/rejected。

  4. 读同一个响应里的 message。 预期:next is not a function。这句 message 才是真正的定位线索;如果 message 是超时类文案,排查方向应转向请求链路而不是业务拒绝。

  5. 对照文件确认「确实没落盘」。 操作前后各备份一次 cordis.patch.yml 并对比内容,预期两次完全一致。这样就能把「界面回弹」和「写入失败」两件事钉死在一起。

判据总结:HTTP 200 + ok:false + settings/rejected + next is not a function = 服务端主动拒绝,与网络、权限、超时都无关。 看到别的拒绝码或别的 message,就不能套用本篇结论。

从 settings/rejected 到 next is not a function:回调约定变了

一句话结论:拒绝点是 Cordis 的更新回调签名改了,而旧消费者还在用三参数写法调 next(),第三个形参取不到 continuation。 社区对已发布 npm 产物的只读核对给出了两处关键事实:

  1. 新调用方传两个参数。 Cordis 4.0.6-alpha.2 调用 internal/update 时传的是 (resolved, restart)。

  2. 旧消费者仍按三个参数注册。 dsh-app-boot@0.2.2-alpha.2 的 lib/index.js 仍注册 (_config, _noSave, next) 并调用 next()(全局 prepend 钩子约 4586 行;该产物内嵌的配置 include 实现约 218 行也保留三参数写法)。

  3. 两套写法对接时第三位永远是空的。 调用 next() 时函数不存在,于是抛 next is not a function,被设置写入链路包成 settings/rejected。

  4. 独立发布的 loader/include alpha.2 已改成两参数。 这说明上游已经完成了迁移,但 app-boot 这两处旧消费者没有一起改到位。

顺序读下来就能理解为什么「版本号看起来一样却表现不同」:真正决定行为的是每个消费者与 Cordis 之间那一次调用的签名,而不是 DSH 的版本字符串。排查时要同时核对「实际解析到的 vendor 版本」与「app-boot 的调用约定」,两者缺一不可(#11994)。

用依赖组合 A/B 对照锁定真正生效的 vendor 版本

关键判据是:保持 DSH 与 app-boot 版本不变,只换 Cordis 与 loader/include,写入行为就翻转。 讨论里给出的对照矩阵已经很干净,照着复现即可:

DSH / dsh-app-bootCordisloader / include无插件确认写入
0.2.2-alpha.24.0.6-alpha.11.0.7-alpha.1 / 1.0.11-alpha.1ok: true,正常完成
0.2.2-alpha.24.0.6-alpha.21.0.7-alpha.2 / 1.0.11-alpha.2settings/rejected: next is not a function

操作步骤:

  1. 先确认当前 profile 实际装了什么。 不要凭 DSH 版本号推断,直接进 profile 目录查看依赖树里 Cordis 与 loader/include 的真实版本。

  2. 记录一次失败基线的完整证据。 包括 HTTP 状态、ok、拒绝码、message、操作前后 cordis.patch.yml 的哈希,作为对照的起点。

  3. 把 vendor 换回 4.0.6-alpha.1 与 1.0.7-alpha.1 / 1.0.11-alpha.1 这一组。 预期:同样操作下 RPC 返回 ok: true,cordis.patch.yml 出现预期的键值变化。

  4. 再换回 alpha.2 组合复现一次。 预期:next is not a function 重新出现。来回各一次,因果关系就成立。

  5. 把这组对照记进排查记录。 后续升级时用同一方法复验,不要因为「DSH 版本没变」就跳过。

对照实验全程不改 DSH 源码与产物、不手写确认状态、不发模型请求,这也是判断结论是否可靠的一条标准:能用一个变量解释的差异,就不要用三个变量去猜。

三种「改了不落盘」要分开处理

一句话结论:设置「改不动」至少有三种不同机制,混淆会把排查带到完全错误的方向。 三者给的特征不同,按特征分流:

  1. settings/rejected + next is not a function:本篇讲的 vendor 回调约定问题,特征是 RPC 拒绝码明确、HTTP 200、任意设置项都失败。

  2. 能启动但保存报 BAD_INDENT:这是加载器与编辑器用了两套 YAML 解析器、对 flow 缩进判定不同导致的,特征是只有特定 profile 保存失败、加载却正常。处置见 DeepSeek Harness 设置保存报 BAD_INDENT。

  3. profile 清单本身不可解析:这是文件层的坏数据,特征是启动阶段就报 Unexpected token,连界面都进不去。处理方式见 DeepSeek Harness profile 清单 BOM 导致的启动失败。

分流顺序建议固定:先看 RPC 有没有拒绝码,再看操作前后文件有没有变化,最后才去怀疑 YAML 与文件编码。

临时处置与修复状态

一句话结论:这处不匹配属于上游要统一的部分,用户侧能做的是回到能工作的 vendor 组合,或直接改文件再重启。 具体:

  1. 回到能工作的 vendor 组合。 即上面表格第一行,Cordis 4.0.6-alpha.1 与 loader/include alpha.1。验证标准是同一操作下 ok: true 且文件内容真的变了。

  2. 直接编辑 profile 文件再重启。 适合一次性改几项的场景:先把 cordis.patch.yml 备份,改完重启,预期设置生效。缺点是无法通过设置页做交互式验证。

  3. 不要反复重试界面上的保存按钮。 在拒绝码不变的前提下,重试只会重复同一条失败路径,不会带来新信息。

  4. 不要删掉整个 profile 重建。 这会把可用的配置一起丢掉,而问题并不在配置内容上。

  5. 修复状态如实记录:截至该讨论,这处调用约定不匹配未修复;0.2.2-alpha.3 又因 pin 了未发布的叶子包而无法安装,无法用来验证修复。细节见 DeepSeek Harness alpha 渠道安装报 ETARGET。

排查注意事项

设置写入类故障的核心原则是:先证明「请求被拒」,再证明「文件没变」,最后才讨论「为什么被拒」。 六条要点:

  1. HTTP 状态码不是结论:200 只代表请求送达,业务结果看 RPC 的 ok 与拒绝码。
  2. message 是第二把钥匙:settings/rejected 只说明类别,next is not a function 才指向具体机制。
  3. 文件对比是硬证据:操作前后各存一份 cordis.patch.yml,哈希一致就说明没落盘。
  4. 别用版本号代替依赖核对:实际解析到的 Cordis 与 loader/include 版本才是决定行为的那一方。
  5. 一次只改一个变量:vendor 组合、Node 版本、插件集合不要同时动,否则对照失效。
  6. 预设故障不要混进来:同一版本里四个 Agent 预设同时「加载失败」是另一条独立机制,见 DeepSeek Harness Agent 预设全部加载失败。

来源:Discussion #11994。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DeepSeek Harness 设置显示已生效却立刻回弹,cordis.patch.yml 没变,是被拒绝了吗?

DeepSeek Harness 的这类回弹要看 RPC 层的返回,不能只看 HTTP 状态码。设置写入走 /api/settings/mutate,这条请求可能返回 HTTP 200,但响应体里 RPC 的 ok 是 false,并带拒绝码 settings/rejected。看到这个组合就说明请求到达了服务端、被业务逻辑主动拒绝,而不是网络或超时问题。

DeepSeek Harness 设置保存报 settings/rejected 是什么意思?

这表示 DeepSeek Harness 设置热重载的回调约定对不上。Cordis 4.0.6-alpha.2 的 internal/update 已经改成两参数 (resolved, restart),而 dsh-app-boot@0.2.2-alpha.2 仍按三参数 (_config, _noSave, next) 注册并调用 next(),第三个形参取不到 continuation,调用时自然报 next is not a function。

为什么只比较 DeepSeek Harness 版本号、或者清 npm 缓存,查不出设置写入失败的原因?

因为 DeepSeek Harness 这条故障取决于实际解析到的 vendor 依赖组合,而不是 DSH 自己的版本号。同一份 DSH 与 app-boot,配 Cordis 4.0.6-alpha.1 加 loader/include alpha.1 时写入正常;换成 4.0.6-alpha.2 加 loader/include alpha.2 就报 next is not a function。必须核对真正装进 profile 的 Cordis 与 loader/include 版本。

DeepSeek Harness 的设置写入被 settings/rejected 拒绝,有没有不改源码的临时办法?

在 DeepSeek Harness 这边,讨论里的做法是把 vendor 组合退回到能工作的一组,即 Cordis 4.0.6-alpha.1 与 loader/include alpha.1,此时同一 DSH 版本的写入可以正常完成。另一条思路是直接改 profile 文件再重启,但要先把文件备份。截至该讨论,这处调用约定不匹配尚未修复,属于需要上游统一的部分。

相关术语

settings/rejected
settings/rejected 是 DeepSeek Harness 设置写入接口返回的 RPC 拒绝码,表示请求已被服务端接收并进入业务逻辑,但因某个前置条件不满足而被主动拒绝。它与网络失败、请求超时不同,需要看同一响应体里的 message 才能定位具体原因。— https://github.com/deepseek-ai/deepseek-harness/discussions/11994
Cordis internal/update
Cordis internal/update 是插件运行时里负责把新配置解析并应用到已加载插件上的内部更新入口,其回调签名决定了调用方如何拿到继续执行的 continuation。4.0.6-alpha.2 把它改成 (resolved, restart) 两参数,是本次设置写入失败的直接原因。— https://github.com/deepseek-ai/deepseek-harness/discussions/11994
cordis.patch.yml
cordis.patch.yml 是 DeepSeek Harness profile 里记录配置补丁的文件,设置页的修改最终应写入这里。设置「看起来生效又回弹」时,判断是否真的落盘,最直接的办法就是看这个文件在操作前后的内容有没有变化。— https://github.com/deepseek-ai/deepseek-harness/discussions/11994

来源