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)。