上传

右上角 上传模型 打开（页签标题是「上传」，也常被叫作发布）。三步把当前项目里勾选的模型和测试数据集发到 Darra Forge（git.darra.xyz）：选内容 → 版本号 + 一句话说明 → 发布。发出去的是统一测试包：包根 MANIFEST.json + testsets/ 目录，收包方可以直接加载测试。

图：上传页。上条是执行区：发布名、版本、刷新、取消、可见性、发布；下面左栏是上传内容与文件索引，右栏是介绍与许可证。

功能概览

想做什么	在哪
看当前项目能发什么	左栏 目标信息、发布内容
选内容：勾模型、勾测试数据集	发布内容 的模型网格与测试数据集，配 全选 / 反选
写许可证、一句话说明、README	右栏 授权与文档
定项目名、版本、可见性	左栏 发布配置
控制公开哪些模型信息	左栏 模型信息公开范围
发布	上条 开始上传
改已发出去的描述 / README / 许可证 / 可见性	右栏 编辑已发布项目

备注

本页只做「把模型和测试数据集发上发布仓库」，不是打安装包、也不是出厂发布。不要把「开始上传」理解成一键打安装包、一键出厂。

提示

SDK 语言包和运行环境在 下载，与本页不是一回事。本页只讲怎么把模型和测试数据集发上 git.darra.xyz。现场推理走独立的 Darra AI SDK，与本页无关；加密出包只在 Studio 里做，公开 SDK 解不开明文。

快速开始

三步：

1. 选内容 — 打开项目，右上角 上传模型 进本页，在 发布内容 里勾上要发的模型和测试数据集。
2. 版本号 + 一句话说明 — 填版本号（x.y.z）和一句话说明本次发布。
3. 发布 — 点 开始上传，等结果区给出项目地址和版本号。

需要就再补许可证 / README / 公开范围（见下文各节），三步之外都是可选。

页面布局

上条是执行区，从上到下四行：

行	内容
一	标题 上传到 Darra Forge、校验摘要、刷新按钮
二	开始上传、取消、状态文字
三	进度条（不定长，只表示在忙）
四	结果区：标题、详情、在浏览器打开

主区是左右两栏：

栏	区块	内容
左	目标信息	项目名、模型数量、测试数据集、项目路径
左	发布内容	模型网格、全选 / 反选、已选摘要
左	发布配置	项目名、版本、可见性、模型信息公开范围
右	授权与文档	项目描述、许可证下拉、许可证全文 / README 两个页签、编辑已发布项目

未打开项目时页面显示「未打开项目 — 在左侧打开项目后，此页显示项目信息并可上传。」目标信息三行显示「—」，测试数据集清空，模型网格清空。不崩溃，也不会自动上传。

切回本页会刷新当前项目；点 刷新 也可手动拉一次。

上传前要备齐

按三步备齐：

1. 选内容 — 打开项目（项目名、模型数量、路径只读，来自当前项目），在 发布内容 勾选至少一款模型；要带测试就勾上测试数据集，随包一起发：统一测试包，包根 MANIFEST.json + testsets/ 目录，图片和标注都随包走，收包方按清单直接加载测试；不勾就不带测试数据集。模型网格列是：发布选中、模型、格式、任务、保护状态、来源路径。全选 一次勾上全部，反选 翻转当前勾选。保护状态列只有两种取值：结构受保护、明文模型。项目里没有模型时网格为空，提示「项目中暂无模型 — 在左侧项目树导入模型后可在此勾选发布。」不造占位行。此时点全选 / 反选会提示先导入模型。
2. 版本号 + 一句话说明 — 版本默认 1.0.0，必须是 x.y.z 三段数字；一句话说明写进发布说明。需要就再选许可证（默认 MIT）、点 使用 README 模板 或手写 README。
3. 发布 — 左栏 发布配置 定项目名（作仓库 path）和可见性；模型信息公开范围 勾要公开的字段，并勾「我已确认本次发布允许公开的信息」；点 开始上传。令牌自动取登录态，页面上没有令牌输入框。

开始上传 的禁用条件只有四项：正在上传、未打开项目、没勾模型、没勾确认公开范围。点下之后还会在页内报这些错：项目名为空、版本为空、版本格式非法、许可证全文为空。全部是页内红字加结果区说明，不弹 MessageBox。

备注

页面上没有令牌输入框，也没有「高级设置」分组。发布令牌自动取登录态（或本次会话里上一次发布成功后驻内存的那份），没登录态时才用机器上的 PAT 环境变量兜底。发布访问令牌不是 Darra 登录令牌，两者是两套体系，不能混用。

发布内容

勾选的模型和测试数据集先在本地组装好要公开的内容，再推上发布仓库。权重按大文件完整上传，不会只提交一份指针文件。

