模型库
Studio 里的模型来自两处：在线模型库（浏览 git.darra.xyz 上的公开仓库，看中了直接导入）和本地导入（把本机已有的权重文件复制进当前项目）。两条路收进来之后都是项目树里的一个模型，推理 / 训练 / 蒸馏 / 评估 / 导出走同一套。
在线模型库页正文是 git.darra.xyz 的项目仓库列表，可按 topic 筛选；顶部一条状态行，左侧写导入进度，右侧写当前仓库或本次导入的落点路径。
功能概览
| 想做什么 | 从哪进 | 要不要先打开项目 |
|---|---|---|
| 浏览公开的模型仓库 | 右上角 在线模型库 | 不要 |
| 把看中的仓库下到本机下载落点 | 仓库页的 导入到 AI Studio | 不要 |
| 下载后直接进项目树接着用 | 同上 | 要；没开项目就只落在本机下载落点，之后打开项目再登记 |
| 把本机已有的权重收进当前项目 | 开始 → 导入 → 导入模型 | 要 |
| 改模型名、任务类型、输入尺寸、类别名 | 导入模型 对话框里改完再确认 | 要 |
| 看推理参数和标签 | 模型右键 → 配方 | 要 |
在线模型库就是 git.darra.xyz 的项目浏览页，模型真身存在那边的 Git LFS 上；Studio 负责浏览和取回。
快速开始
从在线模型库取一个现成模型：
- 右上角 在线模型库，列表里点进目标仓库。
- 在仓库页点 导入到 AI Studio。
- 看顶部状态行的进度和落点路径。当前已打开项目时，模型同时登记进左侧项目树。
- 项目树里双击模型叶子，进模型工作区开始用。
把本机已有的权重收进项目：
- 先新建或打开项目。
- Ribbon 开始 → 导入 → 导入模型。
- 选权重文件，核对自动探测出来的元数据，别称可填可不填。
- 确认导入，模型出现在项目树 模型 (N) 下。
只想下下来、暂时不用： 在线模型库照常导入即可。落点是设置里的 模型/数据集根目录，之后任何时候打开项目再把它导进来。
在线和本地怎么选
| 在线模型库 | 本地导入 | |
|---|---|---|
| 源 | git.darra.xyz 上的仓库 | 本机磁盘上的权重文件或 zip 包 |
| 要不要先打开项目 | 不要 | 要 |
| 落点 | 模型/数据集根目录（下载落点）；开着项目则同时登记进项目树 | 复制进当前项目并登记 |
| 元数据 | 取仓库里的 metadata | 自动探测，导入前可改 |
| 取回方式 | 从在线仓库下载到本机 | 本地文件复制 |
在线库下到本机下载落点的权重，打开项目后也会被登记进项目树。之后它就是项目里的普通模型，可以推理 / 训练 / 导出，也可以在模型叶子上右键走配方、蒸馏。
在线模型库
右上角 在线模型库 打开。不用先新建或打开项目，欢迎页上也能进。
页面就是 git.darra.xyz 的项目列表（公开地址 https://git.darra.xyz/explore/projects）。页内点站内链接仍留在本页，不会变成完整网页。加载时顶部有一条进度条，加载完成才消失。
登录态跟随 Studio：登过 Darra 账号就能看到你有权限的仓库。登录、登出都会让本页刷新一次。
页面语言跟随 Studio 当前界面语言。卡片样式以站点为准；顶部状态条、进度条与失败面板用 Studio 同一套样式。
未登录也能进在线模型库，看得到的是公开仓库。私有仓要先登录。
页内行为
| 你点的是 | 结果 |
|---|---|
| git.darra.xyz 域内链接 | 仍在本页打开，不弹新窗口 |
| 域外链接 | 用系统默认浏览器打开 |
| 仓库页的 导入到 AI Studio | Studio 拦下来自己处理，不交给系统协议 |
| 页内的下载链接 | 同上，走一键导入 |
页面不弹 MessageBox，进度和结果都写在顶部状态行。导入完成后落点路径显示在状态行右侧；停在某个仓库页时，右侧显示当前仓库路径。
一键导入
仓库页上的导入按钮（Release 页、项目页）触发 Studio 的一键导入。
| auto 参数 | 干什么 |
|---|---|
| 不写（默认） | 直接下载并导入，不弹对话框 |
| 1 | 同上，直接下载并导入 |
| 0 | 只停在本页，不下载。状态行提示已打开在线模型库 |
导入按钮标明这次是模型还是数据集。一次导入进行中，再点不会重复开始。
下载过程：
- 取仓库压缩包。先按链接指定的分支取，取不到（404）再试 main，再试 master。
- 解压后按扩展名找权重文件。在线库认这些：
.onnx、.pt、.pth、.pdmodel、.pdiparams、.tar、.darmodel、.safetensors、.tflite（暂不支持, 建议转 ONNX）、.bin、.ckpt、.engine、.weights。 - 权重若还是 Git LFS 指针（一百多字节的文本），会再取一次真实文件。取不到就如实失败，不把指针当成功。
- 元数据里有 sha256 就校验；对不上删掉这次半成品并失败。元数据没给 sha256 就不校验。
- 落到设置里的 模型/数据集根目录。目标目录已有内容时合并、同名文件覆盖，不会清空重来。
下载只走 git.darra.xyz，不会去其他站点取模型权重。公开仓匿名就能下，私有仓下不了。只接受 git.darra.xyz 上的仓库地址。
失败与重试
| 现象 | 页面上看到什么 | 怎么办 |
|---|---|---|
| 打不开页面 | 在线模型库加载失败 + 原因 | 检查网络后点重试 |
| 导航失败（断网 / DNS / 被拒） | 页面导航失败 + 错误状态 | 点重试 |
| 超过约 25 秒没有响应 | 页面加载超时，点「重试」重新加载 | 点重试 |
| 链接不认识 | 无法识别的导入链接 | 回仓库页重新点 导入到 AI Studio |
| 归档取不到 | 归档下载 404，写明试过的分支 | 确认仓库存在且是公开仓 |
| 权重还是 LFS 指针 | 权重仍是 Git LFS 指针，不是真实文件 | 点重试；多次不行就是仓库侧没存真字节 |
| zip 里没有权重 | 包内未找到模型权重文件 | 换一个包 |
导入失败时会按类别给出处置提示：
| 类别 | 提示含义 |
|---|---|
| 网络 | 检查本机网络与 git.darra.xyz 是否可达；私有仓匿名下载会被拒绝 |
| 超时或取消 | 网络慢时稍后重试 |
| 磁盘 | 检查目标盘剩余空间与写权限 |
| 权限 | 换个模型/数据集根目录，或用有权限的账户运行 |
失败只写在状态行或错误面板上，不弹窗。日志里有对应的错误条目（含异常类型和堆栈）。
本地导入
Ribbon 开始 → 导入 → 导入模型。
必须已经打开项目，否则提示 还没打开工程。先新建或打开，再导入。
对话框标题是 导入模型，说明是「从模型库中选择模型文件，复制到当前项目并完成登记」。浏览按钮默认落在设置里的 模型/数据集根目录（默认 %LOCALAPPDATA%\DarraAI\models；开发机 Z 盘挂载时用 Z:\DarraAIModels）。
可以选这些文件：
| 类型 | 文件 | 导入时的行为 |
|---|---|---|
| ONNX | .onnx | 后台探测元数据 |
| PyTorch | .pt、.pth | 自动识别结构 |
| Safetensors | .safetensors | 按原文件复制 |
| Paddle | .pdmodel、.pdiparams、.tar | 读得到就读，读不到如实留未知 |
| TensorRT | .engine | 按原文件复制，不在导入时转换 |
| OpenVINO | .xml 加同名 .bin | 成对复制；只有 .xml 就只复制 .xml，不发明权重 |
| RKNN | .rknn | 按原文件复制，Windows 上不转换、不推理 |
| 加密包 | .darmodel | 结构受保护，只登记不解析 |
| 压缩包 | .zip | 先解压扫描包内权重，找到再走上面的分支 |
选中后自动探测：模型名称、任务类型、输入宽高、类别名，填进「元数据（检测值可手动修正）」。探测错了直接改，保存时按你改的写进项目。别称可选，不填就用自动检测出来的名称。
任务类型下拉九项：目标检测 (detection)、图像分类 (classification)、语义分割 (segmentation)、姿态估计 (pose)、旋转检测 (obb)、文字识别 (ocr)、OCR文本检测 (ocr-text-detection)、实例分割 (instance-segmentation)、深度估计 (depth)。只有选姿态估计才显示 关键点数。
下拉之外还有异常检测 (anomaly)、嵌入 (embedding) 这类任务，靠模型元数据带进来：探测到什么任务就登记什么，下拉停在「未指定」，不改写成别的任务。这两类跑起来的结果形态（逐像素分数图 / 特征向量）：推理。
类别名是一张表，一行一类，类别数直接由行数得出，不用另外填个数。文字识别没有类别表，这一块会收起来。
zip 里的权重若还是 Git LFS 指针，会提示「权重仍是 Git LFS 指针，不是真实文件」，不会把指针当成模型导进来。加密模型不解析结构，界面上如实标「结构受保护」。模型库的商用加密包云端签发、随包验票，口径：加密。
模型始终复制进当前项目目录，不用软链接。数据集才有复制 / 软链接二选一，那是另一回事（设置）。部分格式会先提示装对应运行时，关掉这个提示不影响导入。
边界
- 在线模型库不需要项目；本地「导入模型」必须先打开项目。
- Studio 负责建模与出包。
- 仓库页上有 导入到 AI Studio，在线模型库页本身没有「导入到 IDE」按钮，导入只从仓库页走。
- 私有仓匿名下不了。出包与授权：产品概述。
- RKNN 模型在 Windows 上不转换、不推理，要跑到板端。
- 产品不带本地模型分发库，随包只有 SAM2（辅助自动标注，
models/sam2）；其余模型从在线模型库取。