主题
这页按 当前实现 汇总 HNWarehouse 已可使用的命令入口。
当前主命令：
text
/hnwarehouse
/hnwh玩家常用命令
/hnwarehouse open <玩家名|UUID> <仓库> [页面]
text
/hnwarehouse open <玩家名|UUID> <仓库> [页面]打开目标玩家的仓库 GUI。
说明：
- 玩家查看自己时，也需要显式带上自己的名字或 UUID
- 只带
<仓库>时，默认打开仓库总览 - 再补
<页面>时，直接进入对应页面 - 查看他人仓库需要额外权限
权限：
hnwarehouse.command.openhnwarehouse.command.open.others（查看他人仓库）
/hnwarehouse purchase <仓库>
/hnwarehouse purchase <玩家名|UUID> <仓库>
text
/hnwarehouse purchase <仓库>
/hnwarehouse purchase <玩家名|UUID> <仓库>购买指定仓库。
说明：
- 玩家执行单参数形式时，默认给自己购买
- 控制台必须使用双参数形式
- 如果目标仓库配置了需要玩家在线才能处理的条件，目标玩家离线时会收到额外提示
权限：
hnwarehouse.command.purchasehnwarehouse.command.purchase.others
/hnwarehouse unlock <仓库>
/hnwarehouse unlock <玩家名|UUID> <仓库>
text
/hnwarehouse unlock <仓库>
/hnwarehouse unlock <玩家名|UUID> <仓库>解锁指定仓库。
说明：
- 玩家执行单参数形式时，默认给自己解锁
- 控制台必须使用双参数形式
- 常用于“购买后仍需一次性解锁”的仓库设计
权限：
hnwarehouse.command.unlockhnwarehouse.command.unlock.others
/hnwarehouse expand <仓库> <页>
/hnwarehouse expand <玩家名|UUID> <仓库> <页>
text
/hnwarehouse expand <仓库> <页>
/hnwarehouse expand <玩家名|UUID> <仓库> <页>扩容指定仓库页。
说明：
- 玩家执行双参数形式时，默认给自己扩容
- 控制台必须使用三参数形式
- 页扩容是否可用取决于目标页是否配置了
expansion.enabled: true
权限：
hnwarehouse.command.expandhnwarehouse.command.expand.others
管理与排查命令
/hnwarehouse reload
text
/hnwarehouse reload重载配置与运行时服务。
当前语义：
- 管理员触发后会先收到“正在后台重载，请稍候...”提示
- 真正的配置读取、运行时收尾与新 runtime 构建在后台执行
- 重载期间会暂时拒绝新的运行时入口，避免旧 runtime 继续接收任务
- 如果重复执行，会提示“正在重载中，请稍后再试”
- 虽然改成后台执行，但仍保留安全收尾与 session 保存语义
权限：
hnwarehouse.command.reload
/hnwarehouse status
text
/hnwarehouse status查看插件运行状态。
当前会输出：
- 插件版本
- Debug 模式
- 存储后端
- 统一存储系统初始化状态
- 在线 Session 数量
- 自动保存间隔
- 离线摘要缓存秒数
- capture 三种来源配置
HNEconomy Hook状态HNCore 共享物品库状态- 仓库定义数量
- 访问限制统计
item-admission统计- 条件类型统计
- 各仓库与各页面的骨架摘要
权限：
hnwarehouse.command.status
/hnwarehouse inspect <玩家名|UUID> [detail|access]
text
/hnwarehouse inspect <玩家名|UUID>
/hnwarehouse inspect <玩家名|UUID> detail
/hnwarehouse inspect <玩家名|UUID> access查看指定玩家的仓库摘要。
模式说明：
- 默认：输出仓库与页面摘要
detail：额外输出具体条目 ID、材质与数量access：聚焦访问与锁定状态，不展开页面摘要
当前会显示：
Session 已加载状态，便于区分当前更接近内存态还是离线摘要链路- 总仓库数 / 总页数 / 总占槽 / 总容量 / 总物品数
- 当前可访问仓库数与锁定仓库数
- 各仓库当前状态：可访问、未解锁或受限
- 锁定原因与
visible-when-locked purchase / use / unlock条件摘要item-admission规则摘要
补充说明：
detail更适合做条目级排查，会额外输出条目 ID、材质与数量access更适合只看访问状态，不展开页面摘要- 如果后台读取失败，执行者会收到明确失败提示，而不是静默无结果
权限：
hnwarehouse.command.inspect
/hnwarehouse routecheck <玩家名|UUID> <仓库> [manual|reward|auto-collect]
text
/hnwarehouse routecheck <玩家名|UUID> <仓库> [manual|reward|auto-collect]预览投递路由结果。
说明：
- 只能由玩家执行
- 使用 执行者主手物品 作为模拟投递物品
- 默认来源为
manual
当前会输出：
- 目标玩家与目标仓库
- 主手物品名称、材质与数量
- 预计可投递页
- 预计存入数量与剩余数量
- 被拦截仓库列表
- 被拦截原因
- 命中的访问条件或
item-admission规则
权限：
hnwarehouse.command.routecheck
/hnwarehouse withdraw <玩家名|UUID> <仓库> <页面> <条目ID> [数量]
text
/hnwarehouse withdraw <玩家名|UUID> <仓库> <页面> <条目ID> [数量]将指定仓库条目提取并回填到在线玩家背包。
说明：
- 目标玩家必须可解析
- 查看 / 提取他人物品需要额外权限
- 不带数量时，默认尽可能按服务侧规则提取
- 带数量时必须为正整数
- 如果你是通过 GUI / 聊天确认链路帮其他玩家提取，还会额外涉及
hnwarehouse.gui.withdraw.others
权限：
hnwarehouse.command.withdrawhnwarehouse.command.withdraw.othershnwarehouse.gui.withdraw.others（GUI / 聊天提取他人物品）
/hnwarehouse unlockforce <玩家名|UUID> <仓库>
text
/hnwarehouse unlockforce <玩家名|UUID> <仓库>强制解锁指定玩家仓库。
适合：
- 处理异常状态
- 活动补偿
- 管理员人工修复仓库状态
权限：
hnwarehouse.command.unlockforce
/hnwarehouse unlockreset <玩家名|UUID> <仓库>
text
/hnwarehouse unlockreset <玩家名|UUID> <仓库>重置指定玩家仓库解锁状态。
适合：
- 回滚误操作
- 测试购买 / 解锁流程
- 运营活动重置资格
权限：
hnwarehouse.command.unlockreset