前言¶
在 DeepSeek Harness(DSH)里做视频相关智能体时,常见做法是手写一长段提示词,或从文档里复制各平台的写法再改。可灵要五段式、海螺要在句首写 [Push in] 括号运镜、MiniMax H3 要拆 [Shot N] 并单独写音景与配乐、Sora 2 则要英文并显式声明 Audio:。同一创意换平台,往往等于重写一遍结构,而不是改几个词。
PromptReel 把各平台差异沉淀成 15 套独立模板:填一次创意、主体、动作与场景,得到按所选平台重排的整体提示词,以及景别递进、运镜不重复的分镜脚本。仓库同时提供网页、CLI 与 MCP;作为 DSH 插件时,在 Harness 内注册 Skill 与原生工具,与 CLI、MCP 共用同一套组装引擎,不另起 MCP 服务、不联网。
这是什么¶
PromptReel 是维护者 Thanksgiver233 开源的「视频提示词中枢」,分类上属于工作流类能力。它解决的是跨平台反复查找、改写模板的问题:不是往同一个填空模板里塞词,而是按每个模型的结构 + 能力位重新组装。
当前内置 15 个平台模板:可灵 AI、即梦 Seedance、海螺 Hailuo、MiniMax H3、Muse、通义万相、混元视频、智谱清影、Vidu、PixVerse、Runway Gen-4.5、Luma、Pika、Sora 2、Veo 3.1。项目为 MIT 许可证,核心组装逻辑零依赖(网页可双击 index.html 使用;DSH 插件包名 promptreel-dsh,版本 0.1.0,README 记载已在 DSH 0.2.1-rc.2 上实测)。
社区目录页:https://www.skillhub.cn/plugins/Thanksgiver233/PromptReel
源码:https://github.com/Thanksgiver233/PromptReel
核心功能¶
平台差异,而不是统一填空¶
README 用表格说明各平台语言与结构特点(节选逻辑):可灵为中文五段式且负向词独立;海螺运镜用括号指令写在句首;MiniMax H3 为英文 [Shot N] 分镜加 overall_soundscape / non_diegetic_music;Sora 2 写起点与终点并显式 Audio:;Veo 3.1 音效写具体拟音、台词加引号,等等。输入侧统一为创意、主体、动作、场景及可选的风格、光影、运镜等字段;输出侧按平台能力自动显隐负向词、音效、配乐等项。
三种交付形态¶
- 整体提示词:可直接粘贴到对应视频产品。
- 分镜脚本:自动配景别递进(远景→特写)与不重复运镜;
--action中用逗号分隔的动作节点会拆成多个分镜。 - 结构化 JSON:便于脚本或下游工具消费。
除网页外,同一引擎通过 shared/engine.mjs 供 CLI 与 MCP 使用;仓库用 scripts/parity.mjs 校验网页版与 CLI 版字段一致。
DSH 插件侧能力¶
安装 DSH 插件后(说明见仓库 docs/dsh.md),会注册 promptreel Skill 与 5 个原生工具,与 MCP 工具名对应:
promptreel_list_platformsgenerate_promptgenerate_allget_platform_templatelist_lexicon
智能体可在对话中选平台、生成单平台或全平台结果、查阅模板与词库,而无需在 Harness 里再配置独立的 MCP 进程。插件依赖 Node.js >= 18,peer 依赖 @deepseek-ai/cordis ~4.0.5 及 DSH 0.2.1-rc.2 配套的 skill/tools 包。
安装与启用¶
DSH 社区插件通过 profile 安装;README 给出的命令如下(勿自行改 owner/repo 拼写):
dsh plugin --profile web add github:Thanksgiver233/PromptReel
安装前建议通读仓库源码与 MIT 许可证。插件在当前 dsh 进程的权限下运行,会加载 Skill 与工具实现;若环境对第三方插件有策略,应先审阅 lib/、shared/ 与 cordis.patch.yml 再启用。
典型用法¶
在 DSH 对话中¶
启用插件后,可先让智能体列出平台,再指定平台与创意字段生成提示词。字段语义与 CLI 一致,例如主体、动作(逗号分隔多动作)、场景、风格、光影、运镜、画幅比例、时长、分镜数量等(具体以工具 schema 与 skill/SKILL.md 为准)。
与 README 对齐的 CLI 示例(便于对照输出)¶
未装 DSH 时,也可在克隆后的仓库里用 CLI 验证同一引擎的行为:
node shared/cli.mjs --list
node shared/cli.mjs -p kling \
-b "雨夜霓虹街头,女黑客抬头看见全息鲸鱼" \
--subject "穿黑风衣的年轻女黑客" \
--action "穿过人群,停下抬头,雨水滑落" \
--scene "午夜赛博都市街道,霓虹招牌,积水倒影" \
--style "赛博朋克,电影级写实" --light "霓虹侧光,雨夜反光" \
--camera "缓慢推近" --ratio 16:9 -d 5 -n 4 --format md
同一创意输出全平台 JSON:
node shared/cli.mjs -p all -b "手冲咖啡慢镜头,水汽升腾" --format json
网页与自定义模板¶
双击 index.html 可在浏览器中切换平台、生成整体提示词 / 分镜 / JSON;数据存 localStorage,可导出导入 JSON。「以此模板新建」可克隆内置平台再改,适合团队内部模型或约定写法。平台官方能力会持续变化,模板内版本号为撰写时参考,非对官方规格的承诺。
适用场景与注意¶
适合:需要在多个 AI 视频平台之间切换、又希望保留同一创意语义的内容团队;在 DSH 里做「写脚本 → 出分镜 → 按平台出词」工作流的智能体开发者。
注意:
- 插件不联网,模板与词库随安装包走;更新平台规则需关注仓库版本或自行改
src/platforms.js后构建(改平台流程见CONTRIBUTING.md)。 - Skill 目录
skill/含给 agent 的方法论与references/变量表,可与原生工具配合,减少平台约束说明遗漏。 - 若同时使用独立 MCP 客户端,也可运行
node mcp/server.mjs(stdio);DSH 插件路径则优先用内置工具,避免重复拉起服务。
结尾¶
PromptReel 把「同一创意、多套平台写法」收成可重复执行的组装流程;装进 DSH 后,智能体可直接调用列表、生成与模板查询,而不用每次从文档里拼结构。需要浏览说明或提 issue 时,见社区目录页与 GitHub 仓库:
- https://www.skillhub.cn/plugins/Thanksgiver233/PromptReel
- https://github.com/Thanksgiver233/PromptReel