工具类应用推广：工具支持的对象格式变化时怎样改输入规范
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /13e9885f8d78.html
📄
工具类应用推广：工具支持的对象格式变化时怎样改输入规范
先别急着把旧输入规范整份替换。对象格式变化后，真正要判断的是三件事：旧规范中哪些字段仍然被新格式接受，哪些可以映射改写，哪些已经失去意义必须退出。把这三类分开处理，比一次性重写更省事，也能避免推广素材、帮助文档和对接说明之间互相矛盾。
先判断变化发生在哪一层
对象格式变化可能只影响输入值的写法，也可能改变字段结构，甚至改变一个输入项能承载几个对象。三种情况的处理方式不同。
- 如果只是值写法变化，例如日期分隔符、大小写、前缀规则变了，旧规范多数可以保留，只需替换示例和校验说明。
- 如果字段名或层级变了，旧规范需要逐条映射，保留字段含义、改写字段路径。
- 如果输入单位变了，例如原来一次提交一个对象，现在一次提交一组对象，旧规范中关于“单条填写”的整段说明应当退出。
判断依据不是新格式文档写了什么，而是旧规范里的每条要求在新格式下是否仍能被满足。能满足就保留，换个说法能满足就改写，无法满足就退出。这个判断要逐条做，不能按章节整体保留或删除。
保留、改写与退出的适用前提
保留适用于字段含义和取值范围都没变、只是表达层调整的部分。例如输入项仍要求唯一标识，只是从数字改为字符串，那么“必须唯一、不可为空”这类约束继续成立，改掉示例即可。
改写适用于旧要求仍有效、但需要经过一层映射才能落到新格式的部分。典型情况是旧规范按位置描述字段，新格式按名称描述。此时保留原有校验逻辑，把描述方式换掉，并在规范中注明映射关系，方便旧内容逐步迁移。
退出适用于新格式已不再提供对应能力，或该要求依赖的旧系统、旧合作关系已经不再维护的部分。退出的内容不要直接删掉了事，应在规范中保留一条简短说明，写清该要求为何不再适用，避免执行人员从旧文档里翻出过期规则继续使用。
取舍的关键不是新旧哪个更好，而是这条输入要求是否还有对象可以作用。没有作用对象的规则，留着只会增加核对成本。
用一个假设例子走完判断过程
假设某工具原先接收单个地址字符串，输入规范要求“省、市、区用空格分隔，顺序不可颠倒”。新格式改为接收结构化对象，省市区各自独立成字段。此时：
- “顺序不可颠倒”退出，因为结构化字段本身不含顺序概念。
- “省市区必须完整”保留，因为约束对象仍然存在。
- “用空格分隔”改写为“各字段独立填写，不携带分隔符”。
假设旧规范中还写着“地址总长度不超过某一上限”，而新格式按字段分别限制长度，那么这条整体长度要求就应当退出，替换为分段限制。这里的具体长度值需要以新格式的实际说明为准，不能沿用旧值。
做完这一步，实际动作是产出一份对照表：旧条目、判断结果、新写法或退出原因。对照表完成后，下一步才是修改帮助文档和推广素材中的示例。顺序反了，先改素材再回头补规范，容易出现同一工具在不同页面给出不同输入要求的情况。
规范改完后要同步哪些内容
输入规范很少单独存在。它通常被帮助文档、对接说明、推广落地页里的示例引用。规范改动后，至少检查三类位置：
- 示例值是否仍符合新格式，尤其是复制粘贴后能直接通过校验的示例。
- 错误提示文案是否还指向已经不存在的字段或规则。
- 旧版本文档是否已标注适用对象，避免新用户按旧规范填写。
如果旧合作关系或旧系统仍需按旧格式输入，就保留一份限定适用对象的旧规范，并写清它只服务于哪类对接，而不是让它继续作为默认说明存在。这样保留仍然有价值的部分，同时让新输入路径有独立、明确的依据。
改完后用一个真实输入走一遍校验流程，观察报错信息是否指向新规范中的条目。如果报错仍引用旧字段名，说明规范与实现之间还有未对齐的部分，应先修实现或提示文案，再更新对外内容。
