feat: 1.5.3 station PIDS themes and navigation view API

docs/agents/MESSAGES.md

@@ -1,5 +1,29 @@
 # MESSAGES.md — Agent 交流墙（只追加，不改不删）
 
+## [2026-10-25 17:52] Codex — 最新公开MTR4.1内部UI研究完成
+
+- 用户要求读取最新4.1内部UI写法。重新ls-remote核对stonecutter HEAD=f05d99efab6f27b3868913438fce2da381e5798f，gradle.properties仍4.1.0-beta.2/Elementa743/UniversalCraft497；不冒称4.1正式版或发布包精确源码。新增docs/plans/mtr-4.1-ui-research.md并更新UI设计。
+- 采纳约束式布局、parent/child与稳定ID保留展开、释放判点击/拖动、重叠候选、父页/关闭提交；站点展开后各线路ETA默认可见。排除管理UI颜色/名称身份合并、移开关闭、全行draw/onTick重建和根WindowScreen直接嵌宿主。增加拖出再回原点不点击及刷新后滚动/焦点保持。
+- 直接复用有真实打包边界：NF shadow/relocate gg.essential与Kotlin，Fabric include；最新源码版本目录仅1.21.1/1.21.4。4.0六目标兼容不能靠改import证明，独立设置页复用仅候选，地图浮层先保持轻量共享方案；公共API维持纯JDK。
+- UTF-8/相对链接/代码围栏、全部MTR固定SHA路径、研究版本与依赖、diff检查通过。未复制实现/素材，未修改功能/版本/依赖、未构建或游戏实测。更新同一PR #1；任务释放。
+
+
+## [2026-10-25 17:43] Codex — 1.5.3游戏内UI调查与设计补充
+
+- 用户要求增加游戏内UI优化设计并开始调查。新增docs/plans/v1.5.3-ingame-ui.md，联动主计划与API草案：共享图层菜单、固定站点卡片、单一提示、GUIpx拾取/候选消歧、三语言/键盘/小窗口、覆盖状态、外部聚焦所有者与用户暂时全图覆盖；没有加入特定导航模组适配或任意UI注入。
+- 源码发现Xaero enabled隐藏绘制但点击未同门控、按钮/地图双提示路径，JM原生标题/车辆自绘提示并存及玩家维度地标集合，设置缺项目Screen、语言仅9个列车键；单机保持运行仍仅依赖车辆层且screen精确匹配，站点ETA需新兴趣上下文。以上未本轮实机复现，不等同已修复。
+- 公共JM API固定4a57dee（1.21.1_2.0.0），有可取消PRE点击/拖动但不是完整release/wheel/key桥；兼容JM5现有drawMap mixin需独立验证。参考Create 7ff2760的tooltip仲裁/生命周期，不复制素材。新增U0–U4及六平台视觉/输入/暂停/费用验收。
+- UTF-8/Markdown相对链接/源码固定路径/语言键核对/git diff --check通过；未改生产代码/版本，未构建/启动游戏/发布。工作在docs/1.5.3-station-board-api更新PR #1，准备任务释放，实施仍待领。
+
+
+## [2026-10-25 17:34] Codex — 1.5.3站点到站板与统一API设计准备完成
+
+- 用户指定目标1.5.3。仅完成公共源码核对与设计，未改生产代码/版本属性，未构建或发布。计划docs/plans/v1.5.3-station-board-extension-api.md，契约docs/api/overlay-api-v1-draft.md；草案并非已有API。
+- 单击站点展开固定到站板，默认折叠/按兴趣查询，按线路/方向/目的地/站台展示同源PIDS预测。原生缓存首次空/数量限制不能解释为完整无班次；全图目标维度由新服务端能力执行原生ArrivalsRequest。站点ETA恢复，车体悬停ETA/距离仍暂停。
+- API提供只读目录、可关闭区段/样式会话及同源站点订阅，Java17纯JDK契约；不加入特定第三方依赖或适配器。避免目前去重MapRoute充当有序导航路径；明确停站occurrence/路径歧义、半轨原生距离、复合rail ID、异步latest-wins、错代与生命周期。
+- 证据固定MTR f05d99e、Core 032baaf、Navigation df53387、howtogo 2b57bac。Core主线不是发布包内精确版本，P0必须实际依赖编译/原生对照。UTF-8/相对链接/固定源码SHA和路径/git diff --check通过，无游戏/性能实测。释放准备任务，实施任务待领。
+
+
 
 ## [2026-10-22 22:42] Codex-CI — CI/CD六平台与发布演练验收
 

