SuperAPI AI 工具集

remote-agents

部署与运维

查看项目

更新于 10-16 05:02

技能介绍

用途:本技能充当本地管理器,管理运行编码代理的专属远程主机,涵盖主机开通、传输、存储、桌面、证据与清理。代理执行通过 porch(pragmatic-orchestration 技能)在主机上进行,支持其任意后端;另有可选的持久化受管工作进程守护程序和手机可见的 Codex Remote 线程,不得混为一谈。

主要能力与用法:生命周期命令通过本技能目录的 scripts/host.sh 执行,主机身份来自 config.json(复制 config.example.json 或设置 REMOTE_AGENTS_CONFIG),用 --host <id>、REMOTE_AGENTS_HOST 或 defaultHost 选择主机。常用命令包括:./scripts/onboard.py check(就绪矩阵)、./scripts/host.sh status(实例状态与 SSM 可达性)、start|stop|restart、ssh(基于 SSM 的交互式 SSH)、run '<cmd>'(一次性远程命令)、audit(Windows 工作根布局审计)、以及 desktop 系列与 work-bridge.py 的 SMB 挂载命令。SSH 走 AWS Systems Manager Session Manager;唯一允许的入站规则是工作桥的 WireGuard UDP 端口,禁止向互联网开放 TCP 22、3389、445。开发机可为 macOS、Linux 或 Windows 11,脚本通过 scripts/lib/devlocal.py 自动检测操作系统。

适用场景:按任务路由,例如新主机端到端开通、主机开通与加固、配置主机身份、SSH 与文件传输及 SMB 挂载、在主机上运行代理、Linux/Windows 主机运维、无头交互桌面、GUI/视觉 QA、工作根布局审计、持久化工作进程集群、手机可见 Codex 线程、威胁模型与故障排查。

限制与操作约定:行动前先解析主机,不得猜测 id;先跑 host.sh status,启动已停止主机并等待 SSM;远程工作进程需给出完整契约(目标、远程绝对 cwd、上下文、范围、约束、验证、交付物);长时间任务须分离启动以免 SSH 断开导致终止,并记录 run id 与游标;以远程文件、差异、测试、产物独立验证结果,工作进程报告只是声明而非证据;结束前清理 runs、workspaces、计划任务并卸载桥接。安全不变量:控制面不公开暴露,仅 SSM;远程工作进程拥有主机用户完整权限,VM/账户是边界而非提示词;仅公钥 SSH,administrators_authorized_keys ACL 锁定,开启 Defender;密钥不得出现在提示词、包或仓库中,.bridge-state/ 保持本地 0700 且不提交;GUI 进程仅经计划任务助手中启动,进程启动不等于 UI 就绪,需探测检查。其他细节见各参考文档。