feat: 发布咸鱼喵喵全能助手，加入全收集地图与图文说明

tool/使用须知.md

@@ -1,76 +1,52 @@
-# 使用须知（发布版，2026-10-03 修订）
+# 使用须知（发布版）
 
-## 确认当前操作哪份游戏
+更新：2026-10-24。完整功能说明见 [README](README.md)。
 
-看顶部“当前连接”和存档页“实际保存目录”。身份从游戏的 Node 入口及 StorageManager 存档路径读取，不依赖网页 URL。实机网页 URL 是 chrome-extension 地址。
+## 先确认实例
 
-调试端口可达不等于已连接，更不等于已进入地图。标题画面请正常读档；不要从外部直接调用 DataManager.loadGame 绕过游戏的 completeLoad 流程。
+看面板「当前连接」，建议确认为已创建的沙盒副本。端口可达不等于已读档；标题界面请从游戏正常菜单进入。移动/剧情需回地图，背包、百科和战斗支持菜单画面。
 
-## 常见提示
+不要自行调用裸 DataManager.loadGame：本游戏读档还要重建物理网格。请通过游戏菜单正常读档。
+
+## 常见操作
 
 | 提示或现象 | 处理 |
 |---|---|
-| 调试端口和面板端口相同 | 设置两个不同的端口，再启动 |
-| 端口上的游戏与目标不符／无法识别 | 关闭占用该端口的游戏，或为各实例配置不同端口；不会自动放行 |
-| 旧服务或旧配置占用面板端口 | 停止旧面板后再启动；本次升级前的旧服务需关闭原来的命令行窗口 |
-| 副本缺失／复制未完成 | 不启动残缺副本；选择新的空目录重建。不会覆盖已有目录 |
-| 地图、存档或连接已变化 | 刷新状态并重新读取本图事件／扫描角色，旧列表不能用于新地图 |
-| 莉莉娅脚下不安全 | 她保持悬浮；移动到安全地面再点“落地” |
-| 跨地图超时 | 工具会取消尚未完成的传送请求；确认游戏是否被菜单或演出占用，再重试 |
-| 备份失败 | 不会继续启动需要备份的游戏或覆盖槽位。检查目录、磁盘空间及是否仍在写档 |
-| 当前有摆拍角色，提示不推荐保存 | 读档后摆拍状态可能无法完整恢复；可自行决定继续保存，不要求先撤销 |
+| 端口上的游戏与目标不符 | 关闭占用实例或改端口，不会自动放行 |
+| 地图、存档或连接已变化 | 刷新并重读旧列表 |
+| 百科“前往分块边缘” | 优先目标分块边缘，堵住就改到邻近分块/同图其他空处，保持悬停并恢复碰撞，再自行前往获取 |
+| 地图怎么传送 | 点击方格或图标选中，再点右侧「传送到此分块」；游戏菜单中可看图，需回地图后传送 |
+| 地图太小或图标看不清 | 选择大区域后点「适应地图」，用滚轮/加号放大、拖动查看 |
+| 地图灰色图标和问号 | 灰色 ✓ 为已收集，? 为条件无法判定；「只看未收集」不包括未知点 |
+| 图标尚未加载 | 等待片刻，或点刷新数值与背包；不影响数量操作 |
+| 关闭穿墙被拒绝 | 先微调到空处；开着悬停不代表已离开墙体 |
+| 脚下没有安全地面 | 继续悬停，移动到安全处再落地 |
+| 空中跳跃/下降 | 悬停中可连续点跳，按住游戏下键下降；技能移动保留 |
+| 悬停与穿墙的区别 | 悬停仍受实心地形阻挡；开穿墙后四向均可穿过 |
+| 已经卡进地里 | 先开穿墙，跳到空处再关穿墙；脚下安全后可落地 |
+| 悬停换地图 | 通过原版出口换图，保留悬停和穿墙；无出口的边界仍会阻挡 |
+| 配饰栏位不足 | 增加铃铛或卸下其他配饰 |
+| 无法减少地图铃铛 | 勾选对应选项；此举会重置部分地图收集点 |
+| 秒杀没有生效 | 需有效命中敌人；不会突破剧情无敌或无限生命对象 |
 
-悬浮时按跳跃仍可能一直向上运动；关重力没有取消跳跃输入。落地会检查地形，“全部还原”会直接恢复正常物理状态，使用时应处于安全位置。
+## 保存与恢复的边界
 
-## 搜索和剧情
+普通手动和自动存档照常，数值和背包修改可能随游戏保存。全部还原只解除辅助，不回退物品、数值及剧情变化。
 
-发布版从游戏运行时读取全文台词，全部在内存中使用，不写剧本或缓存文件。先开面板再开游戏也会自动读取；故事表未就绪时最多尝试四次、间隔至少三秒，仍失败会显示原因，可手动重新读取。断线、换实例或重连都会使旧台词失效，重连成功后自动补齐。
+发布版不提供快照、逐帧或输入录制（TAS）。常规游戏存档备份与还原继续可用。
 
-搜索覆盖整段台词和说话人，并显示命中句；未连接时仍可搜索地图、坐标、事件和条件。
+## 数据来源与收集状态
 
-“运行过场”包含剧情指令，可能改变游戏开关和进度。分支剧情可能跳过先前的演出；前往只自动设置普通开关，不承诺还原完整历史进度。没有任何一页提供角色形象的事件，也不能凭空生成合适 NPC。
+百科里的「背包未拥有」和「地图未收集」不是同一回事。食物吃掉或配饰删除后，原来的拾取记录仍在。商店只列候选入口，实际库存由进度决定；未知奖励不会被判成未收集。
 
