docs: 清理过期计划文档并补全 work-log 与开发/用户文档

- 删除已落地的 improvement-roadmap、superpowers 计划与 ui-mockups 参考稿，删除早期 work-log（2026-05-06~08）
- 新增 2026-05-23 起的 work-log 与 attachment-association-background-job、reimbursement-draft-action-branching 等开发文档及用户文档
- docker-compose(.full).yml 微调服务配置

document/work-log/2026-05-06.md

@@ -1,18 +0,0 @@
-# Work Log - 2026-05-06
-
-## 今日工作
-
-### 下午
-- **修复了 Windows Git Bash 启动脚本报错问题**
-  - 问题：虚拟环境指向不存在的 python3
-  - 解决：添加检测函数，无效则重建
-
-- **创建了 work-log 技能**
-  - 自动记录工作日志
-
----
-
-# 待处理
-
-- [ ] 安装 PostgreSQL
-- [ ] 创建 x_financial 数据库

document/work-log/2026-05-07.md

@@ -1,36 +0,0 @@
-# Work Log - 2026-05-07
-
-## 今日工作
-
-- **提交 c00db75** (11:50)
-  - feat: add employee management, backend health check, and UI improvements
-  - 完成了员工管理模块（后端 + 前端）
-  - 添加了后端健康检查
-  - 整理了 UI 资源
-
-- **提交 2d56bc2** (13:48)
-  - feat: enhance employee CRUD with search, filters, and security module
-  - 增强了员工搜索和筛选功能
-  - 添加了安全模块（security.py）
-  - 添加了单元测试
-
-- **提交 b8ba0ea** (14:32)
-  - feat: add auth module with login and access control
-  - 为系统实现了完整的登录认证功能
-  - 后端使用 FastAPI 搭建了 auth 服务，支持管理员密钥验证
-  - 前端对接了登录接口，实现了 Token 存储和自动登录逻辑
-  - 设计并实现了基于角色的访问控制（RBAC），区分超级管理员和普通员工
-
-- **提交 e8f3d97** (15:18)
-  - feat: add settings page with navigation and access control updates
-  - 搭建了系统设置页面，支持管理员配置系统参数
-  - 优化了侧边栏导航交互，增加了收起/展开的流畅动画
-  - 将访问控制规则统一收敛到 accessControl.js，避免散落各处
-  - 统一了 useSystemState 和 useNavigation 两个 composable 的职责
-
----
-
-# 待处理
-
-- [ ] 安装 PostgreSQL
-- [ ] 创建 x_financial 数据库

document/work-log/2026-05-08.md

@@ -1,30 +0,0 @@
-# Work Log - 2026-05-08
-
-## 今日工作
-
-- **提交 adda87a** (08:56)
-  - feat: add system settings with model connectivity and encrypted storage
-  - 为系统设置页面新增了配置管理功能，支持管理员修改 AI 模型连接参数
-  - 引入加密存储方案（secret_box.py），对敏感配置（如 API Key）使用对称加密保护
-  - 后端新增 settings 端点、repository 层和 service 层，实现配置的增删改查
-  - 新增 model_connectivity.py 服务，支持测试 AI 模型连接是否正常
-  - 前端设置页面大幅重构，增加了模型配置表单和连接测试功能
-  - 新增数据库表 system_setting 和 system_setting_secret 存储配置和加密值
-  - 编写了 settings 相关的单元测试，确保配置持久化和服务逻辑正确
-
-- **提交 c5486dd** (10:52)
-  - feat: 启用后端自动启动与 Setup 引导流程增强
-  - 启用了后端自动启动功能，用户访问前端时后端自动拉起，无需手动启动 server
-  - 增强了 Setup 引导流程，新增后端启动进度追踪，分 5 步展示（config → deps → server → health → done）
-  - 网络绑定从 127.0.0.1 扩展到 0.0.0.0，支持远程浏览器访问部署的系統
-  - API URL 动态化，通过 localStorage 持久化配置，支持运行时修改
-  - 新增后端启动探针（probe），自动检测后端就绪状态后才允许浏览器继续操作
-  - Setup 表单智能判断浏览器 host，将本地地址自动转换为 0.0.0.0 供远程访问
-
-- **提交 8656866** (11:14)
-  - feat: 重构模型配置存储与 API Key 加密管理
-  - 新增 SystemModelSetting 模型（slot 为 PK），支持 main/backup/vlm/embedding 四个模型槽位配置
-  - 废弃旧的加密存储方案，改用更规范的数据库表存储加密的 API Key
-  - 兼容旧版 admin secret 格式，将历史密码记录迁移到标准 scrypt 哈希格式
-  - 前端 API URL 智能解析，当后端配置为回环地址但浏览器非回环时，自动使用浏览器 host 访问
-  - 改进 API Key 输入体验，聚焦时自动清除遮罩显示，并提示已从数据库加载密钥

