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(策略):主人给代理的规则文件,决定哪些动词可以自动、哪些必须问人、什么时候可以打扰。
不写进规范的东西¶
邮件怎么读、表单怎么填、微信怎么回、模型怎么选、界面长什么样。这些属于某一方代理的内部实现,各写各的。