前言¶

在 DSH（DeepSeek Harness）里做智能体或工作流时，常见需求是把「发现片源、管理播放源、续播、局域网投屏」收进同一套可嵌入的界面，而不是另开独立桌面应用或手写桥接页。单独跑一套 CineFlow 服务可以完成这些事，但要和 DSH 工作桌（worktable）的容器、项目插件对齐，往往需要自己维护嵌入页与桥接。

dsh-studio-cineflow 由维护者 1997liuyh-boop 发布，归类为工作流插件。它将上游 CineFlow 适配为可独立安装的 DSH studio：插件拥有嵌入的 CineFlow 页面与桥接集成；DSH 工作桌提供 studio 容器，外部 CineFlow 服务及其数据仍由用户单独管理。社区目录见 SkillHub 插件页，源码见 GitHub 仓库。

这是什么¶

一句话定位：CineFlow 影音工作室插件——在电影、剧集、动漫的发现与片源管理、播放续播、局域网投屏等流程上，与 DSH 工作桌集成。

• 仓库名：dsh-studio-cineflow
• 维护者：1997liuyh-boop
• 上游应用：incldue/CineFlow（本适配记录见仓库内 UPSTREAM.json）
• 许可证：本 DSH 适配为 MIT（上游应用亦为 MIT）

核心功能¶

下列能力均来自仓库 README 说明，无 TMDB 或片源凭据时不会伪造推荐数据，失败状态以真实状态展示而非样例数据顶替。

1. 浏览推荐与分类片库（电影、剧集、动漫）。
2. 按标题搜索；按地区、类型、日期区间、热度、评分、上映顺序筛选。
3. 导入、去重、测试、启用、移除播放源，并保留源元数据。
4. 记录播放历史、从保存位置续播；在支持时选择字幕与清晰度。
5. 向同网段兼容设备投屏播放。
6. 窄窗口下保持嵌入布局可用，列表、详情、设置区域支持内部滚动。

安装与启用¶

仓库在 package.json 中通过 dsh.bundle.patch 声明 DSH bundle。官方做法是在 DSH Desktop 插件管理器 中安装：先添加控制包，再添加本插件的指定标签源。

github:1997liuyh-boop/dsh-studio-library#v0.1.3
github:1997liuyh-boop/dsh-studio-cineflow#v0.2.9

安装后请在插件管理器中确认已列出 dsh-studio-cineflow（README 要求确认版本为 0.2.2），再打开 CineFlow。包声明需要兼容的 dsh-worktable ^0.6.0 与 dsh-studio-projects ^0.5.0，由上述控制包（dsh-studio-library）提供。

package.json 中 engines 写明 Node.js >=22，DSH 引擎为 0.2.1-rc.2 || >=0.2.2-rc.1 <0.2.2。若在 Windows 上做开发与安装校验，README 建议使用 Node.js 22 与 npm：

npm install --include=dev --legacy-peer-deps
npm run build
npm run check

Windows 服务启动脚本为 scripts/start.ps1，需 PowerShell 7.4+；未捆绑 Electron，需通过 -ElectronPath 或环境变量 DSH_STUDIO_ELECTRON 指定本地 Electron 可执行文件。共享库构建器可用 node scripts/build.mjs cineflow 构建本仓库。

典型用法¶

安装并确认依赖后，在工作桌中打开 CineFlow studio 即可使用嵌入界面，流程可按 README 归纳如下。

1. 发现与筛选：在推荐与分类库中浏览；用搜索与筛选条件缩小范围。
2. 片源管理：导入播放源 → 去重与连通性测试 → 启用或移除；凭据与元数据由用户在插件/服务侧配置，插件不提供流媒体密钥。
3. 播放与续播：从历史记录恢复进度；按需选择字幕与画质（取决于源与支持情况）。
4. 投屏：确保播放端与目标设备在同一局域网，且设备兼容投屏协议。

TMDB 凭据、片源凭据、外部媒体服务与投屏设备均由用户自行配置。无 TMDB 凭据时 studio 使用公开列表模式。片源可能过期或需要认证；投屏需同网兼容设备。插件不会自动启动广播，也不会代为安装外部 Electron 服务与数据库。

适用场景与注意¶

适合谁

• 已在用 DSH 工作桌，希望把影视发现、源管理、续播、投屏收进同一工作台容器的开发者或个人用户。
• 愿意自行维护 TMDB、播放源与（可选）外部 CineFlow/Electron 服务的部署与凭据。

运行与权限

插件在 当前 DSH 进程权限 下运行；安装前请阅读仓库源码、LICENSE、THIRD_PARTY_NOTICES.md 与 UPSTREAM.json，确认适配范围与第三方声明。社区目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。

限制（README 明确要求）

• 不内置流媒体密钥，不自动开始广播。
• 不捆绑安装外部 Electron 服务与数据库。

来源与版本¶

• 应用源码追溯至 incldue/CineFlow 提交 b32fd8a6ba43dcde4494b7487ebf5d949f65a306，版本 3.4.4。
• 本仓库 package.json 版本为 0.2.9；安装标签使用 #v0.2.9，插件管理器展示版本以 README 核对项为准。

更多信息与问题反馈：https://github.com/1997liuyh-boop/dsh-studio-cineflow · https://www.skillhub.cn/plugins/1997liuyh-boop/dsh-studio-cineflow