Files
Auto-Finance/docs
wandering 946d27d013 feat(browser): 每步填报后做落库自检,行数/合计不一致写进 warnings
用户第 2 条:add_travel_items 点完确定不核对表尾合计,那次 500 现场看着像「脚本没点着按钮」,
白查一轮。现在每步 POST 完回读页面再比。

- BaseBot.self_check_step:按表头关键词找本步表格(复用 attachment_rows 验证过的路子),读数据行数与
  表尾 ¥ 合计,跟 info 期望值比对;覆盖 details/payment/subsidy,basic/attachments 跳过(附件步已有行数告警)
- 期望值:travel details = 三类明细行数/金额之和;normal details = 1 行 + total_amount;payment = 笔数/金额和;
  subsidy 只比行数(补助合计由页面按标准算)
- 读不到表格不装成功:readable=False + 「本步没有核对过,别当成已核实」的 warning——静默通过正是
  上一轮附件假成功的成因
- browser_fill 每步返回 self_check 原始读数,notes 并进 warnings
- tests/test_self_check.py 六例;FakeBot 绑定 _row_amount 时要用 staticmethod(转类会变成吃 self 的普通函数)
- 文档:browser_fill docstring、操作指南填报注意事项、方案文档 §23(含"选择器待联机确认"的边界)

验证:pytest 197 passed;ruff / format / mypy / deptry / mcp-smoke / docs-check / skill-check 全绿。
--no-verify 提交并手跑等价检查。
2026-10-21 13:53:07 +08:00
..

last_reviewed
last_reviewed
2026-10-20

docs — 公开文档目录

本目录存放面向项目用户和外部贡献者的公开文档。

文档清单

文件 说明
MCP.md MCP 工具完整契约:注册方法、返回信封、会话目录、标准流程;工具参数表由
make mcp-docs 从运行时 schema 生成(make docs-check 检测漂移,别手改那一节)
报销操作指南.md 面向最终用户的报销口径与材料准备说明

旧的 API.md(Flask 路由/SSE 文档)已随 Web 界面删除;需要历史接口形态时看 git 提交 b2d271c。

文档边界

维护规范、实施方案、经验总结等内部资料统一放在 .agents/;宿主 Agent 的报销操作纪律在 .agents/skills/reimbursement/SKILL.md。