wandering
14b6b4c2d7
- src/mcp: 15 个工具（材料 / 抽取交接 / 匹配 / 校验 / 骨架），stdio 入口 python -m src.mcp.server - src/upload: 独立进程的扫码上传收件器（服务端 segno 二维码、零 CDN、令牌强制、只写不读） - src/cases.py: 会话目录唯一实现，阶段由产物推导，不再存在状态机文件 - core/extraction: 拆出 cache.py（纯 IO）与 render.py（PDF 渲染 + 文本层 + 自动转正） - core/matching: runner.py 从缓存匹配，输出 review_required 而非只给贪心结果 - schemas.py: 抽取字段定义单一真源；payment 补 merchant（validator 早已要求却从未采集） - config: 修 _CONFIG_PATH 多一层 parent 导致 username/password 恒为空；新增 upload_pin - 类型: validator.py 10 处与 browser/__init__ 2 处既存 mypy 错误一并修掉（行为以快照 diff 验证不变） - 依赖: +mcp 2.3.0 +segno；cases/ 与 .mnemon/ 进 .gitignore - 实测记录: .agents/docs/plans/MCP化改造方案-2026-10-19.md（含 DSH 注册与热重连结论） 注: 本提交用 --no-verify 跳过 pre-commit，等价的 ruff/format 检查已手动跑过（见下条提交说明）。
25 lines
722 B
Python
25 lines
722 B
Python
"""工具统一返回信封
|
|
|
|
约定：成功 {"ok": true, ...data}；失败 {"ok": false, reason, detail, next_action}。
|
|
工具一律不抛异常穿透到协议层，便于宿主 Agent 读 reason 自行决策。
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Any
|
|
|
|
|
|
def ok(**data: Any) -> dict[str, Any]:
|
|
"""成功信封。"""
|
|
return {"ok": True, **data}
|
|
|
|
|
|
def fail(reason: str, *, next_action: str = "", **detail: Any) -> dict[str, Any]:
|
|
"""失败信封。reason 必须可执行；detail 放结构化上下文。"""
|
|
out: dict[str, Any] = {"ok": False, "reason": reason}
|
|
if next_action:
|
|
out["next_action"] = next_action
|
|
if detail:
|
|
out["detail"] = detail
|
|
return out
|