术语终检表(Arden · R8)
www 工作副本 · M1(Arden · 2026-10-21 Asia/Shanghai)
双轨:本页在 www;权威对照仍见 mvdocs glossary。未迁专题外链 mvdocs。
导读入口:overview · cpp-headers
目标设计草案,尚未实施。总体边界见设计概述;编排语义权威见 toolflow.md v1.9(不改语义与 Diagnostic 码表)。本文只做导读收口用术语终检与撞号说明,不另立执行模型。
关联:overview.md(角色化路径) · toolflow.md §2 · host-integration.md · csharp-binding.md · validation-and-roadmap.md(T15 开放风险) · test-contracts.md
1. 核心术语(终检)
| 术语 | 一句话 | 权威落点 | 禁混 / 勿写 |
|---|---|---|---|
| Tool | 可独立 Run 的原子视觉单元;暴露属性 | toolflow.md §2 / §3 | 勿称 ToolBlock / 工具块 |
| ToolFlow | 可复用容器:有序工具 + Inputs/Outputs 终端;产品主容器 | toolflow §2 / §3 | 勿称 ToolBlock;勿与「Tool/ToolFlow 基建」总称混成类型名 |
| ToolId | 对外稳定工具身份(字符串或强类型 id) | toolflow / cpp-headers.md / output-inspection | 勿混 MPF 块 id / 旧 DAG NodeId |
| TypeDesc | 终端/属性的类型描述(含图像精确匹配等) | toolflow §5;cpp-headers | 与公开头同名;勿另造第二套类型系统名 |
| DiagnosticCode | Validate/Run/Load 结构化诊断码闭集 | toolflow §7.4.6;test-contracts.md §8 | 不改码表(R8 仅索引);勿只丢裸字符串 |
.avtf | Vyntek ToolFlow 文档格式(扩展名 .avtf 历史保留;顶层名已锁定) | toolflow §6.3–6.6 | 勿当 .vpp / MPF 兼容;像素不默认内嵌 |
| PixelImageHandle | C++ vyntek::imaging 权威像素句柄 | image-model.md / memory-management.md;toolflow §3.4 | 勿写成「仅 .NET Imaging」或第二套像素真相 |
| Access · ReadOnly | 交给下游前须稳定发布为 Access=ReadOnly;已交下游不得再改写 | toolflow §3.2 / §3.4;memory | 勿称「DAG 边只读」;链接赋值 ≠ 调度边 |
| Adopt · Release | 跨边界所有权:Adopt=绑定接管;Release/Dispose 恰好一次 | host-integration.md §2–3;csharp-binding.md | 禁止双所有者;借用视图 close ≠ 释放图像 |
| 同核 | headless / C# 显示宿主(及可选产线宿主)共用同一 libvyntek_toolflow + libvyntek_imaging | host-integration §1;S07 | 禁止托管侧第二套执行器 / 第二套 Imaging |
补充心智(非类型名):Terminal / Link / RunSession / Registry 见 toolflow §2–§3;ImageDisplay 仅为 C# 显示消费者。
2. Arden 回合 R4–R13 vs T15 开放风险 R1–R10(撞号说明)
两套编号命名空间不同,切勿互替。
| 前缀语境 | 范围 | 含义 | 落点 |
|---|---|---|---|
| Arden 回合 Rn(本阶段文档回合) | R4–R13 | 已拍板的文档交付回合(契约表 / sketch / S09 / 宿主集成 / 术语终检 / T10→TC-OUT / 阶段 D→TC-ACQ·TC-SESS / 阶段 B→TC-MEM / 阶段 F→TC-DISP / 本批横切收束) | overview 索引;validation「已拍板」表中「Arden 回合·Rn」行 |
| T15 开放风险 Rn | R1–R10 | 只登记、不扩做的后议/后续/关闭项 | validation-and-roadmap.md「开放风险登记表」 |
撞号对照(同号 ≠ 同事)
| 号 | Arden 回合(文档交付) | T15 开放风险(只登记) |
|---|---|---|
| R4 | 测试契约表 test-contracts.md | 脚本钩子 / 脚本语言(后续) |
| R5 | 伪仓库树 sketch/README.md | 产线 IO(后续) |
| R6 | 负路径/嵌套场景 S09a–d | 进程外 IPC(后续) |
| R7 | 宿主集成 host-integration.md | 稳定 ABI(后续) |
| R8 | 本页 + overview 导读收口 | DAG/MPF/.vpp(关闭·非目标) |
| R9 | T10 输出观察 → TC-OUT- + S10*(test-contracts / examples-scenarios / output-inspection) | 编辑 UI / 属性网格 / 画布(后续) |
| R10 | 阶段 D 采集/会话 → TC-ACQ- + TC-SESS- + S11**(test-contracts / camera-acquisition / session-lifecycle / examples-scenarios) | ImageDisplay 写成 C++ UI(关闭·禁止;显示仅 C#) |
| R11 | 阶段 B 存储/pin/归还 → TC-MEM- + S12*(test-contracts / memory-management / examples-scenarios) | T15 无 R11(开放风险表仅 R1–R10)——本回合编号独立,无同号 T15 项可撞 |
| R12 | 阶段 F 显示集成 → TC-DISP- + S13*(test-contracts / image-display / examples-scenarios);显示契约仅 C# | T15 无 R12;勿与 T15 R10(C++ UI·已关闭)互替——显示仅 C#,本回合编号独立 |
| R13 | 本批横切收束:toolflow §10.1 T13 索引对齐 OUT/ACQ/SESS/MEM/DISP + S10–S13;validation/overview/sketch 薄回链;文档侧 B–F 已收口(除阶段 A);实现证据另册 | T15 无 R13——本回合编号独立;不扩做、不开下一批 |
引用时写全称:「Arden · R10」 或 「T15 开放风险 R10」,禁止裸写「见 R10」而不标明语境。尤忌把 Arden · R10(阶段 D 契约化)与 T15 R10(C++ UI·已关闭)互替;同理 Arden · R9 ≠ T15 R9(编辑 UI)。Arden · R11 ≠ 任何 T15 开放风险同号(T15 无 R11;本回合编号独立)。Arden · R12(阶段 F 显示·仅 C#)≠ T15 R10(C++ UI·已关闭);T15 无 R12,本回合编号独立。Arden · R13(本批横切收束)≠ 任何 T15 同号(T15 无 R13)。
3. 禁混词(肯定语境禁用;否定句可保留)
| 禁混 | 正确口径 |
|---|---|
| Node / NodeId(作编排身份) | 用 ToolId / 工具属性路径 |
| ToolBlock / 工具块(作类型名) | 用 ToolFlow |
DAG(作肯定调度模型) / dag-dataflow | 列表序 Run + 链接赋值;旧 DAG 文已废止,勿链 |
| 「Imaging 仅依赖 .NET」 / 仅 .NET Imaging | 权威在 C++ vyntek::imaging;.NET 仅为绑定/显示投影 |
MPF_ToolBlock / .vpp(作目标) | 非目标;不接入、不兼容承诺 |
否定句示例可保留:「不混 MPF/DAG」「禁止 Imaging 仅依赖 .NET」「链接不是 DAG 边」。
文档状态:术语终检草案(Arden · R8 · 2026-10-21,Asia/Shanghai;撞号表含 Arden · R9 / Arden · R10 / Arden · R11 / Arden · R12 / Arden · R13)。对齐 toolflow v1.9;不改语义与码表。导读入口见 overview.md。