Serial Studio 的 Swarm 审计修复实录Spec 0029 四波次修复与许可证体系简化【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本文基于 Serial Studio 仓库中已归档的规格文档 Spec 0029 任务清单 与 规格说明 展开完整还原一次由“60 个 AI Agent 审计”驱动的 22 项缺陷修复过程涵盖 Trial 许可证状态机的两处关键 Bug、Hobbyist 功能层的删除、GPL 构建下 Demo 的功能门禁、操作/锁模式下的 QML 命令门控、命令面板交互缺陷以及图标重映射与本地化问题。读完本文你可以理解该项目“验证不削弱、仅去除恒真比较”的许可证简化原则以及每个修复点在源码中的落点与验证方式。一、背景从 60-Agent 审计到 22 项确认问题Spec 0029 的规格文档明确记录了其来源针对最近 12 次提交specs 0027/0028 及许可证提交 1aa3c5ec进行的一次 60-agent Opus 审计30 条确认发现经去重后收敛为 22 个待修问题14 条被证伪的发现有意不修。修复被组织为四个波次Wave加一组收尾验证任务清单全部勾选完成状态于 2026-08-25 关闭。规格文档中固化了四项用户决策这是理解全部修复逻辑的钥匙D1 层数简化Trial 与 Pro 在试用期结束前拥有完全相同的功能集。删除已死的Hobbyist层以及所有形如featureTier() Trial/ Trial的功能门控比较isValid()与SS_LICENSE_GUARD()在每个调用点保持不动——验证逻辑没有被削弱被移除的只是恒真的层级比较。D2 Demo 门禁DemoRocketLaunch在 GPL 构建中整体禁用QML 入口隐藏DemoLauncher::startDemo()与system.startDemoAPI 在非商业构建中直接拒绝。D3 采样速率不动kAssumedMaxRateHz保持 1.024 MHz与原生热路径档位匹配不做速率感知钳制。D4 全量修复其余确认发现按波次全部修复。任务清单 tasks.md 将 24 项任务T1–T24与 3 项验证V1–V3逐条落点到了具体文件与行号下面按波次展开。二、Wave 1 — 许可证正确性T1–T62.1 T1Trial 构造函数无条件 readSettings()原始缺陷Trial 构造函数在“缓存许可证已被恢复为已激活”的启动路径下跳过了readSettings()导致两个连锁问题——reassertTokenIfEntitled()不知道真实的试用资格若该许可证随后被吊销Pro 功能会被静默剥离firstRun()返回错误值。修复后的实现见 Trial.cpp构造函数末尾无条件调用readSettings()第 95 行并且源码注释直接解释了这一设计Trial state loads unconditionally, even when a cached license restored as activated:reassertTokenIfEntitled()must know the real entitlement if that license is later revoked mid-session.installTrialToken()stays gated ontrialEnabled(), so loading state on a licensed machine cannot take the slot.即状态读取无条件执行但安装试用 token仍由trialEnabled()门控见 Trial.cpp已授权机器读取状态不会抢占共享 token 槽位。配合单例指针s_trialreassertTokenIfEntitled()第 115–121 行在 token 槽被其他许可证路径清空后能重新装填试用 token且刻意读取构造完成后的实例指针而非instance()避免 LemonSqueezy 构造期触达清空路径时造成 Meyers 单例递归。2.2 T2onServerReply 只清理自己拥有的 token第二个 Bug试用服务端回复处理会无差别清空共享 token 槽把 LemonSqueezyPro路径安装的合法 token 也清掉。修复后的分支见 Trial.cpp若trialEnabled()成立则installTrialToken(daysRemaining())装填 variant 为 Trial 的 token否则仅当CommercialToken::current().featureTier() FeatureTier::Trial时才clearCurrent()——只有 trial 自己拥有的槽位才会被 trial 清空。2.3 T3删除 Hobbyist 层与约 20 处层级比较D1 决策的落地。从当前源码可确认 CommercialToken.h 中的FeatureTier枚举现在只剩None / Trial / Pro / Enterprise四档Hobbyist已不存在。任务清单记录了全部受影响的门控位置SerialStudio 入口、Dashboard4 处、GPS、Output/Base、MDF4 Player/Export、ConnectionManager7 处、IO MQTT2 处、Sessions/Export、MQTT/Publisher、NotificationCenter、Console/Export2 处共约 20 处恒真的 Trial比较被删除。注意 D1 同时声明了边界isValid()与SS_LICENSE_GUARD()宏在每个站点原样保留验证强度不变。2.4 T4GPL 构建下整体禁用 DemoDemoLauncher::startDemo增加#ifndef构建守卫QML 侧入口main.qml、Welcome.qml、About.qml依据Cpp_CommercialBuild属性隐藏system.startDemoAPI 在非商业构建返回拒绝。仓库中BUILD_COMMERCIAL宏在 main.cpp、CLI 与模块管理等处均有引用从源码结构看该宏是贯穿 C 与 QML 的统一构建开关。此举直接了结了审计发现的“GPL 版进入 Demo 后弹 Pro 功能警告”问题。2.5 T5–T6工作区索引漂移与过期注释T5buildWidgetGroups中无数据集的 grid 被移除时不得平移其后 contenteditable="false">【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
