docs(交接): 同步同事进展并修正仓库约定（P1-1 闭环标注提交号、单仓库、索引补差异报告）

zhizhijie

9 天以前 06b1cb706387c3bc2ab7f6a525c26f9dd22a3bb4

 docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-22.md

@@ -68,6 +68,7 @@
- å‰ç«¯ï¼šå·¥å…·æ åŠ ã€Œè§†å›¾ï¼šæ˜Žç»† / æŒ‰å¸‚州汇总」，汇总模式提供起止月、排名、汇总、导出 Excel；
- ä¿®å¤ä¸¤ä¸ªå£å¾„坑：货运量周转量表的"行内累计 + æ¹–北省合计行"重复计算（1,149,579 â†’ 130,311.89 ä¸‡å¨ï¼‰ã€ç»“束月无数据自动回退；
- ä¸Žæ‰‹å·¥æ ¸ç®—一致：公交 1-8 æœˆ 110776.34 ä¸‡äººæ¬¡ã€è´§è¿ä¼ä¸š 313,998,248 å¨ã€è´§è¿é‡å‘¨è½¬é‡ 130,311.89 ä¸‡å¨ã€‚
- æ”¶å°¾ï¼šæŒ‰ç”¨æˆ·è¦æ±‚把「全省合计」行提到最前面（武汉市之上），导出 Excel ä¸­åˆè®¡è¡ŒåŠ ç²—。

### 5. æ±‡æ€»å¤§è¡¨å¯¼å‡ºç»“果落盘缓存（用户："下载过就不该再等很久，能不能记住上次结果"）

@@ -79,6 +80,15 @@
- **顺带修 bug**：落盘命中时 `elapsedMs` ä¸ºè´Ÿæ•°ï¼ˆä»»åŠ¡èµ·ç‚¹ç”¨çŽ°åœ¨ã€ç»“束时间是历史生成时间）→ å·²æ”¹ä¸ºä»¥ç”Ÿæˆæ—¶é—´ä½œèµ·ç‚¹ã€‚
- **实测**：首次 12.4 s å†™ç¼“存；再次提交 **164 ms** å‘½ä¸­å†…存；**重启后端后提交 1.19 s å‘½ä¸­è½ç›˜**；临时插一条导入记录后 `fromCache=false` é‡æ–°ç”Ÿæˆï¼ˆéªŒè¯ã€Œæœ‰æ–°å¯¼å…¥å³å¤±æ•ˆã€ï¼‰ï¼›æµè§ˆå™¨ç‚¹å¯¼å‡ºç§’出、文案与按钮正确、控制台 0 æŠ¥é”™ã€‚

### 6. å¯¼å‡ºç¼“存守卫升级为「数据指纹」+ å¤±æ•ˆæç¤ºï¼ˆç”¨æˆ·ï¼šæŒ‰ä½ è¯´çš„做）

- **背景**：上一版缓存守卫用全局 `MAX(import_batch.id)`，①导入投资/能耗等无关数据会白失效；②**不含母版文件**，换母版时会错误命中旧结果（正确性漏洞）。
- **改动**（`ReportExportTaskService.java`）：
  1. æŒ‡çº¹ =「依赖源表 `CHECKSUM TABLE` æ ¡éªŒå’Œï¼ˆèƒ½æ•æ‰åŽŸåœ° UPDATE）」+「母版目录全部文件 + ç½‘约车订单 xlsx çš„名称/大小/修改时间」，SHA-256 å‰ 8 å­—节写进缓存文件名；
  2. æºè¡¨èŒƒå›´ç”¨**排除法**：排除投资 3 / èƒ½è€— 2 / å®¡æ ¸ 4 / ç³»ç»Ÿ 6 / `import_batch`，其余全纳入（宁可多算不可出错）；
  3. å¤±æ•ˆæç¤ºï¼ˆç¬¬ 3 æ­¥æç¤ºç‰ˆï¼‰ï¼šæ²¡å‘½ä¸­ä¸”有旧结果时，进度弹窗显示「上次生成的结果已因数据或母版变化失效，本次按最新数据重算。」
- **实测**：无关导入（投资项目 + å¯¼å…¥è®°å½•å„插一行）**仍命中**缓存；相关源表原地 UPDATE、改母版 mtime **必定失效**并重算；命中缓存时不再残留提示；浏览器实测提示行显示正常、控制台 0 æŠ¥é”™ï¼›æµ‹è¯•æ•°æ®å·²å…¨éƒ¨è¿˜åŽŸï¼ˆ419 æ‰¹æ¬¡ / 152 é¡¹ç›®ï¼‰ã€‚

