Xqueue

🗂️ 文件夹即排期表,推文自动发布

基于文件系统的X/Twitter自动排期工具,通过文件夹结构管理推文发布,无需前端界面,适合极简工作流的技术用户。

收藏
4.5k
安装
1.3k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

XQueue 是一款极简主义的X(Twitter)内容调度工具,其核心设计理念是"文件系统即界面"。用户通过创建日期/时间文件夹结构来规划推文发布,配合定时任务实现自动化推送。

工作流程:运行安装脚本配置发布时段 → 在对应时间文件夹放入 .md.txt 推文文件 → 可选添加媒体附件 → cron每15分钟检查并自动发布 → 发布后自动清理文件

特色功能

  • Backlog机制:未指定时间的推文放入 backlog/ 文件夹,系统会在空档时段自动按字母顺序抽取发布
  • 线程支持:单文件内用 --- 分隔多段内容,自动拆分为推文串
  • 社区定向:首行标注 Post to [社区名]: 即可定向发布至X社区
  • 媒体附件:同文件夹内放置图片/视频(JPG/PNG/GIF,最多4个),按字母顺序附加

配置项:时区、分隔符、发布后删除策略、社区ID映射、日志路径、干跑模式等,存储于 config.json

显著优点

1. 极致简洁:无数据库、无Web界面、无依赖膨胀,纯文件操作降低认知负荷
2. Git友好:推文内容可版本控制,便于协作与回滚

3. Batch写作流: backlog机制支持批量创作后自动消化,减少 scheduling 焦虑

4. 资源占用极低:Python单文件脚本,适合长期运行在低配置服务器或本地机器

5. 社区原生支持:针对X社区功能的定向发布,对社群运营者实用

潜在缺点与局限性

  • 时间精度有限:15分钟检查间隔意味着实际发布时间可能有滞后
  • 无预览与校验:缺乏发布前的字符计数可视化、媒体预览、重复内容检测
  • 单平台锁定:仅支持X/Twitter API,无多平台同步能力
  • 文件系统依赖:移动设备操作不便,不适合需要随时调整的非桌面场景
  • 无失败重试机制:API限流或网络故障可能导致内容丢失(文件已删但未成功发布)
  • 安全性考量:凭证以环境变量或可选Keychain存储,无内置加密或权限隔离

适合人群

  • 偏好"文件优先"工作流的开发者与技术写作者
  • 需要稳定、低维护成本社交媒体自动化的独立创作者
  • 习惯于批量创作内容、接受固定发布节奏的内容运营者
  • 希望将推文纳入Git版本控制的技术团队

常规风险

  • 误删风险deleteAfterPost 默认开启,若API调用成功但响应异常,可能导致内容丢失
  • 时区配置错误:跨时区用户易因 timezone 配置失误导致发布时间偏差
  • 凭证泄露:环境变量方式在共享服务器或CI日志中存在暴露风险
  • 内容重复:关闭自动删除后,周循环机制会导致历史内容重复发布
  • API变更:Twitter/X API政策与计费模式频繁调整,存在功能突然失效可能

安全评估:需授予文件系统读写及Twitter API网络访问权限,凭证管理可选系统Keychain。建议运行于隔离环境,定期备份backlog与配置。

Xqueue 内容

手动下载zip · 11.3 kB
README.mdtext/markdown
请选择文件