主题
这页是纯速查版。
如果你已经知道命令大概做什么，但不想翻长文档，可以直接从这里找。
一、最常用的 10 条命令
text
/signin
/hnsignin status
/hnsignin query <玩家>
/hnsignin reload
/hnsignin template-reset <玩家> all
/hnsignin template-reset <玩家> current-weekly
/hnsignin template-reset <玩家> current-monthly
/hnsignin template-grant <玩家> final-reward final
/hnsignin migrate-storage preview
/hnsignin migrate-storage validate如果你只记这几条，已经足够覆盖大部分日常使用与排障。
二、玩家命令
| 命令 | 用途 |
|---|---|
/signin | 打开签到日历 GUI |
/hnsignin | 与 /signin 等价，玩家打开 GUI |
/hnsi | /hnsignin 的简写别名 |
三、基础管理
| 命令 | 用途 |
|---|---|
/hnsignin reload | 重载配置与服务 |
/hnsignin status | 查看运行状态、存储后端、补签策略与补签消耗摘要 |
/hnsignin query <玩家> | 查看玩家当前签到状态与奖励投递摘要 |
补充说明：
- 控制台直接执行不带参数的
/hnsignin不会打开 GUI - 这时应改用
/hnsignin status或/hnsignin query <玩家>
最推荐的组合
改完配置后确认是否生效
text
/hnsignin reload
/hnsignin status玩家反馈“今天状态不对”
text
/hnsignin query <玩家>四、模板状态维护
| 命令 | 用途 |
|---|---|
/hnsignin template-reset <玩家> all | 清空所有模板状态并重置个人循环 |
/hnsignin template-reset <玩家> weekly | 清空全部周模板状态 |
/hnsignin template-reset <玩家> monthly | 清空全部月模板状态 |
/hnsignin template-reset <玩家> personal | 仅重置个人七日循环 |
/hnsignin template-reset <玩家> current-weekly | 仅清空当前周周期模板状态 |
/hnsignin template-reset <玩家> current-monthly | 仅清空当前月份模板状态 |
最推荐的组合
只想回放当前周活动奖励
text
/hnsignin query <玩家>
/hnsignin template-reset <玩家> current-weekly
/hnsignin query <玩家>只想重测当月模板
text
/hnsignin template-reset <玩家> current-monthly个人七日循环跑乱了
text
/hnsignin template-reset <玩家> personal五、模板奖励补发
| 命令 | 用途 |
|---|---|
/hnsignin template-grant <玩家> fixed-cycle <1-7> | 补发固定 7 日周期某一天奖励 |
/hnsignin template-grant <玩家> period-accumulate <门槛> | 补发周期累计奖励 |
/hnsignin template-grant <玩家> personal-cycle <1-7> | 补发个人七日循环某一天奖励 |
/hnsignin template-grant <玩家> calendar-days <日期> | 补发月指定日历天奖励 |
/hnsignin template-grant <玩家> milestones <门槛> | 补发月累计里程碑奖励 |
/hnsignin template-grant <玩家> final-reward final | 补发月终奖 |
常见例子
text
/hnsignin template-grant Steve fixed-cycle 1
/hnsignin template-grant Steve personal-cycle 7
/hnsignin template-grant Steve period-accumulate 3
/hnsignin template-grant Steve calendar-days 15
/hnsignin template-grant Steve milestones 10
/hnsignin template-grant Steve final-reward final注意：
- 当前要求目标玩家在线
- 命令会先登记奖励待发记录，再执行实际发奖
- 如果部分动作失败，失败记录会保留为待重试状态
六、奖励补偿与重试
| 命令 | 用途 |
|---|---|
/hnsignin retry-rewards <玩家> | 重试玩家当前未完成的奖励投递 |
适合场景
text
/hnsignin query <玩家>
/hnsignin retry-rewards <玩家>
/hnsignin query <玩家>补充说明：
- 目标玩家必须在线
- 打开签到 GUI 时，插件也会自动触发一次未完成奖励重试
query现在会显示奖励投递总数和待重试数量
七、存储迁移与校验
| 命令 | 用途 |
|---|---|
/hnsignin migrate-storage preview | 预览 yaml -> database 与 database -> yaml，不写入 |
/hnsignin migrate-storage preview overwrite | 按覆盖模式预览双向迁移 |
/hnsignin migrate-storage validate | 校验 YAML 与 database 两侧数量与摘要是否一致 |
/hnsignin migrate-storage yaml-to-database confirm | 将 YAML 数据迁移到 database |
/hnsignin migrate-storage yaml-to-database overwrite confirm | 以覆盖模式把 YAML 覆盖到 database |
/hnsignin migrate-storage database-to-yaml confirm | 将 database 数据迁回 YAML |
/hnsignin migrate-storage database-to-yaml overwrite confirm | 以覆盖模式把 database 覆盖到 YAML |
使用顺序建议
text
/hnsignin migrate-storage preview
/hnsignin migrate-storage validate
/hnsignin migrate-storage yaml-to-database confirm
/hnsignin migrate-storage validate- 真正迁移必须显式追加
confirm - 不追加
overwrite时，目标后端里已有的玩家数据会被跳过 - 预览、迁移、校验都会导出报告到
plugins/HNSignIn/migration-reports/
八、按场景选命令
玩家说今天已经签过，但你觉得不对
text
/hnsignin query <玩家>先看业务日与重置时间，不要先改数据。
玩家说补签不了
text
/hnsignin query <玩家>先确认当前业务日、最近签到与模板状态，再去核对补签窗口。
想重新测当前周模板
text
/hnsignin template-reset <玩家> current-weekly想重新测当前月模板
text
/hnsignin template-reset <玩家> current-monthly奖励本该发，但漏发了
text
/hnsignin query <玩家>
/hnsignin retry-rewards <玩家>如果确认并不是已有投递失败，而是根本没有登记到这条奖励，再考虑 template-grant。
九、给新手运维的最短排查口诀
可以直接记成下面这句：
先
query看状态，再template-reset回放，最后才template-grant补发。