docs/¹¤×÷ÈÕ½á/¹¤×÷ÈÕ½á_2026-09-16.md
@@ -309,3 +309,74 @@
- 2026-07 æœŸå¯¼å‡ºä»¶ã€Œ è´§è¿ã€é¡µä¸º 118x145(比 8 æœˆå°‘ 2 åˆ—),因 7 æœˆæ¯ç‰ˆæ˜¯ã€Œ1-4 æœˆéª¨æž¶ã€ã€‚
详见《功能测试报告/功能测试报告_货运页签累计列修复与脏期清理_2026-09-16.md》。
---
## äºŒåä¸€ã€2026-07 æ¯ç‰ˆè¡¥é½ + å¯¼å‡ºä»¶ã€ŒExcel æ‰“不开」根因修复
日期:2026-09-16(第 9 è½®ï¼ŒæŽ¥äºŒåèŠ‚ï¼‰
### 21.1 ä»Šå¤©åšäº†ä»€ä¹ˆ
| # | äº‹é¡¹ | ç»“æžœ |
|---|---|---|
| 1 | æ¸…理 2026-09 æ®‹ç•™æ•°æ®ï¼ˆç”¨æˆ·ç¬¬ 1 æ¡ï¼‰ | **完成**:h204_vehicle_quarterly 1284 / investment_monthly 31 / audit_result 2061 / audit_run 3 / import_batch 5 / h2032 636,全部复核为 0 æ®‹ç•™ï¼›å·²ç•™å¯è¿˜åŽŸ SQL å¤‡ä»½ `_backup_2026-09_residual_all_20260916.sql` |
| 2 | ä¿® 2026-07 å¯¼å‡ºä»¶ã€ŒExcel æ‰“不开」 | **完成**(P0,见 21.2) |
| 3 | è¡¥é½ 2026-07 æ¯ç‰ˆï¼ˆç”¨æˆ·ç¬¬ 3 æ¡ã€Œå¯ä»¥è¡¥é½ã€ï¼‰ | **完成**(见 21.3) |
| 4 | ä¿®å¤‡ä»½æ¯ç‰ˆå›žå¡«æŠŠè¡¥é½ã€Œæ‰“回原形」 | **完成**(见 21.4) |
### 21.2 æ ¹å› ï¼šopenpyxl æ¯ç‰ˆ + å¤‡ä»½å›žå¡« â†’ æ®‹ç•™ <is> éžæ³•æ ¼
- åä»¶é‡Œ 19 ä¸ªæ ¼å­å½¢å¦‚ `<c r="E15" s="111" t="n"><v>67.0</v><is><t>67.00</t></is></c>`:`t="n"` å´å¸¦ `<is>`,模式非法,Excel ç›´æŽ¥æ‹’开(COM æŠ¥ã€Œä¸èƒ½å–å¾—ç±» Workbooks çš„ Open å±žæ€§ã€ï¼Œè¿žä¿®å¤æ¨¡å¼ `CorruptLoad=1` ä¹Ÿæ‰“不开)。
- 7 æœˆæ¯ç‰ˆæ˜¯ **openpyxl å†™å‡º**(文本存 `<is>`),8 æœˆæ¯ç‰ˆæ˜¯ **Excel åŽŸç”Ÿ**(文本走 sharedStrings)→ åŒä»£ç ä¸‹åªæœ‰ 7 æœˆåã€‚
- è§¦å‘者是 `restoreSummaryMonthlyBlocks`:7 æœˆæœ‰ `_备份_2026å¹´7月…清理前…xlsx`,整格回填时往 inlineStr æ ¼é‡Œå†™å€¼ï¼Œç•™ä¸‹æ—§ `<is>`;8 æœˆæ²¡æœ‰ `_备份_*`,不走回填,所以一直是好的。
- å®šä½æ‰‹æ³•(值得记住):坏件/好件**除 worksheets/styles/sharedStrings å¤–全部部件逐字节相同** â†’ zip æ‚交 + Excel é€ä¸€å¼€æ¡£ leave-one-out â†’ é”å®š **sheet9《公交》17 æ ¼ + sheet12《轨道、轮渡》2 æ ¼**。
### 21.3 ä¿®å¤
1. `ReportExportService.exportSummaryWorkbook`:落盘前新增 `normalizeStaleInlineStrings(wb)`,清掉所有「非 inlineStr å´æ®‹ç•™ `<is>`」的格子(幂等 + warn æ—¥å¿—)。
2. `ReportExportService.restoreSummaryMonthlyBlocks`:新增 `skipFreightHistoryBlocks`,《 è´§è¿ã€‹é¡µ **T åˆ—及以后**(2025..2021 äº”个年度块 + å„年累计列)永不从备份母版回填 â€”— ä¸Žæ—¢æœ‰ã€Œä¸­å£å¾„排名左块」保护同一思路,防「生成又复活」。
### 21.4 7 æœˆæ¯ç‰ˆè¡¥é½ï¼ˆExcel COM,360 + 324 æ ¼ï¼‰
按 `_fix_mother.ps1`(8 æœˆæ¯ç‰ˆé‚£ç‰ˆï¼‰**整体左移 2 åˆ—**改写:
- å¹´åº¦å—:2025 `T,V,X,Z,AB,AD,AF,AH,AJ,AL,AN,AP`;2024 `AV..BR` éš”列;2023 `BW..CS` éš”列;2022 `DK..DV` è¿žç»­ï¼›2021 `EA..EL` è¿žç»­ï¼›æ¯åˆ—写 `r7/r9/r8/r10 = SUM(17 å¸‚å·ž)`、`r5=r7+r9`、`r6=r8+r10` â†’ **360 æ ¼**;
- ç´¯è®¡åˆ—:`DX=SUM(DK:DV)`、`EM=SUM(EA:EL)`、`DY=IFERROR(DX/SUM(EA:EL)-1,"")`,行 5..112 â†’ **324 æ ¼**;
- `CalculateFullRebuild` åŽä¿å­˜ã€‚母版 921,559 â†’ 1,440,038 å­—节(转 Excel åŽŸç”Ÿï¼‰ã€‚
### 21.5 æµ‹è¯•结果摘要
| ç”¨ä¾‹ | ç»“æžœ |
|---|---|
| 2026-07 å¯¼å‡ºï¼ˆä¿®å¤å‰ï¼‰ | FAIL(复现) |
| çŽ¯å¢ƒ/路径排除(小件、两本母版、09-08 æ—§å¯¼å‡ºã€æ”¹åå¤åˆ¶ï¼‰ | å…¨éƒ¨ OK,确认非环境问题 |
| ä¿®å¤åŽ 2026-07 å¯¼å‡º | **OK sheets=19**,`DX5=144979.2825`、`DY5=-0.101235487797891`、`EM5=161309.53162`、`CU5=173045.296428512` |
| ä¿®å¤åŽ 2026-08 å¯¼å‡º | **OK sheets=19**,`DZ5=144979.2825`、`EO5=161309.53162`、`CW5=173045.296428512` |
| è·¨æœˆä¸€è‡´æ€§ | 7 æœˆä¸Ž 8 æœˆçš„ 2022/2021/2023 ç´¯è®¡**完全相等** |
| éžæ³•格复扫 | 0 ä¸ª |
| 2026-09 æ®‹ç•™å¤æ ¸ | 5 å¼ è¡¨å…¨ 0 |
> æ³¨ï¼š8 æœˆæ¯ç‰ˆè®¡ç®—后 `DZ5` ç”±æ—§çš„写死常量 `144979.285376043` å˜ä¸º `144979.2825`,差 0.0029 â€”— æ­£æ˜¯ç¬¬åäºŒèŠ‚è®°å½•çš„ã€Œå…¨çœè§„ä¸‹å¸¸é‡ â‰  17 å¸‚州之和」那笔差额,属**修正**而非回退。
### 21.6 è¸©å‘
1. **Excel COM å­¤å„¿è¿›ç¨‹ä¼šè®© `Workbooks.Open` é—´æ­‡æ€§å‡æŠ¥åŒä¸€ä¸ªé”™**:每例测完必须强杀本次新建的 `EXCEL` è¿›ç¨‹ã€‚排查初期就因孤儿进程误判「8 æœˆä»¶ä¹Ÿæ‰“不开」,浪费了一轮。
2. `CTWorksheet` **没有** `isSetSheetData()`(sheetData æ˜¯å¿…填),要用 `getSheetData() != null`。
3. æ¯ç‰ˆè¡¥é½çš„备份文件**不能**用 `_备份_` å‰ç¼€ï¼ˆä¼šè¢« `resolveSummaryDonor` å½“ donor å›žå¡«ï¼‰ï¼Œæœ¬æ¬¡ç”¨ `_bak_2026å¹´7月道路运输量汇总表_补齐前_20260916.xlsx`。
### 21.7 é—ç•™
- 2026-06 / 2026-09 æ— æ¯ç‰ˆ â†’ é¢„览 `ready=False`「未找到模板文件」,需先建母版。
- ç¬¬ 8 æ£’遗留未动:`h2031` ç¼º 2025-01、`passenger_individual_monthly` 2026-08 ç¼ºé»„冈、`PASSENGER_AUTH` 11 æœŸå…¨ 0。
- ä»“库根 `_*.*`(含本次 `_hyb_*` / `_loo_*` / `_v2_*` / `_final_*` / `_fixed_*` / `_t7_*` / `_poijar`)未删,待用户同意。
详见《功能测试报告/功能测试报告_2026-07母版补齐与导出件打不开修复_2026-09-16.md》。
### 21.8 æ”¶å·¥è®°å½•(2026-09-16)
- æœ¬è½®ä»£ç /文档已 commit `80e0879`,并 **push åˆ°ä¸ªäºº gitee `origin/master`**(`e29485b..80e0879`)。
- å…¬å¸ gitea ä»ä¸é€šï¼š`git fetch gitea` æŒ‚起约 5 åˆ†é’Ÿæ— å“åº”,已按约定**不强推**,待网络恢复后补推(本地现 `ahead 16`)。
- æ”¶å·¥æ—¶çŽ¯å¢ƒï¼šåŽç«¯ 8090、前端 8080 å‡åœ¨è·‘ï¼›Excel å­¤å„¿è¿›ç¨‹å·²æ¸…干净(只保留用户自己的 18564/25868)。
- æœªæäº¤å†…容(**有意保留,等用户确认**):`docs/投资/` ä¸‹çš„æ—¢æœ‰å¢žåˆ ï¼ˆ`X月…` æ”¹åç­‰ï¼Œéžæœ¬è½®æ”¹åŠ¨ï¼‰ã€ä»“åº“æ ¹ `_*.*` æŽ’查临时文件。
- æ˜Žå¤©å¯åšï¼šæ–°å»º 2026-09(及 2026-06)母版,让 9 æœˆæºæ•°æ®å¯¼å…¥åŽèƒ½ç›´æŽ¥å‡ºæ±‡æ€»å¤§è¡¨ï¼›å…¬å¸ gitea è¡¥æŽ¨ã€‚