# Subtitle Studio 第三方组件与重新链接

Subtitle Studio 的原创程序、歌词排版和动效实现未以开源许可证发布。第三方组件的原许可证、版权及其授予的修改、替换、重新链接和为调试此类修改进行逆向工程的权利优先适用，不受 App 闭源声明限制。

## macOS 12 及以上常规版组件

- Qt 6.8.3 的 LGPLv3 模块动态链接，使用 Qt Base、Multimedia、Image Formats、SVG 及翻译资源；不分发 Qt Virtual Keyboard、Qt PDF 或 QML 插件。各模块与内嵌第三方许可文本在本目录对应子目录中。
- App 原生媒体库及 Python/PyAV 的媒体库均使用 FFmpeg 8.1.2 LGPL-2.1-or-later 动态库，禁用 GPL、nonfree 和 version3 组件，不链接 x264/x265。PyAV 18.1.0 从上游源码编译，使用 BSD-3-Clause 许可；不是带 GPL 编码库的预编译 PyPI wheel。
- `Contents/Resources/ffmpeg` 是独立 GPL 命令行编码器，静态包含 x264。App 仅以独立进程和普通参数／媒体流调用，不将其中的 GPL 编码库链接进 App。其准确对应源码、完整编译选项和依赖源码在同站点源码包中单独提供。
- Python 3.12.14 使用 PSF 许可。各包版本见 `RUNTIME-PACKAGES.json`，包本身、NumPy、ONNX Runtime、CTranslate2 等附带的第三方及二进制依赖版权文本保留在运行时中。Whisper small 模型使用 MIT 许可，模型卡及许可另行保留。
- 静态 OpenSSL 使用 Apache-2.0；nlohmann-json 使用 MIT。内置字体：Source Han Sans CN Medium 1.000 使用 Apache-2.0；Source Han Serif CN Medium 1.000 与无界黑 1.001 使用 SIL OFL 1.1；汇文明朝体 1.00 的版权字段为 Public Domain，作者公开许可允许嵌入。许可及作者公开配置随 App 保留，字体文件未经修改。未分发苹果系统字体及未获分发授权的商业字体，完整字体说明见本文末尾。

## Intel / macOS 10.13.6 兼容版组件

- Qt 5.15.2 LGPLv3 动态库；Python 3.12.14 仅标准库与原生联动助手。首版不含本地 AI 混音匹配、Whisper 模型或 PyAV 媒体运行时。
- 原生 FFmpeg 8.1.2 LGPL-2.1-or-later 动态库；独立 FFmpeg 命令行编码器 GPL-2.0-or-later。保留 Qt、Sparkle 2.9.6、媒体依赖及字体原许可。
- [旧系统兼容版准确对应源码](/releases/Subtitle-Studio-1.2.19-Intel10.13.6-third-party-sources.zip)，包含 Qt 5.15.2、对应媒体/标准库源码、构建步骤及许可证。SHA-256：`3824f8574477cc4997bb3b0c2b2ac43c593aff786e723ef1ef0fb79a820a0a4c`。

## 三份 App 的 Chromaprint 组件

Chromaprint 1.6.1（提交 `aed8eba2202dd9d7b3b0a56c77904cc805490d72`）使用 LGPL-2.1-or-later，保留逐文件 MIT 声明；动态链接且可以合法替换。FFT 使用 FFmpeg avtx，不含 FFTW。 [准确对应源码及两架构/旧系统构建记录](/releases/Subtitle-Studio-1.2.19-Chromaprint-sources.zip)，SHA-256：`ae9076c435c3c2356a3af666368d187fdbfa9663c9fdc1721a6a93b80096f2af`。

## 源码和重新构建

官网 <https://app.365mix.cn/> 提供 [第三方组件对应源码](https://app.365mix.cn/releases/Subtitle-Studio-1.2.6-macOS12-third-party-sources.zip)，与 App 下载位于同一站点、同一 OSS 桶。三份官网下载 ZIP 与自动更新包都只包含 App；字体更换、动效字体说明和第三方对应源码在官网单独提供。转载时请同样提供准确对应源码与许可证，不删除 App 内版权文件。源码包不包含 Subtitle Studio 原创业务、动效或后台源码。

`sources/SOURCES.json` 记录准确版本、上游地址和 SHA-256。Qt 为官方 6.8.3 源码包，其中包含第三方组件源码及声明；Python 和媒体依赖为对应版本源码。构建脚本及 `build-receipts/arm64`、`build-receipts/x86_64` 保留实际参数，`${BUILD_ROOT}` 表示使用者自己的构建目录，不要求使用发行者的本机路径。

