PopRaKo Bot（白杨子 Bot）使用指南

所有 PopRaKo Bot 的命令均以 !（英文感叹号）开头。

如果你想要快速查阅对应命令，请使用 blog 右侧的目录，点击条目以快速跳转。

---

⚠️ 常见问题

如果你发现 PopRaKo Bot 没有回复你的命令，可能原因如下：

• 命令格式错误：请检查是否遗漏参数或使用了中文符号。
• Bot 宕机或维护中：请联系管理员 Hatsu1ki 进行修复。

---

📚 呼出帮助文档

显示完整的命令帮助列表，适用于快速回顾所有功能。

!help

---

🔐 绑定账号

首次使用 Bot 前，请先完成身份绑定。

!bind [-a <ACCESS_TOKEN>] [-n <NICKNAME>]

参数说明：

• -a 或 --access-token：你的访问令牌（暂时不用）
• -n 或 --nickname：可选昵称，用于展示（不填则使用 QQ 群昵称）

示例：

!bind -a JdK2l3XyZ9 -n Jane_Doe

---

👤 用户与角色管理

查看我的详细信息

显示当前用户的个人信息，包括绑定状态、拥有的角色及默认设置。

!me show

---

设置我的默认角色

设定你在参与项目时自动使用的默认分工角色 ID。此设置会影响快捷命令 !pj 的行为。

!me role set -d <ROLE_ID>

参数说明：

• -d 或 --default：指定要设为默认的角色 ID

分工 ID 对照表：

职位	ID
翻译	1
校对	2
嵌字	3
美工	4
监修	5
图源	6

示例：将默认角色设为“校对”

!me role set -d 2

---

查看我最近参加的项目

列出你最近加入的若干个项目（按“加入时间”排序）。不同身份重复加入会刷新时间。

!me project [-n <NUM>]

简写：

!mp

参数说明：

• -n 或 --num：显示的数量，默认为 1

示例：查看最近参加的 5 个项目

!mp -n 5

---

📂 项目集管理（Project Sets）

项目集是项目的分类容器，便于组织和归档大量项目。

列出所有项目集

展示系统中存在的项目集列表。

!project-set list [-n <NUM>]

参数说明：

• -n 或 --num：限制显示数量，默认全部列出（暂时不用）

示例：列出所有项目集

!project-set list

---

创建新的项目集

新建一个项目集用于归类相关项目。

!project-set create -t <PROJECT_SET_TITLE>

参数说明：

• -t 或 --title：项目集标题（必填）

示例：

!project-set create -t 市场部年度活动

---

修改默认项目集

设置创建项目时的默认归属项目集。未显式指定项目集时将自动使用该值。

!project-set modify -d <PROJECT_SET_ID>

参数说明：

• -d 或 --default：默认项目集 ID

示例：设置默认项目集为 ID 3

!project-set modify -d 3

---

🚀 项目管理（Projects）

核心功能模块：创建、查询、加入与发布项目。

创建新项目

创建一个属于某个项目集的新项目。

!project create -t <PROJECT_TITLE> [-s <PROJECT_SET_ID>]

简写：

!pc

参数说明：

• -t 或 --title：项目名称（必填）
• -s 或 --set-id：所属项目集 ID（可选，若未指定则使用默认项目集）

示例：

!pc -t [草草你的]看看我的

---

列出最近项目

获取近期更新的项目列表，支持按时间和发布状态筛选。

!project list [-d <DURATION>] [-p <IS_PUBLISHED>]

简写：

!pl

参数说明：

• -d 或 --duration：代表天数的整数，，如 7（7天）
• -p 或 --published：是否仅显示已发布项目，取值为 true 或 false，默认为 false

示例：列出过去 30 天内已发布的项目

!pl -d 30d -p true

---

加入项目

你可以自己加入项目，也可以邀请他人加入并分配角色。

快捷方式：以默认角色加入项目

!pj -p <PROJECT_ID>

示例：

!pj -p 42

此命令将以你通过 !me role set 设定的默认角色加入 ID 为 42 的项目。

完整命令：邀请他人加入并指定角色

!project join -p <PROJECT_ID> [-u <USER_QQ>] [-r <ROLE_ID>]

简写：

!pj -p <PROJECT_ID> [-u <USER_QQ>] [-r <ROLE_ID>]

参数说明：

• -u 或 --user：加入者的 QQ 号
• -p 或 --project：目标项目 ID
• -r 或 --role：为其分配的角色 ID

示例：邀请 QQ 号为 555555 的用户以“翻译”身份加入项目 42

!project join -u 555555 -p 42 -r 1

---

发布项目

将指定项目标记为“已发布”状态。

!project publish -p <PROJECT_ID>

参数说明：

• -p 或 --project：要发布的项目 ID

示例：

!project publish -p 7