QuickView v1.0.4

视角书签 Mod 的 1.0.4 版本。这一版把编辑面板的「保存」讲清楚了，另外加了一个开关：装了 Tweakeroo 的话，可以让它的灵魂出窍来接管视角。

本版新增

「使用 Tweakeroo 灵魂出窍」开关

装了 Tweakeroo 时，可以在设置页把「切换视角」交给它的自由相机实现（默认关闭）：
打开开关后点书签，相机就会以 Tweakeroo 的方式出现在那个机位，移动、输入、视角恢复都由 Tweakeroo 负责，QuickView 只负责把相机摆到书签的位置和朝向。觉得哪套手感更顺手就用哪套。

• 没装 Tweakeroo 时这一项会置灰，功能自动使用 QuickView 自带的实现
• 该模式下「受伤立即恢复」照常生效；按 B（或菜单「恢复视角」）会连同 Tweakeroo 的自由相机一起关掉，回到本体
• 已知取舍：Tweakeroo 接管时，设置里的「平滑过渡」不生效（相机由 Tweakeroo 按 tick 驱动）

编辑面板补上「取消 / 保存」

• 新建书签（点 + 后）：底部是 取消 / 保存 —— 保存才留下，取消直接丢弃，不会再留下一条空书签
• 编辑已有书签：底部是 取消 / 保存 / 复制 —— 取消会回滚本次所有改动（改之前是什么样就还回什么样）
• 原来的「复制为新书签」按钮文案精简为「复制」

其他改进

• 书签列表以内存为准：同一存档/服务器内不再每次操作都读盘，只在切换世界或维度时重载；打开界面也少读一次盘，操作更跟手
• 搜索更快：过滤时复用已建好的条目控件；拼音转换对英文字母走快路径
• 快捷存点的默认名字跟随语言：中文环境下是「视角 3」而不是英文 View 3
• 构建开启 Gradle 配置缓存（对本机构建更快，不影响游戏内）

修复

• 自由视角的偏航角没有归一化：长时间转视角后数值会一直累加（存进配置里可能出现 4321.0 这类怪值，角度换算精度也会下降）。现在统一归一到 [-180, 180)

升级提示

把 quickview-1.0.4.jar 放进 mods/ 覆盖旧版即可，已有书签与设置都不受影响。

需要 Fabric Loader ≥ 0.18.3、Fabric API 与 LibGui 15.1.0（15.x），Java 21。Tweakeroo 为可选。

Full Changelog: v1.0.3...v1.0.4

QuickView v1.0.3

视角书签 Mod 的 1.0.3 版本。这一版加了两个日常很实用的功能：批量归组和书签克隆，另外自由视角下受伤会自动回到本体。

本版新增

受伤立即恢复视角
自由视角下受到伤害时，立刻回到本体视角，并把打开中的 QuickView 界面一并关掉（否则会出现「已经回到本体、却因为界面拦着而动不了」）。带吸收心（金苹果）时受击同样会触发。默认开启，可在设置页关闭。

批量归组
主界面新增「归组」模式：点书签勾选（绿色标记，红=将删除、绿=将归入分组），底部按钮变成「归组已选 (N)」，点它从上方展开的下拉里选目标分组 —— 支持「＋ 新建分组…」「（无分组）」以及各已有分组，选中即一次性批量移入。随时可以再归组或移出，所以不弹确认框。

书签克隆
编辑面板底部新增「复制为新书签」：复制出一份坐标、朝向、分组都一样的新书签（名字自动加「副本」后缀），并直接切到副本的编辑面板，方便稍作修改后另存一个机位。

其他改进

• 分组下拉里「当前所在的分组」置灰：编辑面板里该书签当前的分组（没分组时是「（无分组）」）会变暗、点不动；批量归组时取勾选项的共同分组，分属不同分组则不置灰任何行
• 设置页：功能说明里提到的快捷键会跟随你的实际改键立即刷新（以前要重进设置页才更新）
• 编辑面板落盘更聪明：只在内容真的改动时才写盘 —— 既不像旧版每次失焦都写一遍，也不会因为崩溃/强杀而丢掉编辑内容
• 拼音搜索加了缓存：书签多时输入更跟手
• 依赖要求写准确了：LibGui 限定 15.1.0 ~ 15.x（代码依赖其内部结构，跨大版本会出问题），Fabric Loader 要求 ≥ 0.18.3（这是 LibGui 15.1.0 自身的要求，之前写的 0.17.0 实际无法满足）

