wandering
94c2f4c94e
用户第 4 条：交通费行的日期由页面按出差起止自动带出，cost=1 分支不填日期，于是「6-02 出发、 6-05 才坐车」这种情况报销日期是错的。要按乘车日必须先知道控件 id，所以做了一次联机探测： 登录 → new_form(travel) → fill(basic) 落草稿 → actor 里打开明细、点 #insertDetail、选 cost=1、 dump 可见 input → 截图；探完按守卫删草稿（唯一命中+未提交+当日制单，bill_no 202610030261，复查 0 命中）。 探测结果：交通费行日期控件 #ksrq（expenPwTraveldetail.STARTDATE）/ #jsrq（OVERDATE）， 页面已按出差起止预填（实测 2026-06-02 → 06-04）。 - add_travel_items 的 cost=1 分支用 transport_fee[].start_date/end_date 覆盖 #ksrq/#jsrq - 缺日期时保留页面带出的值并 log.warning，不静默按出差起止报销 - tests/test_travel_dates.py 两例：有乘车日则覆盖、缺日期不覆盖 - 文档：AGENTS 记下控件名与口径、操作指南 7.2 补一句、方案文档 §25 记探测方法与结论（含可复用的探测套路） 验证：pytest 全绿；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^）。