@agentunion/kite 1.5.0 → 1.6.0

package/docs/05-/347/237/255/344/277/241/350/256/244/350/257/201/344/270/216/347/224/250/346/210/267/344/277/241/346/201/257/346/216/245/345/217/243/346/226/207/346/241/243.md

@@ -0,0 +1,507 @@
+# 短信认证与用户信息接口文档
+
+> 基础路径: `/api/auth/sms`
+> Content-Type: `application/json`
+> 版本: V3
+> 更新日期: 2026-03-07
+
+---
+
+## 目录
+
+1. [发送短信验证码](#1-发送短信验证码)
+2. [短信验证码登录](#2-短信验证码登录)
+3. [获取用户详细信息](#3-获取用户详细信息)
+
+---
+
+## 1. 发送短信验证码
+
+### 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 接口地址 | `POST /api/auth/sms/send` |
+| 是否需要认证 | 否 |
+| Content-Type | `application/json` |
+
+### 请求参数
+
+| 参数名 | 类型 | 必填 | 校验规则 | 默认值 | 说明 |
+|--------|------|------|----------|--------|------|
+| phone | String | 是 | 正则: `^1[3-9]\d{9}$` | - | 中国大陆手机号 |
+| codeType | String | 否 | 枚举值 | `"LOGIN"` | 验证码类型，可选: `LOGIN`、`REGISTER`、`RESET_PWD` |
+
+### 请求示例
+
+```json
+{
+  "phone": "13800138000",
+  "codeType": "LOGIN"
+}
+```
+
+### 成功响应
+
+```json
+{
+  "code": 200,
+  "msg": "验证码发送成功",
+  "data": null
+}
+```
+
+### 错误响应
+
+| code | msg | 触发条件 |
+|------|-----|----------|
+| 500 | 手机号不能为空 | phone 为空 |
+| 500 | 手机号格式不正确 | phone 不匹配正则 |
+| 500 | 发送过于频繁，请稍后再试 | 超出频率限制（1分钟内仅允许1次，1小时内最多5次） |
+| 500 | 短信发送失败，请稍后重试 | 阿里云短信服务调用失败 |
+
+### 业务逻辑
+
+1. 校验手机号格式
+2. 检查发送频率限制:
+   - **1分钟内最多1条** (Redis key: `sms:limit:{phone}:minute`, TTL=60s)
+   - **1小时内最多5条** (Redis key: `sms:limit:{phone}:hour`, TTL=3600s)
+3. 生成随机 **6位数字验证码**
+4. 存入数据库（status=0 未使用，过期时间=当前时间+30分钟）
+5. 存入 Redis（key: `sms:code:{phone}`, TTL=30分钟）
+6. 更新发送频率计数器
+7. 调用阿里云短信服务发送
+
+### Redis Key 说明
+
+| Key | 说明 | TTL |
+|-----|------|-----|
+| `sms:code:{phone}` | 验证码内容 | 30分钟 |
+| `sms:limit:{phone}:minute` | 每分钟发送计数 | 60秒 |
+| `sms:limit:{phone}:hour` | 每小时发送计数 | 1小时 |
+
+---
+
+## 2. 短信验证码登录
+
+### 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 接口地址 | `POST /api/auth/sms/login` |
+| 是否需要认证 | 否 |
+| Content-Type | `application/json` |
+
+### 请求参数
+
+| 参数名 | 类型 | 必填 | 校验规则 | 说明 |
+|--------|------|------|----------|------|
+| phone | String | 是 | 正则: `^1[3-9]\d{9}$` | 手机号 |
+| code | String | 是 | 正则: `^\d{6}$` | 6位数字验证码 |
+| inviteCode | String | 否 | - | 邀请码（新用户注册7天内有效） |
+| deviceId | String | 条件必填 | - | 设备ID（非WEB端必须提供） |
+| source | String | 否 | - | 来源标识，`"WEB"` 为网页端，其他值为客户端 |
+| password | String | 否 | - | 密码（可选，用于首次设置密码） |
+
+### 请求示例
+
+```json
+{
+  "phone": "13800138000",
+  "code": "123456",
+  "source": "WEB",
+  "inviteCode": "ABC123",
+  "deviceId": "device-uuid-xxxx",
+  "password": "MyPassword123"
+}
+```
+
+### 成功响应
+
+```json
+{
+  "code": 200,
+  "msg": "登录成功",
+  "data": {
+    "token": "eyJhbGciOiJIUzI1NiJ9...",
+    "userId": 12345,
+    "phone": "13800138000",
+    "nickName": "用户昵称",
+    "avatar": "https://example.com/avatar.jpg",
+    "isNewUser": false,
+    "inviteBound": false,
+    "userInfo": {
+      "userId": 12345,
+      "aid": "aid_xxxxxxxx",
+      "userName": "13800138000",
+      "nickName": "用户昵称",
+      "phone": "13800138000",
+      "avatar": "https://example.com/avatar.jpg",
+      "isProfileComplete": true,
+      "sig": "hmac_sha256_signature_string",
+      "ts": 1709800000
+    },
+    "accountInfo": {
+      "accountId": 98765,
+      "rechargeCount": 3,
+      "balance": 100.50,
+      "vipType": 1,
+      "vipTypeName": "Pro",
+      "vipExpireTime": "2026-12-31T23:59:59.000+0800",
+      "vipRemainingDays": 299,
+      "credits": 5000,
+      "creditsLimit": 10000,
+      "lastResetTime": "2026-03-01T00:00:00.000+0800",
+      "lastRecoveryTime": "2026-03-07T10:00:00.000+0800",
+      "creditsRecoveryRate": 50,
+      "lastAutoRecoveryTime": "2026-03-07T09:00:00.000+0800",
+      "creditsPackageSummary": {
+        "totalPackageCount": 5,
+        "chatbotCredits": 1000,
+        "codexCredits": 500,
+        "claudeCodeCredits": 2000,
+        "geminiCredits": 800,
+        "openclawCredits": 300,
+        "generalCredits": 400
+      }
+    }
+  }
+}
+```
+
+### 错误响应
+
+| code | msg | 触发条件 |
+|------|-----|----------|
+| 500 | 手机号不能为空 | phone 为空 |
+| 500 | 手机号格式不正确 | phone 格式错误 |
+| 500 | 验证码不能为空 | code 为空 |
+| 500 | 验证码格式不正确 | code 不是6位数字 |
+| 500 | 当前客户端版本过低，请前往https://www.evolai.cn升级新版本客户端 | 非WEB端且未提供 deviceId |
+| 500 | 验证码错误或已过期 | 验证码不匹配或已超过30分钟 |
+| 500 | 账号已被停用，请联系管理员 | 用户状态为停用(status=1) |
+
+### 业务逻辑
+
+#### 登录流程
+
+```
+请求 → 设备校验 → 验证码校验 → 查询/创建用户 → 状态检查 → 生成Token
+  → 密码设置 → 新用户判定 → 邀请处理 → 构建响应
+```
+
+**详细步骤:**
+
+1. **设备校验**: 非WEB端必须提供 `deviceId`，否则返回客户端版本过低错误
+2. **验证码校验**: 对比 Redis 中存储的验证码，校验通过后标记为已使用
+3. **用户查询/自动注册**: 通过手机号查询用户，若用户不存在则自动创建新用户（username=手机号, status=正常）
+4. **用户状态检查**: 若用户 status=1（停用），返回停用错误
+5. **生成JWT Token**: 创建 LoginUser 对象，生成 JWT Token
+6. **记录登录信息**: 更新用户最后登录IP、登录时间、设备ID
+7. **自动创建账户**: 新用户自动创建 EvolUserAccount（免费用户）
+8. **自动创建API Key**: 新用户自动创建 ModelGate API Key
+9. **密码设置**: 如请求中包含 password 且用户尚未设置密码，则设置密码
+10. **新用户判定**:
+    - `createTime` 为 null → 新用户
+    - `createTime` 在7天以内 → 新用户
+    - 超过7天 → 老用户
+11. **邀请码处理**（仅新用户 + 未被邀请过 + 提供了邀请码）:
+    - 异步生成用户自己的邀请码
+    - 同步绑定邀请关系，返回绑定结果 `inviteBound`
+12. **构建完整响应**: 调用 `buildUserInfoResponse()` 构建包含用户信息、账户信息、团队信息、网关信息的完整响应
+
+### 响应字段说明
+
+#### 顶层字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| token | String | JWT Token，用于后续接口认证 |
+| userId | Long | 用户ID |
+| phone | String | 手机号 |
+| nickName | String | 用户昵称（未设置为null） |
+| avatar | String | 头像URL |
+| isNewUser | Boolean | 是否为新注册用户（注册7天内） |
+| inviteBound | Boolean | 是否成功绑定邀请者 |
+| userInfo | Object | 用户基本信息（详见第3节 UserInfo） |
+| accountInfo | Object | 账户信息（详见第3节 AccountInfo） |
+
+---
+
+## 3. 获取用户详细信息
+
+### 基本信息
+
+| 项目 | 说明 |
+|------|------|
+| 接口地址 | `GET /api/auth/sms/userInfo` |
+| 是否需要认证 | **是**（Bearer Token） |
+| Content-Type | 无（GET 请求） |
+
+### 请求头
+
+| Header | 值 | 说明 |
+|--------|-----|------|
+| Authorization | `Bearer {token}` | 登录时返回的 JWT Token |
+
+### 请求参数
+
+无
+
+### 请求示例
+
+```
+GET /api/auth/sms/userInfo
+Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
+```
+
+### 成功响应
+
+```json
+{
+  "code": 200,
+  "msg": "获取成功",
+  "data": {
+    "token": null,
+    "userInfo": {
+      "userId": 12345,
+      "aid": "aid_xxxxxxxx",
+      "userName": "13800138000",
+      "nickName": "用户昵称",
+      "phone": "13800138000",
+      "avatar": "https://example.com/avatar.jpg",
+      "isProfileComplete": true,
+      "sig": "a1b2c3d4e5f6...",
+      "ts": 1709800000
+    },
+    "accountInfo": {
+      "accountId": 98765,
+      "rechargeCount": 3,
+      "balance": 100.50,
+      "vipType": 1,
+      "vipTypeName": "Pro",
+      "vipExpireTime": "2026-12-31T23:59:59.000+0800",
+      "vipRemainingDays": 299,
+      "credits": 5000,
+      "creditsLimit": 10000,
+      "lastResetTime": "2026-03-01T00:00:00.000+0800",
+      "lastRecoveryTime": "2026-03-07T10:00:00.000+0800",
+      "creditsRecoveryRate": 50,
+      "lastAutoRecoveryTime": "2026-03-07T09:00:00.000+0800",
+      "creditsPackageSummary": {
+        "totalPackageCount": 5,
+        "chatbotCredits": 1000,
+        "codexCredits": 500,
+        "claudeCodeCredits": 2000,
+        "geminiCredits": 800,
+        "openclawCredits": 300,
+        "generalCredits": 400
+      }
+    },
+    "teamInfo": {
+      "currentTeamId": 55555,
+      "currentTeamName": "我的团队",
+      "currentTeamRole": "0",
+      "currentTeamAnalyzeTeamMemberData": 1,
+      "teams": [
+        {
+          "teamId": 55555,
+          "teamName": "我的团队",
+          "teamAvatar": "https://example.com/team-avatar.jpg",
+          "memberRole": "0",
+          "memberCount": 5,
+          "vipType": 2
+        },
+        {
+          "teamId": 66666,
+          "teamName": "另一个团队",
+          "teamAvatar": null,
+          "memberRole": "2",
+          "memberCount": 12,
+          "vipType": 1
+        }
+      ]
+    },
+    "gatewayInfo": {
+      "gatewayId": 1,
+      "gatewayName": "ModelGate",
+      "gatewayCode": "modelgate",
+      "apiUrl": "https://mg.evolai.cn/api",
+      "modelBaseUrl": "https://mg.evolai.cn/v1",
+      "apiKey": "sk_mg_xxxxxxxxxxxx",
+      "apiKeyEnabled": true
+    }
+  }
+}
+```
+
+### 错误响应
+
+| code | msg | 触发条件 |
+|------|-----|----------|
+| 500 | Token已失效，请重新登录 | Token 无效、过期或未提供 |
+
+### 响应数据结构详解
+
+#### UserInfo - 用户基本信息
+
+| 字段 | 类型 | 可为空 | 说明 |
+|------|------|--------|------|
+| userId | Long | 否 | 用户ID |
+| aid | String | 是 | AID账户标识（用于API/网关认证） |
+| userName | String | 否 | 用户名（通常为手机号） |
+| nickName | String | 是 | 用户昵称（未设置时为null） |
+| phone | String | 否 | 手机号 |
+| avatar | String | 是 | 头像URL |
+| isProfileComplete | Boolean | 否 | 用户信息是否完善（判断标准：nickName是否已设置） |
+| sig | String | 是 | HMAC-SHA256签名（基于AID生成，AID为空时不返回） |
+| ts | Long | 是 | 签名时间戳（秒级Unix时间戳） |
+
+#### AccountInfo - 账户信息
+
+| 字段 | 类型 | 可为空 | 说明 |
+|------|------|--------|------|
+| accountId | Long | 否 | 账户ID |
+| rechargeCount | Integer | 是 | 充值次数 |
+| balance | BigDecimal | 是 | 当前余额（人民币，单位：元） |
+| vipType | Integer | 是 | VIP类型（见下方VIP类型枚举） |
+| vipTypeName | String | 是 | VIP类型名称 |
+| vipExpireTime | Date | 是 | VIP到期时间（免费用户为null） |
+| vipRemainingDays | Integer | 是 | VIP剩余天数（免费用户为-1） |
+| credits | Integer | 是 | 当前可用积分 |
+| creditsLimit | Integer | 是 | 积分上限（根据VIP类型从配置中动态获取） |
+| lastResetTime | Date | 是 | 最后一次积分手动重置时间 |
+| lastRecoveryTime | Date | 是 | 最后一次积分恢复时间（含手动重置和自动恢复） |
+| creditsRecoveryRate | Integer | 是 | 积分恢复速率（单位：积分/小时，根据VIP类型动态获取） |
+| lastAutoRecoveryTime | Date | 是 | 最近一次积分自动恢复时间（来自日志表，无恢复记录时为null） |
+| creditsPackageSummary | Object | 是 | 积分包统计信息 |
+
+#### VIP类型枚举
+
+| vipType | vipTypeName | 说明 |
+|---------|-------------|------|
+| 0 | Free | 免费用户 |
+| 1 | Pro | Pro会员 |
+| 2 | Max | Max会员 |
+| 3 | Ultra | Ultra会员 |
+
+#### CreditsPackageSummary - 积分包统计（双账本架构）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| totalPackageCount | Integer | 用户拥有的积分包总数量 |
+| chatbotCredits | Integer | Chatbot专属包剩余积分 |
+| codexCredits | Integer | Codex专属包剩余积分 |
+| claudeCodeCredits | Integer | Claude Code专属包剩余积分 |
+| geminiCredits | Integer | Gemini专属包剩余积分 |
+| openclawCredits | Integer | OpenClaw专属包剩余积分 |
+| generalCredits | Integer | 通用包剩余积分（适用于所有模型） |
+
+#### TeamInfo - 团队信息
+
+| 字段 | 类型 | 可为空 | 说明 |
+|------|------|--------|------|
+| currentTeamId | Long | 是 | 当前使用的团队ID（null表示使用个人账户） |
+| currentTeamName | String | 是 | 当前团队名称 |
+| currentTeamRole | String | 是 | 用户在当前团队的角色（见角色枚举） |
+| currentTeamAnalyzeTeamMemberData | Integer | 否 | 当前团队是否允许分析成员数据（0=否, 1=是），默认0 |
+| teams | List\<TeamItem\> | 否 | 用户所属的所有团队列表（无团队时为空数组） |
+
+#### TeamItem - 团队列表项
+
+| 字段 | 类型 | 可为空 | 说明 |
+|------|------|--------|------|
+| teamId | Long | 否 | 团队ID |
+| teamName | String | 否 | 团队名称 |
+| teamAvatar | String | 是 | 团队头像URL |
+| memberRole | String | 否 | 用户在该团队的角色 |
+| memberCount | Integer | 是 | 团队成员总数 |
+| vipType | Integer | 是 | 团队VIP类型 |
+
+#### 团队角色枚举
+
+| memberRole | 说明 |
+|------------|------|
+| 0 | 创建者（Owner） |
+| 1 | 管理员（Admin） |
+| 2 | 普通成员（Member） |
+
+#### GatewayInfo - 网关信息
+
+| 字段 | 类型 | 可为空 | 说明 |
+|------|------|--------|------|
+| gatewayId | Long | 是 | 网关ID |
+| gatewayName | String | 是 | 网关名称 |
+| gatewayCode | String | 是 | 网关编码标识 |
+| apiUrl | String | 是 | API管理URL（用于API Key管理等） |
+| modelBaseUrl | String | 是 | 大模型Base URL（获取模型列表、访问大模型） |
+| apiKey | String | 是 | 用户的ModelGate API Key（未创建时为null） |
+| apiKeyEnabled | Boolean | 是 | API Key是否可用（true=可用, false=禁用, null=未创建） |
+
+**网关查找优先级:** 用户配置的网关 → 团队配置的网关 → 系统默认网关
+
+### 业务逻辑
+
+1. 从 Authorization Header 解析 JWT Token，获取 LoginUser
+2. Token 无效或过期时返回错误
+3. 查询用户基本信息（sys_user 表）
+4. 查询账户信息（evol_user_account 表）
+5. 构建 UserInfo:
+   - 填充基本字段
+   - 基于 AID 生成 HMAC-SHA256 签名及时间戳
+6. 构建 AccountInfo:
+   - 填充账户余额、VIP信息
+   - 动态获取积分上限（基于VIP类型，来自系统配置）
+   - 动态获取积分恢复速率（基于VIP类型，来自系统配置）
+   - 查询最近一次自动恢复日志
+   - 查询积分包汇总（双账本架构）
+7. 构建 TeamInfo:
+   - 查询用户所在的所有团队及其角色
+   - 从 evol_user_account 表获取用户当前使用的团队ID
+   - 匹配当前团队的详细信息
+8. 构建 GatewayInfo:
+   - 按优先级查找有效网关（用户 > 团队 > 默认）
+   - 查询用户的 ModelGate API Key 及其启用状态
+
+---
+
+## 通用说明
+
+### 统一响应格式
+
+所有接口统一返回 `AjaxResult` 格式:
+
+```json
+{
+  "code": 200,
+  "msg": "操作描述",
+  "data": { ... }
+}
+```
+
+| code | 说明 |
+|------|------|
+| 200 | 成功 |
+| 500 | 失败 |
+
+### 认证方式
+
+需要认证的接口请在 HTTP Header 中携带:
+
+```
+Authorization: Bearer {token}
+```
+
+其中 `{token}` 为登录接口返回的 JWT Token。
+
+### 积分体系说明
+
+系统采用 **双账本架构**:
+
+- **通用积分 (credits)**: 存储在 `evol_user_account` 表，所有模型通用
+- **专属积分包 (creditsPackageSummary)**: 各类型积分包独立计算，仅限对应模型使用
+
+积分恢复机制:
+- 积分低于上限时，系统按 `creditsRecoveryRate`（积分/小时）自动恢复
+- 恢复速率根据用户 VIP 类型从系统配置中动态获取
+- 积分不会超过 `creditsLimit` 上限

package/docs/ACP/345/215/217/350/256/256/345/205/274/345/256/271/346/226/271/346/241/210.md

@@ -0,0 +1,138 @@
+# ACP 协议兼容方案
+
+## 结论
+
+**现有 acp_channel 模块已天然支持 ACP 协议客户端接入。** 任何纳入 Kite 管理的模块，其 RPC 方法和事件自动对 ACP 客户端可用，模块本身无需感知 ACP 的存在。
+
+---
+
+## 背景
+
+ACP（Agent Communication Protocol）是一套基于 WebSocket + JSON-RPC 2.0 的代理通信协议。Kite 内部的 RPC 机制同样基于 JSON-RPC 2.0，因此两者在协议层高度兼容。
+
+---
+
+## 现有接入方式对比
+
+| 接入方式 | 连接端点 | 认证方式 | 能力 |
+|---------|---------|---------|------|
+| ACP 客户端连 acp_channel | `ws://<host>:<acp_port>` | kite_token | 调用任意模块 RPC、订阅任意事件 |
+| 远程模块连 gateway | `ws://<host>:<gateway_port>` | kite_token + challenge-nonce | 同上，额外支持模块注册 |
+| CLI / 管理工具连 acp_channel | `ws://<host>:<acp_port>` | 配对码 / SMS / kite_token | 同上 |
+
+---
+
+## 为什么不需要新建 CLI 通道
+
+最初考虑通过 kite_console 的 WebSocket 中转来实现 CLI 控制面，但分析后发现这会引入不必要的中间层：
+
+- kite_console → Kernel 路由已存在一层代理
+- CLI 经由 kite_console 中转 = 增加延迟 + 增加故障点
+- acp_channel 已经实现完整的认证、路由、事件订阅
+
+**正确做法：CLI 直接连接 acp_channel。**
+
+---
+
+## 接入流程
+
+### 1. 认证（首次）
+
+```json
+// 方式一：配对码
+{"jsonrpc": "2.0", "id": "1", "method": "auth.verify",
+ "params": {"method": "pairing_code", "code": "123456"}}
+
+// 方式二：短信验证码
+{"jsonrpc": "2.0", "id": "1", "method": "auth.verify",
+ "params": {"method": "evol_account", "phone": "+86...", "code": "654321"}}
+
+// 响应
+{"jsonrpc": "2.0", "id": "1",
+ "result": {"success": true, "role": "admin", "token": "kt_..."}}
+```
+
+### 2. Token 持久化
+
+将 `token` 存储在本地（如 `~/.kite/token`），后续连接直接用 token 认证：
+
+```json
+{"jsonrpc": "2.0", "id": "1", "method": "auth.verify",
+ "params": {"method": "kite_token", "token": "kt_..."}}
+```
+
+### 3. 调用任意模块 RPC
+
+路由格式：`<module_name>.<method>`
+
+```json
+// 调用 dataclaw 模块的查询接口
+{"jsonrpc": "2.0", "id": "2", "method": "dataclaw.query",
+ "params": {"sql": "SELECT * FROM users LIMIT 10"}}
+
+// 调用 launcher 的模块列表
+{"jsonrpc": "2.0", "id": "3", "method": "launcher.list_modules", "params": {}}
+```
+
+### 4. 订阅事件
+
+```json
+{"jsonrpc": "2.0", "id": "4", "method": "events.subscribe",
+ "params": {"events": ["module.ready", "module.crashed", "auth.success"]}}
+```
+
+---
+
+## 模块自动支持 ACP 的原理
+
+```
+[ACP 客户端]
+     │  ws + JSON-RPC 2.0
+     ▼
+[acp_channel]  ← 认证、会话管理、权限控制
+     │  内部 RPC 路由
+     ▼
+[Kernel]  ← 路由分发
+     │
+     ├──▶ [launcher]    launcher.* 方法
+     ├──▶ [dataclaw]    dataclaw.* 方法
+     ├──▶ [auth]        auth.* 方法
+     └──▶ [任意模块]    <module_name>.* 方法
+```
+
+任何通过 Launcher 启动并向 Kernel 注册的模块，其所有 RPC 方法立即对 ACP 客户端可用。模块只需实现业务逻辑，路由由 Kernel 和 acp_channel 自动处理。
+
+---
+
+## 权限控制
+
+| 角色 | 权限 |
+|-----|------|
+| `admin` | 所有 RPC 方法 + 所有事件 |
+| `operator` | 非敏感 RPC + 大部分事件 |
+| `viewer` | 只读 RPC + 公开事件 |
+
+权限由 acp_channel 在认证时确定，通过 token 的 `role` 字段携带。
+
+---
+
+## 与标准 ACP 协议的差异
+
+| 特性 | 标准 ACP | Kite acp_channel |
+|-----|---------|------------------|
+| 传输层 | WebSocket | WebSocket ✅ |
+| 消息格式 | JSON-RPC 2.0 | JSON-RPC 2.0 ✅ |
+| 认证 | Bearer Token | kite_token（语义相同）✅ |
+| 服务发现 | DNS-SD / mDNS | registry 模块 ✅ |
+| 多租户 | 可选 | 通过 role 实现 ✅ |
+| 双向流 | 事件订阅 | events.subscribe ✅ |
+
+差异极小，已基本兼容标准 ACP 协议。如需完全对齐，只需在 acp_channel 的握手阶段对齐 capability negotiation 格式。
+
+---
+
+## 后续计划
+
+- [ ] 开发 `kite-cli` 命令行工具，封装上述认证 + RPC 调用流程
+- [ ] 在 acp_channel 的握手中加入 ACP capability negotiation 字段，实现完全协议兼容
+- [ ] 文档化各模块的公开 RPC 方法，作为 ACP API 参考