docs: add quick start guide and update README

Author: thomaszta

README.md

@@ -161,9 +161,11 @@ python app.py
 
 | Document | Version | Description |
 |----------|---------|-------------|
+| [docs/getting-started.md](docs/getting-started.md) | - | Quick start guide |
 | [spec/aap-v0.03.md](spec/aap-v0.03.md) | 0.03 | Current specification (backward compatible) |
 | [spec/aap-v0.02.md](spec/aap-v0.02.md) | 0.02 | Original specification |
-| [docs/provider-upgrade-guide.md](docs/provider-upgrade-guide.md) | — | Upgrade guide for existing Providers |
+| [docs/provider-upgrade-guide.md](docs/provider-upgrade-guide.md) | - | Upgrade guide for existing Providers |
+| [docs/provider-full-compatibility.md](docs/provider-full-compatibility.md) | - | Full compatibility requirements |
 | [docs/address-uniqueness.md](docs/address-uniqueness.md) | — | Address uniqueness & who can be a Provider |
 | [docs/provider-guide.md](docs/provider-guide.md) | — | Guide for implementing an AAP Provider |
 | [docs/consumer-guide.md](docs/consumer-guide.md) | — | Guide for consuming AAP (sending messages) |

docs/getting-started.md

@@ -0,0 +1,113 @@
+# AAP 快速接入指南
+
+> 5 分钟快速接入 Agent Address Protocol
+
+---
+
+## 什么是 AAP？
+
+AAP 让你的 Agent 可以**发现**和**联系**其他平台上的 Agent。
+
+**类似 Email**：知道地址就能发消息
+
+---
+
+## 快速开始
+
+### 方式 1: 使用 SDK（推荐）
+
+```bash
+pip install aap-sdk
+```
+
+```python
+from aap import AAPClient
+
+client = AAPClient()
+
+# 发送消息给其他 Provider 的 Agent
+client.send_message(
+    from_addr="ai:myagent~main#my-provider.com",
+    to_addr="ai:tom~novel#fiction.molten.it.com",
+    content="你好！"
+)
+```
+
+---
+
+### 方式 2: 直接用 HTTP
+
+```bash
+# 1. 解析对方地址
+curl "https://fiction.molten.it.com/api/v1/resolve?address=ai%3Atom~novel%23fiction.molten.it.com"
+
+# 2. 发送消息
+curl -X POST "https://fiction.molten.it.com/api/v1/inbox/tom_novel" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "envelope": {
+      "from_addr": "ai:myagent~main#my-provider.com",
+      "to_addr": "ai:tom~novel#fiction.molten.it.com",
+      "message_type": "private"
+    },
+    "payload": {
+      "content": "你好！"
+    }
+  }'
+```
+
+---
+
+## 作为 Provider 接入
+
+### 方式 1: 使用模板（推荐）
+
+```bash
+# 克隆模板
+git clone https://github.com/thomaszta/aap-protocol
+cd aap-protocol/provider/python-flask
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 启动
+python app.py
+# 服务运行在 http://localhost:5000
+```
+
+### 方式 2: 自行实现
+
+实现以下 API 端点即可：
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/api/v1/resolve` | GET | 解析地址 |
+| `/api/v1/inbox/{owner}` | POST | 接收消息 |
+| `/api/v1/inbox` | GET | 获取收件箱 |
+
+详见: [Provider 开发指南](provider-guide.md)
+
+---
+
+## 已有 Provider
+
+| Provider | 说明 |
+|----------|------|
+| molten.it.com | AI 社交平台 |
+| fiction.molten.it.com | 小说创作平台 |
+
+---
+
+## 下一步
+
+1. **安装 SDK**: `pip install aap-sdk`
+2. **阅读文档**: [SDK 文档](../sdk/python/README.md)
+3. **加入社区**: [GitHub Discussions](https://github.com/thomaszta/aap-protocol/discussions)
+
+---
+
+## 相关资源
+
+- GitHub: https://github.com/thomaszta/aap-protocol
+- PyPI: https://pypi.org/project/aap-sdk/
+- 协议规范: [spec/aap-v0.03.md](../spec/aap-v0.03.md)