docs: 文档全面对齐 MCP 架构，并脱敏公开操作指南

接口与入门：
- 新增 docs/MCP.md：注册方法（DSH patch + 通用 client）、返回信封、会话目录布局、标准流程、
  硬约束与未实现清单；工具参考段由**运行时 input_schema 自动生成**，与代码同源不会漂移
- 删除 docs/API.md（856 行 Flask 路由/SSE 文档，描述的端点已不存在）
- 重写根 README.md：为什么放弃自带前端、职责分工表、快速开始、注册配置、流程链、结构与风险
- 重写 AGENTS.md：命令表换成 mcp/mcp-smoke/upload；mypy 目标改 src；新增「提交纪律」
  （pre-commit 的 stash 窗口会回滚未暂存改动）、COM 与 Playwright 线程约束、多进程共存提醒

包文档：src/README.md 与各包 README 按现状重写；新增 src/mcp/README.md（写工具的规矩、
宿主侧四个坑）与 src/upload/README.md（路由表与安全边界）；tests/scripts/config 三处索引更新。

提示词迁移：src/infra/llm/ 整个删除，三份系统提示词迁到 .agents/skills/reimbursement/references/
（invoice-fields / travel-info-fields / normal-info-fields），删掉 can_submit 与 suggestion
（save_info 也会主动剥离），「严格只输出 JSON」改为「交给对应工具落盘」；新增 SKILL.md 作为
宿主侧操作纪律（已被 DSH 热加载为 reimbursement 技能）。

作废处理：删除 .agents/docs/guides/系统事件流全景图.md（SSE 与 file_events/agent_events 通道已整体
移除，现在没有任何事件流）；给项目架构全景图与架构分析-2026-06-15 加「已过时」横幅保留历史；
config.example.json 去 consumable_storage 加 upload_pin；.env.example 去 LLM 段并说明已不再自动加载 .env。

安全：docs/报销操作指南.md 的示例配置里原来写着**真实姓名、16 位公务卡号、内网 LLM 地址与工号**
（自 9fe5d70/2026-05-25 起在版本历史里），本次全部换成占位符。历史清洗与令牌轮换另议。

门禁（改动含 src/infra/llm 删除，故重跑全部门禁）：
  ruff check PASS | ruff format --check PASS(42) | mypy src PASS(34) | deptry PASS(36) |
  pytest 107 passed | scripts/mcp_smoke.py PASS（17 工具 / instructions 1449 字节 / case_list ok）
申购单在依赖清理后另已实机复测：2.4s 生成，产物单元格读回正确。

src/infra/browser/README.md

@@ -1,44 +1,27 @@
 ---
-last_reviewed: 2026-06-15
+last_reviewed: 2026-10-19
 ---
 
 # src/infra/browser — 浏览器自动化
 
-使用 Playwright 操作财务报销系统，自动完成登录、填单、上传附件等操作。
-
-## 文件
+Playwright 操作财务报销系统：登录信息门户、进入报销系统、新建单据、填单、上传附件。
 
 | 文件 | 职责 |
 |------|------|
-| `base.py` | `BaseBot` 基类：浏览器生命周期、登录信息门户、导航到报销系统、创建新单据、截图 |
-| `travel.py` | 差旅报销填报流程：基本信息 → 差旅明细 → 支付方式 → 补助清单 → 附件上传 |
-| `normal.py` | 普通报销填报流程：基本信息 → 总明细 → 支付方式 → 附件上传 |
-| `__init__.py` | 入口函数：`run_bot()` / `run_bot_web()`，负责类型路由和流程调度 |
+| `base.py` | `BaseBot`：浏览器生命周期、登录、导航、新建单据、截图（默认**有头**模式） |
+| `travel.py` | 差旅填报：基本信息 → 差旅明细 → 支付方式 → 补助清单 → 附件 |
+| `normal.py` | 普通填报：基本信息 → 总明细 → 支付方式 → 附件 |
+| `__init__.py` | `run_bot(config, travel_info, normal_info)`；`run_bot_web(config, work_dir)` 从会话缓存加载后执行 |
 
-## 对外接口
+## 现状与计划
 
-| 函数 | 说明 |
-|------|------|
-| `run_bot(config, travel_info, normal_info)` | CLI 模式：根据传入信息判断差旅/普通报销 |
-| `run_bot_web(config, work_dir)` | Web 模式：从缓存加载信息后执行填报 |
+现有入口是**一次性跑完**的编排函数，适合手工验证，不适合 Agent 分步介入：中途出错只能整体重来，
+也没法在填到一半时先看一眼。P3 计划拆成 `browser_open / login / new_form / fill(step) / page_state / close`
+分步工具，过程截图进 `cases/<id>/screenshots/NNN-<step>.png`，并用 `.browser.lock`（PID + 心跳）防止多代进程
+抢同一个浏览器；P4 再加提交前预览与一次性 token 护栏（提交不可逆）。
 
-## 填报流程
+## 注意
 
-### 差旅报销（travel）
-1. 填写基本信息（事由、地点、日期、项目编号）
-2. 添加差旅明细（交通费用逐条录入）
-3. 填写支付方式（公务卡刷卡记录）
-4. 填写补助清单（按天计算交通补助 + 伙食补助）
-5. 上传附件（发票、申请单等）
-
-### 普通报销（normal）
-1. 填写基本信息（报销事由、金额）
-2. 填写发票明细（总数、总金额）
-3. 填写支付方式
-4. 上传附件
-
-## 注意事项
-
-- 浏览器填报会启动 Chromium，请勿手动干扰自动化流程
-- 调试截图保存在 `images/` 目录
-- Web 模式以无头模式运行
+- 会打开 Chromium，自动化期间不要手动点页面
+- 调试截图落在 `images/`（已 gitignore，不进仓库）
+- 步骤函数最好返回「填了什么 / 什么失败」的结构，P3 可直接复用