更新日志

1. 产品定位与组成

• 产品定位：桌面端 RGB 灯带控制软件，支持多设备管理与多种灯效模式（同屏 / 音乐 / 幻彩 / 单色 / 图形 / 跑马灯）。
• 工程组成
  • Skydimo：主程序（Qt UI、设备管理、特效管理、托盘、热键、设置等）
  • LibSkydimo：底层能力库（屏幕采集、音频采集/分析、网络更新/反馈、配置等）
  • CrashReporter：崩溃处理/上报相关组件

2. 用户端主要功能（按模块）

2.1 设备管理与控制

• 启动自动枚举控制器，发现/断开自动加入或移除设备并解绑特效
• 主页设备列表：图标、名称、ID；点击进入设备控制页
• 设备命名：修改显示名并写回设备配置
• 一键全开 / 全关
• Windows 会话锁定/解锁联动：监听并广播系统状态到所有设备

2.2 单设备 / 多设备联动

• 单设备模式：亮度/开关/模式切换仅作用于当前设备（默认）
• 多设备联动：一键切换“所有设备同步控制”，并同步当前特效参数到其他设备

2.3 灯带布局 / 安装配置

• 安装方向设置：安装方向与 TopDown 方向
• 灯珠数量/布局设置：支持 1 边 / 4 边等可裁剪长度设备的灯珠数输入与校验（含规则约束与提示）
• 配置界面标题可显示型号 / COM / 序列号等信息

2.4 特效系统（模式分组 + 子模式）

• 特效分组定义：effects/groups.json
• 特效加载：内置特效 + ./effects/*.dll 外置特效插件
• 同屏模式（id.effect.screenSync）：全屏、半屏（上/下/左/右）、电影模式；支持“同屏高级编辑模式”（需重启）、屏幕采集模式下拉切换
• 音乐模式（id.effect.dynamicMusic）：音乐 1~8（peak values 系列）；底层为 FFmpeg 重采样 + FFT 频谱分析
• 幻彩模式（id.effect.colorful）：流光异彩、影随心动、ColorMap 3~8 等
• 单色模式（id.effect.singleColor）：固定颜色显示/设置
• 图形模式（id.effect.graphics）：PixmapStream 及对应参数面板；仅特定型号（如 SK0N03）显示该分组
• 跑马灯模式（id.effect.marquee）：模式 1~7；共用颜色/参数面板

2.5 快捷键（全局热键，可配置）

• 全开全关切换：默认 Ctrl+Alt+Shift+F10
• 上/下一个模式组：默认 Ctrl+Alt+Shift+←/→
• 亮度增/减：默认 Ctrl+Alt+Shift+↑/↓

2.6 设备物理按键（可配置）

• 开关灯、切换到下一模式/分组
• 可配置“单设备生效”或“多设备联动”

2.7 系统托盘与窗口行为

• 托盘图标：点击/双击显示主窗口；菜单提供“设置/退出”
• 关闭按钮：首次关闭可选择“退出”或“最小化到托盘”，并可记住选择

2.8 设置中心（通用 / 快捷键 / 高级）

• 开机自启（Windows）：注册表 Run + --auto_startup；自启后可隐藏主窗口
• 多语言切换：从 translations/app_*.qm 加载；可按系统语言自动切换
• Gamma（伽马）调节：runtime.gama
• 高级开关：屏幕编辑、同屏截图/快照、循环日志、同屏高级编辑（需重启）
• 恢复默认设置/清空用户数据：设置清理标记并退出，下次启动清空配置并重建目录

2.9 在线更新 / 版本检测（Windows）

• 启动检查新版本：拉取 version + download_url + sha256 并写入全局配置
• 下载并校验安装包：SHA256 校验通过后启动安装并退出
• macOS：更新入口跳转官网

2.10 帮助与反馈（含日志上传）

• 帮助弹窗：版本信息 / 问题反馈 / 联系我们
• 反馈上报：内容与联系方式（4~100 字符），打包日志并上传，成功/失败提示
• 运行数据上报：启动/退出时间等（用于统计/激活/分析）

2.11 稳定性与崩溃处理

• 单实例运行：重复启动激活已有实例
• 异常退出检测：临时文件判断；可提示“恢复出厂设置”解决启动异常
• CrashReporter：启动初始化、退出反初始化；支持崩溃测试开关

3. 命令行参数（高级用法/调试）

• --advanced：启用高级扩展模式（影响设置页“高级设置”与同屏编辑能力）
• --enable_crash_test：启用崩溃测试入口
• --screenshot：启用屏幕捕获场景快照（用于日志反馈）
• --auto_startup：自启标记（自启后隐藏主窗口）
• --enable_VTController：启用 VTController（能力取决于控制器实现）