基础设置：协议号与素材

本文只讲“准备工作”：把协议号放进机器人、确认哪些能用、维护号池，以及上传剧本。

任务怎么配、怎么跑，请看 02-任务使用指南。

推荐准备流程

① 打包 ZIP（.session + .json 成对）
        ↓
② 基础配置 → 上传协议号包
        ↓
③ 验证协议号（必要时先下线再验证）
        ↓
④ 查看协议号信息，清理无效号 / 受限号
        ↓
⑤ 上传剧本 → 剧本信息确认解析正常
        ↓
⑥ 去「任务配置」创建任务

1. 先认识入口

私聊机器人发送 /start，主菜单只有四个入口：

点「🎛 基础配置」进入基础配置面板：

2. 上传协议号包

2.1 文件要求

每个协议号必须是一对同名文件：

sessions.zip
├── 8613800000001.session
├── 8613800000001.json
├── 8613800000002.session
└── 8613800000002.json

注意：.session 是 Telethon 格式，不能直接给其他框架使用。

2.2 操作步骤

1. 进入「🎛 基础配置」→「📠 上传协议号包」。

2. 按提示发送 ZIP 压缩包（以文件形式发送，不要发下载链接）。

3. 按提示确认提交。

4. 处理完成后会回复：✅ 你上传的 协议号 压缩包已经解压完成。发现 N 个协议号:，并列出协议号名。

2.3 上传后的状态

• 上传只代表文件已就位，并不代表协议号可用。

• 必须再执行一次「🪬 验证协议号」，系统才知道哪些号能登录。

• 协议号数量受 VIP 等级限制（见 03-会员等级说明），超出部分不会参与任务。

3. 验证协议号

验证会真实连接 Telegram，确认会话是否仍然有效。

3.1 操作步骤

1. 基础配置 →「🪬 验证协议号」。

2. 机器人提示：❕ 你的VIP等级单次最多检测 N 个协议号，并显示检测进度。

3. 完成后显示：检测总数、✅ 有效数量、❌ 无效数量。

3.2 规则与限制

3.3 什么情况会判为无效

• Session 已过期、被注销、被强制登出

• 账号被冻结/封禁

• .session 与 .json 不匹配，或文件损坏

• 账号触发了需要验证的登录保护

• 检测时网络异常（超时也会计为失败，可稍后单独复查）

提示：无效号不一定是永久报废，可能只是一次网络抖动。批量检测后建议对少量“意外无效”的号再验证一次。

4. Spam 检测（实验功能）

用于判断协议号是否被 Telegram 限制发言（@SpamBot 显示 restricted / limited）。

4.1 操作步骤

1. 基础配置 →「🛡 Spam检测」。

2. 机器人提示正在通过 @SpamBot 检测，检测在后台执行。

3. 完成后推送「Spam 检测报告」，包含四类统计：

4.2 注意事项

• 检测对象是已通过验证的有效号；未验证请先做第 3 节。

• 检测结果会保存为快照，显示在「协议号信息」里；限制可能随时变化，处理前建议重新检测。

• 协议号如果还在其他设备/程序登录，SpamBot 的回复可能被其他会话消费，导致检测不准。

• 「清除 Spam 号」只依据最近一次检测结果，且要先把这些号下线。

5. 查看协议号信息

基础配置 →「🔅 协议号信息」。

面板内容：

说明：

• 协议号名（文件名）才是任务里要填的标识；Telegram 昵称、@username 只是展示信息。

• 清除无效信息只有在存在无效号时才会执行；没有无效号时不会给出提示属于正常现象。

• 清理操作都会直接删除本地 session 文件，不可恢复，请确认后再点。

6. 导出协议号

基础配置 →「📤 导出协议号」。

• 会把当前有效协议号的 .session + .json 打包成 ZIP 发给你，用于备份或迁移。

• 导出前必须让所有协议号离线：如果还有号在活动，会提示

  ⚠️ 当前有 N 个协议号正在活动, 请先到 执行面板 ⏹️ 下线协议号 后再导出。

• 导出的压缩包会以文件形式发送，文件名形如 sessions_export_<时间戳>.zip。

7. 卸载协议号

基础配置 →「🗑 卸载协议号」，会先弹出范围选择：

7.1 指定卸载

1. 点「🎯 指定卸载」。

2. 输入协议号名，一行一个或用逗号分隔；带 .session / .json 后缀也能识别。

3. 确认后会停止这些号并删除文件；不存在的名字会被忽略并列出。

限制：

• 正在被任务使用的号不能卸载，会提示 ⛔ 以下协议号正在被任务使用，暂不能卸载，请先停止相关任务。

• 只会移除这些号在统计和 Spam 检测结果中的记录，其他号不受影响。

7.2 全部卸载

• 会先停止所有任务（ChatRunner），再停止协议号池，最后删除全部 session 文件、统计与 Spam 结果。

• 整个过程需要等待，最长约 30 秒兜底。

• 不可恢复。换号前建议先「📤 导出协议号」备份。

8. 协议号的在线状态与启停

协议号不是上传后就一直在线，而是按需启动、空闲回收。

8.1 在哪里看

执行面板顶部会显示：

• 📤 已上传：有效协议号数量

• 🔝 最大可用：当前 VIP 的 max_bots

• 📦 已加载：已载入号池的协议号数量

• ⚡️ 活动中：当前真正连着的协议号数量

• 💀 已失效：被判定为会话失效/冻结的数量

点「📇 活动帐号(N)」可分页查看在线号：协议号名、用户名、昵称、ID、是否 Premium，被冻结的号会带 ❄️。

8.2 重启与下线

规则：

• 空闲超过 24 小时 的协议号会自动释放连接以节省资源；需要时会自动重新拉起，协议号名不会丢。

• 会话已失效（注销、强制登出、冻结）的号会被移出可重建名册，不再反复重试；需要清理时用「清除无效信息」。

• 下线不会删除文件，重新启动即可恢复；卸载才会删文件。

• 想在活动帐号列表里点「💬 发起会话」让协议号私聊你，你的账号必须设置 @username；否则会提示无法发起。

9. 剧本文件管理

剧本是对话任务和评论任务的“台词本”，通过「📚 上传剧本」上传。

9.1 上传要求

上传成功后提示格式：

你上传的剧本处理完成 1 个:
名称: 早班闲聊 对白数:42 演员数: 3

9.2 剧本信息与删除

「📖 剧本信息」会列出所有剧本：

9.3 写剧本前的三个提醒

1. 冒号必须是英文冒号 :，中文冒号 ： 会导致整行无法解析。

2. 文件必须保存为 UTF-8（Windows 记事本默认可能不是）。

3. 对话任务只接受「普通剧本」；首行写 comment 会变成评论剧本，不会出现在对话任务的可选列表里（剧本语法见 02-任务使用指南）。

10. 名字、头像与用户名

当前版本不在机器人内提供批量改名/换头像入口，统一使用外部工具：

1. 先到执行面板「⏹️ 下线协议号」。

2. 打开 @sloginbot，按提示执行「信息补全」。

3. 完成后再回到执行面板「♻️ 重启协议号」。

⚠️ 频繁改名、换头像、改用户名会显著提高风控概率，建议低频、分批操作。

⚠️ 未下线就操作，容易造成协议号丢失或会话失效。