dsh-infinite_canvas

无限画布（DeepSeek Harness 版）

DeepSeek Harness 内的节点式短剧工作室。 从一句话创意出发，在无限画布上完成剧本、分镜、角色资产、画面生成、视频生成，直到带转场、字幕、配音的成片。

English | 简体中文 · 操作手册：中文版 · English guide

这是什么？

无限画布是一个 DeepSeek Harness 插件：它在 Web 界面侧边栏加入一个完整的创作工作室。你像导演一样工作——无限画布上的节点连成流水线：剧本、分镜、角色与场景资产、图片生成、视频生成，最终在成片节点完成转场、字幕与配音。

全部本地运行于你的 Harness。生成后端自带或自配均可；未配置任何 API 时有内置演示模式，整条流水线离线可学可测。

用对话驱动画布

画布与对话共享同一个"大脑"。每个节点都是一个 AI 工位，而对话侧就是导演：用自然语言下指令，Agent 替你操作画布工具——批量工作尤其如此。

「创建一个叫《时空邮递员》的项目，先写世界观和设定集。」 「根据设定集写第一集。」→ 剧本节点生成一整集（60–120 秒），每个场景带【场N】分场标记。 「把第一集铺开到场景。」→ 每场一个文本节点 + 分镜表节点自动出现并连线。 「把所有角色、场景、道具的参考图都生成了。」→ 十个图片节点一次建好、逐个生成。 「生成场1的视频。」→ 分镜镜头 + 参考图合成一次多镜头视频调用。 「把第一集交给 FilmCraft 渲染 MP4。」→ FCP7 XML + SRT 落盘，Craft 套件接手。

设定集、整集剧本、分镜拆解、成批参考图——这些批量工作正是 Agent 最快的部分。跑完后你只需要在画布上精修真正在意的那 20%：改提示词、调参考图顺序、重掷某一个镜头、从历史里回退旧结果。

案例：门缝里的字条

用上面的流程完整制作的一集。整集铺开后的画布全览——左侧一列图标添加节点，右侧「项目」面板管理当前项目的画布（第1集 / 第2集），资产与设定集在项目内共享：

场1 的镜头组——场1分镜表 → 角色/场景多视图 → 场1视频，节点之间用连线表达参考关系：

节点 + 生成面板：点击节点内容区弹出面板，参考图在顶部缩略图条里可拖拽排序，模型/比例/清晰度/张数一行排开：

设定集弹窗——世界观、风格基调、角色/场景/道具条目，每条都可以绑定参考资产：

资产弹窗——卡片网格，搜索/分类/项目筛选，视频以首帧作为缩略图：

左上角项目名点开是项目下拉：每行显示「项目名 · 画布名」，可直接就地改名，超过 5 个项目自动分页并可跳页：

设置页签——数据根目录、Craft 状态、技能增强（通用专家）、文本模型与图片/视频/TTS 供应商：

快捷键与操作：

帮助与反馈：

制作阶段机与自动创作（实验）

每个画布（一集）都有宿主强制的制作阶段：brief → bible → assets → script → storyboard → shots_ready → generating → qc → post → delivered，配合六道代码闸门（设定集先行 / 分镜质量 / 一表一视频 / 禁逐镜节点 / 破坏性确认 / 阶段越序）。闸门拒绝时会列出确切缺失项，并始终接受用户显式 override（进审计）；宣称"完成"必须以 canvas_production_status 的 ready:true 为据。

打开「自动创作（实验）」开关（设置页）后，对话智能体从一句话创意跑通编剧室：调研 → 编剧A/B 独立提案 → 互评 → 监制决策 → 设定集 → 剧本 → 逐场分镜表（过质量闸门）→ 预算单——全程零付费；批准一次后逐分镜表生成视频并建成片节点。讨论记录落在画布「编剧室会议」节点；该模式下禁止向用户提问。

图片模型：直接用 dsh-image-gen

装了 dsh-image-gen 并配置好模型后，设置页出现「图片模型（来自 dsh-image-gen）」：直接选它的服务商/模型生图——画布侧无需再填 baseURL/API Key，凭据留在 image-gen 侧。

精准布局

canvas_layout_get 读取全图几何；canvas_layout_node 按坐标批量摆放（媒体节点可改尺寸且保持画面比例），并可 pinned 钉住——canvas_relayout 永远不动钉住的节点，簇按带高打包、不再拍成一整列。

在对话旁边工作

