快速开始
本页说明如何在本地环境安装依赖并运行、构建 Live2D Copilot。
环境要求
⚠️
package.json未声明engines，以下版本为常规开发环境假设，以实际可运行环境为准（需人工复核）。
- Node.js：建议 LTS 版本（18 或更高）。
- 包管理器：
pnpm（仓库使用pnpm-lock.yaml）。 - Rust 工具链：需安装 Rust（Tauri 2 依赖，建议 stable 工具链）。
- 平台：面向桌面。当前 Rust 侧部分能力（鼠标穿透、视线追踪、窗口截图）以 Windows 实现为主（
#[cfg(windows)]），跨平台支持有限。 - Tauri 系统依赖：按 Tauri 2 官方文档安装对应平台的构建依赖。
安装依赖
在仓库根目录执行：
bash
pnpm install开发运行
开发模式下，tauri dev 会先通过 beforeDevCommand 启动 Vite 前端，再拉起 Tauri 窗口：
bash
pnpm tauri dev说明：
package.json中的dev脚本为vite（仅启动前端），tauri脚本为tauri；完整桌面开发推荐使用pnpm tauri dev。
构建
bash
pnpm tauri build构建前会通过 beforeBuildCommand 执行 pnpm build（即 vue-tsc --noEmit && vite build）做类型检查与前端打包。
前端构建（单独）
bash
pnpm build关键配置
- Tauri 配置：
src-tauri/tauri.conf.json（产物名Live2D Copilot、标识符com.ai-zen.live2d-copilot、窗口在 Rust 侧动态创建）。 - 权限声明：
src-tauri/capabilities/default.json（core:default、opener:default）。 - 默认模型：
public/models/Mao/（「虹色Mao」）。 - TTS 语音列表：
public/voices.json（Edge-TTS 可用语音，前端缓存读取）。
使用前配置
首次使用需在设置窗口中配置 AI 服务：
- 在设置窗口选择模型提供商（DeepSeek / ChatGLM）。
- 填入对应的 API Key。
- 选择 LLM 模型。
- 选择 TTS 语音（默认
zh-CN-XiaoyiNeural）。 - 点击「保存设置」。
设置会通过 Tauri Command（save_setting）写入应用配置目录下的 settings.json，并即时通过 settings-updated 事件同步到桌宠窗口。