常见问题
没有写进这里的数字（精度、速度、价格、规模）一律不要当官方数据用。
Studio 和 SDK 有什么区别？
Darra AI Studio 是 Windows 桌面端：建项目、管数据集、标注、训练、蒸馏、评估、导出，以及把模型单向加密成 .darmodel。
Darra AI SDK 是独立发放的推理运行时：打开 Studio 出的模型包（或明文模型）做推理，不做加密和签发。
| 产品 | 做什么 | 不做什么 |
|---|---|---|
| AI Studio | 建模与出包（含加密签发） | 不当现场推理服务 |
| Darra AI SDK | 开包、推理、关闭 | 不训练、不蒸馏、不签发 |
用 Studio 必须装 SDK 吗？
只用 Studio 做数据集 / 训练 / 导出：不必须另装公开 SDK，Studio 安装包本身就够用。
要把模型接到现场、PLC 或自己的程序里跑推理：必须用 Darra AI SDK，现场没有第二套推理入口。Studio 出包，SDK 推理。
模型从哪里来？
两个入口，收进来之后都是项目树里的一个模型：
| 入口 | 位置 | 要不要先打开项目 |
|---|---|---|
| 在线模型库 | 右上角 在线模型库 | 不要 |
| 本地导入 | 开始 → 导入 → 导入模型 | 要 |
在线模型库是内嵌的 git.darra.xyz 浏览页，点 导入到 AI Studio 下载到模型 / 数据集根目录；已打开项目时同时登记进项目树。
在哪里登录？各处登录态会不一致吗？
登录入口在右上角「登录」。 点开的是工作区里的登录页（账号中心 login.darra.xyz），设置页、导出页等处的「请先登录」引导也进同一页。
全程序只有一份登录态。 右上角按钮、AI 助手面板头部、在线模型库、设置页读的是同一个结果；登录、登出、令牌续期都立刻一起刷新。
Studio 与商城、官网共用同一套 Darra 账号；登录只记住账号，不记密码，令牌只在本机可用。
登录和商用授权是一回事吗？
不是。 登录是身份，商用授权是资格，AI 调用密钥是配额，三者各自独立判。
| 登录 | 商用授权 | |
|---|---|---|
| 证明什么 | 现在用的是哪个 Darra 账号 | 这个账号能不能签发商用模型包 |
| 在哪看 | 右上角按钮 / 设置页账号区 | 用到加密签发时当场查，界面给结论 |
| 谁说了算 | 账号中心 | 授权库（买过才有） |
| 没有会怎样 | 云端功能不可用，界面写未登录 | 加密签发直接拒绝，并说明原因 |
加密签发按模型包收费，登录之后还要查到授权才能用；查不到（没买、被拒、网络不通）一律按没有处理。价格 商城 AI Studio 商用授权。AI 调用密钥来自环境变量 DARRA_AI_API_KEY 或登录后自动换。
知识蒸馏是强化学习吗？
不是。 Studio 的蒸馏是教师–学生知识迁移，按教师品类分三档：L1 伪标签（通用）、L2 软目标（温度 T=4.0，仅分类 .pt 教师）、L3 特征对齐（仅检测 .pt 教师，训练约慢 1.5–2 倍）。加密模型禁止再拿来训练或蒸馏。
Windows 上有没有 RKNN？
edge-rknn 仅 linux-arm64（RK3588 一类板端）；Windows / linux-x64 不提供 RKNN 转换与推理。Studio 可把已有 .rknn 打进 .darmodel，但这两端收到 rknn 载荷会拒载，NPU 驱动 SDK 不代装。
加密后的模型能不能解密回明文？
不能。 加密单向，官方不提供解回 ONNX / engine / 权重文件的通道；激活码只等于「这一份模型包、离线、永久推理」，不是解包口令。
Linux 有没有 Studio 图形界面？
没有。 桌面端仅 Windows；Linux 只发放 SDK 内核包（x86_64 与 ARM64）。
板端或 Linux 工控机用 SDK 做推理，建模仍在 Windows 上的 Studio 完成。
如何安装？
安装包与语言包从 下载 或 商城 获取。驱动（NVIDIA / 板端 NPU）不代装。
AI Studio（仅 Windows）：
- 装 .NET 8 Desktop Runtime x64。
- 解压应用 ZIP，运行
Darra.AI.Studio.exe。缺 Visual C++ 运行库时启动会提示，按提示装 vc_redist.x64.exe。 - 系统要求 Windows 10 / 11 x64。完整安装包在商城取，不附带在 PLC IDE 里。
Darra AI SDK：
| 平台 | 内核包 |
|---|---|
| Windows x64 | darra-ai-core-windows-x64.zip |
| Linux x86_64 | darra-ai-core-linux-x64.tar.gz |
| Linux ARM64（RK3588 板端） | darra-ai-core-linux-arm64.tar.gz |
语言包只装一个即可。SDK 不下载、也不安装任何环境：推理运行库（ORT / CUDA / TensorRT / OpenVINO / RKNN 等）自己装好，或用带齐依赖的离线整合包。
SDK 支持哪六种语言？
六种语言走同一套推理接口，能力一致。
| 语言 | 包 | 入口 |
|---|---|---|
| C | darra-ai-core 压缩包，或 darra-ai-c-sdk.zip | C |
| C++ | 与 C 共用内核，直接包含 C 头文件 | C++ |
| C# | NuGet 包 Darra.AI.Runtime | C# |
| Python | pip 包 darra-ai，导入名 darra_ai | Python |
| Java | Maven 坐标 xyz.darra:darra-ai，JDK 17 以上 | Java |
| Rust | crate darra-ai，内部发布 | Rust |
全部推理唯一入口：darra_session_open / darra_session_open_plain → darra_session_infer_image → darra_session_close。GUI、PLC、客户应用同一路径。
能不能开放导出？必须加密吗？
可以开放导出，加密不是唯一出口。 转换中心是 ONNX：PT / Paddle 转 ONNX，ONNX 再转 TensorRT engine / OpenVINO；导出页可以出这些行业格式，不强制打进 .darmodel。
SDK 对明文 ONNX 走 darra_session_open_plain；对已签发包走 darra_session_open。限制：不能逆向转换（engine / OpenVINO 不能转回 ONNX）；.pt / .pth 不是运行时载荷，要先转 ONNX。
打包期阈值是默认值，推理期可由用户覆盖（SessionOptions 的 conf_threshold / nms_threshold / top_k / ctc_blank_index / mask_threshold / ocr_dictionary）。输入边长与类别名是模型事实，打包期定下，推理期不覆盖。