语音嫁接 Akillll-DuoHe/voice-grafting

语音嫁接

给 DeepSeek Harness（DSH）接入本地听说能力，并提供一个可独立使用的 QQ 桥。这里是后续修复、维护、构建发行包的源码仓。

从这里开始：按顺序拿

| 顺序 | 拿什么 | 在哪 | 大小 |
| 1 | 源码与文档（先读一遍） | GitHub ｜ Gitee | 约 3 MB |
| 2 | 独立 QQ 桥离线包 | 两个仓的 Release 附件，或 百度网盘（提取码 jjsz） | 73 MB |
| 3 | 通用声音包离线包 | 百度网盘（提取码 f9g2） | 25.67 GB |

- 声音包整包超过平台单文件上限（GitHub 附件 2 GB、Gitee 单文件 100 MB），只能走网盘；下载后请核对对应 Release 里公布的 SHA256。
- 建议顺序：clone 源码 → 读 项目详细记录与维护总览 和两个产品的 README → 先装 QQ 桥 → 再按需装声音包。两个包都先跑「环境检查.cmd」，再跑「安装配置.cmd」。
- 源码仓不含模型和运行时；不下载离线包就得自己准备 Node/Python 与模型（模型来源见各包 LICENSES.md）。
- 声音包可精简：不唱歌删 models/vevo2，不用备选 TTS 删 models/qwen3-tts-1.7b-base；models/voxcpm2 与 runtime/ 不要删。

先看哪里

- 完整说明入口：项目详细记录与维护总览。
- 总体框架与嫁接原则：两条接入路线、各层职责。
- 声音素材、克隆、训练与唱歌：用了什么，使用者提供什么，如何一步步做。
- 本地记忆与上下文规则：压缩、换会话、检索和预算。
- 版本维护、构建与发布：以后在这里改代码。
- 施工记录与验证状态：已完成什么，哪些还要实测。
- 分发清单与隐私边界：哪些能上传，哪些必须留在本机。
- 视频文案要点：对外讲解的简版提纲。

两个包

| 包 | 用途 | 当前插件版本 |
| 通用声音包 packages/voice | 给已有 DSH/平台桥增加本地 ASR、TTS 和可选歌声转换、训练工具 | 0.3.0 |
| 独立 QQ 桥 packages/qq-bridge | 自备角色 QQ，通过 NapCat / OneBot 接 DSH；可再接通用声音包 | 0.8.0-offline.3 |

不包含虚拟形象和嘴型同步。其他人的平台桥可以接声音服务，但需要按其接口做适配；安装声音包不会自动改写每一种第三方桥。

目录

语音嫁接/ packages/ 两个发行产品的源码、安装入口、依赖说明 shared/ 记忆、点歌、回复偏好的共同源码 scripts/ 同步、检查、测试、构建、版本维护工具 tests/ 无真实账号、无模型推理的回归测试 docs/ 详细记录、原则、维护方法、发行记录 VERSION.json 两个组件的版本表维护.ps1 本机维护入口发行包/ 今天已完成的两个 ZIP 和校验文件（Git 忽略）本地资源/ 干净的模型、便携运行环境、发行基线（Git 忽略）本机私有/ 私人规则和历史施工记录（Git 忽略）构建产物/ 以后生成的候选包（Git 忽略）

本仓公开的“规则”是通用技术规则；角色人设、账号、聊天、参考声线和私人歌曲不进入源码仓或公共发行包。不要把整个根目录直接打包上传。只上传 Git 跟踪的公开文件；大体积离线包通过独立附件发布。

开始维护

在本目录打开 PowerShell：

.\维护.ps1 test .\维护.ps1 check .\维护.ps1 build-code

需要 Node 24.20 或更新版本，以及 Python 3.11 或更新版本。维护入口优先使用本机资源目录中已带的便携解释器；源码仓本身不依赖全局 npm 安装。test 只跑离线测试，不登录 QQ、不调用模型、不生成媒体。

build-code 只验证源码装包，不是完整离线包。真正的完整离线构建使用 build-offline，会从本地资源复制约数十 GB 的依赖和模型。此命令不会启动模型。详细步骤见版本维护文档。

当前基线

2026-11-01 两个 ZIP 保留原始内容，发行清单在 发行历史。本次整理不替换原系统正在运行的部署目录；运行现场与新源码仓之间的关系，记录在本机私有交接文件中。

自有源码按 MIT 授权；第三方桥、模型、运行库各自保留原许可。尤其 Vevo2 权重和 NapCat 有使用、分发限制，不能把整个合集称为无限制商用。详见两个产品的 LICENSES.md。