Claude Financial Services 入门：公开插件提供了什么
Financial Services 源码：交接解析器为何拒绝嵌套 JSON
离线执行 extract_handoff，验证参考正则在普通嵌套载荷上发生的解析失败。
你将学会
- 定位真正的提取分支
- 离线测试实际证明了什么
- 扩展路由之前先修好消息协议
开始前需要
- 基本命令行与 JSON 阅读能力
- 包含虚构财务资料的独立工作区
用离线样例把交接请求变成可审阅记录，不让文档直接控制路由。
先看结论
- 失败发生在模式校验之前。
- 测试只执行提取出的解析函数。
- 真实事件路由尚未测试。
定位真正的提取分支
提交 574ed36 的 HANDOFF_RE 从 handoff_request 开头以非贪婪方式匹配到下一个右花括号。extract_handoff 先把这个片段交给 json.loads，之后才检查目标白名单与载荷模式。
普通消息的外层对象中还有一个 payload 对象。第一个右花括号结束的是 payload，外层对象仍未闭合，因此 JSON 解码失败并返回 None，这个样例根本没有进入后续校验。
离线测试实际证明了什么
我们把已读源码中的常量赋值和 extract_handoff 函数提取到离线 Python 命名空间，没有执行 SDK 导入或事件循环。普通文本、允许目标的嵌套载荷、未知目标这三个样例均返回 None。
模式校验替身一旦被调用就会报错，而这些样例都没有触发它。测试证明的是给定字符串的提取失败，没有验证 jsonschema、托管代理 API、流式分片或完整线上服务。
扩展路由之前先修好消息协议
更可靠的替代实现应解析完整的类型化事件，而不是在任意自然语言中寻找花括号片段。如果确实只能使用文本传输，需要定义消息边界，并处理嵌套 JSON、转义字符与多条消息。
验收至少应包含正确嵌套载荷、格式损坏、禁止的目标、额外字段和跨分片消息。替代代码通过一个成功样例，还不足以把整条参考编排路径标为生产可用。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
打开固定提交的 scripts/orchestrate.py。
- 2
比较正则匹配片段与完整输入。
- 3
采用路由前补齐消息边界及反例测试。
可复制示例
{"type":"handoff_request","target_agent":"gl-reconciler","payload":{"event":"review synthetic discrepancy"}}常见问题
是否在真实服务中复现了故障？
没有。结论仅限于已审阅的参考函数和三个离线字符串样例。
把正则匹配范围加长就能解决吗？
长度不能定义 JSON 层次或流式边界，需要合适的解析器与消息协议。
资料来源
- Financial Services / scripts/orchestrate.py来源核查 2026-09-23
- Financial Services / scripts/validate.py来源核查 2026-09-23