核心用法
Perry Coding Agents 是一套基于 Tailscale 网络的远程编码工作流系统，核心能力是将开发任务分发到隔离的云端工作空间执行。主要组件包括：
- OpenCode：主力编码智能体，支持一次性任务和后台运行，提供 Web UI (4096端口)
- Claude Code：备用智能体，适合需要其特定能力的场景，需 TTY 交互
- Perry Workspaces：基于 Tailscale 的隔离开发环境，通过 SSH 访问
标准工作流程遵循"分发→调度回检→完成"模式：创建/复用工作空间 → 配置唤醒回调 → 分发任务 → 设置备用定时检查 → 完成后清理。
显著优点
1. 完全隔离的执行环境：每个任务运行在独立工作空间，避免本地环境冲突
2. 异步非阻塞协作：任务后台运行，通过 webhook 唤醒通知，无需持续等待
3. 规模化并行处理：支持批量 PR 审查、多 Issue 同时修复（"Army Mode"）
4. 安全网络架构：基于 Tailscale 的私有网络，无需暴露公网端口
5. 灵活的智能体选择：OpenCode 适合自动化任务，Claude Code 适合复杂交互场景
潜在局限
1. 网络依赖性强：完全依赖 Tailscale 连通性，MagicDNS 在容器内不可用需使用 IP
2. 回调配置复杂：唤醒机制需动态获取 IP、配置 Token，存在失败风险
3. 调试门槛较高：SSH 非登录 shell 不加载 .bashrc，需使用完整路径
4. 无持久化状态监控：依赖外部 cron 作为备用检查，缺乏原生任务状态追踪
5. 资源管理成本：需手动清理任务专用工作空间，并行任务多时管理负担增加
适合人群
- 需要处理大量 PR/Issue 的维护者和团队 Tech Lead
- 希望在安全隔离环境执行不可信代码的安全敏感开发者
- 追求异步工作流、不愿被长时任务阻塞效率的工程师
- 已采用 Tailscale 作为基础设施的远程/分布式团队
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 网络隔离失效 | Tailscale 连接中断导致无法访问工作空间 | 使用 `tailscale ping` 预检，准备 fallback IP |
| 任务丢失 | 唤醒回调失败且 cron 未触发导致任务悬停 | 严格执行"分发必设 cron"规则，20分钟兜底 |
| 敏感信息泄露 | Token 在 SSH 命令中暴露 | 优先使用环境变量或配置文件注入 |
| 资源残留 | 忘记清理临时工作空间造成浪费 | 建立"创建即标记清理"的工作习惯 |
| 路径错误 | 误用 `/workspace` 而非 `~/<projname>` | 文档强制标注，复制粘贴安全命令 |
安全等级说明
本技能涉及远程代码执行和 SSH 网络操作，但未要求用户提供敏感凭证，主要依赖用户已配置的 Tailscale 网络。风险可控在基础设施层，智能体运行在用户自有隔离环境。