jiyangnan/AgentMesh-Deploy-Agent

AgentMesh Deploy

Independent deployment operations for AI coding agents.

AgentMesh Deploy 是一个独立的发布运维 CLI。它接手任意 Git 产品仓库，分析技术栈，生成供应商计划， 在明确审批后创建候选资源、部署应用、迁移数据库、配置 DNS 与邮件域名，并保存可恢复的执行证据。

产品官网：<https://deploy.agentmesh360.com/

为什么是独立运维 Agent

AgentMesh Deploy 不作为 Sidecar 写进产品仓库。产品代码默认只读，部署契约、审批、Secret Ref、 供应商状态、不可变 Receipt 和恢复记录都保存在独立控制目录中。

flowchart LR
  OWNER["产品负责人<br/>批准费用与高风险操作"] --> AMD["AgentMesh Deploy<br/>独立 CLI / 运维 Agent"]

  A["产品 A<br/>默认只读"] --> AMD
  B["产品 B<br/>默认只读"] --> AMD
  C["产品 C<br/>默认只读"] --> AMD

  AMD --> HOME["外部 Control Home<br/>Project / Plan / Approval / Evidence / Run"]
  AMD --> PROVIDERS["Provider API / CLI<br/>Runtime / Database / DNS / Email / CI"]
  AMD -.-> PATCH["需要改代码时<br/>只生成 Patch / PR 建议"]

这意味着同一个 Agent 可以连续接管多个产品，而不会把 AgentMesh Deploy 的状态、工作流或凭证写入 这些产品的 Git 工作区。

核心能力

• 仓库分析：锁定 Git Commit，在隔离 Checkout 中识别框架、构建命令、环境变量与部署形态。
• 供应商编排：从 Launch Graph 自动编译 Provider Adapter Plan，无需手写供应商动作 JSON。
• 候选优先：先创建 Sandbox/Candidate，验证通过后才允许生成生产 DNS ChangeSet。
• 数据库保护：Schema 检查、迁移分类、Snapshot/Backup Evidence、事务执行和恢复边界。
• DNS 与邮件联合流程：Cloudflare 精确记录集与 Resend Domain Intent、Verify/Poll 联合编排。
• 人工审批：费用、购买、迁移、邮件身份、生产切流和删除动作保持显式授权。

• 中断恢复：Intent 先落盘，Receipt 后记账；Resume 优先接管已发生事实，不盲目重放 Mutation。
• Secret 隔离：只持久化 env://、keychain://、op:// 或自定义 secret:// 引用。

支持的核心供应商

| 领域 | 供应商 | 当前能力 | | --- | --- | --- | | 前端与 Serverless | Vercel | Project、构建配置、文件制品、Preview Deploy、Poll | | 应用运行时 | Railway | Project、Environment、Service、Service Domain、Candidate Deploy | | PostgreSQL | Neon | Project、Branch、Schema、Snapshot、Migration、连接 Secret Sink | | 托管后端 | Supabase | Organization、Project、健康检查、Runtime Credentials | | DNS | Cloudflare | Zone 接管、不可变 DNS ChangeSet、精确 Create/Update、回滚证据 | | 事务邮件 | Resend | Domain、DNS Intent、Verify/Poll、受控发送与交付验证 |

旧版 Manifest 执行器还包含 Docker/Caddy、DigitalOcean、GitHub Actions、Cloudflare Workers/D1/R2/KV 等迁移期能力；新的项目级 First Launch 工作流以独立 V2 控制平面为主。

发布链路

flowchart TD
  A["注册产品仓库"] --> B["隔离分析锁定 Commit"]
  B --> C["生成 Manifest + Launch Graph"]
  C --> D["检查供应商连接与 Secret Ref"]
  D --> E["生成 Candidate Adapter Plan"]
  E --> F{"Sandbox Profile<br/>Approval<br/>Preflight"}
  F -->|未批准| STOP["停止并返回明确下一步"]
  F -->|已批准| G["执行候选资源与部署"]
  G --> H["产品验证 + 数据库证据"]
  H --> I{"生产切流审批"}
  I -->|拒绝| KEEP["保留候选环境"]
  I -->|批准| J["DNS / 邮件验证 / 生产检查"]

## 安装

### GitHub Release

需要 Node.js 20 或更高版本，以及已登录的 GitHub CLI：

releasedir="$(mktemp -d)" gh release download v0.2.0 \ --repo jiyangnan/AgentMesh-Deploy-Agent \ --pattern 'agentmesh-deploy-.tgz' \ --pattern 'SHA256SUMS' \ --dir "$releasedir" (cd "$releasedir" && shasum -a 256 -c SHA256SUMS) npm install --global "$releasedir"/agentmesh-deploy-.tgz agentmesh-deploy version