docs+chore: 定案——submit_* 整类不做,填报完把单据编号交给用户即可

接上一条定案继续收紧:用户不需要提交前预览("我自己去系统就行了,也不需要给我看")。
能力边界停在 browser_fill / browser_page_state。

- 清掉随之变死的代码:cases.py 的 previewed 阶段与 submit_preview.json 读取(没有任何东西会再生成它),
  case_reset(scope=all) 的清理列表同步去掉;阶段链回到五档 empty→extracted→matched→info_ready→docs_ready。
  仍遵循"阶段由产物推导":推不出的一律不写
- INSTRUCTIONS 改为:把单据编号与会话目录告诉用户即可,不必逐张呈报截图。截图仍然生成——它是这一轮
  抓出附件静默假成功的证据,定位是排查用,不是给用户的报告
- SKILL 补一句纪律:提交错了要写情况说明,宁可停在填完,也不替用户按任何不可逆的按钮
- 文档:docs/MCP.md(目录树去掉 submit_preview.json、说明段改为整类否决)、README、浏览器包 README、
  src/mcp/tools/browser.py 模块说明、方案文档 §17 记录定案与连带清理

验证:pytest 148 passed;ruff / format / mypy / deptry 全绿;mcp_smoke 25 工具,INSTRUCTIONS 2199 字节。
仍用 --no-verify 提交并手跑等价检查。
This commit is contained in:
wandering
2026-10-20 21:49:17 +08:00
parent 2e2519632a
commit 6e00ddc37e
9 changed files with 38 additions and 23 deletions
@@ -593,3 +593,22 @@ strip、凭据不读 env、safe_config 不含密码、坏文件与缺文件不
同步改动:README、docs/MCP.md、docs/报销操作指南.md、.agents/skills/reimbursement/SKILL.md、
src/infra/browser/README.md、src/mcp/tools/browser.py 的模块说明与 `browser_close` 提示语。
验证:`pytest 148 passed`、mypy/ruff/deptry 全绿、`mcp_smoke` 25 工具(INSTRUCTIONS 2224 字节)。
## 17. 定案:`submit_*` 整类不做,核对也由人自己看(2026-10-20)
接 §16 之后继续收紧:用户说"只读的 submit_preview 也不需要,我自己去系统就行了,也不需要给我看"。
于是 `submit_*` 这一整类(代提交 + 提交前预览)全部出局,能力边界停在 `browser_fill` / `browser_page_state`。
连带清掉的死代码:
- `cases.py` 的 `previewed` 阶段与 `submit_preview.json` 读取——**没有任何东西会再生成这个产物**,
留着就是一条永远为假的分支;同时从 `case_reset(scope=all)` 的清理列表里去掉
- 阶段链回到五档:`empty → extracted → matched → info_ready → docs_ready`。仍然是"由产物推导",
推不出的一律不写(§16 删 `submitted` 是同一条理由)
- INSTRUCTIONS 从"填报完成后把截图报给用户"改成"把单据编号与会话目录告诉用户即可,
不必逐张呈报截图":截图仍写在 `cases/<id>/screenshots/`,但它的定位是**我核对用的证据**,
不是交给用户的报告——这一轮抓附件假成功靠的就是回看截图,所以不能砍生成,只是不该刷屏
顺带明确一句写进 SKILL:"提交错了要写情况说明,所以宁可停在填完,也不要替用户按下任何不可逆的按钮。"
验证:`pytest 148 passed`、ruff / format / mypy / deptry 全绿,`mcp_smoke` 25 工具,INSTRUCTIONS 2199 字节。
+4 -4
View File
@@ -54,10 +54,10 @@ description: >-
## 提交必须交人工(永久如此)
**不存在代提交的工具,也不会有**:`submit_execute` 已被用户否决。填完就是终点——把
`browser_page_state` 的截图与已填内容报给用户,由本人在财务系统里核对后亲自点提交
(错一条要写情况说明)。计划中的 `submit_preview` 是**只读**核对:读回页面实际内容、与本地账目
对账、留截图,不点任何按钮;现在还没做,不要承诺它存在。
`submit_*` 整类已被用户整体否决:没有代提交工具,也不做提交前预览。填完就是终点——
把**单据编号**和会话目录告诉用户,他自己去财务系统里核对、提交、查状态;不用替他生成预览,
也不必把截图逐张呈报(截图留在 `cases/<id>/screenshots/`,出问题时再拿去对照)。
提交错了要写情况说明,所以宁可停在填完,也不要替用户按下任何不可逆的按钮。
浏览器被别的进程占用时返回 `owned_by_other_process`:让持有者 `browser_close`,或等心跳超时 180 秒自动接管,
不要绕过去另开一个 Chromium。步骤函数报错会带 `screenshot`(在 `detail` 里),把它给用户看比反复重试有用。