English · 中文
这是一套面向 Codex 的本地声音克隆与配音质量控制工作流。它以 CosyVoice2 为本地引擎，支持英文专有名词发音、语气和节奏指导、生成留痕与技术质量检查，不需要为每次生成调用付费语音 API。
“免费”指不产生按次 API 调用费，不等于零成本。电脑、模型下载、存储、电费、部署时间和维护仍由使用者承担。
- 参考声音和生成音频留在本机。
- 通过任务词典控制英文产品名、公司名和人名的读法。
- 提供自然、沉稳、温暖、严肃、表现力和有活力六种克制的配音方向。
- 只迁移来源音频的整体语速、停顿、音高范围和能量范围，不复制来源说话人的身份。
- 明确区分已生成、技术检查通过、人工听感通过、已插入视频、已渲染和已发布。
- 合成前必须确认声音权利与使用授权。
仓库不会附带任何声音样本。公开验证只检查可安全公开的编排层：
$ python3 scripts/test_core.py
core tests passed
$ python3 scripts/validate_repository.py
repository validation passed
真实声音效果仍取决于授权参考音频、CosyVoice2 环境、模型、语言和电脑性能。正式使用前必须完成环境检查和人工试听。
可以查看脱敏的 dry-run 规划结果，了解专名替换与分句结果；该示例不包含任何音频。
git clone https://github.com/yjin5562-dev/local-voice-cloning-director.git \
~/.codex/skills/local-voice-cloning-director重启或刷新 Codex。这个 Skill 允许语义自动调用，之后正常说“用我授权的声音给这段视频配音”即可，不需要每次主动说 Skill 名称。
仓库已经包含经过验证的 .codex-plugin/plugin.json，可用于插件目录和本地插件打包。在进入插件目录之前，方式 A 是最短安装路径。
根据 CosyVoice 官方仓库单独安装 CosyVoice2，然后配置：
export COSYVOICE_ROOT=/path/to/CosyVoice
export COSYVOICE_MODEL=/path/to/CosyVoice2-0.5B
export COSYVOICE_PYTHON=/path/to/cosyvoice/python
python3 scripts/check_environment.py下载模型或修改环境前，先阅读完整环境约定。
- 确认声音属于本人，或者已经取得覆盖本次用途的授权。
- 准备一段干净的 6–15 秒参考音频和完全一致的逐字稿。
- 先检查 dry-run 生成计划，包括分句、专名替换、语气与速度。
- 使用 CosyVoice2 在本地生成。
- 运行技术质量检查，再单独完成人工听感确认。
完整命令和阶段门见 SKILL.md，脱敏的纯文本示例见 examples/。
只能克隆自己的声音，或已经获得明确授权的声音。不得用于冒充、公人物克隆、欺诈、身份验证、骚扰、欺骗性政治传播或规避平台披露要求。
参考录音、精确逐字稿、生成音频、哈希和回执都属于私人生产数据，必须放在仓库外。详见 SECURITY.md 和安全边界。
欢迎提交安装反馈、质量边界、安全语言支持和隐私改进。请先阅读 CONTRIBUTING.md，或使用仓库提供的结构化 Issue 表单。
本仓库原创的编排代码和 Skill 指令采用 MIT 许可证。CosyVoice、模型、FFmpeg、Whisper 与可选 Python 包仍受各自许可证约束，详见 THIRD_PARTY_NOTICES.md。