Threads CLI 是一个用于读取和管理已认证 Threads 数据的命令行工具，在支持 Threads 技能的环境中可用。账户消息收件箱与私信功能需使用单独的 threads_messages 技能。
一、用途 通过 threads-cli 伴生 CLI 读取并管理用户的 Threads 账号数据，覆盖资料、帖子、信息流、收藏、活动、洞察、社交关系、搜索、趋势以及指定帖子。读取操作、dear-algo-whisper 与经批准的发布帖子调用在支持该技能的环境中可用。
二、账号连接
- 执行任何其他命令前，先运行 threads-cli accounts 检查账号是否已连接。若返回带 id 的账号信息，则已连接，正常继续，并在本次对话中缓存该结果，无需每次命令前重复检查。若后续命令出现认证或账号错误，重新运行该命令复查。
- 若命令失败或返回空结果，说明未连接。运行 threads-cli connect-url（输出 JSON，含 connect_url 字段），将其中 URL 告知用户，引导其前往 Meta Accounts Center 关联 Threads 账号。
- 若用户要求断开连接，运行 threads-cli disconnect-url（输出 JSON，含 disconnect_url 字段），引导其访问该地址移除已关联账号。
- URL 一律从命令输出读取，不要硬编码。
三、调用方式 使用 exec 运行：threads-cli <target> [options]。 全局选项：--account-id <threads_account_id>（除 accounts 外所有命令必填，取值为 accounts 响应中当前用户自己的 id 字段；若返回多个账号需询问用户选择）；--retries <N> 重试瞬时失败（默认 0，dear-algo-whisper 与 publish-post 不支持，以免重复变更）。
四、主要命令
- accounts：列出当前认证用户关联的 Threads 账号。
- profile：获取当前用户自己的资料。
- activity-feed：获取活动通知，支持 --first、--category-filter（如 text_post_app_mentions 等 8 种分类）、--after 游标。
- liked-media / saved-posts：获取点赞过/收藏的帖子，支持 --since、--until、--sort-order、--limit、--after。
- insights-overview：获取账号级洞察（浏览量、点赞、引用、回复、转发、流量来源、人群画像），参数 --start-date、--end-date、--sections（summary、views、interactions、followers、demographics、all）。
- post-insights：按 --post-id 获取单帖洞察。
- top-posts：获取日期范围内浏览量最高的帖子及服务定义的最多三篇最受点赞帖子，--count 上限 50。
- user-profile：按数字 Threads 用户 FBID 获取其他用户资料（不接受用户名或资料 URL）。
- profile-threads / profile-replies / profile-media：按用户 FBID 获取其帖子、回复、媒体帖子（图片、视频、轮播），支持 --first（--limit 为兼容别名）与 --after。
- followers / following：获取指定用户的粉丝/关注列表。
- post：按 --url（threads.com 或 threads.net 原始链接，含分享链接）或 --post-id/--id 获取指定帖子，二者必选其一。
- fetch-post-comments（别名 comments）：按 --post-ids 获取评论，支持 --since、--until、--sort-order、--limit、--author-id（可重复或逗号分隔）。
- fetch-post-likers（别名 likers）：按 --post-ids 获取点赞用户，支持 --since、--until、--sort-order、--limit、--reactor-id。
- feedback-hub-overview：获取帖子互动汇总（点赞、转发、引用数）。
- feedback-hub-tab：按 --tab-type（like、repost、quote）分页获取互动用户列表。
- trends：获取 Threads 趋势话题，支持 --first。
- search：按关键词搜索，--recent 1 返回“Recent”标签结果，--trend-fbid 可深入某趋势，支持 --first、--after。
- feed：获取排序信息流，--variant for_you 或 following，following 可加 --sort-by recent，支持 --after 分页。
- publish-post（隐藏写命令，需显式确认）：一次操作发布普通 Threads 帖子并返回帖子 ID。文本在无媒体时至少含一个非空白字符，接受文本的所有字节（含首尾空白与 Unicode）在确认与发布过程中完整保留。可包含 1 至 20 个来自工作区的有序本地图片或视频，可回复指定帖子并设置回复权限。文件在工作区外须先复制进工作区，禁止使用 /tmp 路径。回复权限仅接受 everyone、accounts_you_follow、mentioned_only、parent_post_author_only、followers_only；旧的 following、mentioned、followers 拼写无效，不得静默转换。每个 --media-item 为 JSON，含 file、可选 cover 与精确 alt_text；支持 JPEG、PNG、静态 WebP、MP4、MOV，单个不超过 100 MB，类型按扩展名推断；MP4/MOV 必须配 JPEG/PNG/WebP 封面，图片不可带封面；文件顺序即展示顺序。单个媒体发布为图片或视频，2 至 20 个按顺序发布为一条轮播。
五、输出与写安全 feed 与 post 使用与 instagram-cli 相同的 compact social_posts_v1 展示；以过滤后的结果为权威，不要重建被省略字段。仅含错误的帖子行会被省略，其消息作为 provider_error 呈现。发布须经 Hatch 确认窗口批准，拒绝或关闭即终止；写操作零重试，子项或父项失败即终止，不得继续失败的轮播，后续尝试需重新显式批准。确认界面展示精确文本、回复权限、全部有序媒体及视频封面，标识符不安全时以 Threads image/video 占位，不展示账号、回复、子项、创建或帖子 ID 及本地路径。
六、适用场景 社媒运营与内容分析、账号数据盘点、趋势与搜索监测、粉丝与互动分析、按批准流程发布帖子等。
七、限制 需先完成账号连接；多数命令必须提供账号 ID；用户资料等命令仅接受数字 FBID；发布为隐藏写命令且需显式确认；写操作不支持重试；媒体须位于工作区，单文件上限 100 MB，视频需封面。平台覆盖、收费与价格等信息暂未提供。