aicq-chat-plugin 3.3.1 → 3.4.1

package/README.md

@@ -1,15 +1,16 @@
-# AICQ Chat Plugin v3.0
+# AICQ Chat Plugin v3.2
 
-AICQ 端到端加密聊天频道插件 — 基于 OpenClaw Channel 架构。
+AICQ 端到端加密聊天频道插件 — 基于 OpenClaw Channel Plugin SDK。
 
-## 架构 (v3.0 Channel)
+## 架构 (v3.2 Channel SDK)
 
-v3.0 采用 Channel 插件架构，直接在 OpenClaw 进程内运行：
+v3.2 采用官方 OpenClaw Channel Plugin SDK，使用 `defineChannelPluginEntry` + `createChatChannelPlugin`：
 
-- **无需独立端口** — 不再需要 port 6109 的 sidecar 进程
-- **复用 Agent ID** — 直接使用 OpenClaw 智能体身份
+- **ESM 模块** — 入口文件使用 ES Module 格式
+- **官方 SDK** — 使用 `openclaw/plugin-sdk/channel-core` 的 `defineChannelPluginEntry` 和 `createChatChannelPlugin`
 - **进程内通信** — 通过 Turn Kernel 推送消息，无 HTTP 轮询
 - **Gateway HTTP 路由** — SPA 和 API 通过 Gateway 路由提供
+- **setupEntry** — 轻量级 setup 入口，不加载运行时代码
 
 ## 一键安装
 
@@ -17,6 +18,9 @@ v3.0 采用 Channel 插件架构，直接在 OpenClaw 进程内运行：
 # 安装插件
 openclaw plugins install npm:aicq-chat-plugin
 
+# 配置频道
+openclaw channels add --channel aicq-chat --name "AICQ Chat"
+
 # 重启 gateway
 openclaw gateway restart
 ```
@@ -63,12 +67,13 @@ openclaw gateway restart
 | `AICQ_SERVER_URL` | https://aicq.online | AICQ 服务器地址 |
 | `AICQ_DATA_DIR` | ~/.aicq-plugin | 数据存储目录 |
 
-## 迁移指南 (v2 → v3)
+## 迁移指南 (v3.0 → v3.2)
 
 1. 卸载旧版：`openclaw plugins uninstall aicq-chat`
 2. 安装新版：`openclaw plugins install npm:aicq-chat-plugin`
-3. 重启 gateway：`openclaw gateway restart`
-4. 旧版数据（密钥、好友、消息）会自动迁移
+3. 配置频道：`openclaw channels add --channel aicq-chat`
+4. 重启 gateway：`openclaw gateway restart`
+5. 旧版数据（密钥、好友、消息）会自动迁移
 
 ## 许可证
 

package/SKILL.md

@@ -1,32 +1,33 @@
 ---
 name: aicq-chat
-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
+description: AICQ End-to-end Encrypted Chat Channel Plugin for OpenClaw — Official Channel Plugin SDK with friend management, group chat, file transfer, and AI agent communication
 license: MIT
 metadata:
   author: AICQ
-  version: "3.0.0"
+  version: "3.2.0"
 ---
 
 # AICQ Encrypted Chat
 
-AICQ 是一个端到端加密聊天频道插件，基于 OpenClaw Channel 架构，直接在 OpenClaw 进程内运行。支持好友管理、群组聊天、文件传输和 AI Agent 通信。
+AICQ 是一个端到端加密聊天频道插件，基于 OpenClaw Channel Plugin SDK，直接在 OpenClaw 进程内运行。支持好友管理、群组聊天、文件传输和 AI Agent 通信。
 
-## 架构变更 (v3.0)
+## 架构变更 (v3.2)
 
-从 Sidecar + Tools 架构升级为 Channel 插件架构：
+从 plain-capability 自定义架构升级为官方 Channel Plugin SDK：
 
-| 维度 | 旧版 (Sidecar) | 新版 (Channel) |
-|------|----------------|----------------|
-| 进程 | 独立 Express (port 6109) | 进程内，无独立端口 |
-| 身份 | 自生成 agent-xxxxx | 复用 OpenClaw agent ID |
-| 消息路由 | HTTP API 轮询 | Turn Kernel 推送 |
-| UI | 独立 SPA (localhost:6109) | Gateway HTTP 路由 + 侧边栏 |
-| 启动 | 需手动 node index.js | 随 OpenClaw 自动启动 |
+| 维度 | 旧版 (v3.0) | 新版 (v3.2) |
+|------|-------------|-------------|
+| 模块格式 | CommonJS | ESM |
+| 入口方式 | register/activate/handleTool/handleGateway | defineChannelPluginEntry |
+| 插件形状 | plain-capability | channel (SDK) |
+| 频道注册 | 自定义 channel 对象 | createChatChannelPlugin + createChannelPluginBase |
+| Setup 入口 | 无 | defineSetupPluginEntry |
+| 频道检测 | installed, not configured | 正确配置和启用 |
 
 ## 功能特性
 
 - **端到端加密 (E2EE)** — 基于 NaCl (libsodium) 的加密体系，消息仅通信双方可读
-- **Channel 架构** — 进程内运行，无独立端口，复用 OpenClaw agent ID
+- **Channel SDK** — 使用官方 Channel Plugin SDK，正确注册频道
 - **好友管理** — 好友码添加、QR 码扫描、好友列表同步
 - **群组聊天** — 创建群组、邀请成员、静默模式
 - **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及、流式消息
@@ -39,6 +40,9 @@ AICQ 是一个端到端加密聊天频道插件，基于 OpenClaw Channel 架构
 # 安装插件
 openclaw plugins install npm:aicq-chat-plugin
 
+# 配置频道
+openclaw channels add --channel aicq-chat
+
 # 重启 gateway
 openclaw gateway restart
 

package/{cli.js → cli.cjs}

@@ -135,7 +135,7 @@ function copyDirRecursive(src, dest) {
 // ── Install plugin files to a target directory ─────────────────────
 function installToDir(sourceDir, targetDir, version) {
   const filesToCopy = [
-    'index.js', 'setup-entry.js', 'cli.js', 'postinstall.js',
+    'index.js', 'setup-entry.js', 'cli.cjs', 'postinstall.cjs',
     'openclaw.plugin.json', 'package.json', 'README.md',
   ];
   const dirsToCopy = ['lib', 'src', 'public'];
@@ -287,7 +287,7 @@ function uninstallFromOpenClaw() {
 // ── Help ────────────────────────────────────────────────────────────
 if (command === '--help' || command === '-h') {
   console.log(`
