💰 AI 语音与视频实战指南(上):语音克隆、音乐生成与会议输入

周店瑟谷 1 阅读 效率软件与工具

2026 年可能是「个人也能完成全流程音视频生产」的分水岭。语音克隆跑进四核 CPU、代码渲染视频不再需要剪辑师、多智能体流水线把数字人口播压到每条几元——门槛塌了之后,真正的问题从「能不能做」变成了「怎么做得又稳又省」。

本文是整个系列的上篇,先把音频侧的三条链路彻底拆开:语音克隆与 TTS 模型选型、可编辑的音乐生成、以及会议录音与麦克风替代。每一节都给出实测级的硬件门槛、可执行的安装命令、关键参数与避坑指南,并逐一纠正了流传甚广的认知误差。视频生产链路的完整拆解见下篇。

一、先看清格局:音视频生产的四层分工

在展开具体项目之前,有必要先建立一个统一的认知框架。音视频生产不是一条流水线,而是四层各自独立、可以分别选型的技术栈。

图 1:音视频生产的四层分工,每层可独立替换而不影响其他层
图 1:音视频生产的四层分工,每层可独立替换而不影响其他层

这个框架的核心价值在于:每一层都可以单独替换而不影响其他层。比如你在第七章提到的「音频优先架构」——先出配音再用音频时长反推分镜时长——就是层次解耦带来的直接收益。反之,如果把四层揉成一个黑盒工具,任何一处不满意就得整体重跑,这在生产上是不可接受的。

第二个关键认知是成本结构的位移。2026 年最大的变化是:代码渲染路线(Remotion、HyperFrames、video-talkcraft)的渲染成本降到了零,真正的开销转移到了模型调用费上。很多人算成本时只算了模型调用,却忽略了规模化后可能出现的工具授权最低消费(详见下篇「成本对照表」)。这一点我在下篇的成本章节详细展开。

第三个认知是本地化驱动力已经变了。原本推动本地部署的是隐私,但 2026 年真正的购买理由变成了合规与成本。具体证据和数据见本篇第四章「本地离线与云端 API 的真实取舍」。


二、语音链路:克隆与 TTS 模型选型

语音是整条链路的地基。视频的口播、有声书的旁白、数字人的声音,全部从这里出发。当前的开源生态提供了从「0.1B 跑在四核 CPU」到「2B 追求录音室级」���完整梯度,选型不再是「能不能用」的问题,而是「匹配哪段硬件预算」。

2.1 GPT-SoVITS:生态最全的少样本克隆工作台

仓库:https://github.com/RVC-Boss/GPT-SoVITS | License:MIT(商用无限制)

GPT-SoVITS 是中文社区最活跃的语音克隆工具,也是很多人的入门首选。它的核心竞争力不在某个指标上的极致,而在于完整的工具链和教程生态——训练 WebUI、推理 WebUI、人声分离、Docker 部署一应俱全。

核心能力:Zero-shot 克隆只需 5 秒参考音频;Few-shot 微调只需 1 分钟训练数据。支持中、英、日、韩、粤五种语言。

版本线是选型的关键。官方同时维护 V1 / V2 / V2Pro / V3 / V4 五条线,共用同一套代码、通过启动参数切换:

版本

特点

适用场景

V2

预训练从 2k 小时扩到 5k 小时,新增韩语、粤语

通用场景,稳妥之选

V2Pro / v2ProPlus

性能超过 V4,显存略高于 V2

追求质量,官方 RTF 数据来源

V3

不微调也有较高音色相似度,情绪更丰富

手头没有优质训练集

V4

修复 V3 非整数倍上采样导致的金属杂音,原生 48kHz

V3 的直接替代

官方给出了一条很有价值的选型建议(README 原文):「训练集音频质量平均的情况下,v1/v2/v2Pro 能给出不错的结果,但 v3/v4 不能。此外 v3/v4 的合成音色和时长更倾向于参考音频而非整个训练集。」

这句话的实际含义是:如果你手里的训练集质量参差不齐,选 V2Pro;如果你有一批高质量录音,选 V4。这不是「越新越好」的简单逻辑。

性能数据(v2ProPlus,官方实测):

硬件

RTF

RTX 4090

0.014

RTX 4060Ti

0.028

M4 CPU(纯CPU推理)

0.526

安装:

conda create -n GPTSoVITS python=3.10
conda activate GPTSoVITS
# Linux / macOS
bash install.sh --device <CU126|CU128|ROCM|CPU> --source <HF|HF-Mirror|ModelScope>
# Windows PowerShell
pwsh -F install.ps1 --Device <CU126|CU128|CPU> --Source <HF|HF-Mirror|ModelScope>

Windows 用户有整合包,双击 go-webui.bat 即可。Linux/macOS 上入口脚本是 webui.py(训练)和 GPT_SoVITS/inference_webui.py(推理)。依赖 Python 3.9–3.12、PyTorch 2.5.1/2.7.0、ffmpeg、ffprobe。

关键参数:

  • 训练侧:batch_size、epochs、save_every_n_epoch、if_save_latest、if_save_every_weights

  • 推理侧:ref_audio_path、prompt_text、prompt_lang、target_text、target_lang、speed_factor、fragment_length、split_method、seed

  • Docker 环境下可用 is_half 环境变量开启 fp16 降显存

避坑要点:

  1. macOS GPU 训练质量明显偏低,官方已暂时改用 CPU 训练。Mac 用户若追求音质,建议直接考虑 VoxCPM2 的 Metal 后端。

  2. 中文需要额外下载 G2PWModel 放到 GPT_SoVITS/text 目录,漏了会导致多音字读错。

  3. UVR5 人声分离模型文件名必须包含 roformer 字样,且 config 与 ckpt 必须同名对应,否则不被识别。

  4. Docker Desktop 默认 shm_size 过小会导致异常,需调整到 16g。

  5. 官方从未公布过参数量。第三方文章常见的「GPT 模块 12 层 Transformer / 512 维」等数字来自技术拆解分析而非官方文档,引用时请注明来源。

2.2 VoxCPM2:Tokenizer-free 的方言与多语种高地

仓库:https://github.com/OpenBMB/VoxCPM | License:Apache-2.0(可商用)| 论文:arXiv:2609.24650 / VoxCPM2 arXiv:2606.06928

VoxCPM 是面壁智能(OpenBMB)与清华大学深圳国际研究生院人机语音交互实验室(THUHCSI)联合研发的项目,归属上写「清华开源」不算错,但更准确的表述是深研院合作项目,MiniCPM 团队出品。

它的技术路线非常独特:Tokenizer-free。传统 TTS 先把音频离散化成 token 再建模,会损失信息;VoxCPM 直接在 AudioVAE V2 的潜空间里做端到端 diffusion autoregressive 生成,绕开了离散化环节。

版本演进很能说明问题:

VoxCPM-0.5B

VoxCPM1.5

VoxCPM2

参数量

0.5B

0.6B

2B

语言数

2(中/英)

2(中/英)

30

采样率

16kHz

44.1kHz

48kHz

克隆模式

仅续写

仅续写

独立参考 + 续写

Voice Design

❌

❌

✅

可控克隆

❌

❌

✅

显存

~5GB

~6GB

~8GB

RTF (4090)

~0.17

~0.15

~0.30