-## 场景还原与撤销
+面板「地图」显示原版分块示意布局，包含未探索和隐藏区域；查看不会修改游戏探索记录。它与百科共用来源和状态，当前覆盖全部 411 个官方收集点，但未索引的动态掉落也不会凭空出现在图上。分块传送复用百科备用落点规则，目标受阻时可能抵达同图的邻近分块或其他空处，请留意到达提示。
 
-恢复的角色是固定的摆拍对象，不再自动执行原事件、移动或参与物理碰撞。清除“已抹除”状态只是临时操作；撤销会恢复修改前的字段、原有抹除状态及方法。
+发布版从当前游戏运行时读取全文台词，仅保存在内存中。自动读取最多尝试四次、间隔至少三秒；失败后可手动重新读取。断线、换实例和重连会清除旧内容；未连接时仍可搜索地图、坐标、事件和条件。百科、世界地图与物品图标同样从运行时读取，无需提供完整提取资料。
 
-“被抹除”不证明这个人应该出现在当前剧情。选择哪些角色和站位仍需核对画面；不要把全部恢复后的画面当成原作的准确复现。
+## 剧情、摆拍与备份
 
-摆拍期间自动和手动存档照常，工具不拦截游戏自身的保存。顶部提示不推荐摆拍时保存；面板保存的原有确认框会说明风险，仍可确定继续。完成后可撤销；切图或正常读档自动撤销。面板关闭或失联超过两分钟也会撤销，恢复事件原有行为。
+运行过场会执行整个事件页，可能改变开关和剧情；只播台词不等于完整还原演出。#305 的整页过场可能先播放 #298/#299，直接回看请用只播台词。临时摆拍不保证跨读档恢复；切图、正常读档或面板失联两分钟会撤销，普通存档照常生效。升级前关闭旧面板和游戏，再启动新版本并刷新页面。
 
-这次没有实现“保存并读回完整摆拍布局”。临时函数、UI 显示状态、剧情解释器不承诺跨存档复现。
+还原备份前先关闭游戏。工具校验存档文件与来源，保留还原前的 save 目录和额外安全备份；目标自己的 Steam 云配置保留。备份不存在的槽位不会混入恢复结果。任何恢复操作都应明确选择原版或沙盒目标。
 
-## 备份与还原
-
-- 新备份记录来源，使用唯一目录并校验每个 .rmmzsave 文件。未完成或损坏备份不列为可恢复项。
-- 旧时间戳备份仍可读取，但显示来源未知。还原时必须明确选目标，不能凭备份名称猜。
-- 还原前先退出游戏和 NW.js 游戏窗口，防止运行中的游戏把旧状态写回。
-- 还原得到所选备份中的完整存档集合；备份没有的槽位不会继续留在当前 save 目录。
-- 当前存档会先备份；原 save 目录保留为游戏目录下的 `.save-before-restore-…`，不会直接删除。
-- steam_autocloud.vdf 等非存档文件保留目标目录自己的版本，不从另一份游戏的备份覆盖。
-
-## 已知画面限制
-
-先前记录的“切换剧情分支时角色短暂抽动”，没有足够实机证据保证所有地图均已解决；本轮不把它标成已修。相同立绘的多个事件、剧情自身的移动与刷新仍可能影响演出效果。
-
-并非全部剧情均已验收。遇到问题请记录故事编号、地图、事件页、存档进度和使用的按钮。
-
-
-## 本轮剧情显示与定位修复
-
-#370 横排重复角色的原因是动画图整张显示，现已同步单帧裁切修复。升级后需重启面板和游戏，再刷新网页，才会加载新的游戏内 helper。
-
-运行无形自动/并行控制事件时，会优先保留同图的安全站位，或在目标地图寻找可落地位置。找不到安全地面会停止启动剧情并提示手动定位。运行过场在准备完成后尝试落地；普通手动传送仍默认悬浮。自动选点不等于还原原作站位。
-
-#305 的“运行过场”仍可能先播同页的 #298/#299；直接查看 #305 请用“只播台词”。
-
-
-## 角色与背包、锁定
-
-“角色与背包”页可设置并分别锁定金币、HP、SP、ZP，以及搜索、添加、移除背包物品。作用于当前操作角色，包含切换后的莉莉娅形态，不修改独立跟随的莉莉娅。金币范围 0～99999，其余不能超过当前最大值；不会改变上限。已倒下时请先在游戏里复活或读档。
-
-消耗品默认遵循携带上限，可勾选超上限（最多 99999）。移除装备会同步卸下，移除当前武器会换到另一件已有武器，至少保留一件。铃铛容量、任务及收集进度不在修改范围内。
-
-锁定立即阻止该数值的消耗和增加。读档、新游戏、面板失联超过两分钟或点“全部还原”会解除锁定；已修改的数值和背包不会回退，正常保存会把当前数值和物品写进存档。
-
-本轮同时更新了摆拍人物贴地、原图待机动画和面向主角。仅对原页要求贴地的人物小范围探地，飞行角色和固定摆件不强制落地；撤销恢复原始位置和朝向。首次升级这批摆拍修复，需要重启面板和游戏后刷新网页。
+详细安装与默认端口见 README；独立目录可使用 config.example.json，但必须先修改示例路径。