- CLI
- 0.2.17
- 预览 ref
- a2c45c8
Augment 给人一种“直接开写”的感觉。
缺点是 Auggie 会话运行时,你得一直守着笔记本。
如果一个任务要花 20 到 60 分钟,你需要一个这样的工作流:
- 在有代码仓库的电脑上启动会话
- 离开电脑
- 用手机查看进度
- 回应提示和审批
- 发送一条后续消息
这份指南就是这个工作流。
简要总结
- 安装 Auggie,并在要运行会话的电脑上验证
auggie --version。 - 用手机工作流(Happier 是一种选择)监控会话、处理审批并发送后续消息。
- 如果 Augment 认证状态显示 未知(Unknown),不用慌,Auggie 的认证探测比较保守。
- 如果找不到 Auggie,把
HAPPIER_AUGGIE_PATH设为auggie可执行文件的完整路径。
问题所在
“用手机监控”通常因为以下三个原因之一而失败:
- 会话运行在会休眠的电脑上(会话因此中断)
- 你只有 SSH(手机变成了终端)
- 认证或状态不明确(你不信任看到的内容)
Auggie 是基于本地 CLI 的提供商。代码留在仓库所在的地方,这是优点。
但这意味着你的手机工作流需要有意设计。
常见做法及其权衡
-
用手机 SSH:可行,但在小终端里很难阅读长输出。
-
远程桌面:笨重又麻烦。
-
等回到键盘前再说:安全,但慢。
-
Happier:一款开源应用,用于跨设备运行和编排编码代理。你可以在手机上打开 Augment 会话、查看进度、处理审批,并用一条简短的后续消息推动运行。 权衡:它仍然依赖运行 Auggie 的电脑保持在线。
如果你第一次接触 Happier(它是什么,在哪里获取)
如果你之前没见过 Happier:它是一款面向编码会话的开源配套应用(移动端/网页/桌面)。
就本指南而言,核心思路很简单:
- Auggie 运行在有代码仓库的电脑上
- Happier 是你在手机上监督会话的地方(进度、审批、一条后续消息)
开始设置:
- GitHub: https://github.com/happier-dev/happier
- 安装/下载: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
第 1 步:在要运行会话的电脑上安装 Auggie
根据提供商文档:
npm install -g @augmentcode/auggie
auggie --version如果你使用 hstack,也有安装器:
hstack providers install auggie
auggie --version(如果你没听说过 hstack:它是 Happier 生态中的可选辅助工具,可以帮你安装提供商的 CLI。它不是必需的,npm install -g ... 完全可以。)
重要的不是安装方式。
而是 auggie --version 能在要运行会话的电脑上正常运行。
第 2 步:了解 Auggie 认证(以及状态为什么可能是“未知(Unknown)”)
Auggie 支持从提供商设置中启动它自己的登录流程。
但 Auggie 的认证探测比较保守。
在 Happier 的代理认证探测配置中,Auggie 使用 unknown 解析器。这意味着:
- Happier 不会用有风险的探测去推断“已登录”还是“已登出”
- 即使一切正常,界面也可能显示 未知(Unknown)
所以一个好的规则是:
- 如果
auggie login在那台电脑上能用,就没问题 - 把“未知(Unknown)”理解为“无法安全探测”,而不是“出错了”
实用登录检查清单
在要运行会话的电脑上:
- 运行
auggie --version。 - 运行
auggie login(或从提供商设置中启动)。 - 启动一个小会话,确认可以发送后续消息。
只要成功一次,在它出问题之前就不用再操心认证。
第 3 步:用 HAPPIER_AUGGIE_PATH 修复“找不到 Auggie”
如果会话电脑能运行 auggie,但应用找不到它,问题通常出在 PATH。
Happier 支持一个覆盖可执行文件路径的环境变量:
HAPPIER_AUGGIE_PATH
把它设为 auggie 可执行文件的绝对路径。
这个覆盖在 CLI 后端测试中有实际覆盖(不只是文档上的承诺)。
第 4 步:启动会话,把手机当作监视器
手机工作流刻意保持精简。
作为一个循环:
- 打开会话
- 检查它是否在等待审批
- 发送一条后续消息
- 离开
手机上该做什么(以及不该做什么)
适合在手机上做的:
- 读完之后批准或拒绝权限请求
- 发送简短的纠正(“这一步后停下”“不要碰 X”“先总结”)
- 粗略检查改了哪些文件
不建议在手机上做的:
- 任何大型重构
- 需要大量复制粘贴的事
- 无法轻松核实路径或命令的事
适合 Auggie 的三条可复制后续消息
在“用手机”的场景下,这些后续消息值得反复使用:
- 检查点
完成下一步后停下来,并总结:
- 你改了什么
- 你没改什么
- 你接下来想做什么
- 约束
不要碰迁移和认证代码。如果你觉得必须改,先停下来问我。
- 先看差异
继续之前,列出你修改过的文件和原因(每个一句话)。
第 5 步:故障排查清单
会话没有更新
- 确认电脑在线,且会话运行时仍在运行
- 检查它是否在等待审批
- 重新加载或重新打开会话
如果你合上了笔记本盖子,而那台笔记本就是主机,就当作会话已经停止。
我分不清它是不是卡住了
使用“卡住的会话”排查步骤:
- 等待审批、离线还是忙碌
如果你第一次接触 Happier
如果你之前没见过 Happier:它是一款开源配套应用,用于在一台电脑上运行 Augment/Auggie 这类会话,并用手机监控。
工作流大致是:
- Auggie 在仓库所在的地方运行
- Happier 用来查看进度、处理审批和发送后续消息
(如果你不想再装一个应用,随时可以退回到 SSH。不过大多数人并不喜欢在手机上用 SSH。)
开始设置:
- GitHub: https://github.com/happier-dev/happier
- 安装/下载: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg