一句话定位

deepseek-ivideo 把 iPolloWork 的 HyperFrames Video Studio 作为原生 Video 视图注入 DeepSeek Harness，对话里可以由 AI 直接生成或大范围修改整段视频，也能选中画面里的标题、图片、素材等元素发起 Ask AI 精准修改，最终落到工作区里真实的可编辑 HTML/CSS 项目文件。

核心能力

• 在 DeepSeek Harness 对话标签栏中提供原生 Video 视图（label "Video"），与 Design、PPT 视图并列
• 通过对话让 AI 完整生成或大范围修改视频，并把改动写入当前工作区的真实 HyperFrames 项目文件
• 选中画面中标题、图片、素材或其他元素后用 Ask AI 触发精准修改，插件只准备草稿不自动发送
• 内置 27 个可编辑视频模板（覆盖动态标题、代码讲解、数据图表、产品演示、品牌片头、AI 工作流等），可一键套用到当前会话项目，失败自动回滚
• 提供 ipollowork_video_validate 模型工具，对当前会话的视频项目做结构化校验并返回有限结果
• 每个会话对应独立的 HyperFrames 预览进程，所有 lease 释放 60 秒后自动回收，端口冲突时自动回退

技术实现

• 语言: TypeScript + React（Studio 前端，Vite 构建）+ Node.js（HTTP 桥接与运行时进程管理）
• 关键依赖: @deepseek-ai/cordis（插件注入与 effect）、@deepseek-ai/dsh-host-webserver（路由注册）、@deepseek-ai/dsh-tools（模型工具注册）、@deepseek-ai/dsh-workspace（工作区解析）
• 架构模式: 服务端通过 cordis.patch.yml 把 ipollowork-video-studio 插件插入宿主；apply 阶段在 /ipollowork-video 前缀下注册 webServer 路由（承载 7 个 HTTP API 与 Studio 静态资源），把工作区根、模板目录、项目初始化以及 ipollowork_video_validate 模型工具接到宿主；同时通过 dsh.client.inject 把客户端代码注入到 Harness Web 端，对话里注册 conversation.view slot 渲染承载 Studio 的 iframe；客户端 View 与 Studio 通过 postMessage（channel ipollowork-video-studio-host-v1）交换 ask-ai-selection / ask-video-ai 消息，事件源同时校验 origin 与 source 指向 iframe contentWindow
• 入口文件: packages/deepseek-ivideo/lib/index.js（服务端注册与 HTTP API）、packages/deepseek-ivideo/lib/client.js（前端 Video 视图）、packages/deepseek-ivideo/lib/runtime.js（HyperFrames 进程管理）、packages/deepseek-ivideo/studio/dist/index.html（Studio 静态资源）

适用场景

适合需要在 DeepSeek Harness 工作区里直接产出可编辑视频的用户——做产品演示、数据故事、品牌片头、动态标题、教学片段或社媒短视频。痛点是在普通对话里只能拿到一次性的视频或截图，无法继续精调单一对象；本插件把真实的 HyperFrames 项目落到 video/<sessionId>/，并允许 AI 生成、画布直接编辑、选区级 Ask AI 三种方式交替进行。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:Devin-AXIS/deepseek-design/packages/deepseek-ivideo

配置项

本插件无需用户级配置。安装后插件以 ipollowork-video-studio 标识注入宿主（cordis.patch.yml:1-3），自动在 DSH Web 端注册 Video 视图；运行期每次进程启动用 32 字节随机令牌保护 iframe 通信与 HTTP API 调用（lib/index.js:210），所有读写都限制在当前工作区的 video/<sessionId>/ 目录内（lib/index.js:13-14、93-126）。

常见问题

Q: 这个插件和 deepseek-design 是什么关系？

