TanStarter CLI - 在 Cloudflare 上创建并启动 TanStarter 项目
TanStarter CLI 是一个用于创建生产就绪 TanStarter 应用并部署到 Cloudflare Workers 的命令行工具，约 10 分钟即可完成，支持 Waffo 支付集成、自定义域名、GitHub 仓库创建与资源清理。
社区作者 · zZz
它解决什么问题
TanStarter CLI 从 TanStarter 模板克隆并创建生产可用的应用，部署到 Cloudflare Workers，并自动完成 Cloudflare D1、R2、KV 资源配置、数据库迁移、Worker 密钥同步、GitHub 仓库创建及 GitHub Actions 密钥同步。支持交互式创建、非交互式创建（--yes）、恢复失败（--resume）、删除资源（delete），并可选用 Waffo 支付，自动创建商店、模板内建商品和 Webhook。
CLI 会检查 node、pnpm、git、gh 及 Cloudflare 凭据，缺失时尝试通过系统包管理器安装。项目采用 MIT 许可证。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
前置条件：
- Node.js 20 或更高版本；
- Cloudflare 账号，并在 shell 环境中设置 CLOUDFLARE_ACCOUNT_ID 和 CLOUDFLARE_API_TOKEN；
- GitHub 账号，并已通过 GitHub CLI（gh）认证；
- 若使用 Waffo，需在 Waffo 仪表盘（API & Development → API Keys）创建 Test API Key，并导出 WAFFO_MERCHANT_ID（MER_...）和 WAFFO_PRIVATE_KEY。
快速开始：
- 在终端中导出 Cloudflare 环境变量：
export CLOUDFLARE_ACCOUNT_ID="..."export CLOUDFLARE_API_TOKEN="..."- 运行创建命令：
npx tanstarter-cli@latest create按提示输入项目名称、资源名称、支付方式等信息。
- 若想保留支付询问但接受其他默认值，可运行：
npx tanstarter-cli@latest create my-app --yes全局安装：
- 安装：
npm install -g tanstarter-clitanstarter create
- 运行：
安装为 Agent Skill（Codex、Claude Code 等）：
npx skills add MkFastHQ/tanstarter-cli --skill tanstarter-create常用命令：
- tanstarter create [options]：创建项目；
- tanstarter create <project-name> --resume：从 .tanstarter/state.json 恢复失败的创建；
- tanstarter delete <project-name>：删除 CLI 创建的 Cloudflare 和 GitHub 资源。
选项：
- --domain <domain>：配置 Cloudflare 自定义域名路由；
- --payment <none|waffo>：为生成项目指定支付方式，waffo 会自动创建 Waffo 商店、商品和 Webhook；
- -y, --yes：默认情况下接受默认域名、资源名、GitHub 仓库和最终确认；
- --repo <owner/name>：指定要创建的 GitHub 仓库；
- --resume：继续失败的设置；
- -h, --help：显示帮助；
- -v, --version：显示版本。
示例： tanstarter create --domain app.example.com --repo mkfasthq/my-app
非交互式 Waffo 设置：
npx tanstarter-cli@latest create my-app --payment waffoCLI 会创建项目命名的商店和三个模板商品：Pro Monthly（$9.90）、Pro Yearly（$99.00）、Lifetime（$199.00），并将商品 ID 写入 VITE_WAFFO_PRODUCT_PRO_MONTHLY、VITE_WAFFO_PRODUCT_PRO_YEARLY、VITE_WAFFO_PRODUCT_LIFETIME。随后部署站点、同步 Worker 密钥、验证 URL、注册 Webhook。CLI 始终使用 Waffo 测试模式。
故障恢复：
tanstarter create my-app --resume
tanstarter delete my-app
- 如果项目目录创建后运行失败，修复问题后运行：
- 如需删除已创建的资源：