SDD V2.27 · 2026-08-26

MRRC Modern
软件设计说明书

用于记录多电台(FT-710 / IC-7300 / IC-7300MK2)网页控制系统的架构、 接口、运行模型与版本演进,作为实现与设计的一致性基线文档。

SDD 范围

IBM TeamSD 对齐,15 章,内容基于实际代码状态。

属性
文档 IDSDD-MRRC-MODERN-2026-001
版本V2.27
基线日期2026-08-26
后端运行时Python 3.12+, FastAPI, Uvicorn, PyAudio, NumPy
前端技术HTML5, CSS3, 原生 JavaScript, Web Audio API
核心接口4+1 路 WebSocket(可选 ATR1000)+ 串口 CAT / CI-V + FT4222 SPI / CI-V 0x27 + USB 音频

V2.20 之后的变更重点

MRRC 品牌统一 + 环境变量迁移 (V2.21–V2.22)

FT710_* 环境变量更名为 MRRC_* 并自动兼容旧前缀;启动器、认证 Cookie 与日志命名统一为 MRRC Modern;启动配置模板暴露 MRRC_RADIO_MODEL

IC-7300/MK2 运行可靠性 (V2.24)

按后端选择串口默认波特率(FT-710 38400;IC-7300/MK2 115200);CI-V 0x27 分路队列上限 44 段、积压丢最旧,防止暂停后回放陈旧波形;频谱以 30 Hz 广播且只发送新完成的真实帧。

官方 CI-V 一致性对齐 (V2.25–V2.26)

频谱启动同时开启显示(27 10 01)与波形输出(27 11 01);SCROLL-C 解码为下/上边缘;按型号选择 Transceive 菜单项(IC-7300 0071 / MK2 0089);改用文档化的 03 在线探测;ALC 采用官方 raw 120 满刻度。全仓审计记录了开放问题 I8–I11。

v1.12.0 Windows 稳定版发布 (V2.27)

经 macOS 与 Windows 11 双端 633/633 测试、三个 PyInstaller 目标、Inno Setup 编译与跨主机 SHA-256 校验后发布。FT-710 的 CAT、音频、PTT 与频谱行为保持不变。

SDD 15 章

AD-001 ... AD-016

AD-001 FastAPI/Uvicorn AD-002 直连 CAT AD-003 脏字段广播 AD-004 Opus/PCM 标签流 AD-005 scope_pipe 隔离 AD-006 双模式频谱 AD-007 PTT 安全流程 AD-008 音频设备自动检测 AD-009 7 任务轮询 AD-010 JSON 记忆信道 AD-011 48kHz 编解码 + 44.1kHz 桥接 AD-012 Active-VFO 跟踪 AD-013 表头校准 AD-014 CAT 勘误处理 AD-015 优先级 CAT 抢占 AD-016 可插拔电台后端