Elegant and minimalist timeline & thread archiver for X.
极简的 X (Twitter) 时间线与帖子归档助手。
特性:
[!NOTE] 时间线上裸露在外的回复（推文串），或者帖子详情中回复下裸露的子回复，会自动跳过解析以符合数据直觉。
交互:
入口:
完整推文树:
原本想要内置自动获取并解析完整的推文树的功能，但似乎非常困难且容易造成账号风控。所以目前仍需手动点击进入回复详情页，来查看或归档特定的子回复。
仓库内置了一个极简的 twtree.py 脚本，专门用于合并数个 JSON 文件为完整的推文树，还支持导出人类阅读友好的 TXT 格式。
> ./twtree.py --help
usage: twtree.py [-h] [-i INDENT] [-t {json,txt}] [-f FORMAT] [files ...]
positional arguments:
files
options:
-h, --help show this help message and exit
-i, --indent INDENT
-t, --type {json,txt}
-f, --format FORMAT Line format for txt output.
Available placeholders: {id}, {time}, {name}, {handle}, {text}, {media}
Default: '{name}({handle}) {text}'
用法示例:
原始合并：输入数个 JSON，然后将合并后的 JSON 打印到标准输出
./twtree.py x/*.json
将自动查找没有父级帖子 ID 的孤立帖子作为树顶，允许包含多个树顶，
children 数组包含了子回复，允许多重嵌套，最终表达为完整的帖子树结构
人类阅读友好格式：输入数个 JSON，合并为 TXT，
> ./twtree.py x/*.json -t txt
合并后的 TXT，一个帖子一行，使用缩进表达层级嵌套的树结构
支持使用 -f 指定输出格式，默认为 {name}({handle}) {text}
数据结构示例 (JSON):
[!NOTE] 时间线（Timeline）的 JSONL 与帖子详情（Thread）的 JSON, 内部单条推文的数据模型是完全等价的
区别在于外层包装, JSONL 为逐行独立对象, JSON 为标准的数组结构
{
"id": "1890000000000000000",
"url": "https://x.com/username/status/1890000000000000000",
"context": "你已转贴",
"time": "2026-03-18T12:00:00.000Z",
"author": {
"name": "",
"handle": "",
"avatar": ""
},
"content": {
"text": "",
"media": []
},
"quote": {
"author": {
"name": "",
"handle": "",
"avatar": ""
},
"time": "",
"content": {
"text": "",
"media": []
}
},
"metrics": {
"replies": 0,
"retweets": 0,
"likes": 0,
"bookmarks": 0,
"views": 0
}
}