核心用法
XQueue 是一款极简主义的 X（原 Twitter）内容调度工具，彻底摒弃传统 SaaS 的 Web 界面，将整个工作流程映射到本地文件系统。用户通过创建 xqueue/ 目录下的日期/时间层级文件夹（如 Monday/9am/）来规划发布日程，将 Markdown 或纯文本文件拖入对应槽位即可完成排期。
该工具采用每周循环机制——周一 9 点的文件夹会在每个周一触发。当特定时段无内容时，系统自动从 backlog/ 目录按字母顺序提取最旧文件填充空位，实现"时间敏感内容精准投放 + 常青内容自动补位"的混合策略。发布后文件默认自动删除，避免重复推送。
功能亮点：支持线程（以 --- 分隔）、社区定向发帖（首行标注 Post to [社区名]:）、最多 4 张图片/GIF 附件、时区自定义、以及 dry-run 测试模式。
显著优点
- 架构极简：零数据库、零服务器、零订阅费用，纯 Python 脚本 + cron 即可运行
- 工作流友好：与开发者/写作者的现有工具链无缝集成（Obsidian、VS Code、Git 版本控制）
- 离线优先：所有内容本地存储，可随时用文件管理器直观浏览队列状态
- 容错设计：280 字符自动校验、超额内容记录错误日志而非静默失败、社区 ID 强制验证避免配置遗漏
- 自动化 backlog：智能填充机制降低日程规划的心理负担
潜在局限
- 时间精度：15 分钟轮询间隔意味着实际发布时间有 0-15 分钟延迟
- 平台绑定：仅支持 X/Twitter API，无 Mastodon/Bluesky 等多平台适配
- 协作壁垒：纯本地架构难以支持团队协作或移动端管理
- API 依赖：受 X API 速率限制与计费政策变动影响（Consumer Key 等凭证需自行申请）
- 无可视化：对非技术用户存在显著学习曲线，文件操作失误可能导致意外发布
适合人群
- 独立开发者、技术博主等习惯 Markdown 工作流的内容创作者
- 追求数据主权、反感 SaaS 订阅模式的隐私敏感用户
- 已拥有 X API 凭证（Basic/Free tier）的自动化爱好者
- 需要版本控制推文草稿的写作者（Git 管理
xqueue/目录）
常规风险
- 凭证安全：
X_ACCESS_TOKEN等敏感信息以环境变量或 macOS Keychain 存储，需避免泄露至版本控制 - 误发风险：文件命名或目录拖拽错误可能导致内容进入错误时段或社区
- API 变更：X 平台政策调整可能导致功能突然失效
- 数据丢失：
deleteAfterPost开启后，已发布内容仅从日志追溯，无内置备份机制 - 字符计数陷阱：含 Unicode 字符（如 emoji）的 280 字符边界判断需依赖 X API 实际返回，本地预校验可能存在偏差