Serial Studio 双重许可架构详解SPDX 声明、REUSE 合规与构建时 GPLv3/商业边界强制执行【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本文解析 Serial Studio 仓库的双重许可GPL-3.0-or-later 或 Serial Studio Commercial License模型如何以 SPDX 头部作为权威依据划分双许可文件、专有 Pro 模块与第三方依赖如何用 REUSE.toml 补齐无头部文件的许可声明以及构建系统如何从 CMake 配置、凭据校验到运行时守卫逐层强制执行许可边界。读完后你可以独立判断仓库中任意文件的法律状态、复现默认的纯 GPL 构建并理解官方预编译二进制与源码构建之间的许可区别。1. 许可体系总览SPDX 头部优先文档只做路由License 总说明 开篇即确立了整套许可体系的唯一权威原则每个文件的许可状态以其 SPDX 头部声明为准没有头部的文件由 REUSE.toml 覆盖。SPDX 声明具有最终效力LICENSE.md 本身不附加任何条款只负责把你路由到正确的法律文本。这是典型的 REUSE 合规实践许可信息下沉到每个文件SPDX 注释或集中式注解文件REUSE.toml而非依赖一个笼统的顶层 LICENSE 文件。仓库根目录的 LICENSES/ 目录存放全部法律文本的完整副本包括 GPL-3.0-or-later.txt、LicenseRef-SerialStudio-Commercial.txt、Apache-2.0.txt、MIT.txt、MPL-2.0.txt、OFL-1.1.txt 等 16 份文本保证分发时许可全文随包携带。该体系下每个文件恰好落在三类之一文件类别SPDX 表达式法律后果双许可文件GPL-3.0-or-later OR LicenseRef-SerialStudio-Commercial用户可选 GPL v3 或商业许可任一臂专有 Pro 模块LicenseRef-SerialStudio-Commercial仅此一项无 GPL 权利编译/使用/分发需有效商业许可第三方依赖各自上游许可证BSD、MIT、MPL-2.0 等遵循上游条款见 REUSE.toml 注解其中LicenseRef-SerialStudio-Commercial是一个 SPDX LicenseRef 自定义标识符指向仓库内自持的 LICENSES/LicenseRef-SerialStudio-Commercial.txt这是 REUSE 规范中声明专有许可的标准做法。2. 双许可文件GPL 臂的权利范围标记为GPL-3.0-or-later OR LicenseRef-SerialStudio-Commercial的文件按你的选择提供两种许可。GPL 臂下LICENSE.md 明确授予全部 GPLv3 权利任何用途含商用、私有修改并分发、源码或二进制再分发仅受 GPL 自身条件约束不附加任何额外条款。从构建系统结构看GPL 臂是仓库的默认状态。根 CMakeLists.txt 定义了两个许可相关的构建开关option(BUILD_GPL3 Force GPLv3-only build ON) # 默认 ON option(BUILD_COMMERCIAL Enable commercial features OFF) # 默认 OFF也就是说直接克隆仓库并按默认选项构建得到的就是 LICENSE.md 所说的仅包含双许可文件的构建默认BUILD_GPL3ON构建它是 GPLv3 软件。文件头部的许可声明也一致例如根 CMakeLists.txt# SPDX-License-Identifier: GPL-3.0-or-later OR LicenseRef-SerialStudio-Commercial3. 专有 Pro 模块的判定只看 SPDX 表达式是否为单项License 总说明 给出了 Pro 模块的严格充要条件一个文件是 Pro 模块当且仅当其 SPDX 表达式单独为LicenseRef-SerialStudio-Commercial。这类文件源码公开发布是为了透明、可审计、可贡献但它不附带任何 GPL 权利编译、使用或分发它都需要有效的商业许可且默认构建排除所有此类文件。在仓库中可以找到大量符合该判定的文件其功能面覆盖了 Serial Studio 的 Pro 能力构建期守卫生成器 cmake/GenLicenseGuards.cmakeSPDX-License-Identifier: LicenseRef-SerialStudio-Commercial许可 API 处理器 app/src/API/Handlers/LicensingHandler.cpp、LicensingHandler.hAI 助手界面族app/qml/AI/AssistantPanel.qml、ChatSidebar.qml、KeyManagerDialog.qml、ProUpgradeNotice.qml 等各协议驱动的配置面板app/qml/MainWindow/Panes/SetupPanes/Drivers/ 下的 Audio、CANBus、MQTT、Modbus、OpcUa、S7、USB 等 QML数据库探索器 app/qml/DatabaseExplorer/、仪表盘输出控件DashboardSlider.qml、DashboardKnob.qml 等、Waterfall.qml、Plot3D.qml 等高级可视化组件。这一划分让开源内核 专有增值模块的边界完全由文件级元数据表达而不是隐藏在某个中央清单里——审计者只需对每个文件做一条 SPDX 扫描即可复现全部边界。4. REUSE.toml无 SPDX 头部文件的集中式许可注解对于不便逐个加头部的文件资源、生成物、第三方整体目录REUSE.toml 以 TOML 注解块集中声明。它有两条关键的工程约定直接写在文件注释中首方资源目录逐个枚举而非用通配吞并。app/rcc/**被拆成actions/、ai/、icons/、scripts/等十余个子目录逐一列出原因是其中混有第三方字体fonts/与 vendor 资产通配符会把它们错误地标注为GPL-3.0-or-later OR LicenseRef-SerialStudio-Commercialprecedence override的使用有明确动机。默认优先级是最接近者优先文件自身头部永远赢但当上游 tarball 携带含 HTML 转义 SPDX 标签的生成文档、或文件内引用了被截断的 SPDX 示例如 .claude/** 的 agent skills 在代码围栏里引用头部样例时用override使注解成为唯一事实来源。值得注意的第三方依赖声明示例均出自 REUSE.toml路径版权人SPDX 标识符备注app/rcc/fonts/GeistMono-*.ttfThe Geist ProjectOFL-1.1OFL 要求许可文本随字体分发由 LICENSES/OFL-1.1.txt 满足app/rcc/vendor/highlight*Ivan Sagalaev 等BSD-3-ClauseAI 聊天/Markdown 查看器内嵌的 Web 资产各带 .LICENSE 副车文件core/Devices/ThirdParty/miniaudio.*David ReidMIT-0 OR Unlicense单头库在 REUSE 中声明而非改文件保持与上游逐字节一致、可 diffcore/Core/ThirdParty/fast_float.hfast_float 作者Apache-2.0 OR MIT OR BSL-1.0三臂许可取其一即可core/Core/ThirdParty/atomicops.hDesrochers / PreshingBSD-2-Clause AND Zlib复合表达式文件内嵌了 zlib 许可的信号量代码app/src/ThirdParty/tweetnacl.*Bernstein 等LicenseRef-PublicDomain公有领域lib/hidapi/**Alan OttGPL-3.0-only OR BSD-3-Clause OR LicenseRef-HIDAPI-Original三臂选择lib/mbedtls/**Mbed TLS ContributorsApache-2.0上游为 Apache-2.0 OR GPL-2.0-or-later项目明确取 Apache 臂——这是与本项目两种分发条款都兼容的选项此外REUSE.toml 还包含一段对依赖策略的审计性说明libplctagMPL-2.0在配置期经 FetchContent 获取、从不 vendored仓库仅持有自持的 CMake 装配文件并声明本项目没有任何 LGPL 依赖S7 协议客户端是一方 Qt-Core 代码core/Protocols/S7因此分发不受换链义务约束未来引入任何新依赖前必须针对 PROPRIETARY 分发而非仅 GPL 做许可审查。这条规则解释了为什么 mbedtls 要显式选 Apache 臂、mbed TLS 的 GPL-2.0 臂会被排除。5. 构建时强制执行CMake 如何把许可边界变成硬约束许可模型不只是文档声明构建系统将其落实为可失败的配置检查。5.1 互斥开关GPL 构建禁止混入商业模块CMakeLists.txt 在配置期做强制if(BUILD_GPL3) if(BUILD_COMMERCIAL) message(FATAL_ERROR You cannot enable commercial features (BUILD_COMMERCIALON) when BUILD_GPL3ON.\n Set -DBUILD_GPL3OFF to build with commercial modules.) endif() set(BUILD_COMMERCIAL OFF CACHE BOOL Commercial features disabled due to GPLv3 build mode FORCE) endif()即默认BUILD_GPL3ON时任何尝试打开BUILD_COMMERCIAL的操作都会在 configure 阶段直接FATAL_ERROR终止且BUILD_COMMERCIAL被以FORCE写回 OFF。这与 LICENSE.md 默认构建排除所有 Pro 文件 的承诺形成闭环纯 GPL 构建从源头保证不链接任何LicenseRef-SerialStudio-Commercial单项文件。5.2 商业构建配置期凭据校验CMakeLists.txt 显示商业构建BUILD_COMMERCIALON且BUILD_GPL3OFF必须提供SERIAL_STUDIO_LICENSE_KEY与SERIAL_STUDIO_INSTANCE_ID缺失即FATAL_ERROR。校验流程按源文件注释描述为检查凭据 → 确认curl可用 → 向 Lemon Squeezy 许可 API 发送校验请求 → 解析 JSON 响应确认valid:true→ 无效、过期或未激活则构建失败。实现细节上有一处安全考量值得注意凭据通过载荷文件传递绝不出现在 curl 命令行上因此不会暴露在进程列表或 CI 命令回显中CMakeLists.txt。另外 CMakeLists.txt 的注释说明ARCGIS_API_KEYPro 版 ArcGIS 地图功能仅在BUILD_COMMERCIALON时需要经环境变量或-D传入。5.3 运行时守卫基于构建盐的随机化许可校验函数商业构建还引入一层生成式防护cmake/GenLicenseGuards.cmake 在BUILD_COMMERCIAL且设置了COMMERCIAL_BUILD_SALT时以盐的 MD5 哈希派生出 24 个守卫函数——函数名动词名词后缀组合、算术校验与期望常数全部由COMMERCIAL_BUILD_SALT派生每次构建都不同。每个函数在运行时重算盐的变换并与编译期期望值比对生成器还会先编译一份自测头文件非法的输出会在 configure 阶段而非出厂二进制中失败。守卫头文件生成到${CMAKE_BINARY_DIR}/generated/LicenseGuards.generated.h。从源码结构看这种构建盐派生随机常量的设计使不同合法商业构建之间的守卫互不相同也令静态比对已知副本变得不可行该模块自身即 Pro 模块其 SPDX 为LicenseRef-SerialStudio-Commercial单项。6. 官方预编译二进制EULA 管辖不是 GPL 构建License 总说明 划清了一条容易混淆的线serial-studio.com 与 GitHub Releases 上发布的预编译二进制包含 Pro 模块仅按 Serial Studio 最终用户许可协议 分发且每个 release 含 14 天试用它们不是 GPL 构建。EULA.md 进一步界定了适用范围与试用规则适用边界EULA 只约束官方预编译二进制不约束源码归 LICENSE.md 管、不约束从源码编译的 GPL 构建仅受 GPLv3 管辖、也不约束 Pro 模块源码受商业源码许可管辖EULA.md试用条款每个 release 每用户每设备 14 天评估期期间全部功能解锁试用期内限评估用途——生产、客户工作与营收系统部署需激活许可同一设备上的重装、改系统时钟或伪造机器身份不能重置试用新 release 才开启新一轮 14 天EULA.md激活后可在商业、机构、企业与学术环境及生产系统中使用订阅计划随订阅有效终身计划授权为永久不可撤销除用户未补救的重大违约外EULA.md主要限制未经书面授权不得再分发/转售/镜像/托管包括嵌入容器镜像、固件或产品不得反向工程法定强制例外除外不得规避激活、试用或许可执行机制不得移除许可声明不得将软件呈现为自由或开源软件因其含专有模块且非 GPL 构建。这条边界对集成方至关重要你从本仓库源码自行构建并分发时走的是 GPLv3或商业许可路径而你下载官方二进制再分发时走的是 EULA 路径两条路径的权利与义务完全不同。7. 实操指引在仓库中定位任一文件的许可状态基于上述机制判断与使用流程可以归纳为先查文件 SPDX 头部。命中GPL-3.0-or-later OR LicenseRef-SerialStudio-Commercial→ 双许可文件可选 GPL命中单独的LicenseRef-SerialStudio-Commercial→ Pro 模块需商业许可且默认构建不会包含它无头部则查 REUSE.toml的注解块注意precedence字段override时注解为唯一事实来源文件内出现的 SPDX 字符串仅作文本引用复现纯 GPL 构建按默认选项BUILD_GPL3ON、BUILD_COMMERCIALOFF配置即可构建系统将强制保证结果不含商业模块评估官方二进制14 天试用期内全功能可用但仅限评估生产部署前需激活许可且再分发需书面分发许可EULA.md 第 3、4 节。配套文档可继续深入商标与品牌名称、Logo见 TRADEMARKS.md贡献流程与贡献者许可协议见 CONTRIBUTING.md第三方组件全清单见 REUSE.toml 与 LICENSES/。许可咨询与商业洽谈联系 alexserial-studio.com。8. 小结Serial Studio 的许可工程展示了文件级元数据 集中式注解 构建期强制三层叠加的做法SPDX 头部给出每个文件的法律身份REUSE.toml 用带优先级语义的注解覆盖头部缺失的场景并沉淀依赖策略如 mbedtls 取 Apache 臂、无 LGPL 依赖承诺CMake 则把互斥开关、商业凭据校验与盐值派生守卫变成可失败的构建步骤。对使用者而言核心结论是默认克隆即得 GPLv3 构建Pro 模块边界以 SPDX 单项表达式精确划定官方二进制则另受 EULA 与 14 天试用约束——三者各辖其域互不替代。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考