用途:把 X(Twitter)的推文、线程和 X 文章转换为带 YAML front matter 的 Markdown 文件,便于归档或二次编辑。
主要能力:推文/线程转为 Markdown;X 文章可提取完整内容;输出含 url、author、tweetCount、coverImage 等 front matter;可选下载图片与视频到本地 imgs/ 和 videos/ 目录并改写链接为相对路径;支持 --json 输出。
使用方式:脚本位于 scripts/ 子目录,路径为 ${SKILL_DIR}/scripts/main.ts。常用命令: npx -y bun ${SKILL_DIR}/scripts/main.ts <url> npx -y bun ${SKILL_DIR}/scripts/main.ts <url> -o output.md npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --download-media npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --json 选项包括 <url>、-o <path>、--json、--download-media、--login(仅刷新 cookies)。支持的 URL 形如 https://x.com/<user>/status/<id>、https://twitter.com/<user>/status/<id>、https://x.com/i/article/<id>。
同意与配置:使用前须检查并获取同意,同意文件位于 macOS 的 ~/Library/Application Support/baoyu-skills/x-to-markdown/consent.json 或 Linux 的 ~/.local/share/baoyu-skills/x-to-markdown/consent.json;缺失或版本不符时展示免责声明并询问是否接受。偏好通过 EXTEND.md 配置,优先项目级 .baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md,其次用户级 $HOME/.baoyu-skills/baoyu-danger-x-to-markdown/EXTEND.md;未找到时必须先完成首次设置,支持 download_media(ask/1/0)与 default_output_dir。取值优先级为 CLI 参数、EXTEND.md、技能默认值。
认证:优先使用环境变量 X_AUTH_TOKEN、X_CT0;回退方案为自动打开 Chrome 登录并本地缓存 cookies。
限制:使用逆向工程 API,非官方,X 变更 API 时可能失效,无保证与支持,可能导致账号受限,风险自负。资料未提供收费、价格与平台支持范围等信息。