发布时间: 2026/06/04/12:00
本机器人供”顶尖桌游群”群友使用，用于向十三班书斋投稿文章。机器人涵盖文章的全生命周期管理：创建草稿 → 编辑内容 → 提交审核 → 管理员审核 → 发布上线 → 申请下架。
每位用户只能操作自己的文章，互不干扰。文章发布采用管理员审核制，用户提交后需管理员审批通过才会显示在网站上。
/init（首次初始化）
↓
/create（创建草稿）
↓
/edit（编辑标题/作者/内容）
↓
/submit（提交审核）
↓
管理员 /getauditlist → /viewaudit → /approve（或 /deny）
↓（通过后）
文章自动发布到十三班书斋
↓
/requestoff（申请下架）
↓
文章下架，退回草稿箱数据以 JSON 格式存储在本地，按用户 QQ 号分目录，每个用户下包含三个子目录：
| 目录 | 说明 |
|---|---|
drafts/ | 草稿箱，存放未完成的文章 |
audit/ | 审核队列，存放等待管理员审核的文章 |
articles/ | 已发布，存放已在十三班书斋上线的文章 |
| 参数写法 | 含义 | 示例 |
|---|---|---|
<xxx> | 必选参数 | /create <标题> <作者> |
[xxx] | 可选参数 | /gitpush [提交信息] |
where | 位置标识 | drafts（草稿）、audit（审核）、articles（已发布） |
key | 编辑字段 | 1=标题、2=作者、3=内容 |
所有命令以 / 开头，参数之间用空格分隔。
首次使用必须执行，仅可执行一次。
/init执行后系统会为你创建个人数据目录，之后即可使用所有投稿功能。
/create <标题> <作者>示例：
/create 我的第一首诗 张三创建成功后返回草稿 ID，后续所有操作都基于此 ID。如果创建与已有草稿同名的标题，旧草稿会被覆盖。
/edit <draftId> <key> [value]修改标题（key=1）：
/edit 1 1 新的标题修改作者（key=2）：
/edit 1 2 李四修改内容（key=3）— 分两种方式：
方式一：直接在命令中传入内容
/edit 1 3 这是文章的正文内容...方式二：多轮编辑（推荐，适合长文）
/edit 1 3机器人会提示”请在下一条消息中直接发送文章内容”，然后你单独发送一条消息作为文章正文（支持 Markdown）。发送 /cancel 可取消本次编辑。
/cancel取消当前正在进行的内容编辑（仅在 /edit <id> 3 后的等待状态下有效）。
/draftlist列出你所有的草稿，显示 ID、标题、作者、更新时间。
/auditlist列出你所有正在审核中的文章。
/publist列出你所有已发布在十三班书斋上的文章。
/view <where> <id>示例：
/view drafts 1 查看草稿 ID 1 的完整内容
/view audit 3 查看审核文章 ID 3 的完整内容
/view articles 5 查看已发布文章 ID 5 的完整内容where 参数支持以下写法：drafts / draft / 草稿、audit / 审核、articles / article / 文章 / 已发布。
长文章会自动分段发送。
/submit <draftId>示例：
/submit 1将草稿提交给管理员审核。注意：文章内容不能为空，提交前请确保已用 /edit 添加了正文。
提交后文章从草稿箱移入审核队列，管理员会收到通知。
/withdraw <auditId>示例：
/withdraw 3将已提交审核的文章撤回到草稿箱，可在修改后重新提交。
/requestoff <publistId>示例：
/requestoff 5申请将已发布的文章从十三班书斋下架。下架后文章回到草稿箱，可再次编辑和提交。对应的网站 .md 文件会被自动删除。
以下命令仅限管理员使用。
/getauditlist列出所有用户提交的待审核文章，包含投稿人 QQ、审核 ID、标题、作者、提交时间。
/viewaudit <投稿人QQ> <审核ID>示例：
/viewaudit 123456789 3查看指定用户的某篇审核文章完整内容。执行后系统会记录当前审核上下文，之后可直接使用 /approve 或 /deny 处理。
/approve必须在 /viewaudit 之后使用。通过后文章将：
如果 Git 推送失败，文章仍会标记为已发布（
.md文件已写入本地），管理员稍后使用/gitpush可重试推送。
/deny [理由]示例：
/deny 内容太短，建议扩充到500字以上
/deny 存在错别字，请修改后重新提交拒绝后文章退回投稿人的草稿箱，投稿人可修改后重新提交。
/gitstatus查看网站 Git 仓库的当前变更状态（git status --short），用于确认有哪些文件待提交。
/gitpull从 GitHub 拉取远程仓库最新代码（git pull）。
/gitpush [提交信息]示例：
/gitpush 发布新文章：我的第一首诗
/gitpush 不填则自动生成 "bot: 自动更新 <时间>"执行完整同步流程：
git pull — 拉取最新代码git add -A — 添加所有变更git commit -m "<信息>" — 提交git push — 推送到 GitHub提示：
/approve审核通过时会自动执行同步。如果自动同步失败（如网络问题），可使用/gitpush手动重试。即使本地没有新的变更，也会尝试推送之前未推送的 commit。
/getpublist列出所有用户已发布到十三班书斋的文章，包含投稿人 QQ、文章 ID、标题、作者、发布时间。用于管理员了解全站已发布内容。
/init ← 首次使用
/create 我的诗 张三 ← 创建草稿
/edit 1 3 ← 进入内容编辑模式
（发送文章正文...） ← 多轮编辑
/draftlist ← 查看草稿确认无误
/submit 1 ← 提交审核
/auditlist ← 查看审核状态/getauditlist ← 查看审核队列
/viewaudit 123456789 3 ← 查看文章详情
/approve ← 审核通过（自动生成 .md + Git 推送）
/getpublist ← 查看所有已发布文章
/approve已包含自动 Git 推送，如果推送失败再使用/gitpush重试。
/viewaudit 查看文章，才能使用 /approve 或 /deny。/gitpush 重试。