ChatGPTClaudeGrok / X / CursorGemini

DeepSeek Harness 保存报 BAD_INDENT:profile 存不回去排查

故障排查发布于 2026-11-03作者: DeepSeek Plugin 插件市场
DeepSeek HarnessBAD_INDENTjs-yamlyaml.parseDocumentprofile 保存失败flow 缩进
同一份 DeepSeek Harness profile 能启动但保存报 BAD_INDENT,配置存不回去。加载用 js-yaml、编辑器用 yaml.parseDocument(),两者对欠缩进的 flow 闭合符判定不同。本文给解析器对照判据、手工修法与补丁边界。

DeepSeek Harness(DSH)里有一个反直觉的组合:同一份 profile 运行时能正常加载,但在设置页保存就报 BAD_INDENT、配置怎么也存不回去。 这不是你的 YAML 整体写坏了,而是加载与编辑走了两套解析器。据该用户报告,profile 加载用 js-yaml 配 profile schema,packages/boot/config-editor/src/index.ts 在保存前用 yaml.parseDocument() 解析同一份文本;对嵌套 flow 集合里欠缩进的闭合符,前者接受、后者拒绝,报 Flow sequence in block collection must be sufficiently indented and end with a ]。本篇的全部技术细节均来自该用户单方报告与本人补充验证,没有第三方复核,阅读时请按此口径理解(#11625)。

判据:能启动 ≠ 能保存,两套解析器各管一半

一句话结论:BAD_INDENT 只出现在「保存」这一步,说明问题在编辑器的解析,而不是运行时的加载。 判据拆成三点:

  1. 看失败发生的时机。 预期:启动正常、会话可用、模型也能调用,只在设置页点保存时失败。若启动阶段就崩,方向应转到 profile 清单 BOM。
  2. 看是否与 provider 凭据有关。 报告者明确说明,最小复现不含任何 provider 凭据,也不发出 GLM / OpenAI / Anthropic 请求。也就是说失败在本地配置编辑环节,不是 API 调用失败。
  3. 看错误码是不是缩进类。 预期:BAD_INDENT。若看到的是 settings/rejected 或 next is not a function,那是另一条机制,见 设置改了立刻回弹。 三条对上,就可以停止在凭据、网络、模型上找原因。

最小复现:把同一份 YAML 交给两个解析器

关键判据是:js-yaml 的 load() 能读出数组,而 yaml 的 parseDocument() 返回 BAD_INDENT。 步骤(报告者环境:dsh-v0.2.2-alpha.2、js-yaml 4.3.2、yaml 2.9.0):

  1. 准备一段从零构造的 YAML,不要用真实 profile 片段。
yaml
- id: example
  config: {
    models: [
    { id: model-a }
    ]
  }
  1. 用 js-yaml 读一遍。
js
import yaml from 'js-yaml'
console.log(Array.isArray(yaml.load(source)))   // true

预期:true。运行时那条路径认为这段文本合法。

  1. 用 yaml 的文档解析读一遍。
js
import { parseDocument } from 'yaml'
console.log(parseDocument(source).errors[0]?.code)   // BAD_INDENT

预期:BAD_INDENT。保存那条路径认为它不合法。

  1. 确认差异点就在闭合符。 把闭合的 ] 缩进到与 flow 集合要求一致,预期:parseDocument 的 errors 为空。这一步证明问题不是「整份配置烂了」,而是一个闭合符的缩进。

机制:嵌套 flow 集合的闭合符缩进

