概念与术语
术语终检表
导读入口：overview · cpp-headers
目标设计草案，尚未实施。总体边界见设计概述；编排语义权威见 toolgroup.mdx v1.9（不改语义与 Diagnostic 码表）。本文只做导读收口用术语终检，不另立执行模型。
关联：overview.mdx（角色化路径） · toolgroup.mdx §2 · host-integration.mdx · csharp-binding.mdx · validation-and-roadmap.mdx（T15 开放风险） · test-contracts.mdx
1. 核心术语（终检）
| 术语 | 一句话 | 权威落点 | 禁混 / 勿写 |
|---|---|---|---|
| Tool | 可独立 Run 的原子视觉单元；暴露属性 | toolgroup.mdx §2 / §3 | 勿称 ToolBlock / 工具块 |
| ToolGroup | 可复用容器：有序工具 + Inputs/Outputs 终端；产品主容器 | toolgroup §2 / §3 | 勿称 ToolBlock；勿与「Tool/ToolGroup 基建」总称混成类型名 |
| ToolId | 对外稳定工具身份（字符串或强类型 id） | toolgroup / cpp-headers.mdx / output-inspection | 勿混外部块 id / 旧式 NodeId |
| TypeDesc | 终端/属性的类型描述（含图像精确匹配等） | toolgroup §5；cpp-headers | 与公开头同名；勿另造第二套类型系统名 |
| DiagnosticCode | Validate/Run/Load 结构化诊断码闭集 | toolgroup §7.4.6；test-contracts.mdx §13 | 不改码表，仅作索引对照；勿只用裸字符串 |
.avtg | Vyntek ToolGroup 文档格式（扩展名 .avtg；顶层名已锁定） | toolgroup §6.3–6.6 | 勿当 .vpp 兼容；像素不默认内嵌 |
| PixelImageHandle | C++ vyntek::imaging 权威像素句柄 | image-model.mdx / memory-management.mdx；toolgroup §3.4 | 勿写成「仅 .NET Imaging」或第二套像素真相 |
| Access · ReadOnly | 交给下游前须稳定发布为 Access=ReadOnly；已交下游不得再改写 | toolgroup §3.2 / §3.4；memory | 链接赋值 ≠ 调度边 |
| Adopt · Release | 跨边界所有权：Adopt=绑定接管；Release/Dispose 恰好一次 | host-integration.mdx §2–3；csharp-binding.mdx | 禁止双所有者；借用视图 close ≠ 释放图像 |
| 同核 | headless / C# 显示宿主（及可选产线宿主）共用同一 libvyntek_toolgroup + libvyntek_imaging | host-integration §1；S07 | 禁止托管侧第二套执行器 / 第二套 Imaging |
补充心智（非类型名）：Terminal / Link / RunSession / Registry 见 toolgroup §2–§3；ImageDisplay 仅为 C# 显示消费者。
2. 禁混词（肯定语境禁用；否定句可保留）
| 禁混 | 正确口径 |
|---|---|
| Node / NodeId（作编排身份） | 用 ToolId / 工具属性路径 |
| ToolBlock / 工具块（作类型名） | 用 ToolGroup |
| 「Imaging 仅依赖 .NET」 / 仅 .NET Imaging | 权威在 C++ vyntek::imaging；.NET 仅为绑定/显示投影 |
第三方 ToolBlock / .vpp（作目标） | 非目标；不接入、不兼容承诺 |
否定句示例可保留：「禁止 Imaging 仅依赖 .NET」「链接不是调度边」。
文档状态：术语终检草案。对齐 toolgroup v1.9；不改语义与码表。导读入口见 overview.mdx。