博客发布工具：对象格式变了，输入规范该保留、改写还是退出
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /9d928e87338f.html
📄
博客发布工具：对象格式变了，输入规范该保留、改写还是退出
先给结论：不要整体推翻输入规范，而是把规范拆成“字段语义层”和“格式适配层”。字段语义层（标题、正文、标签、发布时间、作者）通常保留；格式适配层（分隔符、字段顺序、转义方式、批量提交方式）必须改写；只有当新对象格式无法稳定映射到原有字段语义，或必须引入破坏性转换时，才考虑退出这条输入路径，改用人工中转或另一套提交方式。
先判断变化发生在哪一层
对象格式变化有很多种，处理方式完全不同。判断依据不是“格式看起来变了多少”，而是它有没有改变字段的含义和边界。
- 只换分隔符、换行规则、字段顺序——属于格式适配层，改写即可。
- 字段名不变但取值范围变了，例如标签从自由文本变成受控词表——属于语义层变化，需要重新定义允许值。
- 新增必填字段，或原字段被拆分、合并——语义层变化，且可能影响下游流程。
- 对象从单条变成嵌套结构（例如正文里再套一层块级元素）——需要判断你的发布流程能否表达这种层级。
实际操作上，先拿三条真实对象做对照：一条最简单的、一条字段最全的、一条边界最怪的。把这三条按新格式解析一遍，看哪些字段能对上、哪些对不上。对不上的部分，才是需要决策的地方。
保留：字段语义没变，只调整格式适配层
如果对照结果是字段含义一致、只是书写方式变了，那么保留原有输入规范的主体，只改适配层。具体动作是把格式转换集中到一个地方，而不是散落在每个输入环节。
例如，假设原来的输入规范要求每条记录用竖线分隔字段，新对象改用键值对形式。此时不必重写所有录入规则，只需在提交前加一层转换：把内部统一结构渲染成新格式。这样做的结果是，上游编辑习惯不变，下游提交格式正确，出问题时也只需检查转换层这一处。
保留的前提是：转换是可逆的、无歧义的。如果某个字段在新格式下必须靠上下文推断才能还原，就不属于“只改格式”，应进入改写。
改写：字段边界变化，需要重新定义允许值
当新格式改变了字段的取值空间，改写比保留更省事。典型信号是：原来可以随便写的字段，现在有枚举限制；原来一个字段装的内容，现在被拆成两个；原来可选的字段，现在必填。
改写的动作顺序建议是：先冻结旧值到新值的映射表，再改输入规范，最后用历史对象回放验证。映射表要写清楚三类情况——能直接对应的、需要合并或拆分的、无法对应的。无法对应的部分不要硬塞默认值，否则后续排查会失去线索。
一个注明假设的短例子：假设旧格式里“分类”是一个自由文本字段，新格式要求从固定列表中选。你有 40 条历史记录，其中 32 条能直接对应，5 条需要归入“其他”，3 条在新列表里没有合适位置。此时合理的做法是保留这 3 条的原始文本，另存一个备注字段，而不是强行归类。这样做的结果是，新流程能跑通，同时保留了日后重新归类的依据。
退出：映射成本高于收益，或转换不可逆
退出不是失败，而是一种取舍。适用前提有两个：一是新格式与原有字段语义无法建立稳定映射，二是维持映射所需的人工核对量持续高于改用其他提交方式。
判断是否达到退出条件，可以看一个信号：每次提交前都需要人工逐条检查，且检查项在增加而不是减少。如果连续几次批量提交都出现同类错误，说明问题不在操作熟练度，而在规范本身不匹配。
退出的实际动作是切换到人工中转或另一条输入路径，同时保留原有内部结构不变。这样做的结果是，发布速度可能下降，但错误定位成本降低。下一步应观察一段时间内的返工次数，如果返工明显减少，说明退出决策成立；如果没有减少，问题可能出在内部结构本身，而不是对象格式。
改完之后必须做的一次验证
无论选择保留、改写还是退出，都要用同一批对象做一次前后对照：取 5 到 10 条覆盖不同字段组合的记录，按新规范走一遍完整流程，记录每一步的输入和输出。重点看两件事：字段是否丢失，以及错误信息能否指向具体字段。
如果错误信息只能告诉你“格式不对”而无法定位到字段，说明输入规范还停留在格式层，没有把字段语义表达清楚。这时应回到改写步骤，补上字段级校验，而不是继续调整分隔符或转义方式。验证通过后，再把新规范固化为模板，并注明适用条件，避免下次对象格式再变时重新讨论同一件事。