A: 它是 deepseek-design 套件里的"视频"那一支，专门为 Harness 对话增加一个 Video 视图（README.md:13-17 / source/README.md:48-56）。与兄弟插件 iDesign（Design 视图）和 iPPT（PPT 视图）共享 iPolloWork Studio 契约和模板协议，但项目目录彼此隔离，可以只装这一份。

Q: 装了它会不会顺便下载 iPolloWork 桌面端或其它两个兄弟插件？

A: 不会。npm 包自带 Video 视图所需的浏览器资源（packages/deepseek-ivideo/lib/、packages/deepseek-ivideo/studio/dist/），既不下载 iPolloWork 桌面应用，也不强制安装 iDesign/iPPT；三个插件的项目目录（design/、design/-ippt/、video//）互相隔离，不会相互覆盖。

Q: 视频项目文件保存在哪里？

A: 全部写入 DeepSeek Harness 当前注册工作区的 video/<sessionId>/ 目录（source/shared/types/hyperframes-project.ts:14-16 / source/plugins/deepseek-ivideo/src/runtime.ts:236-247），含 index.html、design-tokens.css、manifest.json、brief.json 等真实可继续手工编辑的文件，不是云端封闭画布；你可以用任意代码编辑器改这些文件，也可以让 AI 通过对话继续修改。

Q: 自带了哪些视频模板？

