Boundless Flow场景教程 · 0.5.0

场景教程

模型下载与软件配置

按你要实现的功能选文件,区分原始权重、原生包与 API。

你能得到什么

知道要下载什么、放在哪里、在软件哪一处选择,以及哪些路径仍未开放。

开始前准备

  • 使用可写、有足够剩余空间的自选模型文件夹。模型与应用分别保存;磁盘空间和显存需求随模型及量化变化,没有适用于全部模型的最低配置。
  • 下载前查看下面对应来源的模型卡与许可。浏览器下载需要网络;阅读本指南和已配置本地模型可离线,但 API 需要对应服务可达。
  • 不要一次下载全部模型。先实现一项功能并短试,文件检查不等于实际推理、质量或实时性能已经通过。
  • 运行组件选择「运行组件 · 官方发布包」,填写官方 HTTPS 文件直链、保存文件名、官方公布的文件大小(字节)和 SHA-256。当前只下载并校验,不自动安装或运行;组件需匹配系统、显卡与模型后端。

逐步操作

  1. 01

    先按任务选择运行方式

    只要文字,先选择识别模型;要翻译,再配置翻译模型或 API;要纪要,另配 LLM;克隆/设计再选择 TTS。语音工具的「本机模型」读取本地包,「模型服务」连接已经运行的服务,「云端 API」使用账户。三个入口不自动互相转换。 FireRed Instruct 的原生路线读取原始完整目录,不需要另开服务。

    放大截图 · 模型下载与软件配置 · 1
    真实软件界面 · 点击放大;图中示例数据不代表你的结果
    1. 1先选择模型与参数。
    2. 2点击进入音色模型的配置与试音。
  2. 02

    在软件内选择来源、磁盘与完整文件

    打开「配置引导页 → 模型与参数」,展开「还没有模型文件?下载模型与组件」。在「下载来源」选择 Hugging Face 或 ModelScope 的公开仓库,使用快捷选择或填写「组织/仓库」及分支、标签或提交号;两平台仓库名称可能不同,先阅读对应模型卡和许可。点击「选择文件夹」选自己的磁盘,再点「检查下载清单」。按模型卡勾选全部所需分片、配置、tokenizer、编解码器及辅助模型,确认大小后点「下载所选文件」。不要把网页另存为权重,也不要只下载主文件。受限仓库的账户授权尚未接入。

    放大截图 · 模型下载与软件配置 · 2
    下载配置示例 · 图中为测试清单;实际文件与大小以所选平台清单为准。点击放大。
    1. 03

      看进度,需要时暂停或续传

      查看已下载大小、文件数量和当前文件。折叠下载区或切换配置步骤不会暂停后台;同一引导中会保留来源、仓库、版本、目录和勾选。需要停下时点「暂停下载」并等暂停完成。续传前使用同一来源、版本和目录重新「检查下载清单」,再下载所选文件;来源无摘要时可能重新下载,不保证每个文件从中断处继续。关闭整个引导会结束这次草稿,重启软件后请重新填写和扫描。

      放大截图 · 模型下载与软件配置 · 3
      下载配置示例 · 图中为测试清单;实际文件与大小以所选平台清单为准。点击放大。
      1. 04

        下载完成后,先找对模型目录或单文件

        看到下载完成后点「复制模型路径」,记下自己的保存位置。要选择目录的模型,选含配置和全部配套权重的根目录;要求 ONNX 或 GGUF 单文件的入口,应在该目录里选实际文件,不能把目录当文件。声纹选择 speaker embedding ONNX,情绪分析选择九类分类 ONNX;同为 .onnx 也不能互换。下载不自动切换正在使用的模型,下面一步还需在对应功能里选择并检查。

        放大截图 · 模型下载与软件配置 · 4
        下载配置示例 · 图中为测试清单;实际文件与大小以所选平台清单为准。点击放大。
        1. 05

          在软件选择路径,再检查

          识别在「配置引导页 → 模型与参数」配置;声音在「语音工具 → 模型配置」选择模型与目录;声纹在「声纹识别 → 选择模型」选择实际文件。按提示区分选目录和选单个 GGUF/ONNX 文件,修改路径后重新检查。克隆还要选择参考录音;换录音后必须再点「检查模型」,旧参考检查不能用于新录音。

          放大截图 · 模型下载与软件配置 · 5
          真实软件界面 · 点击放大;图中示例数据不代表你的结果
          1. 1检查和生成固定在编辑区上方。
          2. 2文件检查通过后仍需实际试听。
        2. 06

          需要转换时准备,之后才提前加载

          先点击编辑区上方的「检查模型」,按「下一步」提示操作。需要转换时,点击同一操作区的「准备原生模型」:Index 新增包位于 .boundless-flow/native 固定目录;VoxCPM2 在原模型目录新增 audiovae.safetensors。原文件保留,转换与关联需要源盘空间。完成后重新检查。「提前加载模型」在模型列下方,是可选的内存加载,不补齐下载、不转换文件,也不等于实际推理预热。 FireRed 原始目录无需此转换;同传开始前另有模型、参考音和输出准备,详见同传教程。 模型文件和软件运行组件是两回事。提示缺原生组件时,请使用带齐配套组件的完整应用目录;「准备原生模型」不会安装 CUDA 或补齐运行组件。缺模型文件时按缺项清单补齐到自选模型盘,再返回检查;不要改名绕过提示。 FireRed若组件支持且已选择、检查参考音,加载按钮会显示「预置模型与参考音」,可提前处理模型、参考音和解码前缀,不生成语音。未选参考音或旧组件只支持「提前加载模型」。两种准备完成后都还要生成短句试听;换参考音和原文后重新检查、准备。旧截图只说明当时的按钮位置,不展示这个条件式新按钮。

          放大截图 · 模型下载与软件配置 · 6
          真实软件界面 · 点击放大;图中示例数据不代表你的结果
          1. 1下一步根据检查结果提示。
          2. 2按需转换原始权重,保留原文件。
        3. 07

          用自己的短样本证明功能可用

          转录读一小段话,翻译试一句文本,声音生成一句目标语言,声纹用另一段独立录音。检查完成状态、试听或核对结果后再保存配置。未开放模型即使文件齐全也不能靠检查变成可用。

          放大截图 · 模型下载与软件配置 · 7
          真实软件界面 · 点击放大;图中示例数据不代表你的结果
          1. 1选择已配置的翻译服务。
          2. 2先填写一小段测试原文。
          3. 3选择目标语言。
          4. 4配置有效后点击开始翻译。

        按模型查看下载与配置

        下面是来源和软件适配状态,先选一款满足任务的模型。外部来源于2026-10-09核对;下载与账户操作需要联网。

        Whisper本机音频转写

        需要的文件

        需要匹配当前原生运行时的 GGUF/GGML 文件;官方 Python safetensors 包不能直接作为该文件使用。按对应转换模型来源取得,中文选择多语模型,不用仅英文 .en 版本。

        软件配置路径

        配置引导页 → 模型与参数 → Whisper → 选择对应模型文件,或「音频转写」的 Whisper 路线。选择后用短录音测试。

        当前适配状态

        已有选定中文转写证据;文件转写不表示此路线所有功能都支持实时字幕或手机端。

        打开模型来源 ↗
        SenseVoice · Native原生音频转写

        需要的文件

        官方原始模型是来源,软件原生路线需匹配的 GGUF/GGML 模型与运行组件;不能把原始 .pt 权重改后缀当作原生文件。

        软件配置路径

        配置引导页 → 模型与参数 → SenseVoice · Native → 选择适配模型文件。没有适配包时可使用匹配的 ONNX 路线或已配置服务。

        当前适配状态

        已验证部分原生中文转写;不承诺任意上游版本直接加载。

        打开模型来源 ↗
        FunASR保留现有实时识别兼容路线

        需要的文件

        当前兼容路线使用相应 .pt、config.yaml 和配套词表/运行组件;FunASR 是工具家族,不是任意同名模型均可用。较新 ASR 模型需单独适配,不能根据上游列表认定软件已支持。

        软件配置路径

        配置引导页 → 模型与参数 → FunASR → 选择与现有兼容运行组件匹配的完整模型目录 → 短录音验证。

        当前适配状态

        现有功能保留,可能使用旧 Python 兼容组件;不能概括整个应用为无 Python。

        打开模型来源 ↗
        SenseVoiceSmall ONNX本地讲话转文字

        需要的文件

        当前目录检查要求 model.onnx 及 tokens.json/tokens.txt 中的一种配套词表。官方转换包可能提供 model.int8.onnx/tokens.txt,不能只把不同文件重命名来通过检查;需要软件兼容的导出包。

        软件配置路径

        配置引导页 → 模型与参数 → SenseVoice/ONNX 识别目录;检查后短录音测试。

        当前适配状态

        已有实际中文转录证据;不同导出版本仍须匹配,尚无全语言质量验收。

        打开模型来源 ↗
        Index-TTS2 / IndexTTS-2参考音克隆与所支持的情绪提示

        需要的文件

        原始根目录含 config.yaml、gpt.pth、s2mel.pth、bpe.model、feat1.pt、feat2.pt、wav2vec2bert_stats.pt,还需匹配 w2v-bert、semantic codec、CAM++、BigVGAN 等辅助权重。仅主仓库可能不完整,按检查提示补齐。

        软件配置路径

        语音工具 → 模型配置 → 本机模型 → Index-TTS2 / 2.5 → 选目录 → 检查模型 → 准备原生模型 → 等待路径切换 → 短试音。

        当前适配状态

        原生实验路径;中文与英文按当前版本显示,需实际试音。

        打开模型来源 ↗
        IndexTTS-2.5多语参考音克隆与情绪控制候选

        需要的文件

        保留 2.5 原始 config.yaml、gpt.pth、s2mel.pth、codec.pth、配套 tiktoken 分词文件和辅助权重。不要用 2.0 的 codec 或只改 version。下载辅助包后检查具体缺项。

        软件配置路径

        与 Index2 共用入口,原始目录需准备。新增包固定在所选模型目录的 .boundless-flow/native,保留关联原权重。

        当前适配状态

        已有 F 盘模型实际 CUDA 中文生成;不是所有目录、GPU、语言与情绪均验收。

        打开模型来源 ↗
        VoxCPM2本机参考音克隆

        需要的文件

        完整 config.json、主模型 safetensors/分片及索引、tokenizer 文件与 audiovae.pth。若缺 audiovae.safetensors,在软件准备生成该文件;原文件和模型路径保留。

        软件配置路径

        语音工具 → 模型配置 → 本机模型 → VoxCPM2 → 选目录与参考音 → 检查模型 → 按提示准备文件 → 可选提前加载 → 生成短试音;换录音重新检查。

        当前适配状态

        已有实际 CUDA 中文克隆和会话复用;当前入口不提供独立情绪参数或描述设计。

        打开模型来源 ↗
        Qwen3-TTS Base参考音克隆,Base 专用

        需要的文件

        完整 Base config.json、主权重、tokenizer 配置/词表及 speech_tokenizer/config.json、speech_tokenizer/model.safetensors;0.6B Base 为另一规格,仍须完整同版包。

        软件配置路径

        本机模型 → Qwen3-TTS → 声音来源「参考音克隆 · Base」;选完整目录,填写参考音原文,检查后试音。

        当前适配状态

        已有部分 Base CPU/CUDA 实际生成证据,独立音色质量待验;不能用于无参考设计。

        打开模型来源 ↗
        Qwen3-TTS VoiceDesign无参考音的描述设计

        需要的文件

        使用 VoiceDesign 完整包,含 config.json、主 safetensors、tokenizer 配置及配套 speech_tokenizer;不要与 Base 或 CustomVoice 混用。

        软件配置路径

        本机模型 → Qwen3-TTS → 声音来源「描述音色 · VoiceDesign」;填写声音描述与合成文本,在编辑区上方检查后「生成设计语音」。

        当前适配状态

        已有真实生成与复用证据,表达和独立质量仍须试听评估。

        打开模型来源 ↗
        Qwen3-TTS CustomVoice模型预设音色,与克隆不同

        需要的文件

        完整 CustomVoice 及其 tokenizer/speech_tokenizer 文件,按原始目录结构保存。

        软件配置路径

        按现有声音合成配置使用预设说话人;原生克隆/VoiceDesign 入口不接收 CustomVoice 作为替代。

        当前适配状态

        预设模型,不承诺当前所有后端组合均可生成。

        打开模型来源 ↗
        CosyVoice3服务克隆、跨语言及指令表达

        需要的文件

        官方原始完整包由兼容服务加载。本机入口另需完整 audio.cpp GGUF 和配套资源,不直接加载该原始目录;本指南没有已验收可下载的 GGUF 包链接。

        软件配置路径

        模型服务 → CosyVoice3 → 填已启动服务实际根地址 → 选择模式及参考音/原文或指令 → 短试音;软件不自动启动服务。

        当前适配状态

        服务协议及界面已接入,实际服务质量需用户部署后试音;原生真实生成待验。

        打开模型来源 ↗
        Fish Speech S2 Pro服务克隆与表达标签

        需要的文件

        原始完整 S2 Pro 权重及编解码器由对应服务加载;旧 Fish 权重不能替代。本机要求完整 audio.cpp GGUF 包,其下载与真实生成尚未在这里验收。

        软件配置路径

        模型服务 → Fish Speech S2 Pro → 实际服务地址、参考音和原文 → 合成文本可插表达标签 → 短试音。

        当前适配状态

        可选服务适配;权重许可不是通用商业开源许可,使用前阅读官方条件。

        打开模型来源 ↗
        FireRedTTS3 Instruct / BaseInstruct 参考音克隆与实验性流式译声;Base未开放

        需要的文件

        原始根目录保存 fireredtts3_instruct、redae、text_tokenizer 完整子目录;主模型和 RedAE 各自需最终 model.safetensors。下载暂存文件不能代替。

        软件配置路径

        本机模型 → FireRedTTS3 Instruct → 原始根目录 → CPU → 短参考与准确原文 → 检查并离线试音。随后可在同传选择同一模型与参考音,开启「边生成边播放 · 实验」;当前工作台自动播报,无需另找开关。

        当前适配状态

        当前 Windows 包使用 CPU,不提供此引擎的 CUDA 组件;应用保留生成中 PCM 播放实验入口。需要 NVIDIA GPU 时,请先检查并选择支持的 Index-TTS2、Qwen3-TTS 或 VoxCPM2 组件。每段完整译文定稿后才开始生成;持续实时、物理设备和完整音质尚未验收。Base、声音设计与独立情绪参数未开放。

        打开模型来源 ↗
        MOSS-TTS family目前用于模型包检查,暂不能在软件合成

        需要的文件

        各模型 config.json、权重分片/索引、tokenizer,以及匹配 MOSS-Audio-Tokenizer 或 v2 完整编解码目录;两个版本不能自行混用。

        软件配置路径

        语音工具 → 模型配置 → 正在接入的模型 → MOSS-TTS → 模型及编解码目录 → 检查模型包。

        当前适配状态

        上游能力不等于软件已开放;当前不能用此检查入口完成克隆、设计或同传。

        打开模型来源 ↗
        VibeVoice Realtime 0.5B模型服务预设音色试音

        需要的文件

        完整官方服务模型由已运行服务加载;应用选择预设,不直接导入参考音克隆。

        软件配置路径

        模型服务 → VibeVoice Realtime 0.5B → 实际 WebSocket 地址与服务已有的准确音色名 → 生成试音 → 成功后用于持续同传。

        当前适配状态

        整句文本/流式 PCM/预设;不提供克隆、设计或独立情绪参数。中文实际质量仍待确认。

        打开模型来源 ↗
        HY-MT2 / Hy-MT2文本与字幕翻译

        需要的文件

        本地托管选择匹配的腾讯官方 1.8B Q4_K_M GGUF 与兼容 llama-server 完整组件。其他量化或大模型可通过已部署兼容 API 使用,不自动等于此本地托管路径已验收。

        软件配置路径

        配置引导页 → API 配置 → HY-MT2 → 选择本地模型与服务程序,CPU 或配套 CUDA 后端 → 启动后文本试用;也可填实际兼容 API。

        当前适配状态

        已有实际 CPU 翻译与托管生命周期证据;目标语言质量和具体 GPU 包仍须单独确认。

        打开模型来源 ↗服务组件来源 ↗
        Index-Translate翻译 API 或导入 GGUF 的本地托管

        需要的文件

        API 不需要本机下载权重。自建服务使用官方所选模型完整包;本地托管需明确导入兼容 GGUF,不提供自动转换原始主权重的假设。

        软件配置路径

        API 配置 → HY-MT2/Index 翻译配置 → 填实际服务与模型 ID → 文本试用。公共服务的地址和权限以当时官方说明为准,不保证长期免费或可用。

        当前适配状态

        翻译适配与导入路径保留;实际模型质量、性能与账户可用性分别验证。

        打开模型来源 ↗
        CAM++ / ERes2Net / WeSpeaker ONNX说话人 embedding,与文字识别不同

        需要的文件

        下载兼容的 speaker embedding .onnx 文件,确认该文件的家族与许可;不是所有原始 .pt/.bin 模型都能直接选用。

        软件配置路径

        声纹识别 → 选择模型 → 选择实际 ONNX → 添加合格 WAV → 创建声纹 → 用独立录音比对。

        当前适配状态

        登记和候选比对已接入;未校准分数不认定身份,跨设备/未知人质量仍待评估。

        打开模型来源 ↗
        Cloud APIs / Minutes LLM云端识别、翻译、合成、音色创建或纪要

        需要的文件

        不下载本机权重;准备服务地址、实际模型/音色 ID 与具备所需权限的 API Key。灵录和普通纪要配置需分别确认。

        软件配置路径

        配置引导页 → API 配置选择能力与提供商;声音创建在语音工具 → 云端 API。先短请求成功,再应用到功能。

        当前适配状态

        具体能力依账户与适配协议,配置保存不是接口可用或所有能力通过的证明。

        emotion2vec+ base / seed · 九类分类 ONNX独立语音情绪候选分析,与克隆情绪控制不同

        需要的文件

        软件需要带九类分类层的兼容 ONNX 导出文件。官方来源用于核对模型与许可,原始仓库下载不等于取得当前可用ONNX;仅输出特征的导出不适用。

        软件配置路径

        配置引导页 → 模型与参数 → 本地模型库 → 情绪识别。原始 model.pt 可先「检查准备情况」;兼容的九类 classifier.onnx 登记后保存配置,再到语音工具 → 06 情绪分析选择模型和短录音。文件检查不代表推理通过。

        当前适配状态

        独立分析入口已接入;候选分数未校准,不代表情绪强度或心理结论。分析不自动改会议标签或声音生成参数。

        打开模型来源 ↗

        此模型来源核对日期:2026-10-10

        怎么知道成功

        选中的功能能处理短样本,来源、文件和配置路径对应;知道仍未开放的能力,不把下载完成当作运行成功。

        遇到问题

        缺文件/只找到下载暂存

        回对应来源补齐完整包和辅助组件;不要改名掩盖缺项,也不要把暂存文件当成正式权重。

        GGUF 不兼容

        语音需要当前 audio.cpp 家族和内嵌说明匹配的完整包;翻译 GGUF、旧版 Fish GGUF 或只有单个主权重不能通用替代。

        API 地址或模型不正确

        使用服务实际可用的地址、模型 ID 和鉴权;本地默认地址只在服务确实运行时有效。先文本试用再保存。

        仓库需要登录,或组件不会自动安装

        此入口目前用于公开 HF/MS 仓库;受限仓库授权未接入。运行组件只下载、校验官方直链文件,大小与 SHA-256 由你按官方发布信息填写。完成后按组件官方说明安装与配置,再返回软件检查,不能把包已下载当作组件已就绪。

        下载完成,但还是选不了模型

        核对入口要求的是目录还是单文件、模型家族与完整文件。下载目录内只有暂存文件,或只有官方原始权重时,仍须补齐或取得对应适配包;不要改扩展名掩盖格式。

        接下来

        查看原图