Files
Auto-Finance/.agents/docs
wandering 2e2519632a docs+chore: 定案——提交永远由人类执行,删掉 submit_execute 的全部规划
用户明确否决代提交工具。这不是「还没做」,是能力边界,所以凡是把它写成「待实现」的地方都改了,
免得以后有人以为补个实现就齐活。

- server.py INSTRUCTIONS 改成硬约束:本项目不提供也不计划提供点提交的工具;删除(#delete)、
  撤回同理。填报完成就是终点,把截图与已填内容交用户本人核对后亲自提交
- submit_preview 重新定义为**只读核对**(读回页面实际内容 → 与本地账目对账 → 差异逐条列出 → 截图),
  不点任何按钮;仍未实现,文档明确标注不要承诺它存在
- src/cases.py 删掉 submitted 阶段与 meta.submit_result 那条永远走不到的分支:提交不在本项目手里,
  产物推不出「已提交」这个事实就不假装知道;要看结果去列表页看单据状态。previewed 保留
  (它对应真会落盘的只读产物 submit_preview.json)
- 文案:browser.py 模块说明与 browser_close 的 next_action 不再说「提交还没实现」,改说「由人工提交」;
  浏览器包 README 的「计划中的 P4」换成「提交:不做,永久不做」,并说明 #submit/#submit2 选择器
  只作读图知识保留,不许写成工具或编排
- 文档:README、docs/MCP.md(新增「提交:不做,永久不做」一节)、操作指南(数据流标注到此为止、
  提交小节标明工具不提供该动作)、SKILL 的提交段改为永久约束;方案文档 §16 记录定案与理由,
  并把早期把 submit_execute 列为待办的 4 处改为删除线 + 指向 §16

验证:pytest 148 passed;ruff / format --check / mypy src / deptry 全绿;mcp_smoke 25 工具,
INSTRUCTIONS 2224 字节。--no-verify 提交并手跑等价检查。
2026-10-20 21:00:48 +08:00
..
2026-06-09 16:25:20 +08:00

项目维护人员文档

本目录存放维护人员与自动化代理相关资料,主要用于项目运维,不属于对外公开的用户文档。

  • docs/plans/:实施方案与阶段记录(当前主线是 MCP化改造方案-2026-10-19.md,含实测数据与踩坑)
  • docs/guides/:内部实操手册(项目架构全景图.md 已标注改造前的结构,以方案文档为准)
  • 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^)。