document/work-log/2026-05-23.md

@@ -0,0 +1,17 @@
+# 2026-05-23 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`575f093`
+
+## 工作内容
+
+- 新增风险规则生成引擎，支持从知识、规则资产和业务上下文中生成风险规则草案。
+- 增强知识图谱可视化能力，补充知识摄取日志图谱节点、证据和运行信息展示。
+- 扩展审计页、日志详情页和归档中心交互，便于追踪规则生成、知识索引和报销会话链路。
+- 补充风险规则生成、知识摄取日志、报销引导流程等测试覆盖。
+
+## 提交记录
+
+- `575f093` feat: 新增风险规则生成引擎与知识图谱可视化

document/work-log/2026-05-24.md

@@ -0,0 +1,18 @@
+# 2026-05-24 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`50b1c3f`
+
+## 工作内容
+
+- 增强规则资产管理能力，引入规则测试、规则流图和运行时调试相关页面能力。
+- 新增 Hermes Agent 相关架构、数据库、风险扫描、报销报告和部署说明文档。
+- 扩展 Hermes 配置、报告、风险扫描、调度等后端模型和服务。
+- 新增文档中心页面与时间工具，优化审计页、日志页、设置页和导航交互。
+- 清理旧风险规则文件，并补充知识解析、RAG、规则生成和用户代理服务测试。
+
+## 提交记录
+
+- `50b1c3f` feat: 增强规则资产管理与审计页面运行时调试

document/work-log/2026-05-25.md

@@ -0,0 +1,18 @@
+# 2026-05-25 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`d0e946c`
+
+## 工作内容
+
+- 完善文档中心和报销申请链路，新增首页参考稿并优化侧边栏结构。
+- 抽取用户代理申请服务，增强报销单、申请单、本体识别和编排流程。
+- 强化文档中心未读状态、侧边栏入口、详情提醒和申请预填能力。
+- 优化报销创建页、差旅详情页和小财管家会话状态。
+- 补充文档中心、申请提交确认、助手建议动作、侧边栏折叠等测试。
+
+## 提交记录
+
+- `d0e946c` feat: 完善文档中心与报销申请交互及侧边栏重构

document/work-log/2026-05-26.md

@@ -0,0 +1,20 @@
+# 2026-05-26 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`0e861d8` 至 `df49103`
+
+## 工作内容
+
+- 增强风险规则生成引擎和预算中心页面，打通预算中心本体、风险规则评分和预算后端服务。
+- 新增差旅风险规则库，补充预算实体、预算服务、预算图表和预算中心视图。
+- 完善预算中心图表展示、确认对话框和费用管控交互。
+- 扩展规则资产、员工、报销申请、审批和预算相关测试，覆盖新引擎与预算链路。
+
+## 提交记录
+
+- `0e861d8` feat: 增强风险规则生成引擎与预算中心页面
+- `e1e515e` feat: 新增预算中心本体与风险规则评分回填
+- `e7bef08` feat: 新增预算后端服务与差旅风险规则库
+- `df49103` feat: 完善预算中心图表与确认对话框交互

document/work-log/2026-05-27.md

@@ -0,0 +1,22 @@
+# 2026-05-27 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`2dcc721` 至 `d4d5d40`
+
+## 工作内容
+
+- 重构全局 UI 主题皮肤与样式模块，统一页面视觉基线。
+- 优化报销创建页面样式和洞察面板交互，提升申请与报销过程的可读性。
+- 新增预算助手报告组件，补强预算报告、报销交互细节和申请关联能力。
+- 完善审批退回流程与报销申请关联逻辑。
+- 新增预算费控模型和报销审批流引擎，为后续动态审批与预算分析打基础。
+
+## 提交记录
+
+- `2dcc721` style: 全局 UI 主题皮肤重构与样式模块化
+- `b1a9c8a` fix: 优化报销创建页面样式与洞察面板交互
+- `7d32eae` feat: 新增预算助手报告组件并优化报销交互细节
+- `cbb98f4` feat: 完善审批退回流程与报销申请关联
+- `d4d5d40` feat: 新增预算费控模型与报销审批流引擎

document/work-log/2026-05-28.md

@@ -0,0 +1,21 @@
+# 2026-05-28 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`04cd6d0` 至 `064eeb6`
+
+## 工作内容
+
+- 重构工作台首页，新增数字员工管理页面和员工行为画像算法。
+- 引入费用风险标签体系、员工画像标签分页和 ECharts 统一图表能力。
+- 在列表详情页面引入共享 shell，并逐步拆分审计列表、详情和模型逻辑。
+- 备份列表详情 shell 重构前工作区，降低大规模 UI 抽取风险。
+
+## 提交记录
+
+- `04cd6d0` feat: 新增数字员工管理页面与工作台首页重构
+- `8a4a777` feat: 新增员工行为画像算法与费用风险标签体系
+- `e384318` feat: 引入 ECharts 统一图表并完善员工画像标签分页
+- `b383244` chore: backup workspace before list detail shell refactor
+- `064eeb6` refactor(ui): introduce shared list detail shells