「30+ 语言」是 VoxCPM2 才具备的能力,原始 0.5B 版本只有中英双语——这是版本混淆的高发点。30 种语言包括中、英、日、韩、俄、法、德、西、葡、越、泰、印尼、阿拉伯语、希伯来语、波兰语等,另支持 9 种中文方言:四川话、粤语、吴语、东北话、河南话、陕西话、山东话、天津话、闽南话。输入文本无需语言标签。

Ultimate Cloning 是它最实用的能力:同时提供参考音频和其转写文本,模型从参考处无缝续写,保留全部韵律细节。相比只给音频的方案,韵律保真度明显更好。

安装与调用:

# WebUI
python app.py
# LoRA 微调
python lora_ft_webui.py
wav = model.generate(
    text="...",
    reference_wav_path="path/to/voice.wav",
    cfg_value=2.0,          # 引导强度
    inference_timesteps=10, # CFM 步数
    seed=42,
)

端侧推理走 llama.cpp-omni(GGUF,原生支持 CPU/Metal/CUDA/Vulkan):

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --target voxcpm2-cli -j
./build/bin/voxcpm2-cli -t "文本" -r speaker.wav -o clone.wav \
    VoxCPM2-BaseLM-Q8_0.gguf VoxCPM2-Acoustic-F16.gguf

M4 Pro / Metal 下 RTF 约 1.76(Q8_0 量化),完全可接受。官方还提供 vLLM-Omni recipe(带 PagedAttention 与 OpenAI 兼容 API),RTF 可降至约 0.13。

避坑要点:

  1. 可控生成稳定性不足——Voice Design 和 Controllable Cloning 每次运行结果可能不同,官方自己建议生成 1~3 次挑选。追求确定性的话,应优先用 Ultimate Cloning 模式。

  2. 官方明确禁止用于冒充、欺诈、虚假信息,并要求明确标注 AI 生成内容。

  3. 非 30 语言列表内的语种需自行微调。

2.3 MOSS-TTS-Nano:0.1B 参数把门槛压到四核 CPU

仓库:https://github.com/OpenMOSS/MOSS-TTS-Nano | License:Apache-2.0 | 发布:2026-04-10 | 论文:arXiv:2603.18090

这是 2026 年最值得关注的新项目,也是本轮调研中「笔记信息命中率最高」的一条——原始笔记里的「0.1B / 四核 CPU / 流式 / 20种语言 / zero-shot 克隆」全部精确命中。

它由MOSI.AI + OpenMOSS 团队、复旦 NLP Lab 出品,规格如下:

项

值

参数量

0.1B(约 100M)

架构

纯自回归 Audio Tokenizer + LLM;Local Transformer + RVQ

输出

48kHz 双声道(原生规格,同类少见)

语言

20 种

流式

✅ 低首token 延迟

CPU

✅ 4 核可流式运行

长文本

✅ 自动分块保持克隆一致性

20 种语言:中、英、德、西、法、日、意、匈、韩、俄、波斯、阿、波兰、葡、捷、丹、瑞、希、士。注意:官方未列出任何方言支持,如果你的需求是方言,VoxCPM2 更合适。

配套的 MOSS-Audio-Tokenizer-Nano 约 20M 参数,CNN-free 纯因果 Transformer,RVQ 16 层码本,12.5Hz token 流,可变码率 0.125–2 kbps。

安装:

conda create -n moss-tts-nano python=3.12 -y
conda activate moss-tts-nano
git clone https://github.com/OpenMOSS/MOSS-TTS-Nano.git && cd MOSS-TTS-Nano
pip install -r requirements.txt && pip install -e .

官方首推ONNX CPU 版:

python infer_onnx.py --prompt-audio-path assets/audio/zh_1.wav --text "..."
python app_onnx.py     # FastAPI WebUI
# 需要 GPU 时需先卸载 CPU 版 onnxruntime
python infer_onnx.py --execution-provider cuda ...

也提供 PyTorch 版(infer.py)、CLI 打包(moss-tts-nano generate)、以及服务化方案(vLLM-Omni,提供 paged KV cache、streaming、OpenAI 兼容的 /v1/audio/speech)。

避坑要点:

  1. pynini / WeTextProcessing 安装冲突是最大痛点,官方给出 Conda workaround:
    bash conda install -c conda-forge pynini=2.1.6.post1 -y pip install git+https://github.com/WhizZest/WeTextProcessing.git pip install -r requirements.txt
    非 Conda 环境需自行寻找匹配 Python 版本与平台的 pynini wheel。

  2. README 的 License 章节仍写着「若在 LICENSE 发布前读到此处,视为未授权再分发」——这是遗留文案,实际 LICENSE 文件已是 Apache-2.0。建议引用 LICENSE 文件本体。

  3. 音质定位为「实时产品够用」,非录音室级。它和 VoxCPM2 不是替代关系,而是「端侧 vs 精品」的分工。

2.4 腾讯 AuK:一个模型统一十六项音频任务

仓库:https://github.com/Tencent-Hunyuan/AuK | License:MIT | 发布:2026-09-09 | 论文:arXiv:2609.08936

AuK 由腾讯混元 + 上海交通大学 + 上海创智学院联合研发,是目前功能边界最宽的语音模型。它的思路是:用一个模型替代串联 TTS / VC / 降噪 / 分离的多个专用模型,全部任务走同一个 message-based 接口。

16 项任务分五类:

类别

任务

生成

Zero-shot TTS、Instruct TTS(纯文字描述生成声音,无需参考音频)

内容编辑

改词/插入/删除、改歌词(保留旋律与音色)

声学编辑

音高(半音)、语速、音量(dB)

副语言编辑

情绪、音色、去口音、增删呼吸/笑声/咳嗽、whisper 转换

增强与分离

降噪、去混响、按说话顺序分离、从音乐中提取人声、按内容提取目标说话人

架构上,生成器为 1.5B(MMDiT + single-stream DiT rectified-flow),语义编码器是 Qwen2.5-Omni-3B,配合 50Hz 音频 VAE。训练数据规模是 30.3 亿条指令-音频对 + 195万小时音频,经 RLHF 后训练。

⚠️ 显存数据必须纠正:原始笔记写「6GB 显存即可运行」,这是错的。官方在 A800-80GB 上用 torch.cuda.max_memory_allocated 实测:

模型

输入

关闭CPU offload

开启 CPU offload

AuK

纯文本,1.5s 输出

24.78 GiB

16.75 GiB

AuK

5s 参考音频

25.00 GiB

16.98 GiB

AuK-Flash

纯文本,1.5s 输出

24.77 GiB

16.75 GiB

AuK-Flash

5s 参考音频

24.97 GiB

16.98 GiB

最低约 17GB,这是消费级显卡的硬门槛。RTX 4090(24GB)关闭 offload 能否跑通,官方未给数据,建议实测。

安装与推理:

git clone https://github.com/Tencent-Hunyuan/AuK && cd AuK
uv venv --python 3.10 && source .venv/bin/activate
uv pip install -e ".[gradio]"     # 或 [comfyui] / [train]

hf download tencent/AuK --local-dir ./ckpts/AuK
hf download tencent/AuK-Flash --local-dir ./ckpts/AuK-Flash
hf download Qwen/Qwen2.5-Omni-3B --local-dir ./ckpts/Qwen2.5-Omni-3B
# Zero-shot TTS
auk-infer --audio ref.wav \
  --instruction "Say the following with the same voice: '...'" \
  --output out.wav --gen_seconds 6.0

