# 操作留痕（Codex）

- 时间：2025-11-01 19:35（UTC+8）
- 动作：修改 Dockerfile 创建应用用户命令
- 位置：Dockerfile（运行阶段“创建应用用户和目录”）
- 变更：将原使用 addgroup/adduser 的写法替换为兼容 Debian/Ubuntu 与 Alpine 的健壮分支逻辑（优先使用 `groupadd/useradd`，回退到 `addgroup/adduser` 并按是否支持 `--gid` 区分参数）。
- 目的：修复构建阶段报错“Option g is ambiguous (gecos, gid, group)”，避免不同基础镜像工具链参数差异导致失败。
- 工具：apply_patch（补丁写入）
- 结果：补丁应用成功，建议以 `docker build --no-cache` 重新构建验证。

- 时间：2025-11-01 19:40（UTC+8）
- 动作：修复部署脚本 archive-manager.sh 镜像检查逻辑
- 位置：archive-manager.sh（deploy_app 函数）
- 变更：新增 `image_exists` 检查，通过 `docker image inspect` 判断本地镜像是否存在；若不存在，`deploy` 流程自动调用 `build_image` 进行构建，避免 `docker compose up` 因尝试拉取远端镜像而失败（镜像找不到）。
- 目的：解决部署时报“镜像找不到”的问题，提升一键部署体验。
- 工具：apply_patch（补丁写入）
- 结果：补丁应用成功，可通过 `./archive-manager.sh deploy <目录>` 直接部署，首次会自动构建镜像。

- 时间：2025-11-18 17:43（UTC+8）
- 动作：按环境调整日志输出配置
- 位置：src/main/resources/logback-spring.xml
- 变更：新增 springProfile 分支，开发环境仅输出控制台，生产环境写入与 Dockerfile 一致的 `/app/logs` 并保留分级 RollingFileAppender。
- 目的：满足开发环境不落盘、生产环境落盘且目录对齐容器目录的需求。
- 工具：apply_patch（重写配置文件）
- 结果：配置已更新，可通过启动 dev/prod Profile 验证控制台与落盘行为。

- 时间：2025-11-18 17:46（UTC+8）
- 动作：修复 logback 配置解析错误
- 位置：src/main/resources/logback-spring.xml
- 变更：将 springProfile 条件中的逻辑与符号转义为 `&amp;`，解决 XML 解析报错（“实体名称必须紧跟在 & 后面”）。
- 目的：确保 logback-spring.xml 能被 Spring Boot 正常加载。
- 工具：apply_patch（补丁写入）
- 结果：配置已更正，可再次启动验证。

- 时间：2025-11-18 18:00（UTC+8）
- 动作：调整 OperatorTable 读取数据源方式
- 位置：src/main/java/com/point/strategy/table/OperatorTable.java
- 变更：不再从固定 application.properties 读取数据源，改为注入 Spring Environment，通过激活的 profile 动态获取 `spring.datasource.*`，并在未配置时抛出明确异常；保持现有静态方法接口，内部连接创建随当前 yml 生效。
- 目的：保证建表 DDL 能使用当前激活配置的数据库连接，解决 dev/prod yml 下无法建表的问题。
- 工具：apply_patch（补丁写入）
- 结果：已更新，可在激活对应 profile 后尝试新增门类触发表创建。

- 时间：2025-11-20 09:45（UTC+8）
- 动作：定位 productSalesDocking 方法
- 工具：shell（rg -n "productSalesDocking" src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java）
- 输出：找到方法起始行 1136，确认分析范围

- 时间：2025-11-20 09:45（UTC+8）
- 动作：查看方法周边 1100-1400 行
- 工具：shell（sed -n '1100,1400p' src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java）
- 输出：截取方法上半段，记录日志与统计逻辑

- 时间：2025-11-20 09:46（UTC+8）
- 动作：扩展读取 1170-1900 行
- 工具：shell（sed -n '1170,1900p' src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java）
- 输出：获取循环处理逻辑但输出较大被截断

- 时间：2025-11-20 09:46（UTC+8）
- 动作：聚焦 1500-1700 行
- 工具：shell（sed -n '1500,1700p' src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java）
- 输出：查看 100 列组装逻辑

- 时间：2025-11-20 09:47（UTC+8）
- 动作：尝试用 python 截取完整方法
- 工具：shell（python - <<'PY' ...）
- 输出：命令失败，提示 python: command not found

