mozillach/content-queue

gh-projects-content-queue

镜像概述

基于GitHub项目的内容精选队列工具，最初用于推文管理。支持众包内容创作、提升协作效率并增强内容质量管控能力。

核心功能

• 将推文表示为GitHub Issues
  • 支持回复与转发
  • 自动将未处理的提及转化为新Issue
• 自动将Issue添加到专用项目看板的指定列
• 自动发布专用看板指定列中的Issue内容
• 验证Issue内容是否符合发布要求
• 支持精确时间调度发布
• 反应小组系统：提醒人员响应提及
• 按固定间隔自动发布指定列内容（类似Buffer工具）
• 对到期未就绪的帖子发送提醒
• 从iCal feed自动创建活动相关帖子
• 从Discourse新线程自动创建帖子
• 从Atom/RSS feed自动创建帖子
• ***支持
  • 支持回复、转发与内容警告（spoiler）

计划功能

• 帖子置顶管理（可能先支持***，因其有相关API）
• 查看所有带有enhancement标签的Issue

使用场景

适用于需要协作管理社交媒体内容、整合多源内容（如博客、论坛、活动）并进行质量控制的团队或个人，尤其适合开源社区、内容运营团队等场景。

配置说明

仓库设置要求

1. GitHub用户认证令牌

   • 登录GitHub账号，进入设置→个人访问令牌→生成新令牌
   • 选择public_repo权限（若用于组织需额外选择read:org）
   • 将令牌添加到配置文件的accounts.github.token字段

2. ***** API凭证**

   • 在developer.***.com/apps创建应用（需先申请开发者账号）
   • 复制消费者密钥、密钥，以及访问令牌、密钥到配置文件对应字段

3. ***** OAuth令牌**

   • 在***实例（如https://your-instance.example.com）的/settings/applications/new创建应用
   • 授予read:accounts、read:statuses、write:statuses等读写权限
   • 复制访问令牌及实例API地址（如https://your-instance.example.com/api/v1）到配置文件对应字段

4. 环境要求

   • Node.js ≥ 8.0.0

Docker部署示例

该镜像仅支持通过环境变量配置，以下为启动命令示例：

bash
docker run -d \
  --name content-queue \
  -e GITHUB_TOKEN="your_github_token" \
  -e TWITTER_CONSUMER_KEY="your_twitter_consumer_key" \
  -e TWITTER_CONSUMER_SECRET="your_twitter_consumer_secret" \
  -e TWITTER_ACCESS_TOKEN="your_twitter_access_token" \
  -e TWITTER_ACCESS_SECRET="your_twitter_access_secret" \
  -e MASTODON_ACCESS_TOKEN="your_mastodon_token" \
  -e MASTODON_INSTANCE_URL="https://your-mastodon-instance/api/v1" \
  docker.xuanyuan.run/mozillach/content-queue

测试运行

• 工具启动：执行npm start（需先运行npm ci --production）
• 测试套件：执行npm test（包含eslint代码检查与ava单元测试）

更多配置细节请参考configuration.md。