x-article-publisher

X Article Publisher 是一个强大的自动化工具，旨在连接本地 Markdown 写作工作流与 X (Twitter) Articles 平台。它解决了网页编辑器常见的痛点，例如繁琐的手动格式设定、重复的登录流程以及麻烦的图片管理，通过脚本化的发布流程，让您能维持本地文件结构与 Git 版本控制。

本工具专为内容创作者、开发者与需要发布长文的使用者所设计，协助您在本地管理文档，同时能顺畅地将内容更新至 X 平台。通过内置的持久化浏览器自动化，它能有效处理 2FA 与登录状态，最长可维持七天的登录有效期，确保发布工作不受中断。

• 自动将 Markdown 语法（包含标题、引用、粗体、列表与超链接）转换为 X Articles 支持的格式。

• 具备安全的持久化认证机制，大幅降低频繁手动登录的频率。

• 简化图片处理流程，自动识别封面图并自动上传文章内容中的图片。

• 提供“仅存草稿”模式，确保内容安全，让您在发布前可在浏览器中检视草稿。

• 支持进阶元数据解析，可从 Markdown 文件中直接提取标题与封面图等结构化数据。

• 使用前需具备 X Premium Plus 会员资格，并于 macOS 环境下执行 Python 3.9+。

• 主要界面为 publish_article.py，作为触发自动化流程的核心代码。

• 通过 auth_manager.py 进行认证管理，用户可随时检查、验证或清除存放在本地数据目录中的浏览器状态。

• 转换后的内容会自动保存至 X 草稿箱，需由用户进行最终手动检阅与发布。

• 目前仅支持 macOS 系统，因其依赖于特定系统级剪贴簿与 UI 框架 (AppKit/PyObjC)。