- 时间：2025-11-20 09:47（UTC+8）
- 动作：使用 python3 重试提取方法
- 工具：shell（python3 - <<'PY' ...）
- 输出：成功导出方法文本，但因输出限制被截断

- 时间：2025-11-20 09:48（UTC+8）
- 动作：定位 LIMIT 10 语句行号
- 工具：shell（rg -n "LIMIT 10" src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java）
- 输出：确认 1230/1232 行存在 LIMIT 10
- 时间：2025-11-20 09:49（UTC+8）
- 动作：查看 LIMIT 相关代码行号
- 工具：shell（nl -ba src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java | sed -n '1205,1245p'）
- 输出：确认 totalPending 统计与 LIMIT 10 取数位于 1206-1233 行
- 时间：2025-11-20 09:52（UTC+8）
- 动作：移除 productSalesDocking 中的 LIMIT 10 限制
- 工具：apply_patch（编辑 src/main/java/com/point/strategy/oaDocking/controller/ArchivesUploadController.java）
- 输出：删掉取数 SQL 的 LIMIT 10，保留 biz_date 过滤与排序，确保一次性读取全部数据
- 时间：2025-11-20 09:42（UTC+8）
- 动作：检查 .claude 目录
- 工具：shell（ls .claude）
- 输出：目录不存在，返回 "ls: .claude: No such file or directory"

- 时间：2025-11-20 09:43（UTC+8）
- 动作：列出仓库根目录文件
- 工具：shell（ls）
- 输出：记录仓库根目录下的主要文件和目录

- 时间：2025-11-20 09:44（UTC+8）
- 动作：查看 operations-log.md 内容
- 工具：shell（cat operations-log.md）
- 输出：阅读历史留痕，确认记录格式

- 时间：2025-11-20 09:44（UTC+8）
- 动作：查询当前系统时间
- 工具：shell（date '+%Y-%m-%d %H:%M:%S %Z'）
- 输出：2025-11-20 09:44:48 CST

- 时间：2025-11-24 14:47（UTC+8）
- 动作：确认 .claude 目录是否存在
- 工具：shell（ls .claude）
- 输出：目录不存在，命令返回 “No such file or directory”

- 时间：2025-11-24 14:48（UTC+8）
- 动作：阅读 AnjuanAndJuanneiController.java 源码
- 工具：shell（sed -n '1,960p' src/main/java/com/point/strategy/originBatchUpload/AnjuanAndJuanneiController.java）
- 输出：获取 uploadSimpleFilesAnjuan 及相关上传实现用于 OOM 分析

- 时间：2025-11-24 14:49（UTC+8）
- 动作：查阅 PdfFileHelper.image2Pdf 实现
- 工具：shell（sed -n '520,620p' src/main/java/com/point/strategy/common/PdfFileHelper.java）
- 输出：确认图片转 PDF 逻辑使用 ImageIO.read + iText Image 双重加载

- 时间：2025-11-24 14:50（UTC+8）
- 动作：查询当前系统时间
- 工具：shell（date '+%Y-%m-%d %H:%M:%S %Z'）
- 输出：2025-11-24 14:50:02 CST

- 时间：2025-11-24 14:55（UTC+8）
- 动作：为传统案卷上传OCR处理增加线程池限流
- 位置：src/main/java/com/point/strategy/originBatchUpload/AnjuanAndJuanneiController.java
- 变更：新增受控线程池替代每文件新建线程，限制并发与队列，避免多文件同时触发大量OCR线程造成内存峰值。
- 工具：apply_patch
- 结果：代码已更新

- 时间：2025-11-24 14:56（UTC+8）
- 动作：优化图片转PDF内存占用
- 位置：src/main/java/com/point/strategy/common/PdfFileHelper.java
- 变更：移除 ImageIO 双重加载大图，直接用 iText Image 尺寸设置页面，减少一次内存占用。
- 工具：apply_patch
- 结果：代码已更新

- 时间：2025-11-24 14:59（UTC+8）
- 动作：对上传接口增加并发限流（每次最多3个文件）
- 位置：src/main/java/com/point/strategy/originBatchUpload/AnjuanAndJuanneiController.java
- 变更：新增 Semaphore，保证全局并行处理文件数不超过3；同时将 OCR 线程池调为 1~3 线程并缩短队列，匹配限流策略。
- 工具：apply_patch
- 结果：代码已更新