From 3b321c9c753e8bad2e97b31c48e5df76f9fa2633 Mon Sep 17 00:00:00 2001
From: Chatwoot AI Agent Dev <dev@hanmolabiqiu.com>
Date: Fri, 5 Jun 2026 04:31:42 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E2=80=94=20add=20Platform=20G?=
 =?UTF-8?q?ateway=20section,=20architecture=20diagram,=20env=20vars?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 53c5c95..539591a 100644
--- a/README.md
+++ b/README.md
@@ -132,6 +132,33 @@ AI 使用 **User Session** 发消息（不让客户察觉是 AI），通过追
           加入 conv_id    conv_id 加入                 conv_id 被清理
 ```
 
+## Platform Gateway（电商平台 API 集成）
+
+WS Agent 内置 `gateway/` 库，在生成 AI prompt 前自动查询电商平台数据（商品价格、库存等），将结果注入上下文。
+
+### 支持的平台
+| 平台 | 协议 | 签名算法 |
+|------|------|---------|
+| Amazon | PA-API 5 | AWS4-HMAC-SHA256 |
+| 京东 | 联盟 API | MD5 |
+| 淘宝 | TOP API | MD5 |
+| 拼多多 | DDK API | MD5 |
+| 抖音 | 开放平台 | HMAC-SHA256 |
+
+### 6 种错误路径
+`no_creds`（静默降级）→ `error` / `timeout` / `rate_limited` / `breaker_open` → `success`
+
+### 配置
+```bash
+export GATEWAY_ENABLED=1                 # 默认开启，0=关闭
+export CHATHUB_DB_HOST=localhost         # MySQL 存储凭证
+export CHATHUB_DB_USER=root
+export CHATHUB_DB_PASS=your-password
+export GATEWAY_AES_KEY=32-byte-base64-key  # AES-256-GCM 加密凭证
+```
+
+详见 `gateway/ARCHITECTURE.md`。
+
 ## 快速开始
 
 ```bash