前言¶

在 DSH 里做长链路创作时，剧本、分镜、角色素材和生成任务往往散在不同工具里，会话侧也难以看到真实的生成进度或失败原因。若只想在桌面环境里用统一界面组织这些内容，并把当前 DSH 会话和工作室状态对齐，就需要一个面向客户端的 Studio 适配层，而不是在插件里再塞一套完整后端。

下面介绍社区插件 dsh-studio-media（维护者 1997liuyh-boop，分类：客户端）。它是 Toonflow 的 Studio 适配器：上游版本固定在仓库 UPSTREAM.json 中，插件本身负责无限画布、工作流衔接，以及与已绑定 DSH 会话的消息、流式回复、工具结果和停止状态桥接。插件不自带 Toonflow 服务、数据库、模型提供方或存储，这些需按上游文档自行部署。

这是什么¶

• 仓库：https://github.com/1997liuyh-boop/dsh-studio-media
• 当前版本（package.json）：0.2.5
• 许可证：MIT
• 定位：在 DSH Desktop 中打开 Toonflow 工作室界面，连接本地或自建的 Toonflow 服务实例；与可选同伴插件 dsh-studio-projects、dsh-worktable 同属 Studio 生态（二者为可选 peer 依赖）。

目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-media。

核心功能¶

依据仓库 README，适配器提供的能力包括：

1. 在无限画布上组织剧本、分镜、角色、场景与可复用素材。
2. 在原应用工作流中保留故事、场景、镜头与制作备注。
3. 调用已配置的图片、视频生成任务，并展示真实进度或失败详情。
4. 将已绑定的 DSH 会话与消息、流式回复、模型状态、工具结果及停止状态桥接。
5. 当 Toonflow 或其数据库不可用时展示服务状态与重试控件；不以示例数据作为连接成功的信号。

适配器不包含个人数据、账号、生成配额或外部服务实现；数据库与生成任务仍由 Toonflow 侧负责。第三方与上游说明见 UPSTREAM.json、THIRD_PARTY_NOTICES.md。

环境要求¶

package.json 中声明：

• Node：>=22
• DSH 引擎：0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2
• 兼容性标注：对 dsh 0.2.1-rc.2 为 experimental

客户端注入 @deepseek-ai/dsh-client-ui-slots，平台为 web；包内通过 cordis.patch.yml 参与 bundle 补丁。

安装与启用¶

安装前需完全退出 DSH Desktop，再通过官方 Desktop 插件管理器执行 README 中的命令：先安装控制包 dsh-studio-library，再安装本插件的固定标签。

将 <Desktop install directory> 替换为本机 Desktop 安装目录：

& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-library#v0.1.3"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:1997liuyh-boop/dsh-studio-media#v0.2.5"
& "<Desktop install directory>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop list

安装后核对：main 为 lib/index.js，exports./client 为 lib/client.js，dsh.bundle.patch 为 ./cordis.patch.yml，以及构建产物中的 static 入口。Toonflow 服务、数据库、模型提供方与存储需单独配置，然后重启 Desktop。

Toonflow 服务与连接配置¶

插件不包含 Toonflow 服务本体。在新绝对路径下准备 README 锁定的上游源码，再按上游文档安装依赖并启动服务。README 示例：

node scripts/prepare-upstream.mjs media "C:\work\toonflow"

上述命令在 README 中随插件仓库提供；在新绝对路径执行 prepare-upstream.mjs 后，须按上游 Toonflow 文档完成依赖安装与启动。

在 DSH 宿主机配置 Toonflow 地址：

• 配置项：toonflowUrl
• 或环境变量：DSH_STUDIO_TOONFLOW_URL（服务 origin）

默认 origin 为 http://127.0.0.1:33101。打开 Studio 前，上游服务、数据库、模型提供方与存储均需已运行。

适用场景与注意¶

适合谁：需要在 DSH Desktop 里做动画/分镜类创作编排，并愿意自建或本地运行 Toonflow 上游栈的开发者；若还要项目编排或工作台能力，可额外安装 dsh-studio-projects、dsh-worktable（README 与 package.json 均标明为可选）。

使用前请留意：

1. 插件在当前 DSH 进程权限下运行，安装前请阅读源码与 MIT 许可证，并确认 patches/、UPSTREAM.json 中的上游修订记录。
2. 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，版本以 GitHub 标签与 package.json 为准。
3. 仓库公开星标数为 0（以目录页展示为准），不代表功能完备度；问题反馈可走 GitHub Issues。

结尾¶

dsh-studio-media 把 Toonflow 的无限画布与生成工作流嵌进 DSH 客户端，并显式区分「Studio 适配」与「自管 Toonflow 后端」。按 README 顺序安装 library 与本插件、部署 Toonflow、配置 toonflowUrl 或 DSH_STUDIO_TOONFLOW_URL 后，即可在桌面会话边创作边查看真实服务状态。

• 目录页：https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-media
• GitHub：https://github.com/1997liuyh-boop/dsh-studio-media