03 · 我该从哪一章开始看
这本手册 21 章,不用从头读到尾。找到和你最像的那条,按顺序看那几章就够了。
先看这个:按你的目标选
目标 1 —— "我是新来的,想先搞明白这套东西怎么搭起来的"
01 这套软件是怎么跑起来的 ← 必看,建立全局观
02 名词表 ← 术语过一遍,不用背
20 程序集速查表 ← 一页看全 15 个程序集
然后按需要跳到具体章节
预计 30 分钟。看完你就能在别人提到"实时库""通道""驱动"时知道在说什么。
目标 2 —— "我要接一台 PLC,把数据采上来"
05 点、通道、设备 ← 先搞清三个概念的关系
07 驱动是怎么工作的 ← 采集循环怎么跑、块读怎么规划
08 内置协议怎么用 ← 找到你的 PLC 型号,照抄地址写法
10 运行数据引擎 ← 把工程真正跑起来
关键点:先确认你的 PLC 用哪个协议(在第 08 章的清单里找), 然后按那个协议写地址。地址写错是最常见的失败原因。
目标 3 —— "我要支持一种新协议(自研设备 / 冷门 PLC)"
07 驱动是怎么工作的 ← 理解 IProtocolDriver 的契约
09 写一个自己的协议插件 ← 从零到能加载的完整流程
第 09 章有完整的 plugin.json 字段说明、ABI 校验规则和最小可跑代码。
目标 4 —— "我要在工程里写脚本做逻辑判断"
12 脚本运行时与脚本形态 ← 有哪几种脚本、分别什么时候跑
13 脚本函数库速查 ← 15 个库、每个函数干什么
11 脚本引擎:从代码到运行 ← 想知道"为什么我的脚本被拦了"再看这章
先看 12、13 就能干活,第 11 章是原理(编译过程、安全拦截规则),不写复杂脚本可以不看。
目标 5 —— "我要把组态能力嵌进自己的程序(读工程、批量改配置)"
15 自动化 API 总览 ← 最省事的入口,先看这个
16 自动化 API 方法速查 ← 需要哪个方法直接查
06 工程文件与加载保存 ← 想知道底层文件长什么样再看
典型场景:批量导入几百个点、自动生成画面、把工程信息同步到 MES 系统。
目标 6 —— "我要让外部 AI(Claude / Cursor)连进来改工程"
18 MCP 服务器 ← 启动参数、工具清单、两种传输方式
15 自动化 API 总览 ← 理解 AI 实际调的是什么
目标 7 —— "我要做登录、角色、操作权限"
19 账号、角色与权限 ← 权限模型、API、密码存储
Hmi.Security 不依赖任何其它 Hmi.*,可以直接摘出来单独用。
目标 8 —— "我要把工程交给现场跑,并且要历史曲线和报警"
10 运行数据引擎 ← 采集循环 + 实时库
14 历史库与报警引擎 ← 什么时候记、怎么查、报警怎么流转
17 宿主、进程与壳 ← 进程怎么起、怎么监督
目标 9 —— "出问题了,我要排查"
21 常见问题与坑 ← 先翻这里
04 实时库:内存里的点值表 ← "值不对" 类问题
07 驱动是怎么工作的 ← "连不上 / 采不到" 类问题
再按问题查:我想知道……
| 我想知道 | 去哪一章 |
|---|---|
| 点值存在哪、怎么读怎么写 | 04 实时库 |
| 点、通道、设备是什么关系 | 05 点、通道、设备 |
| 工程目录里都有哪些文件 | 06 工程文件与加载保存 |
| 为什么采数据要"块读" | 07 驱动是怎么工作的 |
| Modbus 地址怎么写 | 08 内置协议怎么用 |
| 怎么加一种自己的协议 | 09 写一个自己的协议插件 |
| 怎么把工程跑起来 | 10 运行数据引擎 |
| 我的脚本为什么被拦了 | 11 脚本引擎 |
| 有哪几种脚本、什么时候触发 | 12 脚本运行时与脚本形态 |
Tag.Write 怎么用 |
13 脚本函数库速查 |
| 历史数据怎么记、怎么查 | 14 历史库与报警引擎 |
| 报警怎么确认、状态怎么流转 | 14 历史库与报警引擎 |
| 怎么批量改工程 | 15 自动化 API 总览 |
| 某个 Automation 方法叫什么 | 16 自动化 API 方法速查 |
| 前端和后端怎么通信的 | 17 宿主、进程与壳 |
| 运行内核进程怎么起 | 17 宿主、进程与壳 |
| MCP 服务怎么开 | 18 MCP 服务器 |
| 权限点有哪些 | 19 账号、角色与权限 |
| 15 个程序集分别是什么 | 20 程序集速查表 |
| 报错了怎么办 | 21 常见问题与坑 |
阅读时的三个提醒
- 每章开头都有"什么时候你会需要它" —— 看完那段觉得跟你无关,直接跳过,不用有心理负担。
- 代码示例都能直接跑 —— 按示例里的注释顺序写(尤其初始化顺序),不要凭直觉调换。
- 手册和代码不一致时,以代码为准,并回头把手册改掉。手册里的文件路径都是真实路径,可以直接打开对照。
准备好了?从第 01 章开始。