装上就能干活的 AI 小程序

适用场景

用于按关键词、话题、账号和日期查找 X 帖子，整理带原帖来源的内容列表，并导出文字、清单及页面提供的可下载图片、视频素材。也可保存常用搜索条件，手动启动定时追踪。

使用前请注意： 当前通过浏览器页面可见内容采集，不调用私有接口。页面适配尚待真实登录后核验，真实搜索、媒体识别、跨页面滚动和目录下载尚未完成实际验收；结果可能受 X 页面结构变化影响。

开始使用

1. 点击右上方 「登录 X」，在宿主管理的浏览器窗口中自行完成登录。无需 API Key，也不要向应用或助手提供密码、验证码。
2. 在左侧 「搜索与筛选」 中填写搜索条件。至少填写关键词、精确短语、任一关键词、话题标签或账号中的一项；仅设置日期、语言或排除词不能开始采集。
3. 选择 「热门」 或 「最新」，设置每轮 1–200 条的采集数量，默认 30 条。
4. 点击 「开始采集」，在右侧查看本轮进度和结果。列表不预填演示帖子，仅显示实际采集内容。

设置搜索与筛选

文字、账号、时间与语言

• 全部关键词：多个词用空格分隔，组合搜索。
• 展开 「文字匹配与账号」，可填写精确短语、任一关键词、排除关键词、话题标签，以及来自、回复或提及的账号。任一关键词和排除关键词用空格分隔；标签可带 #，账号可带 @。
• 账号仅支持 1–15 位英文字母、数字或下划线；搜索文本字段最多 500 个字符。
• 在 「时间与语言」 中选择起止日期和语言。截止日期不包含当天，且必须晚于起始日期。语言可选不限、中文、英语、日语、韩语、西班牙语、法语或德语。
• 下方 「搜索表达式」 会显示当前生成的查询，便于核对条件。

文字、账号、语言、日期和热门／最新排序由 X 原生搜索处理。

素材与互动精筛

展开 「素材与互动精筛」，可设置：

• 素材类型：全部帖子、含图片或含视频。
• 回复帖子：不限、仅回复或排除回复。
• 外部链接：不限、含链接或不含链接。
• 最低点赞数、最低转帖数、最低回复数：填写非负整数，默认 0，表示不设该项门槛。

这些条件在读取页面后筛选。互动数据无法识别时显示 「未知」，不会当作 0，也不会通过正数门槛。回复识别可能受 X 界面语言和页面结构影响。选择「含视频」也可能得到 「视频无直链」 的帖子，并不意味着视频一定可以下载。

采集与定时追踪

单次采集

点击 「开始采集」 后，应用加载 X 搜索页并滚动读取帖子。右侧显示素材库总数、已选数量、本轮已采集数量与目标，以及任务状态。

• 采集数量是筛选后的目标，不保证达到。无结果、严格筛选或页面不再返回内容时，会显示数量不足。
• 帖子按原帖 ID 去重，重复采集不会在历史中新增相同帖子。历史最多保留 1000 条。
• 点击 「停止采集与追踪」 可请求停止；当前页面或网络步骤结束后生效，已采集内容保留。

定时追踪

1. 展开 「保存搜索与定时追踪」。
2. 设置 「追踪间隔（分钟）」，范围为 5–1440 分钟，默认 10 分钟。
3. 点击 「开始追踪」。应用立即执行一轮采集，之后按启动时的条件间隔刷新；右侧显示下次刷新时间。
4. 不再需要时点击 「停止采集与追踪」。

追踪必须显式启动。关闭小程序界面后可继续运行；退出客户端即停止，重启后不会自动恢复。需要更改正在使用的追踪条件时，请先停止，再重新启动。

查看与选择结果

结果列表每页显示 20 条，可使用 「上一页」／「下一页」 翻页。列表支持按采集顺序、点赞最多、转帖最多或发布时间最新排序，这与搜索时的 X 排序是不同设置。

每条帖子展示作者、发布时间、文字、可识别的图片、点赞／转帖／回复数，以及图片数量和视频状态。缺失时间或互动数据会标注为未知；原帖图标可打开来源页面。

• 勾选单条帖子，或使用 「选择本页」 批量选择当前页内容。
• 可跨页选择，右侧 「已选」 显示所选数量。
• 单帖右下方 「下载素材」 可直接导出该帖，无需先勾选。

导出文字与素材

导出入口

• 「下载素材」：导出该帖文字及可下载媒体。
• 「下载所选素材」：导出已勾选帖子的文字及可下载媒体。
• 「导出全部清单与文字」：导出当前素材库全部帖子的文字与清单，不请求或下载媒体文件。

应用先准备内容，再提示 「请选择保存目录」。通过一次系统目录选择完成导出；同名冲突采用重命名方式处理。准备期间可点击 「取消准备」；在系统目录选择中取消，则不导出文件。

导出内容

导出目录按帖子编号和 ID 分为子目录，其中包含：

• **帖子.txt**：作者、发布时间、原帖链接、文字、互动数据和采集时间。
• 图片或视频文件：仅在选择含媒体导出、且下载成功时生成。
• 根目录 **采集清单.json**：帖子记录、媒体信息、是否请求媒体及失败记录。
• 根目录 **下载说明.txt**：帖子和素材数量、失败或不可下载原因。

单项媒体下载失败不会阻止文字和来源导出。请根据完成提示检查失败数量，并查看下载说明和 JSON 清单。临时素材资产会在导出流程结束后清理。

媒体下载限制

• 图片只接受 X 图片域名 pbs.twimg.com 的 /media/ 地址，并请求原图尺寸；单文件上限 32 MiB。
• 视频只支持页面明确提供、位于 video.twimg.com 的 MP4 直链；单文件上限 256 MiB。
• 不支持 blob、HLS 视频，不绕过 DRM 或访问限制。
• HTTP 非成功状态、错误媒体类型、空响应等会记录为下载失败。
• 一次导出最多 1000 条帖子；生成文件超过 5000 个时需减少选择数量。

保存搜索与管理历史

• 在 「保存搜索与定时追踪」 中填写可选名称，点击 「保存当前搜索」。未填写名称时使用搜索表达式作为名称。
• 最多保存 20 个搜索；新增超过上限时只保留最近 20 个。点击已保存的搜索名称可载入条件，但不会自动开始采集。
• 点击保存项旁的 「删除」，二次确认后删除该搜索。
• 「导出搜索方案」 导出当前条件的 搜索方案.json 和使用说明，不包含账号凭据。使用方案时需在小程序中填写对应条件并登录 X。
• 「恢复默认筛选」 需二次确认，只重置筛选条件，保留已保存搜索和帖子历史。
• 「清空历史」 需二次确认，清空素材库记录和选择状态，不影响已导出的本地文件。

必要注意事项

• 「热门」排序来自 X，不是全网排行榜。账号权限、搜索索引、地域、访问限制和限流都会影响结果。
• 出现登录提示时，请在浏览器完成登录后重新采集；出现限流时追踪会暂停，请稍后手动重试。页面加载失败时，请检查浏览器后重试。
• 若提示任务确认超时，不要重复点击；先查看当前状态，必要时停止后再重试。
• 应用使用默认共享浏览器 Profile，仅读取浏览器中可访问的帖子；不导出 Cookie、token 或登录凭据，不执行发帖、点赞或转帖。
• 仅下载你有权使用的内容。导出文件不授予转载或商业使用权，素材版权归原作者。