- CLI
- 0.2.17
- 预览 ref
- a2c45c8
AI 编程工具很有用,但提交你没有真正审查过的改动,总让人不踏实。
在桌前这很容易。在手机上就别扭了:
- SSH 能让你看到真实情况,但在小屏幕上审查 diff 并精确暂存非常累。
- GitHub 手机版很适合审查 PR,但当改动还未提交、停留在你的机器上时,它帮不上什么忙。
- 远程桌面能用,但很容易误触出一个糟糕的提交。
真正有帮助的是更接近这样的体验:
“让我像真正审查代码那样滚动浏览整组 diff,打开某个文件检查,做一处小修改,然后继续。”
这套工作流避开了在手机上用 SSH、远程桌面和 GitHub 手机版时常见的取舍。
要点
- 设置好 Happier(或通过直连会话接入),然后在手机上打开会话。
- 进入版本控制(Source control)→ 审阅(Review)。
- 滚动浏览所有未提交的 diff,看完的就折叠起来。
- 发现不对劲的地方,就在编辑器标签页中打开那个文件修改,然后回到审阅。
- 当你信任这些 diff 后,可以暂存或提交。也可以停在“只审查”,稍后在笔记本上提交。
问题
当代理修改了很多文件(哪怕只是几个重要文件),提交前你需要回答两个问题:
- 改了什么?(不只是哪些文件,而是实际的 diff 内容)
- 我信任它吗?(改得对不对、范围是否恰当、有没有夹带意外)
在手机上,主要的失败方式是:因为工具别扭,你就不再认真审查了。
常见做法及其取舍
- SSH + git diff:能用,但在手机上很容易一扫而过,错过“等等,这个文件为什么改了?”的时刻。
- 远程桌面:能用,但在手机上很容易误触出糟糕的修改。
- GitHub 手机版:很适合审查 PR,但看不到你机器上未提交的工作树。
真正有帮助的是一个能在手机上用的审查界面:像看 PR 一样滚动 diff,跳进某个文件,改一处,继续。
- Happier:一款用于跨设备运行和编排编程代理的开源应用。它在手机上提供“像 PR 一样滚动整组 diff”的视图,而仓库留在你的机器上。 取舍:如果机器或守护进程无法访问,你就又回到 SSH 或远程桌面了。
心智模型:改动文件列表与“审阅”
改动文件列表回答的是:“哪些文件改了?”
审查界面回答的是:“做了哪些工作?”
在 Happier 中,审阅视图就是用来“滚动浏览实际工作”的界面:
- diff 逐步渲染
- 看完的文件可以折叠
- 可以跳到编辑器而不丢失当前位置
正是这一点,让在手机上审查比在小终端里审查顺手得多。
如果你第一次接触 Happier(它是什么、在哪里获取)
Happier 是一款面向 Claude Code、Codex 和 OpenCode 等 AI 编程代理的开源配套应用(移动端 / 网页 / 桌面端)。
这里的工作流是:仓库和 Git 留在拥有工作区的机器上,用 Happier 直接在手机上审查 diff。
对这篇指南来说,这意味着你可以在手机上审查真实的、未提交的工作树 diff(甚至做一处小修改),而不用退回到远程桌面。
开始设置:
- 如何在手机上使用 Happier
- GitHub: https://github.com/happier-dev/happier
- 安装 / 下载: https://github.com/happier-dev/happier#how-it-works
- Discord(社区与支持): https://discord.gg/W6Pb8KuHfg
分步操作:在手机上审查未提交的 diff
1) 打开版本控制
在会话界面中,打开版本控制(Source control)。
你应该能看到分支摘要和改动文件列表。
2) 打开审阅
打开审阅(Review)。
现在像审查 PR 一样滚动浏览整组 diff:
- 看完的文件折叠起来
- 看到可疑之处就停下来
3) 检查并修复小问题(不丢失位置)
发现小问题时(命名、遗留的调试日志、错误的配置修改):
- 在编辑器中打开那个文件
- 修改
- 回到审阅继续
关键在于审查保持连续,你不必频繁切换上下文。
4) 决定下一步做什么
认真审查之后,有几种合理的结果:
- 只审查:你信任这些改动,稍后在笔记本上暂存或提交。
- 现在暂存或提交(如果启用了 Git 操作,并且你愿意在手机上做)。
- 给代理发追加指令(“修好这两个文件,撤销这一个,并拆分提交”)。
附件与项目文件(不要混淆)
审查改动时,确保你看的是工作区文件(仓库),而不只是附件。
附件很适合把日志或一次性产物发给模型,但它们和你打算提交的仓库文件不是一回事。
常见错误
- 只看文件列表(不看 diff)→ 错过真正有风险的改动。
- 在手机终端里审查然后匆忙了事 → 批准了在电脑上本不会批准的东西。
- 以为 GitHub 手机版反映的是你的机器 → 并不是,除非改动已经推送到 PR 中。
故障排查
症状:我看不到版本控制或 diff
可能原因:
- 拥有会话的机器或守护进程无法访问
- 你用的是错误的服务器或配置
解决:
- 确认你连接的是正确的服务器。
- 确认机器在线、可以访问。
症状:审阅是空的,但我知道文件改了
可能原因:
- 你看的是错误的仓库或工作区
- 版本控制后端还没有刷新
解决:
- 回到改动文件列表,确认你处在正确的仓库上下文中
常见问题
能在手机上审查 diff 而不提交吗?
可以,而且这往往是一个合适的默认做法。
在手机上审查,等到有完整工具时再在笔记本上提交和推送。
这样审查 AI 生成的代码够吗?
作为第一轮检查是够的,尤其适合发现明显的范围问题。
对于高风险的改动,合并前请在笔记本上做更深入的审查(或者请另一个代理审查)。