让命令行智能工具先学会旁观
旁观模式要能看清计划
把失败写成能读懂的结果
我会给这类工具再留几条反例:输入为空、外部依赖拒绝、重复执行和中途取消。断言不仅检查 Result,也检查状态是否被提前修改、临时文件是否清理。这样失败时可以直接判断是契约改变,还是某条收尾分支漏掉了。
错误信息也要指向用户能处理的位置。说明哪个参数或文件有问题,保留必要的底层上下文,不把一长串内部调用栈当作提示。可预测的失败路径比“尽量自动修复”更适合小工具。
我会把 dry-run 的输出做得像一份待执行清单:读了哪些文件、识别出哪些对象、每一步原本会调用什么。只说“模拟成功”没有太多帮助,等真正执行才发现过滤条件写错,还是会伤到旧流程。计划可以保存成文本,让人和测试都能比较它。
建议模块的输出也该留在计划里,而不是直接混进执行参数。有人不同意建议时,可以删掉一项后继续运行;工具本身不需要猜用户想不想接受。等这条路径稳定,再考虑给明确、可逆的操作加确认开关。
我最近在想,给旧命令行流程接入智能建议时,最危险的不是模型答错,而是它一开始就拥有了改动真实数据的能力。非科班转过来后,我更愿意把迁移拆小:先让新工具读样例、给出建议,再讨论它能不能写入。这样做慢一点,但出问题时知道问题来自提示词、解析器还是旧规则本身。
先把读写范围写进命令
一个迁移命令至少要把它准备读取什么、可能写到哪里说清楚。--dry-run 不应该只是打印“模拟执行”,而要列出输入文件、过滤条件、准备调用的步骤和会跳过的对象。路径来自用户参数时,先用路径库规范化,再判断它是否落在允许的工作目录内;不能仅靠字符串里有没有 .. 判断安全。
我会先做一个很小的结构体,把“计划”和“执行”分开。计划阶段只收集操作,执行阶段才拿到可写接口。这样单元测试可以直接断言计划内容,而不是创建一堆临时文件后猜结果。下面的断言不是为了证明工具已经安全,只是确认默认模式没有写入动作:
#[test]
fn dry_run_only_returns_plan() {
let plan = build_plan("fixtures/input", true).unwrap();
assert!(!plan.actions.is_empty());
assert!(plan.actions.iter().all(|a| !a.writes));
}
用样例比较,不替旧流程背书
新旧流程比较时,我会选脱敏且覆盖边界的样例:正常输入、缺字段、重复记录、格式不合法的文件都要有。比较的对象也要具体,例如输出条目数、被忽略的原因和错误类别。只比较“命令是否成功”很容易漏掉语义差异。
两边结果不同,不该默认新工具错,也不能默认旧逻辑正确。先把差异保存成可读报告,再逐条确认旧规则是不是历史遗留。比如旧脚本可能悄悄吞掉空行,新解析器却明确报错;这时需要的是产品决定,而不是为了通过对比测试把新行为改回去。
给失败留出停下来的位置
迁移初期最好只开放少量明确场景,并把人工确认放在真正写入之前。网络请求、删除、覆盖文件等能力不要因为“方便”塞给建议模块。即使后面增加自动执行,也应保留可追踪的操作标识、可重复运行的输入,以及失败后的清理策略。
常见误区是把日志当成审计。日志能帮助排查,却不等于它记录了完整操作;另一个误区是把脱敏样例当成生产证明。样例只能验证我们写下的规则。每加一种输入,就补一个最小样例和一条预期,再运行 cargo test。我目前只把这当成学习中的护栏,不把它包装成万能迁移方案。
1322



被折叠的 条评论
为什么被折叠?



