kunchenguid/gnhf

解决的问题

gnhf（Good Night, Have Fun）是一个自主的编排器，旨在用户离开时持续运行 AI 编码代理。它通过自动化一系列小规模、已提交且有文档记录的变更循环，解决了手动监督的问题，确保用户醒来时看到的是干净、逐步推进的工作分支，而不是停滞不前的进程。

工作原理

该工具以循环方式运行，调用非交互式编码代理执行任务。每个迭代步骤如下：

1. 执行：触发代理进行变更。
2. 验证：如果变更成功，将创建独立的 git 提交，并将备注追加到 notes.md 文件中，以实现跨迭代的共享记忆。
3. 失败处理：如果某次迭代失败，将执行 git reset --hard 回滚更改，除非是提交失败，此时会保留工作内容，以便下一次迭代修复。
4. 持久化：使用 .gnhf/runs/ 目录存储提示、日志和元数据，支持后续恢复运行。
5. 速率限制管理：自动检测速率限制（如来自 Claude 的限制），并在重置时间后自动恢复运行。

适用人群

使用 AI 编码代理并希望执行长时间任务（如重构或功能实现）的开发者，无需手动触发每一步或实时审查每次变更。

主要亮点

• 增量提交：每个成功步骤都会单独提交，便于轻松挑选或回滚。
• 代理无关：兼容多种编码代理 CLI 和 ACP 目标。
• 工作树模式：支持在同一仓库上使用隔离的 git 工作树同时运行多个代理。
• 运行限制：支持最大迭代次数、总 token 数以及自定义停止条件（--stop-when）。
• 实时状态：通过终端标题实时更新 token 总数和提交次数。