wandering
5903dae864
用户第 3 条：等额发票被贪心配错时只能靠 remark 记一笔，下游 CSV / invoice_groups.json 仍是错的。
- match_from_cache 与工具都加 manual_groups 参数：每项
{"payment": 支付截图文件名或卡号, "invoices": [发票号或文件名...], "note": "..."}
- 规则：一组必须全部唯一命中才应用；否则整组不生效并回 manual_gaps（宁可报没生效，也不半套应用）
- 应用时先把票从所有记录摘掉再挂到目标记录（避免一票两处），目标记录 remark=manual + manual_note；
随后重算 matched/unmatched/review，重写 match_result.json、payment_records.csv、invoice_summary.csv、
invoice_groups.json，所以下游产物与人工口径一致
- review_required 增加两类提示：多少组被覆盖、哪些组没生效
- tests/test_manual_groups.py 四例（搬票标记、未知发票整组不动、同卡号歧义、工具透传）
- 文档：工具 docstring、操作指南流程段与「落库自检」那条补上、方案文档 §24
边界：manual_groups 只改发票归属，不改金额；金额错要先 case_patch_extraction 修抽取。
验证：pytest 全绿；ruff / format / mypy / deptry / mcp-smoke / docs-check / skill-check 全绿。--no-verify 提交。
last_reviewed
| last_reviewed |
|---|
| 2026-10-20 |
docs — 公开文档目录
本目录存放面向项目用户和外部贡献者的公开文档。
文档清单
| 文件 | 说明 |
|---|---|
MCP.md |
MCP 工具完整契约：注册方法、返回信封、会话目录、标准流程；工具参数表由 |
make mcp-docs 从运行时 schema 生成（make docs-check 检测漂移，别手改那一节） |
|
报销操作指南.md |
面向最终用户的报销口径与材料准备说明 |
旧的
API.md（Flask 路由/SSE 文档）已随 Web 界面删除；需要历史接口形态时看 git 提交b2d271c。
文档边界
维护规范、实施方案、经验总结等内部资料统一放在 .agents/；宿主 Agent 的报销操作纪律在
.agents/skills/reimbursement/SKILL.md。