| | |
|---|
| | | |
|---|
| | | > **用法**：新对话开始后，先读本文件 + 项目根目录 `AGENTS.md`，即可无缝接力。 |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | > **协作约定（2026-08-31）**：说「提交」= 本地 commit + 推送到远端 git（origin main，Gitblit），不再只做本地 commit。 |
|---|
| | | |
|---|
| | | ## 今日（2026-08-28） |
|---|
| | | |
|---|
| | |
|---|
| | | - ⚠️ 需重新打包才在测试环境生效；正式发布时把 `app.captcha.required` 改回 `true`。 |
|---|
| | | |
|---|
| | | ### 2. 数据导入浏览器崩溃排查（进行中，用户线索更新） |
|---|
| | | - **【08-31 根因实锤更新】真正崩溃根因已找到：数据导入页 `<el-tabs>` 触发 Element UI 布局无限循环（详见下面第 4 节，commit 684da41）。此前「线程池占满/batches pending/慢上传」是另一条可复现机制，但不是用户场景的实锤根因；`/import/batches` pending 只是**表象**——el-tabs 布局风暴阻塞主线程后，页面后续请求（含 batches）全部发不出去/排队，表现为「batches pending + 浏览器无响应」。修复 el-tabs 后 dev 与打包形态均正常。 |
|---|
| | | - 用户补充：共 3 台机器出现（对方开发机 + 昨天打包测试 1 台 + 今天 1 台）；对方记录的「迅雷/驱动」是其主观判断；现象时好时坏、每台约 1/3 用户崩。 |
|---|
| | | - 已排除：/import/batches（limit≤200、81 条约 17KB）；进入页面无轮询/定时器。 |
|---|
| | | - 用户怀疑「目录导入（浏览/扫描目录）」→ 已加固（见下）。注意：该功能需用户主动打开目录浏览/点目录导入才触发，与「点数据导入菜单就崩」现象不完全吻合，**待用户确认崩溃时点的具体按钮**。 |
|---|
| | |
|---|
| | | - **本地打包形态压测（headless Chrome，20 轮菜单切换）**：导航 17~89ms、0 JS 错误、DOM 恒 949 节点无累积、堆内存 11~37MB 无泄漏、最长长任务 80ms → 应用 JS 层无死循环/大计算/泄漏。 |
|---|
| | | - **已加 Tomcat 访问日志**（`server.tomcat.basedir: .` + accesslog，jar 同级 `logs/access.*.log`，pattern 含 `%D` 耗时，静态资源也记录）——本地实测 chunk 请求 3ms。**重新打包发布后**，下次崩溃看 access log：chunk 请求是否到达、耗时多少 → 直接定位「服务器慢」还是「客户端没发出请求」。 |
|---|
| | | - 待用户：重新打包发布后，崩溃时看 ①服务器 `logs/access.*.log` ②客户端 F12 Network 中 `chunk-*.js` 请求状态（pending/stalled/耗时）。 |
|---|
| | | - **根因实锤（本机实验复现）**：Tomcat 9 NIO 下慢连接不占线程（slowloris 无效，已测），但**慢速 multipart 上传会占线程**——240 个慢上传占满线程池后，chunk 与 batches 请求全部 pending/超时（与用户现象一致）。**数据导入是同步长任务**（4 万行导入占 1 个线程 5 分钟，前端超时 600s），多用户同时导入/目录导入串行 → 200 线程耗尽 → 新请求（batches、静态文件）排队 pending → 浏览器等 →「无响应」弹窗。**只崩数据导入页**因为它进页即发 2 个 batches 请求且用户多在导入场景操作；其他页面在同样时刻也会 pending 只是未被注意。 |
|---|
| | | - **机制可复现（本机实验，非实锤）**：Tomcat 9 NIO 下慢连接不占线程（slowloris 无效，已测），但**慢速 multipart 上传会占线程**——240 个慢上传占满线程池后，chunk 与 batches 请求全部 pending/超时（与用户现象一致）。**数据导入是同步长任务**（4 万行导入占 1 个线程 5 分钟，前端超时 600s），多用户同时导入/目录导入串行 → 200 线程耗尽 → 新请求（batches、静态文件）排队 pending → 浏览器等 →「无响应」弹窗。**只崩数据导入页**因为它进页即发 2 个 batches 请求且用户多在导入场景操作；其他页面在同样时刻也会 pending 只是未被注意。 |
|---|
| | | - **修复（commit 728b372，已验证）**：① `server.tomcat.threads.max: 500`（application.yml + example）；② 数据导入页 `loadBatches`+`loadOverview` 合并为 `loadData`（进页/刷新/导入后只发 1 个 limit=200 请求，表格取前 50，概览复用同批数据）。**修复验证**：同样 240 慢上传压力下，batches 0.2s、chunk 0.1s 正常。 |
|---|
| | | - **遗留（建议下一步根治）**：导入异步化（@Async 独立线程池执行导入、前端轮询进度），彻底不占 Tomcat 请求线程；或 nginx 托管静态资源。对方 dev 机单用户也 pending，需看对方后端日志（可能 DB 连接/锁，或对方当时在跑导入），与本修复不冲突。 |
|---|
| | | - **用户反驳（08-28 晚）→ 线程池耗尽不是当前场景实锤根因**：崩溃时仅 3 个用户（1 人已登入、1 人未登入、1 人登入后即出问题），时间上不可能占满 200 线程。线程池 500 + batches 合并的修复仍有效（降低同类风险），但不要对用户宣称根因已实锤。真正待取证：重新打包发布后崩溃时看 ①服务器 `logs/access.*.log`（chunk/batches 是否到达、%D 耗时）②对方 dev 机（单用户也 pending 的复现机）后端日志（是否 DB 连接/锁/SQL 卡住）。 |
|---|
| | | |
|---|
| | | ### 3. 待办不变 |
|---|
| | | ### 3. 前端 API 全局超时保护（已完成并推送 commit 41487b9） |
|---|
| | | - 背景：用户要求所有向后台的 API 请求都加超时保护，超时优雅提示（网络/服务器异常），不要无限 pending。 |
|---|
| | | - 实现：`src/api/index.js` axios 实例默认 `timeout: 15000`；响应拦截器里 `ECONNABORTED` → 弹「请求超时：服务器繁忙或无响应，请稍后重试」、无 `response` → 弹「网络异常：无法连接服务器」，并给 error 打 `_toast` 标记，页面 catch 里 `if (e && e._toast) return` 避免重复弹；401 跳登录逻辑不变。 |
|---|
| | | - 长耗时请求显式覆盖：文件上传 600s/300s（原有）、`/audit/execute` 120s、`/audit/review` `/audit/markAudited` `/explain/save` 60s、`/llm/chat` 120s、报表导出 120s、报表预览/就绪 60s、验证码接口 10s、登录 15s。 |
|---|
| | | - 覆盖文件 11 个（api/index.js、AiChatDialog、Captcha3D、AuditResult、DataImport、DataView、ExplainReview、Login、ReportExport、RuleManage、UserManage），node24 构建通过，已提交推送。 |
|---|
| | | |
|---|
| | | ### 4. 菜单/布局与强制登录全部解决（已推送） |
|---|
| | | - 用户反馈 4 个问题：①点「审核结果」菜单不高亮；②企业解释/用户管理顶部没有统一横栏；③某些页面退出登录不显示；④关标签页/浏览器后重开要求强制登录。四项均已完成并实测通过！ |
|---|
| | | - ②③（commit 2bd663b）：ExplainReview.vue 重复 `components` 键覆盖（`{ AppHeader }` 被 `{ AiChatDialog }` 覆盖）→ 企业解释页 app-header 未注册无横栏；已合并。RuleManage/UserManage 旧版布局（无 app-header、退出藏菜单且失效）→ 统一为 app-header 上下布局。 |
|---|
| | | - ④（commit c62a61c）：认证信息（token/username/realName/modules）从 localStorage 改存 **sessionStorage**，关标签页/浏览器后强制重新登录；同标签页 F5 刷新保持登录。偏好记忆（DataImport `dirLast_*`、ReportExport `report_note_*`）保留 localStorage。实测：新标签页直访 #/dashboard 被守卫重定向到 /login ✓；F5 后保持登录 ✓。 |
|---|
| | | - **①根因实锤（commit 684da41，本日重大突破）：数据导入页的 `<el-tabs>` 触发 Element UI 布局无限循环（Chrome Trace 实测：主线程每秒 1000+ 次 Layout/UpdateLayoutTree，无 JS FunctionCall，组件挂载未完成→ batches 请求不发出→ `batchLoading` 永 true → el-loading 动画永转）。这就是用户「点数据导入菜单就浏览器无响应」和「点审核结果不高亮」的真正根因（与此前线程池/上传压力无关！）。 |
|---|
| | | - 修复方式：将 el-tabs 改为 `<el-radio-group>` + `<el-radio-button>` 模块切换 + `v-show` 面板（功能等价，回避 el-tabs 触发器）。验证：★ dev + **打包形态（dist + 静态代理 8091）** 均正常：/import 进入 8ms 发出 batches，无长任务；完整点击 8 个菜单高亮全部正常。 |
|---|
| | | - 测试脚本：`D:\Codex\_tools\pptr-core\` 下 import_probe2.js / import_verify.js / menu_final.js / session_test.js / prod_import_test2.js / prod_server.js（打包静态+API 代理，用于本地验证 dist）。trace 分析脚本在 %TEMP%\analyze_trace*.py。 |
|---|
| | | |
|---|
| | | ### 5. 待办不变 |
|---|
| | | - 用户反馈 4 个问题：①点「审核结果」菜单不高亮；②企业解释/用户管理顶部没有统一横栏；③某些页面退出登录不显示；④（新增）不点退出直接关标签页/浏览器，重开后跳过登录直接进主页，要求重开时强制登录。 |
|---|
| | | - 已修复（②③）：ExplainReview.vue 有重复 `components` 键（`{ AppHeader }` 被后面的 `{ AiChatDialog }` 覆盖）→ app-header 未注册、企业解释页顶部横栏丢失；已合并为 `{ AppHeader, AiChatDialog }`。RuleManage.vue / UserManage.vue 还是旧版布局（`<el-container>` 无 direction、`<el-header>` 无用户/登出、退出登录藏在菜单里且 RuleManage 根本没有 logout 方法）→ 统一改为 `<app-header>` 上下布局、删菜单内退出项，与其余 6 页一致。 |
|---|
| | | - 已实测（puppeteer headless，admin/admin123 登录后逐路由访问）：/explain /rules /users 均有 app-header + 退出按钮；/audit 直接访问时菜单高亮「审核结果」正常 → 问题① 不在 AuditResult 自身。 |
|---|
| | | - **新发现（重要）**：/import（数据导入）页面挂载后 **JS 主线程卡死**（puppeteer evaluate 3s 超时，goto 已到 #/import 但页面脚本长时间不响应）——怀疑这就是「点审核结果不高亮」及此前「数据导入菜单一点就浏览器无响应」的根因方向（页面 JS 阻塞 → 点击事件/高亮更新被卡住）。下一步：profiling /import 页 loadData（batches 响应后 overview 构造 / 200 行表格渲染）找主线程长任务。 |
|---|
| | | - 问题④ 未做（下次优先）：把认证信息（token/username/realName/modules）从 localStorage 改存 **sessionStorage**（关标签页即清空 → 强制登录），涉及 Login.vue、router/index.js、api/index.js、main.js、AppHeader.vue、ReportExport.vue；DataImport 的 `dirLast_*`、ReportExport 的 `report_note_*` 属偏好记忆保留 localStorage。注意：同标签页 F5 刷新保持登录、新开标签页需重登。 |
|---|
| | | - 测试脚本：`D:\Codex\_tools\pptr-core\menu_test3.js`（点击遍历）、`menu_test4.js`（逐路由访问，推荐）、`login_debug.js`；node24 运行（`C:\Users\jcxiong\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe`）。 |
|---|
| | | |
|---|
| | | ### 5. 待办不变 |
|---|
| | | - `docs/打包部署说明.docx` 第六节「外置 application.yml 需包含完整配置」改为「属性级合并」后重新导出 docx（未做）。 |
|---|
| | | - 崩溃根因确认后：修正 commit `cf57c2b` 中「指向客户端环境」的旧结论。 |
|---|
| | | - ~~/import 页 JS 主线程卡死待调查~~ → 已实锤：el-tabs 布局循环，已修复（见上。 |
|---|
| | | - ~~认证信息 localStorage → sessionStorage~~ → 已完成（commit c62a61c）。 |
|---|
| | | |
|---|
| | | |
|---|
| | | ## 〇、关机交接（2026-08-27 深夜，用户关机前） |
|---|
