Agent Native Trade

让机器自己找到它需要的东西。

不只生成代码，也不只替人点击网页。让模型发现需求、寻找交易方、协商条件、签署合同，并推动现实世界完成履约。

一台拖拉机到了保养周期，可以自己检索附近服务商并预约维护；一家下游工厂发现螺丝库存不足，可以直接向上游工厂获取目录、询价和下单；一台设备发现零件损坏，可以描述故障、寻找替换件，并把付款、取货或安装交给具备相应权限的人类或服务商。

语言模型的能力不应该被关在代码编辑器和聊天框里。它们已经能够理解需求、调用工具、持续协商和组织工作；真正缺少的，是一套以模型为主体、对模型开放、任何人都能实现和接入的交易基础设施。

Agent Native Trade 为此提供开放协议与参考实现：商品目录可以分布式发布，索引站只负责发现，交易双方通过邮件等开放通道直接联系；合同、履约事件与评价以可签名对象流转；支付、物流、担保和人工动作由交易双方根据自己拥有的资源协商完成。

我们想做的不是另一个中心化商城，而是机器经济开始交易时，可以共同使用的 HTTP、SMTP 与 BitTorrent。

以模型为主体的开放交易闭环协议 · 参考实现（Apache-2.0）。

入口文档：

• AGENT_SETUP.md — 给模型的接入说明：模型自行安装、配置和验证，只向人类索取不可自动取得的账号/授权
• packages/dsh-plugin/ — 可由 dsh plugin 安装的标准 DSH bundle
• protocol/specification.md — 仓库内协议规范；冲突处以 Schema 与测试向量为准
• docs/agent-contact-runtime-email-selection-v0.1.md — 联系方式、邮件服务、NAT 收件自触发与开箱安装选型（面向 2026-09）

本仓库权威源：protocol/test-vectors/。任何实现通过测试向量互验即为合规实现。

当前已经跑通

项目已经不只是协议和 Schema：参考实现现可完成目录发布/索引、模型检索、邮件首触、事件驱动收件、按需读取与回复、合同双签、履约事件和评价回执。

Publisher / Integrator → Catalog + contact_refs → Indexer → Buyer
                                                        │
Buyer / Seller ← DSH contact bridge ← WakeTask queue ← trade-inboxd ← Email
      │
      └→ DEAL 双签 → Settlement / HumanTask → TRADE_RECEIPT → Indexer

这里保持三个边界：协议对象不依赖客户端；trade-inboxd 负责长连接和可靠入队；DSH 只在需要时读取正文、回复并确认 WakeTask。邮件正文和附件始终是不可信数据。

公共演示索引站

• deepcrop.site — 当前互操作测试使用的社区公共索引站。

该站点是可选发现入口，不是协议权威或运行依赖，也不承诺生产级 SLA。模型和客户端仍需验证目录、合同与回执的签名，并按自己的信任策略决定是否采纳索引结果；任何实现都可以运行自己的索引站。

如果你是接入模型：先读 AGENT_SETUP.md，自行检查环境并完成能自动完成的步骤。只有邮箱账号、API Key、外部授权或现实动作确实缺失时才引导人类；不要把命令清单原样转交给人类。

协议向量快速校验

node tools/generate-test-vectors.mjs     # 生成/再生成测试向量
node tools/verify-test-vectors.mjs       # 用 node:crypto 验证全部向量
bash tools/verify-vectors-openssl.sh     # 用 OpenSSL 交叉验签（第二实现）

模块状态（2026-08-24）

模块	状态	测试
M0 protocol（schemas + test-vectors）	✅	三实现互验（node:crypto / OpenSSL / PyNaCl）
M1 identity	✅	18/18
M2 signed-files	✅	25/25
M3 local-store	✅	20/20（含 TOFU 公钥信任环：.data/peers/）
M4 bt-catalog	✅	21/21（DHT 验收为手动脚本）
M5 email	✅	47 单元 + GreenMail 集成（CI）
M6 settlement	✅	12/12
M7 human-task	✅	23/23
M8 demo-indexer	✅	30/30
M9 mcp-server	✅	28/28（含 stdio 冒烟 + 12 红线）
M10 DSH 集成	✅	28/28 单测 + 最小链路 9 步演示 + contact bridge 6 步演示 + 双 preset 挂载校验 + 会话内往返
M11 棉花娃娃端到端	✅	106 断言全绿（run-demo.sh）
Contact core	✅ 首批实现	10/10（联系解析 + WakeTask + 文件队列）
AgentMail contact adapter	✅ 首批实现	7/7（REST + 响应限额 + WebSocket 兼容包络）
trade-inboxd	✅ 首批实现	5/5（事件队列 + 可选本地命令触发）
DSH contact bridge	✅ 首批实现	5 新工具（wake list/ack + message get/reply/send，共 23 工具）+ 6 步演示 16 断言

M10 快速开始（DSH 标准 bundle）

普通用户不需要克隆或构建整个仓库。把预构建 bundle 安装进正在使用的 profile：

dsh plugin --profile web add \
  https://github.com/liwuzhan/agent-native-trade/releases/latest/download/agent-trade-dsh-plugin.tgz
dsh --profile web --dump-config

安装包声明 dsh.bundle，内含预构建 daemon、23 个交易/联系工具和一个紧凑的交易工作流 skill；不需要仓库路径、AGENT_TRADE_REPO、编译器或安装期构建授权。默认 provider maildrop 是无外网依赖的本地回环。接真实邮箱时设置 AGENT_TRADE_CONTACT_PROVIDER=agentmail、AGENTMAIL_API_KEY 与 AGENT_TRADE_CONTACT_INBOX_ID。

需要开发或验证旧 buyer/seller preset 时，再从源码执行：

…