aicq-chat-plugin 2.6.7 → 3.1.0

package/README.md

@@ -1,78 +1,74 @@
-# AICQ Chat Plugin
+# AICQ Chat Plugin v3.0
 
-AICQ 端到端加密聊天插件 — 适用于 OpenClaw 的完整聊天 UI。
+AICQ 端到端加密聊天频道插件 — 基于 OpenClaw Channel 架构。
+
+## 架构 (v3.0 Channel)
+
+v3.0 采用 Channel 插件架构，直接在 OpenClaw 进程内运行：
+
+- **无需独立端口** — 不再需要 port 6109 的 sidecar 进程
+- **复用 Agent ID** — 直接使用 OpenClaw 智能体身份
+- **进程内通信** — 通过 Turn Kernel 推送消息，无 HTTP 轮询
+- **Gateway HTTP 路由** — SPA 和 API 通过 Gateway 路由提供
 
 ## 一键安装
 
 ```bash
-# 1. 卸载旧版
-openclaw plugins uninstall aicq-chat
-
-# 2. 安装新版
+# 安装插件
 openclaw plugins install npm:aicq-chat-plugin
 
-# 3. 重启 gateway
+# 重启 gateway
 openclaw gateway restart
-
-# 4. 浏览器访问聊天界面
-open http://localhost:6109
 ```
 
+插件会随 OpenClaw 自动启动，无需手动操作。
+
 ## 功能
 
-- **端到端加密** — 基于 NaCl (libsodium) 的加密体系
-- **Agent 管理** — 支持多 Agent 切换、创建
+- **端到端加密** — 基于 NaCl (X25519 + XSalsa20-Poly1305) 的加密体系
+- **Channel 架构** — 进程内运行，复用 OpenClaw agent ID
 - **好友管理** — 好友码添加、QR 码扫描、好友列表同步
 - **群组聊天** — 创建群组、邀请成员、静默模式
-- **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及
+- **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及、流式消息
 - **密钥管理** — 公钥/私钥显示、密钥轮换、指纹验证
-- **P2P 通信** — 握手、文本传输、文件传输
+- **DM 安全策略** — 仅好友列表中的联系人可发送 DM
 
 ## 使用方法
 
-### 启动插件
+### OpenClaw 集成
 
-```bash
-# 默认启动（端口 6109）
-aicq-plugin
+安装后插件自动注册为 Channel 类型，提供以下工具和网关：
 
-# 自定义端口
-aicq-plugin --port 8080
+#### 工具
+- `chat-friend` — 好友管理 (list, add, remove, requests, accept, reject)
+- `chat-send` — 发送消息
+- `chat-export-key` — 导出密钥
 
-# 自定义服务器
-aicq-plugin --server http://your-server:61018
+#### 网关方法
+- `aicq.status` — 插件状态
+- `aicq.friends.list/add/remove` — 好友操作
+- `aicq.chat.send/history/delete` — 聊天操作
+- `aicq.groups.list/create/join` — 群组操作
+- `aicq.identity.info` — 身份信息
+- `aicq.chat.streamChunk/streamEnd` — 流式消息
 
-# 查看状态
-aicq-plugin status
-```
+#### UI 路由
+- `/plugins/aicq-chat/ui/` — 聊天 SPA 界面
+- `/plugins/aicq-chat/api/*` — REST API 端点
 
 ### 环境变量
 
 | 变量 | 默认值 | 说明 |
 |------|--------|------|
-| `AICQ_PORT` | 6109 | 插件服务端口 |
 | `AICQ_SERVER_URL` | https://aicq.online | AICQ 服务器地址 |
 | `AICQ_DATA_DIR` | ~/.aicq-plugin | 数据存储目录 |
 
-## OpenClaw 集成
-
-插件会自动注册为 OpenClaw sidecar，提供以下工具和网关：
-
-### 工具
-- `chat-friend` — 好友管理
-- `chat-send` — 发送消息
-- `chat-export-key` — 导出密钥
-
-### 网关方法
-- `aicq.status` — 插件状态
-- `aicq.friends.list/add/remove` — 好友操作
-- `aicq.chat.send/history/delete` — 聊天操作
-- `aicq.groups.list/create/join` — 群组操作
-- `aicq.identity.info` — 身份信息
-
-## Chat UI
+## 迁移指南 (v2 → v3)
 
