先定指标口径，再谈设备接入
把「在线率」「上报成功率」「指令往返时延」写成统一公式，避免各子系统各算一套。
- 在线率 = 心跳成功设备数 / 纳管设备数，窗口建议 5 分钟滚动
- 每条指标写清单位、采样周期、聚合方式（avg / p95 / max）
- 预留 10% 口径冗余字段，后续扩设备不必推翻表结构
01 / 清单
物联网接入实用指导清单
六条可直接执行的动作项，覆盖协议选型、指标口径与暗黑模式前端呈现，每条都带可验收的量化阈值。
协议分层：高频走 MQTT，低频走 HTTPS
按上报频率与包体大小分流，别让长连接被低频报表拖垮。
- 上报间隔 < 30s：MQTT 5.0 + QoS1，开启会话保持
- 上报间隔 ≥ 5min：HTTPS 批量提交，单批 ≤ 500 条
- 下行控制指令单独通道，避免与遥测争抢带宽
告警先降噪，再谈推送
把抖动、重复、连带三类噪声在规则层拦掉，值班人员才看得动暗黑界面的告警流。
- 连续 3 个采样点越限才触发，避免单点毛刺
- 同一设备同类型告警 10 分钟内合并为一条
- 根因告警置顶，连带告警折叠展示
暗黑模式对比度：正文 ≥ 7:1
低明度底不等于低对比，文字与背景的对比度必须过线，图表色也要留出区分度。
- 正文对比度 ≥ 7:1，次要说明 ≥ 4.5:1
- 霓虹强调色只用于关键数字、按钮与激活态，面积 ≤ 10%
- 曲线配色限制在蓝 / 青 / 暖橙区间，避免同屏出现相近明度色
边缘缓存 72 小时断网续传
网络抖动是常态，边缘侧必须能扛住断连，回补后不产生重复数据。
- 本地环形缓冲 ≥ 72 小时，按设备分队列
- 每条数据带唯一序列号，云端幂等去重
- 回补期间限速，避免瞬时打满上行带宽
上线前做一次「数据驱动复盘」
用真实数据回答：哪个环节最慢、哪类设备最不稳、哪条规则最吵。
- 拉取上线后 7 天 p95 时延与失败率分布
- 按设备型号、站点、固件版本三维下钻
- 输出一张问题排序表，明确责任人与修复窗口
02 / 流程
从设备到决策的四步工作流程
按时间线推进，每一步都有明确产出物与卡点，卡点不通过不进入下一步。
第一步 · 资产盘点
清点网关、传感器、PLC 型号与固件版本，形成设备台账。
产出：设备台账 CSV
第二步 · 接入建模
按协议分组配置采集模板，统一点位命名与单位。
产出：点位字典 v1
第三步 · 规则与看板
配置降噪规则、阈值与暗黑模式看板布局，明确刷新节奏。
产出：告警规则集
第四步 · 灰度与复盘
先接 10% 设备灰度 7 天，指标达标后全量，再输出复盘表。
产出：灰度对比报告
03 / 生态
合作伙伴墙
从芯片模组到行业集成商，生态能力按角色分层，便于按需对接。
芯模组低功耗 NB-IoT / Cat.1
边缘盒协议转换与本地缓存
云平台时序库与规则引擎
可视化暗黑模式大屏组件
集成商产线 / 园区交付
安全商证书与访问审计
已对接生态伙伴 42 家
预置协议模板 68 套
平均接入周期 9 天
联合方案复用率 61%
04 / 问答
常见问题 FAQ
围绕暗黑模式呈现、数据链路与交付节奏的高频疑问，给出可执行的答案。
暗黑模式界面会不会影响数据判读？
关键不在亮或暗，而在对比度与色彩层级。建议正文对比度 ≥7:1，指标数字用高亮暖色，曲线限制在蓝 / 青 / 暖橙三色区间，霓虹色面积控制在 10% 以内。这样在弱光控制室里长时间盯屏，疲劳度明显低于浅色界面。
老设备不支持 MQTT，怎么接进来？
在边缘侧做协议转换：Modbus RTU / TCP、OPC UA、BACnet 先经网关转成 MQTT 上行，网关承担点位映射与单位换算。单台网关建议纳管 ≤200 个点位，超出后拆分或升级型号，避免采集周期被拉长。
如何用数据判断项目是否需要扩容？
盯三个指标：p95 上报时延、broker 连接数水位、时序库写入延迟。当 p95 时延连续 3 天超过 200ms，或连接水位长期高于 70%，就应规划扩容。提前扩容的成本远低于告警延迟带来的处置损失。
告警太多，值班人员开始忽略怎么办？
做三层降噪：单点抖动过滤（连续 3 点越限才触发）、同源合并（10 分钟内同类合并）、根因置顶（连带告警折叠）。经验值是把每日告警量从千条压到 百条以内，响应率才会回升到 90% 以上。
从签约到看板上线通常要多久？
标准节奏是：资产盘点 2 天、接入建模 3 天、规则与看板配置 3 天、灰度观察 7 天，整体约 15 天。若涉及产线停机窗口，需额外预留排期。灰度阶段建议只接 10% 设备，指标达标后再全量。