wandering
6e00ddc37e
接上一条定案继续收紧：用户不需要提交前预览（"我自己去系统就行了，也不需要给我看"）。 能力边界停在 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 提交并手跑等价检查。
last_reviewed
| last_reviewed |
|---|
| 2026-10-19 |
src — 源码
MCP 服务器的全部实现：工具层在上，确定性内核在下，infra 是被调用的手。
src/
├── mcp/ 工具与协议层（25 个工具，stdio）
│ ├── server.py INSTRUCTIONS + TOOLS 注册 + build_server()
│ ├── tools/ materials 材料 / extraction 抽取交接 / analysis 匹配校验 / documents 产物
│ ├── schemas.py 抽取字段定义单一真源 + 日期金额规范化
│ └── envelope.py ok/fail 统一信封（工具不把异常抛穿协议）
├── cases.py 会话目录 cases/<id>/ 唯一实现：材料·收件箱·产物·阶段推导·上传令牌
├── upload/ 扫码上传收件器（独立进程，Flask + segno）
├── core/ 确定性内核：extraction matching validation
├── infra/ browser · documents · com_thread
├── config.py scripts/data/config.json + 环境变量
├── exceptions.py 异常层次
└── __init__.py get_logger（终端 + logs/<日期>.log）
依赖方向
mcp 依赖 core/infra/cases；core 不依赖 infra 与任何框架；infra 不依赖 mcp。
cases.py 只依赖标准库，是会话目录布局的唯一真相：想知道产物叫什么，读它，别猜。
分层原则
- 判断在上，事实在下：读图、综合、决定交给宿主 Agent；本项目只做渲染、匹配、校验、生成
- 无状态：阶段从磁盘产物推导，进程随时可杀可重启
- 不承诺未完成的事：INSTRUCTIONS 只列已注册工具，
browser_*与submit_*尚未实现