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

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

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

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

flowchart TB
  subgraph public_tf ["vyntek::toolgroup 公开"]
    TF[toolgroup.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[toolgroup 执行器/校验实现]
    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/toolgroup/... # 公开
include/vyntek/imaging/... # 公开
src/toolgroup/detail/... # 或 include/vyntek/toolgroup/detail/ 但不进 SDK 安装包
src/imaging/detail/...

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

namespace tg = vyntek::toolgroup;
namespace im = vyntek::imaging;

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

include/
  vyntek.h # 伞头：四模块便利头 + capi + version()
  vyntek/
    toolgroup.hpp # 便利 → toolgroup/{toolgroup,run_session,registry,diagnostic}.hpp
    imaging.hpp # 便利 → imaging 公开子树（含 acquisition_session）
    memory.hpp # 便利 → imaging/buffer + 扁平 vyntek::BufferView 占位
    session.hpp # 便利 → toolgroup/run_session + 扁平 vyntek::Session 占位
    capi/vyntek_exports.h # C 导出（PInvoke 面）
    toolgroup/{toolgroup,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