画布不是必须切过去的另一个窗口——它可以作为 Harness 右侧面板里的一个页签打开，左边对话、右边分镜，同时进行：在对话里提要求，右边节点实时跟着变。

1. 打开右侧面板（开始），点击 无限画布 卡片。
2. 画布以页签形式出现在对话右侧，与全屏面板共享同一批项目、节点与资产。
3. 需要更大空间时，把右栏拖宽，或用右栏的全屏按钮。

同一时刻只有一个画布实例（共享节点图与生成状态）：在右栏打开时若全屏面板也开着，画布会被移动到右栏而不是复制一份——另一侧显示「把画布切换到这里」按钮。

会话↔画布绑定 + 项目记忆（多集连续创作）

为长篇系列设计：一个工作区 = 一个项目，一个会话 = 一集。

• 输入行绑定——想绑才绑：对话输入行的画布选择器（「选择工作区」同款下拉格式）默认显示「选择画布」。未绑定态菜单 = 仅会话 / 创建项目 / 已有项目列表：点项目展开其子画布，点画布即绑定（也可就地新建子画布）；不点 = 仅会话，编码等任务零打扰，且解绑后不会被任何机制绑回。已绑定态项目锁定，只列本项目的子画布（当前项高亮、占用标「占用中」）+ 新建子画布 + 打开画布 + 仅会话（解绑）。
• 会话 Agent 只操作绑定的那张画布：配合内置「媒体创作」预设，Agent 先用 canvas_my_canvas 自证身份（「本会话 = 某项目第 N 集」），之后所有 canvas_* 工具缺省即作用于本集画布——写节点/连线/触发/删除/改设定集全量可操作。跨画布、跨项目是代码级禁令：显式传其他项目/画布的 id（含同项目其他画布）会被工具直接拒绝（locked），文案指引先解绑；未绑定的会话不受任何限制。
• 项目记忆让 100 集连续不乱套：每集画布有自己的记忆（剧情决策/人物状态变化/伏笔账本），项目级调度索引汇总全部集的标题/摘要/关键词/状态。技能纪律要求 Agent 开写前先读索引与本集记忆、每到一个里程碑必须回写——第 47 集不会重复发明第 12 集已经定下的东西。画布「记忆」页签可随时翻看任何一集的记忆全文。
• 数据跟着工作区走：project.json、canvases/、memory/、bindings.json 全部在 <工作区目录>/.infinite-canvas/ 里——拷走目录 = 搬走整部剧。（媒体文件仍在插件数据根目录。）

3D 导演台（预演）

同一项目里内置的摆位与预演工作台：把真实 glTF 角色与场景陈设摆进场景，用真实机位取景，再把结果作为图片或视频节点导回画布。

• 内置「媒体创作」预设模式：导演第一视角的引导式创作（选透镜 → 定题材/规格/影调 → 一句话故事 → 分镜 → 生成 → ArtCraft 后期），随插件安装、在模式选择器直接可选；附带的导演工作坊技能一次只问一个问题，带新手走完全程。
• 三种模式：静态预演（影棚外观、暂停摆位）、动态预演（影棚外观 + 时间轴播放）、实时渲染（成片外观：日光、阴影、材质，无辅助线）。
• 资产库：人物、树木、家具、建筑、几何体，以及古街陈设（坡屋顶、摊位、石阶），一个搜索栏全覆盖。
• 直接操作：局部轴移动/旋转/缩放操作轴、框选、Alt + 拖轴端方块 = 等比缩放、W/A/S/D + Q/E 键盘漫游（按住 Shift 加速 4 倍）。
• 分镜与时间轴：分镜轨、单镜起止、机位关键帧、缓动曲线、标记、循环播放。
• 机位与光学：FOV、焦段、传感器尺寸、滚筒角联动一致；景别预设直接显示当前构图占比。
• 导出：PNG 截图或 MP4/WebM 预演视频，直接落成画布上的图片/视频节点。

资产与画布共享：你已经生成的角色、树木、家具、建筑，可以直接拿来当预演场景的摆件。

完整操作（资产页签、操作轴、快捷键表、分镜、导出）：操作手册 → 3D 导演台。

技能页：导演 / 题材 / 规格 / 影调

右栏第三个页签「技能」决定整部片怎么拍。它不是提示词模板，而是会被自动拼进每一次剧本、分镜、图片、视频生成的硬约束。页面里没有任何下拉框，全部是图标瓦片，点一下选中、再点一下取消。

四层各管什么

