CNB CodeBuddy 远程操控

通过 SSH + PTY 远程控制 CNB 云原生环境中的 CodeBuddy CLI，实现非交互式任务下发和结果回收。

前置条件

1. CNB 云原生环境已创建，可通过 SSH 访问
2. CodeBuddy 已登录（OAuth 中国站扫码，token 持久化）
3. 本地机器有 SSH access 和 expect 工具

环境信息模板

每个 CNB 云原生环境需要记录：

SSH_HOST=<环境ID>@cnb.space
WORK_DIR=/workspace
WEBIDE=https://cnb-.cnb.space

工作流程

阶段一：环境准备（首次）

1. SSH 连接验证

ssh -o ConnectTimeout=10 -o ServerAliveInterval=5 -o ServerAliveCountMax=12  'echo OK'

2. 检查 CodeBuddy 状态

ssh  'which codebuddy; codebuddy --version'
ssh  'tcb ai --config'

3. CodeBuddy 登录（如未登录）

必须走中国站 OAuth，CLI 硬编码认证目标为 codebuddy.ai，API KEY 方案不可行（cn 站 key 全部 401）。

推荐方式：用户在 WebIDE 手动登录

1. 打开 WebIDE，在终端运行 tcb ai -a codebuddy
2. 选「Log in via Chinese Site」
3. 扫描 copilot.tencent.com/login?platform=CLI&state= 二维码
4. 登录成功后 token 自动持久化到 ~/.codebuddy/

自动登录脚本（需用户配合扫码）：

expect << 'EOF'
set timeout 180
spawn tcb ai -a codebuddy
expect -re {Do you trust}
send "r"
expect -re {Enter to confirm}
send "r"
expect -re {copilot.tencent.com/login}
# 提取 URL 通知用户扫码，等待回调
expect eof
EOF

4. 信任工作目录

首次启动 CodeBuddy 会询问是否信任目录，选「Trust folder and all subdirectories」。

阶段二：远程任务下发（日常使用）

方法 A：PTY 交互（推荐，实时可控）

步骤：

1. 启动 CodeBuddy（PTY 模式保持连接）：

ssh -o ConnectTimeout=10 -o ServerAliveInterval=5 -o ServerAliveCountMax=12 -t  'cd  && tcb ai'

2. 等待启动完成（约 15-20 秒），确认看到 GLM-5.1 和 ? for shortcuts

3. 用 process write 发送指令文本（纯文本，不含回车）：

process write sessionId="" data="read README.md and summarize it"

4. 用 process send-keys 发送回车（必须用 hex，不能用 write 发 r）：

process send-keys sessionId="" hex=["0d"]

5. 等待 CodeBuddy 处理（状态变化：waiting for model → streaming → mixing → 完成）

   • 简单文本回复：10-20 秒
   • 需要执行命令的：20-60 秒
   • 看到状态栏从 streaming · ↓ N tokens 恢复到 idle 表示完成

6. 如遇工具确认提示（Do you want to proceed?），自动选 "Yes, and don't ask again"：

process send-keys sessionId="" hex=["1b","5b","42"]  # Down arrow
# 等待 0.3 秒
process send-keys sessionId="" hex=["0d"]             # Enter

7. 读取结果：从 session log 中提取，清除 ANSI 码后即为纯文本

关键交互对照表：

状态栏含义：

方法 B：expect 脚本（无人值守）

使用 scripts/cb-remote.sh：

scp scripts/cb-remote.sh :/tmp/cb-remote.sh
ssh  'bash /tmp/cb-remote.sh "你的指令" [超时秒数]'

方法 C：nohup 后台（长时间任务）

ssh  'cd  && nohup expect /tmp/cb.exp "指令" > /tmp/cb-output.txt 2>&1 &'
# 稍后读取
ssh  'cat /tmp/cb-output.txt | sed "s/x1b[[0-9;]*[a-zA-Z]//g" | tail -30'

阶段三：结果回收

• PTY 模式：从 session log 提取，token 计数（↓ N tokens）表示输出量
• expect/nohup：SSH 读取输出文件
• ANSI 清理：sed "s/x1b[[0-9;]*[a-zA-Z]//g; s/]8;;[^]]*]//g"

故障排查

注意事项

• 一次只能一个 CodeBuddy session，多实例会冲突
• SSH 有超时，keepalive 必须 5 秒一次
• CodeBuddy 基于 ink 框架，键盘事件必须用 hex 精确控制
• 必须走中国站（codebuddy.cn/copilot.tencent.com）
• CNB AI Chat API 不可替代：只做聊天补全，不能执行 shell
• Token 持久化：OAuth 登录后 token 存在 ~/.codebuddy/，重启环境不丢失