云展 Vela

Remote Terminal-Agent Console · 系统架构

以星导航，远程掌控你电脑/服务器上的 claude code、hermes 等终端 AI agent。逆向自 @agentdock/daemon · wire · crypto · sdk @0.0.47 与官方前端 bundle，端到端加密，自建中继与控制台。

已复刻并实测可运行 部分 / 最小可用 暂未复刻
壹 · 三端架构

🖥 被控端

@agentdock/daemon · 你的电脑/服务器

CLI + 守护进程
cli · daemonLoop · lock✓
Agent 控制 ACP
acp · transport · agentSpawn✓
claude/hermes/codex/copilot…✓ 实测
配对 / 加密
pairing · keyManager · envelope✓
143 模块逐字节还原 · tsc 0 错误 · 关键模块对抗审计 0 漂移
Socket.IO · 密文

☁ 中继服务器

自建 Node+socket.io · 代 agentdock-api

配对 / 认证
/v1/pairing · /v1/auth (Ed25519)✓
网关
连接认证 · 房间路由✓
RPC 转发 · 密文中转(不解密)✓
定时任务 · agent设置 · 用量✓ 新增
存储
内存 store◐ 需换 DB
无官方源码，按协议反推全新实现。E2E 下服务器只搬密文，复杂度集中在协议正确性。
Socket.IO · user

📱 控制台 · 云展

自建 React+Vite · 你最终用的入口

核心 · 已实测
配对(扫码+PIN+Box加密)✓
会话列表 + 终端视图✓
全 SessionEvent 渲染✓
权限审批 / 问答 / 中断✓
定时任务 · 设置 · 活动✓
设计
Vela 深空设计系统✓ 重做
暂未做
PWA + Web Push 推送○
🔐 E2E 加密边界：明文只存在于「被控端 Agent 子进程」与「控制台」两头 · 中继服务器全程只搬运 AES-256-GCM 密文，永远解不开
贰 · 远程控制闭环（已实测打通）
  控制台 · 云展                   中继服务器                    被控端 daemon
       │                              │                              │
  ① 生成 Box 密钥 ──/pairing/request──▶ 存 PIN ◀──────── ccpark pair ─┤
  ② 输 PIN · 生成 masterSecret         │                              │
     Box 加密 ──/pairing/deliver──────▶ 暂存密文 ──轮询 status───────▶ decryptBox 恢复根
  ③ ───── Socket.IO 连接(user) ───────▶ 房间路由 ◀── Socket.IO(machine)─┤ register
  ④ 点击 Spawn claude ──rpc-call───────▶ 查机器房间 ──rpc-request──────▶ spawnSession → 子进程
       │ ◀──────── ack {sessionId} ────┤◀────────── ack ──────────────┤
  ⑤ DEK 解密 ◀── message(密文) ──── 存储+转发 ◀── envelope 加密(DEK) ── claude 输出
     渲染终端流(text/工具/审批/turn)    │                              │
  ⑥ 批准/拒绝/回答 ──rpc-call─────────▶ 转发 ──rpc-request──────────▶ acp.resolvePermission

✓ Puppeteer + browser-agent 真实浏览器实测：填 PIN → 连接 → spawn claude → 终端渲染思考/工具调用/权限审批/回复/回合用量，点「批准」后看到命令输出 total 24 · src/ · package.json 与 agent 回复。

叁 · 控制台功能（对照官方 console）

🔗 配对与设备

  • PIN 配对 /pair
  • 扫码配对（摄像头+QR，UI 就绪）
  • 设备管理 / 解绑 / 添加 settings

💬 会话与终端

  • 会话列表 + 活跃分组
  • 终端视图（全事件渲染）
  • spawn / 实时消息流
  • 发送回复 / Web 接管
  • 切换模式（UI 有，下拉）
  • 会话搜索 / 恢复

✅ 权限与决策

  • 权限审批 批准/拒绝
  • 批准本会话所有编辑
  • 问题回答 / 中断 / 停止

⏱ 定时任务

  • cron 任务列表 + 启停
  • 新建/删除（5字段校验）

⚙ 设置中心

  • 设备 · Agent 设置
  • 通知偏好 · 外观主题

📊 活动用量

  • 今日 token / 活跃会话
  • 按模型用量条

🔔 通知 PWA

  • 桌面通知开关（已有）
  • Web Push 推送（VAPID）
  • iOS 添加主屏

🏢 企业版

  • Provider/额度/许可证
  • 审计日志/遥测
肆 · 复刻进度
143
被控端模块全还原
46
SDK 三件套还原
3 端
全部自建可运行
~85%
控制台功能覆盖
组件状态说明
被控端 daemon + CLI✓ 完成143 模块逐字节还原，行为保真审计通过
wire / crypto / sdk✓ 完成46 模块还原，加密字节级互通
中继服务器✓ 可运行配对+认证+RPC路由+密文中转+定时/设置/用量；内存存储
控制台 · 云展 Vela✓ 可运行会话/配对/定时/设置/活动全实测；Vela 深空设计系统重做
控制台 · PWA 推送○ 暂缓Web Push、iOS 添加主屏（按需后续）

结论：「云展 Vela」三端全部自建可运行 —— 从浏览器远程拉起并掌控电脑上的 claude code / hermes，已实测打通。控制台核心功能完备并完成 Vela 深空设计系统重做。
暂缓：PWA 推送通知（不影响核心，按需再做）。
被控端 + SDK 为逐字节还原；服务器与控制台无官方源码，为协议兼容的等价实现。底层包/协议保持 agentdock 命名以兼容真实 daemon。