Xqueue

📁 用文件夹管理你的推文排期

用文件夹管理推文排期,无需前端,文件系统即界面,支持线程、多媒体和自动填充

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

使用说明

核心用法

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 免费额度

Xqueue 内容

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