Ubuntu
107 lines
1.8 KiB
Markdown
107 lines
1.8 KiB
Markdown
# 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. 用小号测试微信连接
|