一句话结论:flow 集合嵌在块集合里时,闭合符的缩进是有要求的;两套解析器对「欠一点」的容忍度不同,于是同一份文件一边过、一边不过。 拆开看:

  1. { 与 [ 开启 flow 上下文。 本例 config: 的值是 flow 映射,里面又有 flow 序列,序列里再嵌一个 flow 映射。
  2. 闭合 ] 需要足够缩进。 规范要求 flow 集合在块集合里「sufficiently indented」,闭合符太靠左时,yaml 包判定为非法。
  3. js-yaml 选择容忍。 运行时用它加载,所以 profile 能正常读出、应用能正常启动。
  4. ConfigEditor 用文档模型,必须严格。 它要保留注释与格式,因此走 parseDocument(),遇到非法节点直接报错,保存中止。
  5. 于是出现「可读不可写」。 这不是数据损坏,而是两个组件对同一份文本的合法性定义不一致。

报告者把这归为兼容性问题,并给出两个方向的修法:让编辑器与运行时共用同一套接受语法,或加一条窄范围的、经过语义校验的兼容修复路径。

修法一:只对齐闭合符,不要重写整段

一句话结论:最小改动是把报错那一行的闭合 ] 缩进补足;不要为了消错而重写整个 provider 配置,否则容易丢字段与注释。 步骤:

  1. 先备份 profile 文件,复制到工作区外。
  2. 在设置页保存一次,记下报错。 预期:BAD_INDENT,并给出位置信息(行号或上下文)。注意错误信息不应包含配置源码片段,如果它带了,属于另一个体验问题。
  3. 定位闭合符所在行。 只改这一行的前导空格,让 ] 与所在 flow 集合的缩进要求一致。
  4. 用 yaml.parseDocument() 复核。 预期:errors 为空。
  5. 回到设置页重新保存。 预期:保存成功、配置文件出现预期的新键。

为什么强调「只改一行」:据该用户报告,让用户重写整段 provider 配置有丢失无关字段与注释的风险。收敛改动面,是这类问题的第一原则。

修法二:本地补丁要满足的四条边界

一句话结论:如果要给编辑器加兼容路径,必须限定在「只修 delimiter-only 行、修完语义等价、保留原有节点、原子替换」四条边界内。 报告者给出的本地实现是:

  1. 只修被报 BAD_INDENT 的纯分隔符行。 并且要先确认 lexer 看到的是真正的 flow 闭合 token;引号字符串与块标量里的括号不算分隔符。
  2. 修复次数要有上限,且要求修复前后运行时解析器产出的值完全相同。 其它畸形输入在写盘前一律拒绝。
  3. 复用未改动的 YAML 节点。 这样注释、引号风格、表达式与已有字段都能保留;普通块序列编辑时,无关行保持逐字节不变。
  4. 完整校验候选内容后再原子替换。 应用失败就恢复之前的字节;错误里报告语法位置,但不带配置源码片段。

这四条的价值在于:兼容路径不能变成「悄悄改写用户配置」。任何一处不满足,都可能把「保存失败」变成「保存成功但配置被改坏」,后者更难发现。

验证到什么程度:本地证据,不等于官方已修复

一句话结论:报告者完成了 42 个测试与隔离装机验证,但没有上游发布记录,也不能推断官方版本已包含修复。 证据清单:

  1. 测试规模:4 个配置测试文件、42 个测试通过,覆盖 Loader 真实保存/重启、JSON 与 YAML、Unicode 与多模型条目、注释与无关行保留、写入失败保护。
  2. 构建门禁:完整构建与类型检查 10/10 门通过。
  3. 装机验证:在隔离的 Windows 安装里,用合成的 legacy flow 风格 profile,走正常设置表单创建自定义 provider、保存、重开、正常退出桌面端再重启,配置与 Unicode 模型条目、显式容量、注释都保留。
  4. 没有发请求:整个保存/重开过程,回环模型桩收到 0 个请求——证明验的是配置编辑路径,不是模型调用。
  5. 明确未覆盖的部分:不声称真实 GLM API 调用成功,也不声称该修复已进入上游发布。

所以正确的表述是:「据该用户报告,本地补丁可修;官方版本是否包含,需要看发布记录」,不能写成「官方已修复」。

与另外两类「设置写不进去」分开

一句话结论:BAD_INDENT 是解析器差异,settings/rejected 是回调约定,启动崩溃是文件编码,三者排查入口完全不同。 对照:

  1. BAD_INDENT:只在保存时报,profile 能启动,同一份 YAML 在两个解析器下结论相反。
  2. settings/rejected: next is not a function:HTTP 200 但 RPC ok:false,任意设置项都失败,与 YAML 内容无关。
  3. Unexpected token:启动阶段就崩,文件开头带 EF BB BF,连界面都进不去。