-AICQ Chat Plugin v3.0 — End-to-End Encrypted Chat for OpenClaw (Channel)
+AICQ Chat Plugin v3.2 — End-to-End Encrypted Chat for OpenClaw (Channel SDK)
 
 Usage:
   openclaw plugins install npm:aicq-chat-plugin   Install plugin via openclaw CLI
@@ -296,8 +296,8 @@ Usage:
   aicq-plugin [command] [options]                 Advanced usage
 
 Commands:
-  start       Install to OpenClaw (if needed) and start in standalone mode (default)
-  install     Install plugin to OpenClaw only (don't start server)
+  start       Install to OpenClaw (if needed) (default)
+  install     Install plugin to OpenClaw only
   uninstall   Remove plugin from OpenClaw (skills/ and plugins/)
   status      Check if the plugin is running
 
@@ -312,8 +312,9 @@ Environment Variables:
   OPENCLAW_WORKSPACE      OpenClaw workspace directory (for skills/)
 
 Architecture:
-  v3.0 uses Channel architecture — runs in-process with OpenClaw.
-  No independent port needed. UI served via Gateway HTTP routes.
+  v3.2 uses official Channel Plugin SDK (defineChannelPluginEntry).
+  Runs in-process with OpenClaw — no standalone server needed.
+  UI served via Gateway HTTP routes.
   - UI: /plugins/aicq-chat/ui/
   - API: /plugins/aicq-chat/api/*
 `);
@@ -322,8 +323,8 @@ Architecture:
 
 // ── Status ──────────────────────────────────────────────────────────
 if (command === 'status') {
-  console.log('AICQ Plugin v3.0 (Channel architecture)');
-  console.log('In Channel mode, the plugin runs inside OpenClaw process.');
+  console.log('AICQ Plugin v3.2 (Channel SDK architecture)');
+  console.log('Uses defineChannelPluginEntry — runs in-process with OpenClaw.');
   console.log('Check OpenClaw gateway status for plugin health.');
   process.exit(0);
 }
@@ -340,32 +341,16 @@ if (command === 'uninstall' || command === 'remove') {
   process.exit(0);
 }
 
-// ── Start (default) — auto-install then run in standalone mode ──────
+// ── Start (default) — auto-install then inform user ───────────────
 installToOpenClaw();
 
-console.log(`[AICQ] Starting plugin in standalone mode`);
+console.log('');
+console.log('[AICQ] Channel Plugin uses OpenClaw Channel SDK (defineChannelPluginEntry).');
+console.log('[AICQ] It runs in-process with OpenClaw — no standalone server needed.');
+console.log('[AICQ] To activate:');
+console.log('  openclaw plugins install npm:aicq-chat-plugin');
+console.log('  openclaw gateway restart');
+console.log('');
 console.log(`[AICQ] Server: ${serverUrl}`);
-
-const env = { ...process.env, AICQ_SERVER_URL: serverUrl };
-const child = spawn('node', [path.join(__dirname, 'index.js')], {
-  env,
-  stdio: 'inherit',
-  detached: false,
-});
-
-child.on('error', (err) => {
-  console.error('[AICQ] Failed to start:', err.message);
-  process.exit(1);
-});
-
-child.on('exit', (code) => {
-  process.exit(code || 0);
-});
-
-process.on('SIGINT', () => {
-  child.kill('SIGINT');
-});
-
-process.on('SIGTERM', () => {
-  child.kill('SIGTERM');
-});
+console.log('[AICQ] UI: /plugins/aicq-chat/ui/');
+console.log('[AICQ] API: /plugins/aicq-chat/api/*');