Kilo 是那种坐在键盘前用起来很顺手的 CLI。

但重要的会话往往都很耗时：

• 依赖升级
• 机械式重构
• “改 30 个文件”的变更

工作流不应该是“守在终端前直到它跑完”。

这份指南介绍如何在有代码仓库的电脑上运行 Kilo，然后用手机推进会话。

简要总结

1. 在要运行会话的电脑上安装 Kilo（kilo --version）。
2. 用 Kilo 的 /connect 流程完成认证。
3. 如果 Kilo 认证状态显示 未知（Unknown），这是预期的：Kilo 的认证探测比较保守。
4. 如果找不到 Kilo，把 HAPPIER_KILO_PATH 设为 kilo 可执行文件的绝对路径。
5. 用适合手机的会话界面监控进度、处理审批并发送后续消息。

问题所在

Kilo 是基于本地 CLI 的提供商。

它的吸引力正在于此：你的仓库和工具都在本地。

但这也意味着：

• 会话运行在某一台特定的电脑上
• 那台电脑休眠，会话就会停止
• 如果你只有 SSH，手机就变成了终端

所以好的“手机工作流”主要是可见性加上小幅干预。

常见做法及其权衡

• 用手机 SSH
• 远程桌面
• 等着

更紧凑的循环效果更好：查看、审批、推一下，然后停。

• Happier：一款开源应用，用于跨设备运行和编排编码代理。它提供一个手机界面，用于监控会话、处理审批和发送后续消息。 权衡：它仍然依赖运行会话的电脑保持在线。

如果你第一次接触 Happier（它是什么，在哪里获取）

如果你之前没见过 Happier：它是一款面向编码会话的开源配套应用（移动端/网页/桌面）。

就本指南而言，核心思路是：Kilo 运行在有代码仓库的电脑上，而 Happier 让你不必一直守在 SSH 里，就能在手机上监督它。

开始设置：

• GitHub: https://github.com/happier-dev/happier
• 安装/下载: https://github.com/happier-dev/happier#how-it-works
• Discord: https://discord.gg/W6Pb8KuHfg

第 1 步：在要运行会话的电脑上安装 Kilo

根据提供商文档：

npm install -g @kilocode/cli@latest
kilo --version

如果你使用 hstack：

hstack providers install kilo
kilo --version

（如果你没听说过 hstack：它是 Happier 生态中的可选辅助工具，可以帮你安装提供商的 CLI。它不是必需的，npm install -g ... 完全可以。）

第 2 步：认证 Kilo（/connect）

Kilo 支持从提供商设置中启动它自己的登录流程。

文档中的关键细节是，Kilo 使用 /connect 流程。

所以如果你看到“未认证”，不用猜，运行 connect 流程后再检查即可。

实用登录检查清单

在要运行会话的电脑上：

1. 运行 kilo --version。
2. 运行 /connect（或从提供商设置中启动）。
3. 启动一个小会话，确认可以发送后续消息。

只要成功一次，就不用再操心认证。

第 3 步：理解认证为什么可能显示“未知（Unknown）”

在源码中，Kilo 认证探测标记为 parser: 'unknown'。

这是有意为之：显示“未知（Unknown）”比在后台运行有风险的探测更安全。

所以把 未知（Unknown） 理解为“无法安全探测”，而不是“出错了”。

第 4 步：用 HAPPIER_KILO_PATH 修复 Kilo 检测

如果已安装 Kilo 但检测不到：

• 确认 kilo --version 能运行
• 然后把 HAPPIER_KILO_PATH 设为绝对路径

这个覆盖在 CLI 测试中有实际覆盖，所以与实现一致。

第 5 步：手机工作流

可行的手机工作流刻意保持简单：

1. 打开会话
2. 检查它是否在等待审批
3. 发送一条后续消息
4. 离开

手机上该做什么（以及不该做什么）

适合在手机上做的：

• 读完权限请求后批准或拒绝
• 发送简短的约束（“下一步后停下”“先总结”）
• 粗略检查改了哪些文件

不建议在手机上做的：

• 大型重构
• 需要大量复制粘贴的事
• 无法核实路径或命令的事

适合 Kilo 的三条可复制后续消息

1. 检查点

完成下一步后停下来，并总结：

• 你改了什么
• 你没改什么
• 你接下来想做什么

2. 约束

不要碰迁移和认证代码。如果你觉得必须改，先停下来问我。

3. 先看差异

继续之前，列出你修改过的文件和原因（每个一句话）。

如果需要真正的交互式终端操作，就等回到键盘前再处理。

如果你第一次接触 Happier

如果你之前没见过 Happier：它是一款开源配套应用，让你在电脑上运行 Kilo 这类会话，并用手机监控。

开始设置：

• GitHub: https://github.com/happier-dev/happier
• 安装/下载: https://github.com/happier-dev/happier#how-it-works
• Discord: https://discord.gg/W6Pb8KuHfg

故障排查

会话没有更新

• 确认电脑在线，且会话运行时仍在运行
• 检查它是否在等待审批
• 重新加载或重新打开会话

Kilo 认证显示“未知（Unknown）”

这是预期的。在源码中，Kilo 认证探测标记为 parser: 'unknown'。

把它理解为“无法安全探测”，而不是“出错了”。

相关指南

• 不再卡在“等待审批”