《塞尔达传说：王国之泪》简体中文互动地图，支持天空/地上/地下三层切换、多图层同显、收集进度追踪、材料刷点查询与实时角色导航。
两条产品线，各自独立发版、互不影响： 地图（本条线，
totkmap-vX.Y.Z）与导航程序 TOTKNavi（totknavi-vX.Y.Z）在 Releases 里按前缀区分，可任意组合使用。
| 方式 | 操作 |
|---|---|
| 在线版 | 打开 https://totk.yalin.site/ |
| 本地 / 离线使用 | 下载地图包 TOTKmap-vX.Y.Z.zip（Releases 里 totkmap- 前缀），解压后浏览器打开 app/index.html；瓦片 / 图标 / 数据全部本地，断网可用 |
| 自行部署 | 把 app/ 整个文件夹放到任意静态服务器（Nginx / EdgeOne Pages / GitHub Pages 等）根目录，站点根目录指向 app/ 内容即可。推荐用静态服务器打开（如 VS Code Live Server、python -m http.server），瓦片加载比 file:// 更快 |
完成进度、自定义标记、图层选择自动保存在浏览器本地存储中，关页不丢。
入库边界：仓库只保留网页源码与数据产物、定位服务源码、人工任务档案。数据流水线工具、过程数据、备份、发布包一律不入库（见下方"不入库"清单），可复现产物已打进
app/。
TOTKmap/
├── app/ ← 网页地图（下载 / 部署只需这个文件夹）
│ ├── index.html ← 入口页面
│ ├── sw.js ← 离线缓存（Service Worker）
│ ├── assets/ ← 图标、材料图片
│ ├── css/ js/ data/ ← 样式、逻辑、地图数据（含任务卡片/流程/数据产物）
│ ├── vendor/ ← 第三方库（Leaflet 等）
│ └── tiles_obj/ ← 三层地图瓦片（天空 / 地上 / 地下）
├── tasks/manual/ ← 任务人工档案（YAML，任务卡片数据源，build 时并入 app/data/task-plan.js）
├── xnavi/ ← 定位核心工程（known 秒锁 / 指针链 / 自愈，双平台统一）
├── xnavi-gui/ ← 桌面导航程序 TOTKNavi-GUI（Wails 工程）
├── README.md ← 本说明
├── CHANGELOG.md ← 版本变更记录
└── .gitignore ← 入库边界定义
不入库（本地保留，均为过程产物或可重建）：
tools/— 数据流水线 / 瓦片与任务构建工具脚本（生成产物已打进app/）主线/情节/神庙/迷你挑战改版数据/、数据校对/— 任务校对过程数据（卡片数据已合入app/data/task-plan.js）归档/、tasks/manual-备份-*/、report/— 历史文档（含 live 系列退役引擎）、导入前备份、临时报告release/、certs/— TOTKNavi 桌面发布包与证书（发布时单独分发）
下载指引（两条线分开下，按需组合）：
- 只要地图 → Releases 里下载
totkmap-vX.Y.Z.zip（或直接用在线版） - 要桌面实时导航 → 再下载
totknavi-vX.Y.Z.zip，解压后把地图包的app/放到TOTKnavi.exe同目录即可联动 - 两者版本独立：新版地图配旧版导航、旧版地图配新版导航都能正常工作
配合 xnavi/ 构建的本地定位服务 TOTKNavi.exe（连接 Ryujinx / Eden 模拟器内存读取坐标，默认端口 8766），在线地图可实时显示你在游戏里的位置：红点 + 轨迹 + 金色引导线 + 距离读数，支持自动跟随切层、到达自动清除。
TOTKNavi-GUI（桌面定位导航程序，Wails 构建）：启动即秒锁定位（known 快路径），侧边栏四页——实时定位（坐标/层/锁定来源状态卡）、导航目标（与地图双向同步，可清除）、存档进度（20 类收集进度）、设置；点「开始定位」后自动打开地图并跟随玩家。
注意事项（发布包内 README.md 有完整版）：
- 解压到纯英文路径——路径含中文会导致程序无法正常运行（用户实测）
- 先启动模拟器并进入游戏（站在大地图上），再点「开始定位」
- 程序只读模拟器内存，不注入不改游戏；被杀毒拦截时加白名单即可
导航程序是独立产品线（Releases 里
totknavi-vX.Y.Z前缀），版本号不跟地图走；手机镜像需要本地离线地图包（totkmap-vX.Y.Z.zip），解压到TOTKnavi.exe同目录即可。
| 功能 | 说明 |
|---|---|
| 三层地图 | 天空 / 地上 / 地下一键切换，各自独立的标点、地名与瓦片；左侧层按钮可锁定当前层 |
| 高清瓦片 | 游戏内等高线地形风格瓦片，按层选格式（WebP q80），最大 1:1 像素仍清晰 |
| 多图层同显 | 位置 / 收集 / 装备 / 地点 / 怪物五大类可任意勾选组合，一键全选 / 清空 |
| 官方地名 | 1312 处官方中文地名直接印在地图上（objmap Location 坐标），随缩放分层显隐，自动防重叠 |
| 存档同步 | 上传《王国之泪》progress.sav，自动读取游戏真实收集进度（鸟望台、神庙、树根、龙之泪、克洛格、魔犹伊等），解析全程本地完成；内置同步存档 · 帮助（模拟器/游戏版本、存档位置、加载技术） |
| 探索度面板 | 加载存档后按「探索 / 任务 / 收集 / 讨伐」四大组双列展示完成数，含 6 类 Boss 讨伐进度，点击展开/收起 |
| 中英双语 | 设置面板一键切换界面语言；神庙 / 鸟望台 / 树根 / 克洛格等点位显示官方英文名，长文攻略保持中文 |
| 一键全选 | 左侧每个大分类标题右侧可一键「全选 / 清空」该组全部分类，按图层分别记忆 |
| 材料收集 | 110 种材料共 44,279 个刷点（地表/地底/天空全覆盖），勾选即在地图上显示；supercluster 聚合 + 数量徽标，最大缩放到 z7 尺寸时逐点显示、每个材料点可点 |
| 材料详情卡 | 256×256 高清图标 + 用途标签（升级素材/料理材料/强化材料）+ 导航/收集/标记完成三按钮；收集后自动定位下一未采集点 |
| 材料性能优化 | 聚合半径随缩放级别动态调整（100%=96px → 800%=128px）+ 移动防抖，地下 12000+ 刷点场景拖动依旧流畅 |
| 龙轨迹 | 四条龙的飞行轨道独立图层，数据直接来自游戏本体 ROMFS 官方轨道（精确贝塞尔曲线 + 真实飞行高度）：白龙（低空/高空双轨大圈 + 2 条联络轨 + 初岛支线，约 33km）/ 奥尔龙（14.3km）/ 费罗龙（8.6km）/ 聂尔龙（10.4km）。入口在侧栏「位置」大组末尾的「龙的轨迹」小分类，点一下显示/隐藏，跨层通用；实线 = 当前层域内的轨迹、虚线 = 另一层域（地上看地下段用虚线，地下看地上段用虚线），沿线箭头指示飞行方向 |
| 搜索定位 | 按神庙/地名/任务/物品名搜索，回车直达并居中放大；材料 Tab 内独立搜索 |
| 完成标记 | 点击标点查看详情，可标记为已完成，进度保存在本地 |
| 自定义标记 | 在地图空白处添加带名称的个人标记 |
| URL 深链 | ?actor=<物品名> 直达材料刷点，?q=<关键词> 自动搜索 |
| 移动端适配 | 窄屏默认收起面板，触控缩放平移，详情卡自动变底部抽屉 |
- 探索收集：神庙 120、鸟望台 15、龙之泪 12、克洛格 742、双倍克洛格 98、宝箱 191、魔犹伊 147、设计图石板 1
- 设施地点：村庄 10、驿站 17、大妖精之泉 4、女神像 14、古代研究所 4、神殿 1、地洞入口 36、洞穴入口 189、井 58、烹饪点 63
- 材料刷点：植物/蘑菇/水果/昆虫/鱼/矿岩 6 大类共 110 种、44,279 个点位
- 地名：官方中文地名 1312 处（含同名多坐标点，如河流/山脉分段标注）
- 区域为按官方区域中心点的近似归属，个别边界点可能偏差
- 部分材料点位为社区数据，冷门物品可能保留英文名
- z7 瓦片未纳入仓库（EdgeOne 文件数限制），最大缩放到 z7 尺寸由 z6 瓦片 2× 缩放实现（清晰度等价 z6）
两条产品线各自独立发版，在 Releases 里按前缀区分：
| 产品线 | Releases 前缀 | 当前版本 | 说明 |
|---|---|---|---|
| 网页地图（本仓库主体） | totkmap-vX.Y.Z |
v2.6.0 | 中英双语 + 地图交互五项升级；在线版 https://totk.yalin.site 同步 |
| 导航程序 TOTKNavi | totknavi-vX.Y.Z |
v3.0.0 | 跨场景持久槽定位，传送 / 神庙零重扫，1.5 秒秒锁 |
更新明细见 CHANGELOG.md。