媒体构建使用 `build_macos12_dependencies.py`：给定 `--arch arm64` 或 `--arch x86_64`、`--root <构建目录>`、`--sources <解压目录>/sources`。x264 仅用于独立 CLI。LAME 唯一源码修正为移除未定义的 `lame_init_old` 导出，脚本中明确记录；其他 FFmpeg、x264 源码无本地内容修改。Intel 未使用外部汇编时禁用 inline SIMD，以避免已验证的 RGBA 色彩转换异常。

PyAV 用 `build_macos12_pyav.py` 从源码生成 wheel，并以 `replace_macos12_pyav.py` 展示动态库收集及重定位；该部署脚本以已有 App 副本为输入，不包含 App 自有源码。构建需 Xcode 命令行工具、兼容 Python、C 编译器、CMake/Ninja、pkg-config 和 Meson。不同编译器不保证输出字节一致；不应直接用最新版依赖替代本包记录的版本。

## 替换动态库

1. 将 App 复制到可写测试目录，保留原版。选择与该包一致的 arm64 或 x86_64 架构、兼容 ABI 和 macOS 最低目标。
2. 原生库在 `Contents/Frameworks`，Qt 插件在 `Contents/PlugIns`。PyAV 媒体库在 `Contents/Resources/remix-runtime/python/lib/python3.12/site-packages/av/.dylibs`；替换时也需保留相应许可证。
3. 用 `otool -L` 检查非系统依赖指向副本内的兼容动态库。路径重定位方法在配套脚本中，不需要发行者私钥。
4. 修改会使发行签名／公证失效。仅为自己本地测试，可对测试副本执行 `codesign --force --deep --sign - "/绝对路径/测试副本.app"`；不要关闭全局 Gatekeeper。公开再分发修改版需遵守相应许可并使用自己的签名，不得冒充原发行者。

App 不以自校验阻止第三方许可允许的替换；在线服务和导出激活限制不取消第三方组件权利。此说明不是法律意见或编解码专利授权。官方参考：<https://www.ffmpeg.org/legal.html>、<https://www.qt.io/development/open-source-lgpl-obligations>。

## App 内更新组件

常规版 Sparkle 2.10.0、兼容版 Sparkle 2.9.6 的许可全文及其第三方许可随 App 保留（`Contents/Resources/licenses/Sparkle-LICENSE.txt`）。上游对应源码：<https://github.com/sparkle-project/Sparkle/tree/2.10.0>、<https://github.com/sparkle-project/Sparkle/tree/2.9.6>。

# Subtitle Studio 动效原生字体

想保持动效原有字形，请按下面的字体名称和字重查找。缺少可选字体仍能显示歌词，但替代字形、间距和换行可能与原效果不同。

“字型”主要控制歌词主字：KTV 扫唱可更换；多数原生动效主字可更换。**赤墨叠字的双字体固定**；云间飞墨、古风书法、蓝笺拾梦、笺上心声、月映星笺的辅助字独立选择。普通字体设置不能覆盖这些固定层和全部装饰文字。更换步骤见《字体更换与原生动效字体说明》。

## 已内置，无需安装

| 字体 | 使用动效／位置 |
| --- | --- |
| 思源黑体 CN Medium | 青光流词、极光冰蓝；多种可选字体缺失时的替代字体 |
| 思源宋体 CN Medium（面板名“思源中宋”） | 月映星笺主字、银翼流光；蓝笺拾梦的辅助小字 |
| 无界黑（Unbounded Sans） | 词意心语、霓光趣词、电光紫韵 |
| 汇文明朝体（Huiwen-mincho） | 弹跳心语 |

无界黑是中文 **Unbounded Sans**，与英文的 **Unbounded** 不是同一款字体。内置字体的版权和许可随软件保存。

## 可选字体：动效 → 原有字体

| 动效 | 原有字体／字重 |
| --- | --- |
| 光碟流词 | 汉仪雅酷黑 65W |
| 赤墨叠字 | 主字：点字油漆体（HelloFont ID YouQiTi）；手写字：默陌追风手写体 |
| 指针流词、造梦逐字、落日橘光、赤焰节拍 | 励字造梦简 特粗（Dream-PossibleGB，Black） |
| 云间飞墨 | 主字：云间书（Book）；辅助字：汉仪国图创新山海经 45简（45J） |
| 古风书法 | 主字：云间书（Book）；辅助字：老钱风（Book） |
| 蓝笺拾梦 | 主字：铁铁手写（Book）；辅助字使用内置思源宋体 CN Medium |
| 笺上心声 | 主字：方正清刻本悦宋简体（Regular）；辅助字：铁铁手写（Book） |
| 月映星笺 | 主字使用内置思源宋体 CN Medium；辅助字：铁铁手写（Book） |
| 柔粉流光、黑金唱片 | 方正清刻本悦宋简体（Regular） |
| 蓝调诗行、翡翠鎏金、深海逐光 | 汉仪瑞意宋 45W |
| 疾速重影 | 字魂181号－飞驰标题体（Regular） |
| 霓虹心动、暖金莓果、青柠脉冲 | 字由经典黑 95（HelloFont JingDianHei 95） |
| 玫瑰墨韵 | 默陌追风手写体（Regular） |
| 樱雪微光 | 铁铁手写（Book） |
| 月白墨影 | 云间书（Book） |