修复

• 编辑面板里的垃圾桶删除曾经静默失效：确认框照常关闭，但书签并没有被删掉（1.0.2 起就存在）。原因是关闭编辑页会重载列表、使待删除对象的引用失效，现在改为用稳定下标定位
• 从「删除 / 归组」切到「编辑 / 排序」后，列表上会残留红/绿勾选框

升级提示

把 quickview-1.0.3.jar 放进 mods/ 覆盖旧版即可，已有书签与设置都不受影响（新配置项在旧配置文件里缺省时按默认值处理）。

需要 Fabric Loader ≥ 0.18.3、Fabric API 与 LibGui 15.1.0（15.x），Java 21。

Full Changelog: v1.0.2...v1.0.3

QuickView v1.0.2

视角书签 Mod 的 1.0.2 版本。相对上一版（1.0.1），这一版补齐了日常使用最需要的几件事：搜索、排序、分组、批量删除，并把界面整体重新排了一遍。

本版新增

拼音搜索
书签列表支持中文原文、全拼、声母三种输入，多音字按词组上下文取音：
家里面 可搜 jia / jialimian / jlm，矿洞Boss房 可搜 kdbf。
（拼音库已打进 jar，无需额外安装）

拖拽排序
点「排序」按钮进入排序模式，按住条目拖动即可调整顺序 —— 条目跟着光标走、落点有预览框，松手才落位并保存。

分组与分组筛选
给书签填一个分组名，主界面左上角的分组按钮点开即可按分组筛选（不再需要反复循环点击）。

批量删除
进入「删除」模式后点击条目即可勾选（红色边框标记，不会立刻删除），勾选后底部按钮变成「删除已选 (N)」，点它才会弹出一次确认，确认后批量删除。清理大量书签不用再点几十次确认。

设置项持久化
设置页的开关（快速添加、自由移动、灵魂出窍优先、平滑过渡）现在会保存到 .minecraft/config/quickview.json，改了就存、重启后保持。

可选平滑过渡
切换视角时可以选择瞬间跳过去，也可以平滑飞过去（设置页开关，默认关闭）。

删除前二次确认
删除书签会先弹确认框，避免误删。

其他改进

• 菜单键可开可关：再按一次 V 直接关闭菜单，不必再按 ESC（在输入框里打 V 不受影响）
• 菜单里点「恢复视角」立即恢复并关闭菜单
• 存档写入改为「临时文件 + 原子替换」：写一半崩溃不会损坏已有书签；文件格式升级为带版本号的对象，旧版裸数组格式仍可读取、保存时自动升级
• 书签名留空不再把书签改成无名（旧版清空名称框会把书签变成空名，删除确认里还会显示成「删除「」」）
• 界面细节：按钮改用自绘图标（齿轮 / 垃圾桶 / 下拉箭头）、清空改成搜索框内部的 × 图标（避免被误认为「关闭页面」）、模式开关右侧会随模式显示操作提示
• 设置页里提到的快捷键会跟随你的实际改键

升级提示

把 quickview-1.0.2.jar 放进 mods/ 覆盖旧版即可，已有书签与存档不受影响。

需要 Fabric Loader ≥ 0.17.0、Fabric API 与 LibGui ≥ 15.1.0，Java 21。

Full Changelog: v1.0.1...v1.0.2

QuickView 1.0.1

修复

• 自由视角下的书签快照：从自由视角通过 V 菜单新增书签（含编辑面板的「设为当前」）时，记录的坐标与朝向不再是玩家本体，而是当前正在看的相机机位 —— 存点后切回去就是刚才看到的位置。

新增

• 自由视角下按 N（快速保存）也能把当前机位存成书签，不再要求先退出视角
• 模组图标

安装

1. Minecraft 1.21.11 + Fabric Loader ≥ 0.17.0
2. 安装 Fabric API 与 LibGui
3. 把 quickview-1.0.1.jar 放进 mods/

纯客户端 Mod，服务端无需安装。

默认按键：V 打开菜单 / B 恢复本体视角 / N 快速保存 / G 自由移动 / H 灵魂出窍优先