连接模型

Hub / Relay 架构（0.2.0 起）

Paseo daemon 不监听公网端口——它启动后主动向外建两条连接：

daemon ──WebSocket 控制面──▶ Hub（ginit 服务端：任务分派、设备管理）
daemon ──TLS 数据面────────▶ Relay（会话流转发给各端客户端）

好处：任意一台内网机器（无公网 IP、不开 SSH）装上 ginit 就能挂进 Paseo 体系；0.1.x 的「外部直连 daemon」部署方式已废弃（PASEO_LISTEN_ADDR 配置项随之移除）。

默认走公网 Relay，自建 Relay 用环境变量切换（见配置参考）。

CLI 日常操作

agent 的启动、查看、跟进全在 paseo 命令里：

paseo run --provider claude/opus-4.6 "实现用户认证"

paseo run --provider codex/gpt-5.4 --worktree feature-x "实现 feature X"

paseo ls

paseo attach abc123

paseo send abc123 "补充一下测试"

指定远程 daemon（比如你挂进 Paseo 的另一台机器）：

paseo --host workstation.local:6767 run "跑全量测试"

会话自动归档

ginit paseo install 写入的 Claude Stop hook（~/.local/share/paseo-hooks/paseo-auto-import.sh）在每次会话结束时把转录自动导入 Paseo，在任意客户端可回看——不用手动上传。

Skills（agent 编排）

把 Paseo 编排技能装进 agent 会话：

npx skills add getpaseo/paseo

之后任何 agent 对话里可用：/paseo-handoff（agent 间接力，比如 Claude 规划 → Codex 实现）、/paseo-loop（按验收标准循环执行）、/paseo-advisor（旁路顾问）、/paseo-committee（双 agent 对照复盘）。