手里攒了一大批 Telegram 用户名或 t.me 链接，但不知道哪些还有效、哪些其实是群或频道而不是真人——直接拿去群发或拉群，轻则白费配额，重则触发风控。筛选用户名模块要解决的就是这个"脏清单"问题：在正式动作之前，先把名单逐条核验一遍，把无效项剔掉，把类型分清，留下可用的目标。
这个模块能做什么
把现有名单导入后，它会对每一个条目逐条向 Telegram 发起查询，回填出可供判断的基础信息：
- 格式兼容：同时支持
@xxx形式的用户名和t.me/xxx形式的链接，混在一起也能识别。 - 有效性校验：标出哪些用户名真实存在、可被解析，哪些已失效或查不到。
- 类型判定：区分该条目到底是用户、群组还是频道，避免把频道当成个人误群发。
- 取回 ID 与名称：解析出对应的数字 ID 和显示名称，方便后续模块直接调用，不必再次解析。
- 最近上线过滤(可选)：可以只保留最近上线过的用户，并自行设定天数范围，把长期不活跃的账号排除在外。
校验完成后，结果支持按类别分类导出：可以单独导出选中类别、用户、最近上线用户、群、频道等不同分组，按你下一步要做的事情各取所需。
关键设置怎么调
模块提供了一组与请求节奏和账号使用相关的参数，用来在"跑得快"和"跑得稳"之间找平衡：
- 请求间隔：控制每次查询之间的停顿，名单越大、越在意稳定性，间隔就应当设得宽松一些。
- 并发账号上限：限定同时参与校验的账号数量，决定整体并行规模。
- 每号配额：给单个账号设定本轮可承担的查询量上限，避免把压力集中到少数账号上。
- 单次筛选数：限定一次任务处理的条目总量，便于把超大名单拆成几批分次跑。
- 仅最近上线用户 + 天数：在需要"只要活跃目标"时开启，并按业务节奏设定天数。
这些参数没有放之四海皆准的数值，建议结合自己的账号数量和名单规模实际试跑后再固定下来。
实战建议与注意事项
- 先小后大：第一次跑陌生来源的名单，先用较小的单次筛选数试一批，确认节奏合适再放量。
- 间隔宁宽勿窄：请求间隔和配额是为了让校验过程更平稳，不要为了图快把间隔压到极限。
- 按用途分开导出：要私聊触达就导"用户"，尤其是"最近上线用户"；要做群发或频道运营，就分别导出"群""频道"，让每条下游动作面对的都是同质目标。
- 把它当成前置工序：筛选用户名的产出是干净、带类型和 ID 的清单，应当作为后续引流、拉群、群发等模块的输入，而不是孤立使用。
- 校验结果取决于 Telegram 当时返回的状态，名单存在时效性，重要任务前最好重新核验一遍再用。
Q：导入的名单里既有 @用户名又有 t.me 链接，需要先统一格式吗？
A：不需要。模块同时识别 @xxx 和 t.me/xxx 两种写法，两者混在同一份名单里也能正常解析校验。
Q：为什么要单独提供"仅最近上线用户"和天数设置？
A：因为很多名单里混着长期不活跃的账号，对其触达往往收效有限。开启该选项并设定天数后，可只保留近期上线过的用户，再配合分类导出把活跃目标单独取出，让下一步动作更聚焦。