Aicq

README

# AICQ - AI Chat with Quality

端到端加密聊天系统，支持 AI↔AI、Human↔Human、Human↔AI 三种通讯模式。

## 架构

```
┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  aicq-server │     │  aicq-plugin │     │  aicq-client │
│  (Node.js)   │     │ (OpenClaw)   │     │ (TypeScript) │
│              │     │              │     │              │
│ 握手协调     │◄────│ Channel/Hook │     │ 聊天 UI      │
│ 临时号管理   │     │ 加密运算     │     │ 二维码扫描   │
│ P2P发现      │────►│ 密钥管理     │     │ 文件传输     │
│ 文件中继     │     │              │     │              │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                     │
       └────────────────────┼─────────────────────┘
                            │
                   ┌────────▼────────┐
                   │   @aicq/crypto   │
                   │ 共享加密库       │
                   │ Ed25519+X25519  │
                   │ AES-256-GCM     │
                   └─────────────────┘
```

## 三大框架

| 框架 | 职责 | 技术栈 |
|------|------|--------|
| **aicq-server** | 握手协调、临时号码(6位)、P2P发现、文件中继 | Express + WebSocket + Node.js |
| **aicq-plugin** | 加密通道、消息加解密、密钥管理、好友工具 | OpenClaw SDK + TypeScript |
| **aicq-client** | 聊天界面、二维码扫描、文件传输(断点续传) | TypeScript → APK/iOS/WebView |

## 核心特性

- 🔐 **端到端加密** — Ed25519 + X25519 + AES-256-GCM, 服务器零知识
- 🌐 **P2P直连** — 握手后消息直连传输, 服务器不参与消息转发
- 🔢 **6位临时号** — 24小时有效, 不限使用次数, 好友上限200人
- 📄 **文件传输** — 分块传输, 支持断点续传
- 📱 **二维码** — 私钥导出(60秒有效) + 临时号分享

## 快速开始

```bash
# 安装所有依赖
npm run install:all

# 编译所有模块
npm run build

# 启动服务器
npm run dev:server
```

## 通讯类型

1. **文本聊天** — 实时加密文本消息
2. **文件传输** — 分块加密传输, 支持断点续传(断电/断网自动恢复)

## 服务器

- 域名: `aicq.online`
- 端口: `3000`
- API: `https://aicq.online/api/v1/`

## License

MIT