re0-order

将具名列表中的项目调整为读者能够说清的一种顺序，只改变它们的位置。

目标

相关项目沿着一个清晰的轴线排列在一起时，列表才有意义；把项目随手追加到写下它们的位置会模糊这种意义。re0-order 按照一个读者能够说清的原则重新排列集合，只移动项目，不做其他改动。它作用于人指定的列表、表格、目录、章节集合或枚举，也作用于人指定的范围内，或由其调用的流水线传入的范围内的这些内容。结果会原地生效：既在列表本身，也在所有与之保持一致的副本中。

工作流

1. 确定列表及其项目：聚焦于人指定范围内的有序集合。
2. 说清最能体现其意义的一个原则，可以是工作流或生命周期顺序、依赖关系、按类型分组、严重程度、频率或字母顺序。如果已有潜在顺序，就将其显现并补全，而不是强加新原则。如果无法确定当前顺序是否有意为之，就把这个判断交给人来决定；在其决定之前不要移动任何内容。
3. 将相关项目放在一起，再按照这一个原则排列这些分组。
4. 如果原则依据的是计数（每个项目的使用频率、搜索频率），就从列表所服务的记录中读取各项计数，并将其作为初始顺序，而不是直接作为排序键。将其他项目都通过它抵达的项目放在前面；即使相关项目的计数不同，也要将它们放在一起；其余部分则按新人会遵循的阅读或工作顺序排列。只有在上述顺序仍无法确定时，才由计数决定先后。说明结果中每一处偏离计数顺序的位置及原因。
5. 将项目原地移动到新顺序。不要改写措辞，不要添加内容，不要删除内容。
6. 在所有反映该集合的地方采用完全相同的顺序，包括翻译副本和其他呈现位置。要查找这些副本，请在仓库中搜索该集合中的两三个项目；如果项目有标识符，就按标识符搜索，否则按独特短语搜索；同时查找自称为此列表副本的文件，例如翻译文件。凡是包含同一集合的搜索结果，都是副本，也是人指定列表的一部分。

规则

• 只重新排序：绝不改写、添加、删除、拆分或合并项目。这些属于其他操作。
• 使用一个读者能够说清的原则；绝不要在一个列表中混用互不兼容的排序方式。
• 按该原则排序之前，先将每个项目所依赖的其他项目置于其前面，并遵守人指定的所有先后关系；依赖关系只约束排序，不是第二个原则。产出知识的项目（研究、调查、测量）是其能够提供信息的每个计划或构建所依赖的项目，即使这些计划或构建没有明确提及它也一样，因此它应排在它们之前；无论其范围多广或是否有明确终点，都不能因此将其放到最后，因为后期发现的问题会导致返工。
• 尊重有意安排的顺序：如果当前顺序已体现真实原则，就补全并整理它，而不是取而代之；若无法确定，就把判断交给人来决定。
• 只在人工指定的范围内操作，或在其调用的流水线传入的范围内操作。绝不要自行选择列表；其顺序由人决定，重新排序操作若自行选择目标，就会改动无人要求移动的内容。
• 同一集合的镜像副本必须采用相同顺序。
• 安全编辑：移动前确认每个项目都存在，若找不到则报告 MISS，不要静默丢弃；编辑时确保 Unicode 安全；大型结构调整应编写脚本，而不是手动批量修改。

验证

完成前，请确认：

1. 读者仅凭结果就能说出排序原则。
2. 原始条目全部保留；只有位置发生变化；没有改写、新增或删除任何内容。移动前保存列表，然后运行 node scripts/same-set.mjs <before-file> <after-file> [--json]：每个非空行都是一个条目；退出码为 0 表示多重集合相同；退出码为 1 会列出新增、删除或更改的条目；退出码为 2 表示用法错误。
3. 同类项彼此相邻，且整个序列始终遵循同一原则。
4. 每个镜像副本的顺序都完全相同。对每个副本运行一次带 --mirror <file> 的同一脚本：它会比较该副本与 after 文件共有的条目；退出码为 1 时，会列出第一个顺序不一致的条目。