写频通 · RadioCPS
面向对讲机售后服务门店的通用写频与客户管理平台。56 个型号的知识库、15 个品牌、10 个驱动族，把自动识别、云端机器档案、跨品牌克隆、工单闭环与机型库持续跟进做成一个系统——写频是入口，订阅是收入，机型库是护城河。
RadioCPS 是金通（Kingtone Solutions）出品的产品名，中文对外称「写频通 · RadioCPS」。它与 Motorola 的 Business Radio CPS 不是同一产品， 两者无任何从属或授权关系——我们做的是覆盖 15 个品牌、56 个型号的通用写频平台， 而 CPS 只是其中一个品牌的官方写频工具。我们用自己的机型库与识别能力， 把不同品牌的写频统一到一套流程里。
写频是入口，订阅是收入，机型库是护城河
国内对讲机经销与维修门店是万级规模的市场，2–5 人的小团队就足以支撑这个服务。 写频通是一套**对讲机写频软件**加门店管理：它真正做的不是"更好的 CHIRP"， 而是把门店每天要做的事——收机器、读频、备份、改频、写回、留档、跟客户——串成闭环。 护城河在**机型库的运营速度**，不在代码本身。
自动识别
连上机器先探测指纹、排队判定型号，不靠人工在几十个驱动里翻。识别到就进入对应的协议核，识别不到会明确告诉你缺哪个型号，而不是猜一个写下去。
云端机器档案
每台机器一份档案，随写随存；本地是唯一事实源，门店之间按游标增量同步。客户换机、重启、恢复基线都有据可查。
跨品牌克隆
把一台机器的频率表搬到另一台，跨品牌也可以：自动裁剪超容量字段、过滤出频段的信道、对齐字段名，DMR 的三张表一并重排。裁剪结果会完整报告，不静默丢字段。
工单闭环
客户档案、故障工单状态机、复购提醒在同一个系统里；信道方案库只算不写，确认后再下发到机器。
机型库持续跟进
新机型进来只加数据、不改代码：机型差异全部下沉到模板 JSON，引擎层不认识任何具体型号。这是 CHIRP 不做也不愿做的事。
中继台同样支持
手台、车载台、中继台三类形态都在库里；中继台的专有字段走扩展位，不污染通用数据结构。
覆盖度：56 个型号 · 15 个品牌
按协议来源分：开源驱动可借鉴 16 个、需抓包逆向 28 个、仅官方闭源 CPS 10 个、网关路线 2 个； 另有 DMR 机型 20 个、仅识别条目 14 个。形态分布：手台 40、车载台 7、中继台 9。 数字对讲机写频软件要处理的不只是频率表：信道与时隙、色码、组呼、用户 ID 都得按型号写对， 写错一项就可能出现"能开机但呼不通"。机型库里没有的，发型号给我们，逆向补进来。
三层解耦：加机型只加数据，不改代码
引擎层不认识任何具体机型，机型差异全部下沉到模板 JSON；上层 Web 界面与命令行统一经驱动注册表调用。 规模：79 个 HTTP 端点、64 个命令行子命令、534 个单元测试用例。
成熟度与红线（先说在前面）
- 真机验证只有 2 个族通过（金通 JST-A800Plus、QT R-200 区制中继台，均 2026-10-07），其余 8 个族目前只有单元测试覆盖， 写频门禁会拦截，需要显式二次确认才能落盘。
- 三条写频安全防线：写回前强制备份 .bak；noTouch 禁写区写入直接拒绝；任何字段写入都不得改变镜像大小。 克隆超出容量或频率范围自动裁剪并完整报告。
- 法律边界：不反编译、不分发原厂 CPS 二进制；只通过自购设备抓包分析；商用收录一律实机采购验证。
- 订阅只掐云端功能，永不掐本机写频；门店过期后仍可把数据 pull 走。
门店怎么部署
四条路径，软件完全相同，只是启动与暴露方式不同；部署有 G1–G9 九道门禁逐项校验。
A. 群晖 NAS + Docker
本单位推荐路径：Container Manager 里跑容器，8790 端口映射到 80/443；数据目录纳入 Hyper Backup，就等于备份了全部门店数据。
B. 云主机 + Docker + Caddy
Caddy 自动申请并续期 Let’s Encrypt 证书；建议给管理入口再加一层 basicauth。
C. 裸机 systemd + Nginx
Python 3.9 以上，建专用系统用户运行；单次推送上限 8 MB。
D. 本机 NAS 专属路径
无 SSH 凭据时的现实解：SMB 共享当部署交换区，DSM 任务计划当一次性 root 执行器。
常见问题
写频通和 CHIRP 有什么区别？
CHIRP 是一个通用开源写频工具：机型多、但要你自己知道是哪一款、自己选驱动、自己填表。写频通把自动识别、云端机器档案、跨品牌克隆、工单闭环和机型库持续跟进做成一个平台——门店拿到的是"这台机器现在什么状态、这份频率表上次写到哪、下一步做什么"，而不只是一次写频动作。护城河在机型库的运营速度，不在代码本身。
支持哪些品牌和机型？
知识库 56 个型号、15 个品牌：摩托罗拉 8、海能达 7、TYT/AnyTone/Retevis/Radioddity 7、宝锋 6、建伍 4、北峰 4、欧讯 3、ICOM 3、科立讯 3、通灵/威而威/飞达信 3、泉盛 2、八重洲 2、消费级 2、金通 1、QT 1。按协议来源分：开源可借鉴 16、需抓包逆向 28、仅官方闭源 10、网关路线 2（另有 DMR 机型 20 个、仅识别条目 14 个）。机型不在库里可以提型号，逆向补进来。
对讲机怎么调频率配对？
先写频、再配对：把主机写好频率表（这就是写频），再让主机与副机用"克隆/配对"功能互拷，多数机型是按一个功能键加开机组合键，几秒完成。写频通把第一步做成了网页操作：选型号、填频率表、生成该机型的写频文件，再按提示用写频线写入或直接克隆。配对前必须对齐制式、频段与功率档位——任一项不一致，就会出现"两台机都能开机、互相却呼叫不通"。
写频会不会把机器写坏？
有三条硬防线：写回前强制备份一份 .bak；noTouch 禁写区里的字段写入直接拒绝；任何字段写入都不得改变镜像大小。克隆结果超出容量或频率范围时会自动裁剪，并且完整报告裁了什么，绝不静默丢弃。
没有原厂 CPS 的机型怎么办？
走自购设备抓包逆向：protocolStatus 标为 reverse-needed 的型号，用自购机器抓包分析协议事实（偏移、位域、字段语义、校验算法），代码全部重新写。法律边界很明确：不反编译、不分发原厂 CPS 二进制、不链接或内嵌 CHIRP 代码，商用收录一律实机采购验证。
怎么收费？
SaaS 订阅是主力收入线：每付费门店 1,000–3,000 元/年。另有机型解锁、批量版、硬件写频线与 OEM 授权。两条刻意的设计：订阅只掐云端功能，永不掐本机写频；门店过期后仍可把数据 pull 走，不做把人逼到墙角的生意。状态机是 active → grace（14 天）→ expired，另有 suspended。
哪些机型已经通过真机验证？
目前 2 个驱动族通过真机读-写-改-恢复验证：金通 JST-A800Plus 与 QT R-200 区制中继台（均为 2026-10-07）。其余 8 个族目前只有单元测试覆盖，写频门禁会拦截，需要显式二次确认才能落盘。我们把这个状态直接写在明面上：先存盘再写、绝不拿只有读没有写的机器试写、恢复原状是收尾硬要求。
门店怎么部署？
四条路径，软件完全相同，只是启动与暴露方式不同：A 群晖 NAS + Docker（本单位推荐，数据目录纳入 Hyper Backup 即等于备份全部门店数据）、B 云主机 + Docker + Caddy（自动续签 Let’s Encrypt）、C 裸机 systemd + Nginx（Python 3.9+，专用系统用户）、D 本机 NAS 专属路径（无 SSH 凭据时用 SMB 共享当部署交换区 + DSM 任务计划当一次性 root 执行器）。部署有 G1–G9 九道门禁逐项校验。
可以跨品牌克隆吗？
可以。克隆时自动做四件事：裁剪超容量字段、过滤出频段的信道、对齐字段名、DMR 的三张表一并重排。克隆结果超出容量或频率范围会自动裁剪并完整报告，不会静默丢弃任何字段。