Perry Coding Agents

🛠️ 远程编码代理一键调度

通过SSH远程调度OpenCode/Claude Code代理执行编码任务,支持后台异步运行与会话复用,适用于隔离环境的开发、PR审查等场景。

收藏
9.5k
安装
3.9k
版本
1.3.0
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

核心用法

Perry Coding Agents 是一种远程编码代理调度机制,允许用户通过SSH将开发任务分派至隔离的Perry工作空间,由OpenCode或Claude Code自动执行。核心工作流为:获取Tailscale IP → SSH远程执行 → 后台异步运行 → 任务完成回调通知。

显著优点

  • 无阻塞后台执行:任务以&后台模式运行,无需等待完成,适合长时编译、测试等场景
  • 会话上下文保持:OpenCode在~/.opencode/持久化状态,同一项目可复用会话延续上下文
  • 双代理支持:OpenCode为默认主力,Claude Code提供TTY交互式备选方案
  • 自动化回调机制:支持通过HTTP webhook在任务完成时触发外部通知
  • 安全网络接入:基于Tailscale私有网络,避免公网暴露

潜在缺点与局限性

  • MagicDNS失效:必须使用IP直连,增加配置复杂度
  • 无内置超时控制:依赖外部机制监控,可能产生僵尸进程
  • TTY限制:Claude Code需-t参数,与后台&模式冲突,无法真正后台化
  • 令牌管理负担:webhook需手动配置token,存在泄露风险
  • 调试困难:异步执行导致实时日志获取不便
  • 单任务串行:同一PR需顺序执行,无法并行多任务

适合人群

  • 需要隔离开发环境的远程团队协作
  • 追求"提交即走"异步工作流的开发者
  • 已有Tailscale基础设施的Perry平台用户
  • 熟悉SSH/命令行的高级技术人员

常规风险

  • SSH密钥泄露StrictHostKeyChecking=no降低MITM防护
  • 命令注入:任务字符串拼接存在shell注入漏洞
  • 令牌暴露:hooks token以明文形式出现在命令行,可被进程列表窥探
  • 权限边界模糊workspace用户权限范围未明确,可能越权访问
  • 网络可达性依赖:Tailscale故障将导致整个工作流中断

安全解读

核心用法

Perry Coding Agents 是一套基于SSH的远程任务调度方案,用于在隔离的Perry工作空间中运行OpenCode或Claude Code代理。核心工作流包括:通过tailscale status获取工作空间IP,使用SSH非交互式或交互式TTY连接执行命令,并通过webhook回调通知任务完成。

显著优点

  • 无状态管理负担:利用OpenCode的~/.opencode/持久化上下文,支持跨会话记忆
  • 真正的异步执行:后台&启动,不阻塞主流程,适合长时间构建/测试任务
  • 安全隔离:Tailscale网络+独立工作空间,天然的网络层隔离
  • 双引擎支持:OpenCode适合批量脚本任务,Claude Code支持交互式TUI场景

潜在局限

  • 网络依赖刚性:MagicDNS故障时必须使用硬编码IP,增加运维复杂度
  • 调试链路长:远程执行时错误定位需多跳排查(本地→Tailscale→SSH→容器内代理)
  • 会话管理弱:"same session continues until done"依赖人工判断CI状态,无自动超时保护
  • T3来源风险:维护者为个人/社区身份,长期维护承诺未验证

适合人群

  • 已部署Tailscale网络的远程开发团队
  • 需要GPU隔离环境进行AI辅助编程的用户
  • 习惯"fire-and-forget"异步工作流的高级开发者

常规风险

  • SSH密钥泄露可导致工作空间完全沦陷(StrictHostKeyChecking=no降低MITM防护)
  • webhook端点若暴露在公网可能遭受回调轰炸
  • 长期使用同一IP可能因Tailscale重分配导致调度失败

Perry Coding Agents 内容

手动下载zip · 1.2 kB
SKILL.mdtext/markdown
请选择文件