前言¶

在 DeepSeek Harness（DSH）里做智能体或日常开发时，图像往往散落在对话消息、临时下载目录和各个 SaaS 控制台之间：生成一次就要切窗口，历史结果难以对照，选中一张图再去做图生视频又要重新找文件。常见做法是单独开 fal.ai 网页、本地 ComfyUI，或用脚本把输出写到某个文件夹——能用，但和 Harness 的侧边栏、项目目录、凭证管理是割裂的。

下面介绍社区插件 dsh-image-studio（维护者 naletko）：在 DSH 侧边栏增加独立的 Images 工作区，用 fal.ai 或本机 ComfyUI 出图，结果持久化在本地索引库里浏览与筛选，可在 lightbox 里把选定图交给 Kling 做图生视频，并在 Montage 里用 ffmpeg 拼成一条 h264 成片。插件当前版本为 0.4.1（MIT），分类为工作流；目录页见 SkillHub，源码见 GitHub。

这是什么¶

dsh-image-studio 是面向 DeepSeek Harness 的 Images 工作区插件：一页完成提示词、模型与画幅选择、批量变体生成、图库浏览，以及（可选）对话工具 image_generate 把图写入同一库。它不是聊天里的单条图片附件，而是带图库、模板、蒙太奇时间线的完整页面；右侧栏还可注册 Project media，与终端并排查看同一图库。

核心功能¶

独立 Images 页面¶

安装后侧边栏出现 Images。页面上方是描述框、模型与画幅选择、变体数量（1–8）和 Generate；下方是 Gallery | Templates | Montage，支持按全部 / 图片 / 视频 / 收藏筛选，以及 Import by link、Search prompts。

生成后端：fal.ai 与本地 ComfyUI¶

• fal.ai：内置三类文生图（字段对齐 fal OpenAPI）：fal-ai/flux-2/klein/9b（FLUX.2 Klein 9B）、openai/gpt-image-2（GPT Image 2）、fal-ai/nano-banana-2（Nano Banana 2）。＋ Own model 可把任意 fal 端点 slug（owner/name）写入插件设置并出现在模型列表中。
• Local ComfyUI：Provider 可切到已在运行的 ComfyUI（默认 http://127.0.0.1:8188）；插件不下载模型、工作流或自定义节点。

fal 账号与 API key 用于 fal 路径与 Animate in Kling；仅浏览、按链接导入、蒙太奇、以及纯 ComfyUI 路径不需要 key。

持久化图库与项目媒体¶

生成结果写入磁盘上的 studio 目录及索引，重启后仍在，提供商不可用也可浏览。默认根目录为 <DSH_HOME>/image-studio；页头 Media source 可改为项目内 <project>/dsh-media，截图与片段与代码同目录，切换无需重启 Harness。

Lightbox 与 Kling¶

点击缩略图进入 lightbox：全尺寸查看、下载原图、复制 prompt、标记收藏，或 Animate in Kling 将该静帧交给 Kling 做图生视频。

Montage（ffmpeg）¶

在 Montage 标签把片段与静帧加入时间线，选择 9:16 / 4:5 / 1:1 / 16:9，由宿主先用 ffmpeg 统一尺寸、帧率与像素格式再拼接为 h264；静帧按设定的 hold 时间循环成片段。系统需在 PATH 提供 ffmpeg，或在 row 配置中设置 ffmpegPath；缺少 ffmpeg 时该标签会提示并隐藏相关操作，不影响生成、图库与 Kling。

其他¶

• Templates：8 组中英双语 starter prompt（如 product hero、UGC selfie 等），仅填充提示框，按 Generate 才消耗。
• Import by link：粘贴图片或视频的 http(s) 直链，下载进同一图库。
• 对话工具（可选）：Harness 启用 tools 服务且具备 @deepseek-ai/dsh-tools 时，模型可调用 image_generate，输出进入与页面相同的库。
• 凭证：fal key 经 Harness 凭证接口写入，配置里只存引用名（默认 FAL_API_KEY），页面不会读回密钥明文。
• 界面：俄语 / 英语随界面语言切换。

环境与依赖¶

安装与启用¶

DSH 生态采用「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行。

从 Plugins 页面（推荐）¶

1. 打开 Plugins → Add plugin。
2. 粘贴仓库规格并安装：

github:naletko/dsh-image-studio

本地克隆目录的绝对路径、或在 profile 所用 npm registry 上可用的 bare 名 dsh-image-studio 也可安装。
3. 若页面未要求，可不必重启；侧边栏应出现 Images。

从终端¶

dsh plugin --profile web add github:naletko/dsh-image-studio      # web profile
dsh plugin --profile desktop add github:naletko/dsh-image-studio  # 须完全退出 DSH Desktop
dsh --profile web --dump-config                                   # 不启动即可 compose 配置树

Desktop 应用在运行时会拒绝终端侧的 plugin 管理，请在应用内用 Plugins → Add plugin。卸载：Plugins → Remove，或 dsh plugin --profile web remove dsh-image-studio；图库目录、凭证与其他插件不会被删除。

典型用法¶

按 README Quick start，顺序如下。

1. 安装插件并在侧边栏打开 Images。
2. 在 Settings → Plugins → Images (fal.ai) 粘贴 fal API key（来自 fal.ai → Keys，格式为 key_id:key_secret 整串），点 Save。
3. 输入画面描述，选模型、画幅与变体数，点 Generate。
4. 点击某张结果：在 lightbox 中下载、复制 prompt、收藏，或 Animate in Kling。

需要与代码同仓媒体时，将 Media source 指到项目的 dsh-media；需要短片时切到 Montage 选素材与画幅后导出。

适用场景与注意¶

适合已在 DSH 中开发智能体或日常用 Harness 协作、又需要 fal / ComfyUI 出图并保留可检索历史、偶尔做 Kling 动效或 ffmpeg 拼片的开发者。若只需要单次聊天配图且不关心图库，本插件偏重工作流，未必必要。

注意：ComfyUI 需自行维护服务与模型；Kling 与 fal 生成会产生第三方用量与费用；Montage 依赖本机 ffmpeg。GitHub 仓库星标为 0（截至资料抓取），不代表功能完备度，以 README 与 compatibility.json 为准。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/naletko/dsh-image-studio
• 源码与文档：https://github.com/naletko/dsh-image-studio