前言¶
在 DSH 里做剧本、分镜、资产和视频相关任务时，常见做法是各开一套本地应用或在对话里零散贴素材，生成、预览和导出状态很难和当前会话对齐。dsh-studio-film 是 DeepSeek Harness 的客户端类工作室插件，把上游 PRINTFILM 能力通过适配层接到 Desktop，用于管理影片项目、媒体资料，并依赖你自行部署的本地 PRINTFILM 服务与数据库。下面按定位、功能、安装与配置说明如何使用。
这是什么¶
- 名称与维护者：
1997liuyh-boop/dsh-studio-film，维护者 1997liuyh-boop；社区目录分类为客户端。 - 一句话定位：PRINTFILM 工作室适配器，面向剧本、分集、分镜、资产管理及视频制作相关任务（仓库描述与
package.json一致）。 - 上游：源码锁定于
https://github.com/yi1108/printfilm，记录在仓库UPSTREAM.json。 - 生态说明：DSH 采用「一切皆插件」思路；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
README 中列出的能力如下，安装后是否完整可用取决于本地 PRINTFILM 服务、数据库与视频生成服务是否已就绪。
- 项目与创作内容：管理项目、故事、场景、角色与制作备注。
- 分集与镜头：组织剧集与镜头，支持画面方向、对白、时长与状态等字段。
- 资产库：管理角色、场景、道具、图像、音频与视频资产。
- 与 DSH 桥接：将原应用的生成、预览、导出与任务状态接入 DSH；通过绑定的 DSH 会话处理消息、模型状态、工具结果与停止操作。
- 故障呈现：真实服务与数据库失败会展示状态并提供重试路径；不以样本数据冒充已连接。
插件不随包提供 PRINTFILM 服务本身，也不负责下载个人项目、导入账号或启动外部服务；第三方应用与资产沿用各自许可证（见 THIRD_PARTY_NOTICES.md）。许可证为 MIT。
安装与启用¶
须先完全退出 DSH Desktop，再通过官方 Desktop 插件管理器安装控制包与本工作室标签。命令须与 README 原文一致（将 <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-film#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 入口存在。
环境与依赖（来自 package.json）：
- Node
>=22 - DSH 引擎：
0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2 - 可选对等依赖：
dsh-studio-projects、dsh-worktable - 当前插件版本：
0.2.5
安装并单独配置 PRINTFILM 服务、数据库与视频生成服务后，重启 Desktop。
PRINTFILM 服务准备¶
插件不包含 PRINTFILM 服务端。在新绝对路径中准备锁定的上游源码，再按上游文档安装依赖并启动服务：
node scripts/prepare-upstream.mjs film "C:\work\printfilm"
将 DSH 宿主配置中的 printfilmUrl 指向服务源，或设置环境变量 DSH_STUDIO_PRINTFILM_URL。默认源为 http://127.0.0.1:33102。打开工作室前，须确保上游服务、数据库与视频生成提供方已在运行。
典型用法与界面侧行为¶
- 按上一节完成插件与服务配置后，在 Desktop 中打开影视工作室客户端（Web 平台注入，依赖
@deepseek-ai/dsh-client-ui-slots）。 - 在工作室中维护项目结构、分集分镜与资产，与原 PRINTFILM 工作流一致；生成、预览、导出与任务状态经适配层反映在 DSH 会话中。
- 若服务或数据库不可用，界面停留在状态与重试视图，直至连接恢复。
仓库提供 node scripts/check-install.mjs 用于安装检查，可在排错时参考。
适用场景与注意¶
适合：已在或计划使用 PRINTFILM 链路，并希望在 DSH Desktop 内统一管理项目、媒体资料与本地服务连接的开发者或小团队。
注意：
- 插件以当前 DSH 进程权限运行；安装前应阅读源码与 MIT / 上游许可证，并理解
cordis.patch.yml等补丁对宿主的影响。 - 服务失败时功能限于状态与重试，不会伪造已连接数据。
- 星标与社区简介仅作目录参考；以 GitHub README 与
package.json为准。
结尾¶
dsh-studio-film 把 PRINTFILM 的剧本、分镜、资产与视频任务接到 DSH 客户端，前提是你本地部署并配置好 PRINTFILM 与相关后端。进一步了解可从社区目录与仓库入手：
