wenjunduan /athena-vm — VM 运行时接入 (v9.9.0)
为什么存在
runtime-verify 的"不同环境"此前只有本机 (空库/满库/慢网络都是模拟). 真实 VM 提供:
- 干净环境 (无本机全家桶依赖) 暴露隐式依赖
- 真实 Linux 发行版 / 版本差异 (本机 macOS ≠ 生产 Ubuntu)
- 破坏性测试的隔离沙箱 (敢 rm 敢压测)
配置文件: ~/.athena/vm.json (chmod 600)
不放 .ai_state/ — 那是项目级、会进 git 的目录. 凭证类配置一律全局 + 600 权限.
{
"version": 1,
"vms": [
{
"name": "dev-vm",
"host": "192.168.1.100",
"port": 22,
"user": "athena",
"auth": { "method": "key", "key_path": "~/.ssh/athena_vm" },
"os": "ubuntu-24.04",
"workdir": "/home/athena/work",
"purpose": ["runtime-verify", "e2e"],
"limits": { "max_session_minutes": 30 }
}
]
}
auth 两种形态 (key 优先):
| method | 字段 | 说明 |
|---|---|---|
key (推荐) |
key_path |
setup 引导跑一次 ssh-copy-id, 之后零交互 |
password_env (降级) |
password_env: "ATHENA_VM_PW" |
存环境变量名, 不存密码本身; 需要 sshpass, 丑但可用 |
❌ 禁止: "password": "明文" — setup 和 doctor 见到该字段直接报错拒绝工作. 配置文件会被 cp、会被 subagent 读、可能被误提交, 明文密码进 JSON 没有借口.
setup (一次性)
mkdir -p ~/.athena && chmod 700 ~/.athena
# 1. 收集: name / host / port / user (问用户, 不猜)
# 2. 认证:
# key 路线 (推荐): 无 key 则 ssh-keygen -t ed25519 -f ~/.ssh/athena_vm -N ""
# 然后让用户自己跑 ssh-copy-id -i ~/.ssh/athena_vm.pub -p {port} {user}@{host}
# (这一步要输密码, 用户亲手输, agent 不经手)
# password_env 路线: 让用户在 shell profile 里 export ATHENA_VM_PW=...; 检查 sshpass 已装
# 3. 写 ~/.athena/vm.json (上面 schema) && chmod 600 ~/.athena/vm.json
# 4. 写 SSH 别名 (权限面收窄的关键 — settings.json 只放行 athena-vm-* 前缀):
cat >> ~/.ssh/config << EOF
Host athena-vm-dev-vm
HostName 192.168.1.100
Port 22
User athena
IdentityFile ~/.ssh/athena_vm
StrictHostKeyChecking accept-new
ConnectTimeout 10
EOF
# 5. 项目内: 更新 .ai_state/_index.md tools_available.vm_available: true
password_env 路线的连接姿势: sshpass -e ssh athena-vm-{name} '...' (sshpass -e 读 SSHPASS 环境变量:
执行前 export SSHPASS="$ATHENA_VM_PW". 密码始终只在环境变量里, 不进命令行参数不进文件).
doctor (连通自检, 进 runtime-verify 前跑)
ssh athena-vm-dev-vm 'echo ATHENA_VM_OK && uname -a && df -h /tmp | tail -1'
# 期望: ATHENA_VM_OK + 系统信息. 失败 → vm_available=false, runtime-verify 降级回本机模拟
在 runtime-verify 中使用 (环境矩阵)
| 环境 | 何时用 | 姿势 |
|---|---|---|
| 本机 | 默认, 快速迭代 | 直接跑 |
| 远程 VM | vm_available=true 时 System/Refactor 建议必跑一轮; 依赖敏感 / 破坏性场景 | ssh athena-vm-{name} 'cd {workdir} && ...' |
- 代码同步: VM 侧
git clone/pull拉最新 commit, 或rsync工作区 (小改动); 注意git push受 stage 门禁 - 证据规则不变: ssh 命令 + 远端输出原样晒进 transcript (/goal supervisor 只认演示)
limits.max_session_minutes是预算护栏 (Loop Readiness 第 2 问), 超时中断并记录
不做
- ❌ 不当部署工具 (VM 是验证环境, 不是生产; 部署是 ship 之后人的决定)
- ❌ 不存明文密码 (见上, 硬拒绝)
- ❌ 不放行裸
ssh *权限 (只放athena-vm-*别名前缀, 见 settings.json) - CX 端注: Codex Remote 已 GA + DigitalOcean Droplet Workspace 插件是原生远程路径, 本 skill 的 ssh 别名方案两端通用; CX 原生方案作为增强可选