协作需求：v3.0.0-alpha 整合包代传魔搭（kohya / musubi，可选 Fast 完整版）

[wochenlong]

仓库内文档（合入后）：docs/team/portable-upload-request-v3.0.0-alpha.md
CC: @IryNeko @ageless-h @SupermarKleet @niangao2331 @MikumikuDAIFans

协作需求：v3.0.0-alpha 整合包上传（魔搭 / 可选抱脸）

给有上行带宽、有魔搭写权限的合作者
维护者本机上行约 1.3MB/s，对 2GB+ 单文件 LFS 长连接 PUT 反复 E1020 失败，请代为上传。
仓库：wochenlong/lora-scripts-next
版本：3.0.0-alpha（基于 main @ 776d234f）

相关文档：portable-build-guide.md（怎么打包）、portable-1.5-krea2-guide.md（满配说明）。

---

1. 背景（为什么要协作上传）

点	说明
制品	带环境包单文件约 2.2～2.5GB（可选满配更大）
魔搭默认上传	整文件单 blob PUT，几乎无字节级断点；断了常从 0% 重来
本机上行	~1.3MB/s → 单文件暴露 30～40 分钟，易 RemoteDisconnected / SSLEOF
结论	不是偶发，是通道与体积不匹配；有稳定上行（建议 ≥5～10MB/s）或分片工具的人上传更合适

GitHub 上 lite 已由维护者发完；本需求主要针对 魔搭大数据包。

---

2. 目标渠道与路径

渠道	仓库 / 位置	优先级
魔搭数据集（主）	windsing/next-trainer-portable	P0
路径约定	releases/v3.0.0-alpha/<文件名>	必须遵守
Hugging Face（可选）	合作者自有 dataset / model repo，或项目指定仓	P2：上行稳可再挂一份国际镜像
GitHub Release	v3.0.0-alpha	lite 已在；大包一般不塞 GitHub

上传后请在协作群 / Issue / Discussion 回报：直链或数据集路径 + SHA256 + 是否与下表一致。

---

3. 包型与优先级

产品默认策略见构建指南 §1.0：默认带环境 = 只预装 Kohya；Musubi / Fast 为可选项。本 alpha 的上传清单如下。

3.1 必传（P0）

文件	约体积	预装	状态（维护者侧）
Next-Trainer-v3.0.0-alpha-kohya.7z	2.5 GB	Kohya（cu128）；无 Musubi / Fast	本地已打好；魔搭 待上传（本机多次 E1020）
Next-Trainer-v3.0.0-alpha-musubi.7z	2.25 GB	Musubi（Krea2）；无完整 Kohya	本地已打好；魔搭 可能已有（见 §5）

3.2 已由维护者处理（无需再传，除非校验缺失）

文件	约体积	位置
Next-Trainer-v3.0.0-alpha-lite.7z	0.39 GB	GitHub Release v3.0.0-alpha

3.3 能力允许时的加码（P1 / P2）

文件（建议命名）	预装	说明
Next-Trainer-v3.0.0-alpha-kohya-musubi.7z	Kohya + Musubi；无 Fast	可选双引擎一键包；脚本：build_portable_2026_full.ps1
Next-Trainer-v3.0.0-alpha-kohya-musubi-fast.7z	Kohya + Musubi + Anima Fast .venv	额外完整版；体积更大（往往数 GB～10GB+ 级，视 Fast 环境而定）。非正式默认产品线：默认策略是「永不预装 Fast」，本包仅作「有能力的合作者加码」与内测便利

Fast 完整版注意

• 必须写清：含 extensions/anima_lora/.venv，仅内测 / 网盘党便利，正式对外文案仍以「设置页安装 Fast」为准。
• 禁止打入训练底模、个人 data/、Token、doc/local。
• 构建思路：先按指南打 kohya-musubi，再在干净环境安装 Anima Fast 后重新 7z；或使用 build_portable.ps1 -BundleAnimaFast / -AnimaFastSource（需本机已有可用 Fast venv）。细节以 portable-build-guide.md 与 build-scripts/README.md 为准。