导演（45 位）：华语 16（王家卫、张艺谋、侯孝贤、毕赣、徐克、路阳、袁和平、乌尔善、李安、杨德昌、贾樟柯、姜文、杜琪峰、宁浩、周星驰、王晶）· 日韩 7（黑泽明、朴赞郁、奉俊昊、是枝裕和、李沧东、宫崎骏、新海诚）· 欧美 22（斯皮尔伯格、希区柯克、库布里克、斯科塞斯、费里尼、伯格曼、塔可夫斯基、诺兰、维伦纽瓦、芬奇、雷弗恩、马力克、迈克尔·曼、科恩兄弟、雷德利·斯科特、大卫·林奇、阿方索·卡隆、伊纳里图、韦斯·安德森、乔治·米勒、阿莫多瓦、盖·里奇）。

规格（8 种）：短剧 · 电影质感 · 商业片 · 纪实 · 音乐视频 · 预告 · 解说 · 访谈。

• 短剧是单集 60–180 秒的自足单元，同时覆盖单集与连续多集——一部剧就是一集一集往下做，不需要单独的「连续剧」规格。
• 电影质感是质感规格，不是长片规格：它约束每一镜怎么做才像电影（ASL 1.5 秒以上、24 帧、动机光、真材质），成片长度档只到 30–300 秒。原因很实际——AI 视频模型单次只出 3–8 秒（本插件默认 5 秒），所谓「一部 120 分钟的电影」只能是几百上千个片段接起来。
• 商业片把「宣传片 / 广告片 / 产品片」合成一张卡——它们是相近需求，靠段位配比内部分流。

画幅不在技能里决定

横屏、竖屏、方屏、宽银幕都能用任何规格——画幅与分辨率是视频节点生成时的选项。短剧竖屏投放很常见，但那是发行选择，不是创作规格；短剧同样可以横屏、可以按电影标准拍。

注入到哪

四层全空时什么都不注入——老项目行为完全不变。

三个按钮

• 预览：显示当前配置注入到剧本的切片全文与字节数
• 写设定集：把风格摘要写进设定集的「风格基调」，对话侧也能读到
• 清空：四层归零，生成行为回到默认

对话侧同样生效

配置存在项目文档里（与设定集同一套同步机制），所以对话侧读得到、面板上也看得到。在对话里说「用王家卫的风格拍这段」，Agent 会调 canvas_list_skills 看有哪些技能、再调 canvas_skill_pack 取对应切片——和画布自生成用的是同一套口径。

完整说明见 操作手册 → 技能页。

工作方式

flowchart LR
    A[剧本节点<br>一集 · 场景标记] --> B[铺开到场景<br>每场 文本+分镜表]
    B --> C[每场多镜头视频<br>镜头+参考图一次生成]
    C --> D[尾帧串联<br>场N尾帧 → 场N+1首帧]
    A --> E[参考图生成<br>角色 · 场景 · 道具]
    E --> C
    D --> F[成片 / FilmCraft<br>转场 · 字幕 · 配音]

核心亮点

角色一致，跨镜跨集

项目级设定集（风格基调 + 角色/场景/道具卡）注入每一次 AI 调用，服装、场景、道具跨镜跨集保持一致。提示词里的 @名称 自动携带该实体的设定描述与参考资产。每次分镜生成后一致性检查会标出未登记实体，Agent 自动补全。

参考图真正绑定

参考图以有序、可见的列表连线（[图1] 角色：陈拾、[图2] 场景：褶皱巷），这个顺序就是到达模型的顺序。多角色画面不再含糊；Volcano Seedance 的原生 [图N] 约定端到端支持（首帧、最多 4 张参考图、官方任务 API）。

从分镜到可看成片

一个分镜表 = 一次多镜头视频生成。 全部镜头（顺序 + 每镜时长）合成一条提示词，视频模型一次调用渲染整段——硬切由模型完成，没有逐镜拼接的接缝。每场 ≤ 15 秒，多场之间用尾帧 → 首帧串联。成片节点按顺序拼接片段——交叉溶解或黑场转场、烧录字幕、原声与 TTS 配音混音——即时导出预览版；接 ArtCraft（FilmCraft）则写出 FCP7 XML 时间线 + SRT 渲染真正的 MP4。

编辑器级画布

平移缩放、框选、对齐参考线、可折叠分组、小地图、60 步撤销重做、节点媒体历史（最近 8 次）、蒙版局部重绘、全要素中键——画布应该像剪辑软件，不像聊天侧栏。

模型自带或自配

