| | |
|---|
| | | > **用法**：新对话开始后，先读本文件 + 项目根目录 `AGENTS.md`，即可无缝接力。 |
|---|
| | | > **每天结束时**：把当天进展、踩过的坑、新需求、未完成事项更新到本文件，然后可以放心开新对话。 |
|---|
| | | |
|---|
| | | ## 今日（2026-08-28） |
|---|
| | | |
|---|
| | | ### 1. 登录验证码：测试阶段可跳过（已完成并验证） |
|---|
| | | - 后端新增 `app.captcha.required` 开关（缺省 `true`=启用）；本机 application.yml 与 example 现为 `false`（测试阶段跳过，**正式发布前改回 `true`**）。 |
|---|
| | | - LoginController：`captchaRequired=false` 时登录不校验验证码；新增公开接口 `GET /api/auth/captcha-config` 返回 `{required}`。 |
|---|
| | | - Login.vue：启动时拉取该配置；`required=false` 时隐藏验证码区域并显示「测试模式：行为验证码已跳过」提示，登录跳过验证；配置请求失败时默认按启用处理（安全兜底）。 |
|---|
| | | - 已实测：captcha-config 返回 required=false；admin/admin123 不带验证码直接登录 200；后端 mvn compile ✅、前端 npm run build ✅。 |
|---|
| | | - ⚠️ 需重新打包才在测试环境生效；正式发布时把 `app.captcha.required` 改回 `true`。 |
|---|
| | | |
|---|
| | | ### 2. 数据导入浏览器崩溃排查（进行中，用户线索更新） |
|---|
| | | - 用户补充：共 3 台机器出现（对方开发机 + 昨天打包测试 1 台 + 今天 1 台）；对方记录的「迅雷/驱动」是其主观判断；现象时好时坏、每台约 1/3 用户崩。 |
|---|
| | | - 已排除：/import/batches（limit≤200、81 条约 17KB）；进入页面无轮询/定时器。 |
|---|
| | | - 用户怀疑「目录导入（浏览/扫描目录）」→ 已加固（见下）。注意：该功能需用户主动打开目录浏览/点目录导入才触发，与「点数据导入菜单就崩」现象不完全吻合，**待用户确认崩溃时点的具体按钮**。 |
|---|
| | | - 加固（已完成，编译/构建通过）：后端 `listDirs` 子目录/文件列表各限 300（新增 `dirsTruncated`/`filesTruncated` 标记，`excelCount` 仍为真实总数）；前端「从目录批量导入」每批限 60 个文件（超限提示分批）；目录浏览弹窗显示截断提示。 |
|---|
| | | - 待办：让崩溃机器用户在 Chrome 开 `chrome://crashes` 记下原因码（OOM / GPU / STATUS_ACCESS_VIOLATION 等），并确认崩溃时点的是侧边栏「数据导入」菜单还是页面上某个按钮；据此决定下一步。 |
|---|
| | | - **重大进展（08-28 下午）**： |
|---|
| | | - 用户确认：**崩溃时服务器后端日志无任何记录 → 请求根本没到后端** → 卡在**静态资源/网络层**（点菜单后浏览器现场下载数据导入页 chunk JS，还没到发 API 那一步）。接口/数据库彻底排除。 |
|---|
| | | - 用户描述补充：点侧边栏「数据导入」菜单 → 无反应、停留主页 → 浏览器弹「应用程序无反应，是等待还是退出」= 渲染/浏览器进程 hang，非 crash。 |
|---|
| | | - 发布机器才是用户运行环境；本机 D:\trafficAudit 仅打包测试（17:39 后停止，日志正常）。 |
|---|
| | | - **本地打包形态压测（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/耗时）。 |
|---|
| | | |
|---|
| | | ### 3. 待办不变 |
|---|
| | | - `docs/打包部署说明.docx` 第六节「外置 application.yml 需包含完整配置」改为「属性级合并」后重新导出 docx（未做）。 |
|---|
| | | - 崩溃根因确认后：修正 commit `cf57c2b` 中「指向客户端环境」的旧结论。 |
|---|
| | | |
|---|
| | | |
|---|
| | | ## 〇、关机交接（2026-08-27 深夜，用户关机前） |
|---|
| | | - **当前运行状态**：前后端应用服务全部已停止（开发服务、打包版均未运行）；仅数据库在跑 |
|---|
| | | （MySQL80 服务=3305，本项目用；MySQL57=3306 勿动）；8080 上 IIS 站点仍在但本项目已不再依赖 IIS。 |
|---|
