核心用法
XQueue 是一款基于文件系统的 X（Twitter）内容排程工具，彻底摒弃传统社交媒体管理工具的数据库和图形界面。用户通过创建星期/时间的文件夹结构来规划发布日程，将 .md 或 .txt 文件拖入对应时段即可实现自动发布。
工作流程：
- 运行
xqueue-setup.py初始化配置，设置每日发布次数、时区、社群目标等参数 - 在
Sunday/10am/等路径下放置推文文件，支持纯文本、线程（---分隔）、社群定向（Post to Community:前缀）及多媒体附件 - 15 分钟 cron 任务自动检测：有内容则发布并清理，空槽则从
backlog/按字母序取最旧内容填充 - 每周循环执行，未设具体时间的素材统一存入 backlog 待命
显著优点
1. 架构极简：零依赖前端、零数据库、零网络面板，纯 Python + 文件系统实现，部署维护成本极低
2. 开发者友好：版本控制友好（Git 可追踪），批量编辑便捷（任意文本编辑器/脚本），符合 Unix 哲学
3. 智能兜底：backlog 自动填充机制解决「内容产出节奏 ≠ 发布节奏」的错配问题
4. 线程与社群原生支持：单文件多推文的线程格式、社区定向发布均为一等公民功能
5. 透明可审计：文件夹即队列，posted.log 即日志，无黑箱状态
潜在局限
- 精度限制：15 分钟轮询间隔意味着实际发布时间存在 0-15 分钟延迟，不适合秒级时效场景
- 单实例约束：文件锁机制未明确说明，多机并发访问同一目录可能导致竞态条件
- 删除即永久：默认
deleteAfterPost: true虽防重复，但误删或配置错误可能导致内容丢失无回收 - 平台绑定：深度耦合 X API，迁移成本较高；社群 ID 需手动配置，无自动发现
- 字符硬限制：280 字符超限即拒发，非自动截断或拆分，需人工预处理
适合人群
- 习惯本地优先、文件驱动工作流的开发者/技术写作者
- 追求「基础设施即代码」理念的独立创作者，希望推文日程与项目代码同仓库管理
- 内容产出波动大、需要「写时不管排，排时不管写」分离策略的批量创作者
- 反感 SaaS 订阅、偏好自托管基础设施的隐私敏感用户
常规风险
- 重复发布风险：若
deleteAfterPost误设为 false，周期性 cron 将导致内容无限重发 - 时区配置陷阱：跨夏令时切换需手动验证，未明确说明自动处理机制
- 媒体体积限制：图片 5MB/GIF 15MB 的硬限制需前置检查，超限静默失败
- API 凭据暴露：
config.json含社群 ID 等敏感信息，需确保文件权限与仓库.gitignore配置 - 字母序依赖：backlog 排序依赖文件名前缀数字，无拖拽重排功能，命名策略失误将导致发布顺序混乱