离线扫描适合交付清单
离线模式通过 TIA Openness 读取项目中 PLC 下的 DB、符号名、注释、数据类型、地址和访问属性。它适合正式整理 DB 点位清单，也适合判断哪些 DB 可以安全导出。缺点是必须在安装了对应 TIA Portal 的机器或虚拟机里运行。
文档手册
在线扫描和离线扫描选择方式
离线模式通过 TIA Openness 读取项目中 PLC 下的 DB、符号名、注释、数据类型、地址和访问属性。它适合正式整理 DB 点位清单，也适合判断哪些 DB 可以安全导出。缺点是必须在安装了对应 TIA Portal 的机器或虚拟机里运行。
Beta: 在线扫描和离线扫描选择方式
离线扫描读取 TIA Portal 项目元数据，信息最完整但需要本机安装博图；在线扫描输入 PLC IP 或 OPC UA endpoint，不需要本机安装博图，但只能导出 PLC 在线协议真实开放出来的 DB 节点。在线扫描优先走 OPC UA
在线模式输入 192.168.0.1 或 opc.tcp://192.168.0.1:4840。真正可导出的点位必须来自 PLC OPC UA Server 暴露的 DB 节点；PLC 未启用 OPC UA、DB 未允许 OPC UA/HMI/外部访问、证书或账号不通过时，在线源不会提供符号、注释和类型。
扫描范围以 DB 点位为主
在线和离线模式都围绕 DB 点位整理结果，输出字段以符号地址、数据类型和可复核的地址信息为核心。输入、输出和存储区变量如需纳入交付，应先在工程侧形成明确映射或按独立清单处理。
S7 102 可达不等于能导出符号点位
S7 TCP 102 只能说明 PLC 链路可达。没有 TIA 项目或 OPC UA 节点时，优化 DB 的符号名、注释、类型和偏移无法可靠枚举。HQ Scan 以工程元数据或 PLC 明确开放的节点作为点位来源，避免生成缺少依据的运行地址。
在线模式的推荐准备
在 PLC 侧启用 OPC UA Server，选择需要开放的 DB 或变量，确认安全策略、证书、账号和网络防火墙，再用 HQ Scan 在线入口确认 4840 可达。只有确认节点可浏览后，在线导出才有意义。
在线扫描是低影响只读浏览
在线扫描只浏览 OPC UA 节点并读取节点属性，用来得到符号地址、数据类型和访问属性；不写 PLC、不下发控制、不订阅实时值，也不持续采集。正式产线仍建议先在维护窗口或指定 PLC 上确认，因为任何网络访问都会经过现场网络、防火墙和 PLC OPC UA Server。
在线和离线数量不要求完全一致
离线扫描读取 TIA 项目元数据，能看到项目里存在但未开放到 OPC UA 的内容；在线扫描只看到 PLC 当前 OPC UA Server 暴露出来的节点。PLC 侧开放范围、DB 访问权限、项目树范围、规则过滤和类型支持范围都会影响数量，所以两种模式的总数可以不同。数量差异不是错误，关键是确认目标范围内可识别、可导出的 DB 标量点没有漏。
OPC UA endpoint 填写方式
在线入口可以填写 PLC IP，也可以填写完整 OPC UA endpoint。只写 192.168.0.1 时，HQ Scan 会按默认端口拼成 opc.tcp://192.168.0.1:4840；如果现场 OPC UA 使用非默认端口，应写完整地址，例如 opc.tcp://192.168.0.1:4841。S7 102 可达性只用于辅助判断网络连通，不作为符号点位来源。
在线浏览参数理解方式
在线配置中的 timeoutMs 控制单次连接和读取等待时间；maxBrowseNodes、maxBrowseDepth 控制最多浏览节点数和层级深度；browseBatchSize、attributeBatchSize 控制批量浏览和批量读取属性的单批数量；browseDelayMs 用于在现场网络较慢时降低连续浏览压力。一般项目保持默认值即可，只有 PLC Server 限制较严格或网络响应较慢时再调整。
在线模式不会补推离线字段
在线模式不会根据 S7 102 端口推断优化 DB 结构，也不会自动补齐 TIA 项目里的注释、文件夹层级、DB 号、字节偏移或位偏移。PLC OPC UA Server 没有公开的字段，HQ Scan 不会在结果里虚拟生成；这类字段应通过离线项目扫描或工程侧开放设置补齐。