DeepSeek Harness 保存报 BAD_INDENT:profile 存不回去排查
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 只出现在「保存」这一步,说明问题在编辑器的解析,而不是运行时的加载。 判据拆成三点:
- 看失败发生的时机。 预期:启动正常、会话可用、模型也能调用,只在设置页点保存时失败。若启动阶段就崩,方向应转到 profile 清单 BOM。
- 看是否与 provider 凭据有关。 报告者明确说明,最小复现不含任何 provider 凭据,也不发出 GLM / OpenAI / Anthropic 请求。也就是说失败在本地配置编辑环节,不是 API 调用失败。
- 看错误码是不是缩进类。 预期:
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):
- 准备一段从零构造的 YAML,不要用真实 profile 片段。
- id: example
config: {
models: [
{ id: model-a }
]
}
- 用 js-yaml 读一遍。
import yaml from 'js-yaml'
console.log(Array.isArray(yaml.load(source))) // true
预期:true。运行时那条路径认为这段文本合法。
- 用 yaml 的文档解析读一遍。
import { parseDocument } from 'yaml'
console.log(parseDocument(source).errors[0]?.code) // BAD_INDENT
预期:BAD_INDENT。保存那条路径认为它不合法。
- 确认差异点就在闭合符。 把闭合的
]缩进到与 flow 集合要求一致,预期:parseDocument的 errors 为空。这一步证明问题不是「整份配置烂了」,而是一个闭合符的缩进。
机制:嵌套 flow 集合的闭合符缩进
一句话结论:flow 集合嵌在块集合里时,闭合符的缩进是有要求的;两套解析器对「欠一点」的容忍度不同,于是同一份文件一边过、一边不过。 拆开看:
{与[开启 flow 上下文。 本例config:的值是 flow 映射,里面又有 flow 序列,序列里再嵌一个 flow 映射。- 闭合
]需要足够缩进。 规范要求 flow 集合在块集合里「sufficiently indented」,闭合符太靠左时,yaml 包判定为非法。 - js-yaml 选择容忍。 运行时用它加载,所以 profile 能正常读出、应用能正常启动。
- ConfigEditor 用文档模型,必须严格。 它要保留注释与格式,因此走
parseDocument(),遇到非法节点直接报错,保存中止。 - 于是出现「可读不可写」。 这不是数据损坏,而是两个组件对同一份文本的合法性定义不一致。
报告者把这归为兼容性问题,并给出两个方向的修法:让编辑器与运行时共用同一套接受语法,或加一条窄范围的、经过语义校验的兼容修复路径。
修法一:只对齐闭合符,不要重写整段
一句话结论:最小改动是把报错那一行的闭合 ] 缩进补足;不要为了消错而重写整个 provider 配置,否则容易丢字段与注释。 步骤:
- 先备份 profile 文件,复制到工作区外。
- 在设置页保存一次,记下报错。 预期:
BAD_INDENT,并给出位置信息(行号或上下文)。注意错误信息不应包含配置源码片段,如果它带了,属于另一个体验问题。 - 定位闭合符所在行。 只改这一行的前导空格,让
]与所在 flow 集合的缩进要求一致。 - 用
yaml.parseDocument()复核。 预期:errors为空。 - 回到设置页重新保存。 预期:保存成功、配置文件出现预期的新键。
为什么强调「只改一行」:据该用户报告,让用户重写整段 provider 配置有丢失无关字段与注释的风险。收敛改动面,是这类问题的第一原则。
修法二:本地补丁要满足的四条边界
一句话结论:如果要给编辑器加兼容路径,必须限定在「只修 delimiter-only 行、修完语义等价、保留原有节点、原子替换」四条边界内。 报告者给出的本地实现是:
- 只修被报
BAD_INDENT的纯分隔符行。 并且要先确认 lexer 看到的是真正的 flow 闭合 token;引号字符串与块标量里的括号不算分隔符。 - 修复次数要有上限,且要求修复前后运行时解析器产出的值完全相同。 其它畸形输入在写盘前一律拒绝。
- 复用未改动的 YAML 节点。 这样注释、引号风格、表达式与已有字段都能保留;普通块序列编辑时,无关行保持逐字节不变。
- 完整校验候选内容后再原子替换。 应用失败就恢复之前的字节;错误里报告语法位置,但不带配置源码片段。
这四条的价值在于:兼容路径不能变成「悄悄改写用户配置」。任何一处不满足,都可能把「保存失败」变成「保存成功但配置被改坏」,后者更难发现。
验证到什么程度:本地证据,不等于官方已修复
一句话结论:报告者完成了 42 个测试与隔离装机验证,但没有上游发布记录,也不能推断官方版本已包含修复。 证据清单:
- 测试规模:4 个配置测试文件、42 个测试通过,覆盖 Loader 真实保存/重启、JSON 与 YAML、Unicode 与多模型条目、注释与无关行保留、写入失败保护。
- 构建门禁:完整构建与类型检查 10/10 门通过。
- 装机验证:在隔离的 Windows 安装里,用合成的 legacy flow 风格 profile,走正常设置表单创建自定义 provider、保存、重开、正常退出桌面端再重启,配置与 Unicode 模型条目、显式容量、注释都保留。
- 没有发请求:整个保存/重开过程,回环模型桩收到 0 个请求——证明验的是配置编辑路径,不是模型调用。
- 明确未覆盖的部分:不声称真实 GLM API 调用成功,也不声称该修复已进入上游发布。
所以正确的表述是:「据该用户报告,本地补丁可修;官方版本是否包含,需要看发布记录」,不能写成「官方已修复」。
与另外两类「设置写不进去」分开
一句话结论:BAD_INDENT 是解析器差异,settings/rejected 是回调约定,启动崩溃是文件编码,三者排查入口完全不同。 对照:
BAD_INDENT:只在保存时报,profile 能启动,同一份 YAML 在两个解析器下结论相反。settings/rejected: next is not a function:HTTP 200 但 RPCok:false,任意设置项都失败,与 YAML 内容无关。Unexpected token:启动阶段就崩,文件开头带EF BB BF,连界面都进不去。
先按错误出现的阶段分类,再深入具体机制,比一上来读配置文件有效得多。
排查注意事项
这类单方证据的问题,排查原则是「先复现解析器差异,再决定是否改文件」。 六条要点:
BAD_INDENT先怀疑解析器差异,不要先怀疑自己的缩进全错。- 用最小 YAML 做对照,不要拿真实 profile 反复试错。
- 只改闭合符那一行,整段重写会丢注释与无关字段。
- 改前备份、改后用文档解析器复核,两件事都不能省。
- 区分「本地验证」与「官方修复」,本篇没有第三方复核,也没有上游发布记录。
- 修复若要做成产品能力,必须保证语义等价,否则会把保存失败变成静默改配置。
常见问题
因为在 DeepSeek Harness 里加载与保存用了两套 YAML 解析器。据该用户报告,启动时用 js-yaml 配 profile schema 读取,配置编辑器 ConfigEditor 保存前用 yaml.parseDocument() 解析同一份文本。对嵌套 flow 集合中欠缩进的闭合符,前者接受、后者抛出 BAD_INDENT,于是出现「能启动但存不回去」。
在 DeepSeek Harness 里,把同一份 profile 片段分别交给两个解析器:js-yaml 的 load() 返回 true 表示能读出数组,yaml 的 parseDocument() 的 errors[0].code 返回 BAD_INDENT,两者结论相反就说明是解析器差异。这个最小复现不需要任何 provider 凭据,也不会发出模型请求。
在 DeepSeek Harness 里对最小例子有效:把闭合 ] 的缩进补齐到与 flow 集合要求一致,yaml.parseDocument() 就不再报 BAD_INDENT。但据该用户报告,让用户手工重写整段 provider 配置有丢失无关字段与注释的风险,所以更稳的做法是只调整闭合符所在那一行的缩进,并保留其余原始行。
截至该讨论,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
来源
- #11625 — [Bug] Runtime-valid profile cannot be saved in Settings: js-yaml / yaml flow-closing indentation mismatch· deepseek-ai(GitHub Discussions)