标签： 命令行工具
-
随着 Go 多语言翻译工作流越来越复杂，性能瓶颈开始从单个命令内部转向多个命令之间的重复准备工作。current-check、result-pack、import 等命令虽然职责不同，却会反复重建相似的当前状态、历史审核链、回执、SHA 和身份标识。本文记录性能优化思路从“单命令内部复用”进一步转向“跨命令共享已验证执行环境”的过程，并讨论为什么共享环境不能等同于永久缓存、为什么冷启动必须始终独立正确，以及性能优化为什么不能绕过当前性和失效检测。
-
一次 Generation Bundle 当前性检查中，我误用了不存在的 generation-bundle check 命令。脚本虽然检测到失败并打印了 RESULT=FAILED，却因为在顶层子 Shell 中错误使用 return，没有真正停止执行，最终又打印出了一个伪造的 RESULT=PASS。本文记录这次故障的发现、恢复和修正过程，并讨论为什么 FINAL 只是摘要而不是权威状态、为什么后续成功不能覆盖必要检查失败，以及正式工作流中的 Shell 控制流为什么同样必须遵循“无法确认时按失败处理”的原则。
-
在为 site-v2-shell 首页创建候选快照时，本应只有 1 个页面翻译单元，结果却意外生成了 122 个单元。问题并非数据损坏，而是命令没有显式绑定内容包，底层流程落入了 Tour 的默认范围。本文记录这次真实故障的发现与修复过程，以及为什么错误的正式产物不能直接删除、为什么内容包本身就是工作流的权威边界，以及正式命令为什么宁愿多写一个参数，也不应该依赖隐式范围猜测。
-
本文记录 A Tour of Go 中文版项目在正式开发前完成的设计收敛过程。通过分析官方源码，确认当前固定 upstream 基线中 raw article 与 standalone 模式均为 101 页，而 integrated production 实际为 103 页，因此最终将 production 页面确定为翻译、校验和状态管理的最小单元。项目同时冻结整页翻译、段落结构校验、Candidate 与 Published 独立管理、Upstream Lock、最小等价 Projector 等核心规则，并根据真实使用需求放弃 Gin 和 Web 管理界面，正式采用 Go、Cobra CLI、文件状态存储及官方 Tour 兼容运行方案。