编辑器概览与导航树
QI 提供一整套游戏内可视化编辑器，让你不碰 YAML 也能创建 / 编辑物品、动作、套装等。GUI 编辑保存的就是同一份 YAML，与手写完全互通。
1. 打开编辑器
| 命令 | 打开 |
|---|---|
/qi editor | 类型浏览器（编辑根入口） |
/qi editor browse | 同上 |
/qi editor <itemId> | 直接打开某物品的物品编辑器 |
权限：qinhitems.editor。
🖼️ [图片占位]
/qi editor打开的类型浏览器界面 · 建议assets/editor-type-browser.png
2. 导航树总览
/qi editor → 类型浏览器（TypeBrowser）
│
└─ 选类型 → 物品浏览器（ItemBrowser，按类型过滤）
│
├─ 右键物品 / 新建 → 物品编辑器（ItemEdition）★主界面
│ ├─ 材质 / 品质 / 类型 / 显示名 / 物品名 / Lore（聊天输入）
│ ├─ 开关：无限耐久 / 发光 / 隐藏属性 / 隐藏附魔（即时切换）
│ ├─ 最大堆叠 / CustomModelData / 附魔总上限（聊天输入）
│ ├─ [动作/技能] → 动作编辑器（ActionRefsEdition）
│ │ ├─ 触发器标签页
│ │ ├─ [添加处理器] → 处理器选择器（ActionHandlerPicker）
│ │ │ └─ 选处理器 → 载荷表单（PayloadSchemaForm）或聊天输入
│ │ └─ [绑定技能] → 技能绑定（SkillBinding）
│ ├─ [宝石孔] → 宝石孔编辑器（GemSocketEdition）
│ ├─ [属性] → 属性编辑器（AttributeEditor）
│ │ └─ [基础值] → 基础值编辑器（BaseValueEditor）
│ ├─ [常驻效果] → 常驻效果编辑器（PermEffectEditor）
│ ├─ [附魔] → 附魔编辑器（EnchantmentEditor）
│ ├─ [限制] → 限制编辑器（RestrictionEditor）
│ ├─ [Provider] → Provider 浏览器（ProviderBrowser）
│ ├─ [模板] → 模板中心（TemplateHub）
│ │ ├─ 定义：Lore / 碎片 / 变量
│ │ ├─ 技能 / 能力 / 资源包
│ ├─ [套装] → 套装中心（SetHub）
│ │ ├─ 新建套装 / 绑定到现有套装
│ │ └─ 编辑套装（SetEdit）→ 件数 / 加成（SetBonusEdit）
│ ├─ [资源包/模型] → 资源包中心（ResourcePackHub）→ 模型选择器
│ └─ [保存]（槽位 53）
│
└─ 删除模式 / 翻页各子界面详情见对应子页。
3. 通用交互约定
| 操作 | 含义（多数界面通用） |
|---|---|
| 左键 | 编辑 / 选择 / 上移 |
| Shift + 左键 | 下移 |
| 右键 | 删除 / 取消 |
| Shift + 右键 | 删除 / 确认危险操作 |
| 聊天输入 | 很多字段点击后会关闭背包、提示在聊天框输入，输入 cancel 取消 |
| 翻页按钮 | 列表超过一页时上一页 / 下一页 |
聊天输入由 EditorChatInput 驱动，提示格式统一（带标题、提示、示例、cancel 取消）。
🖼️ [图片占位] 一次聊天输入提示（编辑显示名）的聊天框截图 · 建议
assets/editor-chat-prompt.png
4. 会话与保存
- 编辑会话（EditorSession）：按玩家跟踪当前编辑状态（工作副本、当前触发器、草稿等）。关背包不保存 = 丢弃改动。
- 保存（EditorSaveGuard）：点保存按钮（物品编辑器槽位 53）才写回 YAML。保存前会跑
PolicyEngine校验：有错误则提示并拒绝，有警告则提示但继续。保存后热重载动作表。
5. 重要特性
- 全功能 GUI 化：几乎所有 YAML 字段都能在 GUI 里编辑，YAML 只是持久化格式。
- 动作载荷不透明：QI 不解读处理器 payload，但若处理器注册了 载荷 schema，GUI 会生成带类型字段的表单。
- 套装全局：把物品绑进套装会自动更新套装 YAML，无需单独保存。
- MiniMessage Lore：显示名 / Lore 支持完整 MiniMessage。
- 权限单一：
qinhitems.editor一个权限管所有编辑功能，无细粒度分权。