---

4. 校验信息（维护者已构建的包）

基线：main @ 776d234f，VERSION=3.0.0-alpha。

文件	SHA256
Next-Trainer-v3.0.0-alpha-lite.7z	9BAD369B0CAEA7D289FA6011275BA2B4F27887169E5020F82AB0A5E8D1CD10D9
Next-Trainer-v3.0.0-alpha-kohya.7z	E519DB1C99A51DE37F8B0BF9160948ED94DBA101C6DD21CC35642AA1F870ABA9
Next-Trainer-v3.0.0-alpha-musubi.7z	4E5EB5E64D6B143D933DA7981DC8C86F7971A01D613F4447848C30128AF4535A

自行重打包时：更新 SHA256，并在回报里写明 git commit 与 PORTABLE_BUILD 内容。

本地获取（与维护者约定网盘 / 内网拷贝即可）：

…/build/Next-Trainer-v3.0.0-alpha-kohya.7z
…/build/Next-Trainer-v3.0.0-alpha-musubi.7z
…/build/Next-Trainer-v3.0.0-alpha-lite.7z   # 一般不必再传魔搭

---

5. 魔搭当前进度（维护者尝试结果，请先核对再传）

路径	维护者侧结果
releases/v3.0.0-alpha/Next-Trainer-v3.0.0-alpha-musubi.7z	曾成功 commit（7875f301…）；上传前请在数据集 Files 里确认是否仍在
releases/v3.0.0-alpha/Next-Trainer-v3.0.0-alpha-kohya.7z	未稳定成功；请优先补传

若 musubi 已存在且 SHA256 一致，可跳过；不一致则覆盖并说明。

---

6. 上传操作建议（减少再失败）

1. 一次只传一个文件（不要双开 kohya + musubi 并行）。
2. 优先用 SDK / CLI 的 folder 或单文件上传；失败整文件重来时换网络或分时段。
3. 若仍不稳：7z 分卷（如 512MB：*.7z.001…），魔搭路径仍放在 releases/v3.0.0-alpha/，并附 README-分卷说明.txt。
4. 上行仍差时：可改走 Hugging Face 作镜像，魔搭只挂说明 + 跳转（需在回报里写清）。
5. 权限：需对 windsing/next-trainer-portable 有写权限；没有则把 7z + SHA256 交给有权限者，或开 Discussion 交接。

示例（单文件）：

modelscope upload windsing/next-trainer-portable `
  .\Next-Trainer-v3.0.0-alpha-kohya.7z `
  releases/v3.0.0-alpha/Next-Trainer-v3.0.0-alpha-kohya.7z `
  --repo-type dataset `
  --commit-message "Add Next-Trainer-v3.0.0-alpha-kohya.7z"

---

7. 验收与回报清单

上传完成后请回复：

• 魔搭路径可点开下载
• 文件名与 §3 一致（或分卷命名已说明）
• SHA256 与 §4 一致（或附新哈希 + commit）
• （可选）kohya-musubi / kohya-musubi-fast 是否已传、体积与哈希
• （可选）Hugging Face 镜像 URL

用户侧解压提醒（可写进数据集 README）：非中文非空格路径；kohya 包双击 启动.bat（2026 根）或 run_gui.bat；不附带训练底模，Anima 权重仍用 Download-Anima-Model.bat / 自备。

---

8. 联系与范围

• 产品 / 发版问题：仓库 Issues / 团队 Discussion
• 本需求范围：代传已有 alpha 大包 + 可选加打满配 / Fast 完整版；不要求合作者改产品默认策略
• 维护者继续保留 lite 的 GitHub 发布；大包以魔搭（及合作者镜像）为准

文档版本：2026-08-20