2026-06-24 10:42:57 +08:00
# 2026-06-24 工作日志
## 当日工作内容
- 09:41： ，
- 修改：新增 `agent-change-log` Skill，
- 修改：新增 Skill 展示元数据，方便后续通过 `$agent-change-log` 识别和调用。
- 修改：准备把 `AGENTS.md` 接上强触发规则，避免后续代理只记得“写代码”而忘了“写修改记录”。
- 操作：沿用既有 `document/work-log/YYYY-MM-DD.md` 日志目录，不另起一套新路径，避免历史记录分裂。
- 验证：
- 影响：后续修改会从“最终总结”升级为“过程可追踪”，当天工作内容、遗留问题和 TODO 会随着每轮修改持续增长。
- 09:42： `agent-change-log` 规则做了第一次自检，并把验证结果回填到当天日志里。
- 操作：运行 `git diff --check` 检查本轮涉及文件的空白问题。
- 操作：用 `rg` 检查 Skill frontmatter、`AGENTS.md` 触发规则，以及日志中的 `当日工作内容` 、`遗留问题` 、`TODO` 三个固定标题。
- 验证：`git diff --check` 无输出，说明补丁没有空白错误；`rg` 能命中 `agent-change-log` 、日志路径和三段式标题。
- 影响：这个日志 Skill 已经有了可执行的触发条件、固定记录位置和第一次样例记录，后续修改可以直接照这个格式增量追加。
- 09:43： `.gitignore` 忽略。
- 操作：运行 `git check-ignore -v` 检查 `.codex/skills/agent-change-log/SKILL.md` 和 `agents/openai.yaml` 的忽略来源。
- 验证：命中 `.gitignore:10:.codex/` ，说明普通 `git status` 不会显示这个新 Skill； `ls` 已确认两个文件真实存在。
- 影响：本机后续可以使用这个 Skill， ，
- 09:44： `.gitignore` 规则，让新建的 `agent-change-log` Skill 能进入普通版本管理视野，同时继续保护 `.codex` 下其他本地状态。
- 修改：把 `.codex/` 改成 `.codex/*` ，再只放行 `.codex/skills/agent-change-log/**` 。
- 操作：保留 `.codex` 其他内容默认忽略，避免把本地运行缓存、临时状态或其他未审查 Skill 一起暴露出来。
- 验证：`git status --short` 已能看到 `agent-change-log` 的两个新增文件；`git diff --check` 仍然无输出。
- 影响：后续提交这个 Skill 时不需要强制添加，普通 `git status` 就能看到相关文件。
- 10:01： ， ， `agent-change-log` 的硬流程。
- Git 提交检查：已运行 `git fetch --all --prune` ； `HEAD..origin/main` 未发现 upstream 新提交。当前本地 `main` 显示 ahead 1，
- 修改：更新 `agent-change-log` ，新增 `Required Git Check` ，要求写日志前执行 `git fetch --all --prune` 、`git status -sb` 、上游分支识别和 `git log HEAD..@{u}` 。
- 修改：更新 Skill 展示提示，把 upstream commit check 也列入触发场景。
- 修改：更新 `AGENTS.md` ，明确每次日志更新前先做 Git 拉取检查；工作区干净且只落后上游时可 `git pull --ff-only` ，脏工作区或可能冲突时只 fetch 并记录风险。
- 操作：没有在当前脏工作区执行自动 merge/rebase，
- 验证：`rg` 已命中 `Required Git Check` 、`git fetch --all --prune` 、`HEAD..@{u}` 和 `git pull --ff-only` ； `git diff --check` 无输出。
- 影响：后续日志会同时记录“我改了什么”和“其他智能体已经提交了什么”，不会只盯着本地 diff。
- 10:02： ， `origin/main..HEAD` 的本地提交。
- Git 提交检查：`origin/main..HEAD` 发现 `9321260 chore(skills): add git checkpoint commit loop` ，提交时间为 2026-06-24 09:47:05， `git-checkpoint-commit` Skill、展示元数据、`checkpoint_commit.py` 脚本，并调整 `.gitignore` 。
- 修改：更新 `agent-change-log` ，要求同时检查 `HEAD..@{u}` 和 `@{u}..HEAD` ，分别识别 upstream 新提交和本地 ahead 新提交。
- 修改：更新 `AGENTS.md` ，把本地 ahead 提交也纳入“其他智能体提交摘要”的记录范围。
- 操作：用 `git show --stat` 和 `git show --name-only` 查看 `9321260` 的文件清单与提交信息，没有改写该提交。
- 验证：`rg` 已命中 `@{u}..HEAD` 、`本地 ahead` 和 `9321260` ； `git diff --check` 无输出。
- 影响：后续即使其他智能体只做了本地 commit、还没 push，
- 10:21： `9321260` 提交后的工作日志。（ ）
- Git 提交检查： ： ； `origin/main` ； ：
- 修改：最近提交为 `9321260 chore(skills): add git checkpoint commit loop` 。
- 操作： `tools/agent-change-log/update_change_log.py` ，自动读取 Git 状态并写入当天日志。
- 验证：自动脚本只记录提交和 Git 状态，不替代业务测试；业务验证仍以本次任务实际运行结果为准。
- 影响：提交后即使执行代理忘记手动写日志，也会留下最低限度的时间、提交和分支状态记录。
- 10:21：
- Git 提交检查：当前权限下 `git fetch --all --prune` 会失败，错误是 `.git/FETCH_HEAD` 不允许写入；`origin/main..HEAD` 仍显示本地 ahead 提交 `9321260` 。
- 修改：新增 `tools/agent-change-log/update_change_log.py` ，用于自动生成并追加当天工作日志，包含 Git 双向提交检查、最近提交摘要、重复提交去重和 fetch 失败遗留问题记录。
- 修改：新增 `.githooks/post-commit` ，提交后调用日志脚本，作为真正的自动触发点。
- 修改：新增 `tools/agent-change-log/install_post_commit_hook.sh` 和 `README.md` ，说明如何把版本化 hook 安装到本地 `.git/hooks/post-commit` 。
- 修改：更新 `AGENTS.md` ，明确 Skill/AGENTS 只是规则，自动触发必须安装 post-commit hook； `.git` ，必须如实记录限制。
- 操作：尝试执行 `tools/agent-change-log/install_post_commit_hook.sh` ，当前沙箱返回 `mkdir: .git/hooks: Operation not permitted` ，所以本轮不能实际安装本地 hook。
- 验证：`update_change_log.py --dry-run --no-fetch` 能输出日志条目；默认 dry-run 能捕获 fetch 权限错误并输出遗留问题；真实运行脚本已成功追加 10:21 的 `auto-log:9321260` 记录。
- 影响：现在仓库里已经有可执行自动日志链路；等环境允许写 `.git` 后，安装 hook 即可实现“提交后自动写日志”。未提交的普通文件变更仍无法由 Git 自动判断，需要代理在任务结束前主动调用日志 Skill。
- 10:24：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ； `git status -sb` 显示当前 `main...origin/main [ahead 1]` ； `HEAD..@{u}` 未输出 upstream 新提交；`@{u}..HEAD` 显示本地 ahead 提交 `9321260 chore(skills): add git checkpoint commit loop` 。
- 修改：`document_preview.py` 把 PDF 渲染器标识升级为 `pdf-raster-cjk-safe-v3` ，新增 `render_pdf_pages()` ，按 `pdftoppm -> mutool -> gs -> pdftocairo` 尝试生成 PNG； `Missing language pack` 、`Unknown font tag` 、`No font in show` 这类会丢中文的输出时，不再接受该 PNG。
- 修改：`ocr.py` 删除“PDF 文本层可用就直接构建识别结果”的分支， ；
- 修改：`docker-compose.yml` 、`docker-compose.full.yml` 、`bootstrap_paddleocr_mobile.sh` 、`bootstrap_paddleocr_gpu.sh` 增加 `mupdf-tools` ，让容器里有 `mutool` 作为中文安全转图 fallback。
- 修改：`test_ocr_service.py` 增加回归测试，覆盖运行时依赖包含 `mupdf-tools` 、Poppler 字体映射失败时尝试下一个渲染器、坏转图不再调用 OCR worker、以及 PDF 文本层可用时仍必须调用 OCR worker。
- 操作：执行 `python3 -m py_compile` 、`git diff --check` 和 `rg` 残留检查；尝试按项目规范执行容器内定向 pytest。
- 验证：`py_compile` 、`git diff --check` 、残留搜索均通过；容器 pytest 未能执行，原因是当前 Codex 进程访问 Docker socket 被拒绝：`permission denied while trying to connect to the docker API at unix:///Users/caoxiaozhu/.docker/run/docker.sock` 。
- 影响：后续 PDF 票据如果第一轮转图丢中文，会自动切换渲染器；如果所有渲染器都不可用，会明确失败并提示转图问题，而不是把缺中文的坏图送进 OCR。
- 10:28：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ；当前 `main...origin/main [ahead 1]` ； `HEAD..@{u}` 未输出 upstream 新提交；`@{u}..HEAD` 仍显示本地 ahead 提交 `9321260 chore(skills): add git checkpoint commit loop` 。
- 发现：`server/storage/receipt_folder/caoxiaozhu_xf.com/f0dd9b4a-f7b7-4784-ade7-4e31b71f0b12/meta.json` 中 `preview_kind=pdf` 、`preview_media_type=application/pdf` ，前端 `ReceiptFolderView.vue` 因此走 `<iframe>` 而不是 `<img>` 。
- 根因：`OcrService._finalize_document()` 里旧逻辑在 PDF 文本层参与纠错且 OCR 文本占位符比例较高时，会主动把 `preview_kind` 和 `preview_data_url` 清空；票据夹保存时拿不到 `data:image/png` ，只能回退到原 PDF 预览。
- 修改：删除这段清空 PNG 预览的旧保护逻辑；转图阶段已经负责识别坏 PNG，
- 操作：执行 `python3 -m py_compile server/src/app/services/ocr.py server/tests/test_ocr_service.py` 、`git diff --check` 和 `rg` 残留检查。
- 验证：语法检查、空白检查和残留搜索均通过；容器 pytest 仍因 Docker socket 权限无法执行。
- 影响：后续 PDF OCR 结果即使使用文本层修正字段，也会保留 OCR 转图得到的 PNG 预览，票据夹应写入 `preview_kind=image` 、`preview_media_type=image/png` 。
- 10:32：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ；当前 `main...origin/main [ahead 1]` ； `HEAD..@{u}` 未输出 upstream 新提交；`@{u}..HEAD` 仍显示本地 ahead 提交 `9321260 chore(skills): add git checkpoint commit loop` 。
- 发现：最新两条票据夹记录 `e9e3c0be-...` 、`9ecee0d8-...` 上传时间为 10:29， `preview_kind=pdf` 、`ocr_line_count=0` ， `ocr_text` 仍是只有英文和数字的旧坏结果。
- 根因：`OcrService._build_cache_key()` 只使用 OCR 语言、设备、模型和文件 digest，
- 修改：新增 `OCR_RESULT_CACHE_PIPELINE_VERSION` ，把当前 PDF 渲染器标识 `DocumentPreviewAssets.PDF_RENDERER_ID` 和 `no-pdf-direct` 策略写入 OCR cache key。
- 修改：`test_ocr_service.py` 增加 `test_ocr_cache_key_includes_pdf_render_pipeline_version` ，防止以后改转图管线但继续吃旧缓存。
- 操作：执行 `python3 -m py_compile server/src/app/services/ocr.py server/tests/test_ocr_service.py` 、`git diff --check` 和 `rg` 检查；尝试执行容器内定向 pytest。
- 验证：本地语法检查、空白检查和残留搜索通过；容器 pytest 仍因 Docker socket 权限被拒绝，未能执行。
- 影响：后端加载新代码后，同一 PDF 会因为 cache key 变化重新进入 PDF 转 PNG + Paddle OCR 流程，而不是复用旧的 PDF fallback/坏识别结果。
- 10:40：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ；当前 `main...origin/main [ahead 1]` ；基于本地 ref， `HEAD..@{u}` 未输出 upstream 新提交；`@{u}..HEAD` 仍显示本地 ahead 提交 `9321260 chore(skills): add git checkpoint commit loop` 。
- 修改：`workbench-ai-file-preview-dialog.css` 将预览遮罩改成“侧边栏占位列 + 主内容列”的网格布局，弹窗固定落在第二列并居中；同时保留折叠侧栏变量和 900px 以下移动端单列布局。
- 修改：`workbench-ai-composer-components.test.mjs` 增加回归断言，锁定附件预览必须按主内容区域居中，而不是按整个 viewport 居中。
- 操作：检查本地 `5173` 可达，返回 `HTTP/1.1 200 OK` ；检查项目没有现成 Playwright/Puppeteer 依赖，未新增依赖。
- 验证：`node --test web/tests/workbench-ai-composer-components.test.mjs` 通过 8/8； `npm --prefix web run build` 构建通过；`git diff --check` 无输出。
- 影响：用户点击附件打开预览时，弹窗会避开左侧 AI 工作台侧边栏，在右侧主工作区内居中展示，截图里的“偏左/不居中”观感会收敛。
2026-06-24 12:36:03 +08:00
- 11:06： ，
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ；当前 `main...origin/main` ，基于本地 ref， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交。
- 修改：`SettingsView.vue` 将缓存管理区改为维护页式结构，
- 修改：`settings-view.css` 新增缓存管理布局样式，桌面 4 列、平板 2 列、手机 1 列；整体收敛为企业后台风格，减少截图里的空泛卡片感。
- 修改：`useSettings.js` 增加 `cacheClearFailed` 和 `normalizeCacheClearErrorMessage()` ，把后端原始 `Not Found` 映射为“缓存清理接口暂不可用，请确认后端服务已加载最新路由后重试。”。
- 修改：`settings-cache-management-section.test.mjs` 增加回归断言，锁定范围清单、保护说明、失败态和友好错误文案。
- 操作：检查本地 `http://127.0.0.1:5173/app/settings?section=cacheManagement` 可达，返回 `HTTP/1.1 200 OK` ；确认项目没有现成 Playwright/Puppeteer，
- 验证：`node --test web/tests/settings-cache-management-section.test.mjs` 通过 3/3； `npm --prefix web run build` 构建通过；`git diff --check` 无输出。
- 影响：缓存管理页现在能清楚说明“清什么、不清什么、执行后结果如何”，异常时不再直接显示生硬的 `Not Found` 。
2026-06-24 10:42:57 +08:00
- 10:41：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `error: cannot open '.git/FETCH_HEAD': Operation not permitted` ；当前 `main...origin/main [ahead 1]` ；基于本地 ref， `HEAD..@{u}` 未输出 upstream 新提交；`@{u}..HEAD` 显示本地 ahead 提交 `9321260 chore(skills): add git checkpoint commit loop` 。
- 修改：`receipt_folder.py` 在 `document.preview_data_url` 缺失且源文件是 `application/pdf` 时，保存阶段立即调用 `DocumentPreviewAssets.render_pdf_first_page()` 生成 `preview.png` ，并把 `preview_kind` 、`preview_media_type` 、`preview_rendered_with` 写成图片预览元数据；只有渲染异常时才回退到源 PDF 预览。
- 修改：`test_receipt_folder_service.py` 新增 `test_receipt_folder_pdf_save_eagerly_renders_image_preview` ，覆盖 PDF OCR 结果没有内嵌预览图时，票据夹仍应主动生成图片预览的场景。
- 操作：读取当前票据夹存储里的两条 PDF meta， `preview_kind=pdf` 、`preview_media_type=application/pdf` 且没有 `preview.png` ，这与前端显示 PDF 预览的问题一致。
- 验证：`python3 -m py_compile server/src/app/services/receipt_folder.py server/tests/test_receipt_folder_service.py` 通过；宿主机缺少 pytest 和后端依赖，容器 pytest 又因 Docker socket 权限被拒绝，暂未完成项目要求的容器定向测试。
- 影响：后续新上传或重新 OCR 保存的 PDF 票据会优先拥有 PNG 图片预览，前端票据夹预览应走 `<img>` 体验；既有已经写成 PDF fallback 的旧 meta 还需要单独刷新。
2026-06-24 12:36:03 +08:00
- 10:56： `Agent Trace` 分区替换为“缓存管理”，补上管理员一键清理进程内缓存的前后端链路。
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `error: cannot open '.git/FETCH_HEAD': Operation not permitted` ；当前 upstream 为 `origin/main` ；基于本地 ref， `HEAD..@{u}` 未输出 upstream 新提交，`@{u}..HEAD` 未输出本地 ahead 提交。
- 修改：后端新增 `SystemCacheService` 和 `/api/v1/settings/cache/clear` ，清理 OCR 识别结果缓存、运行时配置缓存、模型失败冷却缓存、知识库本地索引缓存和地点语义分析缓存，并返回每项清理数量；接口使用管理员依赖保护，不删除票据源文件、业务单据或数据库记录。
- 修改：`OcrService` 、`runtime_chat.py` 、`knowledge_rag_local.py` 、`application_location_semantics.py` 和 `config.py` 增加可计数的缓存清理入口，避免继续靠重启服务才能摆脱旧 OCR 结果。
- 修改：前端 `settingsModelHelper.js` 将 `agentTraces` 分区替换为 `cacheManagement` ； `SettingsView.vue` 增加“应用缓存”面板和“一键清理缓存”按钮；`useSettings.js` 接入 `clearSystemCaches()` ，展示清理中、成功/失败和各缓存项数量；同时移除系统设置里对 `AgentTraceCenterView` 的加载。
- 修改：移除 `LogDetailView.vue` 和 `DigitalEmployeeWorkRecords.vue` 中跳转到已删除 `agentTraces` 设置分区的“查看 Trace”按钮，
- 修改：新增 `test_system_cache_endpoints.py` 和 `settings-cache-management-section.test.mjs` ；顺手把设置页既有渲染/LLM 测试的断言目标从外层组件对齐到当前真实模型/子组件，并把渲染设置卡片间距恢复为测试要求的 24px。
- 操作：执行前端设置相关测试、`npm --prefix web run build` 、Python `py_compile` 、`git diff --check` 和旧 Agent Trace 设置入口残留搜索。
- 验证：前端设置测试全部通过，`npm --prefix web run build` 通过， `git diff --check` 无输出；容器 pytest 仍因 Docker socket 权限被拒绝，未能执行 `server/tests/test_system_cache_endpoints.py` 。
- 影响：管理员可以在系统设置里手动清掉 OCR 等进程内缓存；生产上如果某次 OCR 结果错误，不必依赖重启服务才能让同一附件重新走识别链路。
- 10:57：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `error: cannot open '.git/FETCH_HEAD': Operation not permitted` ；当前 `main...origin/main` ；基于本地 ref， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出提交。
- 发现：最新票据 `25be8906-d3c8-4236-934d-e769ee19d3a7` 的 `meta.json` 仍是 `preview_kind=pdf` 、`preview_media_type=application/pdf` ，目录里没有 `preview.png` ；同时 10:43 的 `POST /api/v1/ocr/recognize` 只耗时 9ms，
- 发现： `server/logs/app.log` 没有新的 `Starting X-Financial` ，所以用户随后测试时后端没有加载刚改的保存阶段预览逻辑；当前 Codex 沙箱执行 `docker ps` / `docker exec` 仍被 Docker socket 权限拒绝，无法替用户重启或检查容器内 `mutool` 。
- 修改：`ReceiptFolderView.vue` 在 `loadPreview()` 取回 blob 后，根据 `blob.type` 推断实际预览类型；如果后端懒刷新后返回 `image/png` ，即使详情 JSON 里还是旧的 `preview_kind=pdf` ，页面也会把 `selectedReceipt.preview_kind` 修正为 `image` 并走 `<img>` 。
- 修改：`receipt-folder-view.test.mjs` 新增静态回归断言，锁定 `inferPreviewKindFromBlob()` 、`image/*` 、`application/pdf` 和 `loadPreview()` 更新 `preview_kind` 的行为。
- 验证：先运行 `node --test web/tests/receipt-folder-view.test.mjs` 看到新增断言红灯；实现后同一测试通过；`npm --prefix web run build` 通过；`git diff --check` 无输出。容器内后端 pytest/运行时工具检查仍因 Docker socket 权限无法执行。
- 影响：根因层面仍需要重启/重建容器后端加载新代码和 PDF 渲染工具；前端层面已经避免“预览接口返回图片，但详情旧 kind 仍让 UI 当 PDF 展示”的二次误判。
- 11:09： `Not Found` 的原因，并给后端路由表补了 OpenAPI 回归断言。
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `error: cannot open '.git/FETCH_HEAD': Operation not permitted` ；当前 upstream 为 `origin/main` ；基于本地 ref， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交。
- 发现：`server/logs/app.log` 已记录 `POST /api/v1/settings/cache/clear 404` ，说明浏览器请求路径没有走偏，确实打进了当前 FastAPI 后端，但运行中的路由表还没包含新接口。
- 发现：后端最后一次启动日志是 10:01 左右，而 `settings.py` 的缓存清理路由是 10:49 后写入；后续没有新的 `Starting X-Financial` ， `touch settings.py` 也没有触发 reload 日志，判断当前容器后端未热重载新代码。
- 修改：`test_openapi_schema.py` 增加 `/api/v1/settings/cache/clear` 的 OpenAPI 断言，要求运行时路由表必须暴露“清理系统缓存”接口，防止后续代码改了但 router 没挂上仍然漏测。
- 操作：尝试用 `docker ps` 、`docker exec` 进入 `local-x-financial-linux` ，以及通过 `2223` SSH 进入容器；当前 Codex 沙箱分别被 Docker socket 权限和本机网络策略拒绝，不能直接替用户重启容器或在容器内执行 pytest。
- 验证：`python3 -m py_compile server/tests/test_openapi_schema.py server/src/app/api/v1/endpoints/settings.py server/src/app/schemas/settings.py server/src/app/services/system_cache.py` 通过；`node web/tests/settings-cache-management-section.test.mjs` 通过 3/3； `pytest server/tests/test_system_cache_endpoints.py server/tests/test_openapi_schema.py` 未能执行，原因仍是 Docker socket 权限拒绝。
- 影响：代码层面的接口和回归测试已经补齐；当前页面的 `Not Found` 需要运行中的后端容器重启/热重载后才会消失。
- 11:15： ，
- Git 提交检查：`git fetch --all --prune` 成功执行；当前 `main...origin/main` ； `HEAD..@{u}` 未输出 upstream 新提交；`@{u}..HEAD` 输出部分本地未 push 提交（如上文所述）。
- 修改：`SettingsView.vue` 调整了缓存管理的 DOM 结构，引入了如 `item-ocr` , `item-model` 等特定类名用于精细化配置图标颜色，将四类清理范围展示为动态可交互的卡片。
- 修改：`settings-view.css` 增加了微动效（卡片悬停浮起、图标放大效果）、阴影层级、渐变背景以及平滑过渡，同时升级了“一键清理缓存”的操作按钮质感和渐变绿色安全提示带。
- 验证：本地确认代码结构变更正确无冲突。由于当前沙箱没有可用浏览器自动化插件，未生成真实页面截图验证。
- 影响：缓存管理页面的视觉提升到了更专业现代的企业控制台风格。
- 11:19：
- 修改：撤销了刚刚给 `SettingsView.vue` 和 `settings-view.css` 中添加的高级渲染效果（去除了所有悬浮渐变、卡片光晕和彩色图标），并恢复为了扁平简约的标准卡片列表样式。
- 影响：现在“应用缓存清理”的样式已经和系统其他选项卡保持了更好的统一。
- 11:23： ，
- 发现：在我最初接手前，缓存管理的“清理面板”带有橙色背景（`#fffaf5` ）和橙色边框（`#fed7aa` ），“安全提示条”带有绿色背景（`#f0fdf4` ）和绿色边框（`#bbf7d0` ）。
- 修改：在 `settings-view.css` 中，将 `.cache-management-panel` 、`.cache-safety-strip` 和 `.cache-clear-button` 的这些定制颜色全部移除，统一使用与系统基调一致的 `#e2e8f0` 边框、`#f8fafc` 浅灰背景和 `#334155` 标准文本色。
- 影响： ，
- 11:29：
- 发现：之前这两个模块作为 `.settings-card` 的直接子元素，导致父级的 `padding-left: 24px; padding-right: 24px;` 直接作用在它们身上，而它们自己又带有边框和背景，结果就是在视觉上“边框贴着父容器的边缘”。
- 修改：在 `SettingsView.vue` 中，给这两个模块外面包裹了一层标准的 `<div>` 容器。
- 影响：现在父级的 padding 被外层 `div` 吸收，安全提示条和操作面板恢复了正常的内缩边距，完美对齐了中间的 4 个范围网格，不再有“顶破边界”的突兀感。
- 11:20： ，
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `error: cannot open '.git/FETCH_HEAD': Operation not permitted` ；当前 upstream 为 `origin/main` ；基于本地 ref， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交。
- 发现：`server/logs/app.log` 继续记录 03:07、03:11、03:14 的 `POST /api/v1/settings/cache/clear 404` ；请求仍然打进 FastAPI，
- 发现：`server/server_start.sh` 在容器内默认关闭 `SERVER_RELOAD` ，而外层 `start.sh` 之前没有容器判断，会误以为 `APP_DEBUG=true` 就是 reload 模式，导致复用旧后端时没有提示。
- 修改：`AGENTS.md` 、`docker-compose.yml` 、`docker-compose.full.yml` 将主容器名统一为 `local-x-financial-linux` ； `SERVER_RELOAD=${SERVER_RELOAD:-true}` ，让本地开发容器后端默认开启 uvicorn reload。
- 修改：`start.sh` 增加 `is_container()` 判断，容器内默认 reload 状态与 `server/server_start.sh` 保持一致；如果没有显式开启 reload，
- 修改：`settings-cache-management-section.test.mjs` 对齐当前缓存管理页 DOM 结构，避免继续断言已经不存在的旧 `cache-management-hero` 容器。
- 验证：`sh -n start.sh && sh -n server/server_start.sh` 通过；`python3 -m py_compile ...` 通过；`node web/tests/settings-cache-management-section.test.mjs` 通过 3/3； `git diff --check` 无输出；容器内 pytest 仍因 Docker socket 权限被拒绝。
- 影响：重启/重建 `local-x-financial-linux` 后，缓存清理接口应加载进运行路由表；后续本地开发容器里的后端改动也不会再静默停留在旧进程。
- 11:39：
- Git 提交检查：`git fetch --all --prune` 失败，错误是 `error: cannot open '.git/FETCH_HEAD': Operation not permitted` ；当前 upstream 为 `origin/main` ；基于本地 ref， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动。
- 根因：对话上传附件先写入票据夹，再归集到报销单附件；归集时会重新跑一次附件 OCR， `preview_data_url` ，即使票据夹里已有 PNG 预览，报销单附件 meta 仍会回退到源 PDF。清 OCR 缓存后，详情页不再有会话临时结果兜底，就暴露为 PDF 预览和“其他单据”。
- 修改：`expense_claim_attachment_operations.py` 读取 `source_receipt_id` 对应的票据夹预览资源，并在 OCR 来源选择时保留不弱于新 OCR 且带图片预览的票据夹结果，避免被一次同等质量但无预览图的新 OCR 覆盖。
- 修改：`expense_claim_attachment_presentation.py` 支持把票据夹已有的 PNG 预览复制到报销单附件目录，写入 `preview_kind=image` 、`preview_media_type=image/png` 和新的 `preview_storage_key` 。
- 修改：`expense_claim_attachment_document.py` 增加历史坏 meta 自动修复：当附件 meta 仍有 `source_receipt_id` ，且当前是 PDF 预览、`other` 类型或无字段时，详情页读取 meta/预览会从票据夹重新补回 OCR 字段和 PNG 预览。
- 修改：`test_attachment_association_jobs.py` 增加两条回归测试，分别覆盖清 OCR 缓存后归集仍保留票据夹 PNG/字段，以及已经退化成 PDF/其他单据的历史附件能通过 `source_receipt_id` 自动修复。
- 验证：`python3 -m py_compile server/src/app/services/expense_claim_attachment_presentation.py server/src/app/services/expense_claim_attachment_operations.py server/src/app/services/expense_claim_attachment_document.py server/tests/test_attachment_association_jobs.py` 通过；`git diff --check` 通过；容器内定向 pytest 仍因 Docker socket 权限被拒绝，命令未能进入 `local-x-financial-linux` 。
- 影响：后续从 AI 对话上传并自动归集的 PDF 票据，应在单据详情页展示报销单附件目录里的 PNG 预览，并稳定保留火车票字段；已经坏写入的附件只要 meta 里还保留 `source_receipt_id` ，打开详情页时会尝试自动修复。
- 11:55：
- Git 提交检查：`git fetch --all --prune` 成功；当前 `main...origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只新增 OCR/票据夹相关修改。
- 根因：运行容器缺 `poppler-data` / `mutool` ，中文 PDF 转图失败；`OcrService` 虽然先提取了 `pdftotext` 文本层，但 `_prepare_pdf_inputs()` 转图失败后直接返回失败结果，文本层没有机会进入分类和字段抽取。
- 根因：同一 PDF 之前已经以 `other/空字段` 写入票据夹时，`persist_ocr_batch()` 的重复文件路径会读取旧 meta 并覆盖新 OCR 结果，导致用户重新上传同一文件仍看到“当前会话已识别 · 其他单据”。
- 修改：`ocr.py` 增加 PDF 文本层兜底结果构建；当转图失败但文本层有有效字符时，继续生成结构化识别结果，同时保留转图失败 warning，
- 修改：`receipt_folder.py` 在重复文件命中旧票据时，如果新 OCR 结果明显更强（非 `other` 、有字段、有文本），会刷新旧票据的 OCR 派生 meta，
- 修改：`test_ocr_service.py` 、`test_receipt_folder_service.py` 增加红绿回归，覆盖 PDF 转图失败但文本层可用、旧坏 meta 被新 OCR 修复，以及测试间 OCR cache 隔离。
- 操作：重启当前实际运行容器 `x-financial-local-linux` ，等待 `http://127.0.0.1:5173/api/v1/health` 恢复；随后用 `caoxiaozhu@xf.com` 用户头对 `2月20_武汉-上海.pdf` 和 `2月23_上海-武汉.pdf` 重新调用 `/api/v1/ocr/recognize` ，修复同批两条旧坏票据 meta。
- 验证：容器内 `pytest -q server/tests/test_ocr_service.py server/tests/test_receipt_folder_service.py server/tests/test_ocr_endpoints.py server/tests/test_attachment_association_jobs.py` 通过 28/28； `python -m py_compile` 通过；`git diff --check` 无输出；真实 5173 OCR 接口返回两张 PDF 均为 `火车/高铁票` ，字段包含时间、车次、行程、金额、身份证号、车厢、座位号和商户。
- 影响：后续即使中文 PDF 转图依赖暂时缺失，
- 12:04：
- Git 提交检查：`git fetch --all --prune` 成功；当前 `main...origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动。
- 根因：仓库 `docker-compose.yml` 已写入 `poppler-data mupdf-tools` ，但当前占用 5173 的仍是旧容器 `x-financial-local-linux` ，它没有按最新 compose 重建，容器内只有 `pdftoppm/pdftocairo/pdftotext` ，缺 `poppler-data` 和 `mutool` ，所以后端只能回退到源 PDF 预览。
- 操作：在当前开发容器内执行 `apt-get update && apt-get install -y --no-install-recommends poppler-data mupdf-tools` ；随后访问两条 receipt 的 `/preview` 接口触发 `_refresh_pdf_preview_asset_if_needed()` 生成 `preview.png` 。
- 验证：两个 `/api/v1/receipt-folder/{id}/preview` 响应都已从 `application/pdf` 变为 `image/png` ； `file` 确认为 `PNG image data, 1323 x 882` ；两条 `meta.json` 均写入 `preview_kind=image` 、`preview_media_type=image/png` 、`preview_file_name=preview.png` 、`preview_rendered_with=pdf-raster-cjk-safe-v3` ；人工查看 `preview.png` 确认中文票面正常渲染。
- 影响：当前 5173 页面重新打开这两条票据预览时应直接走图片预览；后续当前容器内新上传同类中文 PDF 也会优先生成 PNG 预览。
- 12:23： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动。
- 根因： `File.type/name` 判断卡片类型，所以 PDF 票据即使 OCR 已识别为火车票、票据夹预览接口已返回 PNG， ； `preview_data_url` ，没有统一处理 `receipt_preview_url` 。
- 修改：新增 `documentPreviewAssets.js` ， `travelReimbursementAttachmentModel.js` 、`ReceiptFolderView.vue` 、`workbenchAiComposerModel.js` 和 `useWorkbenchAiFilePreview.js` 改为复用同一套解析逻辑。
- 修改：会话附件卡片在 OCR document 带 `preview_kind=image` + `receipt_preview_url` 时优先显示图片类图标，不再继续按原始 PDF 类型展示；附件预览弹窗遇到票据夹预览接口时通过 `fetchReceiptFolderAsset()` 带鉴权拉取 blob， `Content-Type` 选择图片/PDF 展示。
- 修改：`receipt_folder.py` 在 OCR 持久化后把票据夹 meta 里的 `preview_kind` 回填到返回给会话层的 OCR document； `preview_kind=image` 。
- 验证：前端 `node --test web/tests/attachment-association-confirmation.test.mjs web/tests/workbench-ai-composer-components.test.mjs` 通过 24/24； `node --test web/tests/receipt-folder-view.test.mjs` 通过；容器内 `pytest -q server/tests/test_ocr_endpoints.py server/tests/test_ocr_service.py server/tests/test_receipt_folder_service.py` 通过 25/25； `npm --prefix web run build` 通过；`python -m py_compile` 通过；`git diff --check` 无输出。
- 操作：重启当前实际运行容器 `x-financial-local-linux` 并确认 `/api/v1/health` 正常；真实 5173 `/api/v1/ocr/recognize` 重新上传 `2月23_上海-武汉.pdf` 后返回 `document_type=train_ticket` 、`preview_kind=image` 、`receipt_preview_url=/receipt-folder/.../preview` ，对应 `/preview` 响应 `content-type: image/png` 。
- 影响： `documentPreviewAssets.js` ，就不会再各自维护一套 PDF/图片判断。
2026-06-24 21:59:15 +08:00
- 12:52：
- Git 提交检查：`git fetch --all --prune` 成功执行；`HEAD..origin/main` 与 `origin/main..HEAD` 均无提交。
- 修改：在 `receipt-folder-view.css` 中，为弹窗外框加上轻量圆角 (6px) 与精致投影；将弹窗 header padding 收至 `20px 24px 12px 24px` ， `0 24px 20px 24px` ，确保紧凑挺拔。
- 修改：将列表行间距设为 `8px` ，每个条目高度收敛至 `52px` ，内边距调整为 `10px 14px` ，文件名与说明文本大小降为 `13px` 与 `11.5px` ，以求更加精致细腻。
- 修改：将底部操作区的按钮高度设为标准 `36px` ，水平内边距设为 `16px` ，字重保持专业的 `500` ，使比例更协调，消除挤压感的同时保留小巧玲珑感。
- 操作：执行前端生产编译构建 `npm run build` 并运行 `node --test web/tests/receipt-folder-view.test.mjs` 。
- 验证：`npm run build` 构建成功，单元测试通过，`git diff --check` 无输出。
- 影响：弹窗彻底摆脱了原本的拥挤挤压感，同时避免了尺度过大、粗糙的问题，整体显得小巧精致、清爽洗练。
- 13:03：
- Git 提交检查：`git fetch --all --prune` 已在 Git 写权限升级后成功执行；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只触碰 AI 工作台申请意图与测试文件。
- 修改：`workbenchAiApplicationGateModel.js` 新增 `resolveInlineTravelApplicationRequest()` ，识别“出差/差旅/交通 + 具体地点或交通方式”的申请意图，并排除查标准、问制度、查进度等咨询类请求。
- 修改：`usePersonalWorkbenchAiMode.js` 在已有申请表动作之后、报销创建入口之前接入差旅申请识别；命中后直接调用 `startAiApplicationPreview()` ，并把同句里的“直接提交”转成 `autoSubmit` 。
- 修改：`useWorkbenchAiApplicationPreviewFlow.js` 支持申请预览生成后自动提交；只有 `normalizeApplicationPreview(preview).readyToSubmit` 为真时才带 `confirmed: true` 复用现有提交前核查和提交动作，缺日期等必填项时仍停在核对表。
- 修改：`workbench-ai-application-gate-model.test.mjs` 和 `expense-application-fast-preview.test.mjs` 增加回归测试，锁定紧凑差旅直提句子的识别、分流和自动提交接线。
- 验证：`node --test web/tests/workbench-ai-application-gate-model.test.mjs` 通过 4/4； `node --test --test-name-pattern "direct-submit" web/tests/expense-application-fast-preview.test.mjs` 通过 2/2； `git diff --check -- ...` 无输出；`npm --prefix web run build` 构建通过。
- 验证补充：整跑 `node --test web/tests/expense-application-fast-preview.test.mjs` 时，本次新增用例通过，但该文件仍有 12 个既有失败，集中在其它文案/静态结构断言，已单独记录为遗留问题。
- 影响： ，
- 13:20：
- Git 提交检查：`git fetch --all --prune` 首次被 `.git/FETCH_HEAD` 权限拦截，随后在升级权限下成功执行；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮新增 `AI意图规划器` 文档和 planner 接线。
- 修改：新增 `document/development/AI意图规划器/CONCEPT.md` 和 `TODO.md` ，明确大模型负责识别动作与步骤，业务执行器负责白名单校验、必填校验、查重和提交。
- 修改：新增 `workbenchAiIntentPlannerModel.js` ，把后端 `StewardPlanResponse` 或本地 fallback 统一归一为 `intent plan` ，计划中包含 `intent` 、`requestedAction` 、`slots` 、`missingFields` 和 `steps` 。
- 修改：`useWorkbenchAiStewardFlow.js` 增加 `resolveInlineExecutionPlan()` ，复用现有 `/steward/plans` 大模型 function calling 能力，返回模型计划；调用失败或超时时由前端 fallback 接管。
- 修改：`usePersonalWorkbenchAiMode.js` 不再直接消费正则识别结果，而是先尝试 steward 模型计划，再用 `buildRuleFallbackWorkbenchAiIntentPlan()` 兜底，最后通过 `resolveExecutableTravelApplicationPlan()` 驱动申请预览和自动提交；模型规划等待期间会锁住发送态，避免重复触发。
- 修改：`workbench-ai-intent-planner-model.test.mjs` 增加模型计划归一化、fallback、政策咨询排除和主流程接线测试； `expense-application-fast-preview.test.mjs` 的直提断言同步为 planner 语义。
- 验证：`node --test web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs` 通过 8/8； `node --test --test-name-pattern "direct-submit" web/tests/expense-application-fast-preview.test.mjs` 通过 2/2； `npm --prefix web run build` 构建通过；`git diff --check -- ...` 无输出。
- 验证补充：整跑 `expense-application-fast-preview.test.mjs` 仍有 12 个既有失败，当前与本次 planner 新增用例无关；本轮未在真实页面输入框回放模型返回路径。
- 影响：复杂意图链路现在有了清晰的模型计划适配层；后续扩展报销、附件归集、关联申请单时，可以继续让模型输出 steps，
- 13:35： ， ， ， ， ，
- Git 提交检查：`git fetch --all --prune` 普通沙箱首次失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ；随后在升级权限下成功执行。当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只继续修改 AI 工作台意图规划、申请预览执行和对应测试。
- 修改：`workbenchAiIntentPlannerModel.js` 新增 `shouldRequestWorkbenchAiIntentPlan()` ，把差旅、申请、交通方式、保存草稿、直接提交等财务执行候选先送进 steward 计划器；同时新增 `save_application_draft` step， `requestedAction=save_draft` 归一成可执行的 `autoSaveDraft` 。
- 修改：`workbenchAiApplicationGateModel.js` 放宽本地兜底识别，支持“上海出差”这种目的地前置写法和单独出现的“火车/高铁/飞机”等交通方式。
- 修改：`usePersonalWorkbenchAiMode.js` 不再只在 fallback 已经完整命中时才规划；只要 `shouldRequestWorkbenchAiIntentPlan()` 认为是财务执行候选，就先走模型计划，模型失败才用本地 fallback。
- 修改：`useWorkbenchAiApplicationPreviewFlow.js` 在生成申请核对表后支持 `autoSaveDraft` ，直接复用现有 `AI_APPLICATION_ACTION_SAVE_DRAFT` 保存草稿动作；自动提交仍只在 `readyToSubmit` 为真时执行。
- 验证：`node --test web/tests/workbench-ai-intent-planner-model.test.mjs` 通过 5/5； `node --test --test-name-pattern direct-submit web/tests/expense-application-fast-preview.test.mjs` 通过 2/2； `node --test web/tests/workbench-ai-application-gate-model.test.mjs` 通过 4/4； `npm --prefix web run build` 构建通过；`git diff --check -- ...` 无输出；尾随空白扫描无命中。
- 验证补充：用 Node 直接解析用户原句，结果为 `requestedAction=save_draft` ， `build_application_preview -> validate_required_fields -> save_application_draft` ，可执行参数为 `autoSubmit=false` 、`autoSaveDraft=true` 。
- 影响： ，
- 13:58：
- Git 提交检查：`git fetch --all --prune` 普通沙箱首次失败，错误是 `.git/FETCH_HEAD: Operation not permitted` ；随后在升级权限下成功执行。当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮继续修改 steward function calling、AI 工作台 planner、申请预览字段接力和测试。
- 修改：后端 `StewardTask` 增加 `requested_action` ， `StewardIntentAgent` 的 tool schema 要求模型输出 `preview/save_draft/submit` ； `StewardModelPlanBuilder` 将模型动作写入任务，缺省时才按原文保守推断。
- 修改：`usePersonalWorkbenchAiMode.js` 将入口从“先构造 fallback 再规划”改成 `executeModelPlannedWorkbenchIntent()` ：先调用 `resolveInlineExecutionPlan()` ，再把模型 plan 归一为可执行申请；只有模型失败时才执行 `buildRuleFallbackWorkbenchAiIntentPlan()` ，并保留模型识别到 reimbursement task 后进入原报销关联门。
- 修改：`workbenchAiIntentPlannerModel.js` 保留模型拆出的 canonical ontology fields， `shouldRequestWorkbenchAiIntentPlan()` 改为普通有效输入都先进入 planner，
- 修改：`workbenchAiApplicationPreviewModel.js` 和 `useWorkbenchAiApplicationPreviewFlow.js` 支持把模型拆出的 `time_range/location/reason/transport_mode` 转为申请预览 ontology， ，
- 测试：先让 `workbench-ai-intent-planner-model.test.mjs` 红灯失败，确认旧实现缺少 `ontologyFields` 、政策查询被排除、入口仍携带 `fallbackIntentPlan` ；随后实现并跑绿。
- 验证：`node --test web/tests/workbench-ai-intent-planner-model.test.mjs` 通过 7/7； `node --test --test-name-pattern direct-submit web/tests/expense-application-fast-preview.test.mjs` 通过 2/2； `node --test web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs` 通过 11/11； `x-financial-local-linux` 内 `pytest -q server/tests/test_steward_intent_agent.py server/tests/test_steward_planner.py` 通过 27/27； `py_compile` 通过；`npm --prefix web run build` 构建通过；`git diff --check` 无输出，尾随空白扫描无命中。
- 验证补充：用 Node 直接归一模型 plan， `requestedAction=save_draft` 、`ontologyFields.time_range=2026-02-20 至 2026-02-23` 、`location=上海` 、`reason=国网仿生产服务器部署` 、`transport_mode=火车` 、`autoSaveDraft=true` 。
- 影响：
- 14:33： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮继续修改 steward planner/runtime、申请字段解析、AI 工作台等待时间和相关测试。
- 修改：`StewardPlannerService.build_plan()` 改成先调用模型 intent agent， ；
- 修改：`StewardIntentAgent` 的 function calling 调用改为 `timeout_seconds=10` 、`max_attempts=3` ，并通过 `RuntimeChatService.complete_with_tool_call(use_failure_cooldown=False)` 避免第 1 次失败后第 2、3 次被 cooldown 跳过。
- 修改：`useWorkbenchAiStewardFlow.js` 将 inline execution plan 等待时间从 12s 调到 35s，
- 修改：`ApplicationFactResolver` 和 `StewardPlannerExtractionMixin` 的规则降级补齐 `requested_action` 、完整日期范围和申请事由清洗；即使模型 3 次超时，
- 测试：先新增红灯测试覆盖“单一出差描述也要先调用模型”“模型调用参数为 10s/3 次”“tool-call 规划可关闭 cooldown 连续重试”“前端等待 35s”“规则降级保留保存草稿和日期范围”，
- 验证：容器内 `pytest -q server/tests/test_runtime_chat_service.py server/tests/test_steward_intent_agent.py server/tests/test_steward_planner.py` 通过 38/38； `node --test web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs` 通过 11/11； `npm --prefix web run build` 通过；`git diff --check -- ...` 无输出。
- 真实接口验证：重启 `x-financial-local-linux` 后直接请求 5173 的 `/api/v1/steward/plans` ，原句耗时 32.08s， `attempt=1/2/3` 均约 10.2s 超时后才返回 `planning_source=rule_fallback` ；返回任务已包含 `requested_action=save_draft` 、完整 `time_range=2026-02-20 至 2026-02-23` 、`location=上海` 、`reason=国网仿生产服务器部署` 、`transport_mode=train` 。
- 影响：用户不会再看到毫秒级规则直出；当前模型服务超时时会先完整等待三次，再用可执行的基础规则计划继续流程。
- 15:14： ， ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮新增 LangGraph 依赖、graph planner、runtime 开关和测试。
- 修改：新增 `StewardGraphPlannerService` ，用 LangGraph `StateGraph` 编排 `prepare_context -> detect_model_intent -> off_topic/rule_fallback/完成` ，不再把规划主流程继续写在一个手工 `if/else` 方法里。
- 修改：`/steward/plans` 和 `/steward/plans/stream` 的 planner 工厂默认返回 `StewardGraphPlannerService` ； `STEWARD_AGENT_RUNTIME=legacy` 可回退到旧 `StewardPlannerService` 。
- 修改：`server/pyproject.toml` 、`server/uv.lock` 和 `egg-info` 同步加入 `langgraph>=1.2,<2.0` ； `.env.example` 增加 `STEWARD_AGENT_RUNTIME=langgraph` 。
- 测试：先新增 `test_steward_graph_planner.py` 红灯测试，覆盖 LangGraph planner 的模型成功路径、模型无 tool call 后规则降级、默认 LangGraph、显式启用 LangGraph 和 legacy 回退；随后实现并跑绿。
- 验证：容器内 `pytest -q server/tests/test_steward_graph_planner.py server/tests/test_steward_planner.py server/tests/test_steward_intent_agent.py server/tests/test_runtime_chat_service.py server/tests/test_config_settings_reload.py` 通过 45/45； `ruff check --ignore E501 ...` 通过；`git diff --check` 无输出；`pip check` 无 broken requirements。
- 真实接口验证：通过真实 5173 `/api/v1/steward/plans` 回放保存草稿原句，服务端仍先等待 MiniMax 3 次 10s 超时，再返回 `rule_fallback` ；返回字段包含 `requested_action=save_draft` 、完整日期范围、上海、事由和 `transport_mode=train` 。容器内直接探针确认默认 planner 类型为 `StewardGraphPlannerService` 。
- 影响：小财管家的规划骨架已经由 LangGraph 承接；后续可以继续把 slot/runtime decision、checkpoint 记忆、human-in-the-loop 和 action node 迁到框架里，而不是继续扩写自研分支编排。
- 15:22： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只修改 AI 意图规划器文档和当天工作日志。
- 修改：新增 `LANGGRAPH_RUNTIME_MIGRATION.md` ，记录当前已完成的 LangGraph 第一阶段、目标架构、runtime state 草案、节点边界、Phase 1-5 迁移计划、回退策略、验证矩阵和风险处理。
- 修改：更新 `CONCEPT.md` ，删除“非目标：不新增 LangGraph”的过期表述，
- 修改：更新 `TODO.md` ，把 `requested_action` 、LangGraph 接入和迁移文档标为完成，
- 操作：查询 LangGraph 官方文档，确认 Graph API、persistence 和 interrupt 的能力边界；读取当前 `StewardGraphPlannerService` 与已有 AI 意图规划文档后再落文档。
- 验证：`rg` 确认旧“不能新增 LangGraph”说法没有残留； `git diff --check -- document/development/AI意图规划器/...` 无输出；新增迁移文档 356 行。
- 影响：后续开发有了明确的执行顺序和验收标准；下一步应先按文档 Phase 1 修通真实 `llm_function_call` 成功路径，再迁 slot/runtime/action/checkpoint。
- 15:31： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮新增 graph runtime、runtime 测试并更新 AI 意图规划器文档。
- 修改：新增 `StewardGraphRuntime` ，用 LangGraph `StateGraph` 编排 `slot_prepare_context -> slot_tool_decision -> done/rule_fallback` ，把原 `StewardSlotDecisionAgent` 包成图节点；工具节点异常时会带 `langgraph_slot_decision` 失败 trace 进入规则兜底。
- 修改：`StewardGraphRuntime` 运行时图新增 `runtime_memory_context -> runtime_action_decision/runtime_tool_decision -> done/rule_fallback` ，先归一化并合并 `steward_state` ，已选流程确认走确定性 action 节点，不再调用模型；普通补字段/确认继续由 runtime tool 节点判断。
- 修改：`/steward/slot-decisions` 和 `/steward/runtime-decisions` 默认使用 `StewardGraphRuntime` ；如果 LangGraph 实例化或执行异常，端点 helper 会退回旧 `StewardSlotDecisionAgent` / `StewardRuntimeDecisionAgent` ，保证框架失效时仍能实际响应。
- 测试：先新增 `test_steward_graph_runtime.py` 红灯测试，覆盖槽位工具节点、图内规则兜底、运行时记忆合并、确定性行动选择，以及端点 helper 在 graph runtime 失败后 legacy 兜底；随后实现并跑绿。
- 文档：更新 `LANGGRAPH_RUNTIME_MIGRATION.md` 的当前状态和 Phase 2 完成项；更新 `CONCEPT.md` 的 LangGraph 节点命名；更新 `TODO.md` 勾掉 slot/runtime graph runtime 迁移，保留副作用 action node、checkpoint、人审中断和 trace 后续事项。
- 验证：容器内 `pytest -q server/tests/test_steward_graph_runtime.py server/tests/test_steward_graph_planner.py server/tests/test_steward_slot_decision_agent.py server/tests/test_steward_runtime_decision_agent.py server/tests/test_steward_planner.py server/tests/test_steward_intent_agent.py server/tests/test_runtime_chat_service.py server/tests/test_config_settings_reload.py` 通过 59/59； `ruff check --ignore E501 ...` 通过；`git diff --check` 无输出；`pip check` 无 broken requirements。
- 影响：会话内“识别缺什么、读记忆、判断补字段/继续/确认”的入口已经被 LangGraph 接管；当前仍没有让 LangGraph 直接执行保存草稿、提交审批、关联申请单等副作用动作。
- 15:53： `/steward/plans` 的基础业务动作规划补成服务端白名单 `action_steps` ，让申请、报销、保存草稿和直接提交都有明确动作序列。
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮新增 action contract、扩展 steward schema、更新前端 planner model、修复申请事由清洗并同步文档。
- 修改：`StewardTask` 和 `StewardPlanResponse` 增加 `action_steps` ；新增 `StewardActionStep` 、`StewardActionType` 、`StewardActionStatus` ，把可执行动作显式收进 Pydantic 协议。
- 修改：新增 `StewardActionPlanBuilder` ，由服务端确定性生成白名单动作：申请直接提交输出 `fill_application_fields -> build_application_preview -> validate_required_fields -> run_duplicate_precheck -> submit_application` ；保存草稿输出 `save_application_draft` ；报销输出 `fill_reimbursement_fields -> build_reimbursement_preview -> validate_required_fields -> create_reimbursement_draft` 。
- 修改：`StewardGraphPlannerService` 增加 `attach_action_steps` 节点，模型成功、模型失败兜底和 off-topic 都统一经过动作规划节点； `StewardPlannerService` 返回前也补同一套 action contract。
- 修改：`workbenchAiIntentPlannerModel.js` 优先消费服务端 `task.action_steps` ，旧响应才回退本地 `requested_action` 推导；这样后端 LangGraph 规划出的动作能真正驱动前端执行计划。
- 修改：`ApplicationFactResolver` 修复“交通火车”污染申请事由的问题，同时保留“高铁往返”这类业务描述；新增解析回归测试。
- 测试：先新增红灯测试，覆盖申请直接提交 action steps、保存草稿 action steps、报销 action steps、前端优先消费服务端 action steps、`交通火车` 事由清洗；随后实现并跑绿。
- 验证：容器内 `pytest -q server/tests/test_application_fact_resolver.py server/tests/test_steward_graph_runtime.py server/tests/test_steward_graph_planner.py server/tests/test_steward_slot_decision_agent.py server/tests/test_steward_runtime_decision_agent.py server/tests/test_steward_planner.py server/tests/test_steward_intent_agent.py server/tests/test_runtime_chat_service.py server/tests/test_config_settings_reload.py` 通过 66/66； `node --test web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs` 通过 12/12； `npm --prefix web run build` 通过；`ruff check --ignore E501 ...` 通过；`git diff --check` 无输出。
- 真实接口验证：重启 `x-financial-local-linux` 后回放 `2026-02-20 至 2026-02-23， ， ， ， ，真实 5173 `/api/v1/steward/plans` 返回 `requested_action=submit` ，字段为 `time_range=2026-02-20 至 2026-02-23` 、`location=上海` 、`reason=辅助国网仿生产服务器部署` 、`transport_mode=train` ，动作序列为 `detect_intent:completed -> fill_application_fields:planned -> build_application_preview:planned -> validate_required_fields:planned -> run_duplicate_precheck:planned -> submit_application:pending_confirmation` 。
- 影响：基础业务已经不是“只识别一个 requested_action”了， ； ，
- 16:13： ， `/steward/actions/execute` 入口处理。
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮新增 action executor、执行接口、前端执行服务和相关测试。
- 修改：新增 `StewardActionExecuteRequest` / `StewardActionExecuteResponse` ，并在 `steward.py` 暴露 `/steward/actions/execute` ；新增 `StewardActionExecutor` ，统一处理未知 action 拒绝、缺字段阻断、提交确认门禁、precheck 阻断和业务服务调用。
- 修改：`save_application_draft` / `submit_application` 复用现有 `UserAgentService` 申请保存/提交能力；`create_reimbursement_draft` 复用 `ExpenseClaimService.save_or_submit_from_ontology()` ，避免再写一套入库逻辑。
- 修改：`associate_attachments` 和 `link_existing_application` 保留在执行白名单里，但在真实接线完成前统一返回阻断，不允许以 noop 形式“假成功”或产生隐式副作用。
- 修改：前端 `steward.js` 新增 `executeStewardAction()` ； `stewardPlanModel.js` 保留服务端 `action_steps` ，并在 suggested action payload 中携带最终可执行 action step，
- 修改：`useWorkbenchAiActionRouter.js` 接入 `steward_execute_action` 点击执行；申请直接提交会先调用 `run_duplicate_precheck` ， `submit_application` ，执行结果回写到当前 AI 会话。
- 修改：`test_reimbursement_endpoints.py` 两个申请快路径断言从旧 `AP-` 前缀同步到当前短单号 `A...` 规范。
- 文档：更新 `LANGGRAPH_RUNTIME_MIGRATION.md` 、`TODO.md` 、`CONCEPT.md` ，标记第一版 action registry / executor 完成，并把 checkpoint、interrupt、关联申请和附件真实执行列为后续。
- 验证：容器内 `pytest -q server/tests/test_steward_action_executor.py` 通过 5/5； `pytest -q server/tests/test_application_fact_resolver.py server/tests/test_steward_action_executor.py server/tests/test_steward_graph_runtime.py server/tests/test_steward_graph_planner.py server/tests/test_steward_slot_decision_agent.py server/tests/test_steward_runtime_decision_agent.py server/tests/test_steward_planner.py server/tests/test_steward_intent_agent.py server/tests/test_runtime_chat_service.py server/tests/test_config_settings_reload.py` 通过 71/71。
- 验证：前端 `node --test web/tests/workbench-ai-action-router.test.mjs web/tests/steward-actions-service.test.mjs web/tests/steward-plan-message-copy.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs` 通过 21/21； `npm --prefix web run build` 通过；`ruff check --ignore E501 ...` 通过；`git diff --check` 无输出。
- 真实接口验证：重启 `x-financial-local-linux` 后，真实 5173 `/api/v1/steward/plans` 仍返回直接提交 action 链；`/api/v1/steward/actions/execute` 对未确认的 `submit_application` 返回 `needs_confirmation` ，没有执行入库副作用。
- 影响：基础业务链路已经具备“规划 action -> 执行器门禁 -> 复用现有业务服务”的后端闭环；下一步需要把 executor 包进 LangGraph checkpoint / interrupt，
- 16:40：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮新增 `StewardGraphActionRuntime` ，扩展 action executor 测试并更新 AI 意图规划器文档。
- 修改：新增 `StewardGraphActionRuntime` ，用 LangGraph `StateGraph` 编排 `action_checkpoint_load -> action_execute_node -> action_checkpoint_persist` ，并把 `/steward/actions/execute` 默认切到这个 graph runtime。
- 修改：复用 `AgentConversation.state_json` 持久化 `steward_action_checkpoint` ；同一 `conversation_id + client_trace_id` 的已完成 action 会直接重放终态结果，`needs_confirmation` 会保存 pending interrupt，
- 修改：`link_existing_application` 走报销草稿真实创建链路并写入申请关联风险标记；`associate_attachments` 接入 `AttachmentAssociationJobRunner` ，无 `receipt_ids` 时阻断，避免假成功。
- 修改：为 `complete_with_tool_call()` 补上主模型失败后 backup 返回 tool call 的回归测试，锁住“模型规划失败优先重试/切 backup，
- 文档：更新 `LANGGRAPH_RUNTIME_MIGRATION.md` 、`TODO.md` 、`CONCEPT.md` ，把 action node、checkpoint、pending interrupt、幂等重放、关联申请单和附件关联标为已完成，
- 验证：容器内 `pytest -q server/tests/test_steward_action_executor.py` 通过 9/9； `pytest -q server/tests/test_runtime_chat_service.py::test_runtime_chat_complete_with_tool_call_fails_over_to_backup_before_retrying_main` 通过 1/1。
- 验证：迁移集合 `pytest -q server/tests/test_application_fact_resolver.py server/tests/test_steward_action_executor.py server/tests/test_steward_graph_runtime.py server/tests/test_steward_graph_planner.py server/tests/test_steward_slot_decision_agent.py server/tests/test_steward_runtime_decision_agent.py server/tests/test_steward_planner.py server/tests/test_steward_intent_agent.py server/tests/test_runtime_chat_service.py server/tests/test_config_settings_reload.py` 通过 76/76； `pytest -q server/tests/test_attachment_association_jobs.py server/tests/test_linked_reimbursement_draft_jobs.py` 通过 7/7。
- 验证：前端 `node --test web/tests/workbench-ai-action-router.test.mjs web/tests/steward-actions-service.test.mjs web/tests/steward-plan-message-copy.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs` 通过 21/21； `ruff check --ignore E501 ...` 通过；`npm --prefix web run build` 通过；`git diff --check` 无输出。
- 真实接口验证：重启 `x-financial-local-linux` 后，真实 5173 `/steward/actions/execute` 对同一未确认 `submit_application` trace 第二次返回 `needs_confirmation` 且 `result_payload.idempotent_replay=true` ，证明 checkpoint 重放生效。
- 真实接口验证：真实 5173 `/steward/plans` 回放“2026-02-20 至 2026-02-23， ， ， ， `rule_fallback` ，动作链和字段可用，但 `planning_source=llm_function_call` 仍需修模型配置。
- 影响：
- 16:53：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只改 AI 模式前端等待反馈和对应测试/日志。
- 根因：`executeModelPlannedWorkbenchIntent()` 在等待 `/steward/plans` 返回前只设置 `sending=true` ，没有先激活对话、清空输入框、展示用户气泡或 pending 卡片；真实 MiniMax 三次超时会让用户看到 30 多秒“无响应”。
- 修改：`usePersonalWorkbenchAiMode.js` 新增 `startModelPlanningConversation()` ，进入模型规划前立即推入用户消息和“正在识别意图，准备拆解申请、报销和附件任务。”的 pending 卡片，并持久化到最近对话。
- 修改：`startModelPlannedApplicationPreview()` 把规划 pending 的 `pendingMessageId` 传给申请预览；`useWorkbenchAiApplicationPreviewFlow.js` 支持复用这张 pending 卡片，避免重复用户消息和重复等待卡。
- 测试：先新增 `workbench AI mode shows a visible planning response before waiting for steward model plan` 红灯测试，确认当前缺少即时反馈；实现后同文件 9/9 通过。
- 验证：前端相关集合 `node --test web/tests/workbench-ai-action-router.test.mjs web/tests/steward-actions-service.test.mjs web/tests/steward-plan-message-copy.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs web/tests/workbench-ai-composer-components.test.mjs` 通过 31/31； `npm --prefix web run build` 通过；`git diff --check` 无输出。
- 真页验证：使用本地 5173 和本地模拟员工账号登录 AI 模式， ， ， ， ， ； `AZ8QSX9QA` 。
- 影响：用户按回车后不再空等模型规划，长耗时仍存在但前端会立即反馈“已接收并正在规划”；真实 `llm_function_call` 成功路径仍依赖模型配置修复。
- 16:59：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只继续修改 AI 模式前端消息复用、思考事件合并和对应测试。
- 根因： `requestInlineAssistantReply()` 又新建第二张助手卡片；所以用户输入“你好”时会看到两段会话。
- 修改：`usePersonalWorkbenchAiMode.js` 删除中间态独立回复，普通管家回复也把 `pendingMessageId` 传给 `requestInlineAssistantReply()` ，让同一轮输入继续复用规划 pending 卡片。
- 修改：`useWorkbenchAiStewardFlow.js` 支持 `requestInlineAssistantReply(prompt, entry, files, options)` ，当传入 `pendingMessageId` 时替换原 pending 卡片而不是追加新消息；新增 `mergeInlineThinkingEvents()` 合并模型规划和管家回复思考事件，避免同一事件重复或丢失。
- 测试：先新增红灯测试 `workbench AI mode reuses planning pending message for regular steward replies` ，确认普通回复必须复用规划 pending；
- 验证：前端集合 `node --test web/tests/workbench-ai-action-router.test.mjs web/tests/steward-actions-service.test.mjs web/tests/steward-plan-message-copy.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs web/tests/workbench-ai-composer-components.test.mjs` 通过 32/32； `npm --prefix web run build` 通过；`git diff --check` 无输出。
- 真页验证：本地 5173 AI 模式输入“你好”后， `assistantCardCount=1` 、`pendingCards=0` 、思考区标题为“小财业务思考5 条”，截图保存为 `/tmp/x-financial-ai-single-message-hello.png` 。
- 影响：一次用户输入现在对应一条助手消息；意图识别、规划等待、普通回复整理都会落在同一个思考区域，不再把“已完成意图识别”单独展示成一轮会话。
- 17:26：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有多项既有未提交改动，本轮只继续修改 AI 模式前端 thinking 事件、流式规划接线和对应测试。
- 根因：`executeModelPlannedWorkbenchIntent()` 虽然会先创建 pending 卡片，但 `resolveInlineExecutionPlan()` 仍走非流式 `/steward/plans` ，模型等待期间只有一条静态 thinking； ，
- 修改：新增 `workbenchAiPlanningThinkingModel.js` ，集中维护可复用的 thinking 事件合并、完成态转换、初始意图判断和阶段性进度计划，避免继续把主 composable 写大。
- 修改：`usePersonalWorkbenchAiMode.js` 在模型规划 pending 卡片上启动可取消的阶段性进度：判断办理意图、抽取关键信息、规划执行步骤、匹配业务工具、准备兜底策略；模型返回或进入 fallback 后会清理定时器。
- 修改：`useWorkbenchAiStewardFlow.js` 支持 `resolveInlineExecutionPlan(prompt, entry, files, { pendingMessageId })` ；传入 pending id 时改走 `/steward/plans/stream` ，只把服务端 thinking 实时写回当前卡片，不把 answer delta 提前塞进规划消息。
- 修改：`useWorkbenchAiApplicationPreviewFlow.js` 生成申请核对表时保留并完成前置规划 thinking，
- 测试：新增 `workbench AI mode streams planning thinking into the pending message` ，锁定阶段性 thinking、可取消定时器、流式规划接线和申请预览 thinking 合并；同文件 11/11 通过。
- 验证：相关前端集合 `node --test web/tests/workbench-ai-action-router.test.mjs web/tests/steward-actions-service.test.mjs web/tests/steward-plan-message-copy.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs web/tests/workbench-ai-composer-components.test.mjs` 通过 33/33； `npm --prefix web run build` 通过；`git diff --check` 无输出。
- 真页验证：本地 5173 干净会话输入“2026-02-20 至 2026-02-23， ， ， ， ， `AZ4A98BSF` ，截图保存为 `/tmp/x-financial-ai-progressive-thinking.png` 。
- 验证补充：我额外跑了 `workbench-ai-mode-switch.test.mjs` ，该文件仍有 2 个既有静态断言失败，断言点还停在旧的内联附件卡片和旧的 `selectedFiles` watch 结构；本轮相关测试和真页回放不受影响。
- 影响：用户现在不再只看到静态“思考中”，而是能在同一张思考卡片里持续看到业务意图、槽位、动作链和兜底策略的推进过程；服务端流式 thinking 到达后也会合并进同一个列表。
- 17:40：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有大量既有未提交改动，本轮只补 AI 工作台申请上下文提交识别、申请预览执行分支和对应测试。
- 根因：`resolveInlineApplicationPreviewTextAction()` 只识别“提交 / 确认提交 / 直接提交”等精确词，用户输入“提交这个单据”会绕过当前申请核对表上下文，继续进入 `shouldRequestWorkbenchAiIntentPlan()` 和小财管家规划，导致再次识别意图并等待模型。
- 修改：`workbenchAiApplicationGateModel.js` 把“提交这个单据 / 提交这个申请单 / 提交当前单据 / 提交刚才的草稿”等上下文指代短句映射为 `AI_APPLICATION_ACTION_SUBMIT` ；同类保存指代短句也映射到保存草稿动作。
- 修改：`useWorkbenchAiApplicationPreviewFlow.js` 在提交动作里新增“已保存草稿 + 上下文提交短句”快路径；当最近申请核对表已有 `draftPayload.claim_id` 或单号，且用户明确说提交当前/刚才的单据时，跳过二次确认弹窗，直接执行提交前核查和 `/reimbursements/application-preview-action` ，并带上 `application_edit_claim_id` 复用原草稿。
- 测试：先新增 `workbench-ai-application-context-submit.test.mjs` 红灯测试，复现“已有草稿 + 提交这个单据”只打开确认弹窗、不调用提交接口；实现后该测试通过，并确认 payload 写入 `application_edit_claim_id=claim-saved-draft` 。
- 验证：`node --test web/tests/workbench-ai-application-context-submit.test.mjs` 通过；`node --test web/tests/workbench-ai-application-gate-model.test.mjs` 通过；相邻 `workbench-ai-action-router.test.mjs` 、`workbench-ai-intent-planner-model.test.mjs` 、`ai-application-preview-actions.test.mjs` 均通过；本轮改动文件 `git diff --check -- ...` 无输出。
- 验证补充：`workbench-ai-mode-expense-scene-action.test.mjs` 和 `expense-application-fast-preview.test.mjs` 仍有既有静态断言失败，主要还在扫描旧 `PersonalWorkbenchAiMode.vue` 或过窄源码片段；新增的上下文提交行为测试已覆盖真实执行路径。
- 影响： ， ， ， ， ， ， ，
- 17:48： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有大量既有未提交改动，本轮只继续修改 `workbenchAiIntentPlannerModel.js` 和对应意图规划测试。
- 根因：后端已经返回 `pending_flow_confirmation` ，且候选流只有 `travel_application / 先发起出差申请` ，但前端 `normalizeWorkbenchAiIntentPlan()` 只识别 `tasks` ，没有把这个唯一候选流转成可执行申请计划，最后又回到普通 steward 回复路径。
- 修改：`workbenchAiIntentPlannerModel.js` 增加 pending flow 候选解析；当 `pending_flow_confirmation.status=pending` 且唯一候选为“先发起出差申请”时，直接生成 `create_travel_application` 计划，包含 `build_application_preview` 、必填校验、模型抽取的时间/地点/事由/交通方式。
- 测试：先新增红灯用例 `workbench AI intent planner turns single application candidate flow into executable preview payload` ，复现该计划原本返回 `null` ；实现后同文件 12/12 通过。
- 验证：`node --test web/tests/workbench-ai-intent-planner-model.test.mjs` 、`node --test web/tests/workbench-ai-application-gate-model.test.mjs` 、`node --test web/tests/workbench-ai-application-context-submit.test.mjs` 、`node --test web/tests/steward-plan-model-pending-flow.test.mjs` 均通过；`git diff --check -- web/src/composables/workbenchAiMode/workbenchAiIntentPlannerModel.js web/tests/workbench-ai-intent-planner-model.test.mjs` 无输出。
- 影响： ， ， ， ， ， ，
2026-06-24 22:59:10 +08:00
- 22:04：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；本轮修改集中在 AI 工作台命令意图、待审单据查询识别和对应前端测试。
- 根因：工作台输入链路目前优先进入模型规划，但前端本地可执行意图只覆盖申请预览、报销和单据查询的较完整问法；“我要审核”没有命中 `resolveAiDocumentQueryIntent()` 的待审查询触发词，“删除草稿”则没有上下文命令入口，容易退回普通 steward 规划或被当作报销填槽文本。
- 修改：新增 `workbenchAiCommandIntentModel.js` 和 `useWorkbenchAiCommandIntents.js` ，把“删除草稿 / 删除这个申请单 / 把刚才保存的草稿删掉”等短句识别为上下文命令；命中最近草稿时只给“查看草稿详情”动作，要求用户在详情页二次确认删除，不直接执行破坏性删除。
- 修改：`usePersonalWorkbenchAiMode.js` 接入命令意图 composable， ； ，
- 修改：`aiDocumentQueryIntent.js` 扩展“我要审核 / 我要审批 / 待办审批 / 去审核 / 处理审批”等短句到待我审核单据查询，同时排除“审批规则怎么走”这类政策咨询，避免误打到单据列表。
- 测试：先补红灯测试复现缺口；实现后 `node --test web/tests/workbench-ai-command-intent-model.test.mjs web/tests/ai-document-query-model.test.mjs` 通过 19/19； `workbench-ai-action-router.test.mjs` 和 `workbench-ai-intent-planner-model.test.mjs` 通过；`npm --prefix web run build` 通过；`git diff --check -- ...` 无输出。
- 真页烟测：当前 `x-financial-local-linux` 正在监听 5173， `curl -I http://127.0.0.1:5173/app/workbench` 返回 200，
- 影响：用户在 AI 工作台直接输入“删除草稿”时，会被引导到最近草稿详情并保留删除确认边界；输入“我要审核”或“待办审批”时，会直接查询待我审核单据，不再表现为没识别到意图。
- 22:31：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；本轮在 22:04 短句修复基础上继续新增 Markdown 方案、统一意图框架、动作策略、筛选能力和前端测试。
- 文档：新增 `2026-06-24-workbench-intent-frame-design.md` ，明确 `IntentFrame Parser -> Target Resolver -> Action Policy -> 业务 flow` 的总体方案；用户确认只需要 `.md` 后，我清理了临时 DOCX 产物，只保留 Markdown 文档。
- 修改：新增 `workbenchIntentFrameModel.js` ，把输入统一解析为 `action / objectType / filters / targetMode / safetyLevel / normalizedQuery` ；覆盖“删除刚才那个草稿”“删除 3 天前的草稿”“审核合规没有风险的申请”和“审批规则怎么走”。
- 修改：新增 `workbenchIntentActionPolicy.js` ，把删除、审核、驳回固定为 `confirm_required` ；当前上下文目标只打开详情确认，筛选型目标只查询候选，不通过自然语言直接执行副作用。
- 修改：`useWorkbenchAiCommandIntents.js` 先走统一 Intent Frame， ；
- 修改：`aiDocumentQueryIntent.js` 和 `aiDocumentQueryModel.js` 增加“3 天前”相对日期、无风险/高/中/低风险筛选、`我的草稿单据` 查询来源识别和风险摘要展示；“审批规则怎么走”仍保持规则咨询，不进入单据查询。
- 测试：先补红灯测试复现缺口；实现后 `node --test web/tests/workbench-intent-frame-model.test.mjs` 通过 4/4， `node --test web/tests/ai-document-query-model.test.mjs` 通过 16/16； `workbench-ai-command-intent-model.test.mjs` 、`workbench-ai-action-router.test.mjs` 、`workbench-ai-intent-planner-model.test.mjs` 均通过。
- 验证：`npm --prefix web run build` 通过，保留既有 Rollup pure 注释与 chunk size warning； `git diff --check -- ...` 无输出；`curl -I http://127.0.0.1:5173/app/workbench` 返回 200。
- 影响：后续“删除 3 天前的草稿”会先转成“我的 3天前 草稿单据”候选查询；“审核合规没有风险的申请”会先转成“待我审核 无风险 申请单”候选查询；“刚才那个草稿”仍可在当前会话内定位最近草稿，但只给详情确认入口。
- 22:36： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；本轮继续修改统一 Intent Frame 查询句、单据查询 thinking 和对应回归测试。
- 根因：`resolveWorkbenchIntentFrame()` 能解析出 `action=delete` ，但 `normalizedQuery` 被压成“我的草稿单据”，丢了“申请单”筛选；同时 `handleAiDocumentQueryIntent()` 只接收查询句，不接收原始 `commandFrame` ，导致 thinking 只展示“解析筛选条件”，没有展示“删除是高风险动作，不会直接执行，会先筛选候选”。
- 修改：`workbenchIntentFrameModel.js` 保留“草稿 + 申请单”的组合筛选，`删除申请单草稿` 现在生成 `我的 草稿 申请单` ，避免查询阶段退化成全部草稿。
- 修改：`aiDocumentQueryModel.js` 新增 `buildAiDocumentQueryThinkingEvents()` ，当传入 `commandFrame` 且 `safetyLevel=confirm_required` 时，首个 thinking 事件固定为“识别高风险操作意图”，文案明确删除/审核不会直接执行，会先筛选候选。
- 修改：`useWorkbenchAiDocumentQueryFlow.js` 支持第三个参数 `{ commandFrame }` ， `useWorkbenchAiCommandIntents.js` 在候选查询时传入统一意图帧，让查询 thinking 保留原始动作语义。
- 测试：新增回归覆盖 `删除申请单草稿` ，断言查询句保留 `申请单` 与 `草稿` ，且 thinking 首条包含“删除 / 不会直接执行 / 先筛选候选”；相关 `workbench-intent-frame-model.test.mjs` 6/6 通过。
- 验证：`node --test web/tests/workbench-intent-frame-model.test.mjs web/tests/workbench-ai-command-intent-model.test.mjs web/tests/ai-document-query-model.test.mjs` 通过 27/27； `workbench-ai-action-router.test.mjs` 和 `workbench-ai-intent-planner-model.test.mjs` 通过 17/17； `npm --prefix web run build` 通过；`git diff --check -- ...` 无输出；
- 影响：用户输入“删除申请单草稿”时，不会只看到普通查询筛选；系统会先展示删除动作的高风险策略思考，再查询“我的草稿申请单”候选，并保留详情页二次确认边界。
- 22:42： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；本轮继续修改 `aiDocumentQueryModel.js` 、查询 flow 和统一意图回归测试。
- 根因：
- 修改：`buildAiDocumentQueryMessage()` 支持 `commandFrame` ，当命令为删除/审核/驳回等 `confirm_required` 动作时，在候选卡片上方插入高风险操作提示：系统不会直接删除/审核相关单据，需点击下方候选单据里的快捷按钮并进入详情核对后再操作。
- 修改：候选单据卡片的操作按钮会随命令动作改文案：删除为“进入详情确认删除”，审核为“进入详情确认审核”，驳回为“进入详情确认驳回”；普通查询仍保持“查看详情”。
- 修改：`useWorkbenchAiDocumentQueryFlow.js` 在生成最终查询消息时传入 `commandFrame` ，保证真实工作台路径能展示同一套提示和按钮文案。
- 测试：新增回归断言 `删除申请单草稿` 的结果消息包含“系统不会直接删除相关单据 / 请点击下方候选单据里的快捷按钮 / 进入单据详情核对后再操作”，并出现 `进入详情确认删除` 按钮文案。
- 验证：`node --test web/tests/workbench-intent-frame-model.test.mjs web/tests/workbench-ai-command-intent-model.test.mjs web/tests/ai-document-query-model.test.mjs` 通过 28/28； `workbench-ai-action-router.test.mjs` 和 `workbench-ai-intent-planner-model.test.mjs` 通过 17/17； `npm --prefix web run build` 通过；`git diff --check -- ...` 无输出；
- 影响：用户输入“删除申请单草稿”后，既能在 thinking 里看到删除动作识别，也能在最终结果卡片里看到删除确认边界和实体快捷入口，不会误以为系统已经直接删除或只能普通查看。
- 22:49：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍是本轮 AI 工作台意图识别和结果渲染相关未提交改动。
- 根因：高风险提示块里使用了 `<p>` 标签，但 `conversationTrustedHtml` 的 trusted HTML 白名单不允许 `<p>` ；安全渲染会把包含该标签的整段 trusted HTML 丢弃，所以页面只保留 Markdown 标题，看起来像没有继续删除思考。
- 修改：`aiDocumentQueryModel.js` 将高风险提示正文改为白名单已允许的 `<div>` ，不扩大 trusted HTML 标签面；`personal-workbench-ai-mode.css` 增加提示块样式，让“系统不会直接删除相关单据”和后续详情确认说明稳定显示在候选卡片上方。
- 测试：先新增渲染级红灯测试复现截图，确认渲染后只剩标题；修复后该测试断言 `ai-document-command-guidance` 、`系统不会直接删除相关单据` 、`进入详情确认删除` 和 `ai-document-card-list` 都保留在最终 HTML 中。
- 验证：`node --test web/tests/ai-document-query-model.test.mjs` 通过 17/17； `node --test web/tests/ai-document-query-model.test.mjs web/tests/workbench-intent-frame-model.test.mjs web/tests/workbench-ai-command-intent-model.test.mjs web/tests/workbench-ai-action-router.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs` 通过 46/46； `npm --prefix web run build` 通过；`git diff --check -- ...` 无输出；`curl -I http://127.0.0.1:5173/app/workbench` 返回 200。
- 影响：用户输入“删除申请单草稿”后，结果标题下方会恢复高风险说明、候选单据卡片和“进入详情确认删除”快捷按钮；系统仍不会直接删除单据，而是要求进入详情核对后再操作。
2026-06-25 10:56:00 +08:00
- 23:02：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；当前工作区还有一个非本轮修改的规则 Excel 文件变更，本轮只修改 AI 工作台点击防护。
- 根因：历史会话里保存的是静态详情链接，用户删除单据后再重进会话点击，原逻辑会直接 `emit('open-document')` 跳详情页，没有先确认单据是否仍存在；如果后端返回 404，
- 修改：`usePersonalWorkbenchAiMode.js` 将详情链接点击处理改为异步校验；对带 `claim_id` 的 AI 历史详情入口先调用 `fetchExpenseClaimDetail()` ，当返回 not found / 不存在 / 已删除 / 不可访问 / 无权时，不再跳转详情。
- 修改：失效时调用既有 `markAiWorkbenchConversationDocumentDeleted()` 把当前会话里的 `#ai-open-document-detail` 写回 `#ai-deleted-document-detail` ，刷新历史列表，并 toast 提示“该单据已经删除或不可访问，已将这条历史入口标记为不可查看。”
- 验证：`node --test --test-name-pattern "deleted document|validates document detail" web/tests/ai-conversation-html-renderer.test.mjs web/tests/assistant-session-draft-delete.test.mjs` 通过 3/3； `node --test web/tests/ai-document-query-model.test.mjs web/tests/workbench-intent-frame-model.test.mjs web/tests/workbench-ai-command-intent-model.test.mjs web/tests/workbench-ai-action-router.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs` 通过 46/46； `npm --prefix web run build` 通过；`git diff --check -- ...` 无输出；
- 影响：用户重新进入历史会话后，如果之前的候选单据已被删除，再点旧快捷入口会在会话内变成“单据已删除/不可查看”，不会进入坏详情页；后端临时网络错误则不会错误失效化链接，会继续按原流程跳转。
- 23:10：
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有一个非本轮修改的通讯费规则 Excel 变更，本轮没有触碰该文件。
- 根因：`resolveExecutableTravelApplicationPlan()` 原来把包含 `submit_application` step 的计划直接映射为 `autoSubmit: true` ； `startAiApplicationPreview()` 又在核对表 ready 时用 `confirmed: true` 调用提交动作，等于把“用户说直接提交”误当成“已核对并确认提交”。
- 修改：`workbenchAiApplicationGateModel.js` 保留 `requestedSubmit` 语义，但不再给紧凑差旅申请返回 `autoSubmit: true` ； `workbenchAiIntentPlannerModel.js` 仍识别 `requestedAction=submit` 和提交步骤，但 executable payload 固定 `autoSubmit: false` ，并输出 `requestedSubmit` / `submitRequiresConfirmation` 。
- 修改：`usePersonalWorkbenchAiMode.js` 将确认标志传入申请预览流；`useWorkbenchAiApplicationPreviewFlow.js` 删除预览生成后的自动 `confirmed: true` 提交分支，改为在核对表 footer 提醒“系统不会自动提交申请，请先核对申请核对表”；`workbenchAiMessageModel.js` 持久化这两个确认标志，避免刷新或重进会话后提示丢失。
- 修改：同步更新 `AI意图规划器` 相关文档，把“直接提交自动走完整链路”改成“先展示核对表，用户确认后进入提交链路”。
- 验证：先用改过的测试跑出红灯；修复后 `node --test --test-name-pattern "direct-submit|direct submit|requires confirmation|confirmation metadata|intent planner|application gate" ...` 通过 14/14； `node --test web/tests/workbench-ai-application-gate-model.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs web/tests/ai-document-query-model.test.mjs web/tests/workbench-intent-frame-model.test.mjs web/tests/workbench-ai-command-intent-model.test.mjs web/tests/workbench-ai-action-router.test.mjs` 通过 51/51； `node --test --test-name-pattern "direct-submit|direct submit|direct-submit command" web/tests/expense-application-fast-preview.test.mjs` 通过 2/2； `npm --prefix web run build` 通过；`git diff --check` 无输出；`curl -I --max-time 5 http://127.0.0.1:5173/app/workbench` 返回 200。
- 影响： ， ， ， ， ， ，
- 23:22： ，
- Git 提交检查：`git fetch --all --prune` 成功；当前 upstream 为 `origin/main` ， `HEAD..@{u}` 与 `@{u}..HEAD` 均未输出新提交；工作区仍有一个非本轮修改的通讯费规则 Excel 变更，本轮没有触碰该文件。
- 修改：`workbenchIntentFrameModel.js` 新增 `riskLevel` 、`requiresCandidateSearch` 、`requiresSelection` 、`requiresConfirmation` 、`executionMode` 、`policyDecision` ，让删除、审核、驳回等高风险动作稳定落到候选筛选或确认，而不是从规则里直接推执行。
- 修改：`workbenchIntentActionPolicy.js` 改为优先消费 `policyDecision` ，并把 `riskLevel` 、`requiresSelection` 、`requiresConfirmation` 透传到 route，
- 修改：调整 `resolveAction()` 顺序，让“查 3 天前的申请单”先命中查询动词，不再被裸 `申请` 误判为创建申请；这也是本轮红灯测试暴露出的规则误伤点。
- 文档：`AI意图规划器/CONCEPT.md` 新增“规则兜底边界”，明确规则只输出安全策略，不拥有副作用授权；同时把第一阶段落地里的自动提交旧描述改为等待核对和二次确认。
- 测试：先给 `workbench-intent-frame-model.test.mjs` 增加红灯断言，覆盖上下文删除、筛选删除、无风险审核、政策咨询和只读查询的策略字段；修复后该文件通过 8/8。
- 验证：`node --test web/tests/workbench-intent-frame-model.test.mjs web/tests/ai-document-query-model.test.mjs web/tests/workbench-ai-command-intent-model.test.mjs web/tests/workbench-ai-action-router.test.mjs web/tests/workbench-ai-application-gate-model.test.mjs web/tests/workbench-ai-intent-planner-model.test.mjs` 通过 52/52； `npm --prefix web run build` 通过；`git diff --check` 无输出；`curl -I --max-time 5 http://127.0.0.1:5173/app/workbench` 返回 200。
- 影响：后续规则层更像 guardrail， ； ，
2026-06-24 10:42:57 +08:00
## 遗留问题
2026-06-25 10:56:00 +08:00
- 23:22： `/steward/plans` 或 runtime decision 输出同名字段，再由前端只做展示和兜底。
- 23:10：
- 23:10： `expense-application-fast-preview.test.mjs` 整文件仍有 13 个既有旧静态断言失败，失败点包括旧 assistantName 断言、旧申请 session 静态结构、表格样式和已拆分 composable 的旧代码片段匹配；本轮只验证了 direct-submit 相关子集通过。建议后续单独清理该测试文件，避免继续掩盖真实回归。
- 23:02：
2026-06-24 22:59:10 +08:00
- 22:49：
- 22:42：
- 22:36：
- 22:31：
- 22:04：
2026-06-24 10:42:57 +08:00
- 09:41： `.codex/skills` 目录里，本轮可以通过文件检查验证结构，但是否被未来会话自动加载还依赖 Codex 对项目 Skill 的刷新机制。建议后续新开会话或下一次任务时确认 Skill 列表是否出现 `agent-change-log` 。
- 09:43： `.codex/` 曾被 `.gitignore` 整体忽略，新建的 `agent-change-log` 默认不会进入普通提交范围； ， ， `.codex` 。
- 10:01： ， `main` ahead 1。建议后续如果真的发现 upstream 新提交，先用 fetch 和 `HEAD..@{u}` 写日志；只有在工作区干净、可快进时再执行 `git pull --ff-only` ，避免把其他智能体提交和本地半成品混到一起。
- 10:02： `HEAD..@{u}` 和 `@{u}..HEAD` 两个方向。
- 10:21： ： ：
- 10:21： `.git/hooks` ，所以 post-commit hook 模板已经入库，但尚未安装到本 checkout。建议在有 `.git` 写权限的环境执行 `tools/agent-change-log/install_post_commit_hook.sh` 。
2026-06-24 12:36:03 +08:00
- 10:24： ， `mupdf-tools` 。建议在 Docker 权限恢复后重建/重启 `local-x-financial-linux` ，执行定向 OCR 测试，并在 5173 用真实 PDF 票据确认预览图和 OCR 字段都保留中文。
2026-06-24 10:42:57 +08:00
- 10:28： ， ，
- 10:32： ， ， `pdf-image-ocr:` 。
- 10:40：
2026-06-24 12:36:03 +08:00
- 11:06：
2026-06-24 10:42:57 +08:00
- 10:41： ， ， `resolve_preview` 或重识别来补 `preview.png` 。
2026-06-24 12:36:03 +08:00
- 10:56： ， `server/tests/test_system_cache_endpoints.py` ，并在 5173 系统设置页实际点击一次“一键清理缓存”确认接口返回明细。
- 10:57： `local-x-financial-linux` 或当前 compose main 服务，确认 `mutool` / `pdftoppm` 可用后重新打开票据预览。
- 11:09： `POST /api/v1/settings/cache/clear` 的 404 已确认来自运行中 FastAPI 未加载新路由；当前沙箱不能通过 Docker socket 或 SSH 进入容器重启。建议在有 Docker 权限的终端重启/重建 `local-x-financial-linux` ，然后检查 `/api/v1/openapi.json` 是否包含 `/api/v1/settings/cache/clear` 。
- 11:15：
- 11:20： ， `local-x-financial-linux` 或运行容器内 pytest。建议在有 Docker 权限的终端重启/重建该容器，再重新点击“一键清理缓存”确认不再 404。
- 11:39： ， `server/tests/test_attachment_association_jobs.py` 新增两条测试，并在 5173 重新打开刚才那张坏票据验证自动修复是否生效。
- 11:55： `x-financial-local-linux` ，且容器内 `poppler-data` 未安装、`mutool` 不存在；本轮文本层兜底已恢复 OCR 字段，但 PDF 图片预览仍会带转图失败 warning。12:04 已在当前运行容器补齐依赖并刷新本批票据预览；建议后续仍按最新 compose 统一到 `local-x-financial-linux` ，避免旧容器继续抢占 5173。
- 12:23： ， ， ，
2026-06-24 21:59:15 +08:00
- 13:03： `expense-application-fast-preview.test.mjs` 整文件仍有 12 个既有失败，失败点包括 unsupported business guidance 文案、旧申请 session 静态结构、typewriter/table 静态断言等；本次新增的直提申请用例已通过。建议后续单独清理这些陈旧断言，避免掩盖真正的申请链路回归。
- 13:20： ， `/steward/plans` 返回 `llm_function_call` 的端到端路径。建议后续用真实模型配置测试一次“去上海出差...直接提交”，确认模型返回任务计划后前端进入申请核对表。
- 13:35：
- 13:58： ， `/steward/plans` 的网络返回是否包含新的 `requested_action` 。建议后续打开浏览器 DevTools 或后端日志，用真实模型配置回放一次保存草稿话术。
- 14:33： ， `rule_fallback` 。建议下一步先修复模型连通性或配置可用 backup， `planning_source=llm_function_call` 的成功路径。
- 14:33： ，
- 15:14： `/steward/plans` 的规划编排骨架，还没有把 slot decision、runtime decision、草稿保存/提交 action 和跨轮 checkpoint 迁入 graph。建议下一步按节点边界继续拆迁，
- 15:14： `langgraph` 依赖把 `websockets` 锁到 15.0.1；当前 `pip check` 和 steward 相关测试通过，但如果后续实时流或 WebSocket 功能异常，需要优先核对这个依赖变化。
- 15:22： ， `LANGGRAPH_RUNTIME_MIGRATION.md` 从模型成功路径开始推进，不要跳过文档直接扩写 graph node。
- 15:31： `StewardGraphRuntime` 已覆盖 slot/runtime decision， ， `steward_action_nodes.py` / action contract，
- 15:53： ， ； `save_application_draft` 、`submit_application` 、`create_reimbursement_draft` 仍需要下一步接到现有业务服务并补幂等、确认来源和 trace。建议下一步先做 action registry，
- 16:13： ，
- 16:13： `link_existing_application` 和 `associate_attachments` 已进入执行白名单并在未接线时阻断，但真实执行还没有统一接入 action executor。16:40 已接入真实执行和回归测试，后续仍需在真页补充可视化恢复/继续动作。
- 16:40： `/steward/plans` 仍未跑到 `planning_source=llm_function_call` ，当前阻塞点是 backup skipped、MiniMax 三次失败；代码层 backup tool-call 成功路径已有测试，但环境层还要修模型配置或连通性。
- 16:40： ，
- 16:53： `usePersonalWorkbenchAiMode.js` 当前已超过 800 行，后续继续加 AI 模式功能前建议拆出模型规划等待态、普通对话启动和申请预览桥接 composable，
- 16:59： ； `llm_function_call` 成功路径，再拆分 AI 模式前端运行时文件。
- 17:26： `workbench-ai-mode-switch.test.mjs` 仍有 2 个旧静态断言失败，分别断言附件卡片还在主模板内联、`selectedFiles` watch 还在主 AI 模式文件里；当前真实代码已经拆成组件/composable。建议后续单独整理这个老测试文件，
- 17:40： `workbench-ai-mode-expense-scene-action.test.mjs` 和 `expense-application-fast-preview.test.mjs` 仍有多条旧静态断言失败，失败点主要是代码已拆到 composable 后测试还读取旧 Vue 单文件或固定片段。建议后续把这些静态断言改成导入 composable/model 的行为测试，避免真实功能修复被旧结构误报淹没。
- 17:48： ， ， ， ， ，
2026-06-24 10:42:57 +08:00
## TODO
- [x] ~~检查 `agent-change-log` 的 frontmatter、触发描述和日志模板是否完整。~~ （完成于 09:42， ： `rg` 命中 frontmatter、日志路径和三段式标题； `git diff --check` 无输出）
- [x] ~~将 `AGENTS.md` 接入“每次修改后调用日志 Skill”的项目级规则。~~ （完成于 09:42， ： `AGENTS.md` 已新增 `变更日志 Skill 规范` ）
- [x] ~~如果需要把 `agent-change-log` 随仓库提交，确认是调整 `.gitignore` 放行还是用强制添加方式纳入版本管理。~~ （完成于 09:44， ： `.gitignore` 已只放行 `.codex/skills/agent-change-log/**` ）
- [x] ~~把 Git 拉取检查和其他智能体 upstream 提交分析纳入 `agent-change-log`。~~ （完成于 10:01， ： `Required Git Check` ， `AGENTS.md` 已要求日志前运行 `git fetch --all --prune` 和 `git log HEAD..@{u}` ）
- [x] ~~把本地 ahead 提交也纳入 `agent-change-log` 的提交分析范围。~~ （完成于 10:02， ： `AGENTS.md` 已新增 `git log @{u}..HEAD` ，并记录 `9321260` 本地 ahead 提交）
- [x] ~~补上提交后自动写日志的可执行脚本和 hook 模板。~~ （完成于 10:21， ： `update_change_log.py` dry-run 与真实写入成功，`.githooks/post-commit` 已新增）
- [ ] 在有 `.git` 写权限的环境执行 `tools/agent-change-log/install_post_commit_hook.sh` ， （ ：
- [ ] 在后续每次 bugfix、新功能、重构或配置/文档修改后，调用 `agent-change-log` 并增量更新当天日志。（ ：
2026-06-24 12:36:03 +08:00
- [ ] 重建/重启 `local-x-financial-linux` ，确认容器内存在 `mutool` ，并执行 OCR 定向 pytest。（ ：
2026-06-24 10:42:57 +08:00
- [ ] 在 5173 真页重新上传/预览火车票 PDF， ， （ ：
- [ ] 重新上传 10:06 同款 PDF 或触发该票据重识别，确认新的 `meta.json` 写入 `preview_kind=image` 和 `preview_media_type=image/png` 。（ ：
- [ ] 后端加载缓存版本修复后，重新上传同一 PDF， `ocr_line_count` 和 PNG 预览都来自新转图流程。（ ：
- [ ] 在有浏览器自动化能力的环境回放 AI 工作台附件预览弹窗， （ ：
2026-06-24 12:36:03 +08:00
- [ ] 在真实浏览器回看系统设置 / 缓存管理页，确认 4 类缓存范围清单、维护操作条和错误反馈在当前主题下没有拥挤或错位。（ ：
2026-06-24 10:42:57 +08:00
- [ ] Docker 权限恢复后运行票据夹 PDF 预览定向测试，并刷新已有 `preview_kind=pdf` 的旧票据 meta。（ ：
2026-06-24 12:36:03 +08:00
- [ ] Docker 权限恢复后运行 `server/tests/test_system_cache_endpoints.py` ，确认 `/api/v1/settings/cache/clear` 在容器内清理 OCR 缓存并拒绝非管理员。（ ：
- [ ] 在 5173 系统设置页点击“一键清理缓存”，确认按钮 loading、toast 和清理明细符合预期。（ ：
- [ ] 重启/重建运行中的后端容器后，重新打开 `25be8906-d3c8-4236-934d-e769ee19d3a7` 这类旧 PDF 票据详情，确认预览接口能生成 `preview.png` ，且前端根据 `image/png` blob 切到图片预览。（ ：
- [ ] 重启/重建 `local-x-financial-linux` 后重新点击“一键清理缓存”，确认 `server/logs/app.log` 不再出现 `POST /api/v1/settings/cache/clear 404` ， （ ：
- [ ] 重启/重建 `local-x-financial-linux` 后确认 `SERVER_RELOAD=true` 已生效，再修改一个后端入口文件验证日志出现新的 `Starting X-Financial` 。（ ：
- [ ] Docker 权限恢复后运行 `server/tests/test_attachment_association_jobs.py::test_attachment_association_keeps_receipt_folder_preview_and_fields_after_cache_clear` 和 `server/tests/test_attachment_association_jobs.py::test_attachment_meta_repairs_existing_pdf_fallback_from_source_receipt` 。（ ：
- [ ] 在 5173 打开刚才清缓存后退化为 PDF/其他单据的报销单附件详情，确认 meta 自动修复后预览为 PNG， （ ：
- [x] ~~重新跑截图同批火车票 PDF 的 OCR 接口，确认不再返回“其他单据/空字段”。~~ （完成于 11:55， ： `/api/v1/ocr/recognize` 返回 `2月20_武汉-上海.pdf` 与 `2月23_上海-武汉.pdf` 均为 `火车/高铁票` ，并写回票据夹字段）
- [x] ~~重建或补齐当前运行容器的 `poppler-data` / `mupdf-tools`，确认 `mutool` 可用后再上传同类中文 PDF， （完成于 12:04， ： `apt-get install poppler-data mupdf-tools` 成功，`/usr/bin/mutool` 可用；两条 `/preview` 返回 `image/png` ，并写入 `preview_kind=image` ）
- [x] ~~统一 AI 会话附件、票据夹和报销附件的预览类型判定，避免会话上传卡片继续把已生成 PNG 预览的 PDF 当成 PDF 展示。~~ （完成于 12:23， ： `documentPreviewAssets.js` ；前端相关测试 24/24 通过，真实 OCR 返回 `preview_kind=image` 且 `/preview` 为 `image/png` ）
2026-06-24 21:59:15 +08:00
- [x] ~~重新设计一键关联票据的弹窗 UI， ， （完成于 12:52， ： `npm run build` 构建成功，`receipt-folder-view.test.mjs` 测试通过，样式已应用）
- [ ] 单独修复 `expense-application-fast-preview.test.mjs` 里 12 个既有失败或拆分陈旧静态断言， （ ：
- [ ] 在真实 5173 AI 工作台输入“去上海出差，辅助国网仿生产服务器部署，交通火车，直接提交”，确认模型计划路径命中 `/steward/plans` ， （ ：
- [x] ~~在真实 5173 AI 工作台输入“2026-02-20 至 2026-02-23， ， ， ， ， （完成于 16:53， ： `AZ8QSX9QA` ）
- [ ] 在真实 5173 网络面板或后端日志核对 `/steward/plans` 返回 `planning_source=llm_function_call` 、`tasks[0].requested_action=save_draft` 和完整 `ontology_fields` 后，再确认前端没有走 rule fallback。（ ：
- [x] ~~确认真实 `/steward/plans` 不再毫秒级规则直出，并在模型不可用时按 10s * 3 次后降级。~~ （完成于 14:33， ： ， `rule_fallback` ）
- [ ] 修复 MiniMax 连通性或配置可用 backup 模型，再用同一句保存草稿话术确认 `/steward/plans` 返回 `planning_source=llm_function_call` 。（ ： ； ）
- [x] ~~评估 LangChain/LangGraph 是否作为 steward agent 层框架，引入前明确 memory、tools/action、planner、runtime state、observability 和依赖风险。~~ （完成于 15:14， ： `/steward/plans` 规划编排，
- [x] ~~将 `StewardSlotDecisionAgent` 和 `StewardRuntimeDecisionAgent` 继续迁入 LangGraph 节点，形成统一 steward graph runtime。~~ （完成于 15:31， ： `StewardGraphRuntime` ，容器内 graph runtime 相关回归 59/59 通过）
- [x] ~~为 `/steward/plans` 增加服务端白名单 `action_steps`，覆盖申请、报销、保存草稿和直接提交的基础动作规划。~~ （完成于 15:53， ： `StewardActionPlanBuilder` ，真实 5173 回放返回完整 action steps，
- [x] ~~为 LangGraph steward runtime 增加 checkpoint/persistence 设计，复用现有 conversation state， （完成于 16:40， ： `StewardGraphActionRuntime` ，同一 `conversation_id + client_trace_id` 重放返回 `idempotent_replay=true` ，未确认 action 写入 pending interrupt）
- [ ] 修通真实 `llm_function_call` 成功路径，用真实模型配置验证 `/steward/plans` 不再进入 rule fallback。（ ： ；
- [x] ~~实现 LangGraph 白名单 action node， （完成于 16:40， ： `StewardGraphActionRuntime` 默认接管 `/steward/actions/execute` ，
- [x] ~~实现 action registry 的未知 action 拒绝、确认来源校验、重复申请 precheck 阻断和基础业务执行。~~ （完成于 16:13， ： `StewardActionExecutor` ，容器内 action executor 5/5 和迁移回归 71/71 通过；前端点击执行回归 21/21 通过；真实 5173 未确认 submit 返回 `needs_confirmation` ）
- [x] ~~为第一版 `StewardActionExecutor` 增加 checkpoint / interrupt 恢复、持久化 trace 和幂等键。~~ （完成于 16:40， ： `StewardGraphActionRuntime` 持久化 `steward_action_checkpoint` ，重复 trace 不重复建单）
- [x] ~~补齐 `link_existing_application` 和 `associate_attachments` 的真实 action executor 接线与回归测试。~~ （完成于 16:40， ：
- [ ] 前端 AI 工作台从 `steward_action_checkpoint.pending_interrupt` 恢复继续/确认按钮，避免刷新页面后只剩后端 checkpoint、用户看不到可继续 action。（ ： ）
- [ ] 拆分 `usePersonalWorkbenchAiMode.js` 的模型规划等待态和对话启动逻辑，优先把文件降回 800 行以内。（ ：
- [x] ~~修复 AI 模式普通回复复用规划 pending 卡片，确保一次用户输入只生成一条助手消息。~~ （完成于 16:59， ： `assistantCardCount=1` ，前端相关测试 32/32 通过）
- [x] ~~让 AI 模式模型规划等待期间持续追加 thinking 事件，而不是静态显示“思考中”后一次性出现步骤。~~ （完成于 17:26， ：
- [x] ~~修复 AI 工作台“保存草稿”后的上下文提交短句，让“提交这个单据”复用最近申请草稿而不是重新规划。~~ （完成于 17:40， ： `workbench-ai-application-context-submit.test.mjs` 与 `workbench-ai-application-gate-model.test.mjs` 通过）
- [x] ~~修复“完整出差信息但未说申请/报销”时只停在候选流程确认的问题，让唯一的“先发起出差申请”候选流直接进入申请预览计划。~~ （完成于 17:48， ： `workbench-ai-intent-planner-model.test.mjs` 新增回归通过，相邻 4 组前端测试通过）
2026-06-24 22:59:10 +08:00
- [x] ~~修复 AI 工作台“删除草稿”和“我要审核/待办审批”短句意图漏识别。~~ （完成于 22:04， ： `node --test web/tests/workbench-ai-command-intent-model.test.mjs web/tests/ai-document-query-model.test.mjs` 通过 19/19，
- [ ] 在真实 5173 AI 工作台分别输入“删除草稿”和“我要审核”， （ ：
- [x] ~~落地 AI 工作台统一意图识别 Markdown 设计文档，并实现第一版 Intent Frame + Action Policy。~~ （完成于 22:31， ： `2026-06-24-workbench-intent-frame-design.md` 已新增，`workbench-intent-frame-model.test.mjs` 4/4 与 `ai-document-query-model.test.mjs` 16/16 通过）
- [ ] 在真实 5173 AI 工作台分别输入“删除 3 天前的草稿”和“审核合规没有风险的申请”，确认系统先筛选候选而不是直接执行删除/审核。（ ：
- [x] ~~修复“删除申请单草稿”不显示删除动作思考的问题。~~ （完成于 22:36， ： `workbench-intent-frame-model.test.mjs` 新增回归通过，相关前端测试 44/44 通过，前端 build 通过）
- [ ] 在真实 5173 AI 工作台输入“删除申请单草稿”，确认首条 thinking 明确显示“删除”高风险策略， （ ：
- [x] ~~为高风险删除/审核候选结果补充用户可见确认边界说明和实体快捷按钮文案。~~ （完成于 22:42， ： `workbench-intent-frame-model.test.mjs` 新增结果提示回归通过，相关前端测试 45/45 通过，前端 build 通过）
- [x] ~~修复“删除申请单草稿”高风险提示和候选卡片被 trusted HTML 安全渲染整块丢弃的问题。~~ （完成于 22:49， ： ，
2026-06-25 10:56:00 +08:00
- [x] ~~修复 AI 历史会话旧详情入口在单据已删除后仍可跳转坏详情页的问题。~~ （完成于 23:02， ：
- [x] ~~修复“直接提交”自然语言意图绕过申请核对表并自动提交的问题。~~ （完成于 23:10， ： `git diff --check` 均通过）
- [x] ~~把前端统一意图框架里的规则职责收口为稳定安全策略字段。~~ （完成于 23:22， ： `workbench-intent-frame-model.test.mjs` 红灯后转绿，相关前端测试 52/52 通过，前端 build 与 `git diff --check` 均通过）
2026-06-24 22:59:10 +08:00
- [ ] 在真实 5173 AI 工作台输入“删除申请单草稿”， ， （ ：
2026-06-25 10:56:00 +08:00
- [ ] 在真实 5173 跑“删除单据 -> 重新进入历史会话 -> 点击旧详情入口”， （ ：
- [ ] 在真实 5173 AI 工作台输入“2026-02-20 至 2026-02-23， ， ， ， ， ， （ ：
- [ ] 将后端模型计划 / runtime decision 的结构化输出与前端 IntentFrame 策略字段对齐，统一 `riskLevel` 、`requiresCandidateSearch` 、`requiresSelection` 、`requiresConfirmation` 、`executionMode` 、`policyDecision` 命名。（ ：
2026-06-24 21:59:15 +08:00
- [ ] 单独修复或重写 `workbench-ai-mode-switch.test.mjs` 的旧静态结构断言，使它适配 `WorkbenchAiFileStrip` 和 OCR composable 拆分后的真实代码。（ ：
- [ ] 单独修复或重写 `workbench-ai-mode-expense-scene-action.test.mjs` 与 `expense-application-fast-preview.test.mjs` 中继续扫描旧 Vue 单文件的静态断言，改为覆盖 composable/model 的行为测试。（ ：
- [ ] 在真实 5173 AI 工作台回放“2026-02-20 至 2026-02-23， ， ， ， （ ：