先按错误出现的阶段分类,再深入具体机制,比一上来读配置文件有效得多。

排查注意事项

这类单方证据的问题,排查原则是「先复现解析器差异,再决定是否改文件」。 六条要点:

  1. BAD_INDENT 先怀疑解析器差异,不要先怀疑自己的缩进全错。
  2. 用最小 YAML 做对照,不要拿真实 profile 反复试错。
  3. 只改闭合符那一行,整段重写会丢注释与无关字段。
  4. 改前备份、改后用文档解析器复核,两件事都不能省。
  5. 区分「本地验证」与「官方修复」,本篇没有第三方复核,也没有上游发布记录。
  6. 修复若要做成产品能力,必须保证语义等价,否则会把保存失败变成静默改配置。

来源:Discussion #11625。

ChatGPTClaudeGrok / X / CursorGemini

常见问题

DeepSeek Harness 的 profile 能启动,为什么加 provider 保存报 BAD_INDENT?

因为在 DeepSeek Harness 里加载与保存用了两套 YAML 解析器。据该用户报告,启动时用 js-yaml 配 profile schema 读取,配置编辑器 ConfigEditor 保存前用 yaml.parseDocument() 解析同一份文本。对嵌套 flow 集合中欠缩进的闭合符,前者接受、后者抛出 BAD_INDENT,于是出现「能启动但存不回去」。

怎么快速确认 DeepSeek Harness 的 BAD_INDENT 是解析器差异而不是我的 YAML 写错了?

在 DeepSeek Harness 里,把同一份 profile 片段分别交给两个解析器:js-yaml 的 load() 返回 true 表示能读出数组,yaml 的 parseDocument() 的 errors[0].code 返回 BAD_INDENT,两者结论相反就说明是解析器差异。这个最小复现不需要任何 provider 凭据,也不会发出模型请求。

DeepSeek Harness 报 BAD_INDENT 时,直接把闭合的 ] 缩进对齐就行吗?

在 DeepSeek Harness 里对最小例子有效:把闭合 ] 的缩进补齐到与 flow 集合要求一致,yaml.parseDocument() 就不再报 BAD_INDENT。但据该用户报告,让用户手工重写整段 provider 配置有丢失无关字段与注释的风险,所以更稳的做法是只调整闭合符所在那一行的缩进,并保留其余原始行。

这个 BAD_INDENT 问题在 DeepSeek Harness 里已经修复了吗?

截至该讨论,DeepSeek Harness 没有上游发布记录。报告者提供的是本地补丁与本地验证结果:4 个配置文件、42 个测试通过,构建与类型检查 10/10 门通过,并在隔离的 Windows 装机上验证了保存、重开、重启后配置保留。这些是本地结果,不代表官方版本已包含该修复。

相关术语

BAD_INDENT
BAD_INDENT 是 yaml 包在缩进不合法时给出的错误码,完整提示通常是 Flow sequence in block collection must be sufficiently indented and end with a ]。它表示解析器认为 flow 集合的闭合符缩进不足,而不是说整个文件缩进全错。— https://github.com/deepseek-ai/deepseek-harness/discussions/11625
flow 集合
flow 集合是 YAML 里用 [ ] 表示序列、用 { } 表示映射的行内写法,可以和块结构嵌套。当 flow 集合嵌套在块集合里时,闭合符需要足够的缩进,不同解析器对这一点的严格程度可能不同。— https://github.com/deepseek-ai/deepseek-harness/discussions/11625
yaml.parseDocument
yaml.parseDocument 是 yaml 包提供的文档级解析入口,返回 AST 与 errors 数组,便于在保留注释与格式的前提下做编辑。DeepSeek Harness 的 ConfigEditor 在保存前用它解析同一份 profile,与运行时使用的 js-yaml 不是同一套实现。— https://github.com/deepseek-ai/deepseek-harness/discussions/11625

来源