核心用法
XQueue 将文件系统本身转化为 X/Twitter 的排程界面。用户通过创建 xqueue/ 目录结构,按星期和时间(如 Monday/9am/)放置 .md 或 .txt 文件即可设定发布计划。内置的 cron 每 15 分钟扫描一次:若当前时间对应文件夹有内容则发布并清理;若为空则自动从 backlog/ 文件夹按字母顺序拉取最旧内容填充。支持线程(用 --- 分隔)、多图/视频附件(同目录放置媒体文件)、以及 X 社区定向发布(首行标注 Post to Community:)。
显著优点
1. 极简架构:零数据库、零前端、零依赖复杂部署,纯 Python + 文件系统即可运行
2. 版本控制友好:推文内容即文本文件,天然适配 Git 管理、批量编辑和协作流程
3. 自动化兜底:backlog 机制允许批量创作,系统自动填充空档,降低排期焦虑
4. 多媒体支持:JPG/PNG/GIF 自动附加,最多 4 张,按字母序排列
5. 社区原生:内置 X Communities 支持,无需手动复制社区 ID
潜在局限
- 精度限制:15 分钟轮询周期意味着实际发布时间可能有 0-15 分钟延迟
- 单实例设计:无多用户或分布式锁机制,不适合团队协作同一账号
- 状态隐式:无可视化面板,队列状态需手动浏览文件夹或查看
posted.log - 字符硬性截断:超过 280 字符直接拒绝发布,无自动分段或提示修剪
- 平台绑定:API 变动(如 X API 计费策略调整)可能直接影响功能可用性
适合人群
- 开发者/技术写作者,习惯用文件和 Git 管理内容
- 追求极简工具栈的独立创作者和小团队
- 需要规律发布但不想维护复杂社媒管理后台的用户
常规风险
- 误删风险:
deleteAfterPost默认为 true,文件发布后永久删除,若未备份则内容丢失 - 重复发布:关闭
deleteAfterPost后,每周循环会导致相同内容重复推送 - 凭据暴露:需配置 X API 四元组(Consumer Key/Secret, Access Token/Secret),存在.env 泄露风险
- 时区混淆:依赖用户正确配置
timezone,错误设置导致发布时机错位 - API 配额:高频检查(15分钟)+ 多线程发布可能快速消耗 X API 免费额度