AI 实现仪器兼容

平台没收录的仪器怎么办？传统做法是工程师逐条阅读 SCPI/Modbus 编程手册、手工录入指令、再连上真机一条条调试——一台仪器没有几天下不来。本页以 贝奇 CH9733P+ 快克测试仪（SCPI 协议）为例，演示把编程手册 PDF 丢给 AI 后，如何在一杯茶的时间里完成「读手册 → 提取指令 → 批量导入 → 真机验证 → 修正解析」的完整仪器兼容过程。

流程总览

工程师                          AI（WorkBuddy + atecloud-flow-edit）      ATECLOUD
  │                                     │                                  │
  │ ① 平台新增仪器型号（1 分钟）──────────────────────────────────────────► │
  │ ② 上传编程手册 PDF + 一句话任务 ──► │                                  │
  │                                     │ ③ 加载指令导入工作流 ──────────► │
  │                                     │ ④ 解析手册、识别全部指令          │
  │ ⑤ 按测试需要圈定导入范围 ◄────────  │                                  │
  │                                     │ ⑥ 生成结构化指令表、批量写入 ──► │
  │ ⑦ 仪器连上 BOX、打开工位日志        │                                  │
  │                                     │ ⑧ 逐条真机验证、读日志定位问题    │
  │                                     │ ⑨ 修正解析规则、复测通过 ──────► │
  │ ⑩ 指令可用，直接进测试流程 ◄────────────────────────────────────────── │

步骤 1：平台新增仪器型号

在 ATECLOUD「仪器维护 → 仪器型号」中新增型号，填写基本信息：仪器型号 CH9733P+、仪器类型、仪器厂家（贝奇 btech）、命令结果符（换行符）。这一步是给仪器在平台里"上户口"，只需一分钟。

新增仪器型号

步骤 2：上传手册，一句话下达任务

打开 WorkBuddy，把仪器厂商的 SCPI 编程手册 PDF 直接拖进对话，附一句话任务：

此文档是仪器 CH9733P+ 编程手册，提取指令导入 ATECLOUD 中。

在 WorkBuddy 中上传手册

模型选择

复杂手册解析建议切换到推理能力更强的模型。AI 会自动加载 atecloud-flow-edit 技能中的指令导入工作流（instruction-import、handbook-format、instruction-conventions），按平台规范干活，而不是自由发挥。

步骤 3：AI 读手册，规划导入范围

AI 检查 PDF 解析环境后通读手册，先给出导入范围评估：全册 50 多条指令中，哪些适合自动化适配（如 TRIG、TRIG:SOUR、负载 LOAD/MSET/TRAN 系列）、哪些是面板/界面显示类指令可以不导，并说明理由。

AI 识别手册并规划导入范围

然后逐条提取指令，生成结构化指令表 CH9733P+_scpi.md，每条指令包含：指令说明、命令模板、参数表（参数名称、参数编码、数据类型、数据指标、数据单位、取值范围、参数说明）。

AI 生成的结构化指令表

步骤 4：按测试需要选择指令范围

AI 把识别结果编号列出，你只需要回复数字——根据实际测试需求选择要导入的指令（比如只导负载、电流、电压相关，跳过暂不用的接口类指令）。确认后 AI 批量写入平台，并自动核对写入结果。

按测试需要选择导入范围

导入完成后，进入「仪器维护 → 指令维护」就能看到新仪器名下的全部指令：设置负载模式、查询负载模式、设置/查询电压、电流、功率……参数表中连取值范围、参数说明都已按手册填好。

指令维护中查看导入的指令

步骤 5：真机验证

指令录进去只是第一步，能不能跟真机对上话才是关键。把仪器连到 BOX，在工位配置中打开日志订阅（串口/USB 设备服务，DEBUG/INFO 级别），然后让 AI 验证所有指令。

把仪器连到 BOX

打开日志看 AI 验证过程

日志里能实时看到 AI 逐条下发指令、读回包：会话建立、指令收发、偶发的串口重连……全程无需人工干预。字幕说得好——验证这么麻烦的事儿，让 AI 去干吧。

步骤 6：AI 自动定位并修正解析问题

真机验证最容易暴露"手册没写"的坑。本例中 AI 从日志发现：部分回读指令的 data 读数全部为空，而 state/mode 类正常。

AI 随即自主定位：抓取回读原文，发现回包带单位后缀（如 0.1300A、100.00V）——平台按数值解析时无法处理单位尾巴。接着它参照平台已有正确指令确认 regexps 解析规则的真实结构，为相关回读指令补上解析表达式，并逐条复测。

AI 参照平台已有指令修正解析规则

AI 逐条复测验证

修正后再次验证：回读值正确解析，测试指标（如负载电流，指标编码 data、类型数值、单位 A）配置完整可用。

回读指标与解析规则配置完成

常见坑：回读带单位后缀

仪器回包带单位后缀（0.1500A/100.00V）时，回读指标必须配置解析表达式（regexps），否则数值指标会被整条丢弃。这是手工录入时代最容易踩、也最难排查的坑之一——AI 从日志里自主发现并修复，正是它比手册好用的地方。

传统 vs AI：仪器兼容全过程对比

环节	传统人工	AI 加持
读手册	工程师逐页啃 PDF，数天	AI 通读手册并给出导入建议，分钟级
录指令	逐条手工录入参数表，易错漏	生成结构化指令表，确认后批量写入
选范围	全录或凭经验取舍	AI 分类评估，按测试需要回复数字即可
真机验证	逐条下发、肉眼对回包	AI 自动逐条验证，全程写日志可查
排查解析	回读为空时无从下手	AI 从日志定位单位后缀问题并修复
总耗时	数天	一次对话 + 一杯茶的时间

完整操作视频

▶ AI 实现仪器兼容完整演示（贝奇 CH9733P+，约 95 秒）

AI 实现仪器兼容 ​

流程总览 ​

步骤 1：平台新增仪器型号 ​

步骤 2：上传手册，一句话下达任务 ​

步骤 3：AI 读手册，规划导入范围 ​

步骤 4：按测试需要选择指令范围 ​

步骤 5：真机验证 ​

步骤 6：AI 自动定位并修正解析问题 ​

传统 vs AI：仪器兼容全过程对比 ​

完整操作视频 ​

相关链接 ​