用途
re0-order 用于整理那些因随手追加而变得杂乱无章的清单:一个列表、一张表格、一份目录、一组章节或一个枚举。它的目标是在只改变条目位置的前提下,让相关条目沿一条读者能说清的主轴排列在一起,使清单重新具有可读的逻辑含义。
主要能力
- 锁定目标:确定需要排序的条目集合,以及人类指定或管道传入的范围。
- 选择唯一原则:从工作流或生命周期顺序、依赖关系、按种类分组、严重程度、频率、字母顺序等中选定一个最能赋予顺序意义的原则;若已存在潜在顺序,则显现并补全它,而不是强加新顺序。
- 依赖优先:在按原则排序前,把被依赖的条目放在依赖它的条目之前,并保持人类明确陈述的优先级;依赖只作为约束,不作为第二排序原则。产生知识类成果(研究、调查、测量)的条目即使未被点名,也要排在会被其影响的计划或构建之前。
- 计数辅助:当原则涉及可测量的计数(如使用频率、搜索频率)时,仅将计数作为起始参考,不作为排序键本身;先放置通向其他条目的入口项,保持同类相邻,让阅读或工作顺序决定其余部分,计数只用于填补该顺序留下的空白,并说明偏离计数的每一处原因。
- 镜像同步:在仓库中按条目标识符或独特短语搜索两三个条目,并查找自称副本(如翻译文件)的文件,凡是包含同一集合的文件都视为镜像,应用完全相同的顺序。
- 安全编辑:移动前断言每个条目存在,缺失则报告 MISS 而非静默丢弃;支持 Unicode 安全编辑;大型结构性移动通过脚本完成。
使用方式
先由人类指定要整理的清单及其范围,然后按上述工作流执行排序,并在完成后进行验证:保存移动前的清单,运行 node scripts/same-set.mjs <before-file> <after-file> [--json] 检查前后条目集合是否一致(退出码 0 表示多重集相同,1 列出新增、删除或改动的条目,2 为用法错误);对每个镜像副本另用 --mirror <file> 运行同一脚本,退出码 1 时指出第一处分歧。
适用场景
适合需要把已经存在但顺序混乱的清单整理成可命名顺序的场合,例如文档章节、配置枚举、目录表格、多语言副本需要保持一致顺序的项目。
限制
- 只调整顺序,绝不改写、新增、删除、拆分或合并条目。
- 必须使用一个读者可命名的原则,不在同一清单中混合不兼容的排序方式。
- 只作用于人类指定或管道传入的范围,不自行选择清单。
- 当前顺序是否刻意不明确时,须交由人类决定,决定前不移动任何条目。