X Tracker

同步并归档 X 数据（关注列表、书签、个人推文），支持内容聚合、改写和 Notion 同步。

路径约定：

• {SKILL_DIR} — skill 目录（含 scripts/、references/）

• {PROJECT_ROOT} — skill 父目录（含 config.json、data/、digests/）

首次设置

• 配置 OAuth 2.0：参考 references/oauth-setup.md

• 初始化：cd {SKILL_DIR} && bun scripts/auth.ts init

• 登录：cd {SKILL_DIR} && bun scripts/auth.ts login

所需 scope：tweet.read , users.read , follows.read , bookmark.read , offline.access

数据同步

重要：不要主动运行 sync-following.ts 。关注列表由定时任务或用户手动同步，新增关注需用户确认后才纳入跟踪。

cd {SKILL_DIR}

bun scripts/sync-following.ts # ⚠️ 仅限用户明确要求时运行

bun scripts/sync-bookmarks.ts # 书签 → data/bookmarks/ bun scripts/fetch-my-tweets.ts # 个人推文 → data/my-tweets/ bun scripts/fetch-following-tweets.ts # 关注者推文 → data/following-tweets/

日常同步（不含关注列表）：bun scripts/sync-bookmarks.ts && bun scripts/fetch-my-tweets.ts && bun scripts/fetch-following-tweets.ts

每日精选（Digest）

cd {SKILL_DIR} && bun scripts/analyze.ts digest [--date YYYY-MM-DD]

零 API 调用，基于本地 following-tweets

• bookmarks 。按 score = like + retweet×3 + bookmark×2 排序取 Top 20。输出 digests/{date}/digest.json 。

触发流程（"每日精选"/"今日精选"）：

• 运行 digest 命令，生成 digests/{date}/digest.json

• 读取 JSON，确认 date_distribution 日期分布

• 按分类生成中文精选，每条格式：

• 作者 | 类型 | 来源标签 | 互动数据

• 英文原文（保留原始内容）

• 中文翻译/摘要（不超过 2 句话概括核心）

• 来源标签：🔖 书签 / 📌 双来源 / 无标签=关注

• 根据 tweet_date 标注发布日期，非当日内容标注 [MM-DD]

• 写入 {PROJECT_ROOT}/digests/{date}/digest.md

内容改写（Rewrite）

cd {SKILL_DIR} && bun scripts/analyze.ts rewrite [--date YYYY-MM-DD] [--top 10]

按分数取 Top N，输出 digests/{date}/rewrite.json （含 is_link_only 、expanded_url ）。

触发流程（"推文改写"/"内容改写"/"rewrite"）：

• 运行 rewrite 命令

• 读取 JSON，确认日期：查看 date_distribution 中各日期占比，若当日（tweet_date = 今天）不足半数则展示分布并让用户确认是否继续

• 纯链接处理（is_link_only: true ）：列出这些推文的 expanded_url ，提示用户手动转存网页内容后再改写，跳过这些条目先处理其余内容

• 并行 sub-agent（Task, general-purpose, model=sonnet），每条一个（跳过纯链接）

• 改写风格见下方「改写风格指南」

• 合并写入 digests/{date}/rewrite.md

改写风格指南（sub-agent prompt 必须包含）：

• 人称：第一人称，站在用户视角写，像发推/写公众号，不是写新闻稿

• 语气：口语化、短句为主，可以自嘲、可以直接，不端着、不用"值得关注的是"之类的套话

• 结构：标题（一句话抓眼球）+ 正文（200-400字），不要小标题堆叠

• 内容：先说事实（一两句话讲清楚发生了什么），再说自己的看法/体感，可以联系自身使用经验

• 禁止：AI 腔（"值得注意的是"、"本质上"、"标志着"反复出现）、过度总结、三段式排比、空泛的"未来可期"

• 参考调性：data/my-tweets/all.json 中的原创推文风格——中英混用、网络用语自然、技术人视角

风格分析（Style）

cd {SKILL_DIR} && bun scripts/analyze.ts style

分析个人推文风格，输出 data/my-style/style-profile.json 。

单条推文获取

cd {SKILL_DIR} && bun scripts/fetch-tweet.ts <tweet_id>

通过 X API v2 获取单条推文全文（含 note_tweet），JSON 输出到 stdout。

Notion 同步

cd {SKILL_DIR} && bun scripts/notion-sync.ts <following|bookmarks|all>

增量推送到 Notion 数据库。详见 references/notion-schema.md 。

配置

{PROJECT_ROOT}/config.json （gitignored）：

{ "client_id": "...", "client_secret": "...", "access_token": "...", "refresh_token": "...", "user_id": "...", "data_dir": "./data", "notion": { "following_db_id": "...", "bookmarks_db_id": "..." } }

参考文档

• references/x-api-endpoints.md — API 端点参考

• references/oauth-setup.md — OAuth 2.0 配置指南

• references/notion-schema.md — Notion 数据库 schema