A: 27 个内置可编辑视频模板，覆盖动态标题、代码讲解、数据图表、产品演示、品牌片头、AI 工作流演示等场景（packages/deepseek-ivideo/lib/templates/*/manifest.json）。模板筛选只放行 surface === "video" 且 category === "video" 的模板（packages/deepseek-ivideo/lib/index.js:20-22），Design 与 PPT 模板不会混入。

Q: Ask AI 会自动发送消息吗？

A: 不会。Ask AI 只把当前视频项目或选中元素的相对路径、CSS 定位、文字/alt/src、计算样式整理成对话草稿填到 Harness 输入框（packages/deepseek-ivideo/lib/client.js:113-128 / source/plugins/deepseek-ivideo/src/client.tsx:20-30），由用户点发送才会提交，插件不自动执行工具调用；选中元素后会通过 postMessage 跨 iframe 通信（channel ipollowork-video-studio-host-v1，origin 与 source 双重校验）把上下文送到 Harness。

Q: 多人同时编辑会互相覆盖吗？

A: 不会。视频文件写入走 writeStudioText 并附带 baseUpdatedAt 版本检查（source/shared/studio-host/src/http.ts:161-163），文件自上次读取后被外部改动会返回 409 冲突提示你重新加载；写入采用临时文件 + rename 实现原子替换，避免半写状态。模板应用也是先在隔离目录校验再原子替换，失败时恢复旧项目并重启 Studio（packages/deepseek-ivideo/lib/index.js:37-82 / README.md:68-75）。

Q: 为什么首版没有语音克隆和 Design System 抽屉？

A: 首版在 Studio 里显式关闭了 features.voice 与 features.designSystem 两个开关（source/plugins/deepseek-ivideo/studio/src/main.tsx:48-54），branding 标题也固定为 iVideo by iPolloWork；这两项属于 iPolloWork 主项目的全局能力，当前版本暂未暴露给 DSH 宿主，仅保留 Video 模板、时间线、可视化编辑、动画、预览和导出能力。需要这些能力的用户需使用 iPolloWork 桌面端。

Q: 如何卸载？

A: 运行 dsh plugin --profile web remove deepseek-ivideo。卸载后 Video 视图会从对话标签栏消失，但工作区中的 video/<sessionId>/ 文件不会被自动删除，如不再需要请手动清理。

上手难度

入门 — 安装后无需配置即可在对话中选择 Video 视图开始创作，AI 生成、画布精调、Ask AI 三种交互在同一个界面里就能完成，不需要写代码或调整配置文件；模板套用、校验、导出都通过 Studio 内置按钮触发。

已知问题与限制

• 首版不内置语音克隆、语音设置与 Design System 抽屉：Studio 中 features.voice 与 features.designSystem 被显式置为 false（source/plugins/deepseek-ivideo/studio/src/main.tsx:48-54），需要这些能力的用户需使用 iPolloWork 桌面端。
• 仅能读写 video/<sessionId>/ 子目录：所有 API 都通过 safeRelativePath 强制把路径限制在 video/ 前缀下（packages/deepseek-ivideo/lib/index.js:13-14 / source/shared/studio-host/src/http.ts:46-60），工作区其它目录不会被插件访问；跨工作区的符号链接也会被拒绝（source/shared/studio-host/src/http.ts:80-95）。
• 单文件体积上限 4 MB：视频项目的 index.html 等文本读取与写入受 MAX_TEXT_BYTES = 4 * 1024 * 1024 约束（packages/deepseek-ivideo/lib/index.js:14、94-125），HTTP 请求体上限仍是 20 MB（source/shared/studio-host/src/http.ts:10、187），超出时返回 413。
• Session ID 格式受限：必须匹配 ^[A-Za-z0-9_-]{1,128}$（packages/deepseek-ivideo/lib/index.js:13），过长或带特殊字符的会话 ID 会直接返回 400。
• 端口分配在 3100-3899 区间按哈希取模：每个 sessionId 派生出一个固定的本地端口（source/shared/types/hyperframes-project.ts:1-8），最多向后探测 32 个端口寻找可用槽位；若全部被占用则启动失败（source/plugins/deepseek-ivideo/src/runtime.ts:21、258-307）。
• 运行时进程有空闲超时：所有 lease 释放 60 秒后进程自动被 SIGTERM 回收，启动超时上限 45 秒（source/plugins/deepseek-ivideo/src/runtime.ts:19-22、405-410）；Harness 父进程与 preview 子进程通过 IPC disconnect 事件联动回收（packages/deepseek-ivideo/lib/preview-owner-guard.js:1-13）。
• 嵌入的 HyperFrames 运行时版本与 npm 公开发行版不同：发布包在打包时通过 stage-hyperframes-runtime.mjs 把 vendor/hyperframes 的本地构建产物（当前源版本 0.7.60）拷进 lib/hyperframes/，安装时不会从 npm 拉取同名包（package.json:55-57）；用户如果想升级必须等待主仓库同步并重新发版。
• 校验工具超时 120 秒：ipollowork_video_validate 在执行超过 120 秒后会中止底层进程（packages/deepseek-ivideo/lib/index.js:191、220-238），特别复杂的项目需要分段校验或简化项目结构。
• 导出视频需 Puppeteer 与 Chrome：HyperFrames 运行时通过 await import("puppeteer-core") 动态加载浏览器（packages/deepseek-ivideo/lib/hyperframes/cli.js），导出前需要确保系统已安装可被 Puppeteer 启动的 Chrome/Chromium。

DeepSeek Design

由 iPolloWork 推出的 DeepSeek Harness 核心设计系统
让 DeepSeek Harness 不只回答问题，也能生成、理解并持续修改真正可编辑的设计作品。

简体中文 · English

---

DeepSeek Harness 的核心设计能力

DeepSeek Design 是由 iPolloWork 推出、专为 DeepSeek Harness 构建的原生可视化设计系统。

它把 DeepSeek Harness 作为理解需求、生成内容和修改文件的 AI 引擎，把 iPolloWork Design Studio 作为可视化创作与精调界面。你可以在对话中提出完整需求，也可以选中画布里的一个标题、一张图片或一个组件，让 AI 只修改当前对象；需要更精确时，则直接在 Studio 中调整文字、字体、颜色、尺寸、间距、背景、链接与图片。

你可以把它理解为 DeepSeek Harness 中类似 Claude Design 的开放设计工作流：AI 负责从意图到作品，Studio 负责从作品到细节，最终结果仍是工作区中真实、可保存、可继续编辑的文件。

DeepSeek Design 不是另一个聊天机器人，也不会替换 DeepSeek Harness。它以原生插件方式进入 Harness 的对话界面，复用当前会话、模型、工作区与权限体系，为 Harness 增加一套专门的 Design 能力。

从一句话到可交付设计

1. 在 DeepSeek Harness 中描述你想要的网站、App 原型、海报、信息卡、报告或演示文稿。
2. Harness 在当前工作区生成或修改 HTML、CSS、设计令牌和项目说明文件。
3. 打开对话旁的 Design 或 PPT 视图，实时查看结果。
4. 直接编辑画布，或选中具体元素后使用 Ask AI 继续修改。
5. 继续对话、切换模板或撤销修改；PPT 作品还可导出为 PDF 或 PPTX。

这是一条持续循环的创作流程，而不是一次性的图片生成：

描述需求 → AI 生成 → Studio 预览 → 手动精调 / Ask AI → 保存到工作区 → 继续迭代

三个独立插件，一套创作系统

三个插件可以单独安装，也可以一起使用。它们共享 iPolloWork Studio 契约和模板协议，但项目目录彼此隔离，因此不会相互覆盖。只安装所选 npm 包，不会下载另外两个插件。

核心特性

• Harness 原生界面：Design 与 PPT 作为独立视图出现在 DeepSeek Harness 对话中，不需要启动 iPolloWork 桌面端。
• AI 与手动编辑并存：既能让 AI 完整生成或重构，也能在画布中直接修改单个元素和全局主题。
• 选区级 Ask AI：选中元素后，插件把明确的文件、定位信息和当前样式整理为对话草稿；由用户确认后再发送，不会自动提交。
• 真实项目文件：作品保存在 Harness 工作区，而不是封闭的云端画布或不可编辑截图。
• 模板市场：Design 与 PPT 拥有各自的精选模板入口；网站和海报不会混入 PPT，幻灯片也不会混入 Design。
• 可逆编辑：支持保存、撤销和文件变更冲突检测，降低 AI 与手动编辑同时发生时的覆盖风险。
• 设计系统能力：通过设计令牌统一管理颜色、字体、背景、圆角、阴影、间距和组件视觉语言。
• 独立安装：每个 npm 包都包含所需的浏览器资源，只安装选择的能力，不把完整 iPolloWork 主项目带入 Harness。
• 原生 Video 工作流：iVideo 直接复用 HyperFrames 时间线、可视化编辑、预览、校验与导出，不维护第二套视频引擎。

快速开始

环境要求

• Node.js ^22.19.0 或 >=24.0.0
• DeepSeek Harness 当前版本及其插件管理所需的 pnpm

DeepSeek Harness 仍处于开发者预览阶段，可能出现兼容性变更。请优先使用最新版本，详见其官方项目。

只安装 Design

npx @deepseek-ai/dsh plugin --profile web add deepseek-idesign
npx @deepseek-ai/dsh web

同时安装 Design、PPT 与 Video

npx @deepseek-ai/dsh plugin --profile web add deepseek-idesign deepseek-ippt deepseek-ivideo
npx @deepseek-ai/dsh web

如果已经安装了 dsh 命令，可以把上面的 npx @deepseek-ai/dsh 直接替换为 dsh。Web 界面默认运行在 http://127.0.0.1:3080。

更新或卸载

# 更新
npx @deepseek-ai/dsh plugin --profile web update deepseek-idesign deepseek-ippt deepseek-ivideo

# 卸载
npx @deepseek-ai/dsh plugin --profile web remove deepseek-idesign deepseek-ippt deepseek-ivideo

如何使用

1. 在要作为工作区的项目目录中启动 DeepSeek Harness。
2. 新建或打开一个对话，在对话视图中选择 Design、PPT 或 Video。
3. 点击编辑开关旁的 + 打开对应模板市场，或直接让 AI 从当前空白项目开始创作。
4. 点击画布中的元素进行精调；需要 AI 帮助时，点击 Ask AI，检查自动填入的修改要求后再发送。
5. 所有修改都会回到当前工作区，后续对话仍可继续读取和编辑。

Design 项目保存在：

design/<sessionId>/

PPT 项目保存在：

design/<sessionId>-ippt/

Video 项目保存在：

video/<sessionId>/

安全与数据边界

• 插件只接受 DeepSeek Harness 已注册的工作区，并将读写限制在工作区的 design/ 目录内。
• Studio iframe 使用进程级随机令牌访问宿主接口，并校验同源消息。
• 文本写入带版本冲突检查并采用原子替换，避免静默覆盖较新的文件。
• 模板应用先在隔离目录中完成校验，再原子替换当前项目；失败时恢复原项目。
• Ask AI 只填写当前对话的草稿，不会代替用户发送消息。
• 安装插件不会安装或启动 iPolloWork 桌面应用；每个插件只载入自己的 Studio。

项目结构与同步方式

packages/
  deepseek-idesign/       可直接安装的完整 Design 插件
  deepseek-ippt/          可直接安装的完整 PPT 插件
  deepseek-ivideo/        可直接安装的完整 Video 插件
source/
  plugins/                DeepSeek Harness 适配器源码
  shared/                 三个插件共用的 Studio 协议与类型
SOURCE_COMMIT             对应的 iPolloWork 主库提交
repository.json           包版本与源码来源清单

iPolloWork 是产品源码的唯一事实来源；deepseek-design 是面向 DeepSeek Harness 用户的独立发布与贡献入口。

社区可以在本仓库修改 source/ 或根目录 README。合并后，自动流程会在 iPolloWork 主库创建可审查的上游 PR；上游合并后再统一构建三个插件，并把结果同步回本仓库。这样，iPolloWork、DeepSeek Design 和三个 npm 包始终由同一套 Studio 能力升级，不需要分别维护功能分叉。

请不要直接修改 packages/ 下的生成产物。

参与贡献

• 功能建议与问题反馈：GitHub Issues
• 源码贡献：修改 source/ 并提交 Pull Request
• iPolloWork 核心 Studio 与模板贡献：iPolloWork

许可

本项目使用与 iPolloWork 主仓库一致的 iPolloWork Source Available License。第三方组件及历史许可部分继续保留各自的许可条款。

---

The core design capability for DeepSeek Harness

DeepSeek Design is a native visual design system created by iPolloWork for DeepSeek Harness.

It uses DeepSeek Harness as the AI engine that understands a brief, creates content, and edits workspace files, while iPolloWork Design Studio provides the visual surface for previewing and refining the result. Ask for a complete design in conversation, select one heading, image, or component for a focused AI change, or directly adjust text, typography, color, size, spacing, backgrounds, links, and media in Studio.

Think of it as an open, source-available Claude Design-style workflow inside DeepSeek Harness: AI moves from intent to artifact, Studio moves from artifact to detail, and the result remains a real, editable project in your workspace.

DeepSeek Design is not a separate chatbot and does not replace Harness. It installs as a native Harness bundle and reuses the active conversation, model, workspace, and permission system to give Harness a dedicated Design capability.

One continuous design loop

Brief → AI generation → Studio preview → Visual edit / Ask AI → Workspace files → Iterate

1. Describe a website, app prototype, poster, information card, report, or presentation.
2. Harness creates or updates the HTML, CSS, design tokens, and project metadata in the current workspace.
3. Open the Design or PPT conversation view to see the result immediately.
4. Edit directly on the canvas or select an element and use Ask AI for a focused change.
5. Continue the conversation, switch templates, or undo changes; presentations can also be exported to PDF or PPTX.

Three plugins, one creative system

Install any plugin independently or use all three. They share iPolloWork Studio contracts and template protocols while keeping project directories isolated. Installing one package never downloads the other two.

Highlights

• Native Harness surface — Design and PPT appear as dedicated conversation views; the iPolloWork desktop app is not required.
• AI plus direct manipulation — generate or restructure with AI, then refine individual elements and the global theme visually.
• Selection-aware Ask AI — the selected element, file location, and styles are prepared as a reviewable conversation draft and are never submitted automatically.
• Real workspace files — designs remain editable HTML, CSS, tokens, and metadata instead of a closed canvas or flattened screenshot.
• Curated template catalogs — Design and PPT have separate template entry points, so slide templates never pollute the general design catalog.
• Reversible editing — save, undo, and write-conflict detection protect mixed AI and manual workflows.
• Design-system controls — colors, typography, backgrounds, radii, shadows, spacing, and component language stay coordinated through design tokens.
• Independent installation — each npm package includes its browser assets and installs only the selected capability.
• Native Video workflow — iVideo reuses the HyperFrames timeline, visual editing, preview, validation, and export pipeline without a second video engine.

Quick start

Requirements

• Node.js ^22.19.0 or >=24.0.0
• A current DeepSeek Harness release and pnpm for its plugin manager

DeepSeek Harness is currently a developer preview and may introduce compatibility-breaking changes. Follow its official repository for current requirements.

Install Design only

npx @deepseek-ai/dsh plugin --profile web add deepseek-idesign
npx @deepseek-ai/dsh web

Install Design, PPT, and Video

npx @deepseek-ai/dsh plugin --profile web add deepseek-idesign deepseek-ippt deepseek-ivideo
npx @deepseek-ai/dsh web

If dsh is already installed, replace npx @deepseek-ai/dsh with dsh. The Web UI is served at http://127.0.0.1:3080 by default.

Update or remove

# Update
npx @deepseek-ai/dsh plugin --profile web update deepseek-idesign deepseek-ippt deepseek-ivideo

# Remove
npx @deepseek-ai/dsh plugin --profile web remove deepseek-idesign deepseek-ippt deepseek-ivideo

Using the Studio

1. Start DeepSeek Harness from the directory you want to use as the workspace.
2. Create or open a conversation and choose the Design, PPT, or Video view.
3. Use the + beside Edit to open the matching template catalog, or ask the AI to start from the blank project.
4. Select elements for direct editing. Use Ask AI when you want Harness to make the next change, then review the prepared draft before sending it.
5. Every change remains in the current workspace and can be read or edited by later turns.

Design projects use design/<sessionId>/; PPT projects use design/<sessionId>-ippt/; Video projects use video/<sessionId>/.

Security and data boundaries

• Access is limited to workspaces registered by DeepSeek Harness and paths below their design/ directory.
• The Studio iframe uses a random per-process token and same-origin message checks.
• Writes use conflict checks and atomic replacement; template changes are staged and validated before replacing a project.
• Ask AI only prepares a draft in the current conversation and never submits it for the user.
• Installing these packages does not install or launch the iPolloWork desktop app; each package loads only its own Studio.

Repository model

packages/               Complete, installable plugin builds
source/plugins/         DeepSeek Harness adapter sources
source/shared/          Shared Studio protocol and types
SOURCE_COMMIT           Matching iPolloWork source commit
repository.json         Package and provenance manifest

iPolloWork is the single source of truth for product code. deepseek-design is the focused distribution and contribution entry point for Harness users.

Pull requests may update source/ or this README. Accepted changes are imported into iPolloWork as a reviewable upstream pull request. After that pull request is merged, all three plugins are rebuilt from shared Studio sources and synchronized back here. Do not edit generated runtime files under packages/ directly.

Contributing

• Ideas and bug reports: GitHub Issues
• Adapter contributions: open a pull request against source/
• Core Studio and template contributions: iPolloWork

License

This project uses the same iPolloWork Source Available License as the main iPolloWork repository. Third-party components and previously licensed portions retain their respective licenses.