进仓	不进仓
README.md、LICENSE.md	未勾选的测试数据集
根 metadata.json、weights/metadata.json	eval 目录，以及 evaluation 里除 report.json 外的历史与 markdown
weights 目录下的权重文件与配套 darmkey	MODEL_CARD.md、model.json、.darra-model.json
包根 MANIFEST.json + testsets/ 目录（勾选的测试数据集，含图片与标注）	labels.txt、training_args.bin
最新一次 evaluation/report.json	本机绝对路径、项目内部 ModelId
.gitattributes（只有大文件规则）	未勾选的披露字段
assets 目录下 README 用到的图片

勾上的测试数据集随包发布：testsets/ 目录收图片和标注，包根 MANIFEST.json 记清单（统一测试包），收包方按清单直接加载测试。

元数据只写真读到的任务 / 标签 / 数据集名，不编造官方 mAP。evaluation/report.json 是有条件的：只有勾了评估摘要、且不是加密发布、且真找到这个文件时才进仓，取的是最后修改时间最新的那份，不是分数最好的那份。

备注

只要本次勾选里有任一加密模型，公开的模型信息就按加密模型的上限来：只公开名称和受保护标记，结构 / I/O / 标签 / 校验值一律不公开——即使你勾了更多字段也不会公开。加密发布时非 darmodel / darmkey 的权重不会上传。

许可证与文档

许可证下拉固定 10 项，顺序是：MIT、Apache-2.0、GPL-3.0、AGPL-3.0、LGPL-3.0、BSD-2-Clause、BSD-3-Clause、MPL-2.0、Unlicense、商业授权。默认选 MIT。

作者默认取登录显示名，没有就用账号 ID，都没有则写 Darra；年份自动取当前年。下拉切换会重新填全文，但发布时以编辑框里的文本为准。

README 可以点 使用 README 模板 生成一版再改，也可以直接手写。README 里用到的本地图片会一并收进 assets 目录推上去。

模型信息公开范围

六个可勾字段：任务类型、标签、产物完整性、训练来源、评估摘要、许可证信息。没勾的字段不写进公开元数据。

必须勾「我已确认本次发布允许公开的信息」才能上传：不勾时按钮禁用，点了也会报「请明确确认本次发布允许公开的模型信息」。

备注

仓库可见性和公开字段是两件事，相互独立。公开仓库不等于字段全公开；字段勾满了，私有仓也只有能访问的人看得到。

发布配置

字段	规则
项目名	默认取项目名。真正用作仓库 path 前会做一次清洗：转小写、非法字符换成 -、去掉首尾 -
版本	默认 1.0.0。必须是 x.y.z 三段数字，不接受 v 前缀和预发布后缀。既作版本号也作发布名
可见性	只有 公开 / 私有 两项，默认公开

同名或同版本再发会失败，且失败点不同：

• 项目名与已有仓库重复：在建项目阶段就报 path 重复，换个名字再发。
• 项目已存在但版本号已用过：多半一路走到打版本号才失败，提示版本已存在。这时仓库与代码其实已经推成功了，可以去 git.darra.xyz 手工补打版本号。

备注

界面那句「公开模型: 公测期间, 不受储存空间限制」是产品策略说明，代码层没有配额逻辑。发布服务真报配额不足时，提示里会建议改用公开仓库。

执行

点 开始上传 后按这个顺序跑：

1. 取令牌、校验请求。
2. 在本地组装本次要公开的内容。
3. 建发布项目。建之前先查 models 组：查得到就建在组里，查不到或查询出错就不带命名空间直接建在个人命名空间下，只记一条警告，不会重试。
4. 本地初始化仓库、检查权重布局，把内容和权重推上默认分支。
5. 打版本号。
6. 写发布说明。

状态行逐步更新。取消 中断本次：HTTP 请求中断，上传进程整棵杀掉，结果区显示「上传已取消」。已经建好的发布项目和已经推上去的提交不会回滚。

关闭本页（关标签、切项目、关窗口）会取消在途上传。

成功时结果区给四行：项目地址、版本号、发布模型名单，以及一句可以在本页或 git.darra.xyz 继续改描述 / README / 许可证的提示。在浏览器打开 用系统默认浏览器打开该项目地址。

失败时把真错误写在结果区，不粉饰：发布服务接口的失败带 HTTP 状态码和响应片段，上传的失败带退出码和错误输出前几百字。

编辑已发布项目

右栏底部 编辑已发布项目 在已有远端项目时可用。改描述、README、许可证、可见性后直接提交进那个仓库，不用重新走一遍上传。README 里的图片会以 assets 目录一并提交。

边界

1. 本页把模型和测试数据集发上 git.darra.xyz。
2. 页面上没有令牌输入框，令牌自动取登录态（没登录态才用环境变量兜底）。
3. 取消或关掉页面都不会回滚已经建好的仓库和已经推上去的提交。
4. 本次勾选里只要有一款加密模型，整份公开元数据都按加密上限裁剪。
5. 同名仓库和同版本号都会失败，但失败点不同：前者卡在建项目，后者卡在打版本号（那时内容其实已经推上去了）。

相关页面

设置 · 产品概述 · 下载