写博客工具：工具支持的对象格式变化时怎样改输入规范
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /0d65f0979ccd.html
📄
写博客工具：工具支持的对象格式变化时怎样改输入规范
当写博客工具从接收纯文本改为接收结构化对象（例如带标题层级、图片说明、引用块的字段组合）时，你手上的旧输入规范通常不会自动兼容。最稳妥的做法是：先拿一篇真实草稿，对照工具当前实际接受的对象格式逐字段试填，把“不认的字段”和“被静默丢弃的字段”分开记录，再决定是改输入模板还是换工具。下面按这个顺序展开。
先确认变化发生在哪一层：载体格式还是字段结构
对象格式变化有两种，处理方式完全不同。第一种是载体变化，比如从 .txt 改为 .md 或 JSON，内容语义没变，只是换了个壳。第二种是字段结构变化，比如原来整篇是一个 content 字符串，现在拆成 title、blocks、captions 等独立字段，甚至要求每个块带类型标记。
判断方法很简单：把你原来的输入原样粘进去，如果只是排版乱、换行丢失，属于载体层；如果标题、图片、列表整段消失或错位，属于字段层。载体层只需换转义和换行规则，字段层才需要重写输入规范。
这个区分决定了下一步动作的方向，选错会让后续返工翻倍。
用一篇真实草稿做字段级试填，而不是先改模板
不要一上来就重写整个输入规范。先取一篇已经写完、结构完整的草稿，按工具当前显示或文档说明的对象字段逐个对填。假设工具要求如下结构（仅为说明字段关系的假设示例）：
title：单行字符串blocks：数组，每项含type和texttype允许的值：paragraph、heading、quote
试填时重点记录两类异常：一是工具直接报错的字段，二是没有报错但输出里消失的内容。后者更危险，因为它不会提醒你。
实际动作：填完后对照原文逐段核对输出。如果发现图片说明全丢，说明 captions 这类字段没有被你的输入覆盖；如果引用块变成了普通段落，说明 type 值不在允许集合内。这个核对结果直接决定你是改字段映射，还是需要换一个支持该块类型的工具。
区分三种原因，避免把工具限制误判为输入错误
字段对不上时，原因可能是：工具本身不支持该对象类型；你的输入规范写错了字段名或嵌套层级；或者工具支持但要求先做一次转换。三者处理方式不同。
可区分的证据：
- 如果换一个最简单的合法对象能成功，说明工具可用，问题在你的输入结构。
- 如果所有含某类块的对象都失败，而其他块正常，说明工具不支持该类型。
- 如果文档里写了该字段但实际不生效，说明版本或配置与文档不一致，需要以实际行为为准。
注意，请求量或报错归零不能单独证明你改对了，也可能是工具把错误静默吞掉。必须用输出内容反查。
改输入规范时保留一层可回退的映射
确定要改规范后，不要直接删掉旧字段。建议保留一个中间映射层：旧输入先转成通用结构，再按当前对象格式输出。这样当工具再次调整对象格式时，你只改映射出口，不动原始草稿。
具体做法：把原始内容按语义存成最小单元（段落、标题、引用、图注各一条），每条带一个稳定的内部类型标签，再由一个转换步骤生成工具需要的 type 值。转换规则单独放一处，便于核对和替换。
这个动作的结果是：下次对象格式再变，你只需要改转换规则，而不是重写所有历史输入。是否值得做这层映射，取决于你预期格式变化的频率；如果只是一次性迁移，直接改规范更省事。
什么时候该改规范，什么时候该换工具
如果工具当前对象格式缺少你业务必需的块类型（例如必须保留代码块或嵌套列表），且文档和实际行为都确认不支持，那么继续改输入规范只是绕路，应评估替代工具。评估时仍按同一方法：拿真实草稿试填，看必需字段是否被接受、输出是否保真。
如果缺失的只是展示细节，而内容语义完整，优先改输入规范，因为迁移成本更低。判断依据是你能否在输出里找回原文的每一个语义单元，而不是看排版是否完全一致。
最后提醒：具体工具支持哪些字段、字段名怎么写、是否收费，都需要以你当前使用的版本和实际试填结果为准，不要仅凭旧文档或他人描述下结论。
