技能介绍

要解决的问题

当 CodeBuddy CLI 运行在 CNB 云原生环境中时，手动交互操作难以满足自动化任务需求——比如需要批量下发指令、无人值守执行，或是在非交互终端里回收结果。传统交互方式依赖人工输入回车、选择选项，不仅效率低，还无法融入流水线或脚本体系，导致远程环境中的 CodeBuddy CLI 难以被程序化调用。

核心能力与工作流程

该技能通过 SSH 建立远程连接，并利用 PTY（伪终端）实现非交互式控制，核心是模拟键盘事件精准操作基于 ink 框架的 CodeBuddy CLI。具体分为三个阶段：

环境准备：首先验证 SSH 连接可用性，检查 CodeBuddy 是否已登录（未登录则需通过中国站 OAuth 扫码认证，token 会持久化到 ~/.codebuddy/）；首次启动需信任工作目录，避免卡住交互流程。
任务下发：提供三种适配不同场景的方式：

- PTY 交互模式（推荐）：保持 PTY 连接，通过 process write 发送指令文本，用 process send-keys 发送十六进制回车（如 ["0d"]）提交，实时跟踪状态栏变化（从 waiting for model 到 idle），支持动态调整指令。
- expect 脚本模式：用 scripts/cb-remote.sh 实现无人值守执行，适配批量或定时任务。
- nohup 后台模式：用于长时间运行的任务，避免终端断开影响进程。

结果回收与异常处理：PTY 模式从会话日志提取结果并清理 ANSI 码；脚本或后台模式通过 SSH 读取输出文件。针对常见问题（如 401 认证错误、SSH 断连、回车未生效），提供了对应排查方案，比如用 ServerAliveInterval 保持 SSH 连接，确保用十六进制发送回车而非普通字符。

适用边界与注意事项

该方案仅支持单 CodeBuddy 会话运行，多实例会冲突；SSH 连接需配置 5 秒一次的心跳，否则易超时断开；CodeBuddy CLI 硬编码认证目标为 codebuddy.ai，必须走中国站 OAuth，API KEY 会触发 401；另外，CNB AI Chat API 仅能做聊天补全，无法替代其执行 shell 的能力，需明确区分使用场景。