docs/agents/STATE.md

@@ -7,11 +7,22 @@
 
 - **v1.5.2 正式版（main）**：TSC 全网实时车厢以双锚点显示为抽象纯 2D 符号，固定轨道→线路→车厢；客户端无行车模拟，附近仅为无动态服务端能力时的回退。GitHub [v1.5.2](https://github.com/teamCreating/MTR-Map-Overlay/releases/tag/v1.5.2) 已正式发布并设为 Latest。
 - 项目标识：MTR Map Overlay；mod ID `mtrmap`；Java 包 `io.github.teamcreating.mtrmap`；客户端命令 `/mtrmap`
-- 最后更新：2026-10-22 18:21，操作者：Codex
-- 版本管理：按用户要求固定 1.5.2，只有用户明确指示时才更改版本号；禁止自动递增。
+- 最后更新：2026-10-25 17:52，操作者：Codex
+- 版本管理：用户已指定下一目标1.5.3；本轮完成设计准备，代码属性/已发布附件仍为1.5.2，进入实现时统一调整双分支。禁止自行递增其他版本。
 - main 保留 NeoForge/Fabric MC 1.21.1；`compat/mtr-4.0-mc-1.20` 另提供 MC 1.20.1/1.20.4 Forge/Fabric + MTR 4.0.5 构建。v1.5.2 发布包含六个 JAR，按精确 Minecraft 版本及加载器选择。
 - 中英文 README 已同步六个附件的依赖矩阵、官网文档及 Modrinth/CurseForge、Ko-fi/爱发电入口；仅修改文档及 badge 资产。
 
+## 1.5.3准备（设计完成，功能未实现）
+
+- 2026-10-25 17:52，Codex：新增[MTR4.1内部UI研究](../plans/mtr-4.1-ui-research.md)，远端stonecutter HEAD仍f05d99e/4.1.0-beta.2；新Elementa+UniversalCraft与旧Screen并存。借鉴约束式布局、稳定键保留展开、释放时点击/拖动判定、候选列表及父页/保存逻辑；不直接套管理列表的颜色名称分组、移出关闭、全行遍历或WindowScreen根节点。NF重定位gg.essential/Kotlin而Fabric include，直接调用内部控件须实际依赖和旧4.0验证；公共API不泄漏这些类型。UI设计补拖出再拖回不点击、刷新保持展开/焦点、展开站点后各线ETA默认可见。文档/固定源码路径/版本检查通过；本轮无实现/依赖变更、构建或实机测试，更新PR #1。
+
+- 2026-10-25 17:43，Codex：补充[游戏内UI调查与设计](../plans/v1.5.3-ingame-ui.md)：共享图层菜单、固定站点卡片、单一悬停/GUIpx命中、候选消歧、三语言/键盘/小屏布局、分层数据状态及外部聚焦提示/暂时全图覆盖。源码发现Xaero隐藏按钮点击/双提示路径、仅车层维持单机运行、JM查看维度与地标集合差异；属于源码调查，未本轮实机复现。新增U0–U4验收，尤其车层关闭仍需本站ETA推进与JM5/6输入桥。API草案补所有者显示与用户覆盖状态，无特定模组适配或任意UI注入接口。已核对现有双分支源码和固定JM公开API；文档/引用/语言键核对通过，未改生产代码/版本/发布，也没有新UI的构建或游戏测试。更新同一PR #1。
+
+- 2026-10-25 17:34，Codex：新增[站点到站板/扩展API计划](../plans/v1.5.3-station-board-extension-api.md)与[公共API v1草案](../api/overlay-api-v1-draft.md)。单击站点展开固定面板、默认折叠/按需订阅；各线路按方向/目的地和站台区分，复用MTR/TSC给PIDS的原生预测，不新增模拟。站点ETA纳入1.5.3；列车悬停ETA/下一站距离仍暂停。
+- 统一MapReadApi/MapViewApi/StationBoardApi：稳定只读目录、精确区段和声明式样式、独立可关闭会话；不主动适配MTR-Navigation/howtogo。当前去重绘制缓存不足以表达有序乘车区段，须新增原生ID/停站occurrence/路径能力并验证歧义；保留静态v8/车辆v1，新增可选能力。
+- P0必须核对实际4.1.0-beta.2/4.0.5依赖、原生PIDS对照及重复平台/多路径夹具；源码Core主线不能等同已发布MTR内嵌版本。原生到站候选限额不保证每线路完整，必须显式LIMITED；目标维度查询由服务端原生操作完成。
+- 本轮只验证文档UTF-8/相对链接/源码固定SHA和文件路径及git diff --check。没有新功能、API产物、构建或游戏实测，也未发布；下一步见任务看板P0实施项。
+
 ## 平台与依赖
 
 | 项 | 值 |

docs/agents/TASKS.md

@@ -6,9 +6,13 @@
 
 ## 进行中
 
+### [待领，1.5.3实施] 原生能力验证→统一API→站点到站板
+- 准备设计已完成，见[实施计划](../plans/v1.5.3-station-board-extension-api.md)与[API草案](../api/overlay-api-v1-draft.md)。先P0验证实际MTR4.1/4.0依赖、PIDS到站对照、路径/停站occurrence映射，并做[UI设计](../plans/v1.5.3-ingame-ui.md)U0宿主输入/暂停桥验证；再按P1–P4交付只读目录、精确区段/样式会话、站点固定展开ETA与六平台验证。接口未实现，不能直接调用草案示例。
+- 不主动适配第三方导航模组，不恢复车体悬停ETA/距离，不新增模拟。用户指定目标1.5.3；本轮代码版本仍1.5.2，开始功能实现时同步双分支版本与协作文档。
+
 ### [待领，性能/兼容后续] 全网列车大网与复杂网络性能
 - 2026-10-21 20:09，Codex：全图简化锚点功能、双地图/加载器接入、异常边界和NeoForge单列远处运行验证已完成，见[验证记录](../validation/global-trains.md)。仍需真实1000/5000列、多观看者、复杂网络、高速小半径、跨维度的性能/复杂网络矩阵（六平台小网格功能回归已完成）；不能把codec大小当成FPS或总出站实测。
-- 继续使用TSC全网实测锚点，客户端无模拟/沿轨求解；版本1.5.2/静态v8/动态v1/纯2D保持。距离/ETA暂停，旧stash不恢复。
+- 继续使用TSC全网实测锚点，客户端无模拟/沿轨求解；版本1.5.2/静态v8/动态v1/纯2D保持。车体悬停距离/ETA暂停，站点ETA已纳入1.5.3计划，旧stash不恢复。
 
 ### [功能] 非 TRAIN 轨道渲染开关
 - `TrackSampler` 目前只采样 TRAIN 模式轨道。增加配置项按 TransportMode 过滤（BOAT/CABLE_CAR 可选）。
@@ -23,6 +27,12 @@
 
 ## 完成
 
+- [完成] MTR4.1内部UI源码研究 — Codex，2026-10-25 17:52，见本条所在提交。核对最新4.1公开分支HEAD/版本，追踪Elementa/旧Screen、约束布局/分组/输入/文本/关闭提交及NF重定位与Fabric include；新增研究并补1.5.3 UI设计，文档与固定源码引用验证通过。未直接复用内部控件、未修改生产功能/依赖/版本、未实机测试，更新PR #1。
+
+- [完成] 1.5.3游戏内UI优化调查与设计 — Codex，2026-10-25 17:43，见本条所在提交。核对主线/兼容UI及Create/JourneyMap公开源码，补布局/输入/悬停/设置/状态/聚焦/暂停设计与U0–U4验收；链接、固定源码、语言键核对及diff检查通过。仅调查设计，无生产代码/版本或发布变更，未启动游戏。更新PR #1。
+
+- [完成] 1.5.3站点ETA与统一扩展API准备 — Codex，2026-10-25 17:34，见本条所在提交。核对MTR/TSC/Navigation/howtogo固定公共源码，提交交互、原生数据链、目录/区段/样式/ETA契约及P0–P4验收计划；文档和源码引用检查通过。只完成准备设计，未实现/构建/发布，二进制版本仍1.5.2。
+
 - [完成] GitHub Actions CI/CD — Codex-CI，2026-10-22 22:42。双分支六目标Runner构建与CI Gate、18项工具回归、远端产物复核、六包Candidate、Nightly完整验证/无变更跳过、Snapshot六包与Publish只读演练通过；Environment已配置，规则在本验收提交推送后启用。RELEASE_TOKEN按用户要求稍后配置，不触发正式发布。实现提交main 9ea00e9、compat 7f63367，证据见docs/validation/ci-cd.md。