API 接口文档
按实摘自仓库公开头 include/vyntek.h 与 include/vyntek/**（tip 1c03617：嵌套子树 + CM1 扁平便利伞头），未编造未声明的 ABI。空实现 / 未齐处标注「桩 / STUB」。规格全文与对齐表见 cpp-headers；成像/内存正文 image-model · memory-management；对照站 mvdocs。
头树已落地，核心语义亦已实现（编排 Run/Link/Validate、
.avtfLoad/Save、采集停流与归还泵、成像句柄与内存协调）；真实算法仍 stub（Reed 职责），且全部未验收。命名空间vyntek::toolflow/vyntek::imaging。MVP 无稳定 ABI（VYNTEK_ABI_UNSTABLE）。
导航
- 主页
- API（本页）
- ToolFlow · Imaging · Memory · Session
- 规格 · cpp-headers · overview
- 规格对照 · 架构审查
- 本地预览：http://127.0.0.1:8792
伞头 — vyntek.h
便利伞头（CONVENIENCE ONLY）：聚合四模块扁平便利头 + C API，并提供版本查询。优先链接 Vyntek::toolflow + Vyntek::imaging。
版本宏
| 宏 | 说明 |
|---|---|
VYNTEK_VERSION_MAJOR | 主版本，当前 0 |
VYNTEK_VERSION_MINOR | 次版本，当前 1 |
VYNTEK_VERSION_PATCH | 补丁，当前 0 |
VYNTEK_VERSION | 字符串形式，如 "0.1.0" |
VYNTEK_VERSION_NUMBER | MAJOR*10000 + MINOR*100 + PATCH |
VYNTEK_ABI_UNSTABLE | 标记非稳定 ABI |
命名空间函数（vyntek::）
const char* version() noexcept — 库版本字符串。
const char* version_commit() noexcept — 配置时短 git commit，或 "unknown"。
模块索引（按实 · CM1）
| 模块 | 便利头 | 嵌套权威 | 状态 |
|---|---|---|---|
| ToolFlow | vyntek/toolflow.hpp | vyntek/toolflow/*.hpp | 便利转发 · 语义 STUB |
| Imaging | vyntek/imaging.hpp | vyntek/imaging/*.hpp | 便利转发 · 部分实现 · 仍 STUB 标 |
| Memory | vyntek/memory.hpp | 权威在 imaging/buffer.hpp | 转发 + vyntek::BufferView 占位 |
| Session | vyntek/session.hpp | 权威在 toolflow/run_session.hpp | 转发 + vyntek::Session 占位（≠ AcquisitionSession） |
| C API | — | vyntek/capi/vyntek_exports.h | 声明在 · NON-STABLE |
包含方式（按实）
#include <vyntek.h>
// 或扁平便利：
#include <vyntek/toolflow.hpp>
#include <vyntek/imaging.hpp>
// 推荐嵌套（与规格/cpp-headers 一致）：
#include <vyntek/toolflow/toolflow.hpp>
#include <vyntek/toolflow/run_session.hpp>
#include <vyntek/imaging/handle.hpp>
namespace tf = vyntek::toolflow;
namespace im = vyntek::imaging;MVP 口径
- 无稳定 ABI（T14 / host-integration R7）。
- TC-MEM-* 摘录见本站 test-contracts-tc-mem；完整 TC-* 仍见 mvdocs test-contracts。
- 对齐细表：cpp-headers 本仓对齐（tip
1c03617）。