核心用法
XQueue 是一款极简主义的 X(Twitter) 自动发布调度工具，完全依赖文件系统作为用户界面。用户通过创建 星期/时间/ 的文件夹结构来规划内容，将 .md 或 .txt 文件放入对应时隙即可实现定时发布。
工作流程
1. 初始化配置: 运行 python3 xqueue-setup.py 设置每日发布次数、时间点、时区、X 社区等参数
2. 内容投放: 将推文文件放入 xqueue/Monday/9am/ 等具体时隙，或暂存于 backlog/ 文件夹
3. 自动执行: 每 15 分钟 cron 任务检查当前时间，匹配时隙则发布内容，空时隙自动从 backlog 按字母序补货
4. 清理归档: 发布后默认删除源文件，记录到 posted.log
内容格式支持
- 简单推文: 纯文本
.md/.txt文件（限 280 字符） - 线程推文: 单文件内用
---分隔多条推文 - 媒体附件: 同文件夹放置 JPG/PNG/GIF（单图<5MB，GIF<15MB，最多4张）
- 社区定向: 首行以
Post to [社区名]:开头实现定向发布
显著优点
| 维度 | 优势 |
|------|------|
| **极简架构** | 零数据库、零前端、零依赖服务，纯 Python + 文件系统实现 |
| **Git 友好** | 内容即文件，天然支持版本控制、代码审查、协作编辑 |
| **离线优先** | 所有内容本地存储，无需联网即可准备发布队列 |
| **灵活调度** | 精确时隙 + backlog 自动补货双模式，兼顾确定性与批量生产 |
| **透明可控** | 文件系统即真相源，浏览文件夹即可查看完整发布计划 |
| **低成本运维** | 仅需 Python 环境 + cron，无云服务商锁定 |
潜在局限
- 时间精度: 15 分钟检查间隔意味着实际发布时间有 0-15 分钟漂移
- 单账号限制: 配置绑定单一 X 账号，多账号需多实例
- 无可视化: 纯 CLI/文件操作，对非技术用户门槛较高
- 错误恢复弱: 发布失败仅记录日志，无重试机制或告警通知
- 媒体处理基础: 无图片压缩、格式转换等预处理功能
- 周期固定: 严格按周循环，不支持复杂规则（如跳过节假日）
适合人群
- 技术背景的独立开发者、创作者，偏好 "code over click"
- 需要 Git 版本控制内容发布流程的团队
- 追求极简基础设施、避免 SaaS 订阅费的用户
- 内容生产节奏规律、可提前批量准备的账号运营者
常规风险
- 误删风险:
deleteAfterPost: true为默认设置，发布后源文件永久删除，需自行备份重要内容 - 重复发布: 若关闭自动删除，周循环机制将导致内容重复推送
- API 限流: 依赖 X API v2，需关注速率限制与权限变更
- 时区陷阱: 服务器与配置时区不一致可能导致发布偏移
- 凭证安全: API Key 存储于环境变量或 macOS Keychain，共享环境需特别注意隔离