C++ 头文件与模块边界（示意）

UI / Runner / 产线宿主
        │
        ▼
  vyntek::toolflow（公开头）  ──依赖──►  vyntek::imaging（公开句柄头）
        │
        ▼
  detail/internal（不对宿主暴露）

<vyntek/toolflow/toolflow.hpp>      // ToolFlow 根：Create / Load / AddTool / Link / Validate
<vyntek/toolflow/tool.hpp>          // Tool 基类 / 观察指针 / ToolId / LastRun 查询
<vyntek/toolflow/terminal.hpp>      // Inputs/Outputs 终端、TypeDesc
<vyntek/toolflow/link.hpp>          // Link 端点、LinkId、建链结果
<vyntek/toolflow/run_session.hpp>   // RunSession、RunResult、RunContext、取消
<vyntek/toolflow/registry.hpp>      // ToolRegistry、工厂、register_builtin_tools
<vyntek/toolflow/serialize.hpp>     // .avtf Load/Save、schema_version、Diagnostic
<vyntek/toolflow/diagnostic.hpp>    // Diagnostic / DiagnosticCode / Severity（亦可由 serialize/toolflow 转发）

<vyntek/imaging/image_info.hpp>     // ImageInfo、PixelFormat、ColorEncoding
<vyntek/imaging/handle.hpp>         // 公开句柄：Share / OpenRead / OpenWrite / Access
<vyntek/imaging/access.hpp>         // ReadOnlyView / WritableView（临时访问）
<vyntek/imaging/buffer.hpp>         // ImageBuffer、Rent / ImportNative / ReturnCompleted
<vyntek/imaging/factory.hpp>        // PixelImage 工厂：Create / Copy / RentGray8…
<vyntek/imaging/version.hpp>        // ImageContentVersion

// <vyntek/toolflow/toolflow.hpp> 可转发包含 tool / terminal / link / run_session
#include <vyntek/toolflow/tool.hpp>
#include <vyntek/toolflow/terminal.hpp>
#include <vyntek/toolflow/link.hpp>
#include <vyntek/toolflow/run_session.hpp>
// 成像：只依赖公开句柄，不拉 buffer 内部实现
#include <vyntek/imaging/handle.hpp>

flowchart TB
  subgraph public_tf ["vyntek::toolflow 公开"]
    TF[toolflow.hpp]
    Tool[tool.hpp]
    Term[terminal.hpp]
    Link[link.hpp]
    Run[run_session.hpp]
    Reg[registry.hpp]
    Ser[serialize.hpp]
    Diag[diagnostic.hpp]
  end
  subgraph public_im ["vyntek::imaging 公开"]
    HI[handle.hpp]
    II[image_info.hpp]
    Acc[access.hpp]
    Buf[buffer.hpp]
    Fac[factory.hpp]
    Ver[version.hpp]
  end
  subgraph internal ["detail / internal（不对宿主）"]
    TFImpl[toolflow 执行器/校验实现]
    ImImpl[协调实体/池/归还泵]
  end
  subgraph csharp ["C# / UI（绑定层）"]
    ID[ImageDisplay 控件]
    Bind[PInvoke 绑定 MVP；见 csharp-binding]
  end
  TF --> Tool
  TF --> Term
  TF --> Link
  TF --> Run
  TF --> Reg
  Ser --> TF
  Diag --> TF
  TF -.->|属性中的图像句柄| HI
  Tool -.-> HI
  HI --> II
  HI --> Acc
  HI --> Ver
  Fac --> HI
  Fac --> Buf
  TFImpl --> public_tf
  ImImpl --> public_im
  Bind -->|句柄/视图桥| HI
  Bind --> TF
  ID --> Bind

include/vyntek/toolflow/...     # 公开
include/vyntek/imaging/...      # 公开
src/toolflow/detail/...     # 或 include/vyntek/toolflow/detail/ 但不进 SDK 安装包
src/imaging/internal/...

// 示意、非已发布 ABI
#include <vyntek/toolflow/toolflow.hpp>
#include <vyntek/toolflow/registry.hpp>
#include <vyntek/toolflow/run_session.hpp>
#include <vyntek/toolflow/serialize.hpp>
#include <vyntek/imaging/handle.hpp>

namespace tf = vyntek::toolflow;
namespace im = vyntek::imaging;

// ToolFlow 持有/传递 im::PixelImageHandle；不 include UI。

include/
  vyntek.h                          # 伞头：四模块便利头 + capi + version()
  vyntek/
    toolflow.hpp                    # 便利 → toolflow/{toolflow,run_session,registry,diagnostic}.hpp
    imaging.hpp                     # 便利 → imaging 公开子树（含 acquisition_session）
    memory.hpp                      # 便利 → imaging/buffer + 扁平 vyntek::BufferView 占位
    session.hpp                     # 便利 → toolflow/run_session + 扁平 vyntek::Session 占位
    capi/vyntek_exports.h           # C 导出（PInvoke 面）
    toolflow/{toolflow,tool,terminal,link,run_session,registry,serialize,diagnostic,output_inspector}.hpp
    imaging/{image_info,handle,access,buffer,factory,version,status,acquisition_session,memory_pool,memory_owner,fake_camera_adapter}.hpp