跳到主要内容

互操作性

QZX Result Contract v1:让软件可以验证结果

代理不应该从一句自然语言中猜测这次操作是成功、部分失败还是只返回了数据。Result Contract v1 为 QZX 和兼容实现定义一个小而可预测的 JSON 结构。

只为人设计的终端输出有局限

终端文本对人很方便,但如果数据、解释和错误混在一起,自动化就必须再次解析文字。结构化契约把这些职责分开。

  • 明确的成功状态。
  • 人类消息与机器判断分离。
  • 可供程序消费的数据。
  • 可预测的错误与元数据。

从设计上可验证

公开规范包含 JSON Schema 和一致性材料。MCP 配置展示 structuredContent、outputSchema 与同一结构化目标之间可以如何衔接,而不宣称 QZX 已成为行业标准。

不必采用整套 CLI 才能采用契约

如果独立实现能够单独实现并验证这个契约,它才真正具有互操作价值。使用 schema、运行验证器,并报告可复现差异。