安装部署
本文档详细说明 ChatAI 插件的安装部署流程。
环境准备
Node.js
推荐使用 Node.js 18 LTS 或更高版本：
bash
# 检查版本
node -v # 应输出 v18.x.x 或更高
# 使用 nvm 安装（推荐）
nvm install 18
nvm use 18pnpm
bash
# 安装 pnpm
npm install -g pnpm
# 检查版本
pnpm -v # 应输出 8.x.x 或更高编译工具
better-sqlite3 是原生模块，需要编译工具：
bash
# 安装 Visual Studio Build Tools
# 下载地址: https://visualstudio.microsoft.com/visual-cpp-build-tools/
# 安装时选择 "使用 C++ 的桌面开发"bash
sudo apt update
sudo apt install build-essential python3bash
sudo yum groupinstall "Development Tools"
sudo yum install python3bash
xcode-select --install安装插件
方式一：Git 克隆（推荐）
bash
cd /path/to/yunzai
git clone https://github.com/XxxXTeam/chatai-plugin.git ./plugins/chatai-plugin方式二：手动下载
- 从 GitHub Releases 下载最新版本
- 解压到
plugins/chatai-plugin目录
安装依赖
在 Yunzai 根目录 执行：
bash
pnpm install注意
必须在 Yunzai 根目录执行，不是插件目录
构建原生模块
bash
pnpm rebuild better-sqlite3常见构建问题
问题：找不到 Python
bash
# 设置 Python 路径
npm config set python /usr/bin/python3问题：node-gyp 错误
bash
# 全局安装 node-gyp
npm install -g node-gyp
# 清理缓存后重试
pnpm store prune
pnpm install
pnpm rebuild better-sqlite3问题：ABI 不兼容
bash
# 完全重建
rm -rf node_modules
pnpm install
pnpm rebuild目录结构
安装完成后，插件目录结构如下：
plugins/chatai-plugin/
├── apps/ # 应用模块
├── config/ # 配置管理
├── data/ # 运行时数据
│ ├── presets/ # 预设文件
│ ├── tools/ # 自定义工具
│ └── chatai.db # SQLite 数据库
├── docs/ # 文档
├── resources/ # 静态资源
├── src/ # 源代码
└── index.js # 插件入口启动验证
启动 Yunzai-Bot：
bash
pnpm start查看控制台输出，确认插件加载成功：
[ChatAI] 插件加载成功TRSS 环境
如果使用 TRSS-Yunzai，插件会自动检测并共享端口：
yaml
# 配置文件中启用共享端口
web:
sharePort: true
mountPath: /chatai更新插件
bash
cd plugins/chatai-plugin
git pull
cd ../..
pnpm install
pnpm rebuild better-sqlite3