document/work-log/2026-05-29.md

@@ -0,0 +1,21 @@
+# 2026-05-29 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`99e9079` 至 `4c59941`
+
+## 工作内容
+
+- 拆分审计列表详情流程和模型，复用共享列表 shell，降低重复 UI 结构。
+- 完成共享 shell 与加载状态收口，统一页面加载、空态和列表体验。
+- 统一后端分页查询接口与前端服务层适配。
+- 新增票据夹模块，优化 OCR、员工画像和票据相关服务。
+
+## 提交记录
+
+- `99e9079` refactor(audit): split list detail flows
+- `64cc76c` refactor(audit): reuse list shells and split models
+- `e080105` feat(ui): finalize shared shells and loading states
+- `678f64d` feat: 统一后端分页查询与前端服务层适配
+- `4c59941` feat: 新增票据夹模块并优化 OCR 与员工画像服务

document/work-log/2026-05-30.md

@@ -0,0 +1,18 @@
+# 2026-05-30 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`7989f3a`
+
+## 工作内容
+
+- 新增风险图谱算法能力，围绕风险节点、关系和来源构建设计与实现文档。
+- 扩展系统仪表盘和操作反馈体系，提升风险与业务操作的可解释性。
+- 增强规则资产、风险规则模拟、员工、申请和审批相关服务。
+- 更新前端预算中心、审计、工作台、差旅申请和详情页等模块。
+- 补充文档、测试和运行资产，支撑风险图谱与仪表盘演示。
+
+## 提交记录
+
+- `7989f3a` feat: 新增风险图谱算法与系统仪表盘及操作反馈体系

document/work-log/2026-06-01.md

@@ -0,0 +1,18 @@
+# 2026-06-01 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`92444e7`
+
+## 工作内容
+
+- 扩展风险规则体系，增强规则生成、规则执行、复合规则和本体字段治理能力。
+- 新增审批动态路由能力，补强申请审批、报销审批和流程转派场景。
+- 推进预算中心列表化改造，配套更新预算、审计、文档中心和工作台页面。
+- 更新项目协作规范、环境配置和规则表资产。
+- 补充风险规则、本体、审批、文档中心和申请流程相关测试。
+
+## 提交记录
+
+- `92444e7` feat: 扩展风险规则体系、审批动态路由与预算中心列表化改造

document/work-log/2026-06-02.md

@@ -0,0 +1,18 @@
+# 2026-06-02 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`ca691f3` 至 `0c74b4a`
+
+## 工作内容
+
+- 优化差旅报销预审流程和个人工作台 UI 体系，增强申请、报销和智能助手联动。
+- 重构财务看板口径，补充半年模拟数据和报销状态注册表。
+- 扩展财务看板、风险看板、员工画像、工作台、差旅详情和申请创建页面。
+- 补充模拟数据、状态口径、看板展示和报销流程相关测试。
+
+## 提交记录
+
+- `ca691f3` feat: 优化差旅报销预审流程与个人工作台 UI 体系
+- `0c74b4a` feat: 财务看板口径重构与半年模拟数据及报销状态注册表

document/work-log/2026-06-03.md