## 系统字体与兼容动效

| 动效 | 默认选择 |
| --- | --- |
| 经典扫唱 | 系统默认字体，可自行更换 |
| 手写微光 | 行楷-简（Xingkai SC）；缺失时按系统可用字体替代 |
| 折页轮词 | 苹方-简 Medium（面板默认名“中黑体”）；缺失时使用内置替代字体 |
| 蜜桃薄荷、晴空汽水 | 苹方-简 Medium；Windows 可使用微软雅黑替代 |
| 紫晶流彩 | 宋体-简 Bold；Windows 可使用宋体替代 |
| 星光流韵 | 宋体-简与行楷-简混排；缺失时使用系统可用宋体／楷体替代 |
| 燃光碎影 | 优先本机 HYLiLiangHeiJ（汉仪力量黑简），没有时使用系统替代字体 |
| 震字残影 | 优先本机 HYZhuZiSuDaHei／HYZhuZiSuDaHeiW（汉仪铸字苏打黑）；没有时使用系统替代字体 |
| 蓝光轮转 | 优先苹方-简，其次微软雅黑、Noto Sans CJK SC 等系统字体 |

Mac 的行楷-简、苹方-简、宋体-简等由系统提供，部分需在“字体册”下载。软件不另行分发系统字体；Windows 上的自动替代字形可能不同。星光流韵、燃光碎影等的小型英文装饰字也可能保留模板字体。

## 官方查找入口

以下是官方查询入口，不是字库直链；请核对完整名称、字重、授权和可独立安装的文件。

- [汉仪](https://hanyi.com.cn/)：搜索“雅酷黑”“瑞意宋”“国图创新山海经”，按上表核对 65W、45W、45J。
- [字由](https://www.hellofont.cn/?from=official)：搜索“点字油漆体”“经典黑”，同时核对 HelloFont ID YouQiTi、HelloFont JingDianHei 及 95 字重。当前商品名可能与字体内部名称不同。
- [方正清刻本悦宋](https://www.foundertype.com/index.php/FontInfo/ductdetail/id/199)：核对简体 Regular；不要只按相似名称选择另一套简繁家族或其他字重。
- [励字造梦简 特粗](https://www.dreamfont.cn/font/lizizaomengjian%20tecu)：英文名 Dream-PossibleGB-Black。
- [字魂](https://izihun.com/)：搜索“字魂181号”或“飞驰标题体”。
- 云间书、铁铁手写、老钱风：可在[剪映官方客户端](https://www.jianying.com/)的字体面板中查找名称、作者和授权信息。剪映内可用不代表可在 Subtitle Studio 中安装；若没有官方独立字体文件，请向版权方咨询，或使用替代字体。
- 默陌追风手写体：按完整名称向作者／版权方查询授权及独立字体文件；这里不提供未经核对的下载地址。

## 安装与重新使用

**Mac：**双击有权使用的 `.ttf`、`.otf` 或 `.ttc` 文件，在“字体册”点击“安装”，确认已启用；可下载的系统字体先完成下载。见[苹果安装说明](https://support.apple.com/zh-cn/guide/font-book/fntbk1000/mac)。

**Windows：**解压后右键 `.ttf` 或 `.otf` 文件，选择“安装”；需要所有用户使用时选择“为所有用户安装”，并在“设置”→“个性化”→“字体”确认。见[微软安装说明](https://support.microsoft.com/zh-cn/windows/experience/personalization/manage-fonts-in-windows)。

保存工程并完全退出 Subtitle Studio，再重新打开。要恢复某动效的默认字体和参数，可先切换到其他动效，再选回目标动效；要用自己的字体，请到右侧“属性”→“字幕”→“字体”→“字型”选择，随后核对“样式”。

客户包不附带上述可选字体。请按版权方许可核对演出投屏、直播、广告等用途；不要从其他软件缓存复制字体或转发未经许可的字库。
