指南变更记录

Timestamp	Request	Actions	Verification	Result
2026-10-29 19:08 Asia/Shanghai	widened docs sync：补齐中英文入口、中文源码指南和 Agent 路由	以一条主流程建立 Lite + 代码地图，保留既有丰富说明；文档站接入，根规则归一	两遍源码调查完成；文档校验及站点构建结果见下文	Synced through 6011ff1ec1f774a656e6a8f1feac1410fb2f7a9a；此锚点只标识当前 Git HEAD，工作树未提交行为不声明已发布

验证范围

文档结构校验通过（退出 0）；独立站点构建通过（退出 0），输出在仓库外，未替换业务预览产物。

运行时测试会提取真实 public 脚本函数并用替身验证边界；这与真实核心和真实游戏验收不同。本轮不运行核心构建、网页构建或业务测试，也不替换现有 wasm-page/dist。完整核心构建仍按根 README 的 Emscripten/Linux 或 WSL 要求执行。

统一维护复核（2026-10-29）

补齐中英 README 入口、贡献与安全说明；AGENTS 为规范正文，CLAUDE 为引用入口。补充钩子检查暂存内容、提交标题及推送新增历史，保留项目原有检查；安装步骤与边界见根 SECURITY 和 CONTRIBUTING。独立站点采用 VitePress 默认主题，源码链接在网页中保留为精确路径。

本地分支规范化了 1 条提交信息；重建对象均已验证 SSH 签名，文件树、署名、日期和父图保持对应。原引用有本机备份，远端与标签未改。

文档结构校验和站点构建均退出 0；共用护栏的 9 项隔离测试通过。业务测试、生产部署和远端发布未因此视为通过。大文件扫描边界见 SECURITY。

Synced through 6011ff1ec1f774a656e6a8f1feac1410fb2f7a9a；源码树与原锚点对应，未提交实现仍按工作树单列。

文档站恢复默认主题（2026-10-29）

按用户要求统一使用 VitePress 默认主题，移除额外配色、字体、圆角和入场动效。指南正文、源码定位及导航保留；文档依赖与业务依赖分开。新建站点从 MkDocs 迁移为 VitePress，既有两个 VitePress 站点使用原生主题入口。

界面与配套实现整理（2026-10-29）

整理模拟器页面和运行面板的品牌色、响应式布局与 Anime.js 动效，随包保留字体及依赖许可。

验证：项目 Node 测试通过；变更 JavaScript 语法检查通过。浏览器页面检查与模拟器真机兼容性分别记录。

Synced through 0906c48cdcdaeeb8abba2e779e7be3caa75b34bf；本节对应随后提交的工作树。

存档与确认输入诊断边界（2026-11-02）

以前台最小补丁同步主流程及源码证据：区分游戏确认／取消、PSP 工具对话框的 buttonSwap、三层 JavaScript 输入与实际保存结果；用返回／选择“否”的提示循环说明为何不能直接判断写入失败或内存不足。补充内存文件系统到 OPFS 的应用目录层级、只读元数据检查及 30 秒自动同步窗口。此处保留通用诊断机制，不发布本机测试资料，也不推广为所有移动设备的兼容性或性能结论。

Synced through 24d70f1f52994b00c5f7f22c5385f38996c66416。本节对应未提交的指南工作树。Lite 结构与源码链接校验退出 0：0 个错误、1 个既有告警（上游来源说明未包含 Agent 同步规则）；改动文件的空白检查通过。本次未重建文档站或业务产物；文档校验不替代产品构建、重新加载恢复、设备兼容性或性能采样验收。

栏目导航与屏幕手柄（2026-11-02）

以前台补丁同步图标文字栏目、窄横屏横向导航和键盘焦点规则；说明摇杆落点、径向死区、方向滑动换向与多指释放边界。补充低高度控件重排、布局与可视区域分工，以及折叠／旋转后取消旧手势、重新落指测量的位置约定。代码地图新增游玩控件样式、画布尺寸通知和原生 DPI 更新的职责，并指向栏目、视口、触控和独立 C++ 分支回归。原生补丁必须重新构建配套核心才会生效。