# AuK-Flash:4 步固定,CFG=0
auk-infer --ckpt ckpts/AuK-Flash/auk_flash.safetensors \
  --cfg 0 --nfe 4 --sway -1 ...

--instruction 是必填项,这是 AuK 与其他模型最大的交互差异——你必须用自然语言描述「怎么说」,而不只是给文本。

避坑要点:

  1. 30 秒硬限制:源/参考音频 + 生成目标合计必须 ≤30 秒,且节点不会自动切分长音频。长内容必须自行分段。

  2. ComfyUI 不支持自动 VRAM offload,需手动在 Loader 里开启 cpu_offload。

  3. Prompt Enhancer 读取 .env,必须在启动 ComfyUI 之前加载,否则报错。

  4. MLLM 编码器固定 Qwen2.5-Omni-3B,--qwen_path 不支持 Qwen3-Omni。

  5. 加载 ckpt 时缺 text_encoder.* 键是正常现象,编码器和 VAE 是运行时单独加载的。

  6. 官方 README 的任务表未列出支持语种,中文任务示例存在,但覆盖几种语言、有无方言需查论文正文。

部署生态是AuK 的明显优势:Day-0 支持 SGLang-Omni、vLLM-Omni(单 H100 两阶段管线)、audio.cpp(GGUF --family auk)、Apple Silicon MLX、ComfyUI 官方节点、Gradio,另有完整微调管线。

2.5 abogen:从电子书到带章节的 M4B 有声书

仓库:https://github.com/denizsafak/abogen | License:MIT | 底层模型:Kokoro-82M(Apache-2.0)

abogen 解决的是一个具体但真实的需求:把手头的电子书批量转成能播的有声书。它支持 ePub、PDF、纯文本、Markdown 输入,另支持 TXT、SRT、ASS、VTT。

功能核实全部命中:

功能

说明

自动加章节标记

从 ePub/Markdown 选章节,PDF 支持「章节 + 页」

M4B 带封面

<<METADATA_COVER_PATH>>,从 EPUB/PDF 自动提取封面

M4B 带作者信息

自动写入 title / artist / album / year / album_artist / composer(narrator) / genre

NVIDIA 加速

CUDA 12.6 / 12.8 / 13.0

AMD 加速

ROCm 6.4,但仅 Linux

Docker

docker build -t abogen .

M4B 元数据标签写法(写在文本文件开头):

<<METADATA_TITLE:Title>>
<<METADATA_ARTIST:Author>>
<<METADATA_ALBUM:Album Title>>
<<METADATA_YEAR:Year>>
<<METADATA_ALBUM_ARTIST:Album Artist>>
<<METADATA_COMPOSER:Narrator>>
<<METADATA_GENRE:Audiobook>>
<<METADATA_COVER_PATH:path/to/cover.jpg>>

安装(注意 espeak-ng 必须独立安装,Windows 还要 --index-strategy unsafe-best-match):

# NVIDIA (Windows, CUDA 12.8)
uv tool install --python 3.12 abogen[cuda] \
  --extra-index-url https://download.pytorch.org/whl/cu128 \
  --index-strategy unsafe-best-match
# AMD (Linux, ROCm 6.4)
uv tool install --python 3.12 abogen[rocm] \
  --extra-index-url https://download.pytorch.org/whl/nightly/rocm6.4 \
  --index-strategy unsafe-best-match
# 纯 CPU
uv tool install --python 3.12 abogen

关键参数:语速 0.1x–2.0x;字幕粒度可选 Disabled / Line / Sentence / Sentence+Comma / Sentence+Highlighting / 1-3 words / 自定义;字幕格式支持 SRT 与 ASS(宽/窄/居中宽/居中窄);输出音频支持 WAV / FLAC / MP3 / OPUS(压缩最佳) / M4B(带章节);字幕变速策略有 TTS Regeneration(音质好)与 FFmpeg Time-stretch(速度快)两档;另有章节静音间隔与语音混音器(按权重混合 Kokoro 语音并存为 profile)可调。

避坑要点:

  1. 单词级字幕仅对英文有效——Kokoro 只为英文提供时间戳 token,中文/日文只能走句子和逗号切分,字幕会偏长。这是中文用户最需要预期管理的限制。

  2. AMD/ROCm 仅 Linux,Windows 用户无法加速。

  3. 界面是 PyQt6 桌面端 + 独立的 abogen-web(Flask,端口 8808),两者功能不完全对等——Supertonic TTS、LLM 文本规范化、Audiobookshelf 集成目前只在 web 端。

  4. Docker 部署需处理 UID/GID 文件权限;Nginx 反代时需关闭 Block Common Exploits(会剥掉 Authorization 头)。

