auto-account-machine/browser-automation-ts/QUICK-START.md

快速开始 - 5分钟运行你的第一个自动化

⚡ 3步开始

步骤1：安装依赖

cd browser-automation-ts
npm install

步骤2：复制配置文件

# 将windsurf.yaml复制到configs目录
cp ../src/tools/automation-framework/configs/sites/windsurf.yaml configs/sites/

步骤3：运行！

# 设置必需的环境变量
export ADSPOWER_USER_ID=your-profile-id
export WINDSURF_EMAIL=your-email
export WINDSURF_PASSWORD=your-password

# 执行自动化
npm run run -- windsurf

---

🎯 就是这么简单！

你刚才做了什么：

1. ✅ 安装了TypeScript自动化框架
2. ✅ 使用了旧框架的YAML配置（完全兼容）
3. ✅ 运行了完整的Windsurf自动化流程

---

📖 添加新网站（1分钟）

1. 创建YAML配置

# 创建新网站配置
cat > configs/sites/mysite.yaml << EOF
site: mysite
workflow:
  - action: navigate
    url: https://mysite.com
  - action: click
    selector: "#login"
  - action: fillForm
    fields:
      email: "{{account.email}}"
      password: "{{account.password}}"
EOF

2. 设置账号信息

export MYSITE_EMAIL=your-email
export MYSITE_PASSWORD=your-password

3. 执行

npm run run -- mysite

---

💡 核心概念

通用执行器

• 1个工具，运行所有网站
• 只需编写YAML配置
• 不需要编写代码

工作流程

YAML配置 → 加载 → WorkflowEngine → AdsPower → 浏览器自动化

配置即代码

workflow:
  - action: navigate    # 导航
  - action: click       # 点击
  - action: fillForm    # 填表
  - action: verify      # 验证

---

🔍 查看更多

• 📚 完整文档：HOW-TO-USE.md
• 🏗️ 架构说明：docs/ARCHITECTURE.md
• 📦 迁移进度：MIGRATION-PROGRESS.md

---

⚙️ 环境变量说明

必需

ADSPOWER_USER_ID=xxx    # AdsPower配置ID

账号信息（按网站）

WINDSURF_EMAIL=xxx
WINDSURF_PASSWORD=xxx

STRIPE_EMAIL=xxx
STRIPE_PASSWORD=xxx

# 规则：网站名_字段名（大写）

---

🎉 恭喜！

你已经掌握了新框架的使用方法！

现在可以：

• ✅ 复用旧框架的所有YAML配置
• ✅ 添加新网站只需创建YAML
• ✅ 享受TypeScript的类型安全
• ✅ 使用9个完整迁移的Action类

开始自动化吧！ 🚀