设计规格
设计规格
规范性的设计契约：架构决策、行为规定、接口外形与验收口径。
规格 ID：TC001 — 稳定标识（页面改名/迁移不变），全站对照见设计规格索引。
设计规格是**规范性（应然）**内容：API 契约、行为规定、架构决策、验收口径。实现现状单独标注，外形 ≠ 验收完成。
本站即规格权威。M6 未开；M5-10：显示 MVP 只认 Controls，Skia/Avalonia 不双开。
规格入口
| 主题 | 页面 |
|---|---|
| 概述 / 角色读序 | 机器视觉设计概述 |
| Tool / ToolGroup（编排） | toolgroup |
| C++ 头树 / 库名 T14 | cpp-headers |
| 图像模型 / 内存 | image-model · memory-management |
| 采集 / 会话停流 | camera-acquisition · session-lifecycle |
| 观察 / 性能诊断 | output-inspection · performance-and-diagnostics |
| 显示 / C# 绑定 | image-display · csharp-binding |
| 测试契约（验收口径） | test-contracts · 薄摘 TC-MEM · TC-SESS · TC-ACQ · TC-OUT · TC-DISP |
| 场景与验证路线 | examples-scenarios · validation-and-roadmap |
| 测试准入策略 | test-value-and-lifecycle |
| 伪仓库树对照 | sketch |
规格 ID 索引（TC001–TC021）
每份规格页在首行标注规格 ID：TC001 式（TC + 3 位数字），分配后永不复用、不随页面改名/迁移变化。分配顺序：本页 → engineering/ → machine-vision/（概述 → 编排 → 头树 → 内存 → 采集 → 会话 → 观察 → 性能 → 显示 → 绑定 → 契约表 → 五份薄摘 → 场景 → 路线 → sketch）。
勿与契约 ID 混淆：
TC001式标识规格页本身；TC-<组>-<序号>（如TC-MEM-01、TC-ACQ-05）标识 test-contracts 表内的验收条目。两套编号互不通用。
| ID | 规格页 | 页面 |
|---|---|---|
| TC001 | 设计规格索引（本页） | /docs/specs/ |
| TC002 | 测试价值与生命周期规范 | test-value-and-lifecycle |
| TC003 | Vyntek 机器视觉设计概述 | overview |
| TC004 | Tool / ToolGroup 基建设计 | toolgroup |
| TC005 | C++ 头文件与模块边界 | cpp-headers |
| TC006 | 图像存储、访问与归还生命周期 | memory-management |
| TC007 | 持续相机采集与缓冲回收 | camera-acquisition |
| TC008 | 会话停止、故障与最终回收 | session-lifecycle |
| TC009 | 工具最近输出与动态调试 | output-inspection |
| TC010 | 图像系统性能、配额与诊断 | performance-and-diagnostics |
| TC011 | ImageDisplay 多格式图像集成 | image-display |
| TC012 | C# 适配 / 绑定（MVP） | csharp-binding |
| TC013 | MVP 可勾选测试契约表 | test-contracts |
| TC014 | 测试契约摘录：TC-MEM-* | test-contracts-tc-mem |
| TC015 | 测试契约摘录：TC-SESS-* | test-contracts-tc-sess |
| TC016 | 测试契约摘录：TC-ACQ-* | test-contracts-tc-acq |
| TC017 | 测试契约摘录：TC-OUT-* | test-contracts-tc-out |
| TC018 | 测试契约摘录：TC-DISP-* | test-contracts-tc-disp |
| TC019 | 示例代码场景规划（S01–S13） | examples-scenarios |
| TC020 | 验证与完善路线 | validation-and-roadmap |
| TC021 | 伪仓库树（sketch） | sketch |
角色读序
| 角色 | 建议顺序 |
|---|---|
| 编排作者 | toolgroup §2–§4 → §3.4 句柄 → §7.6 fake → test-contracts TC-* |
| Headless 宿主 | host-integration → toolgroup 停止矩阵 → TC-RUN-04 / TC-SER-01 |
| C# 显示宿主 | host-integration → csharp-binding → image-display（仅 C# · Controls）→ TC-DISP |
| 成像消费者 | image-model + memory-management → camera-acquisition / session-lifecycle → TC-MEM / TC-ACQ / TC-SESS → cpp-headers |
本仓 ↔ 规格（按实）
| 本仓路径 | 规格期望 | 状态 |
|---|---|---|
include/vyntek/toolgroup/*.hpp | <vyntek/toolgroup/…> | 路径已齐；编排核心语义已实现（Run/Link/Validate/.avtg Load·Save）；真实算法仍 stub；观察面外形在 output_inspector.hpp |
include/vyntek/imaging/*.hpp | <vyntek/imaging/…> | 路径已齐；采集/池/停流有骨架；仍 NON-STABLE |
include/vyntek/{toolgroup,imaging,memory,session}.hpp | CM1 便利伞头 | 转发嵌套头；BufferView / Session 为占位 |
include/vyntek.h | 伞头 | 转发子树 + capi；无稳定 ABI |
include/vyntek/capi/vyntek_exports.h | PInvoke | share / try_get_* / latest / handle_image_info 已声明 |
| CMake 双库 | T14 | vyntek_toolgroup + vyntek_imaging |
imaging/acquisition_session.hpp | 采集会话 | 停流骨架；Latest = 预览槽；PeekIngressFront = FIFO |
bindings/csharp | PInvoke + ImageDisplay | 投影接口、Unload/Remount、view 映射在；无真实渲染；TC-DISP 未勾 |
tests/ / examples/ | TC-* / S01–S13 | 勾选未关；示例专题属 M6 未开 |
明细见 cpp-headers 本仓对齐。