SuperAPI AI 工具集

replica-deploy

部署与运维

查看项目

更新于 10-15 12:43

技能介绍

用途

replica-deploy 用于把一个应用克隆版本真正发布到用户自己的域名上,并配套建立生产环境所需的数据库、支付、认证、邮件、托管与监控设施。它读取 replica/ 目录中的全部内容,并写出 replica/deploy.md,该文件是本目录下 preflight.md 清单的填写版本。

核心规则

  • 未经用户同意,任何内容都不会上线。需要先展示预检结果并询问用户。
  • 购买与登录由用户完成。Claude 不会购买域名、输入银行卡、输入密码或粘贴真实密钥;Claude 只写出确切的 DNS 记录、环境变量名与命令,账户层面的操作由用户执行。
  • 品牌替换扫描必须干净,否则不允许上线,没有例外。

使用方式

步骤一:预检

运行每一项检查并把结果粘贴进 deploy.md:

npx playwright test                                                  # replica-test
python3 ../replica-diff/parity.py replica/features.csv               # must-haves done
python3 ../replica-brand/sweep.py . --config replica/brand.json      # exit 0: clean
python3 ../replica-launch/listing.py replica/launch/listing.json     # if shipping to stores
npm run build                                                        # production build passes

路径相对于技能包的安装位置。若安装在 ~/.claude/skills/ 下,则对应为 ~/.claude/skills/replica-diff/parity.py 等。

此外还需人工确认:没有未解决的 S1 或 S2 缺陷;隐私政策与条款页面已上线并列出所有处理方;如在欧盟或英国使用非必要 Cookie 则需有 Cookie 横幅;账户删除功能可用;favicon、标题与 OG 图片均为自己的。任何失败都会停止部署,并说明是哪一项以及原因。

步骤二:生产服务

  • 数据库使用独立的生产项目,绝不使用开发库;开启备份;迁移由部署执行而非手动运行。
  • 在托管平台设置生产环境变量,与 .env.example 保持一致;真实密钥只能在这里使用。
  • Stripe:切换到实时模式,重新创建产品与价格,添加生产 webhook 端点及其签名密钥,测试一次真实购买并退款。
  • OAuth:把生产域名加入每个提供方的重定向 URI 与授权来源。需要验证的 Google 作用域必须获得批准,否则只有测试用户可以登录。
  • 邮件:在邮件服务商处验证发信域名。

步骤三:托管与域名

默认使用 Vercel 托管 Next.js(其他情况用 Netlify、Cloudflare Pages、Fly 或 Render)。连接仓库,使 main 分支自动部署且拉取请求获得预览 URL。

域名由用户在任何注册商处购买后配置:

record name value
A @ 托管商的 apex IP(Vercel 在域名设置中显示)
CNAME www 托管商的目标(Vercel:cname.vercel-dns.com)
TXT @ 或子域名 托管商要求的验证值(如有)

邮件 DNS 由邮件服务商提供:SPF(TXT)、DKIM(CNAME 或 TXT),以及 DMARC 记录,先设为 v=DMARC1; p=none; rua=mailto:you@yourdomain,待报告干净后再收紧为 quarantine。缺少这些,确认邮件会进入垃圾箱。

选择一个规范主机(apex 或 www),把另一个重定向过去。上述托管商的 HTTPS 是自动的,但仍需检查。

步骤四:监控

错误追踪(Sentry 或托管商自带)、对首页与核心流程 API 的可用性检查、保留日志、分析(使用隐私友好的分析可避免 Cookie 横幅),以及向用户邮箱或手机发送警报。随后自己在线执行一次核心流程,并请用户在自己的手机上再执行一次。

步骤五:移动端(如有 App)

Expo:运行 eas build 再运行 eas submit 提交到 TestFlight 与 Play 内部测试。原生:在 Xcode 中归档并上传到 App Store Connect;用 Gradle 打出 bundle 上传到 Play Console。开发者账户归用户所有(Apple 每年 99 美元,Google 一次性 25 美元)。先进入 Beta,再使用 replica-launch 的列表进行审核。

输出

replica/deploy.md,包含每一项检查及其结果、线上 URL、已设置的 DNS 记录,以及第一周需要关注的内容。此时克隆版本已成为带有用户名字的应用。

适用场景与限制

适用于需要把克隆应用正式发布到自有域名的场景。上述收费信息仅涉及 Apple 与 Google 开发者账户,其余涉及费用、平台或效果的内容暂未提供。