用途
X Article Publisher 用于把 Markdown 文章发布到 X（Twitter）Articles 编辑器，并在转换过程中保留原有格式（如标题、加粗、链接、列表、引用等）。它适合需要将本地 Markdown 文件或 URL 内容整理后发布到 X Articles 的场景。
主要能力
- 解析 Markdown，提取标题、封面图、内容图片、分割线以及转换后的 HTML，并输出结构化 JSON。
- 通过 Python 脚本把 HTML 或图片复制到系统剪贴板，实现富文本粘贴。
- 支持将 Markdown 表格转换为 PNG 图片（table_to_image.py），以应对 X Articles 不支持原生表格渲染的情况。
- 支持将 Mermaid 图表转换为 PNG 图片（需安装 @mermaid-js/mermaid-cli）。
- 自动检测 Markdown 中的分割线（---），并提示通过 X Articles 的 Insert > Divider 菜单插入（HTML 的 <hr> 标签会被 X 忽略）。
- 按 block_index 精确定位图片和分割线的插入位置，并建议从大到小的顺序插入以避免位置偏移。
- 提供封面图上传、标题填写、正文粘贴、内容图片插入、分割线插入、保存草稿的完整工作流。
使用方式
- 准备环境：安装 Playwright MCP；确保已登录 X 且拥有 Premium Plus 订阅；安装 Python 3.9+ 及依赖（macOS：pip install Pillow pyobjc-framework-Cocoa；Windows：pip install Pillow pywin32 clip-util）；如需 Mermaid 转换，安装 npm install -g @mermaid-js/mermaid-cli。
- 解析 Markdown：运行 parse_markdown.py 获取 JSON 数据，或使用 --html-only 输出 HTML 到临时文件。
- 打开 X Articles 编辑器：导航到 https://x.com/compose/articles，点击 create 按钮进入编辑器。
- 上传封面图：使用 browser_file_upload 上传第一张图片作为封面。
- 填写标题：在标题输入框中填入解析得到的标题。
- 粘贴正文：用 copy_to_clipboard.py 将 HTML 复制到剪贴板，然后在编辑器中按 Meta+V 粘贴，保留富文本格式。
- 插入内容图片：对每张内容图片，按 block_index 从大到小的顺序，复制图片到剪贴板，点击目标段落后按 End 键，再按 Meta+V 粘贴，并等待上传完成。
- 插入分割线：通过 X Articles 的 Insert > Divider 菜单插入，同样按 block_index 从大到小操作。
- 保存草稿：检查内容后保存为草稿，工具不会自动发布。
适用场景
- 需要把 Markdown 格式的长文发布到 X Articles，并希望保留标题、加粗、链接、列表、引用等格式。
- 文章中包含表格或 Mermaid 图表，需要先转换为图片再发布。
- 文章中包含分割线，需要通过 X Articles 菜单插入。
- 希望以草稿形式保存，人工审核后再发布。
限制
- 需要用户已登录 X 且拥有 Premium Plus 订阅。
- 依赖 Playwright MCP 进行浏览器自动化，若 MCP 连接异常需按故障排除步骤处理。
- 不会自动发布，只保存草稿。
- 表格和 Mermaid 图表需要预先转换为图片，X Articles 不支持原生表格渲染。
- 分割线必须通过 Insert > Divider 菜单插入，HTML <hr> 会被忽略。
- 图片路径若找不到，脚本会尝试在 ~/Downloads、~/Desktop、~/Pictures 中自动搜索同名文件；若仍找不到，上传会失败。
- 点击包含链接的段落时可能误触链接，需按 End 键将光标移到行尾以避免位置偏移。
- 关于收费、价格、平台支持范围等更多信息，资料中暂未提供。