@@ -0,0 +1,49 @@
+# 2026-06-03 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`faa39e6` 至 `87da5df`
+
+## 工作内容
+
+- 建设数字员工财务报告体系、定时提醒和看板快照调度能力。
+- 优化风险看板、数字员工看板、预算与风险卡片、共享加载态和仪表盘展示。
+- 完善工作台费用进度、费用统计详情弹窗、分布图、画像雷达和个人工作台标签展示。
+- 推进本体字段治理和风险规则模板执行器重构。
+- 优化申请与报销流程，包括申请关联限制、交通方式显式要求、手工明细入口收口和管理员工作台权限。
+- 完善文档中心未读状态、铃铛通知、排序、全部已读和顶部通知持久化。
+- 细化风险可见性和审核人风险提示，修复规则标准调整后的风险说明保留问题。
+
+## 提交记录
+
+- `faa39e6` test(dashboard): cover shared loading overlay
+- `d060f89` style(dashboard): reuse shared loading overlay
+- `0d6327a` feat(dashboard): polish risk and digital employee boards
+- `15006a0` feat: 数字员工财务报告体系与定时提醒及看板快照调度
+- `27dd2f0` feat(dashboard): reorganize budget and risk cards
+- `6fc5e66` feat(workbench): show progress update time first
+- `3130c42` feat(workbench): separate stale progress items
+- `20cb60e` feat(workbench): add expense stats detail modal
+- `31052d0` feat(workbench): keep progress detail return context
+- `74d488a` fix(workbench): center progress expense type
+- `18d716b` feat(workbench): show expense distribution as donut chart
+- `e12b140` fix(workbench): show single expense distribution chart
+- `34457f9` feat: 本体字段治理与风险规则模板执行器重构
+- `8887cf5` fix(workbench): stretch profile tag card
+- `04f0951` fix: restrict application linking for reimbursement drafts
+- `59d3bf0` fix(auth): keep admin out of personal workbench
+- `9219854` fix: require explicit transport mode for applications
+- `513ff90` fix: remove manual expense detail add action
+- `4717ee6` fix(documents): refine unread badges and mark all read
+- `8c2f301` fix(documents): sort newest rows first
+- `c73178b` fix(documents): move unread notice into bell
+- `95956af` fix(notifications): refine bell notification center
+- `9c24a85` fix(workbench): remount expense stats chart on reopen
+- `67b81a1` fix(workbench): replay profile radar animation
+- `8e24775` fix: handle risk explanation standard adjustment
+- `cb36d78` fix: 优化顶部导航栏布局与工作台摘要展示并清理旧票据数据
+- `0f8bc40` fix: preserve reviewer risk notice after standard adjustment
+- `b9826a1` fix: keep adjusted risks visible to reviewers
+- `75d5c17` feat(workbench): persist topbar notification state
+- `87da5df` feat: 风险可见性控制与差旅详情页交互优化

document/work-log/2026-06-04.md

@@ -0,0 +1,18 @@
+# 2026-06-04 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`1cbf3fe` 至 `f60ceba`
+
+## 工作内容
+
+- 增强报销预审会话状态管理，优化工作台与报销创建页交互。
+- 完善小财管家意图规划、管家计划和报销提交编排。
+- 扩展用户代理、编排器、差旅报销会话、提交组合器和申请预填相关能力。
+- 补充小财管家计划、报销预审、提交编排和工作台交互测试。
+
+## 提交记录
+
+- `1cbf3fe` feat: 报销预审会话状态管理与工作台交互增强
+- `f60ceba` feat: 小财管家意图规划与报销提交编排增强

document/work-log/2026-06-06.md

@@ -0,0 +1,18 @@
+# 2026-06-06 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`e124e4b`
+
+## 工作内容
+
+- 重构报销审批流，贯通小财管家计划、报销预审、申请提交和审批链路。
+- 扩展管家计划流式接口、报销单服务、申请草稿、风险提示和上下文工具。
+- 优化工作台 AI 模式、差旅报销创建页、申请详情页和文档中心交互。
+- 更新 Docker、环境配置和忽略规则，配合新流程运行。
+- 补充大量后端、前端和端到端测试，覆盖审批流、预算分析、申请确认和工作台入口。
+
+## 提交记录
+
+- `e124e4b` feat: 报销审批流重构与管家计划全链路贯通

document/work-log/2026-06-09.md

@@ -0,0 +1,18 @@
+# 2026-06-09 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`25724c3`
+
+## 工作内容
+
+- 同步报销流程和工作台近期改动，继续完善申请、报销、风险建议与工作台协同。
+- 调整 Docker、GPU、Postgres 和环境配置，适配本地与容器化运行。
+- 补充移动端相关资源和前端页面改动。
+- 更新服务端报销、员工、本体、规则、用户代理和审批链路实现。
+- 扩展工作台、申请详情、报销创建、审计和文档中心相关测试。
+
+## 提交记录
+
+- `25724c3` feat: 同步报销流程与工作台改动

document/work-log/2026-06-12.md

@@ -0,0 +1,15 @@
+# 2026-06-12 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`336fee9`
+
+## 工作内容
+
+- 更新仓库忽略规则，将 `.superpowers` 工具缓存目录排除出版本管理。
+- 降低本地代理工具缓存误入库风险。
+
+## 提交记录
+
+- `336fee9` chore: 忽略 .superpowers 工具缓存目录

document/work-log/2026-06-13.md

@@ -0,0 +1,17 @@
+# 2026-06-13 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`8b952c9`
+
+## 工作内容
+
+- 拆分差旅报销创建工作流，降低单页脚本和流程模型复杂度。
+- 抽取差旅报销草稿、提示动作、附件、会话状态和提交组合等前端逻辑。
+- 强化报销创建页的可维护性，为后续 AI 工作台与报销流程复用做准备。
+- 补充报销创建、会话状态、建议动作和附件流程测试。
+
+## 提交记录
+
+- `8b952c9` refactor(travel): split reimbursement create workflow

document/work-log/2026-06-15.md

