官方中文正文为项目官方提供的中文文档（原文转载），本站未作翻译、未改动文字，仅剔除图片与无关章节。

你的声音，你的工作流。

从 VoiceStudio 开始（默认引擎，基于 k2-fsa/OmniVoice），也可以选择其他引擎。详见功能与引擎目录。

本地工作流在你的硬件上运行。远程服务为可选功能；使用情况分析须经同意才会启用。

开始使用

一键安装（macOS / Linux）

# 最新 Electron 版本
curl -fsSL https://voicestudio.sh/install | sh

# 指定已发布的 Electron 版本（替换 X.Y.Z）
curl -fsSL https://voicestudio.sh/install | sh -s -- --version X.Y.Z

# 构建当前 main 并安装桌面应用
curl -fsSL https://voicestudio.sh/install | sh -s -- --main

# 卸载应用，保留你的数据
curl -fsSL https://voicestudio.sh/install | sh -s -- --uninstall

下载发行版需要 curl 与 SHA-256 工具。--main 需要 Git、Node.js 22+、Bun、Rust/Cargo 以及平台构建工具；详见安装脚本的前置条件与行为。 安装程序会保留你的设置、项目和模型。旧版本必须包含 Electron 包； 它绝不会回退到已归档的 Tauri 构建。

从 Releases 下载，然后阅读对应平台的安装指南：

macOS · Windows · Linux · Docker

打开声音克隆，选择已有声音或添加清晰的参考录音，输入文字并生成。按提示安装所需模型。硬件要求因引擎而异，详见性能指南。

用提示词安装

粘贴到你的编码智能体（Claude Code、Codex、Cursor 等）：

Install the VoiceStudio Electron app on this device and verify it works, following
https://github.com/debpalash/VoiceStudio/blob/main/docs/install/agent.md

智能体安装指南涵盖硬件检测、复用现有数据、下载模型前先征得同意，以及一次测试生成。支持技能的智能体也可以运行 npx skills add debpalash/VoiceStudio。

git clone https://github.com/debpalash/VoiceStudio.git
cd VoiceStudio
bun install
bun run setup:api  # 启动 Electron 前先准备 Python 依赖
bun run dev

Electron 是唯一的桌面应用与 Web UI。 0.5.3 版是最后一个 Tauri 版本。现有 Tauri 用户必须单独安装 Electron。已退役的 Tauri 外壳和旧版 UI 入口均已移除。

文档

智能体技能：npx skills add debpalash/VoiceStudio — 音频工作流选 voicestudio，仓库维护选 voicestudio-maintainer。

许可与负责任使用

应用采用 AGPL-3.0 许可。模型遵循各自的许可，商用前请确认其条款。克隆声音前须取得本人许可。详见许可说明。