- CLI
- 0.2.17
- 预览 ref
- a2c45c8
Kiro 是那种大家通常在“真正的”电脑上运行的提供商：
- 装有仓库的笔记本
- 开发机
- 服务器
而你一站起来，就想要和所有人一样的东西：
- 看它是否还在运行
- 看它是否需要输入
- 发一条后续消息
很多人这时会默认用 SSH。
这份指南提供另一种方式：在仓库所在的地方运行 Kiro，然后用手机跟进。
简要总结
- 在要运行会话的电脑上安装 Kiro CLI（
kiro-cli --version）。 - 用
kiro-cli login登录。 - 不要过度解读认证状态。
- Kiro 的认证探测比较保守，即使登录正常也可能显示 未知（Unknown）。
- 在底层，当有安全的状态命令可用时，Kiro 通过
kiro-cli whoami --format json进行探测。
- 用适合手机的会话界面跟进对话记录并处理审批。
问题所在
在手机上跟进本地 CLI 会话，主要取决于两点：
- 与运行会话的电脑之间稳定的连接
- 能可靠地判断“是否已登录、是否就绪”
Kiro 在这方面尤其严格，因为它的认证探测被视为仅限手动。
所以工作流需要明确。
常见做法及其权衡
-
SSH：可行，但这是在手机上做终端工作。
-
等回到键盘前：安全，但慢。
-
Happier：一款开源应用，用于跨设备运行和编排编码代理。它提供一个手机界面，用来跟进会话、处理审批并发送一条后续消息。 权衡：它仍然依赖运行会话的电脑保持在线。
如果你第一次接触 Happier（它是什么，在哪里获取）
如果你之前没见过 Happier：它是一款面向编码会话的开源配套应用（移动端/网页/桌面）。
开始设置：
- GitHub: https://github.com/happier-dev/happier
- 安装/下载: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
第 1 步：安装 Kiro
按照提供商文档，验证：
kiro-cli --version第 2 步：登录（仅限本机）
Kiro 使用本机登录：
kiro-cli login这意味着：
- 在笔记本上登录，并不会让服务器也登录
实用登录检查清单
在要运行会话的电脑上：
- 运行
kiro-cli --version。 - 运行
kiro-cli login。 - 明确验证账号：
kiro-cli whoami --format json如果输出了用户或账号信息，说明你在这台电脑上已登录。
只要成功一次，除非有变化，就不用再操心认证。
第 3 步：理解认证状态为什么可能是“未知（Unknown）”
在源码中，Kiro 认证探测的定义是：
statusCommand: ['whoami', '--format', 'json']parser: 'kiroWhoamiJson'- 后台检查：
manual_only
最后一点就是“未知（Unknown）”不是 bug 的原因。
这是一种安全策略：不在后台激进地探测。
第 4 步：手机工作流
手机循环刻意保持精简。
作为一个循环：
- 打开会话
- 检查它是否在等待审批
- 发送一条后续消息
- 离开
手机上该做什么（以及不该做什么）
适合在手机上做的：
- 审批
- 简短的约束（“下一步后停下”“先总结”）
- 快速检查差异
不建议在手机上做的：
- 大型重构
- 无法核实路径或命令的事
适合 Kiro 的三条可复制后续消息
- 检查点
完成下一步后停下来，并总结：
- 你改了什么
- 你没改什么
- 你接下来想做什么
- 约束
不要碰迁移和认证代码。如果你觉得必须改，先停下来问我。
- 验证
继续之前，把你接下来要运行的确切命令贴出来，并解释原因。
如果会话需要真正的终端操作，就等回到键盘前再处理。
如果你第一次接触 Happier
如果你之前没见过 Happier：它是一款开源配套应用，可以把 Kiro 作为目录中定义的 ACP 提供商来运行，并让你方便地在手机上跟进会话。
开始设置：
- GitHub: https://github.com/happier-dev/happier
- 安装/下载: https://github.com/happier-dev/happier#how-it-works
- Discord: https://discord.gg/W6Pb8KuHfg
故障排查
Kiro 显示未登录，但我确定登录过
- 运行
kiro-cli whoami --format json - 如果输出了账号信息，说明登录成功
如果没有，说明你没有在这台电脑上登录（即使你在另一台电脑上登录了）。
会话没有更新
- 确认电脑在线，且会话运行时仍在运行
- 检查它是否在等待审批
- 重新加载或重新打开会话
我看到 Kiro 输出的 stderr 噪声
Happier 使用 Kiro 专用的传输层，会屏蔽一个已知的可选通知“method not found”的 stderr 输出模式。
所以如果你看到一次性的警告，可能无害。
常见问题
为什么不同电脑上的认证状态看起来不一样？
因为 Kiro 登录只在本机有效。
如果你有多台电脑，每台都需要单独运行 kiro-cli login。
“仅限手动”的认证探测是什么意思？
意思是应用不会在后台激进地探测 Kiro 的认证状态。“未知（Unknown）”是一个安全的状态，并不一定代表出错。