@@ -0,0 +1,19 @@
+# 2026-06-15 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`5747e85` 至 `9f7b8b4`
+
+## 工作内容
+
+- 恢复上传阶段规则中心复核，确保附件上传时的风险识别链路有效。
+- 修正报销明细和风险建议对齐问题，让风险提示能对应到具体费用行。
+- 细化差旅报销小财管家流程，覆盖申请、报销、计划、回显和提交流程。
+- 更新规则表、后端服务、前端工作台和差旅报销创建页，补齐流程测试。
+
+## 提交记录
+
+- `5747e85` fix(risk): restore upload-time rule center review
+- `7927417` fix(claim): align risk advice with expense rows
+- `9f7b8b4` Refine travel reimbursement steward flow

document/work-log/2026-06-17.md

@@ -0,0 +1,26 @@
+# 2026-06-17 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`470f343` 至 `b8915a2`
+
+## 工作内容
+
+- 收窄差旅路线风险指标，减少误报并统一风险标记口径。
+- 调整 Web 端口配置，补充工具临时目录忽略规则。
+- 重构报销审批流，优化差旅详情、风险建议卡片和文档中心交互。
+- 更新财务差旅与通信费用规则表。
+- 同步报销审批流和预算分析测试。
+- 归档用户报销票据附件，清理运行资产边界。
+
+## 提交记录
+
+- `470f343` fix(expense): narrow travel route risk indicators
+- `0d525fa` chore: 忽略 .codex-temp 工具临时目录
+- `09a66c7` chore: 将 web 端口由 5173 调整为 5273
+- `1f4681f` feat(claim): 重构报销审批流并收敛风险标记
+- `a3e5295` feat(rules): 更新财务差旅与通信费用规则表
+- `0fac8b6` feat(web): 优化差旅详情、风险建议卡片与文档中心交互
+- `4199feb` test: 同步报销审批流与预算分析测试
+- `b8915a2` chore(storage): 归档用户报销票据附件

document/work-log/2026-06-18.md

@@ -0,0 +1,32 @@
+# 2026-06-18 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`cce19e4` 至 `4d04f4e`
+
+## 工作内容
+
+- 完善 Steward 业务无关输入拦截，支持 `off_topic` 计划、前端引导话术和场景细分。
+- 增强服务端启动 bootstrap、缓存预热和登录目录并发幂等控制。
+- 仅放行财务业务相关问题的信号校验，强化业务边界。
+- 更新差旅、通信等财务规则表，并清理用户历史报销票据附件。
+- 优化工作台 AI 模式、差旅/风险建议交互、用户消息气泡和引用图标。
+- 新增 X-Financial 改进路线图，补充未来改进方向。
+- 更新忽略规则，避免 `.env`、`.nezha`、`.omo` 等本地或敏感配置入库。
+
+## 提交记录
+
+- `cce19e4` feat(steward): 拦截业务无关输入返回 off_topic 计划
+- `4343253` feat(steward): 前端支持 off_topic 与引导话术
+- `c28e99b` chore(gitignore): 忽略 .nezha/ 与 .omo/ 本地工具目录
+- `38653fa` chore(storage): 清理用户历史报销票据附件
+- `35372c6` feat(rules): 更新差旅与通信费用等财务规则表
+- `59ba76c` feat(startup): 服务端启动 bootstrap 与缓存预热
+- `3f17619` fix(auth): 登录目录就绪幂等化与并发控制
+- `127d603` feat(ontology): 仅放行财务业务相关问题的信号校验
+- `a6674a1` feat(steward): off_topic 场景细分与引导回复
+- `0cde1f8` feat(web): 工作台 AI 模式与差旅/风险建议交互优化
+- `a2f67af` docs: 新增 X-Financial 改进路线图
+- `3131112` style(web): 调整 AI 模式用户消息气泡布局与引用图标
+- `4d04f4e` chore(gitignore): 忽略 .env 防止敏感配置入库

document/work-log/2026-06-20.md

@@ -0,0 +1,27 @@
+# 2026-06-20 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`3d69f85` 至 `3b74a33`
+
+## 工作内容
+
+- 细化申请单阶段风险可见性并更新规则表。
+- 拆分工作台 AI 模式报销预审和文档查询模型。
+- 新增申请核对预览快速建单接口，并统一平台管理员判定。
+- 接入 AI 工作台申请预览动作，支持申请单草稿保存和删除权限统一。
+- 将单号规则收紧为 `A/R/D + 8 位` 紧凑格式，并适配后端测试。
+- 增强 AI 工作台会话、文档卡片渲染和 AI 文档查询卡片。
+
+## 提交记录
+
+- `3d69f85` feat(risk): 申请单阶段风险可见性细化与规则表更新
+- `304bbe1` feat(web): 工作台 AI 模式报销预审与文档查询模型拆分
+- `729d833` feat(server): 新增申请核对预览快速建单接口与平台管理员判定统一
+- `96c2e10` feat(web): 统一平台管理员判定与 AI 工作台申请预览动作接入
+- `47c6a4b` refactor(server): 单号规则收紧为 A/R/D+8 位紧凑格式
+- `81e990a` feat(server): 申请单支持草稿保存并统一删除权限口径
+- `0cda750` feat(web): AI 工作台会话与文档卡片渲染增强
+- `8158716` test(server): 适配 A/R/D 紧凑单号格式
+- `3b74a33` feat(web): AI 文档查询卡片重构与单号判定统一

