夜桜 Sakura ← 返回官网

安装与配置文档

适用于 Windows x64 稳定版 v0.99 · 看这篇就能跑起来

一、快速开始

下载：在官网首页点「下载 Sakura v0.99（Windows x64）」得到一键包。
解压：解压到任意目录（避免中文/带空格路径更省心），例如 D:\sakura。
配置：用记事本改包内 config.toml，填入你的 API 供应商与角色。
安装依赖：双击 install.bat（首次自动装依赖，稍等片刻）。
启动：双击 start.bat。看到桌宠出现即成功。

二、配置 config.toml

核心是把「聊天/回复用的模型」接到你想用的 API 供应商（OpenAI 兼容接口、DeepSeek、GLM、Claude 等均可）。

# config.toml 片段
[vendor]              # 供应商
  name = "OpenAI"
  api_key = "sk-..."  # 你的密钥
  base_url = "https://api.openai.com/v1"

[model]               # 主模型
  name = "gpt-4o-mini"
  temperature = 0.8

想用国内直连的中转/国内大模型时，把 base_url 换成对应服务商地址、name 换成对应模型名即可。不同供应商写法一致，都是 OpenAI 兼容格式。

三、创意工坊内容的安装

角色包、语音、立绘、插件等可变内容，全部在官网「创意工坊」里一站获得，点卡片上的「下载 ZIP」即可。

整包角色（.char）含角色卡 + 立绘 + GPT-SoVITS 语音权重，一键导入。
分件可单独更换某张立绘/某套语音，快速换装。
异角色隔离：混用不同角色的卡与立绘/语音会被自动拦截。

下载后按包内说明导入，或在 Sakura 的角色管理里导入即可。内容与应用版本解耦，换更新版不需要重装内容。

四、常见问题

Q：启动后桌宠不出现？
先确认 install.bat 已跑过、config.toml 的 api_key 正确；再双击 start.bat 看终端报错。

Q：我能用多个不同 API 吗？
可以。不同任务（主回复/记忆/工具）可各自指定供应商，见 config.toml 对应小节。

Q：macOS / Linux？
Windows 是当前主要测试目标；其他平台可按仓库文档手动安装依赖运行。

Q：忘记 API 供应商接法？
接法都是 OpenAI 兼容格式，只需把 base_url 和 name 换成对应服务的地址与模型名。

遇到报错可查看仓库问题区：GitHub · Rvosy/sakura