joywayerandClaude Opus 4.7
13cc24b463
§7.5 路径回退到 writeToFile：撤销 evaluateJavaScript 路径
CLAUDE.md 原则 A 升级为第一准则（H5 端零修改不可妥协）后，重新评估
上一轮 commit 246f215 引入的 evaluateJavaScript 路径：
- WKUserScript(.atDocumentStart) 注入会被 H5 自带 var app_xxx 声明
覆盖回退
- WKUserScript(.atDocumentEnd) 又太晚，H5 业务顶层 <script> 已经
读过默认值
- 没有"在 <script src> 之后、业务 <script> 之前"的精确时机
- 任何"让 H5 改一行 / 改一个文件"的妥协方案违反原则 A 第一准则
- 详细分析见 CLAUDE.md「典型案例 3」
撤销方案：回到原 msext writeToFile 路径，原生在 loadFileURL 之前写
4 个 app_*.js 文件到沙盒，H5 启动时 <script src> 同步引入即可读到
实际值，时序 100% 等价 msext。
Design §7.5 全面回退（-285 / +126 行）：
- §7.5 头部：标题 / 简介改回写文件路径；中间走过两次弯路的完整决策
链记录在头部（commit f68b0db → 246f215 → 本次 commit）
- §7.5.2 注入时机表 → 4 个文件写入时机表，附"为什么不要照搬
WKUserScript 注入"警告段
- §7.5.3 删除 AppDataInjector + .legacy 标注；AppDataWriter 升回主路径
（保留 logger debug 输出 / msext 字面对齐细节 / 转义 / 大小写）
- §7.5.4 接入点：writeInitial + writeBattery + writeNetwork 三阶段，
addObserver 持续监听
- §7.5.5 大厅 / 子游戏 / 弹层差异表回到 "app_data.js / app_gamesname.js
/ app_battery.js / app_network.js" 维度
- §7.5.6 与 msext 差异表回到"writeToFile 等价化"对比
- §7.5.7 与 §3.4.1 polyfill 关系：§7.5 文件预写为主路径；
WKUserScript + evaluateJavaScript "探索后撤回"
- §7.5.8 联调路径恢复 cat 文件路径，加 4 种现象诊断表
Contract §4.2 同步：
- 头部说明改回 "原生 writeToFile 写文件" + 撤销中间 evaluateJavaScript
路径的复盘段
- 子节标题回到 "写到 {gamedir}/{gamestart}/app_*.js"
- 子节"更新时机"段回到 loadFileURL 前 / addObserver / 前台切换
- 删除"H5 团队 zip 自带 + 默认占位"约定（不再适用，原生重新负责写入）
- 修订记录新增一行"路径再次调整（最终）"
Contract §10 验收清单同步：
- "H5 zip 自带 4 个 .js" → "沙盒下 4 个 .js 存在（xcrun simctl + cat 验证）"
- 删"原生 WKUserScript 覆盖生效"项 → 加"值是实际渠道值而非占位"
- "阶段 B 动态覆盖" → "battery/network 变化重写文件"
Plan §6.4 里程碑加两行：CLAUDE.md A 升级 + §7.5 最终回退。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-22 12:40:07 +08:00
..
2026-06-21 22:32:38 +08:00
2026-06-22 12:40:07 +08:00
2026-06-22 12:40:07 +08:00
2026-06-22 12:40:07 +08:00