document/work-log/2026-06-21.md

@@ -0,0 +1,24 @@
+# 2026-06-21 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`8b34954` 至 `08a4fa3`
+
+## 工作内容
+
+- 增强 AI 文档详情引用解析和查询卡片展示。
+- 优化差旅申请详情进度 viewer、审批信息、加载态和领导意见事件样式。
+- 移除顶栏 AI 快捷操作区，让非首页顶栏更收敛。
+- 优化 OCR 处理：PDF 文本层可用时跳过 worker 调用，并补装 `poppler-data`。
+- 将 AI 工作台附件改为卡片化展示，支持单项移除并适配卡片样式与交互。
+
+## 提交记录
+
+- `8b34954` feat(web): AI 文档详情引用解析与查询卡片增强
+- `24b5b71` feat(web): 差旅申请详情进度 viewer 与审批/加载态组件增强
+- `1986b0d` style(web): 移除顶栏 AI 快捷操作区并优化差旅领导意见事件样式
+- `88e91a5` feat(ocr): PDF 文本层可用时跳过 worker 调用并补装 poppler-data
+- `669d22e` feat(web): 差旅领导意见事件结构化与申请审批信息增强
+- `d660a96` feat(web): AI 工作台附件改为卡片化展示并支持单项移除
+- `08a4fa3` style(web): AI 工作台附件卡片样式与交互适配

document/work-log/2026-06-22.md

@@ -0,0 +1,28 @@
+# 2026-06-22 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`6d33ba5` 至 `bc743ad`
+
+## 工作内容
+
+- 执行 800 行源码限制重构，拆分服务、组件、composable、工具函数和测试辅助模块。
+- 拆分 Docker 主应用编排和完整本地栈，补充 Docker 说明、重构计划和 UI 参考图。
+- 更新差旅、交通、通信等财务规则表。
+- 恢复差旅详情子组件样式。
+- 扩展报销单输出工号/邮箱，并支持申请人邮箱前缀匹配。
+- 新增报销单关联申请单门控和草稿检测流程。
+- 增强申请单预览编辑器和报销流程细节。
+
+## 提交记录
+
+- `6d33ba5` refactor: enforce 800 line source limits
+- `607e127` chore(docker): 拆分主应用编排与完整本地栈
+- `e42deda` docs: 同步 Docker 编排说明并补充重构计划与 UI 参考
+- `103f225` chore(rules): 更新差旅/交通/通信等财务规则表
+- `1b04ee1` fix(web): restore travel detail child component styles
+- `aa965da` feat(server): 报销单输出工号/邮箱并扩展申请人邮箱前缀匹配
+- `ba444a5` feat(web): 报销单新增关联申请单门控与草稿检测流程
+- `ded8b39` feat(web): 申请单预览编辑器增强与报销流程细节适配
+- `bc743ad` chore(rules): 更新公司通信费报销规则表

document/work-log/2026-06-23.md

@@ -0,0 +1,28 @@
+# 2026-06-23 工作日志
+
+## 远端依据
+
+- 分支：`origin/main`
+- 提交：`84a8998` 至 `73966b3`
+
+## 工作内容
+
+- 新增票据文件夹资产缓存和统一文档预览生成，完善 OCR、票据夹和附件分析链路。
+- 前端接入票据夹资产缓存，完善 AI 工作台附件流程、智能入口识别和草稿附件选择。
+- 统一 `WEB_PORT` 回退到 `5173`，并让烟雾检查支持开关。
+- 更新交通、通信、差旅、出差等财务规则表。
+- 重构通知中心列表行布局和时间标签格式。
+- 移除误跟踪的 `expense_claims` 运行时票据文件。
+- 修复孤儿申请预览消息，触发重新生成可编辑表格。
+- 合并财务工作流模块，抽取申请事实解析、Steward 计划拆分、可信 HTML、加载状态和文档协议常量。
+
+## 提交记录
+
+- `84a8998` feat(server): 票据文件夹资产缓存与文档预览统一生成
+- `e725b7f` feat(web): 票据夹资产缓存接入与 AI 工作台附件流程完善
+- `dc4cad2` chore(env): WEB_PORT 统一回退为 5173 并烟雾检查改为可开关
+- `0122f3b` chore(rules): 更新交通/通信/差旅/出差等财务规则表
+- `8094333` style(web): 通知中心列表行布局重构与时间标签格式化
+- `f17098a` chore(repo): 移除误跟踪的 expense_claims 运行时票据文件
+- `1f40ce3` fix(web): 孤儿申请预览消息触发重新生成可编辑表格
+- `73966b3` refactor: consolidate finance workflow modules

