用途：新对话/接手人先读
HANDOFF.md+ 项目根AGENTS.md，再读本文，即可无缝接力。
与其它文档的关系：本文只写 09-23 的增量（现状快照 + 本次对话新增的腾讯文档读取调研 + 当前待办入口）；
系统结构、P0/P1/P2 全量遗留仍以docs/交接文档_2026-09-21.md为准，不重复。
docs/交接文档_2026-09-21.md §4。origin，§1.4）。不要强推、不要覆盖同事代码。| 项 | 值 |
|---|---|
| 分支 | main |
| 本轮起点 HEAD | 8b739ce docs(交接): 统一 09-22 关机快照（合并同事版本，修正运行状态为实测：8090/8080 在运行） |
| 远端 | 本轮开始前已同步公司 origin/main；本次续接新增的文档提交见 git log |
| 远端地址 | origin → http://61.183.254.94:3000/r/trafficAudit.git（分支 main）——**只用公司 gitea 单仓库**，个人 gitee 已弃用 |
| 项 | 值 |
|---|---|
| dev 后端 8090 | 运行中（09-23 08:48 启动，日志出现 Started TrafficAuditApplication） |
| dev 前端 8080 | 运行中（09-23 08:48 启动，日志出现 App running at） |
| 数据库 | MySQL，库 traffic_audit，配置 jdbc:mysql://localhost:3305/traffic_audit，root/root；本机 MySQL57、MySQL80 服务均 Running |
| 其它 node 进程 | 存在若干 node/cmd（08:42 起），为 Codex 自身组件，**勿动** |
判断服务是否起来：**只看日志**（后端
Started TrafficAuditApplication+Tomcat started on port(s): 8090；前端App running at）。
沙箱内Get-NetTCPConnection会静默失败/报无匹配，据此判断会误判。
# 项目根目录，必须在沙箱外（提权）运行
powershell -NoProfile -ExecutionPolicy Bypass -File start-dev.ps1
# 停止：
powershell -NoProfile -ExecutionPolicy Bypass -File stop-dev.ps1
脚本会自动跳过已在监听的端口；关机后服务自然停止，无需手工处理。
git fetch origin
# 先合并远端 main（有必要就解冲突，禁止强推）
git add -- <改动文件>
git commit -m "docs: ..."
git push origin main
docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md。docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md。货运 历史同比业务已确认软件正确。报告 docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md，明细 CSV 同目录。docs/生成汇总大表/_cache/，gitignore）+ 数据指纹守卫（依赖源表 CHECKSUM TABLE + 母版文件身份，换母版必失效），失效时弹窗给说明。Codex++ 守卫脚本仍启用，主渲染进程空闲 CPU 约 13.3%（单核），较修复前约 115% 已解决。localhost:3305，而 09-22 功能测试报告记录的验证库是 localhost:3308。3305 库中，潜江 2026-08 仍挂旧项目“潜江传化公路港项目”并保留 5173/12000/5173/1440，说明上一轮 08 月修正未落到本次运行库；3308 当前无法连接。success=1；三个月均改为“中国虾谷冷链仓储物流园” 11947.9 / 0 / 1135 / 0。docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md。用户给定在线表格（只读分享链接）：
https://docs.qq.com/sheet/DQ2ZLR09Kcm9ZcUpI?nlc=1&tab=000004
文档名 《2026年十一数据》，权限**只能查看**，共 10 个页签：铁路、民航、道路、水路、高速公路、普通国省道、营业性客运量、人员流动量汇总、报厅办1、报厅办2。
做法（Codex 内置浏览器 + CUA/Playwright，无需任何腾讯账号/API）：
<text> 节点即可得到**当前显示值**：表头、日期、数值、百分比，连 #DIV/0! 这种错误文本也能拿到。能力边界（很重要）：
=…）。代码调研（全仓无腾讯文档/分享链接/腾讯 Open API 任何集成）：
el-upload，接受 .xlsx/.xls/.et（网约车报告另有 .docx）——traffic-audit-web/src/views/DataImport.vue:57、DataImport.vue:502；MultipartFile——DataImportController.java:33；WorkbookFactory.create(file.getInputStream())——DataImportService.java:192；结论：要靠软件自己读在线表格，**必须新增集成**（下述官方 API 是唯一正规路径）；否则只能像本次一样借助浏览器「打印预览」人工/脚本抓显示值。
官方 Open API（V3，V2 已废弃）提供**读指定范围**接口：
GET https://docs.qq.com/openapi/spreadsheet/v3/files/{fileId}/{sheetId}/{range}
# 例：/files/ABCDE123abcde/BB08J2/A10:D11
请求头：
Access-Token: {ACCESS_TOKEN}
Open-Id: {OPEN_ID}
Client-Id: {CLIENT_ID}
Accept: application/json
要点：
range 用 A1 表示法，返回 gridData.rows[].values[].cellValue；scope.sheet 或 scope.sheet.readonly；Access-Token/Open-Id；Client-Id）+ OAuth 回调 + 用户授权，并确认目标文档所在账号能授权该应用。3305 用对应月份源表重导并完成幂等/导出验证；后续不要再沿用 09-22 报告的 3308 验证结论。backend.log → 按 P1-9 做成《校验报错_<年月>.xlsx》或页面提示。docs/交接文档_2026-09-21.md §4）ReportExportService.java:6251 仍写同一格）；getLastMidIssues() 无调用方）；fixCityMonthHeaderText()），待跑一次 2026-08 导出核对后再改；| 用途 | 路径 / 命令 |
|---|---|
| 每日总入口 | HANDOFF.md（本仓库根） |
| 项目规约 | AGENTS.md（仓库根） |
| 系统总交接 + P0/P1/P2 | docs/交接文档_2026-09-21.md |
| 汇总大表专项交接 | docs/问题汇总/汇总大表问题交接_2026-09-21.md |
| 汇总大表差异清单/明细 | docs/问题汇总/汇总大表_软件输出与手工定稿差异清单_2026-08_20260922.md + 同名 CSV |
| 投资比对/修复报告 | docs/功能测试报告/数据比对报告_投资明细表软件生成与人工版_2026-09-22.md、docs/功能测试报告/功能测试报告_投资明细表取数修复_2026-09-22.md |
| 潜江重导验证报告 | docs/功能测试报告/功能测试报告_潜江投资物流月报重导_2026-09-23.md |
| 历史问题坑索引 | docs/问题汇总/问题与注意事项汇总_2026-09-16.md |
| 汇总大表母版 | docs/生成汇总大表/（{yyyy}年{M}月道路运输量汇总表.xlsx） |
| 投资模板/输入/输出 | docs/投资/模板/、docs/投资/输入/…、docs/投资/输出/ |
| 启停 | start-dev.ps1 / stop-dev.ps1（沙箱外） |
| 后端/前端日志 | backend.log、traffic-audit-web/frontend.log |
本文由 2026-09-23 会话生成，用于新对话续接。系统全景仍以 docs/交接文档_2026-09-21.md 为准。