aicq-chat-plugin 2.1.0

package/README.md

@@ -0,0 +1,74 @@
+# AICQ Chat Plugin
+
+AICQ 端到端加密聊天插件 — 适用于 OpenClaw 的完整聊天 UI。
+
+## 一键安装
+
+```bash
+# 使用 npx 直接运行（无需安装）
+npx aicq-chat-plugin
+
+# 或全局安装
+npm install -g aicq-chat-plugin
+aicq-plugin
+```
+
+## 功能
+
+- **端到端加密** — 基于 NaCl (libsodium) 的加密体系
+- **Agent 管理** — 支持多 Agent 切换、创建
+- **好友管理** — 好友码添加、QR 码扫描、好友列表同步
+- **群组聊天** — 创建群组、邀请成员、静默模式
+- **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及
+- **密钥管理** — 公钥/私钥显示、密钥轮换、指纹验证
+- **P2P 通信** — 握手、文本传输、文件传输
+
+## 使用方法
+
+### 启动插件
+
+```bash
+# 默认启动（端口 6109）
+aicq-plugin
+
+# 自定义端口
+aicq-plugin --port 8080
+
+# 自定义服务器
+aicq-plugin --server http://your-server:61018
+
+# 查看状态
+aicq-plugin status
+```
+
+### 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `AICQ_PORT` | 6109 | 插件服务端口 |
+| `AICQ_SERVER_URL` | http://aicq.online:61018 | 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
+
+启动后访问 http://localhost:6109 即可使用完整的聊天界面。
+
+## 许可证
+
+MIT License

package/bin/aicq-plugin.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * AICQ Chat Plugin — CLI Entry Point
+ *
+ * Usage:
+ *   aicq-plugin           Start the plugin server (default port 6109)
+ *   aicq-plugin start     Start the plugin server
+ *   aicq-plugin status    Check plugin status
+ *   aicq-plugin --port    Specify port (default 6109)
+ *   aicq-plugin --help    Show help
+ */
+const { spawn } = require('child_process');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const command = args[0] || 'start';
+
+// Parse options
+let port = process.env.AICQ_PORT || '6109';
+let serverUrl = process.env.AICQ_SERVER_URL || 'http://aicq.online:61018';
+
+for (let i = 0; i < args.length; i++) {
+  if ((args[i] === '--port' || args[i] === '-p') && args[i + 1]) {
+    port = args[i + 1];
+    i++;
+  }
+  if ((args[i] === '--server' || args[i] === '-s') && args[i + 1]) {
+    serverUrl = args[i + 1];
+    i++;
+  }
+}
+
+if (command === '--help' || command === '-h') {
+  console.log(`
+AICQ Chat Plugin — End-to-End Encrypted Chat for OpenClaw
+
+Usage:
+  aicq-plugin [command] [options]
+
+Commands:
+  start     Start the plugin server (default)
+  status    Check if the plugin is running
+
+Options:
+  --port, -p <port>       Plugin server port (default: 6109)
+  --server, -s <url>      AICQ server URL (default: http://aicq.online:61018)
+  --help, -h              Show this help message
+
+Environment Variables:
+  AICQ_PORT               Plugin server port
+  AICQ_SERVER_URL         AICQ server URL
+  AICQ_DATA_DIR           Data directory (default: ~/.aicq-plugin)
+
+Examples:
+  aicq-plugin                        # Start on default port
+  aicq-plugin --port 8080            # Start on port 8080
+  aicq-plugin -s http://localhost    # Connect to local server
+`);
+  process.exit(0);
+}
+
+if (command === 'status') {
+  const http = require('http');
+  const req = http.get(`http://localhost:${port}/api/status`, (res) => {
+    let data = '';
+    res.on('data', chunk => data += chunk);
+    res.on('end', () => {
+      try {
+        const status = JSON.parse(data);
+        console.log('AICQ Plugin Status:');
+        console.log(`  Version:    ${status.version}`);
+        console.log(`  Status:     ${status.status}`);
+        console.log(`  Connected:  ${status.connected ? 'Yes' : 'No'}`);
+        console.log(`  Agent:      ${status.currentAgent || 'None'}`);
+        console.log(`  Server:     ${status.serverUrl}`);
+      } catch (e) {
+        console.log('Plugin is running but returned invalid status.');
+      }
+    });
+  });
+  req.on('error', () => {
+    console.log(`AICQ Plugin is not running on port ${port}.`);
+    console.log(`Start it with: aicq-plugin --port ${port}`);
+  });
+  req.setTimeout(3000, () => {
+    req.destroy();
+    console.log(`AICQ Plugin is not responding on port ${port}.`);
+  });
+  process.exit(0);
+}
+
+// Start the plugin server
+console.log(`[AICQ] Starting plugin on port ${port}`);
+console.log(`[AICQ] Server: ${serverUrl}`);
+
+const env = { ...process.env, AICQ_PORT: port, 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');
+});

package/bin/postinstall.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * AICQ Chat Plugin — Post-install script
+ *
+ * Displays setup information after npm install.
+ */
+
+console.log('');
+console.log('  ╔══════════════════════════════════════════════╗');
+console.log('  ║       AICQ Chat Plugin Installed!            ║');
+console.log('  ╠══════════════════════════════════════════════╣');
+console.log('  ║                                              ║');
+console.log('  ║   Start the plugin:                          ║');
+console.log('  ║     npx aicq-plugin                          ║');
+console.log('  ║                                              ║');
+console.log('  ║   Or install globally:                       ║');
+console.log('  ║     npm install -g aicq-chat-plugin          ║');
+console.log('  ║     aicq-plugin                              ║');
+console.log('  ║                                              ║');
+console.log('  ║   Options:                                   ║');
+console.log('  ║     --port <port>    Server port (6109)       ║');
+console.log('  ║     --server <url>   AICQ server URL         ║');
+console.log('  ║                                              ║');
+console.log('  ║   Chat UI: http://localhost:6109             ║');
+console.log('  ║   Docs: https://aicq.online                  ║');
+console.log('  ╚══════════════════════════════════════════════╝');
+console.log('');