同类的另一个选择:Audiobook Creator(https://github.com/ezionian/audiobook-creator )满足部分相同描述,但多出一个 abogen 没有的能力——多声线按角色分配(GLiNER NER + LLM 判定性别年龄)。代价是License 为 GPL-3.0(有传染性),且必须自备 OpenAI 兼容 LLM + Kokoro-FastAPI 服务,Docker 需同时起三个服务并依赖 host 网络,Apple Silicon 走 CPU。

2.6 VoiceStudio:本地 ElevenLabs 替代品

仓库:https://github.com/debpalash/VoiceStudio | 官网:voicestudio.sh | License:AGPL-3.0 ⚠️

VoiceStudio 的定位是「一站式本地语音工作台」,覆盖语音识别、声音设计、语音克隆、视频配音、文字转有声书六项功能,数据全部本地存储。

规模上它是最全的:16 个 TTS 引擎 + 11 个 ASR 引擎,架构为 Electron 桌面壳 + Python FastAPI 后端(仅监听 3900 端口)。

⚠️ 「0 成本」这个说法需要重新表述。 官方描述的确切含义是:没有账号、没有 API key、没有订阅、没有按字符计费,唯一支出是你自己的 CPU/GPU 时间。所以「零 API 费用」成立,但软件本身不是零成本——它是 AGPL-3.0。

商用风险是本次核查中最关键发现:

  • 应用层 AGPL-3.0,允许免费商用,但网络部署(SaaS)会触发源码开放义务

  • 模型权重各持独立许可。README 明确警告:默认 OmniVoice 预训练权重标记为 CC-BY-NC(非商业)

  • 官方结论是「模型许可不限制生成音频,但选模型前必须逐个确认」

  • 若要用于客户的有偿项目,默认引擎 OmniVoice 因CC-BY-NC 直接不可用,必须换引擎

硬件要求:GPU 可选,4GB 显存为加速下限,推荐 8GB+;大型可选引擎需 12–16GB+。CPU 可跑但建议轻量引擎(KittenTTS / Supertonic-3 / PocketTTS)。Intel Mac 无法运行本地后端(PyTorch wheel 不可用),只能连远程后端。

安装:

curl -fsSL https://voicestudio.sh/install | sh
curl -fsSL https://voicestudio.sh/install | sh -s -- --version X.Y.Z
curl -fsSL https://voicestudio.sh/install | sh -s -- --uninstall

也可从 Releases 下载 macOS DMG / Windows x64 installer / Linux AppImage / Docker。

关键参数:

  • 克隆参考音频:3 秒为下限,官方建议 5–15 秒干净单人录音

  • 本地 API(OpenAI 兼容):http://localhost:3900/v1

  • MCP:http://localhost:3900/mcp

  • 支持 HTTP / SSE / WebSocket

  • 支持 CUDA / MPS / MLX / ROCm / CPU 四类后端自动路由

避坑要点:

  1. 安装包未签名(macOS 未做 notarization),系统必然告警,须从官方 Release 下载并校验 SHA-256。

  2. 646 种语言容易被误读——这是 16 个 TTS + 11 个 ASR 引擎的目录合计值,单一引擎通常只支持 9–31 种。

  3. 架构变更警告:README 明确「Electron 是唯一的桌面应用与 Web UI,0.5.3 版是最后一个 Tauri 版本」。若参考资料写「Tauri v2 桌面应用」,说明信息已过时。

  4. 首次启动要下载数 GB 模型。

  5. 注意 latentforge/VoiceStudio(11 stars,Apache-2.0)是另一个同名无关项目,不要混淆。

2.7 横向对比与选型决策树

基础参数与适用场景(✅ 表示支持或无限制,❌ 表示不支持):

项目

参数

License

商用

显存/硬件

语言/方言

最适合

不适合

GPT-SoVITS

未公布

MIT

✅

消费卡

5 种/仅粤语

中文配音、快速验证、攒训练集微调

追求开箱即用与极致音质

VoxCPM2

2B

Apache-2.0

✅

~8GB

30 种 / 9 种方言

需方言、48kHz 成品音质

要 Voice Design 稳定复现;低显存机器

MOSS-TTS-Nano

0.1B

Apache-2.0

✅

4 核 CPU

20 种 / ❌

端侧、嵌入式、浏览器内

录音室级音质;方言

AuK

1.5B + 3B 编码器

MIT

✅

17–25GB

未列 / 需自测

音频编辑、降噪分离、改歌词

消费级显卡;长音频(30s 限制)

abogen

Kokoro-82M

MIT

✅

CPU/CUDA/ROCm

Kokoro / 弱

快速产出带章节封面的 M4B

多角色有声书;Windows AMD

VoiceStudio

集成 16+11 引擎

AGPL-3.0

⚠️ 受限

4GB 下限

646(引擎合计)

一站式桌面工作台、Agent 集成

闭源商用交付;Intel Mac

关于「语言数」的常见误读:VoiceStudio 的 646 种是 16 个 TTS + 11 个 ASR 引擎的目录合计值,单一引擎通常只支持 9–31 种。

选型决策树:

图 2:语音模型选型决策树,先看显存约束再看功能需求
图 2:语音模型选型决策树,先看显存约束再看功能需求

关于有声书生成的补充建议:若你的核心需求是「单工具、开箱即用」,选 abogen;若核心需求是「多人角色有声书」,选 Audiobook Creator,但必须提前接受 GPL-3.0 的传染性和更复杂的服务编排。


三、音乐链路:可编辑的音乐生成

「从歌词生成歌曲」现在已经不稀缺了,真正的分水岭是能否编辑。这一节的核心项目 YuE2 之所以值得关注,正是因为它把音乐生成从「盲盒」变成了「可读可改的工程」。

3.1 YuE2:把乐谱变成可读可改的控制面板

仓库:https://github.com/multimodal-art-projection/YuE | License:代码/文档/agent skill 为 Apache-2.0,模型权重为 CC BY-NC 4.0 + 附加创作者许可 | 论文:arXiv:2609.33757

在展开之前必须先澄清一个常见误解:ACE-Step 和 YuE2 解决的是两个不同的问题。ACE-Step 是「歌词生成歌曲」这一半的正确答案,但它没有乐谱层——官方 README 中 midi、notation、symbolic、score(作为乐谱义)零命中。而笔记里「编辑乐谱调整旋律、和弦」这个描述,精确指向YuE2。

YuE2 官方 README 第 66 行的原��最能说明它的设计哲学:

White-box music generation through symbolic planning. Read, play, and change the composition before rendering it. Melody and chords become explicit controls that a person or an agent can inspect and edit.

技术架构:单个 AR–NAR Mixture-of-Transformers 骨干——自回归预测记谱与语义 token,再用 flow matching 生成声学 latent,VAE 解码成立体声。

核心是用 ABC 记谱(不是 MIDI)做规划层,四个关键设置:

设置

行为

推荐场景

cot="full"

生成含旋律 + 和弦的可编辑计划

新歌默认

cot="melody"

仅旋律计划,伴奏自由生成

cover 场景推荐

cot="off"

直接从歌词 + 风格生成,不做规划

快速试听

abc=...

直接提供你自己的乐谱

精确控制

ABC 记谱相比 MIDI 的优势在于文本可读、可 diff、可被 agent 直接修改。这对于「让 AI 帮你改歌」的场景是决定性的——MIDI 是二进制结构,agent 难以可靠地编辑;ABC 记谱是纯文本,agent 读得懂、改得动。

ComfyUI 支持是官方原生且已合并:comfyanonymous/ComfyUI#16250「Support Yue2 music model.」创建并合并于 2026-09-11。要求 ComfyUI ≥ v0.35.0(AMD GPU 建议 ≥ v0.35.1)。

模型放置路径:

ComfyUI/models/checkpoints/yue2_3b_int8_convrot.safetensors
ComfyUI/models/audio_encoders/sheetsage2_bf16.safetensors   # 仅 cover 需要

ComfyUI 节点的真实参数(以下数字均来自官方文档):

参数

数值 / 说明

Max Duration

上限 900 秒;Text-to-Music 模板默认 120 秒,Music Cover 节点默认 360 秒

生成预算

每秒 25 个 semantic token

cfg_scale

0–100,默认 1.0。1.0 = 关闭 guidance;1.01 = 该选项加入前模型的原始行为

abc 留空

关闭规划,直接生成

上下文不足时会自动降预算并在控制台告警:YuE2 music budget reduced to ... tokens (... seconds) to fit the prompt.;完全无空间时报 YuE2 prompt leaves no room for music; shorten the style, lyrics, or ABC.;乐谱被截断会报 YuE2 abc reached its token budget before the end token.,此时需调高 max_abc_tokens。

⚠️ 硬件门槛必须说清。官方明确要求:

Linux · Python 3.12 · NVIDIA GPU with BF16 support and 24 GB VRAM. YuE2 produces 48 kHz stereo audio without quantization.

而 ComfyUI 提供的是 yue2_3b_int8_convrot——int8 量化 + convrot 版本。这就是「官方要求 24GB」与「ComfyUI 能跑在消费级卡上」差异的来源。同一模型在两条路径上的硬件要求差4–6 倍。写方案时必须说清走的是哪条路,否则会误导读者。

Cover 工作流(这是 YuE2 最有差异化的能力):

Reference Audio → SheetSage2(转录) → Melody ABC 乐谱 → YuE2(新风格 + 新歌词)

关键限制:因为连接原曲的只有旋律,所以新歌词「stay reasonably close to the original phrasing and syllable count」时匹配度最好。建议 cot="melody" + 不带和弦符号的乐谱。

安装:

git clone https://github.com/multimodal-art-projection/YuE.git
cd YuE
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip && python -m pip install .
python examples/generate.py --output outputs/first-song

输出 outputs/first-song/audio.flac,同目录会保留 score、semantic tokens、acoustic latents、生成设置与模型标识——这点对「可审计的生成过程」很有价值。

3.2 ACE-Step:音频域编辑的另一种哲学

如果笔记里指的是「MIDI 导入/导出 + 钢琴卷帘」,最匹配的则是 Plenio(仅 27 star,小众实验项目);而如果核心诉求是「音频域的编辑能力」,ACE-Step 是这个方向的答案。

两个版本需注意区分:ACE-Step v1(ace-step/ACE-Step,4,881 star,Apache-2.0)已于 2026-02-15 停更;ACE-Step 1.5(ace-step/ACE-Step-1.5,13,073 star,MIT)仍活跃,最后推送 2026-10-05。

v1 的编辑能力(全部为音频域操作,无乐谱/MIDI):Text2Music / Retake(variance 调节)/ Repainting(指定起止秒数重绘)/ Edit(only_lyrics 保留旋律 vs remix 改变旋律)/ Extend。另有 lyric2vocal、text2sample、RapMachine、StemGen、singing2accompaniment 等 LoRA。

⚠️ 必须澄清的常见混淆:v1.5 支持 BPM / key / scale / 拍号元数据控制——这是元数据控制,不是乐谱编辑,两者常被混为一谈。若你需要真正的旋律/和弦编辑,请用 YuE2。

v1.5 的硬件矩阵(官方README):≤6GB 用 2B turbo + INT8 量化 + 全 CPU offload(无需 LM);6–8GB 加 acestep-5Hz-lm-0.6B;8–16GB 可上 1.7B LM(后端 vllm);16–20GB 用 2B sft 或 XL turbo(XL 需 offload);20–24GB XL 无需 offload;≥24GB 可用 acestep-5Hz-lm-4B。

其他事实:时长 10 秒–10 分钟;50+ 语言(中英日韩西德法意俄优化);<4GB VRAM 可跑;A100 <2 秒/首、RTX 3090 <10 秒/首;LoRA 训练「8 首、3090 上 1 小时」。XL 系列(4B DiT)权重约 9GB bf16(2B 为 4.7GB)。

避坑要点:ComfyUI 官方在 2026-02-03 公告 ACE-Step 1.5 支持时明确说明「Cover、Repaint 等功能尚未在 ComfyUI 中支持」。若需要 text→music 之外的编辑,需等官方模板更新,或用第三方节点(hiroki-abe-58/ComfyUI-AceMusic)。

⚠️ 内容安全提示:中文社区流传的两篇 CSDN「ComfyUI_ACE-Step」介绍文章为 AI 生成的伪造内容,文中给出的 https://github.com/ACE-Studio/comfyui-ace-step 仓库返回 404,不存在。文中「上传 MIDI 做旋律引导」「乐器比例参数节点」等描述均无对应实现,请勿引用。

3.3 ComfyUI 落地与工程要点

综合两个项目,在 ComfyUI 中做音乐生成的实践要点:

  1. 模型放置:YuE2 用 yue2_3b_int8_convrot.safetensors(int8 量化,消费级卡可行);ACE-Step 1.5 按显存按上表选 2B 或 XL。

  2. 显存预判:ACE-Step 1.5 在 ≤6GB 显存下可跑但需全 CPU offload;YuE2 的 int8 版在 8–12GB 区间较舒适。两者都不建议在 4GB 以下尝试。

  3. 时长控制:两者都受 token 预算约束。YuE2 的每秒 25 个 semantic token 是硬性开销,Max Duration 上限 900 秒,但实际生成时长受 prompt 总长度挤占。

  4. 可复现性:YuE2 保留完整的 score / semantic tokens / acoustic latents / 生成设置,出了问题可以直接回溯到具体环节;ACE-Step 1.5 无此便利。

  5. 版权状态:YuE2 权重是 CC BY-NC 4.0 + 附加创作者许可,商用需仔细阅读附加条款;ACE-Step 1.5 是 MIT,但需确认权重与训练数据的商用边界。


四、输入链路:会议记录与麦克风替代

中国家谱寻根资源地图 · 开源项目 / 家谱资料 / 迁徙线索
GENEALOGY · 寻根资源地图

中国家谱知识服务
开源项目 · 家谱资料 · 迁徙线索

一份把「软件工具」「权威数据源」「祖先故事与迁徙证据」「老谱数字化链路」串起来的地图。所有仓库数据为 2026-10-06 实时核验,数据源均为可公开访问的官方平台。

15+开源家谱项目
10万+上图收录家谱种数
65.7万CBDB 历史人物数
1869万华谱网人物节点
01

中文原生的开源家谱系统

这批项目从 UI 到数据模型都按中文语境设计(字辈、排行、世系、堂号),可以直接部署成家族网站或桌面应用。

pure-genealogy ↗

★ 407 MIT Next.js 15 + Supabase 2026-01 活跃

目前中文社区最完整、最"能打"的一体化族谱系统,单 Supabase 实例即可跑起来,适配 Web 与 H5。

  • 数据模型:单表 family_members 自引用(father_id)建世系;字辈走姓名第二字统计;residence_place 记录居住地迁移;remarks 存 Slate.js 富文本生平
  • 2D 族谱图:Dagre 层级树 + 水墨"世代标尺" + 金线溯源(高亮祖先路径)/ 金扇繁衍(高亮子孙路径)
  • 3D 力导向关系图,支持自动巡游(自动规划两人最短关系路径并飞行浏览)
  • 统计仪表盘(性别/在世比例/世代增长/字辈频率)、家族时间轴、Living Book 拟物翻书详情页
  • 导入导出:Excel / CSV;族谱图可导出高清 PNG

⚠ 不支持 GEDCOM —— 与其他软件交换数据要靠 Excel 中转。适合想立刻上线一个好看家族网站的团队。

Branchloom · 有谱 ↗

Apache-2.0 桌面端 Electron/TS 支持 GEDCOM 2026-09 活跃

"本地优先"路线的代表:数据存在你自己手里,不依赖任何会倒闭的网站。想做的是家谱界的 Obsidian。

  • 数据模型最接近学术规范:人物 / 关系 / 事件 / 地点 / 史料来源 / 引文 / 附件
  • GEDCOM 导入导出全支持,另提供完整项目包 .blp
  • 可用自己的 GitHub 私有仓库做备份并与家人异步协作 —— 同步前先预览,字段冲突必须手动确认
  • 带 CLI 与 AI Agent Skill,可辅助批量整理;但写入前强制"先预览再确认",避免 AI 改坏族谱
  • 跨平台:macOS / Windows / Linux

✔ 如果你在意"数据永流传、不被平台绑架",这是首选。缺点:社区很小(★6),生态早期。

LyGenealogy · 屈氏宗谱 ↗

Apache-2.0 Nuxt3 + Vue3 + Express pnpm Monorepo

一个真实姓氏(屈氏)落地过的族谱数字化平台,工程结构规范,适合宗亲会/姓氏研究会自建。

  • 三层结构:Express + TS 的 REST API / Nuxt 3 公共前端(SSR/SSG/ISR、PWA、H5 适配)/ Vue3 + Element Plus 管理后台
  • 功能:族谱库列表与详情(谱籍、字辈摘要)、字辈查询、成员搜索、亲缘关系递归展示、世系树
  • 姓氏文化、百科、新闻等内容模块统一管理,支持多姓氏扩展
  • SQLite 持久化,支持多族谱、多地区

✔ 适合"一个姓、一批人、长期维护"的场景,前端 SSR 对搜索引擎友好,方便对外展示。

mumuy/relationship ↗

★ 3734 MIT JavaScript 2026-09 活跃

中国亲戚关系计算器。它不是家谱管理工具,而是称谓/辈分引擎——恰好是家谱系统最难写的那块。

  • 核心算法三段式:中文称谓 → 内部关系链(f=父, m=母, s=子, d=女, &o/&l 表长幼)→ 反向生成称谓
  • 能力:称谓计算、辈分计算、关系链还原、两人关系合称(如"儿女亲家")
  • 区域模式:默认普通话 / 北方 / 粤语,且支持 setMode 注册自定义地区称谓
  • 支持"二舅"这类排行修饰词、同义词扩展与口语化输入("吾之""家的")

✔ 强烈建议作为依赖嵌入你的家谱系统:把谱系数据直接翻译成"该叫表叔还是堂伯",并可用于辈分逻辑校验。

guyue55/FamilyTree ↗

MIT Django 5 + Vue 支持 GEDCOM

功能设定偏"企业级"的族谱系统:权限、协作、全文检索、多语言一应俱全。

  • 后端 Django 5 / Python 3.12 + DRF + JWT/OAuth2;PostgreSQL、Redis、Celery、Elasticsearch
  • 核心:多族谱管理、成员 CRUD、复杂关系网络、交互式族谱图、多媒体资料上传
  • 高级:基于角色的权限控制、多用户协作编辑、GEDCOM 导入导出、全文搜索、统计分析
  • WebSocket 实时同步 + 响应式设计 + 国际化

✔ 技术栈重但齐全,适合有 Python 运维能力、想要"多家族/多租户"的机构。注意:★0,作者近期才起步。

qiaoshouqing/familytree ↗

★ 557 MIT TypeScript

极简开源家族树网站。轻、干净、易改,是"自己动手改一个"的性价比之选。

✔ 想要简单可控、愿意自己改代码的前端同学优先看这个。

选型速判

要「立刻能用的中文家族网站」→ pure-genealogy;要「数据永流传 + GEDCOM + 家人协作」→ Branchloom;要「宗亲会/姓氏研究会」→ LyGenealogy;只要「称谓辈分算法」→ mumuy/relationship 直接引依赖。

02

GEDCOM 成熟生态(中文可用)

国际家谱领域有二十多年的工程积累,数据模型和交换标准(GEDCOM)远比国内项目成熟。它们都有完善的中文界面,是"认真修谱"的稳妥底座。

Gramps ↗

★ 3123GPL-2.0 PythonGEDCOM 5.5

开源家谱软件的事实标准,数据模型设计最严谨,插件生态最丰富。

  • 完整数据模型:Person / Family / Event / Place / Repository / Citation / Source / Media / Note,并细分 Name、Surname、ChildRef、EventRef 等
  • GEDCOM 5.5 导入导出广泛支持(多字节 UTF-8 编码可正确处理);建议用 .gramps 原生格式备份避免信息丢失
  • 内部统一 Unicode/UTF-8,提供简体中文界面,所有报告支持 Unicode 字体
  • 插件体系:Views / Reports / Tools / ImportExport / Gramplets,启动时注册,无需改动核心代码

✔ 学术级规范 + 可扩展。做过"史料来源—引文—结论"三层溯源,这正是修谱最需要的可信度结构。

webtrees ↗

★ 824GPL-3.0 PHPGEDCOM 5.5.1

自托管的在线协作家谱系统,多人同时修谱体验成熟。

  • 数据模型完全围绕 GEDCOM 5.5.1:Trees → Records(INDI/FAM/SOUR) → Facts(事件/属性) → Places → Dates
  • 对东亚姓名友好:支持 ROMN(罗马化姓名变体)与 FONE(拼音变体)标签,可同时保存汉字名与拼音
  • 多语言界面(I18N::translate),权限/隐私分级、媒体文件管理

✔ 想要"多人一起在线修谱"且不介意自己架 PHP 服务,这是最省事的选择。

GEDKeeper ↗

★ 214GPL-3.0 C# / .NET含简体中文

老牌跨平台个人家谱库软件,Windows 用户体验最接近国产桌面软件习惯。

  • 完整 GEDCOM 5.5.1 支持,人数与代数无限制
  • 家族树打印/导出为图片、PDF、Excel、RTF、HTML
  • 动态地图(Google Maps)呈现地理数据 —— 对看祖籍分布很有用
  • 亲属关系度计算器、统计、幻灯片、Lua 脚本与插件

✔ 不想碰命令行、只用 Windows 桌面的话,体验最"顺手"。

为什么绕不开 GEDCOM

GEDCOM 是家谱数据的交换标准(当前版本 5.5.1 与 GEDCOM 7)。国内多数项目(含 pure-genealogy)不支持它,意味着数据进去就出不来。若你打算长期维护几代人的资料,优先选支持 GEDCOM 进口出口的工具,把数据主权留在自己手上。上图家谱平台则另建了一套更细粒度的「家谱本体」(文献/姓/人/地/时/事),见下一节。

03

家谱资料与开放数据源

这一节是"资料本身"。按权威度和可编程程度排序,第一条是唯一能直接写进代码的官方家谱数据入口。

中国家谱知识服务平台(上海图书馆)↗

权威可编程 10万+ 种630 家馆藏机构

全国最大的家谱联合目录与知识服务平台,2016 年上线,年浏览量 100 万+ 人次,也是国内数字人文的标杆案例。

  • 收录 10 万余种家谱,其中上图馆藏 3.7 万余种、7 千余种对外网开放全文查阅
  • 服务内容:家谱元数据、全文影像、先祖名人介绍、谱系图、家规家训
  • 多维探索:人 / 地 / 时 / 事 分面检索、数据可视化、地理空间服务
  • 众包功能:上传家谱、在线识谱、在线修谱,可直接捐献影像
  • 实体展陈(上图东馆):「君从何处来」家谱迁徙图、「探姓觅谱」AR 姓氏墙(前 300 大姓)、「生生不息」3D 家谱树(胡适/李鸿章/盛宣怀)、「华夏一家」谱籍分布图

✔ 寻根第一站。先在这里搜你的姓 + 祖籍地,看有没有可查的家谱。

上海图书馆开放数据平台 ↗

API关联数据 SPARQL需 APIKey

把上面那个平台的底层数据以面向机器的方式开放出来,是整个中文家谱生态里最值得开发者深挖的一块。

  • 三种取数方式:① 资源 URI 取 RDF(JSON-LD 三元组)② 类型查询接口(姓氏 / 先祖名人 / 地点 / 机构 / 朝代 / 书目,每次最多 20 条)③ SPARQL Endpoint(复杂查询)
  • 规范控制基础库:人名规范库、历史纪年表、地理名词表、华人姓氏列表、收藏机构名录
  • 家谱本体定义 文献 / 姓 / 人 / 地 / 时 / 事 六类概念及关联,字段尽量复用已有规范词表(便于与其他数据整合)
  • 需注册取 APIKey:data.library.sh.cn/jp/userlogin/tologin
  • 另在 OpenKG 上有镜像条目「华人家谱关联数据集」,含家谱本体与接口说明文档下载

✔ 想做"输入姓氏+祖籍地,自动列出相关家谱与先祖名人"这类应用,就用这个接口。

CBDB 中国历代人物传记资料库 ↗

★ 230哈佛/北大/中研院 SQLiteCC BY-NC-SA

唐至清(7–19 世纪)中国历史人物关系型数据库,截至 2026 年 5 月已收录 65.7 万+ 人。GitHub 仓库持续更新最新 SQLite 版本。

  • 核心表:Person(姓名/拼音/性别/朝代/生卒年/籍贯)· Kinship(亲属关系及代码表)· Office posting(职官任免)· Association(社会关系)· Address(各类型地址:出生地/居住地/祖籍…)
  • 另有大量 code table:亲属关系码、入仕途径码、机构码、地名码等,支持网络分析与 GIS 空间分析
  • 多种形态:可下载单机库(Access/SQLite)、在线查询、API、CBDB Linked Open Data;配套 MARKUS 文本标注与 CHGIS 历史地理系统
  • 数据来源:正史、科举题名录、职官表、地方志、墓志铭、文集等

⚠ 偏"精英人物"(官员、科举、名士),不是平民家谱。但如果你家明清出过读书人/官员,这里是查证祖先生平最硬的证据库。

Genealogy-MBW · 华谱网数据集 ↗

1869万节点图数据模型 已脱敏

面向家谱文化与图数据研究的开放数据集,截至 2026 年 5 月累计 1869 万人物节点 + 2380 份家谱。

  • 统一图模型:节点 = 家谱人物,边 = 亲属关系,节点属性存人物描述
  • 知识密度高:含人物世系、代际演化、迁徙关联、血缘关系、过继关系、隔代后代
  • 处理链路完整:多源异构采集 → OCR 与版式理解 → 人物关系抽取与消歧 → 谱系结构建模 → 图数据库设计 → 清洗校核 → 一致性校验 → 隐私脱敏
  • 涉及领域规则:血亲 vs 过继区分、同名异人/异名同人判定、缺失世系链接还原、历史地名变迁识别

✔ 想做族谱知识图谱 / 迁徙网络可视化,这是目前最"现成"的高质量中文族谱图数据。

CGED / CUSD(港大李-坎贝尔团队)↗

清代民国约200万人CSV/Excel

与 CBDB 协作的两个"大社科数据"项目,是目前唯一整建制研究中国官僚体系的微观数据库。

  • CGED:1700–1950 年文官与专业生涯,含约 200 万人、337 万条军政职位记录,附个人家族与地理来源信息
  • CUSD:1890–2010 年含中国香港在内的中国大学生社会来源
  • 特别适合"查某位先祖的人事档案";提供 CSV/Excel 下载与中文使用指南

✔ 祖上若在清代做过官或有功名,这条路比家谱更可能直接查到名字。

其他可用数据源一览

数据源规模 / 内容形态与许可怎么用
中国家谱总目数据集
OpenDataLab / Chinese-Genealogy
52401 条家谱条目,608 个姓氏,1200 万字(上海图书馆牵头编纂) 文本,81.3MB,CC BY-NC 4.0 做姓氏分布/谱籍地统计、训练家谱领域模型
ChineseNames
R 包 · psychbruce
1806 个姓氏 + 2614 个取名用字,1930–2008 全国频次(覆盖约 12 亿汉族人口)
★188 · GPL-3.0
R 包 / 数据集 校验字辈用字、判断名字时代特征与地域分布
老家河南家谱馆 · 中华家谱数据库
jiapudata.com
民间藏谱汇编,持续建设中;有各地宗亲会合作 网站检索 查河南地区姓氏族谱,联系宗亲会
FamilySearch
familysearch.org
全球最大免费线上族谱服务,含中文馆藏与检索 网站 / 开放 API 查海外华人支系、下南洋后裔
新加坡华人传记数据库 1819–2019 八代新加坡华人人物,含关系网络与祖籍地 CSV / Excel 可下载 查下南洋家族在东南亚的支系
姓氏源流类 API
天行数据 / apihz 百家姓
姓氏历史来源、得姓始祖、郡望堂号、迁徙分布、姓氏图腾 JSON API(有免费额度) 做产品时补"姓氏介绍"页,省得自己编
04

祖先故事与迁徙线索

家谱里找不到答案时,靠的是"迁徙史 + 地名暗号"。下面这张时间轴可以直接当成检索关键词清单用。

核心方法:上图「君从何处来」迁徙图是怎么做的

上海图书馆把平台里 7 万多种家谱,用机器学习基于事件本体做数据提取,专门抽取始祖和始迁祖的迁徙事件,转成语义化关联数据,再通过可视化与交互设计,做成一张可按朝代查看迁徙趋势的航线图;并对数据密集的几波移民潮做重点展演。这套"从家谱原文抽迁徙事件 → 语义化 → 可视化"的思路,你自己修谱时完全可以照搬:把每位祖先的始迁时间 + 迁出地 + 迁入地结构化下来,就能画出自家一支的迁徙线。

307 – 453 年

永嘉南迁

八王之乱 + 五胡乱华,中原士族与富户大规模渡江南下,约 90 万人,占刘宋人口六分之一。今南京—镇江一带北方侨民甚至多于原住民。

路线:东线循邗沟与淮河东南向/西线循汉水南下,汉中与襄阳为集散地;关陇流民入汉水与川北
755 – 9 世纪

安史之乱后南迁

河南、河北、陕西居民南下江淮、西入四川,历时一个半世纪,完成中国经济文化中心南移。荆州至常德一带户口因移民增加十倍。

路线:东路走大运河入淮南江南再入赣闽;中路出南阳襄阳沿汉水入岭南;西路越秦岭入汉中与四川盆地
1126 年 – 13 世纪

靖康之乱南迁(最大一次)

金兵南下、高宗南渡,累计南下移民约 500 万。最密集区是从苏州到宁波一带,杭州城内高度集中。今天世界性的「客家人」族群正是这次移民形成的。

路线:与唐后期相同,七个较大阶段;南宋内部另有江西→淮南、福建→潮梅、江西→湖南等支线
1371 – 1417 年

明初洪洞大槐树移民(规模最大)

明朝在洪洞大槐树下设局驻员 50 年,大规模迁民 18 次、约百万人,遍布京冀豫鲁苏鄂等 18 省。洪武年间全国移民总数达 1340 万,占人口 19%。

路向:山西南部 → 河南(93 万)/山东(121 万)/河北(41 万);同期还有江西→湖广、湖广→四川
元末 – 清代

江西填湖广 · 湖广填四川

晚清魏源记:"江西人入楚,楚人入蜀,故当时有江西填湖广、湖广填四川之谣。"麻城曾收集 142 套族谱,其中 125 支可溯自江西。

路向:江西饶州等地 → 以鄱阳瓦屑坝中转 → 鄂皖湘;湖广黄州府 → 四川(川北多陕西、川东多湖广、川西多广东)
清中期 – 民国

走西口 · 闯关东 · 下南洋

自发性经济移民。闯关东:1912–1945 年关内流向关外约 991 万人;下南洋:到 1905 年海外华侨总数已达 700 万,闽粤人占 95% 以上。

路向:晋陕 → 内蒙归化与河套(走西口)/冀鲁豫 → 东北,多由古北口、张家口、喜峰口出关/闽粤 → 东南亚与台湾
持续千年 · 五次大迁徙

客家民系形成与迁川

客家人祖先本居黄河流域,因战乱南迁至闽粤赣边区。清初康雍乾三朝(约 1680–1800)第五次大迁徙中大批入川,仅仪陇一县客家人曾占总人口 33%,至今约 11.8 万。

迁川路线:粤北 → 湖南汝城/桂东/茶陵/醴陵/浏阳/平江 → 长江;或 粤北 → 宜章/郴州/祁阳/邵阳/常德 → 长江;两路经鄂西溯江入川

地名"暗号":家谱里写到这些地方,就等于给了你迁徙线索

民间广泛流传"北有山西洪洞大槐树,南有江西鄱阳瓦屑坝"。这些地名多数不是真实最后的祖籍,而是移民集散地/中转站,是身份认同符号 —— 看到它们就说明你的祖先属于某一次特定移民潮。

山西洪洞大槐树 · 老鹳窝明初官方移民集散地 → 豫冀鲁皖苏。民谣:"问我祖先来何处,山西洪洞大槐树"
江西鄱阳瓦屑坝鄱阳湖边古渡口,洪武大移民主要中转站 → 鄂皖湘,湖北江汉平原三分之二来自南昌府一带
湖北麻城孝感乡四川移民后裔最普遍的祖籍认同。麻城四乡之一,嘉靖年间析入黄安(今红安)
苏州阊门苏北扬州、淮安一带移民普遍自称来自苏州阊门,实为集散地符号
南京杨柳巷云贵驻留军士后裔多自称祖籍南京杨柳巷,对应明初军籍移民
山东枣林庄与洪洞大槐树、瓦屑坝、麻城孝感乡齐名的"移民发源地"符号

把线索变成证据的三步

① 先从家谱/口传里抠出"始迁祖名 + 迁出地 + 迁入地 + 大致年代"四要素;② 用上表时间轴判断它属于哪一次移民潮,再去该移民潮的集散地(大槐树/瓦屑坝/孝感乡…)方向上找对应姓氏族谱;③ 到 jiapu.library.sh.cn 按「姓氏 + 谱籍地」检索上图及 630 家机构馆藏,并在 data.library.sh.cn 用 API 拉规范化的地名与人名做交叉验证(历史地名变迁务必用它的地理名词表校准)。

05

老谱数字化链路(把纸变成数据)

纸质族谱是竖排繁体、生僻字多、版面复杂,通用 OCR 基本没法用。这条链路是目前可落地的最优解。

PaddleOCR / PP-StructureV3 ↗

Apache-2.0百度飞桨 繁体竖排2025-05 v3.0

古籍 OCR 的首选底座。PP-OCRv5 单模型即同时支持简体中文、繁体中文、中文拼音、英文、日文,覆盖手写体、竖排文本、生僻字。

  • 古籍场景实测:文本检测精度 +43%,生僻字识别精度 +95%,微调后字符准确率 94%+
  • PP-StructureV3 版面分析:区分标题/正文/表格/图片/公式区域并判断阅读顺序 —— 这正是竖排古籍"从右到左"不乱序的关键
  • CPU 也可跑(默认启用 MKL-DNN,Intel CPU 提速约 2.3 倍),也支持昆仑芯、昇腾等国产硬件
  • 输出 Markdown / JSON / DOCX / XML,可直接进后续结构化流程

✔ 关键参数:lang=chinese_cht(繁体)、降低 det_db_thresh 到 0.3 以适应墨色浅的老谱。

Chinese-Ancient-OCR ↗

PaddleOCR 封装竖排自动排序

基于 PaddleOCR 的古籍识别工具,把"竖排排序"这个最烦的坑直接填了,开箱即用。

  • 智能文字排序:自动识别竖排古籍并按"从右到左、从上到下"正确排序
  • 单图识别 + PDF 批量处理(自动分页渲染、逐页识别、生成独立与合并文本)
  • 可自定义 DPI 提升精度;输出 TXT / JSON / 可视化标注图片

✔ 只想把一本电子化族谱快速转成文字,用这个比从零搭 PaddleOCR 省事得多。

推荐处理流程(七步)

STEP 1扫描 ≥300 dpi

300 是精度与体积的平衡点,低于 300 会明显掉识别率。保存级图像 + 元数据一并留存。

STEP 2抽样试识别

先识别几页,摸清版面类型(双行小注/批注/套印)与主要错误类型,再决定参数。

STEP 3图像预处理

OpenCV:灰度化 → 高斯去噪 → 投影分析纠偏 → 高斯自适应二值化(对老化泛黄、光照不均更稳)。

STEP 4版面分析

PP-Structure:切分标题/正文/表格/图片区域并确定阅读顺序,避免竖排错行。

STEP 5文字识别

PP-OCRv5 繁体模型;保存文字 + 坐标 + 置信度,低置信度的地方留给人工。

STEP 6后处理纠错

形近字表纠错(己/已、曰/日、未/末、戌/戍…),但人名务必人工复核,不要被自动纠错改错。

STEP 7双层 PDF 归档

图像层 + 透明文字层,既可保真又可全文检索;版本化发布,保留原文影像与修订记录。

必须提醒的一句

OCR 输出永远是「可校对的初稿」,不是成品。字符准确率高不代表人名、日期、地名、官职正确 —— 而这四类字段恰好是家谱的全部价值所在。务必按"字符 / 字段 / 版面"三层验收,风险字段 100% 人工过一遍。

06

落地路径建议

按你的真实目的直接对号入座。

你的目的推荐组合为什么
想快速有个好看的家族网站 pure-genealogy(★407, MIT) 一个 Supabase 即跑,中文体验最完整,2D/3D 谱图与 Living Book 直接可用。缺点:无 GEDCOM,数据需靠 Excel 出。
想数据几十年不丢 + 家人一起改 Branchloom(有谱)+ 私有 GitHub 仓库 本地优先、Apache-2.0、GEDCOM 全支持、冲突手动确认、AI 写入前强制预览 —— 数据主权完全在你手上。
宗亲会 / 姓氏研究会自建 LyGenealogy(屈氏宗谱)架构即用 Monorepo 工程规范、支持多姓氏扩展、前端 SSR 便于对外展示、含字辈查询与亲缘递归。
认真修谱,要学术级规范 Gramps(本地主编)+ webtrees(在线协作) 数据模型含 Source/Citation/Repository 三层溯源;GEDCOM 互通,不会被任何单一软件锁死。
查祖上到底是谁 jiapu.library.sh.cn 检索 → CBDB / CGED 查名人 → 老家河南家谱馆找民间藏谱 先用 10 万+ 种联合目录定位家谱,再用数据库交叉验证人物生卒、职官、籍贯。
做迁徙/族谱可视化产品 上图开放数据 API + 上图迁徙图方法论 + Genealogy-MBW 图模型 数据层用官方 RDF/SPARQL,结构层仿"始祖→始迁祖→迁入地"事件本体,展示层参考航线图与谱籍分布图。
把纸质老谱数字化 PaddleOCR PP-StructureV3 + Chinese-Ancient-OCR 唯一能同时处理竖排、繁体、生僻字与复杂版面的可用开源方案。
要把谱系翻译成"该怎么称呼" mumuy/relationship(★3734)当依赖嵌入 称谓/辈分/关系链算法直接可用,含北方与粤语模式,还能注册自家地区的叫法。

最后一条建议

家谱这件事,工具会过期,数据不能。无论你最终用哪个系统,都请做到三件事:① 保留一份 GEDCOM 或纯文本导出;② 原始家谱影像单独存档、不要只留 OCR 文本;③ 每条祖先信息标注来源出处(哪本谱、第几页、谁口述)。做到这三点,数据就能跨过任何一次软件换代,真正"永流传"。

仓库指标经 GitHub API 于 2026-10-06 实时核验·数据源均为公开可访问的官方平台
中国家谱寻根资源地图 · 建议收藏本页作为检索入口

此处内容已隐藏,「密码可见」