系统要求

在安装 CharaStudio 之前，请确保您的计算机满足以下最低系统要求：

下载安装包

访问 CharaStudio 下载页面 获取最新版本的安装包。

Windows 安装

1. 下载 .exe 安装程序
2. 双击运行安装程序
3. 按照安装向导完成安装
4. 首次启动时，CharaStudio 将自动下载所需的 AI 模型（约 3-5 GB）

# 或通过命令行安装
winget install CharaStudio

macOS 安装

1. 下载 .dmg 磁盘镜像
2. 打开镜像并将 CharaStudio 拖入 Applications 文件夹
3. 首次启动时，如果提示"无法打开"，请前往系统设置 > 隐私与安全性进行授权

Linux 安装

# Debian/Ubuntu (.deb)
sudo dpkg -i charastudio_*.deb

# AppImage（通用）
chmod +x CharaStudio-*.AppImage
./CharaStudio-*.AppImage

首次启动设置

首次启动时，请按照以下步骤完成初始配置：

1. 选择语言：在欢迎屏幕上选择您偏好的界面语言（简体中文 / English / 日本語）
2. 配置存储路径：选择项目文件、AI 模型和缓存数据的存储位置
3. 下载 AI 模型：首次使用时，CharaStudio 会引导您下载所需的 AI 模型
4. 登录（可选）：您可以跳过账户登录，直接使用离线功能

验证安装

安装完成后，打开 CharaStudio。如果看到主界面，则说明安装成功。可以尝试以下操作验证全部功能：

• 创建新角色
• 开始新的故事项目
• 探索资产库

常见问题

启动报错"未找到 AI 模型"

这意味着 AI 模型尚未下载。请前往设置 > AI 模型，点击**"下载模型"**按钮。

GPU 加速不工作

1. 前往设置 > 性能
2. 确保**"启用 GPU 加速"**已勾选
3. 确认显卡驱动为最新版本

如何修改数据存储路径

前往设置 > 存储可随时修改数据存储位置。注意：现有项目文件不会自动迁移，需要手动迁移。