🔑 一、Telegram API 申请攻略
使用本工具需要为每个Telegram账号申请 API ID 和 API Hash。这是Telegram官方提供的开发者凭证，每个账号只需申请一次，永久有效。
它们是Telegram官方分配给每个账号的开发者标识，用于让第三方程序（如本工具）通过合法接口与Telegram通信。申请过程完全免费，不会影响账号正常使用。
申请步骤
打开 Telegram API 官网
在浏览器中访问 https://my.telegram.org ，使用你要申请的Telegram账号的手机号登录。
输入手机号
在页面中输入你的Telegram注册手机号（需包含国家代码，如 +8613800138000），点击"Next"。
输入验证码
Telegram会向你发送一条消息，内含登录验证码。在网页中输入该验证码完成登录。
点击 "API development tools"
登录成功后，页面会显示两个选项。点击 "API development tools" 进入开发者申请页面。
填写应用信息
如果是第一次进入，需要填写应用信息表单：
获取 API ID 和 API Hash
提交后，页面会显示你的 App api_id（一串数字）和 App api_hash（一串字母数字混合）。请务必复制保存好！
页面上你会看到类似这样的信息：
App api_id: 28547392
App api_hash: 09a5c4f8b3e2d1a6f7c9b0e3d4a5b6c7
- 每个手机号只能申请一次，申请后永久有效，不需要重复申请
- API ID 是纯数字，API Hash 是字母数字混合字符串，两者不要搞混
- 请勿将 API ID 和 API Hash 分享给他人，这等同于你的账号密钥
- 如果提示 "too many attempts"，等待几小时后再试
📄 二、账号文件格式说明
准备一个 .txt 文本文件，每行一个账号，格式如下：
字段说明
| 字段 | 说明 | 示例 |
|---|---|---|
| 手机号 | 带国家代码的完整手机号 | +8613800138000 |
| API_ID | 纯数字，从 my.telegram.org 获取 | 28547392 |
| API_HASH | 字母数字混合字符串 | 09a5c4f8b3e2d1... |
| 代理（可选） | 第4列，不填则用本地网络 | socks5://user:pass@IP:端口 |
- 每行一个账号，用英文逗号分隔（不要用中文逗号）
- 手机号必须带
+号和国家代码 - API_ID 必须是纯数字，不要加引号
- 不需要代理的账号只写前3列即可
- 建议准备 3-5 个账号轮换使用，降低风控风险
👥 三、群组文件准备
准备一个 .txt 文本文件，每行一个Telegram群组链接：
群组链接类型说明
| 链接类型 | 格式 | 处理方式 |
|---|---|---|
| 公开群 | https://t.me/groupname | ✅ 免加入，直接发送消息 |
| 私密群（邀请链接） | https://t.me/+xxxxx | ✅ 自动加入群组后发送 |
| 私密群（旧格式） | https://t.me/joinchat/xxxxx | ✅ 自动加入群组后发送 |
| 用户名 | @channelname | ✅ 免加入，直接发送消息 |
🌐 四、代理配置（可选）
如果你的账号需要通过代理连接Telegram，可以在账号文件第4列添加代理地址。支持 SOCKS5 和 HTTP 代理。
📝 五、文案管理与派发策略
文案池
点击程序中的 "⚙️ 点击管理长文案矩阵池" 按钮，可以添加多条营销文案。程序支持两种派发策略：
| 策略 | 说明 | 适用场景 |
|---|---|---|
| 随机轮询发送 | 每次发送随机从文案池中选一条 | 避免内容重复，降低风控 |
| 顺序循环发送 | 按顺序依次发送，循环使用 | 有明确的内容排期计划 |
🚀 六、完整操作指南（三步向导）
准备工作（开始前完成）
准备两个 txt 文件
按第二节格式创建 account.txt（手机号 + API ID + API Hash + 可选代理），按第三节格式创建 groups.txt（每行一个群组链接）。放在任意目录即可。
第 ① 步：卡密激活
输入卡密激活
双击 PigTGMarketing.exe 启动。程序会先自动检查更新，然后进入第一步。把客服给你的卡密粘贴到输入框，点击 「激活」。
激活成功后卡密会本地记住，之后启动无需重复输入，直接跳到第二步。
第 ② 步：导入并登录账号
选择账号文件
点击 「选择账号文件」，选中你的 account.txt。程序会立刻解析并列出所有账号，显示每个号的登录状态。
登录账号（全程窗口内完成）
点击 「🔑 一键登录全部」，或对单个账号点「登录」。需要验证码时会弹出输入窗口，直接在窗口里填即可；有两步验证密码的也会弹窗询问。
第 ③ 步：配置任务并启动
选择群组文件
点击 「选择群组文件」，选中 groups.txt。界面会显示读到多少条链接。
编辑营销文案
点击 「⚙️ 管理文案池」，添加你的营销文案（建议 3 条以上，内容尽量不同）。派发策略推荐选 「随机轮询发送」。文案会本地保存，下次启动自动恢复。
设置发送参数
设置「每个号最高群发数量」（新号建议 20-30，老号 50）。需要长期挂机就勾选 「24小时循环」 并设置冷却时间（建议 24 小时）；需要定时重复发同一批群就勾选 「定时重发」 并设置间隔分钟数。
更多开关在 「⚙️ 高级选项」 里，详见第七节。
启动任务
点击 「🚀 启动任务」。程序会依次执行：登录校验 → 链接预筛 → 分类路由 → 循环群发。整个过程日志区实时刷新，黑色运行窗口有更详细的技术输出。
过程中可随时暂停 / 停止 / 隐藏窗口
运行中可点 「⏸️ 暂停」 临时停手（不断开账号），点 「⏹️ 停止」 完全终止。嫌黑色运行窗口碍事，可以点标题栏的 「运行窗口」 按钮随时隐藏或重新显示，不影响任务运行。
查看结果
任务结束后会自动在程序目录的 reports/ 下生成报告（成功群 / 失败群 / 失败原因），也可以随时点 「📊 导出报告」 手动导出。若开启了自动清洗，无效群会自动从群组文件里剔除。
🎛️ 七、功能按钮与设置项说明
主要按钮
| 按钮 | 功能说明 |
|---|---|
| 🚀 启动任务 | 开始群发。流程：登录校验 → 链接预筛 → 分类路由 → 循环发送 → 风控重试 → 生成报告 |
| ⏸️ 暂停 | 暂停当前发送，可随时恢复继续。暂停期间不断开账号连接 |
| ⏹️ 停止 | 完全停止所有任务，断开账号连接，终止 24 小时循环和定时重发 |
| 🔑 一键登录全部 | 批量登录账号文件里的所有号。验证码 / 两步验证密码全部窗口内弹窗输入，已登录的自动跳过 |
| ⚙️ 管理文案池 | 添加 / 编辑 / 删除营销文案，选择派发策略。文案本地保存，下次启动自动恢复 |
| 📊 导出报告 | 导出发送结果，含成功群列表、失败群列表及具体失败原因 |
| 🗑️ 清洗无效群 | 把已解散 / 失效 / 无权限的群从群组文件中剔除，保持列表干净 |
| 🔄 重置续传进度 | 清空断点续传记录。下次启动会从头重新发全部群，而不是接着上次的断点 |
| 运行窗口（标题栏） | 一键隐藏 / 显示黑色 CMD 运行窗口。隐藏后任务照常运行，只是不占屏幕 |
| 帮助（标题栏） | 打开本使用教程、执行网络检测（检测本机直连 / Telegram 连通性 / 代理通道） |
基础设置项
| 设置项 | 说明 | 推荐值 |
|---|---|---|
| 每个号最高群发数量 | 单个账号每轮最多发送的群数量。数值越大越容易触发风控 | 新号 20-30 / 老号 50 |
| 24小时循环 | 勾选后每轮发完等待冷却时间自动开始下一轮，实现无人值守长期挂机 | 长期挂机时勾选 |
| 大循环冷却时间 | 每轮发送完成后等待多久再开始下一轮（小时） | 24 |
| 定时重发 | 勾选后按设定的分钟间隔，对同一批群反复发送 | 按需，间隔 ≥ 30 分钟 |
| 文案派发策略 | 多条文案的发送顺序：顺序轮流 或 随机抽取 | 随机轮询发送 |
⚙️ 高级选项
| 开关 | 说明 | 默认 |
|---|---|---|
| 自动分配代理 | 把代理列表按顺序自动分配给各账号，一号一代理，避免同 IP 扎堆 | 按需开启 |
| 强制优先加群 | 覆盖智能路由，所有群一律先加群再发送。一般不用开，智能路由已自动判断 | 关闭 |
| 每次启动重新预筛链接 | 关闭时复用本地预筛缓存，启动更快；群组列表变动大时可打开做一次全量重扫 | 关闭 |
| 启用智能风控套件（测试版） | 实验性风控增强，详见第八节。默认关闭，觉得掉号频繁可以打开试试 | 关闭 |
| 结束后自动清洗无效群 | 任务结束自动剔除失效群，无需手动点清洗 | 建议开启 |
🧠 八、智能功能与风控机制
这一节是 v4.1 相比老版本提升最大的部分，建议完整读一遍——理解这些机制能明显提高你的发送成功率、降低掉号率。
1. 智能自动路由（默认开启，无需设置）
老版本最大的浪费是：把发送额度砸在根本发不出去的群上——广播频道只能管理员发、没加入的群直接被拒、失效链接白等流控。
现在程序会在发送前先对全部链接做一次预筛探测，自动分成三类并走不同通道：
| 分类 | 含义 | 处理方式 |
|---|---|---|
| 直发 | 已经加入的群 | 免加群直接发，速度最快 |
| 加群后发 | 未加入的公开群 / 私密邀请链接 | 先自动加群，成功后立即发送 |
| 跳过 | 广播频道 / 失效链接 / 内部消息链接 | 直接跳过，不浪费额度和时间 |
2. 断点续传
任务跑到一半关掉程序、断网、或者电脑重启，不用从头再来。程序按群组文件记录进度（已发成功 / 已确认失效 / 待发送），下次启动自动跳过已处理的，从断点继续。
想强制重新全量发一遍，点 「🔄 重置续传进度」 即可。注意：24 小时循环的第二轮及以后本来就是全量重发，不受断点影响。
3. 风控智能重试（不轻易放弃）
老版本遇到加群风控就整轮放弃这些群。现在的处理是：
- 被限流的群不算失败，进入待重试队列
- 等最早解除限制的账号冷却到期，自动换号重新加群 + 补发
- 最多重试 3 轮，单轮等待上限 30 分钟，避免无限卡死
4. 限流权限分离（重点）
5. 内容去指纹
同一条文案反复群发，Telegram 很容易识别为垃圾信息。程序会在每条消息末尾追加随机不可见字符（零宽字符 / 空格等，肉眼完全看不见），让每条消息的实际内容都不完全相同，降低被聚类识别的概率。
6. 🧪 智能风控套件（测试版）
在 「⚙️ 高级选项」 里，默认关闭。这是一组更激进的保号策略，牺牲一点发送速度换取更低的掉号率。开启后生效：
| 策略 | 作用 |
|---|---|
| 账号轮换打乱 | 每轮大循环前随机打乱账号顺序，避免固定的账号使用节奏被识别 |
| 单号单日配额 | 账号发满设定数量后锁定到次日，绝不超额压榨 |
| 切号强制冷却 | 切换账号后额外静默 1-3 秒，避免多号连续发送形成明显特征 |
| 发送间隔加宽 | 群间间隔从 10-18 秒扩展到 12-25 秒随机，节奏更接近真人 |
| PeerFlood 立即止损 | 识别到 PeerFlood（官方限制垃圾信息的前兆信号）立刻停用该号，不再无意义重试加速封号 |
开关不影响已有配置，随时可以切换对比效果。
7. 异常链接自动识别
群组文件里混入的内部消息链接（形如 t.me/c/xxxx/123）、失效邀请链接、格式错误的行，都会在预筛阶段自动识别并跳过，不会再因为解析失败导致任务中断。
📌 保号建议汇总
- 新号先养：注册后先正常用几天（加几个群、聊几句），别一上来就群发
- 文案要多样：准备 3-5 条内容明显不同的文案，别只放一条
- 额度别贪：新号每轮 20-30 个群，稳定运行一周后再往上加
- 一号一代理：开启自动分配代理，避免多号同 IP
- 循环别太密：冷却时间建议 24 小时，别设成 1-2 小时
- 掉号频繁就开测试套件：智能风控套件专门针对这个场景
❓ 九、常见问题与故障排除
Q: 启动后提示"加载账号文件失败"
检查账号文件格式是否正确：每行用英文逗号分隔，手机号带+号，API ID是纯数字。不要用中文逗号或多余空格。
Q: 提示输入验证码，在哪里输入？
Q: 提示"Session被锁定"或"FLOOD_WAIT"
- 降低"每个号最高群发数量"（新号建议 20-30）
- 增加更多账号轮换，并开启自动分配代理
- 到「⚙️ 高级选项」打开 智能风控套件（测试版）
Q: 什么是 PeerFlood？和 FLOOD_WAIT 有什么区别？
FLOOD_WAIT 是临时限速，等一会就恢复；PeerFlood 是 Telegram 判定该账号在发垃圾信息的降权信号，属于封号前兆。程序遇到 PeerFlood 会直接停用该账号，避免继续操作加速封号。出现 PeerFlood 说明这个号短期内不适合再群发了。
Q: 任务跑到一半关掉了，再开要重头来吗？
不用。程序有断点续传，重新启动会自动跳过已发成功和已确认失效的群，从断点继续。想强制全量重发，点「🔄 重置续传进度」。
Q: 大部分群提示"没有权限发送"怎么办？
多半是链接里混了广播频道（只有管理员能发）。v4.1 的智能自动路由会在发送前自动识别并跳过这类链接，不会浪费额度。如果你的群组文件是很久之前准备的，建议在「⚙️ 高级选项」里打开一次「每次启动重新预筛链接」做全量重扫。
Q: 某些群组发送失败
可能原因：群组已解散、被踢出、没有发送权限、链接失效等。运行完成后点击"📊 导出报告"查看失败原因，再点击"🗑️ 清洗无效群"清理（也可在高级选项里开启结束后自动清洗）。
Q: 程序突然退出 / 黑框一闪就没了
先确认群组文件里是否混入了内部消息链接（形如 t.me/c/xxxx/123）——v4.1 已能自动识别跳过这类链接。若仍然出现异常退出，请先不要关闭黑色运行窗口，把窗口里最后几行红色报错截图发给客服 @waitzzz111。
Q: 黑色运行窗口能关掉吗？
能。点标题栏的 「运行窗口」 按钮可以随时隐藏或重新显示，隐藏后任务照常运行。注意不要直接点黑框右上角的 ✕ 关闭，那会把整个程序结束掉。
Q: 代理连接不上
检查代理格式是否正确：socks5://用户名:密码@IP:端口。确认代理服务器在线且账号密码无误。可以先去掉代理测试本地网络是否能连。
Q: 卡密到期了怎么办
联系客服（TG: @waitzzz111）购买新卡密，重新激活即可。永久版不会过期。
Q: 换电脑后卡密不能用了
卡密绑定机器码，一卡一机。换电脑需要联系客服解绑后重新绑定，或购买新卡密。
Q: 程序提示更新
程序内置自动更新。功能升级走云端热更新，启动时自动拉取最新业务核心，几秒完成、无需重新下载 exe；只有底层框架变动时才会提示下载新 exe，点「是」一键升级即可。标题栏显示的版本号就是当前实际运行的功能版本。
Q: 杀毒软件报毒怎么办
联系客服 Telegram: @waitzzz111