Synced through 6171ab4a6d437872499a40e0011b888c4c3e9d26；本节记录上述源码提交的验证范围。

验证分别记录：

• 网页 Node 测试 203/203 通过；独立生产网页构建退出 0，未覆盖当前 Android 预览目录。
• 无头浏览器以坐标点击完成 5 种尺寸的连续切换，每种尺寸的 12 个屏幕按键均命中；尺寸变化取消旧手势，新触点可保持按住 700 毫秒。8 个栏目逐个点击后均进入对应面板。另检查从 320×480 到 1365×820 的 12 种 CSS 视口，包含低高度横屏和方形窗口；结合设备像素比 1／2、普通／全屏共 48 组，按键、摇杆和全屏菜单无交叠或出界，按键命中区域至少 44 像素。以上为桌面浏览器自动化，不是真实折叠屏或手指操作验收。
• 既有配套 Wasm 加载新页面后，在固定设备像素比 1、未加载游戏的原生菜单中，连续切换 4 种尺寸并点击设置入口，画面逐项确认进入。这只验证既有核心与新网页的尺寸通知，不代表新原生补丁或变化中的设备像素比已完成浏览器验收。
• 独立窗口尺寸回归将真实生产函数和分支编译为 Wasm，13/13 场景通过；旧源码负对照被 DPI 断言拒绝。整份当前 SDL 窗口源文件编译为独立 Wasm 对象成功。同一回归已加入构建脚本，位于完整核心构建之前。SDL 调用仍使用测试替身，未完整链接新核心，也未替换 Android 站点；手机手感、游戏触点和性能不因此视为通过。
• 文档 Lite 结构与源码链接校验退出 0：0 个错误、2 个告警（代码地图的 7 个规定表头触发措辞计数；上游来源说明未包含 Agent 同步规则）。保留原文件换行格式的空白检查通过。本轮未部署或触发云构建。

狭窄窗口与新核心点击验证（2026-11-02）

补齐狭窄、矮窗口的控制区边界：窗口空间不足时使用覆盖画面的紧凑排布，避免独立控制区挤掉画布；更窄的窗口不再保留固定最小页面宽度。修复通用按钮交互样式覆盖肩键定位方式的问题，肩键悬停、按下时保持原位。显示手柄时隐藏状态角标，收起后恢复原有显示规则。主流程说明这种排布会占用部分游戏视野，几何检查不能替代实际手指操作。

Synced through d2443ceca686c20aab92593446a4a17cd73ca8c0。

本轮验证分别记录：

• 当前工作树的独立网页生产构建退出 0；直接测试最终打包页面，未额外注入样式。18 种尺寸结合设备像素比 1／2、普通／全屏共 72 组全部通过：控件中心命中、无交叠或出界、按键命中区域至少 44 像素、画布尺寸非零。补充尺寸为 320×360、320×400、360×360、360×320、280×600、300×400，覆盖前一轮遗漏的狭窄和矮窗口。
• 同一生产包另以 5 种尺寸、普通／全屏、左右肩键共 20 组检查真实悬停、鼠标按下及按压状态，控件矩形保持不变；状态角标隐藏、恢复检查通过。这些是桌面无头浏览器检查，不代表真实折叠设备或手指舒适度验收。
• 从固定源码提交 2052040b4e72e692e66220f394b64d6b3946ad1e 独立完整重建核心，1112 项编译与链接完成；源码指纹及三份配套产物哈希复核一致。重建前的解码依赖检查与 13 项窗口尺寸回归通过。完整链接证明产物可生成，不单独证明游戏运行结果。
• 新核心在无游戏镜像的原生菜单中，不刷新页面，连续切换设备像素比 2、1.25、3、1，同时将 CSS 窗口宽度在 959 与 960 之间切换。每档画布缓冲尺寸与 WebGL 绘制缓冲一致，实际坐标点击均进入图像设置，画面逐张复核，未捕获页面脚本异常。这覆盖设备像素比与窗口尺寸共同变化；没有把仅改像素比而不发送尺寸通知的测试夹具当作真实设备行为。
• 新核心另在固定设备像素比 2 下连续切换 450×600、720×720、390×844、844×390，四次点击均进入图像设置，过程中未刷新页面、未捕获页面脚本异常。原生设置界面在窄竖屏下仍显拥挤；这项验收只证明点击与画面位置相符，不代表原生菜单排版已全面适配。
• 手机触摸手感、真实折叠屏、游戏触点及性能仍需单独验收。本轮未替换 Android 站点、未部署或触发云构建。
• 文档 Lite 结构与源码链接校验退出 0：0 个错误、2 个既有告警（代码地图表头的措辞计数；上游来源说明未包含 Agent 同步规则）；保留原文件换行格式的空白检查通过。未重建文档站。

