🚀 快速上手教程 (Quick Start)

欢迎使用 Telegram 乌鸦全自动矩阵营销系统！本文档将引导您在 5 分钟内完成环境准备、全局设置与首个营销任务的启动。

---

一、 系统环境要求

1. 操作系统：Windows 10 / 11 64位 或 Windows Server 2019+。
2. 本地网络：确保本地具备访问 Telegram 官方 API 接口的网络环境（或准备好充足的 Socks5/HTTP 优质原生代理）。
3. 服务状态：确保后端主控服务已启动（默认监听端口 777）。

极速自检

在浏览器地址栏输入 http://127.0.0.1:777，若能正常出现登录主页，说明主控核心服务工作正常。

---

二、 核心五步快速获客闭环

flowchart LR
    S1["1. 全局环境设置<br>(settings)"] --> S2["2. 导入/注册账号<br>(registrator)"]
    S2 --> S3["3. 精准目标采集<br>(parsing)"]
    S3 --> S4["4. 营销投放裂变<br>(send / invite)"]
    S4 --> S5["5. 导出效能报表<br>(stat_generator)"]

第一步：配置全局网络与安全基线 (settings)

1. 进入左侧导航栏 「设置 -> 全局设置」 (settings.html)。
2. 检查并确认以下风控黄金参数：
   • 连接超时：10 秒
   • 代理模式：s-w (软件内置代理池)
   • 代理匹配：phone (严格保证印尼号走印尼IP，美国号走美国IP)
   • 智能防机器人：保持勾选状态 (true)
   • 最大等待限制：80 秒
3. 点击页面底部 「保存配置」。

---

第二步：导入或协议注册账号资产

• 已有 Session/TData 账号：进入 accounts.html，点击顶部「导入账号」，将账号文件夹拖入即可；
• 全新自动接码协议注册：进入 registrator_herosms.html 或 registrator_5sim.html，填入接码平台 API Key，选择目标国家与运营商，点击「开始注册」，系统全自动接码、生成真实设备指纹并持久化保存。

---

第三步：采集高意向目标客户 (parsing)

1. 进入 「采集 -> 群成员采集」 (parsing.html)；
2. 输入竞品或行业公开群链接（如 https://t.me/crypto_discussion）；
3. 勾选 「仅采集近期在线活跃用户」（过滤僵尸粉与死号）；
4. 点击「开始采集」，采集完成后可在当前页面直接导出 usernames.txt。

---

第四步：启动多维触达 (stories_public / invite_admin_auto)

• 安全防封推荐（快拍艾特营销）：进入 stories_public.html，上传业务宣传图片，开启「@标记用户」，粘贴采集的用户名单，全自动发布快拍强制弹窗强提醒；
• 极速拉人（管理员拉群）：进入 invite_admin_auto.html，输入自己的公开或私有群链接，导入目标用户，系统全自动避开机器人，极速拉人入群。

---

第五步：查看任务执行报表 (stat_generator)

1. 任务完成后，进入 「统计 -> 报表生成器」 (stat_generator.html)；
2. 选择本次任务生成的数据库文件（位于 additives/ 目录下）；
3. 勾选 「仅导出成功记录」，点击生成；
4. 系统将即刻生成一份包含完整数据指标的可视化独立 HTML 报告，双击即可直接在浏览器中打开复盘或向上级汇报。