commit-rewriter 0.1 发布

commit-rewriter 0.1 — simonwillison.net · 22 小时前 · 🛠 工具 / 开源

commit-rewriter 0.1 是 Simon Willison 为 Datasette 的安全版本发布流程顺手做出来的小型本地 Web 应用，用来批量编辑仓库的提交信息。触发点很具体：准备安全修复版本时，最初的提交里塞满了编码智能体留下的冗余内容（coding agent cruft）以及对私有仓库 issue ID 的引用，这些内容一旦随公开发布进入永久历史，就等于把内部协作痕迹和漏洞线索一起暴露出去。工具的使用方式被压到一行：uvx commit-rewriter path/to/repo；如果当前目录已经是目标仓库，直接省略路径即可。uvx 会按需拉取并在隔离环境中运行，不必预先安装，也不会污染项目依赖。作者把它称为 little web app，而不是纯命令行工具，这个形态选择贴合任务本身：提交信息是多行文本，编辑时需要上下对照、反复推敲措辞，浏览器里的编辑界面比终端逐条提问更顺手，同时本地运行保证了仓库内容不出本机。版本号 0.1 说明它是刚发布的最小可用版本，接口与行为都还可能变化。它的定位不是通用历史重写工具，而是发布前的一次性清理工序：把「给人看的草稿式提交说明」整理成「可公开的变更记录」，这类需求在 AI 编码代理普及后已经从偶发变成常态，安全修复版本尤其敏感，因为发布行为本身就会暴露修复位置。

核心论点

• 动机来自一次具体的发布流程：为 Datasette 安全版本整理提交历史时，初始提交里充满编码智能体留下的冗余内容（coding agent cruft）和对私有仓库 issue ID 的引用，既噪音大又不适合公开。这类需求在 AI 编码代理普及后从偶发变成常态——代理生成的提交说明往往是给人看的草稿，而不是可公开的变更记录；安全修复版本尤其敏感，因为发布这个动作本身就会暴露修复的位置，因此发布前的提交信息清理是必要工序，而不是洁癖。
• 调用方式是 uvx commit-rewriter path/to/repo，如果当前目录已经是目标仓库则省略路径参数。uvx 是 uv 生态里的工具运行器，按需拉取依赖并在隔离环境中执行，使用者不需要全局安装，也不会污染项目的虚拟环境，把「试用成本」压到一行命令。对维护者来说，这种分发方式的意义在于把一次性工具的门槛降到几乎为零：不必为了一次发布前的清理去安装长期依赖。版本号 0.1 表明这是刚发布的最小可用版本，接口与行为仍可能调整。
• 形态上它是本地运行的 Web 应用，而不是纯 CLI。编辑提交信息是多行、需要前后对照的文本工作，浏览器里的编辑界面比终端逐条提问更顺手，也更容易在一个页面里浏览整段历史；本地运行则保证仓库内容不离开本机。这个选择与作者一贯的小工具风格一致：把界面做得够用即可，重点是把某个具体工作流痛点一次性解决，而不是做成通用平台，这也解释了为什么它从一个内部需求直接变成一个可发布的小版本。
• 与 git rebase -i、git filter-repo 等既有方案相比，commit-rewriter 把目标收窄到提交信息这一层，用界面替代交互式变基的语义与冲突处理，操作面更小、误伤风险更低，代价是它并不解决作者身份、文件内容或历史结构的问题。需要注意，任何提交信息改写都会改变 commit SHA，已推送的分支必须 force push，因此它最适合发布前的私有历史清理，而不是公共分支上的日常操作。

💡 为什么值得读: 它给出一条一行命令就能跑通的发布前清理路径，也顺带说明 AI 代理写下的提交历史为什么需要在上线前被人重读一遍。

🏷️ git, commit, tool, Datasette

---