wandering
35603837e4
用户第 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 提交并手跑等价检查。
项目维护人员文档
本目录存放维护人员与自动化代理相关资料，主要用于项目运维，不属于对外公开的用户文档。
docs/plans/：实施方案与阶段记录。当前主线MCP化改造方案-2026-10-19.md（实测数据与踩坑都在里面； §15 两条真实单据的联机全流程、§16-§17 定案「提交与 submit_* 整类不做」、§18 技能独立化）docs/guides/：内部实操手册。项目架构全景图.md写的是改造前架构（顶部有过时标注），现状看src/README.md；工程实践指南.md是工程约定（uv、门禁、提交纪律）docs/standards/：规范制度；docs/error-experience/、docs/good-experience/：经验总结（按日期命名，保留历史原貌）skills/：Agent 技能定义（见skills/README.md）
对外用户文档统一放 docs/（工具契约是 docs/MCP.md）。
已作废并删除：
docs/guides/系统事件流全景图.md（SSE 与 file_events/agent_events 通道已随 Web/Agent 一起移除， 现在没有任何长连接事件流；需要看历史内容用 git 提交2f08bbd^）。