原生设置栏目的宽度适配（2026-11-04）

以前台补丁说明网页核心的栏目布局按有效 UI 宽度决定，避免横向画布在窄窗口中仍保留固定宽度侧栏。补充图标文字标签、跨布局的栏目和滚动状态交接、选中标签可见以及搜索过滤入口的保留规则；代码地图新增原生栏目布局、容器与视图重建职责，并同步指南覆盖范围。

Synced through 3fb1bfccb462299a872a237b2696f51420bc3041。

本轮验证分别记录：

• 独立栏目模式回归共 38 项通过：网页与非网页策略各 19 项，均提取真实函数并编译为小型 Wasm。显示数据及视图重建使用替身，非网页分支检查不等于桌面原生程序构建。窗口尺寸回归 13 项及解码依赖检查通过；构建脚本语法检查通过，云构建未执行。
• 当前源码完整核心重建完成 1112 项编译与链接，输入源码及配套产物哈希复核一致。本机预览已更新为这组核心；未替换 Android 站点。
• 独立无头 Edge 加载新核心且不加载游戏，在设备像素比 1 下连续缩窄、展开窗口：390 像素宽时改为顶部栏目，系统设置仍选中，内容滚动位置保留，实际点击返回按钮可回到主菜单。搜索为空且缩屏移除搜索页时回退到图像设置；有过滤条件时保留搜索页，滚动后可点击“结束搜索”，清除后其他栏目恢复可用，再展开也保持已清除。
• 设备像素比 2 下，手动横向滚动栏目后等待 1 秒未被拉回，实际点击可见的声音设置标签后进入对应页面。窗口宽度在 731、733、731 像素间切换，对应画布宽度 719、721、719，顶部导航与侧栏往返切换后声音设置保持选中。以上尺寸切换未刷新页面，截图逐张复核，未捕获页面脚本异常。
• 上述结果属于桌面浏览器中的窄屏操作验证，未证明真实手机、折叠屏、触摸手感或游戏性能。适配范围是原生设置分栏，不能推定主菜单与全部弹窗已适配。本轮未部署或触发云构建。
• 文档 Lite 结构与源码链接校验退出 0：0 个错误、2 个既有告警（代码地图表头的措辞计数；上游来源说明未包含 Agent 同步规则）；保留原文件换行格式的空白检查通过。未重建文档站。

GitHub Actions 双平台构建入口（2026-11-07）

新增与 CNB 对应的 GitHub Actions 源码测试、完整构建及手动部署入口。两端使用同一固定工具链 Dockerfile 和构建脚本；部署继续只在手动入口读取项目独立的保密配置，线上版本与响应头验证保持独立。双语 README、部署说明和主流程已同步，不改变本地预览或游戏内容边界。

验证：全部工作流 actionlint 通过；网页 Node 测试 203/203、玩家服务器测试 7/7、部署准备与浏览器资料脚本测试 32/32 均通过。未执行完整模拟器云构建、真实部署或线上验证。

Synced through 928e85b45524baff757825fab47c8210fc118a08；本节记录该提交之后的双平台构建改动。