文本模型直接来自 Harness（无额外 Key）。图片/视频后端采用供应商 + 模型两级结构：供应商配一次（地址、Key、可选的厂商专属扩展参数 JSON），下面挂任意多个模型 ID，点 ★ 星标作为默认路由。视频端点自动适配——OpenAI 风格任务接口、Seedance 原生 content[]、Sora 风格 /v1/videos 由自动降级链覆盖，分辨率/比例/首帧/参考图按厂商惯例映射，超大参考图发送前自动压缩。所有网关调用经本地 Harness 宿主进程转发（无浏览器 CORS 限制）。什么都没配？演示模式本地合成占位图与动画视频，整条流水线离线可测。

便携数据根目录

设置一次数据根目录，所有数据按项目名落盘：节点与设定集在 project.json，资产索引在 assets.json，媒体在 image/ video/ audio/ text/，Craft 后期产物在 craft/。换电脑 = 复制文件夹：新机器把数据根目录指过去，所有项目（资产、设定集、媒体）自动识别——另有**「从数据根导入」**一键合并。把目录放进网盘同步文件夹，多台机器自动保持一致。

快速开始

1. 安装插件（bundle 目录）并重启一次 Harness。
2. 点侧边栏 Infinite Canvas，在设置里配好数据根目录。
3. 对话：「创建一个项目叫〈你的创意〉，先写世界观和设定集。」
4. 「写第一集。」 → 剧本节点生成带【场N】标记的一集 → 点铺开到场景（或让 Agent 做），得到每场的文本+分镜表组合。
5. 「把所有角色、场景、道具的参考图生成了。」 → 一批命名规范、与设定集一致的资产图。
6. 「生成场1的视频。」 → 分镜镜头 + 参考图合成一次多镜头调用；场与场之间尾帧串联。
7. 打开成片节点导出预览版，或交给 FilmCraft 渲染正式 MP4。

未配置任何生成 API 时，全部步骤以演示模式运行——整条流水线离线可用。

完整的图文教程（含截图、模型配置与数据目录迁移）见中文操作手册。

生成后端

所有网关调用由本地 Harness 宿主进程转发（无浏览器 CORS 限制）——任何 OpenAI 风格的厂商端点都可用。

ArtCraft 桥接

安装姊妹插件 dsh-artcraft 后，画布可与本地 Craft 家族（PhotoCraft、FilmCraft、EffectCraft、LightCraft、VectorCraft、DesignCraft 等 12 个）经同源 HTTP 协作。把 ArtCraft 的数据根目录指向与画布相同的位置，全部后期产物落在 projects/<项目>/craft/：资产按项目同步、图片支持 PhotoCraft 无头调色（单个/批量）、成片导出 FCP7 XML + SRT 交 FilmCraft 渲染 MP4。设置面板的状态卡为每个 Craft 显示一盏状态灯与 n/n 就绪摘要。

发布（维护者）

维护者手册（红线、分支模型、版本规则）见 RELEASING.md；操作细节见 docs/release.md；已发布变更见 CHANGELOG.md——GitHub Release 正文一律英文，从 changelog 复制。

发布走 npm Trusted Publishing（OIDC）——任何地方都不存在 npm 令牌：

• 发布流程：dev 测试通过并获批准 → 合并进 main → 创建 GitHub Release（tag v0.17.11，…）→ Actions 自动发布该版本。
• publish.yml 工作流内置守卫：release 提交必须在 main 上、tag 必须与 package.json 一致，然后带 provenance 徽章发布。

数据与隐私

• 画布文档、项目与设置存于浏览器 localStorage（dsh-ic:*）；资产元数据存于 IndexedDB（dsh-infinite-canvas）；设置数据根目录后媒体文件落盘（按项目名分目录，插件后端带 HTTP Range 支持视频拖动）。
• AI 文本生成经 Harness 宿主进程（用你已配置的模型，无额外 Key）。
• 图片/视频/TTS 网关调用由本地 Harness 宿主进程转发（规避浏览器 CORS）；你的端点与 Key 都留在本地。
• 插件自身不向任何第三方上传数据。

环境与限制

• DeepSeek Harness 0.2.0-rc.2+；演示模式成片导出需要 MediaRecorder（Chromium）。
• 预览成片为实时录制 WebM；多轨剪辑的 MP4 母版请配合 ArtCraft FilmCraft 或任意 NLE。
• 图片 edits/蒙版重绘需要模型支持该端点（如 gpt-image-1）。
• 宿主侧插件更新需重启一次 Harness；Web 半区热加载。

许可证

Apache-2.0