核心用法
baoyu-danger-x-to-markdown 是一款将 X（原 Twitter）内容转换为 Markdown 格式的命令行工具，主要功能包括：
- 推文/线程转换：提取单条或多条推文，生成带 YAML 前置元数据的 Markdown 文件
- X Articles 完整提取：支持长文章格式的内容导出
- 媒体下载：可选将图片、视频下载至本地
imgs/和videos/目录，并自动重写 Markdown 链接为本地相对路径 - 灵活配置：通过 EXTEND.md 文件自定义媒体下载策略（每次询问/总是下载/从不下载）和默认输出目录
使用流程：
1. 首次运行强制配置：通过 AskUserQuestion 交互式询问用户偏好（媒体处理、输出目录、配置存储位置），创建 EXTEND.md
2. 每次转换前检查用户授权：读取 consent.json，若未授权则显示免责声明，获取明确同意
3. 执行转换：bun/npx bun scripts/main.ts <url>，支持 -o 指定输出、--json JSON 输出、--download-media 下载媒体
认证方式：优先使用环境变量 X_AUTH_TOKEN 和 X_CT0，失败则自动打开 Chrome 登录并缓存 Cookie
显著优点
- 完整的元数据保留：输出包含作者信息、推文数量、封面图等结构化 YAML 数据
- 线程完整性：支持完整导出推文线程，而非仅单条推文
- 本地归档能力：媒体下载功能便于建立完全离线的个人知识库
- 配置层级清晰：项目级、用户级、XDG 标准路径三级配置，兼顾团队协作与个人偏好
- 运行时灵活：自动检测
bun或降级至npx，降低环境依赖门槛
潜在缺点与局限性
- 非官方 API 依赖：使用逆向工程 API，X 平台随时可能变更接口导致工具失效
- 账号安全风险：存在触发平台风控、导致账号限制或封禁的可能性
- 无持续保障：开发者不提供长期维护承诺，功能损坏可能无法及时修复
- 首次配置阻塞：强制交互式配置虽保护用户知情权，但降低了自动化场景的可用性
- PowerShell 与 Bash 脚本分离：跨平台路径检测逻辑重复，维护成本较高
适合人群
- 研究人员与记者：需要系统归档社交媒体内容作为参考资料
- 内容创作者：备份自己的推文历史，便于二次创作或迁移平台
- 数字档案管理员：建立结构化的社交媒体内容离线归档
- 技术用户：能够理解和接受逆向工程工具的风险，具备 CLI 环境配置能力
常规风险
| 风险类别 | 具体描述 |
|---------|---------|
| 服务可用性 | X API 变更可能导致工具随时失效，无预警 |
| 账号安全 | 频繁或批量请求可能触发反爬虫机制，导致账号临时限制或永久封禁 |
| 数据完整性 | 非官方接口可能无法 100% 还原推文样式（如投票、卡片等特殊格式） |
| 隐私合规 | 导出他人推文需遵守平台条款及当地数据保护法规 |
| 依赖维护 | 项目活跃度不确定，长期依赖存在技术债务风险 |
建议：重要内容建议配合官方数据导出请求（Twitter Archive）作为备份，本工具更适合增量归档与即时转换场景。