Serial Studio 0066 规格全解用 19 个可独立验证的任务落地 OPC UA 客户端驱动【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本文以 Serial Studio 仓库中 spec 0066OPC UA Client Driver的 tasks.md 为骨架完整拆解这个驱动从线协议词汇表、原生解码模板、GUI 驱动核心、API 命令到 Python 仿真器与 CI 的 19 个有序任务T1–T19每个任务改哪些文件、做什么、如何验证、依赖谁。读完你可以掌握该项目 spec 驱动开发流程中任务分解 逐项验证的实操范式并对照当前仓库源码理解 OPC UA 驱动的线格式、锁存解码、订阅/轮询回退与项目生成的真实实现。一、tasks.md 在 spec 流程中的位置Phase 3 的有序清单spec 0066 由三份文档构成四阶段流程中的前三阶段spec.md 定义做什么plan.md 定义怎么做tasks.md 定义按什么顺序做spec.mdPhase 1需求 R1–R18 与验收标准 AC1–AC11定义 Pro 用户连接security policy None的 OPC UA 服务器、浏览地址空间、勾选标签、生成完整工程、订阅/轮询取值、源时间戳、Python 仿真器与集成测试。plan.mdPhase 2技术设计——一个商业IO::Drivers::OpcUaHAL 驱动封装QOpcUaClient每个发布间隔把脏标签序列化成紧凑二进制 delta 帧[u16 tag][u8 type][payload]经普通publishReceivedData()路径发出由新的opcua原生锁存模板解码。tasks.mdPhase 3本文主体把 plan 拆成小、有序、可独立验证的单位——每一个任务都是一位评审者可以孤立阅读的一致 diff/ss-implement自上而下执行这张清单并保持状态框最新。门禁Gate规则同样在文档头部写死在人类把 tasks.md 标记为approved之前不得开始/ss-implement。本规格最终于 2026-08-25 关闭spec.md 头部status: done。二、任务约定Conventions每个任务如何被约束tasks.md 开头给出五条全局约定它们决定了整张清单的写法一个任务 一个聚焦、可评审的变更。若一个任务触碰超过 3 个文件或需要用一整段话才能描述就必须拆分Verify 是本单位的确认方式——通常是python scripts/code-verify.py --check filescode-verify.py 是该仓库的静态规则检查器外加一个测试或一次回读read-backDeps 列出必须先落地的任务 ID排序保证尽量每完成一个任务树都能概念上编译API 命令 ID 沿用现有io.modbus.*的形状即io.opcua.*构建、启动、--dump-api-schema、截图、.ts重译等维护者专属步骤标注 [maintainer]任务保持打开状态直到维护者回报。这套约定的实际效果在清单末尾的 Definition of Done 中得到印证19 个任务全部[x] done且明确记录diff 就是所要求的内容且仅此而已——超车道out-of-lane的编辑T5 的 vault scope、command_safety.json、重新生成的CommandStrings.cpp、tst_enum_labels.cpp的一行全部在聊天中点名。三、T1–T5地基——线词汇表、原生模板、单元测试、枚举、凭据库T1线词汇表头OpcUaWire.htasks.md 要求的头文件是驱动编码器与模板解码器共享的 header-only 词汇表包含kWireVersion、kMaxTags 2048、kSoftTagLimit 512、kMaxStringBytes 256、类型标签枚举Bool, I8, U8, I16, U16, I32, U32, I64, U64, F32, F64, Str、每类型 payload 宽度、appendEntry(QByteArray, index, type, QVariant)与readEntry(view, pos, out)要求边界检查、SS_ASSERT密度 ≥2、readEntry零分配、商业 SPDX 头。当前仓库中该文件已迁移到 core/Protocols/OpcUa/OpcUaWire.h实现与任务描述完全一致并可进一步读出细节inline constexpr std::uint8_t kWireVersion 1; inline constexpr int kMaxTags 2048; inline constexpr int kSoftTagLimit 512; inline constexpr int kMaxStringBytes 256; inline constexpr int kMaxFrameBytes 65536; inline constexpr int kHeaderBytes 1; inline constexpr int kEntryHeaderBytes 3;帧布局在头文件注释中写得很清楚[version u8]开头之后是若干 entry[index u16 LE][type u8][payload]字符串前置一个 u16 LE 字节长度帧里只包含自上一 tick 以来变化的标签解码器对其余标签做锁存latch。类型枚举Type的数值即线上字节Bool0 … Str11Invalid255。appendEntry对字符串按 UTF-8 截断到kMaxStringBytes且回退避免切断多字节字符的续字节readEntry在截断的 entry 或未知类型时返回 false 且不推进pos从而终止遍历——这正是 T2 模板版本字节不匹配与截断 entry 停止遍历的实现基础。任务验证命令python scripts/code-verify.py --check app/src/IO/Drivers/OpcUaWire.h路径为当时布局现见core/Protocols/。Deps无。T2opcua原生锁存模板任务要求在BinaryTemplates.cpp、NativeTemplateRegistry.cpp中新增OpcUaParser : NativeLatchParser按schemaJSON 参数[{i:0,t:f64}, ...]解码 T1 的 delta 帧并在modbus旁注册OpcUaTemplate描述符idopcua参数schemaJson不变式每帧解码器、对kMaxBytesPerFrame的固定循环上界、遍历上的SS_ASSERT_HOTPATH、除storeAt外无分配。当前实现位于 core/Pipeline/DataModel/Scripting/NativeTemplates/WireLatchTemplates.cppOpcUaTemplate的makeParser展示了任务要求的校验逻辑schema 必须列 1 到kMaxTags个标签每个{i: index, t: type}条目的 index 合法、类型已知且不重复否则返回nullptr并给出错误文本如 The tag schema has an invalid, duplicate or missing index.最终构造TypedWireParser。模板说明文本也明确由 OPC UA 工程生成器机器管理。DepsT1。T3wire 模板的 ctest 单元测试任务要求在 app/tests/tst_opcua_wire.cpp及CMakeLists.txt的ss_add_unit_test置于商业构建守卫内覆盖每类型往返、字符串 256 字节截断、标签上界、版本拒绝以及经OpcUaParser的锁存语义脏子集、未知索引、截断 entry。当前测试类的用例名与任务一一对应typeCodesRoundTrip / scalarsRoundTrip(_data) / stringsTruncateAtCap / truncatedEntryStopsWalk / badVersionRejected / templateLatchesDeltas / templateIgnoresUnknownIndexAndTypeMismatch / templateRejectsBadSchema验证分两段code-verify.py --check可由作者完成构建后ctest -R tst_opcua_wire标 [maintainer]。任务状态如实记录为 code written; awaiting maintainer build ctest。DepsT2。该测试后来还扩展出模糊测试 app/tests/fuzz/fuzz_opcua_wire.cpp。T4BusType::OpcUa枚举 标签 图标任务要求把OpcUa追加在Mqtt之后商业块内索引 10永不重排——枚举顺序同时索引Hardware.qml的 StackLayout 与集成测试api_client.py的bus_mapslugopcua/ 标签OPC UAbusTypeIcon()分支三档图标16/24/32注册进rcc.qrc。验证除code-verify.py --check外还有一条回读规则grep -rn BusType::Mqtt app/src列出的每个 switch现在都要有OpcUa兄弟分支或被后续任务T6、T8、T9、T13覆盖。Deps无。当前仓库中枚举与标签分别落在 core/Core/SerialStudio.h 与 core/Core/EnumLabels.cpp由 app/tests/tst_enum_labels.cpp 覆盖 slug/label。T5CredentialVaultscope任务要求在CredentialVault构造函数增加可选scope字符串前缀进settingsKey()默认空保持 MQTT 键逐字节不变避免 OPC UA 凭据与 MQTT 键命名空间冲突文档明确这是计划中点名的超车道编辑MQTT/目录下其他内容不动。验证code-verify.py --check 回读默认 scope 产生旧键串。这体现了任务清单的一个纪律任何超出本任务主线的改动都必须在任务文本中显式命名而不是悄悄做掉。四、T6–T8驱动核心——拨号裁决、订阅/轮询回退、缓存与项目生成T6驱动核心属性、发现、拨号任务要求IO::Drivers::OpcUa : HAL_Driver提供属性集endpointUrl、endpointIndex、endpointList、endpointSelectable、authMode、username、经 vault scopeopcua的 password、publishingInterval、tagCount、statusText、pollModerequestEndpoints→ 列表open()创建客户端open62541、应用认证、connectToEndpoint以m_connecting返回 true。核心不变式是**每次尝试恰好一次裁决**成功与失败都经唯一failDial()漏斗 reportOpenFinished上报外加 15 秒最后手段定时器每个失败同时到达ConnectionManager::disconnectDevice(this)任何地方都不许模态框logDriverError建立后掉线 → 排队disconnectDevice。验证包含一条 grep 不变式每个reportOpenFinished(false调用点也调用failDial/disconnectDevice。DepsT1、T4、T5。当前 core/Devices/IO/Drivers/OpcUa.h 可以逐条对照Q_PROPERTY 列表中endpointUrl/endpointIndex/endpointList/endpointSelectable/authMode/publishingInterval/tagCount/statusText/pollMode全部存在私有槽onSessionConnected、onConnectFailed、onDialTimeout与私有方法failDial(const QString reason)即任务点名的裁决漏斗write()恒返回 -1纯读驱动isWritable()为 false。T7订阅、轮询回退、值缓存、发布 tick任务要求连接后每标签一个QOpcUaNodeenableMonitoring(Value, params)全部被拒或BadServiceUnsupported/BadTooManySubscriptions→m_pollModem_pollTimer→readNodeAttributes。值缓存TagSlotvalue、status、sourceTs、dirty坏状态保留最后好值并计数缺失/偏移 5 s 的源时间戳回退到接收时间并计数m_frameTimer按发布间隔把脏槽经 T1 编码进一次性 reserve 的缓冲调用publishReceivedData(std::move(frame), earliestSourceTs)空则不发帧。不变式源拥有时间steady-clock 偏移每次连接只算一次永不重盖章每值无信号/分配诊断是 1 Hz 拉取的普通计数器。验证函数长度 ≤100 行回读确认没有每通知的Q_EMIT。DepsT6。T8标签模型 工程生成任务要求OpcUaTagModel : QAbstractItemModel惰性fetchMore→browseChildrenreadAttributes取 DataType/AccessLevel/DisplayName/Description EngineeringUnitsfolder 三态勾选不支持的类型不可选软/硬标签上限以及generateProject()/buildProject()按父文件夹分组、每标签一个 dataset数组展开、带单位、plt/led/字符串路由、frameParserTemplate opcua、frameParserParams {schema}连接设置来自driverProperties()。验证回读生成的 JSON 能经ProjectModel::loadFromJsonDocument的Keys::名称而非字面量往返。DepsT2、T7。当前代码里这两块分别落在 core/Devices/IO/Drivers/OpcUaTagModel.cpp 与 core/Devices/IO/Drivers/OpcUa/OpcUaProjectBuilder.cpp工程生成另有单测 app/tests/tst_opcua_project_builder.cpp 守护。五、T9–T13接线、API、QML 与 CLIT9ConnectionManager ModuleManager CMake 接线任务要求m_opcUaUiopcUa()访问器、三处BusTypeswitchactiveUiDriver、uiDriverForBusType、createDriver、wireUiDriver、总线名列表、teardown 重置Cpp_IO_OpcUa上下文属性 保留名OpcUa进商业QT_MODULES/QT_LIBS与源码列表。验证是grep -n OpcUa .../ConnectionManager.cpp显示全部三个 switch。DepsT6。当前接线在 core/Devices/IO/ConnectionManager.cpp 与 core/Misc/ModuleManager.cpp。值得注意的是当前 app/CMakeLists.txt 第 90 行注释写明OPC UA does NOT use Qt6::OpcUa (spec 0067). The driver talks to the open62541 static library——即规格完成后后续 spec 0067 把底层换成了直接链 open62541 静态库这是 tasks 文档本身不包含的后续演化。T10API handler任务要求按 plan §API 实现io.opcua.*命令configuration、discoverEndpoints5 秒有界、getEndpoints、browse、tags CRUD、带注册级策略预检的generateProject、getStatus注册在BUILD_COMMERCIAL下构建后由维护者跑SerialStudio --dump-api-schema生成物只经生成器更新。当前 core/Api/API/Handlers/OpcUaHandler.cpp 已落地app/rcc/api/sdk-symbols.json 中可见io.opcua命令面addTag、browse、clearTags、discoverEndpoints、exportCertificate、generateProject、getCertificate、getConfig、getStatus等含后续 spec 加入的证书命令。任务还记录了一个超车道编辑命令在 app/rcc/ai/command_safety.json 中标记。DepsT8、T9。T11 / T12设置面板与标签浏览器 QMLT11要求OpcUa.qmlendpoint URL Discover、带禁用安全行与 tooltip 的 endpoint combo、认证模式、用户名/密码、警告横幅、间隔、标签数、Browse/Generate 按钮、状态行Hardware.qml索引 10 的Loader以及同Modbus.qml的 ComboBox 恢复竞争保护T12要求OpcUaTagBrowser.qmlOpcUaTagModel上的TreeView、复选框 delegate、folder 三态、type/access 列、搜索过滤、软限横幅、Select All Readable、OK/Cancel外观镜像ModbusGroupsDialog.qml打开对话框对仿真器的验证标 [maintainer]。两个 QML 当前分别位于 app/qml/MainWindow/Panes/SetupPanes/Drivers/OpcUa.qml 与 app/qml/MainWindow/Panes/SetupPanes/Drivers/OpcUaTagBrowser.qml。DepsT9T12 另依赖 T8、T11。T13命令注册表、编辑表单、流程图、CLI任务要求driver.opcua开关命令 绑定scripts/registry-verify.py校验、总线 combobox 条目、流程图名称数组加opcua、CLI--opcua url、--opcua-user、--opcua-pass、--opcua-interval、--opcua-tag可重复经setupOpcUaConnection()。当前 CLI 实现见 app/src/Misc/CLI/CliIndustrialConfig.cpp读取opts.opcuaOpt后取cm.opcUa()、setEndpointUrl(url)设置--opcua-user时setAuthMode(1)。验证python scripts/registry-verify.pyscripts/generate-command-strings.py --checkcode-verify.py --check。DepsT4、T9。六、T14–T16仿真器、集成测试与帮助页T14Python 仿真器asyncua 服务器任务要求在examples/OPC UA PLC Simulator/下提供监听opc.tcp://127.0.0.1:4840/serialstudio/的asyncua服务器Plant/Line1/… 文件夹、布尔/整数/浮点/双精度/字符串、一个浮点数组、一个周期性 Bad 状态标签、时变物理量--port、--user/--pass、--secure-only只通告 Basic256Sha256 端点、--no-subscriptions标志由驱动生成器产出的工程文件examples.json中requiresPro: true、分类 Industrial Automationasyncua1.1进 requirements。验证脚本启动 nc -z 127.0.0.1 4840截图标 [maintainer]。任务状态记录已用 asyncua 客户端活体验证。当前 examples/OPC UA PLC Simulator/opcua_plc_simulator.py 及其 README 已按此落地并进一步扩展README 记录了--rate、--drop-after、--security、--cert-expired、--cert-wrong-host等后续安全相关标志工程文件为 examples/OPC UA PLC Simulator/OPC UA PLC Simulator.ssproj。T15集成测试 fixtures任务要求在 tests/integration/test_opcua_driver.py 实现 plan §Test 的测试清单discover、匿名/用户名/坏凭据/关闭端口的连接、browse、不支持类型、generate、订阅速率、轮询回退、CSV 时间戳、坏状态、重连、工程往返、API 面opcua_simulatorfixture4840 不通则 skip重启 helper 服务重连测试markersopcua、requires_opcua_simbus_map[opcua] 10。验证pytest ... --collect-only可先行全量运行标 [maintainer]。任务记录 collects 16 tests; full run pending maintainer app。DepsT10、T14。T16帮助手册页任务要求以 Modbus 页的口吻写 doc/help/Drivers-OPC-UA.md概述、厂商兼容列表、凭据警告、端点发现、标签浏览器、工程生成、订阅 vs 轮询、时间戳、CLI、仿真器演练、API 命令注册在drivers-modbus之后并在 doc/help/Auto-Generating-Projects.md 加交叉链接段。验证python scripts/documentation-verify.py doc/help/Drivers-OPC-UA.md。当前帮助页正文确认与任务描述一致概述厂商兼容性Rockwell via FactoryTalk Linx Gateway、KEPServerEX/Ignition、Siemens S7-1200/1500 与 WinCC、Beckhoff TwinCAT、CODESYS、BR、WAGO、Schneider并且随着后续安全通道规格其None-only 限制段落已更新为支持六种安全策略。七、T17–T19CI、AI 文档与静态门禁T17CI workflow任务要求在.github/workflows/ci.yml的集成矩阵加opcua_sim: true/falseLinux/macOS 腿在 Mosquitto 旁启动 T14 脚本后台 4840 端口等待Windows 腿marker_expr加and not requires_opcua_sim不改 Qt 安装。验证python -c import yaml; yaml.safe_load(...) diff 限于集成 job。当前 .github/workflows/ci.yml 中可见矩阵项opcua_sim: true/false与 Windows 腿的marker_expr: not destructive and not dos and not audio and not requires_broker and not requires_opcua_sim与任务描述逐字吻合。T18AI-facing 文档任务要求更新 doc/claude/architecture/io.md拨号教条异步、一次裁决、delta 帧 tick、轮询回退、vault scope、doc/claude/directory-map.md 新文件行、CLAUDE.md数据源列表与11 drivers计数。验证是ss-ai-audit抽查。T19静态门禁 评审最后一步对所有变更跑code-verify.py --check、registry-verify.py、对驱动/模板/handler diff 跑qt-cpp-review、sanitize-commit.py不提交。任务文档还有一段值得注意的反事实检查最可能失守的规则是一次裁决拨号锁存证据就是failDial漏斗 grep test_closed_port_settles测试——即先声明风险规则再指出守护它的证据。任务状态记录了真实收尾sanitize-commit停在 singleton-census 门7 处全部是兄弟驱动静态实例形状由维护者决定--accept。八、Definition of Done清单如何收口tasks.md 的完成定义全部勾选展示了这类清单的验收口径值得作为工程参照spec.md 的每一条验收标准满足并勾选AC3/AC4/AC6/AC7/AC10 为维护者观察项python scripts/code-verify.py --check对所有变更文件干净qt-cpp-review跑过 C diff14 个确认发现已修6 个调查项记入聊天热路径未触碰维护者在 Pro 构建上跑过一次--benchmark-hotpathAC7pytest tests/integration/test_opcua_driver.py与ctest -R tst_opcua_wire在仿真器在线时绿sanitize-commit.py已跑工作树无 lint 债diff 是所要求的且只有那——超车道编辑全部点名spec.md状态置为done。九、从清单到当前仓库任务完成后的代码演化tasks.md 是任务时刻的快照而当前仓库已经历后续重构从源码结构看可以确认这些演化作为理解 T1–T19 落点的补充证据驱动类注释明确Certificate store, browse session, subscriptions and project builder are sub-objects (spec 0070)见 core/Devices/IO/Drivers/OpcUa.hT6–T8 的单体职责已被拆为OpcUaSession、OpcUaBrowser、OpcUaSubscriptions、OpcUaProjectBuilder、OpcUaFrameAssembler、OpcUaCertificateStore、OpcUaEndpointSelection等子对象core/Devices/IO/Drivers/OpcUa/ 目录但failDial裁决漏斗、m_dialTimer、PendingDial等 T6 命名的一词未变线词汇表从当时的app/src/IO/Drivers/提升到 core/Protocols/OpcUa/OpcUaWire.h常量与帧格式与 T1 描述完全一致测试面从 T3 的tst_opcua_wire扩展到tst_opcua_frame_assembler、tst_opcua_subscriptions、tst_opcua_endpoint_selection、tst_opcua_marshal、tst_opcua_project_builder、tst_opcua_security与 fuzz 目标app/tests/ 目录安全策略T 系列中的 None-only 限制来自 plan 的 2026-08-22 维护者决定在后续规格中补齐OpcUa.h现暴露securityPolicy/securityMode/证书属性帮助页与仿真器的--security/--cert-*标志也印证了这条时间线。十、要点回顾tasks.md 的价值不在文件清单本身而在约定一个任务一个可评审 diff、每个任务自带 Verify 与 Deps、维护者步骤显式标记、超车道编辑显式点名、Definition of Done 逐条勾销OPC UA 驱动的技术主线在 T1/T2/T6/T7 就已定死header-only 线词汇表版本字节 u16 索引 u8 类型 LE payload2048 标签上限、256 字节字符串上限、锁存解码→ 原生模板解码 → 一次裁决拨号 脏槽 delta 帧 tick 订阅/轮询自动回退每个任务的验证命令code-verify.py --check、ctest -R tst_opcua_wire、pytest ... --collect-only、registry-verify.py、documentation-verify.py、yaml 语法检查都是可直接在仓库中复现的读者可据此对任意一个任务做独立的证据核验。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Serial Studio 0066 规格全解用 19 个可独立验证的任务落地 OPC UA 客户端驱动【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio本文以 Serial Studio 仓库中 spec 0066OPC UA Client Driver的 tasks.md 为骨架完整拆解这个驱动从线协议词汇表、原生解码模板、GUI 驱动核心、API 命令到 Python 仿真器与 CI 的 19 个有序任务T1–T19每个任务改哪些文件、做什么、如何验证、依赖谁。读完你可以掌握该项目 spec 驱动开发流程中任务分解 逐项验证的实操范式并对照当前仓库源码理解 OPC UA 驱动的线格式、锁存解码、订阅/轮询回退与项目生成的真实实现。一、tasks.md 在 spec 流程中的位置Phase 3 的有序清单spec 0066 由三份文档构成四阶段流程中的前三阶段spec.md 定义做什么plan.md 定义怎么做tasks.md 定义按什么顺序做spec.mdPhase 1需求 R1–R18 与验收标准 AC1–AC11定义 Pro 用户连接security policy None的 OPC UA 服务器、浏览地址空间、勾选标签、生成完整工程、订阅/轮询取值、源时间戳、Python 仿真器与集成测试。plan.mdPhase 2技术设计——一个商业IO::Drivers::OpcUaHAL 驱动封装QOpcUaClient每个发布间隔把脏标签序列化成紧凑二进制 delta 帧[u16 tag][u8 type][payload]经普通publishReceivedData()路径发出由新的opcua原生锁存模板解码。tasks.mdPhase 3本文主体把 plan 拆成小、有序、可独立验证的单位——每一个任务都是一位评审者可以孤立阅读的一致 diff/ss-implement自上而下执行这张清单并保持状态框最新。门禁Gate规则同样在文档头部写死在人类把 tasks.md 标记为approved之前不得开始/ss-implement。本规格最终于 2026-08-25 关闭spec.md 头部status: done。二、任务约定Conventions每个任务如何被约束tasks.md 开头给出五条全局约定它们决定了整张清单的写法一个任务 一个聚焦、可评审的变更。若一个任务触碰超过 3 个文件或需要用一整段话才能描述就必须拆分Verify 是本单位的确认方式——通常是python scripts/code-verify.py --check filescode-verify.py 是该仓库的静态规则检查器外加一个测试或一次回读read-backDeps 列出必须先落地的任务 ID排序保证尽量每完成一个任务树都能概念上编译API 命令 ID 沿用现有io.modbus.*的形状即io.opcua.*构建、启动、--dump-api-schema、截图、.ts重译等维护者专属步骤标注 [maintainer]任务保持打开状态直到维护者回报。这套约定的实际效果在清单末尾的 Definition of Done 中得到印证19 个任务全部[x] done且明确记录diff 就是所要求的内容且仅此而已——超车道out-of-lane的编辑T5 的 vault scope、command_safety.json、重新生成的CommandStrings.cpp、tst_enum_labels.cpp的一行全部在聊天中点名。三、T1–T5地基——线词汇表、原生模板、单元测试、枚举、凭据库T1线词汇表头OpcUaWire.htasks.md 要求的头文件是驱动编码器与模板解码器共享的 header-only 词汇表包含kWireVersion、kMaxTags 2048、kSoftTagLimit 512、kMaxStringBytes 256、类型标签枚举Bool, I8, U8, I16, U16, I32, U32, I64, U64, F32, F64, Str、每类型 payload 宽度、appendEntry(QByteArray, index, type, QVariant)与readEntry(view, pos, out)要求边界检查、SS_ASSERT密度 ≥2、readEntry零分配、商业 SPDX 头。当前仓库中该文件已迁移到 core/Protocols/OpcUa/OpcUaWire.h实现与任务描述完全一致并可进一步读出细节inline constexpr std::uint8_t kWireVersion 1; inline constexpr int kMaxTags 2048; inline constexpr int kSoftTagLimit 512; inline constexpr int kMaxStringBytes 256; inline constexpr int kMaxFrameBytes 65536; inline constexpr int kHeaderBytes 1; inline constexpr int kEntryHeaderBytes 3;帧布局在头文件注释中写得很清楚[version u8]开头之后是若干 entry[index u16 LE][type u8][payload]字符串前置一个 u16 LE 字节长度帧里只包含自上一 tick 以来变化的标签解码器对其余标签做锁存latch。类型枚举Type的数值即线上字节Bool0 … Str11Invalid255。appendEntry对字符串按 UTF-8 截断到kMaxStringBytes且回退避免切断多字节字符的续字节readEntry在截断的 entry 或未知类型时返回 false 且不推进pos从而终止遍历——这正是 T2 模板版本字节不匹配与截断 entry 停止遍历的实现基础。任务验证命令python scripts/code-verify.py --check app/src/IO/Drivers/OpcUaWire.h路径为当时布局现见core/Protocols/。Deps无。T2opcua原生锁存模板任务要求在BinaryTemplates.cpp、NativeTemplateRegistry.cpp中新增OpcUaParser : NativeLatchParser按schemaJSON 参数[{i:0,t:f64}, ...]解码 T1 的 delta 帧并在modbus旁注册OpcUaTemplate描述符idopcua参数schemaJson不变式每帧解码器、对kMaxBytesPerFrame的固定循环上界、遍历上的SS_ASSERT_HOTPATH、除storeAt外无分配。当前实现位于 core/Pipeline/DataModel/Scripting/NativeTemplates/WireLatchTemplates.cppOpcUaTemplate的makeParser展示了任务要求的校验逻辑schema 必须列 1 到kMaxTags个标签每个{i: index, t: type}条目的 index 合法、类型已知且不重复否则返回nullptr并给出错误文本如 The tag schema has an invalid, duplicate or missing index.最终构造TypedWireParser。模板说明文本也明确由 OPC UA 工程生成器机器管理。DepsT1。T3wire 模板的 ctest 单元测试任务要求在 app/tests/tst_opcua_wire.cpp及CMakeLists.txt的ss_add_unit_test置于商业构建守卫内覆盖每类型往返、字符串 256 字节截断、标签上界、版本拒绝以及经OpcUaParser的锁存语义脏子集、未知索引、截断 entry。当前测试类的用例名与任务一一对应typeCodesRoundTrip / scalarsRoundTrip(_data) / stringsTruncateAtCap / truncatedEntryStopsWalk / badVersionRejected / templateLatchesDeltas / templateIgnoresUnknownIndexAndTypeMismatch / templateRejectsBadSchema验证分两段code-verify.py --check可由作者完成构建后ctest -R tst_opcua_wire标 [maintainer]。任务状态如实记录为 code written; awaiting maintainer build ctest。DepsT2。该测试后来还扩展出模糊测试 app/tests/fuzz/fuzz_opcua_wire.cpp。T4BusType::OpcUa枚举 标签 图标任务要求把OpcUa追加在Mqtt之后商业块内索引 10永不重排——枚举顺序同时索引Hardware.qml的 StackLayout 与集成测试api_client.py的bus_mapslugopcua/ 标签OPC UAbusTypeIcon()分支三档图标16/24/32注册进rcc.qrc。验证除code-verify.py --check外还有一条回读规则grep -rn BusType::Mqtt app/src列出的每个 switch现在都要有OpcUa兄弟分支或被后续任务T6、T8、T9、T13覆盖。Deps无。当前仓库中枚举与标签分别落在 core/Core/SerialStudio.h 与 core/Core/EnumLabels.cpp由 app/tests/tst_enum_labels.cpp 覆盖 slug/label。T5CredentialVaultscope任务要求在CredentialVault构造函数增加可选scope字符串前缀进settingsKey()默认空保持 MQTT 键逐字节不变避免 OPC UA 凭据与 MQTT 键命名空间冲突文档明确这是计划中点名的超车道编辑MQTT/目录下其他内容不动。验证code-verify.py --check 回读默认 scope 产生旧键串。这体现了任务清单的一个纪律任何超出本任务主线的改动都必须在任务文本中显式命名而不是悄悄做掉。四、T6–T8驱动核心——拨号裁决、订阅/轮询回退、缓存与项目生成T6驱动核心属性、发现、拨号任务要求IO::Drivers::OpcUa : HAL_Driver提供属性集endpointUrl、endpointIndex、endpointList、endpointSelectable、authMode、username、经 vault scopeopcua的 password、publishingInterval、tagCount、statusText、pollModerequestEndpoints→ 列表open()创建客户端open62541、应用认证、connectToEndpoint以m_connecting返回 true。核心不变式是**每次尝试恰好一次裁决**成功与失败都经唯一failDial()漏斗 reportOpenFinished上报外加 15 秒最后手段定时器每个失败同时到达ConnectionManager::disconnectDevice(this)任何地方都不许模态框logDriverError建立后掉线 → 排队disconnectDevice。验证包含一条 grep 不变式每个reportOpenFinished(false调用点也调用failDial/disconnectDevice。DepsT1、T4、T5。当前 core/Devices/IO/Drivers/OpcUa.h 可以逐条对照Q_PROPERTY 列表中endpointUrl/endpointIndex/endpointList/endpointSelectable/authMode/publishingInterval/tagCount/statusText/pollMode全部存在私有槽onSessionConnected、onConnectFailed、onDialTimeout与私有方法failDial(const QString reason)即任务点名的裁决漏斗write()恒返回 -1纯读驱动isWritable()为 false。T7订阅、轮询回退、值缓存、发布 tick任务要求连接后每标签一个QOpcUaNodeenableMonitoring(Value, params)全部被拒或BadServiceUnsupported/BadTooManySubscriptions→m_pollModem_pollTimer→readNodeAttributes。值缓存TagSlotvalue、status、sourceTs、dirty坏状态保留最后好值并计数缺失/偏移 5 s 的源时间戳回退到接收时间并计数m_frameTimer按发布间隔把脏槽经 T1 编码进一次性 reserve 的缓冲调用publishReceivedData(std::move(frame), earliestSourceTs)空则不发帧。不变式源拥有时间steady-clock 偏移每次连接只算一次永不重盖章每值无信号/分配诊断是 1 Hz 拉取的普通计数器。验证函数长度 ≤100 行回读确认没有每通知的Q_EMIT。DepsT6。T8标签模型 工程生成任务要求OpcUaTagModel : QAbstractItemModel惰性fetchMore→browseChildrenreadAttributes取 DataType/AccessLevel/DisplayName/Description EngineeringUnitsfolder 三态勾选不支持的类型不可选软/硬标签上限以及generateProject()/buildProject()按父文件夹分组、每标签一个 dataset数组展开、带单位、plt/led/字符串路由、frameParserTemplate opcua、frameParserParams {schema}连接设置来自driverProperties()。验证回读生成的 JSON 能经ProjectModel::loadFromJsonDocument的Keys::名称而非字面量往返。DepsT2、T7。当前代码里这两块分别落在 core/Devices/IO/Drivers/OpcUaTagModel.cpp 与 core/Devices/IO/Drivers/OpcUa/OpcUaProjectBuilder.cpp工程生成另有单测 app/tests/tst_opcua_project_builder.cpp 守护。五、T9–T13接线、API、QML 与 CLIT9ConnectionManager ModuleManager CMake 接线任务要求m_opcUaUiopcUa()访问器、三处BusTypeswitchactiveUiDriver、uiDriverForBusType、createDriver、wireUiDriver、总线名列表、teardown 重置Cpp_IO_OpcUa上下文属性 保留名OpcUa进商业QT_MODULES/QT_LIBS与源码列表。验证是grep -n OpcUa .../ConnectionManager.cpp显示全部三个 switch。DepsT6。当前接线在 core/Devices/IO/ConnectionManager.cpp 与 core/Misc/ModuleManager.cpp。值得注意的是当前 app/CMakeLists.txt 第 90 行注释写明OPC UA does NOT use Qt6::OpcUa (spec 0067). The driver talks to the open62541 static library——即规格完成后后续 spec 0067 把底层换成了直接链 open62541 静态库这是 tasks 文档本身不包含的后续演化。T10API handler任务要求按 plan §API 实现io.opcua.*命令configuration、discoverEndpoints5 秒有界、getEndpoints、browse、tags CRUD、带注册级策略预检的generateProject、getStatus注册在BUILD_COMMERCIAL下构建后由维护者跑SerialStudio --dump-api-schema生成物只经生成器更新。当前 core/Api/API/Handlers/OpcUaHandler.cpp 已落地app/rcc/api/sdk-symbols.json 中可见io.opcua命令面addTag、browse、clearTags、discoverEndpoints、exportCertificate、generateProject、getCertificate、getConfig、getStatus等含后续 spec 加入的证书命令。任务还记录了一个超车道编辑命令在 app/rcc/ai/command_safety.json 中标记。DepsT8、T9。T11 / T12设置面板与标签浏览器 QMLT11要求OpcUa.qmlendpoint URL Discover、带禁用安全行与 tooltip 的 endpoint combo、认证模式、用户名/密码、警告横幅、间隔、标签数、Browse/Generate 按钮、状态行Hardware.qml索引 10 的Loader以及同Modbus.qml的 ComboBox 恢复竞争保护T12要求OpcUaTagBrowser.qmlOpcUaTagModel上的TreeView、复选框 delegate、folder 三态、type/access 列、搜索过滤、软限横幅、Select All Readable、OK/Cancel外观镜像ModbusGroupsDialog.qml打开对话框对仿真器的验证标 [maintainer]。两个 QML 当前分别位于 app/qml/MainWindow/Panes/SetupPanes/Drivers/OpcUa.qml 与 app/qml/MainWindow/Panes/SetupPanes/Drivers/OpcUaTagBrowser.qml。DepsT9T12 另依赖 T8、T11。T13命令注册表、编辑表单、流程图、CLI任务要求driver.opcua开关命令 绑定scripts/registry-verify.py校验、总线 combobox 条目、流程图名称数组加opcua、CLI--opcua url、--opcua-user、--opcua-pass、--opcua-interval、--opcua-tag可重复经setupOpcUaConnection()。当前 CLI 实现见 app/src/Misc/CLI/CliIndustrialConfig.cpp读取opts.opcuaOpt后取cm.opcUa()、setEndpointUrl(url)设置--opcua-user时setAuthMode(1)。验证python scripts/registry-verify.pyscripts/generate-command-strings.py --checkcode-verify.py --check。DepsT4、T9。六、T14–T16仿真器、集成测试与帮助页T14Python 仿真器asyncua 服务器任务要求在examples/OPC UA PLC Simulator/下提供监听opc.tcp://127.0.0.1:4840/serialstudio/的asyncua服务器Plant/Line1/… 文件夹、布尔/整数/浮点/双精度/字符串、一个浮点数组、一个周期性 Bad 状态标签、时变物理量--port、--user/--pass、--secure-only只通告 Basic256Sha256 端点、--no-subscriptions标志由驱动生成器产出的工程文件examples.json中requiresPro: true、分类 Industrial Automationasyncua1.1进 requirements。验证脚本启动 nc -z 127.0.0.1 4840截图标 [maintainer]。任务状态记录已用 asyncua 客户端活体验证。当前 examples/OPC UA PLC Simulator/opcua_plc_simulator.py 及其 README 已按此落地并进一步扩展README 记录了--rate、--drop-after、--security、--cert-expired、--cert-wrong-host等后续安全相关标志工程文件为 examples/OPC UA PLC Simulator/OPC UA PLC Simulator.ssproj。T15集成测试 fixtures任务要求在 tests/integration/test_opcua_driver.py 实现 plan §Test 的测试清单discover、匿名/用户名/坏凭据/关闭端口的连接、browse、不支持类型、generate、订阅速率、轮询回退、CSV 时间戳、坏状态、重连、工程往返、API 面opcua_simulatorfixture4840 不通则 skip重启 helper 服务重连测试markersopcua、requires_opcua_simbus_map[opcua] 10。验证pytest ... --collect-only可先行全量运行标 [maintainer]。任务记录 collects 16 tests; full run pending maintainer app。DepsT10、T14。T16帮助手册页任务要求以 Modbus 页的口吻写 doc/help/Drivers-OPC-UA.md概述、厂商兼容列表、凭据警告、端点发现、标签浏览器、工程生成、订阅 vs 轮询、时间戳、CLI、仿真器演练、API 命令注册在drivers-modbus之后并在 doc/help/Auto-Generating-Projects.md 加交叉链接段。验证python scripts/documentation-verify.py doc/help/Drivers-OPC-UA.md。当前帮助页正文确认与任务描述一致概述厂商兼容性Rockwell via FactoryTalk Linx Gateway、KEPServerEX/Ignition、Siemens S7-1200/1500 与 WinCC、Beckhoff TwinCAT、CODESYS、BR、WAGO、Schneider并且随着后续安全通道规格其None-only 限制段落已更新为支持六种安全策略。七、T17–T19CI、AI 文档与静态门禁T17CI workflow任务要求在.github/workflows/ci.yml的集成矩阵加opcua_sim: true/falseLinux/macOS 腿在 Mosquitto 旁启动 T14 脚本后台 4840 端口等待Windows 腿marker_expr加and not requires_opcua_sim不改 Qt 安装。验证python -c import yaml; yaml.safe_load(...) diff 限于集成 job。当前 .github/workflows/ci.yml 中可见矩阵项opcua_sim: true/false与 Windows 腿的marker_expr: not destructive and not dos and not audio and not requires_broker and not requires_opcua_sim与任务描述逐字吻合。T18AI-facing 文档任务要求更新 doc/claude/architecture/io.md拨号教条异步、一次裁决、delta 帧 tick、轮询回退、vault scope、doc/claude/directory-map.md 新文件行、CLAUDE.md数据源列表与11 drivers计数。验证是ss-ai-audit抽查。T19静态门禁 评审最后一步对所有变更跑code-verify.py --check、registry-verify.py、对驱动/模板/handler diff 跑qt-cpp-review、sanitize-commit.py不提交。任务文档还有一段值得注意的反事实检查最可能失守的规则是一次裁决拨号锁存证据就是failDial漏斗 grep test_closed_port_settles测试——即先声明风险规则再指出守护它的证据。任务状态记录了真实收尾sanitize-commit停在 singleton-census 门7 处全部是兄弟驱动静态实例形状由维护者决定--accept。八、Definition of Done清单如何收口tasks.md 的完成定义全部勾选展示了这类清单的验收口径值得作为工程参照spec.md 的每一条验收标准满足并勾选AC3/AC4/AC6/AC7/AC10 为维护者观察项python scripts/code-verify.py --check对所有变更文件干净qt-cpp-review跑过 C diff14 个确认发现已修6 个调查项记入聊天热路径未触碰维护者在 Pro 构建上跑过一次--benchmark-hotpathAC7pytest tests/integration/test_opcua_driver.py与ctest -R tst_opcua_wire在仿真器在线时绿sanitize-commit.py已跑工作树无 lint 债diff 是所要求的且只有那——超车道编辑全部点名spec.md状态置为done。九、从清单到当前仓库任务完成后的代码演化tasks.md 是任务时刻的快照而当前仓库已经历后续重构从源码结构看可以确认这些演化作为理解 T1–T19 落点的补充证据驱动类注释明确Certificate store, browse session, subscriptions and project builder are sub-objects (spec 0070)见 core/Devices/IO/Drivers/OpcUa.hT6–T8 的单体职责已被拆为OpcUaSession、OpcUaBrowser、OpcUaSubscriptions、OpcUaProjectBuilder、OpcUaFrameAssembler、OpcUaCertificateStore、OpcUaEndpointSelection等子对象core/Devices/IO/Drivers/OpcUa/ 目录但failDial裁决漏斗、m_dialTimer、PendingDial等 T6 命名的一词未变线词汇表从当时的app/src/IO/Drivers/提升到 core/Protocols/OpcUa/OpcUaWire.h常量与帧格式与 T1 描述完全一致测试面从 T3 的tst_opcua_wire扩展到tst_opcua_frame_assembler、tst_opcua_subscriptions、tst_opcua_endpoint_selection、tst_opcua_marshal、tst_opcua_project_builder、tst_opcua_security与 fuzz 目标app/tests/ 目录安全策略T 系列中的 None-only 限制来自 plan 的 2026-08-22 维护者决定在后续规格中补齐OpcUa.h现暴露securityPolicy/securityMode/证书属性帮助页与仿真器的--security/--cert-*标志也印证了这条时间线。十、要点回顾tasks.md 的价值不在文件清单本身而在约定一个任务一个可评审 diff、每个任务自带 Verify 与 Deps、维护者步骤显式标记、超车道编辑显式点名、Definition of Done 逐条勾销OPC UA 驱动的技术主线在 T1/T2/T6/T7 就已定死header-only 线词汇表版本字节 u16 索引 u8 类型 LE payload2048 标签上限、256 字节字符串上限、锁存解码→ 原生模板解码 → 一次裁决拨号 脏槽 delta 帧 tick 订阅/轮询自动回退每个任务的验证命令code-verify.py --check、ctest -R tst_opcua_wire、pytest ... --collect-only、registry-verify.py、documentation-verify.py、yaml 语法检查都是可直接在仓库中复现的读者可据此对任意一个任务做独立的证据核验。【免费下载链接】Serial-StudioOpen-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.项目地址: https://gitcode.com/GitHub_Trending/se/Serial-Studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
