# WeChat-Nanobot Bridge 快速开始

## 1. 安装依赖（Python）

```bash
cd /home/ubuntu/nanocode/weixin-nanobot-bridge

# 安装 Python 依赖
pip3 install flask flask-cors requests python-dotenv pydantic
```

## 2. 安装依赖（Node.js - 可选）

```bash
# 如果需要连接微信，安装 Node.js 依赖
npm install axios

# 安装 weixin-agent-sdk（需要从 npm 或源码安装）
# npm install weixin-agent-sdk
```

## 3. 启动 Bridge 服务

```bash
# 快速启动
python3 src/server.py

# 或使用脚本
./scripts/start.sh
```

服务将在 `http://localhost:5000` 启动。

## 4. 测试

```bash
# 在另一个终端测试
./scripts/test.sh

# 或使用 curl
curl http://localhost:5000/health

curl -X POST http://localhost:5000/chat \
  -H "Content-Type: application/json" \
  -d '{"conversationId": "test", "text": "你好"}'
```

## 5. 模拟运行（不连接微信）

```bash
node nanobot-adapter.js --simulate
```

## 6. 连接微信（需要 weixin-agent-sdk）

```bash
# 1. 确保 bridge 已启动

# 2. 启动适配器
export NANOBOT_BRIDGE_URL=http://localhost:5000/chat
node nanobot-adapter.js --weixin

# 3. 扫码登录微信
```

## 常见问题

### Flask 未安装

```bash
pip3 install flask flask-cors
```

### 端口被占用

```bash
# 查看占用
lsof -i :5000

# 修改端口
# 编辑 config/config.json，修改 server.port
```

### 测试失败

```bash
# 查看日志
tail -f logs/server.log
```

## 项目状态

| 组件 | 状态 |
|------|------|
| HTTP API | ✅ 可用 |
| 会话管理 | ✅ 可用 |
| 安全控制 | ✅ 可用 |
| 模拟适配器 | ✅ 可用 |
| 微信连接 | ⚠️ 需 weixin-agent-sdk |

## 下一步

1. 测试基础 API 是否正常
2. 配置 nanobot 路径（如果不在 PATH）
3. 尝试模拟运行
4. 用小号测试微信连接