bangdream-shift 使用指南
bangdream-shift 是一款基于 Koishi 框架开发的 Bang Dream! 班表管理与活动数据追踪工具。本手册详细介绍了其核心功能及指令用法。
📅 班表管理系统 (Shift Management)
班表功能支持创建、编辑、展示以及多人协作，适合活动跑号、排班使用。
1. 基础管理指令
- 创建班表
create-shift <name> <start> <end>
创建一个新的班表。时间格式建议使用YYYYMMDDHH。
示例：create-shift 309ppp 2025121015 2025121821 - 列出班表
ls-shift
查看当前群组绑定的所有班表。带有*标记的为当前正在使用的班表。 - 切换班表
switch-shift <name>
在已有的多个班表中，切换当前群组生效的班表。 - 删除班表
remove-shift <name>
彻底删除班表（仅限班表创建者/所有者群组执行）。 - 修改结束时间
set-shift-ending <end>
调整当前班表的活动结束时间。
2. 排班操作 (Shift Editing)
- 添加排班 (常规)
add-shift <person> <day> <startHour1> <endHour1> [更多时间段...]
在指定天数（从活动开始算第几天）为某人添加排班区间（24小时制）。
示例：add-shift 沙绫 1 9 12 14 16(表示第1天 添加9-12点和14-16点的班) - 一键排班 (文本解析)
add-shift-once <day> <text>
通过一段自然文本批量识别多人的排班信息。
示例：add-shift-once 岛村卯月 10-12 14-16 大桥彩香 18-20 - 删除排班
del-shift <person> <day> <start> <end> ...
从指定人的排班记录中移除特定时间段。 - 更换排班
exchange-shift <oldName> <newName> <day> <start> <end> ...
将某个时间段内的 A 成员替换为 B 成员。 - 重命名成员
rename-person <oldName> <newName>
全局替换当前班表中该成员的所有出现名称。 - 设定时段颜色 (标记)
set-shift-color <day> <start> <end> <color>
为特定时段设置特殊的背景颜色color可选值：gray(灰色),black(黑色),invalid(失效/禁止),none(清除颜色)。
3. 可视化与查询
- 展示班表图
show-shift <day>
调用渲染后端，生成并发送指定天数的完整排班图。 - 展示换班表图
show-shift-exchange <day>
生成换班信息的视图（换班专用）。 - 查询空缺 (剩余时段)
show-shift-left <day>
查询当前班表中未满员的时段以及所缺人数。
4. runner管理
- 设定目标顺位
set-runner <name> <ranking>
为成员标记目标（如main,10,100,1000），渲染时会体现差异。 - 删除runner人员
del-runner <name>
5. （进阶）协作与权限
- 分享班表
share-shift <shift_name> <group_id>
允许其他群组（如副群、分会）共同管理该班表。 查看/撤销分享
shift-group-ls <name>: 查看当前有哪些群组拥有该班表权限。revoke-shift <name> <group_id>: 撤销指定群组的管理权限。
🏎️ 车速定时推送 (Speed Tracker)
此功能用于在活动期间定时监控排名分数变动，自动计算“时速”。
开启定时推送
interval-speed-on [server] [-p player]
在当前频道开启整点推送。server: 服务器缩写（jp,cn,en,tw,kr）。-p: 可选，指定关注的排名或玩家 ID。
- 关闭定时推送
interval-speed-off
停止当前频道的定时任务。
🛠️ 后台配置参数 (BOT主)
在 Koishi 管理控制台插件设置页可以调整：
openShift: 班表功能开关。openSpeedTracker: 测速推送开关。defaultServer: 默认查询服务器。backendUrl: tsugu后端的 URL 地址。
本文部分内容使用 Gemini 根据源代码生成
文档版本：v1.0.0 更新日期：2026-01-09