# xiaozhi-nodejs-client

**Repository Path**: joe910101605/xiaozhi-nodejs-client

## Basic Information

- **Project Name**: xiaozhi-nodejs-client
- **Description**: 小智 Nodejs Client
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-22
- **Last Updated**: 2025-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Node.js版小吱Web客户端
参考：https://github.com/TOM88812/xiaozhi-web-client
这是小智Web客户端的Node.js实现版本，提供了WebSocket代理和音频处理功能。

## 功能特点

- Express Web服务器（端口：8888）
- WebSocket代理服务（端口：8892）
- Opus音频编解码支持
- 设备ID和客户端ID管理
- 配置保存和加载功能

## 环境要求

- Node.js 14.x 或更高版本
- npm 6.x 或更高版本

## 安装依赖

```bash
cd nodejs
npm install
```

## 启动项目

```bash
npm start
```

启动后，可以通过浏览器访问 http://localhost:8888 来使用应用。

## 配置说明

项目使用.env文件进行配置，主要配置项包括：

- `WS_URL` - 远程WebSocket服务器地址
- `PROXY_PORT` - WebSocket代理端口
- `WEB_PORT` - Web服务器端口
- `DEVICE_TOKEN` - 设备认证Token
- `ENABLE_TOKEN` - 是否启用Token认证
- `LOCAL_PROXY_URL` - 本地代理URL
- `CLIENT_ID` - 客户端ID（自动生成）

## 项目结构

- `index.js` - 主入口文件，包含Express服务器配置
- `proxy.js` - WebSocket代理实现，包含音频处理逻辑
- `package.json` - 项目配置和依赖管理
- `.env` - 环境变量配置（位于上级目录）

## 主要依赖

- `express` - Web服务器框架
- `ws` - WebSocket实现
- `@discordjs/opus` - Opus音频编解码库
- `node-wav` - WAV文件处理
- `dotenv` - 环境变量管理
- `express-handlebars` - 模板引擎

## 注意事项

1. 确保.env文件中的配置正确无误
2. 如需更改端口或服务器地址，修改.env文件后重启应用
3. 使用前请确保安装了所有依赖

## 问题排查

如果遇到连接问题，请检查：
- 远程WebSocket服务器地址是否正确
- 本地代理端口是否被占用
- Token认证是否正确配置