Threads Messages 是一个用于处理用户本人 Threads 私信的工具,通过配套命令行程序 threads-messages-cli 调用。它的用途集中在消息读取与发送,不适用于 Threads 内容或账号的非消息数据;后者需要使用单独的 threads 技能。
主要能力包括:获取收件箱会话列表及最近消息预览,按指定文件夹筛选(例如 PENDING),读取某个会话的消息,并通过上一页返回的分页游标获取后续结果。发送方面,可向一个已有会话发送文本,或向 1 至 11 个数字型收件人 FBID 发送消息;也可分享一条已发布且可见的 Threads 帖子,附带或不附带文本,并可指定回复某条已有消息。发送命令为隐藏写操作,必须经过明确的用户意图确认,包含确切内容、确切目标和回复对象后才可执行。
使用方式上,除 connect-url 外,所有命令都需要 --account-id 参数,值为用户自己的 Threads 账号 ID;若尚不知道该 ID,应先通过 threads-cli accounts 获取。连接 Threads Messages 时运行 threads-messages-cli connect-url,并将返回的 connect_url 作为带标签的链接提供给用户,完成连接后才能使用收件箱与会话命令。收件箱和会话命令支持 --first、--message-count、--after 等分页参数;发送不支持 --retries,因为消息发送不是幂等操作,每次获批的发送都是新的独立操作。
适用场景包括查看私信收件箱、阅读特定会话、回答与私信内容相关的问题、在明确授权下发送简短文本或分享已有帖子。限制也很明确:只能操作已认证用户自己的消息;不得批量导出、下载、保存、归档、镜像或转储消息历史,尤其要拒绝针对消失式、一次性查看、临时或过期消息的此类请求;不提供文件上传,只能按 FBID 分享已发布可见的帖子;不得通过替代路径绕过 U18 限制或过滤结果;不得自行推测或替换用户名、收件人、会话或回复目标;发送失败或受限时不得改道重试。输出为 JSON,读取结果会附带 UTC 和本地时间的语义时间字段,发送结果只包含不透明 message_id 与整数 timestamp_ms。