产品架构
供需两端采用不对称运行模型。
需求入口宿主智能体
Hermes、OpenClaw、企业智能体负责对话、记忆、自然语言和宿主侧批准。
↓ 采购意图 / 授权范围
买家侧Kiwi 买家连接器
统一的意图、权限、任务、询价、磋商、协议和成交交接核心；MCP、HTTP 与插件只是薄包装。
↓ 商家发现与 A2A 直连
发现层Kiwi 商家发现网络
保存商家身份、验证、新鲜度、区域、商品能力与公开端点；不成为消息中转和商品真相源。
↓ 询价单 / 报价 / 条件磋商
供给侧Kiwi 商家运行时
独立持有商品事实、报价政策、询价队列、人工审批、协议、审计和恢复。外部宿主与推理模型均可拔插。
组件归属
三仓各自拥有一种权威。
| 仓库 / 产品 | 负责什么 | 不负责什么 |
|---|---|---|
kiwi | 买家核心、A2A/KNP、授权、任务、协议、交接与宿主适配 | 不拥有商家商品真相，不执行支付和订单 |
kiwi-catalog | 商家身份、验证、新鲜度、商品能力索引和路由 | 不中转磋商消息，不主动抓取商家 ERP |
shopping-cli | 商品、价格、库存、配送、报价政策与商家运营事实 | 不拥有买家预算、宿主记忆或支付权限 |
协议边界
标准商业能力用 UCP，跨商家询价与磋商用 KNP。
A2A智能体发现、消息与任务承载
KNP询价、报价、还价、澄清与非绑定协议
KTH把协议安全交接到外部成交入口
UCP商品目录、购物车、结账与订单等标准商业原语
KNP 的三个副作用恒为否：不创建订单、不授权支付、不预留库存。
源码与接入
从公开仓库开始。
Kiwi 运行时TypeScript · Apache-2.0
买家核心、协议、商家运行时、MCP 与宿主适配。
Kiwi 商家发现网络Python · Apache-2.0验证、索引、路由与商家账户。
商家商品事实引擎Python · Apache-2.0商品、库存、政策、询价队列与适配器。
# Kiwi 运行时
git clone https://github.com/harrylabsj/kiwi
cd kiwi
npm install
npm run verify
# 商家发现网络
git clone https://github.com/harrylabsj/kiwi-catalog
cd kiwi-catalog
uv sync --locked --extra api --extra dev
# 商家商品事实引擎
git clone https://github.com/harrylabsj/shopping-cli
cd shopping-cli
uv sync --locked --extra api --extra dev产品状态
技术能力已具备，欢迎接入 Kiwi。
买家接入
Hermes、OpenClaw 和 MCP 宿主可接入跨商家发现、询价、磋商与成交交接。
商家接入
独立运行的商家运行时可连接商品、库存、报价政策和企业成交入口。
产品边界
Kiwi 不自动创建订单、不授权支付，也不把非绑定协议假装成真实成交。
协议语义以仓库中的 spec/、机器可读契约和一致性向量为准；市场页面只解释产品，不替代规范。