跳转至

DWP 规范

v0.1 草案

三章即三个部件,首字母互不相同:Deal、Wire、Policy。章节号按这个走。

章节

  • 00 约定(Conventions) 术语、身份、消息信封、编号与时间、错误、版本、扩展
  • D 事项(Deal) 事项结构、十个动词、状态转换、回执、归档
  • W 通道(Wire) 四个动作、最小 HTTP 绑定、A2A 绑定、错误与重试
  • P 策略(Policy) 策略文件格式、信任档、推送与打扰规则

已发布的章节出现在左侧目录;未发布的章节不给占位页面,避免读者把空页当规范。

规范 URI

  • 版本化路径:https://dwpspec.org/spec/dwp/v0.1
  • 单章:https://dwpspec.org/spec/dwp/v0.1/D-deal
  • 一经发布只做永久重定向,不改路径。 站点本身可以换,路径语义不变。

命名空间

  • DNS 记录前缀:_dwp.<domain>(端点)、_dwp-key.<domain>(可选签名公钥)
  • 卡片位置:/.well-known/dwp/agent-card.json
  • 消息端点:/dwp/v0.1/messages
  • 扩展标识:https://dwpspec.org/spec/dwp/v0.1/ext/<名字>

两条已写死的取舍

  • Deal 只结构化五件:对手方、时间点或时间窗、标的(自由文本+可选分类)、价格(区间或单价×数量)、附件哈希。其余自由附注。字段不扩张到交付物清单、变更规则、行业参数。
  • Wire 的最小语义是对端可被拉:任何实现都要能响应「给我该事项的新消息」。push 到回调只是优化,失败必须回落 pull。

版本规则

  • 小版本(v0.1 → v0.2):只加不改。新增字段必须可选,缺省行为写进正文。
  • 次版本(v0.1 → v1.0):可以改语义,但对端不声明支持就不许发。
  • 草案期(v0.x)不做兼容承诺,但每版必须留差异说明。

术语一次定义

规范里每个术语只在 00 约定 定义一次,其余章节引用不复述。三个词先说清:

  • Deal(事项):就某件事达成的一次往复,从开口到结案。不含对价含义——确认一个会议时间也是 Deal。
  • Wire(通道):两个代理之间传递 Deal 消息的路径。只管收发与可靠性,不管内容。
  • Policy(策略):主人给代理的规则文件,决定哪些动词可以自动、哪些必须问人、什么时候可以打扰。

不写进规范的东西

邮件怎么读、表单怎么填、微信怎么回、模型怎么选、界面长什么样。这些属于某一方代理的内部实现,各写各的。