studio-model-setup
Install and migrate DSH-Spicy in DSH, provision Qwen Image 2.1 and MiniMax H3 on a local machine or remote GPU, and configure the film editor and character library.
Install
npx skills add https://github.com/kingcharleslzy-ai/DSH-Spicy/tree/main/skills/studio-model-setup
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kingcharleslzy-ai-dsh-spicy@llmmart
git clone https://github.com/kingcharleslzy-ai/DSH-Spicy.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kingcharleslzy-ai/dsh-spicy collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
根据实际设备部署
先确定运行 DSH 的机器和 profile、推理机器的操作系统/GPU、要启用图像、视频还是长片,以及是否有现成模型目录。检查磁盘和现有安装,按需要部署。包内文档路径均以安装包根目录为基准。该技能位于根目录下的 skills/studio-model-setup;安装前可从 GitHub 同名文件和根目录 AGENTS.md 阅读。
会话自查。 确认 DSH 会话有可运行、能使用工具的对话模型。首次安装时可按插件名搜索 GitHub,从仓库根目录 AGENTS.md 找到本技能。DSH 显示「暂无可用模型」或 no API key 时,用户需要先在 DSH 模型设置中完成登录或配置凭据;图像网关密钥用于连接图像后端。执行安装后通过同一会话实际交付图片和视频。
先获取现场事实,再选步骤。 在 DSH 端和 GPU 端分别检查系统、架构、驱动、显存/统一内存、可用磁盘、Python 和 DSH 版本、是否已有权重和占用端口。区分“必须完全同机”和“允许自己的远程 GPU”。把硬件、所需功能、预计下载大小和所选后端对应起来。下载前按目标模型卡中的具体文件合计大小;已有文件可按同一 revision 的 SHA-256 验证后复用。共享显卡等待其他任务完成。
Windows 首装先在实际登录的桌面会话运行只读终端命令。若命令连输出都没有,记录退出码,按 Windows 会话与目录诊断 检查账户、TEMP 和 DSH 的启动方式。请保留系统账户原有权限。
Windows 的工作区和 DSH 数据目录可能位于不同磁盘。按空间和实测写权限选择专用子目录,把缓存也放在选定的卷。用户要求图像和视频时,默认先完成图像,再继续视频。宿主所需的安装、目录授权按具体操作申请。详见 选择部署位置。
首装与复用。 在当前 profile 查安装状态,按仓库 Release 的校验清单核对包名、版本和哈希。桌面 Agent 可用 plugin_manager 的 install_bundle 安装校验后的本地 TGZ,随后在当前会话检查创作工具是否已经注册。若要求从零部署,使用独立的运行环境、模型目录、缓存和空闲端口,交付时列出本次实际下载的权重及校验结果。已有可用部署且用户允许复用时,保留原配置,说明哪些组件沿用、哪些由本次安装。第一次出片用当前会话提交新任务,以任务 ID 对应图库原图及视频回执。
随安装查新。 用设备型号、操作系统、当前驱动、模型变体与具体报错搜索上游。优先查 PyTorch 安装选择器、ComfyUI 安装文档与发布说明、MFLUX 的 Qwen21 文档、Hugging Face 发布者的模型卡与文件清单。社区攻略可用于找线索,再核对日期、平台、CUDA wheel、节点类型和权重格式。记录实际用过的来源、提交、包版本及实测结果。若新版更适合设备,在独立环境以同一小样验证,再决定是否采用。改模型须先核对 DSH 工具的接口、工作流节点和输入输出;设备不支持某种后端时,说明具体阻点,给出可行的同机或远程选择供用户决定。
Windows 首装从这里开始:Windows 双模型部署。同机 H3 用 local,图像用回环网关。运行 DSH 的 Windows 机器必须自己完成最后的生成与回放。
- 安装与迁移。DSH 至少 0.2.2-rc.1。用宿主 plugin_manager 的 list_bundles 查包名;安装项目市场的编译版本,或校验 Release TGZ 后使用当前 profile 的包管理器。桌面版优先使用其插件管理页。若之前同时启用 dsh-h3-video 或 dsh-h3-film-local,等待进行中的调用结束,分别停用这两个独立 bundle,启用新版 dsh-qwen-studio 并重新加载。保留旧连接、模型、角色库、工程和附件供续作。失败时可重新启用原包并回退 Qwen 的版本。详细顺序在 AGENTS.md。
- Mac 本机图像。Apple Silicon 用 Python 3.12 执行 scripts/setup-local.sh,设置脚本打印的解释器。按 docs/SETUP.md 准备 MFLUX 可读的完整 Qwen Image 2.1 checkpoint 和需要的共享组件,检查 processor、视觉编码器和权重分片,再配置模型路径。用 qwen_image_connection status 和 qwen_image_resources 读取真实状态。
- 本机或远程 NVIDIA 图像。按 docs/REMOTE.md 安装专用 ComfyUI、三个基础权重及所需可选权重;复制网关、工作流和自定义节点,用自己的私有配置启动网关。DSH 图像选远程模式,即使 GPU 在同机;同机用回环 /v1 地址。异机使用已配公钥的 SSH 别名或用户部署的受保护网关。读取能力接口,再确认当前后端支持所需编辑模式。
- 本机或远程视频 GPU。按 docs/H3-SETUP.md 在 Windows NVIDIA 主机准备 ComfyUI 和工作流要求的权重,用随包 scripts/check-h3-models.py 对实际 /object_info 核对节点和文件名。DSH 与 GPU 同在 Windows 时 transport=local,异机时 transport=ssh。两种模式都使用 GPU 主机的 Python 和 studioDir 的绝对路径。H3 直接使用自己的 ComfyUI;Qwen 的 /v1 地址只用于图像。缺少 Turbo LoRA 或 Ref2VA 时只报告相应档位,不覆盖其他可用档位。
- 长片。在执行剪辑的 DSH 机器配置 Python、Pillow、PyYAML、FFmpeg/ffprobe 和可写工程目录。内置桥接使用 POSIX 文件锁,macOS 支持系统旁白。沿用旧工程时保持 project_root、data_home 与素材卷;新装使用包内桥接,film.json 示例及依赖自查见 docs/H3-SETUP.md。h3_character_list 可检查桥接,h3_film_status 可按已知 ID 检查原工程。
- 验收。区分工具已注册、模型文件已识别、实际成功生成。用户要求出样时先交付一张完成图或一个最短可用样镜,再做目标档位;返回真实任务 ID 和附件。排查按「profile → 连接 → 权重/节点 → 任务」逐层定位。共享 GPU 时串行提交,不通过另一个后端重复生成。保留私有配置,只报告所需且已脱敏的状态。
日常使用读 studio-creation、qwen-image、h3-video 或 h3-long-film。已部署环境只调整本次所需设置。
Files (dsh-spicy)
-
SKILL.md 6.6 KB
--- name: studio-model-setup description: Install and migrate DSH-Spicy in DSH, provision Qwen Image 2.1 and MiniMax H3 on a local machine or remote GPU, and configure the film editor and character library. whenToUse: 安装或升级创作插件、准备图像或视频模型、配置 GPU 或 SSH、长片环境、排查模型缺失及首次运行时使用。 --- # 根据实际设备部署 先确定运行 DSH 的机器和 profile、推理机器的操作系统/GPU、要启用图像、视频还是长片,以及是否有现成模型目录。检查磁盘和现有安装,按需要部署。包内文档路径均以安装包根目录为基准。该技能位于根目录下的 skills/studio-model-setup;安装前可从 GitHub 同名文件和根目录 AGENTS.md 阅读。 **会话自查。** 确认 DSH 会话有可运行、能使用工具的对话模型。首次安装时可按插件名搜索 GitHub,从仓库根目录 AGENTS.md 找到本技能。DSH 显示「暂无可用模型」或 `no API key` 时,用户需要先在 DSH 模型设置中完成登录或配置凭据;图像网关密钥用于连接图像后端。执行安装后通过同一会话实际交付图片和视频。 **先获取现场事实,再选步骤。** 在 DSH 端和 GPU 端分别检查系统、架构、驱动、显存/统一内存、可用磁盘、Python 和 DSH 版本、是否已有权重和占用端口。区分“必须完全同机”和“允许自己的远程 GPU”。把硬件、所需功能、预计下载大小和所选后端对应起来。下载前按目标模型卡中的具体文件合计大小;已有文件可按同一 revision 的 SHA-256 验证后复用。共享显卡等待其他任务完成。 Windows 首装先在实际登录的桌面会话运行只读终端命令。若命令连输出都没有,记录退出码,按 [Windows 会话与目录诊断](../../docs/WINDOWS-LOCAL.md#让自己的-ai-代装) 检查账户、TEMP 和 DSH 的启动方式。请保留系统账户原有权限。 Windows 的工作区和 DSH 数据目录可能位于不同磁盘。按空间和实测写权限选择专用子目录,把缓存也放在选定的卷。用户要求图像和视频时,默认先完成图像,再继续视频。宿主所需的安装、目录授权按具体操作申请。详见 [选择部署位置](../../docs/WINDOWS-LOCAL.md#1-确认设备安装-dsh)。 **首装与复用。** 在当前 profile 查安装状态,按仓库 Release 的校验清单核对包名、版本和哈希。桌面 Agent 可用 `plugin_manager` 的 `install_bundle` 安装校验后的本地 TGZ,随后在当前会话检查创作工具是否已经注册。若要求从零部署,使用独立的运行环境、模型目录、缓存和空闲端口,交付时列出本次实际下载的权重及校验结果。已有可用部署且用户允许复用时,保留原配置,说明哪些组件沿用、哪些由本次安装。第一次出片用当前会话提交新任务,以任务 ID 对应图库原图及视频回执。 **随安装查新。** 用设备型号、操作系统、当前驱动、模型变体与具体报错搜索上游。优先查 PyTorch 安装选择器、ComfyUI 安装文档与发布说明、MFLUX 的 Qwen21 文档、Hugging Face 发布者的模型卡与文件清单。社区攻略可用于找线索,再核对日期、平台、CUDA wheel、节点类型和权重格式。记录实际用过的来源、提交、包版本及实测结果。若新版更适合设备,在独立环境以同一小样验证,再决定是否采用。改模型须先核对 DSH 工具的接口、工作流节点和输入输出;设备不支持某种后端时,说明具体阻点,给出可行的同机或远程选择供用户决定。 **Windows 首装从这里开始**:[Windows 双模型部署](../../docs/WINDOWS-LOCAL.md)。同机 H3 用 local,图像用回环网关。运行 DSH 的 Windows 机器必须自己完成最后的生成与回放。 1. **安装与迁移**。DSH 至少 0.2.2-rc.1。用宿主 plugin_manager 的 list_bundles 查包名;安装项目市场的编译版本,或校验 Release TGZ 后使用当前 profile 的包管理器。桌面版优先使用其插件管理页。若之前同时启用 dsh-h3-video 或 dsh-h3-film-local,等待进行中的调用结束,分别停用这两个独立 bundle,启用新版 dsh-qwen-studio 并重新加载。保留旧连接、模型、角色库、工程和附件供续作。失败时可重新启用原包并回退 Qwen 的版本。详细顺序在 AGENTS.md。 2. **Mac 本机图像**。Apple Silicon 用 Python 3.12 执行 scripts/setup-local.sh,设置脚本打印的解释器。按 docs/SETUP.md 准备 MFLUX 可读的完整 Qwen Image 2.1 checkpoint 和需要的共享组件,检查 processor、视觉编码器和权重分片,再配置模型路径。用 qwen_image_connection status 和 qwen_image_resources 读取真实状态。 3. **本机或远程 NVIDIA 图像**。按 docs/REMOTE.md 安装专用 ComfyUI、三个基础权重及所需可选权重;复制网关、工作流和自定义节点,用自己的私有配置启动网关。DSH 图像选远程模式,即使 GPU 在同机;同机用回环 /v1 地址。异机使用已配公钥的 SSH 别名或用户部署的受保护网关。读取能力接口,再确认当前后端支持所需编辑模式。 4. **本机或远程视频 GPU**。按 docs/H3-SETUP.md 在 Windows NVIDIA 主机准备 ComfyUI 和工作流要求的权重,用随包 scripts/check-h3-models.py 对实际 /object_info 核对节点和文件名。DSH 与 GPU 同在 Windows 时 transport=local,异机时 transport=ssh。两种模式都使用 GPU 主机的 Python 和 studioDir 的绝对路径。H3 直接使用自己的 ComfyUI;Qwen 的 /v1 地址只用于图像。缺少 Turbo LoRA 或 Ref2VA 时只报告相应档位,不覆盖其他可用档位。 5. **长片**。在执行剪辑的 DSH 机器配置 Python、Pillow、PyYAML、FFmpeg/ffprobe 和可写工程目录。内置桥接使用 POSIX 文件锁,macOS 支持系统旁白。沿用旧工程时保持 project_root、data_home 与素材卷;新装使用包内桥接,film.json 示例及依赖自查见 docs/H3-SETUP.md。h3_character_list 可检查桥接,h3_film_status 可按已知 ID 检查原工程。 6. **验收**。区分工具已注册、模型文件已识别、实际成功生成。用户要求出样时先交付一张完成图或一个最短可用样镜,再做目标档位;返回真实任务 ID 和附件。排查按「profile → 连接 → 权重/节点 → 任务」逐层定位。共享 GPU 时串行提交,不通过另一个后端重复生成。保留私有配置,只报告所需且已脱敏的状态。 日常使用读 studio-creation、qwen-image、h3-video 或 h3-long-film。已部署环境只调整本次所需设置。
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.