document/work-log/2026-06-24.md

@@ -0,0 +1,138 @@
+# 2026-06-24 工作日志
+
+## 当日工作内容
+
+- 09:41：我开始为 X-Financial 补一个专门写修改日志的项目级 Skill，目标是让后续每次 bugfix、新功能、重构或配置/文档修改之后，都能留下有时间、有操作、有判断的增量记录。
+  - 修改：新增 `agent-change-log` Skill，约定触发场景、每日日志位置、三段式结构、TODO 勾选规则和拟人化记录方式。
+  - 修改：新增 Skill 展示元数据，方便后续通过 `$agent-change-log` 识别和调用。
+  - 修改：准备把 `AGENTS.md` 接上强触发规则，避免后续代理只记得“写代码”而忘了“写修改记录”。
+  - 操作：沿用既有 `document/work-log/YYYY-MM-DD.md` 日志目录，不另起一套新路径，避免历史记录分裂。
+  - 验证：09:42 已补做结构检查，见下一条记录。
+  - 影响：后续修改会从“最终总结”升级为“过程可追踪”，当天工作内容、遗留问题和 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：我继续检查了新 Skill 的版本管理可见性，确认它已经落在本机项目目录，但默认会被 `.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：我按你的补充要求，把“先拉取/检查 Git，分析其他智能体提交”纳入 `agent-change-log` 的硬流程。
+  - Git 提交检查：已运行 `git fetch --all --prune`；`HEAD..origin/main` 未发现 upstream 新提交。当前本地 `main` 显示 ahead 1，后续在 10:02 单独补充分析本地 ahead 提交。
+  - 修改：更新 `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：我把本地 ahead 提交也纳入日志 Skill，因为当前仓库已经出现 `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，也会被日志 Skill 捕捉并分析。
+
+- 10:21：自动记录 `9321260` 提交后的工作日志。（auto-log:9321260）
+  - Git 提交检查：fetch 失败：error: cannot open '.git/FETCH_HEAD': Operation not permitted；upstream `origin/main`；upstream 新提交：未发现；本地 ahead 提交：9321260 (HEAD -> main) chore(skills): add git checkpoint commit loop。
+  - 修改：最近提交为 `9321260 chore(skills): add git checkpoint commit loop`。
+  - 操作：manual 验证自动日志脚本 触发 `tools/agent-change-log/update_change_log.py`，自动读取 Git 状态并写入当天日志。
+  - 验证：自动脚本只记录提交和 Git 状态，不替代业务测试；业务验证仍以本次任务实际运行结果为准。
+  - 影响：提交后即使执行代理忘记手动写日志，也会留下最低限度的时间、提交和分支状态记录。
+
+- 10:21：我排查了“修改 bug 或新增功能后不会自动写日志”的根因，并补上可执行自动化入口。
+  - 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：我修正了 PDF 票据 OCR 的转图链路，避免“预览图丢中文但仍继续 OCR”的假成功。
+  - 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 文本层可用就直接构建识别结果”的分支，PDF 现在必须先转图片，再进入 Paddle OCR worker；文本层仅作为后续纠错/兜底材料，不再绕过图片 OCR。
+  - 修改：`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：我确认 10:06 上传的票据夹记录当前仍是 PDF 预览，并修正 OCR 文本层纠错会清空 PNG 预览的问题。
+  - 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：我继续排查“重新上传仍是 PDF 识别”的原因，确认最新 10:29 上传命中了旧 OCR 结果，并修正 OCR 内存缓存失效条件。
+  - 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，没有包含 PDF 转图/识别管线版本；同一 PDF 重新上传时可能复用旧的内存缓存，导致新转图逻辑没有机会执行。
+  - 修改：新增 `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：我修正了 AI 工作台附件预览弹窗在左侧侧边栏存在时视觉不居中的问题。
+  - 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 工作台侧边栏，在右侧主工作区内居中展示，截图里的“偏左/不居中”观感会收敛。
+
+- 10:41：我补修了票据夹 PDF 保存阶段的预览持久化，避免 OCR 后仍把源 PDF 当成附件预览展示。
+  - 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 还需要单独刷新。
+
+## 遗留问题
+
+- 09:41：当前 Skill 是新建在项目级 `.codex/skills` 目录里，本轮可以通过文件检查验证结构，但是否被未来会话自动加载还依赖 Codex 对项目 Skill 的刷新机制。建议后续新开会话或下一次任务时确认 Skill 列表是否出现 `agent-change-log`。
+- 09:43：`.codex/` 曾被 `.gitignore` 整体忽略，新建的 `agent-change-log` 默认不会进入普通提交范围；09:44 已改成只放行该 Skill。建议后续如果还新增其他项目 Skill，也按同样方式逐个显式放行，别一次性开放整个 `.codex`。
+- 10:01：当前工作区已有大量未提交改动，且本地 `main` ahead 1。建议后续如果真的发现 upstream 新提交，先用 fetch 和 `HEAD..@{u}` 写日志；只有在工作区干净、可快进时再执行 `git pull --ff-only`，避免把其他智能体提交和本地半成品混到一起。
+- 10:02：本地 ahead 提交也可能来自其他智能体，不能只看 upstream behind。建议后续日志固定同时记录 `HEAD..@{u}` 和 `@{u}..HEAD` 两个方向。
+- 10:21：自动日志触发时发现 fetch 未成功：失败：error: cannot open '.git/FETCH_HEAD': Operation not permitted。建议后续在有 Git 写权限和网络权限的环境里重新执行拉取检查。
+- 10:21：当前环境不能写 `.git/hooks`，所以 post-commit hook 模板已经入库，但尚未安装到本 checkout。建议在有 `.git` 写权限的环境执行 `tools/agent-change-log/install_post_commit_hook.sh`。
+- 10:24：本轮未能在容器内执行 pytest，也未能实际确认容器是否已安装 `mupdf-tools`。建议在 Docker 权限恢复后重建/重启 `x-financial-main`，执行定向 OCR 测试，并在 5173 用真实 PDF 票据确认预览图和 OCR 字段都保留中文。
+- 10:28：10:06 那条既有票据记录已经写成 PDF fallback，代码修复不会自动改写旧 meta。建议重新上传一次同一 PDF，或在容器权限恢复后触发票据重识别/重建预览，确认新记录变为 PNG 预览。
+- 10:32：最新 10:29 上传仍然写成 PDF，说明运行中的后端可能还没加载最新代码，或本轮上传发生在缓存版本修复之前。建议重启后端/重建容器后再重新上传，确认 OCR cache key 已包含 `pdf-image-ocr:`。
+- 10:40：本轮可以确认 5173 服务可达、结构测试和生产构建通过，但当前环境没有可调用的浏览器自动化插件，项目也没有现成 Playwright/Puppeteer 依赖，所以未生成真实页面截图。建议在具备浏览器自动化的环境回放一次附件预览，确认主内容区居中效果。
+- 10:41：票据夹 PDF 保存阶段已补主动生成图片预览，但当前沙箱不能访问 Docker socket，无法运行容器内 pytest，也无法刷新已有 PDF 票据的旧 meta。建议 Docker 权限恢复后先跑定向测试，再对旧记录触发 `resolve_preview` 或重识别来补 `preview.png`。
+
+## 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，证据：Skill 已新增 `Required Git Check`，`AGENTS.md` 已要求日志前运行 `git fetch --all --prune` 和 `git log HEAD..@{u}`）
+- [x] ~~把本地 ahead 提交也纳入 `agent-change-log` 的提交分析范围。~~（完成于 10:02，证据：Skill 和 `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`，让提交后自动写日志真正启用。（来源：10:21 当前沙箱安装失败）
+- [ ] 在后续每次 bugfix、新功能、重构或配置/文档修改后，调用 `agent-change-log` 并增量更新当天日志。（来源：09:41 用户要求）
+- [ ] 重建/重启 `x-financial-main`，确认容器内存在 `mutool`，并执行 OCR 定向 pytest。（来源：10:24 PDF 中文转图链路修复）
+- [ ] 在 5173 真页重新上传/预览火车票 PDF，确认预览 PNG 不再丢中文，OCR 字段不再出现“乘车人/站点”等中文缺失或错位。（来源：10:24 PDF 中文转图链路修复）
+- [ ] 重新上传 10:06 同款 PDF 或触发该票据重识别，确认新的 `meta.json` 写入 `preview_kind=image` 和 `preview_media_type=image/png`。（来源：10:28 PNG 预览保留修复）
+- [ ] 后端加载缓存版本修复后，重新上传同一 PDF，确认不会再命中旧 OCR 缓存，`ocr_line_count` 和 PNG 预览都来自新转图流程。（来源：10:32 OCR cache key 修复）
+- [ ] 在有浏览器自动化能力的环境回放 AI 工作台附件预览弹窗，截图确认弹窗按侧边栏右侧主内容区居中。（来源：10:40 附件预览弹窗布局修复）
+- [ ] Docker 权限恢复后运行票据夹 PDF 预览定向测试，并刷新已有 `preview_kind=pdf` 的旧票据 meta。（来源：10:41 PDF 保存阶段主动生成图片预览修复）