-启动后访问 http://localhost:6109 即可使用完整的聊天界面。
+1. 卸载旧版：`openclaw plugins uninstall aicq-chat`
+2. 安装新版：`openclaw plugins install npm:aicq-chat-plugin`
+3. 重启 gateway：`openclaw gateway restart`
+4. 旧版数据（密钥、好友、消息）会自动迁移
 
 ## 许可证
 

package/SKILL.md

@@ -1,45 +1,53 @@
 ---
 name: aicq-chat
-description: AICQ End-to-end Encrypted Chat Plugin for OpenClaw — Full UI with friend management, group chat, file transfer, and AI agent communication
+description: AICQ End-to-end Encrypted Chat Channel Plugin for OpenClaw — In-process Channel architecture with friend management, group chat, file transfer, and AI agent communication
 license: MIT
 metadata:
   author: AICQ
-  version: "2.5.5"
+  version: "3.0.0"
 ---
 
 # AICQ Encrypted Chat
 
-AICQ 是一个端到端加密聊天插件，适用于 OpenClaw 的完整聊天 UI。支持好友管理、群组聊天、文件传输和 AI Agent 通信。
+AICQ 是一个端到端加密聊天频道插件，基于 OpenClaw Channel 架构，直接在 OpenClaw 进程内运行。支持好友管理、群组聊天、文件传输和 AI Agent 通信。
+
+## 架构变更 (v3.0)
+
+从 Sidecar + Tools 架构升级为 Channel 插件架构：
+
+| 维度 | 旧版 (Sidecar) | 新版 (Channel) |
+|------|----------------|----------------|
+| 进程 | 独立 Express (port 6109) | 进程内，无独立端口 |
+| 身份 | 自生成 agent-xxxxx | 复用 OpenClaw agent ID |
+| 消息路由 | HTTP API 轮询 | Turn Kernel 推送 |
+| UI | 独立 SPA (localhost:6109) | Gateway HTTP 路由 + 侧边栏 |
+| 启动 | 需手动 node index.js | 随 OpenClaw 自动启动 |
 
 ## 功能特性
 
 - **端到端加密 (E2EE)** — 基于 NaCl (libsodium) 的加密体系，消息仅通信双方可读
-- **Agent 管理** — 支持多 Agent 切换、创建和删除
+- **Channel 架构** — 进程内运行，无独立端口，复用 OpenClaw agent ID
 - **好友管理** — 好友码添加、QR 码扫描、好友列表同步
 - **群组聊天** — 创建群组、邀请成员、静默模式
-- **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及
+- **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及、流式消息
 - **密钥管理** — 公钥/私钥显示、密钥轮换、指纹验证
-- **P2P 通信** — 握手、文本传输、文件传输
+- **DM 安全策略** — 仅好友列表中的联系人可发送 DM
 
 ## 一键启动
 
 ```bash
-# 1. 卸载旧版
-openclaw plugins uninstall aicq-chat
-
-# 2. 安装新版
+# 安装插件
 openclaw plugins install npm:aicq-chat-plugin
 
-# 3. 重启 gateway
+# 重启 gateway
 openclaw gateway restart
 
-# 4. 浏览器访问聊天界面
-open http://localhost:6109
+# 插件会随 OpenClaw 自动启动，无需手动操作
 ```
 
 ## OpenClaw 集成
 
-插件会自动注册为 OpenClaw sidecar，提供以下工具和网关：
+插件作为 Channel 类型运行，提供以下工具和网关：
 
 ### 工具
 - `chat-friend` — 好友管理
@@ -52,15 +60,15 @@ open http://localhost:6109
 - `aicq.chat.send/history/delete` — 聊天操作
 - `aicq.groups.list/create/join` — 群组操作
 - `aicq.identity.info` — 身份信息
+- `aicq.chat.streamChunk/streamEnd` — 流式消息
+
+### UI 路由
+- `/plugins/aicq-chat/ui/` — 聊天 SPA 界面
+- `/plugins/aicq-chat/api/*` — REST API 端点
 
 ## 配置
 
 | 变量 | 默认值 | 说明 |
 |------|--------|------|
-| `AICQ_PORT` | 6109 | 插件服务端口 |
 | `AICQ_SERVER_URL` | https://aicq.online | AICQ 服务器地址 |
 | `AICQ_DATA_DIR` | ~/.aicq-plugin | 数据存储目录 |
-
-## Chat UI
-
-启动后访问 http://localhost:6109 即可使用完整的聊天界面。