实时看板

快速入门

首次使用时先确认账号权限和系统连接状态，再开始日常操作。

1. 打开管理员提供的系统地址，输入账号和密码后登录。
2. 确认顶部显示“实时连接”，右上角显示正确的用户名和角色。
3. 进入“实时看板”确认设备在线，重点查看红色“老化失败”卡片。
4. 进入“设备管理”核对 IMEI、分组、最后上报时间和当前参数。
5. 老化结束后进入“老化记录”，按设备或 PSN 查询结果并查看曲线。

实时看板

看板集中显示每台老化机当前状态、温度、功率、电流、运行时长以及累计成功/失败数量。

• “分组”只显示指定设备组；顶部设备总数及老化中、空闲、暂停、失败、离线数量会随分组和搜索条件实时更新。
• 支持按设备名称、设备 ID 或 IMEI 搜索，并可叠加分组和在线状态筛选。
• 设备列表采用紧凑分页模式，每页可选择显示 20、50、100 或 200 台，表头和操作列保持可见。
• 布局可选择 5×5、10×5 或 10×10，分别显示 25、50 或 100 台/页。
• 实时消息持续更新状态，同时每 60 秒主动同步一次完整看板快照，适合 24 小时展示。

设备管理

系统支持手工新增和硬件自动发现两种接入方式。新固件通过 HTTPS 上报 IMEI 后，管理员可以在“待认领”中核对并创建 JetLinks 设备；旧设备仍可继续使用“新增设备”。

1. 自动发现设备：核对机身 IMEI，在批准前设置唯一设备 ID、设备名称和分组，然后点击“核对 IMEI 并认领”。
2. IMEI 是不可变的硬件身份；设备 ID 是 JetLinks 实例、MQTT clientId 和 topic 身份，可以在认领时设置为 WKY001 等业务编号。
3. 认领成功后设备 ID 不能原地修改，如需更换必须删除设备并重新激活；设备名称和分组可以随时修改。
4. 填写唯一设备 ID、设备名称，可选填预期 IMEI、分组和备注。
5. 创建成功后设备先显示为离线；硬件连接并上报后，实际 IMEI、状态和当前参数自动更新。
6. 预期 IMEI 仅用于登记核对，列表中的实际 IMEI 始终以上报字段 im 为准。
7. 使用列表顶部的分组筛选快速缩小范围；点击表头可切换升序和降序。
8. 管理员点击“编辑名称”可修改 JetLinks 中的设备名称，设备 ID 不会改变。
9. 管理员只能删除已经离线的设备；系统会先取消激活，再从 JetLinks 删除设备实例。

设备列表用于核对设备身份、连接状态、当前参数、老化统计和历史记录入口。

字段	说明
设备名称	JetLinks 中的设备名称或设备 ID。
IMEI	来自设备上报字段 im；未上报有效 15 位编号时显示“未上报”。
软件版本	优先显示设备最近上报的 fv、fw 或 firmwareVersion；没有版本上报时显示自动认领时的版本。
凭据状态	“设备独立凭据”表示由自动认领流程创建；“共用凭据待迁移”表示现有设备尚未切换。
当前参数	采用设备最近一次有效上报中的温度、功率、电流和配置范围。
记录统计	显示该设备累计产品数、成功、失败和健康度。

管理员可直接在设备列表的分组下拉框中调整设备归属；普通用户只能查看已授权设备。

远程配置 管理员

远程配置只允许选择在线设备。系统读取设备最近一条完整且已上报或确认的参数，也可通过单台设备或分组批量下发。

读取设备配置

1. 选择“单台设备”或“按分组批量”。
2. 选择在线目标；分组模式下还要选择其中一台在线设备作为读取来源。
3. 切换目标只改变下发对象，不会读取或替换当前参数；需要读取时手动点击“读取设备当前配置”。
4. 系统按时间读取最新完整配置，来源包括完整 EVENT、success=true 的下发配置回复和完整属性上报。
5. 只使用包含全部 rc/tck/tlv/tov/pkp/pbg/plv/pov/wr 的消息，不会被普通 warn 事件覆盖。

下发与成功判断

1. 核对温度上下限、功率上下限、上报周期、检测延时和老化时长。
2. 输入右上角当前登录账号自己的系统登录密码，单击“下发配置”；不要填写 JetLinks 或 MQTT 密码。分组模式会再次显示设备数量和最终九项参数供确认。
3. 平台发送 WRITE_PROPERTY 后，不以 HTTP 接口返回作为最终成功依据。
4. 只有收到该设备下一条 WRITE_PROPERTY_REPLY 且 success=true，才显示配置成功。
5. 配置下发记录最多保留 5000 条，可按设备和结果筛选；展开记录可查看操作者、模板、下发参数、失败原因和设备回执。系统登录密码不会写入记录。
6. 管理员可在“设备上线自动下发”中选择单台设备或分组，并关联已保存模板。设备由离线变为在线且处于空闲状态时自动下发；老化中、暂停和故障状态会跳过，同一设备 5 分钟内不会重复触发。

配置模板

可为常用型号保存具名模板并按组管理，支持导入 JSON；系统最多保留 200 个模板。

选择已保存产品配置后，名称和九项参数默认灰化锁定，可直接下发。需要调整时点击“修改参数”，核对后必须点击“更新当前模板”才会生效。

新建配置默认使用温度 0–90℃、功率 1–300W、60 分钟老化，以减少启动阶段误报；手动读取设备配置后参数会保留，直到再次读取或主动选择其他模板。

老化记录

记录按产品测试过程组织，可按分组、设备、结果、PSN、异常类型和开始日期范围组合筛选；结束日期包含当天全部记录。

