README-MOSS.md

MOSS 专用 ComfyUI

从 /marimo 复制非模型文件建立；原目录保留。新实例的模型路径、运行环境、登录配置和备份桶均独立。原有非 MOSS 工作流保存在 inherited-workflows/。

启动

bash /marimo_moss/comfyui.sh --setup-only
bash /marimo_moss/start.sh

访问 http://服务器地址:8189。登录信息由首次初始化生成，查看：sudo cat /var/lib/comfyui-moss-admin/login.txt。ComfyUI 运行于低权限 comfyui 用户；Python 环境在 .venv/。也可使用 MOSS-ComfyUI.ipynb。

模型

Base、SFT、文本编码器和两种 VAE 均来自 Comfy-Org/MOSS-Image，保持原始文件，不量化、不转换。

模型实体只保存在 /marimo_moss 下的公共目录，ComfyUI 和 SD WebUI 的对应目录都是相对软链接：

实体目录	ComfyUI/models 下的链接	sd-webui-forge-neo/models 下的链接
Stable-diffusion	diffusion_models、checkpoints	Stable-diffusion
Lora	loras	Lora
text_encoder	text_encoders	text_encoder
VAE	vae	VAE

实体目录（/marimo_moss 下）	文件	大小（GB）
Stable-diffusion	moss_image_base_bf16.safetensors	10.165
Stable-diffusion	moss_image_sft_bf16.safetensors	10.165
text_encoder	qwen3.5_9b_bf16.safetensors	19.306
VAE	flux2-vae_small.safetensors	0.250
VAE	flux2-vae.safetensors	0.336
Lora	shuiwu22-moss-image-120epoch-000100.safetensors	0.297

LoRA 是用户指定的 100 epoch 文件，触发词 shuiwu22，示例强度 0.6。六个文件合计 40,518,714,704 字节，提交号与 SHA256 记录在 moss-model-manifest.json，下载校验结果在 moss-model-verification.json。

补下载：python /marimo_moss/download_moss.py；完整校验：python /marimo_moss/download_moss.py --verify-only。下载工具需要 aria2c，文件直接写入公共目录，完成后自动补链接。

手动补链接：bash /marimo_moss/restore-model-links.sh；只检查：加 --check。ComfyUI 和 SD WebUI 的启动脚本也会自动补链接。以后新增模型只需放入上述四个公共目录。两边共享文件路径；本次 MOSS 生图验证使用 ComfyUI。

工作流

在 ComfyUI 工作流列表打开 MOSS/，或导入 ComfyUI/user/default/workflows/MOSS/ 中的 JSON：

• MOSS-BASE-BF16.json：Base 文生图。
• MOSS-SFT-BF16.json：SFT 文生图。
• MOSS-BASE-LORA-BF16.json：Base 加指定 LoRA，已启用。
• 四个 Official-BF16-*.json：Comfy-Org 官方 Base/SFT 文生图和布局控制模板的 BF16 适配版；提示词增强默认关闭，可手动开启。
• 三个 MOSS-*-HIRES-BF16.json：Base、SFT、Base＋LoRA 二采本地适配版；首采 1024×1024，放大后再次采样至 1536×1536。参数、来源及使用方法见 MOSS-HIRES.md。

前三个工作流采用 1024×1024、50 步、Euler、sgm_uniform、CFG 3、原生 shift 5、SLG 负分支第 22 层、small VAE。两种 VAE 都已提供，可在 VAELoader 手动切换。官方模板保留其自身采样参数，原始 JSON 在 workflows/official/，来源在 workflow-sources.json。

生图验证

服务运行后执行：/marimo_moss/.venv/bin/python /marimo_moss/validate_moss.py。测试依次运行 Base、Base＋LoRA、SFT，检查执行成功、1024×1024 输出和非空图像，记录 PNG 的 SHA256。结果在 moss-generation-validation.json，图片在 comfyui-output/，完整执行记录在 moss-*-test-history.json。

备份与恢复

bash /marimo_moss/backup.sh --dry-run
bash /marimo_moss/backup.sh
bash /marimo_moss/restore.sh /marimo_moss --dry-run
bash /marimo_moss/restore.sh /marimo_moss

两个脚本固定使用独立私有桶 ACCC1380/molab-moss，拒绝其他 HF_BUCKET，并拒绝对原 /marimo 目录操作。同步始终 delete=False。原 ACCC1380/molab-checkpoints 桶不参与上传或恢复。

备份包含代码、十个可用工作流、归档的参考工作流、来源清单、验证记录及四个公共目录里的模型（目前六个；以后新增到这四个目录的模型也会备份）；程序内部的模型链接路径被排除，避免重复上传。图片、凭据、缓存和 Python 环境不上传。上传前必须有当前模型目录对应的成功 Base/SFT 测试及完整模型校验。

restore.sh 下载完成后自动执行 restore-model-links.sh，为两个程序重建全部九个相对软链接。空环境只需运行恢复脚本，无需手动逐个补链接；目录换位置也适用。然后初始化环境和登录。如果要再次备份，需重新运行生图验证生成本机测试图片。HF 身份来自 HF_TOKEN、本机登录缓存或 .env，不会写入备份。