## äºŒã€æµ‹è¯•ç»“果摘要

- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看补齐网约车与个体客运类型_2026-09-22.md`
@@ -88,6 +98,7 @@
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_数据查看按市州汇总与导出_2026-09-22.md`（接口 10 æ¡ + çœŸæœº 4 æ¡å…¨é€šè¿‡ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_汇总大表进度弹窗优化_2026-09-22.md`（6 æ¡ç”¨ä¾‹é€šè¿‡ï¼šç”Ÿæˆä¸­çŠ¶æ€ / å®Œæˆæç¤º / å†æ¬¡ä¸‹è½½èµ°ç¼“å­˜ / å…³é—­ / æ— æŽ§åˆ¶å°æŠ¥é”™ / å…¶å®ƒå¯¼å‡ºæœªå—影响）
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_汇总大表导出结果落盘缓存复用_2026-09-22.md`（10 æ¡ç”¨ä¾‹é€šè¿‡ï¼šé¦–次生成写缓存 / å†…存命中 164ms / **重启后落盘命中 1.19s** / æœ‰æ–°å¯¼å…¥å³å¤±æ•ˆ / åŒ key åªç•™æœ€æ–°ç‰ˆæœ¬ / æ—¶é•¿æ˜¾ç¤ºä¿®å¤ / æµè§ˆå™¨ç«¯åˆ°ç«¯ï¼‰
- æŠ¥å‘Šï¼š`docs/功能测试报告/功能测试报告_导出缓存改用数据指纹_2026-09-22.md`（12 æ¡ç”¨ä¾‹é€šè¿‡ï¼šæ— å…³å¯¼å…¥ä»å‘½ä¸­ / ç›¸å…³æºè¡¨åŽŸåœ° UPDATE å¿…失效 / **换母版必失效** / å¤±æ•ˆæç¤ºæ˜¾ç¤º / å‘½ä¸­æ— æç¤º / æ•°æ®è¿˜åŽŸæ ¸å¯¹ï¼‰
- çŽ¯å¢ƒï¼šåŽç«¯ `mvn spring-boot:run`（8090，`Started TrafficAuditApplication`）；前端 `npm run serve`（8080，`Compiled successfully in 4769ms`）；MySQL `localhost:3308/traffic_audit`；登录 admin/123456 å– JWT。
- ç»“果：3 ä¸ªæ–°ç±»åž‹æ­£å‘（含期间/关键字筛选）、负向（未知类型、无数据期、无 token）全部通过；入库抽查条数与库内一致（20 / 20 / 139）；原有 15 ç±»å›žå½’正常。

@@ -104,3 +115,11 @@

1. å¼€å·¥"按市州汇总 + å¯¼å‡º Excel"：后端加 `/api/data/summary` ä¸Ž `/api/data/export`，前端加"明细/汇总"切换与导出按钮。
2. æ±‡æ€»ç»“果与报表/手工作业抽样核对（1-8 æœˆå…¬äº¤ã€å·¡æ¸¸å‡ºç§Ÿã€è´§è¿è§„上企业）。

## äº”、Codex æ¡Œé¢ç«¯è¾“入卡顿复核（2026-09-22）

- æŒ‰ 09-21 çš„修复方案，用户重启电脑和 Codex åŽå¤æ ¸ã€‚
- è¿›ç¨‹ï¼šChatGPT äºŽ 2026-09-22 12:54 æ–°å¯åŠ¨ï¼›ä¿®å¤è„šæœ¬ `fix-codex-typing-retry-storm.js` å­˜åœ¨ä¸” `user_scripts.json` ä»ä¸º `enabled=true`。
- æ€§èƒ½ï¼šä¸»æ¸²æŸ“进程（PID 7044）连续 10 ç§’采样约 `13.28%` å•æ ¸ï¼›ä¿®å¤å‰çº¦ `115%` å•æ ¸ã€‚
- å®ˆå«ï¼šè°ƒè¯•ç«¯å£ 9229 è¯»å– `window.__codexPlusRetryTimerGuardInstalled=true`，本次会话 `window.__codexPlusRetryTimerGuardDropped=16`。
- ç»“论：输入卡顿修复在重启后仍生效，问题已解决。