Latest Agent Release

最新版本更新说明

2026年7月15日

Current Version

v2.0.3

常规更新 (Regular)

最低版本：v1.0.0

1. 新增强拉入群任务 Worker 注册、领取、执行和结果回传完整链路。

2. Telethon 依赖固定至已验证 commit，避免浮动版本导致运行行为变化。

3. 支持名单模式与源群采集模式两种目标来源。

4. 名单支持 `@username`、Telegram 链接、`phone:+E164` 和 `id:数字` 强类型目标。

5. 自动拒绝无类型纯数字、非法目标、重复目标和外部传入的 access_hash。

6. username、手机号和用户 ID 均由当前执行账号独立解析，禁止跨账号复用 access_hash。

7. 手机号目标采用临时联系人解析，并在成功或失败后自动清理联系人。

8. 自动过滤机器人、已删除用户、无法解析用户、已在目标群用户及不符合活跃度条件的用户。

9. 源群模式支持每个账号独立解析或加入源群并分页采集成员。

10. 源群采集支持成员上限、实时进度、分页取消、去重及部分可见成员处理。

11. 源群模式支持排除源群管理员、机器人、已删除用户和已在目标群成员。

12. 源群成员邀请时由各执行账号重新获取自己的 InputPeer，避免采集账号实体跨号串用。

13. 新增账号连接、授权状态、代理要求、健康分、手动禁用、任务上限和每日限额门禁。

14. 新增目标群解析、成员邀请权限及账号目标群访问权限预检。

15. 新增单目标互斥租约、租约超时恢复和单目标最大尝试次数控制。

16. 短 FloodWait 支持延迟重试，长 FloodWait 自动冷却账号并重新调度目标。

17. PeerFlood 自动进入持久化冷却，冷却账号不再领取新目标或执行软邀。

18. 隐私限制结果不再通过无限换号循环绕过，并保留明确的隐私分类。

19. 新增可选软邀兜底，默认关闭，启用时校验私有邀请链接、授权标记、健康账号和独立日限。

20. 软邀增加目标级幂等与取消保护，同一目标不会重复私信，结果区分软邀成功和软邀失败。

21. `daily_limit_per_account=0` 明确表示暂停硬邀，不再被错误回退为默认限额。

22. `flood_wait_max=0` 明确表示不原地等待，隐私或目标重试为 0 时首次失败后不换号。

23. 统一任务终态结算，区分完成、部分完成、带错误完成、失败和用户取消。

24. 无账号、无目标、账号全部不可用、连接全部失败、目标群失败及未知异常均会回传最终结果。

25. Terminal settlement 保证只执行一次，任务结束后关闭全部 Telethon clients 并记录未处理目标数。

26. 统一 processed、pending、total 和最终进度统计，避免进度与结果分类不一致。

27. 新增逐目标结构化结果、稳定 attempt key 和 `result_version`，支持 Server 幂等持久化。

28. Agent 重启后仅恢复 pending/retry_wait 目标，已成功目标不会再次领取或重复邀请。

29. 加强停止/取消传播，所有账号协程、采集分页、等待与软邀流程均可及时中断。

30. 加强代理路由和停止可观测性，日志可显示账号冷却原因、截止时间和任务终止原因。

下载青鸟助手 Agent 客户端