• 设备开始上报有效温度和功率数据后，系统开始形成可追踪过程。
• 正常结束：结束事件同时满足 cmd=2 且 st=0，只表示设备按协议正常结束。
• 绿色无风险：设备正常结束且智能分析没有发现异常；温控阶段边界仅用于解释曲线，不单独作为风险。
• 黄色需要关注：设备正常结束，但后台曲线分析发现了明确风险。
• 异常结束：结束时存在温度、功率、传感器或其他状态位错误。
• 未完整结束：已经形成有效曲线，但没有收到完整结束事件，仍保留用于排查。
• 只有零散事件、没有有效温度/功率过程的数据不计为一个产品。

列表默认每页显示 50 条，可切换为 20、100 或 200 条；筛选条件变化后自动回到第一页，右侧曲线图标始终固定可见。协议正常结束的记录先显示绿色，后台发现明确曲线风险后才转为黄色。

PSN 由设备协议上传。没有 psn 字段时不影响记录保存；同一 PSN 多次老化会分别保存，便于复测对比。

管理员、技术员和品质人员可勾选 2 至 50 条记录，选择一个配置模板作为比较基准后执行批量 AI 分析。结果包含共性、差异、异常聚类和九项参数研究建议；管理员和技术员可逐项接受或拒绝参数建议，接受后更新模板，但不会自动下发设备。

曲线与智能分析

只要过程包含温度或功率采样，即使没有正常结束，也可以查看曲线。

• 红线表示温度，绿线表示功率，紫色标记表示系统识别的异常点。
• 横轴为时间，左轴为温度（℃），右轴为功率（W）。
• 鼠标移动到采样点可查看该时刻时间、温度、功率和状态。
• 智能分析会识别全功率升温、调功缓升温和恒温保温阶段，并计算升温速度、平均功率、最大采样间隔和异常时间点。
• 进入保温阶段后的低功率和间歇补热属于正常温控行为；只有持续失去功率并伴随温度停止上升或回落时，才作为潜在断路风险提示。

老化分析

分析报告汇总上一完整日、周或月的测试情况，用于比较老化数量、成功率、失败类型和潜在风险。

1. 管理员输入方案名称，选择一个或多个设备，或一个或多个分组。
2. 勾选日报、周报、月报，可同时设置多个周期。
3. 日报、周报、月报通知可分别选择；只有选中的周期才发送钉钉报告。
4. 保存后系统在空闲时生成，也可在方案列表单击“立即生成”。
5. 报告永久保存在系统中；管理员可删除，普通用户只能查看授权设备范围内的报告。

报告包括老化总数、成功/失败数、成功率、故障占比及变化趋势，并关注连续失败、设备间质量差异、接近阈值的合格记录和同一 PSN 重复失败。

启用国内 AI 后，日报和周报会补充潜在问题、变化趋势与排查建议；协议状态码和本地确定性规则仍是最终判定依据。

原始数据 管理员

原始数据用于调试 MQTT 上报、事件、配置回复和上下线状态。列表先显示可读解读，展开后再查看完整 JSON。

• 可按分组、设备、消息类型、关键词和条数查询，日常建议每页 100 条。
• EVENT 会解读具体事件、时间、cmd 和 st 错误原因。
• 属性上报会显示温度、功率、电流、IMEI、PSN 和状态摘要。
• 下发配置回复用于确认 WRITE_PROPERTY_REPLY / success=true。

用户管理 管理员

管理员可创建管理员、技术员、品质人员、客户和老化操作账号，并按设备分组或单台设备分配访问范围。

角色	主要权限
管理员	全部权限，包含设备、用户、分组、AI 与通知管理。
技术员	读取和下发配置、维护配置模板、查看原始数据、执行批量对比分析。
品质人员	查看已授权设备、记录和报告，并执行批量对比分析。
客户	只读查看已授权设备、老化记录、曲线和报告。
老化操作	查看已授权设备和记录，读取并下发配置；不能维护模板或查看原始数据。

1. 单击“新增用户”，输入用户名和至少 6 位初始密码。
2. 勾选整组授权，或单独勾选设备，核对“已授权设备”数量。
3. 创建后可编辑授权范围、重置密码、停用或重新启用账号。
4. 管理员可在“管理员账号安全”中修改自己的密码。

系统设置与分组 管理员

分组在“系统设置”中统一维护，设备归属在“设备管理”的分组下拉框中选择。

1. 进入“系统设置”，输入名称并新增分组。
2. 返回“设备管理”，为设备选择刚创建的分组。
3. 系统保存后同步更新 JetLinks 设备标签 group。
4. “钉钉机器人”可配置多个 Webhook，并按设备或分组选择不同通知范围。
5. “AI 分析服务”支持阿里云百炼和 DeepSeek；API Key 使用 AES-256-GCM 加密保存，不在页面回显。
6. 保存后使用“发送测试”检查群机器人连接；Webhook 和 Secret 不会在页面明文回显。
7. 只有未分配设备的分组可以删除；不存在的分组不会显示在筛选项中。

状态码速查

st 是 16 位状态位，可能同时包含多个错误位。系统会按位拆解并显示全部错误原因。

常见问题与排查

安全与维护

• 管理员首次使用后应修改默认密码，禁止多人共用管理员账号。
• 生产环境建议配置 HTTPS，避免账号、Cookie 和业务数据明文传输。
• SSH 和管理端口仅向可信 IP 开放，禁止长期对全部公网地址开放。
• 定期备份用户、分组、配置模板、分析方案、报告和会话数据。
• JetLinks/PostgreSQL 数据应按企业备份策略定期备份并验证恢复。
• 设备与服务器时间应保持同步，避免影响曲线和老化过程匹配。

操作检查表

文档版本 V1.0 · 更新日期 2026-07-20