Boundless Flow无界音流 · 使用手册
0.5.0English
使用指南 / 12

排错与数据

按具体阶段定位;保留原文件与完整错误,避免反复盲目转换。

图中为软件实际界面,配置和会话使用示例内容。请按你自己的模型、服务和录音填写。

从安装、模型下载到完成操作,查看新手图解教程 →

启动与版本

打开 Boundless Flow 应用或你创建的应用快捷方式。主界面显示的版本号应为 0.5.0。首次使用从「配置引导页」开始;后续使用可直接进入相应工具。

若打开了旧版本,先关闭不需要的应用实例,再打开当前版本。程序位置、模型位置和数据位置分别配置;移动程序前检查配套组件,移动模型前检查引用路径。

常见提示

功能/提示使用说明
s2mel 权重带 net. 前缀当前选择原始 Index 权重;先准备原生模型,完成后使用自动切换的 .boundless-flow/native。
缺少 gpt/s2mel/feat/semantic_codec/bigvgan 等文件区分原始目录与已准备目录;按检查结果补齐来源权重,再准备。不要用空文件或改名掩盖缺项。
index_checkpoint_unsupported_or_invalid记录失败文件、pickle_global、offset、protocol 和模型版本。原文件保留;更新组件或定位格式后再试,该提示表示当前组件无法读取此检查点格式。
缺少 audiovae.safetensorsVoxCPM2 原生包需要该文件;按原生准备流程处理配套权重。
参考录音须 1–60 秒更换录音或显式选择合格讲话区间,不补静音、不改写原始录音。
expected mono 16000 Hz WAV先在音色工具显式导入转换;声纹登记仍应提供界面要求的合格 WAV。
无法在模型目录内准备检查该盘剩余空间、目录写权限和是否只读;不自动转存 C 盘。
API 401/403/模型不可用确认能力专用鉴权、服务地址和账户可用模型;保存成功不是接口验证。
模型准备 · 检查后按提示准备 示例
  1. 1确认原始模型目录。
  2. 2先检查模型,再按提示准备。
  3. 3需要转换时点击准备原生模型。

配置、原音与空间

使用软件内的配置备份与恢复功能明确选择候选。模型转换仅在模型目录内新增原生包;需要关联的原始权重仍是依赖,不可随意移走。应用数据、会话音频、导入参考和导出结果也需分别备份。

会话音频、导入参考音、模型文件和导出结果都会占用磁盘空间。先确认文件是否仍被软件引用,再备份或移走;同盘移动不会释放空间。音色和声纹的「归档」只隐藏条目,不删除录音。

导入参考录音 · 名称、路径与转换 示例
  1. 1选择要导入的原始录音。
  2. 2为录音填写便于查找的名称。
  3. 3点击导入,原录音会保留。

反馈问题应包含

提供版本和运行入口、操作步骤、出错阶段、模型家族及完整目录、失败文件与完整错误。API Key 与私人音频无需放入截图。性能问题说明会议时长、语言数、模型、输入/输出设备和哪个阶段耗时;不要只用总请求时间推断同传延迟。

离线水印结果

平台方可使用单独的 Boundless Flow 离线语音水印解码器检查 WAV。选择音频,由平台方在自己的离线设备上配置对应私钥和槽位,再查看结果;无需上传录音,也不需要在普通语音工具中配置私钥。

结果区显示生成 ID、唯一记录数和已验证包数。同一条生成记录可以在音频中重复出现,因此已验证包数可能大于唯一记录数。排错时再查看详情中的 FFT、认证和协议信息。

“检测到 Boundless Flow 语音水印”表示恢复了通过认证的软件来源记录,不证明说话人的真实身份。“未检测到”也不能证明音频是真人原声;裁剪、转码或过短的音频可能无法恢复水印。目前不保证经过 MP3 等有损转码后仍能恢复。

开源识别组件声明

本地 FunASR 适配复用 Apache-2.0 许可的 aha,并参考 MIT 许可的 FunASR 前端。以下为运行源码声明,模型权重的许可另以其来源为准。

查看署名与许可全文
Boundless Flow FunASR Nano local adapter

Adapted runtime and processor integration from aha 0.2.3, Apache-2.0.
https://github.com/jhqxxx/aha
Source revision: 387fe01c279940edc0b76ed7c1bc38f80ab3b614
Modified by Boundless Flow contributors: checked LFR indexing and KV cleanup.
Model weights are not included. Their licenses remain separate.

                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

   1. Definitions.

      "License" shall mean the terms and conditions for use, reproduction,
      and distribution as defined by Sections 1 through 9 of this document.

      "Licensor" shall mean the copyright owner or entity authorized by
      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).

      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.

      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."

      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by Licensor and
      subsequently incorporated within the Work.

   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.

   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.

   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:

      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and

      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and

      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and

      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding those notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.

   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.

   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.

   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.

   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.

   END OF TERMS AND CONDITIONS

   APPENDIX: How to apply the Apache License to your work.

      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "[]"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. We also recommend that a
      file or class name and description of purpose be included on the
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

   Copyright [jhq] [name of copyright owner]

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.


FunASR reference license: MIT, Copyright (c) 2025 FunASR.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.