iPolloWork 为 DeepSeek Harness 推出的 PPT 视图插件，对话中直接生成与精调幻灯片，附 6 个精选模板并支持 PDF/PPTX 导出。
- 语言
- JavaScript
- License
- NOASSERTION
- 分支
- main
安装
$ dsh plugin --profile web add github:Devin-AXIS/deepseek-design/packages/deepseek-ippt在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
一句话定位
deepseek-ippt 是 iPolloWork 为 DeepSeek Harness 做的"幻灯片"原生插件，在对话里多出一个 PPT 视图，可以由 AI 直接生成完整演示文稿，也可以选中某张幻灯片或其中某个元素做选区级 Ask AI，最后把真实可继续编辑的 HTML/CSS/设计令牌落到工作区的 design/<sessionId>-ippt/ 目录。
核心能力
- 在 Harness 对话中多出 PPT 视图（label
PPT，与 iDesign 的 Design 视图并存），可在该视图里逐页预览与编辑 - AI 在对话中直接生成叙事、页面、整篇演示文稿，并支持选区级 Ask AI（选中元素后填好草稿，由用户发送）
- 6 个精选幻灯片模板（4 套 HTML Anything 系列 + 2 套原生可编辑 PPTX），模板市场只展示幻灯片，不会混入网站/海报/视频
- 逐页预览 + 直接元素编辑：文字、图片、排版、颜色、位置、视觉样式均可在画布里调整
- 共享 iPolloWork 设计令牌系统：通过
design-tokens.css统一管理颜色、字体、背景、圆角、阴影、间距，编辑主题时整本 PPT 同步更新 - 导出 PDF 与 PPTX（PPT 视图内置 jsPDF、html2canvas、pptxgen、JSZip；原生 PPTX 模板导出后对象在 PowerPoint 里仍可继续编辑）
- 保存带
baseUpdatedAt冲突检测 + 原子替换，模板应用先在隔离目录校验再原子替换，失败时恢复旧项目
技术实现
- 语言: TypeScript（子包
type: module，主源码在source/plugins/deepseek-ippt/src/，构建产物在packages/deepseek-ippt/lib/）；Studio 端用 React 18 + Vite 6 + Tailwind CSS v4 - 关键依赖:
@deepseek-ai/cordis、@deepseek-ai/dsh-host-webserver、@deepseek-ai/dsh-workspace、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-conversation、react18.2（全部为可选 peer dependency）；运行期只用 Node 内置node:crypto/node:fs/node:fs/promises/node:path/node:url - 架构模式: DSH 适配器插件 ——
cordis.patch.yml向宿主插入 Cordis 插件id: ipollowork-ppt-studio；client.tsx用ctx.slots.inject("conversation.view")把PPT视图组件挂到 Harness 对话里；index.ts用ctx.webServer.register({ kind: "prefix", path: "/ipollowork-ppt" })把 Studio 静态资源和/ipollowork-ppt/api/*接口挂到 Harness 内置 Web 服务器 - 入口文件:
source/plugins/deepseek-ippt/src/index.ts（服务端，复用source/shared/design-studio/src/index.ts的createDeepSeekDesignStudioPlugin工厂，传mode: "slides"、routeRoot: "/ipollowork-ppt"、studioTitle: "DeepSeek iPPT"、defaultTemplateId: "ipollowork.deepseek-harness.ppt"、projectSuffix: "-ippt"），客户端入口source/plugins/deepseek-ippt/src/client.tsx，编译后分别是packages/deepseek-ippt/lib/index.js与packages/deepseek-ippt/lib/client.js
适用场景
希望直接在 Harness 对话里就把一份演示文稿做出来、再逐页精调细节的工作者，比如产品/运营做 pitch deck、技术汇报、季度评审、对外宣传页等；也想让生成的 PPT 既能被 AI 修改也能直接打开 PowerPoint 继续编辑的人群。design/<sessionId>-ippt/ 与 iDesign 的 design/<sessionId>/ 目录相互隔离，两边可以同时装在同一工作区，不会互相覆盖。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH | >=0.0.1-rc.1 且 <0.2.0-0，开发期锁定 0.1.0-rc.6 | package.json#peerDependencies 声明 @deepseek-ai/dsh-host-webserver、@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-conversation、@deepseek-ai/dsh-workspace 需要该区间（package.json:51-58），开发依赖实际锁定 0.1.0-rc.6（package.json:81-84） |
| Node.js | ^22.19.0 或 >=24.0.0 | 子包 package.json 没有 engines 字段；沿用父仓库 README.md:74 声明；@types/node devDep 锁到 25.6.0（package.json:86） |
| React | ^18.2.0 | 由 Harness 宿主提供，列在 peerDependencies（package.json:57） |
| 平台 | 跨平台（macOS / Windows / Linux） | package.json 没有 os/cpu 限制；客户端用 iframe + sandbox 属性隔离（lib/client.js:103） |
| 原生模块 | 无 | 运行时只使用 Node 内置模块（lib/index.js:1-5），安装不会拉 sharp/onnxruntime-node 等预编译二进制 |
| 浏览器运行时 | Chromium（由 Harness 宿主提供） | Studio 是浏览器内运行的 React/Vite 应用（packages/deepseek-ippt/studio/dist/），插件不自带浏览器二进制 |
安装方式
dsh plugin --profile web add github:Devin-AXIS/deepseek-design/packages/deepseek-ippt
配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| 本插件无需额外配置 | — | cordis.patch.yml 不读任何字段；createDeepSeekDesignStudioPlugin 只在编译期接收 mode/routeRoot/studioTitle/defaultTemplateId/projectSuffix 等构造参数（已硬编码为 slides / /ipollowork-ppt / DeepSeek iPPT / ipollowork.deepseek-harness.ppt / -ippt）。运行期所有交互（工作区 ID、会话 ID、模板 ID、选区上下文）通过 URL 查询参数和 PostMessage 在 Studio 与 Harness 之间传递 | — |
常见问题
Q: 这个插件和 deepseek-design 是什么关系？
A: 它是 deepseek-design 套件里的"幻灯片"那一支，专门为 Harness 对话增加一个 PPT 视图。三个兄弟插件 iDesign/iPPT/iVideo 各自独立安装、目录彼此隔离（design/<sessionId>/、design/<sessionId>-ippt/、video/<sessionId>/），可以只装这一份。
Q: 装了它会不会顺便下载 iPolloWork 桌面端或 iVideo？
A: 不会。npm 包自带 Studio 浏览器资源（packages/deepseek-ippt/studio/dist/ 与 lib/client.js），既不下载 iPolloWork 桌面应用，也不加载 iVideo 或 iDesign；安装命令只拉这一份插件。
Q: 作品真实文件落在哪里，能继续手动编辑吗？
A: 落在 Harness 工作区的 design/<sessionId>-ippt/ 下，是真实的 HTML、CSS 设计令牌和 manifest.json 等文件，不是云端封闭画布；你可以用任意编辑器改这些文件，也可以让 AI 通过对话继续修改。
Q: 自带了哪些模板？
A: 6 个精选幻灯片模板：Knowledge Arch Blueprint（技术风）、Hermes Cyber Terminal Deck、Presenter Mode Deck、Pastel Slow-life Deck、Morrow Brand Narrative（PPTX 可继续编辑）、iPollo VI Enterprise Presentation（38 页原生可编辑 PPTX）。
Q: 能导出 PDF/PPTX 吗？
A: 可以。Studio 内置 jsPDF、html2canvas、pptxgen 和 JSZip，PPT 视图支持 PDF 和 PPTX 两种导出；带 "native-editable" 标记的 PPTX 模板导出后对象在 PowerPoint 里仍可继续编辑。
Q: Ask AI 会自动发出消息吗？
A: 不会。Ask AI 只把"目标元素 + 文件路径 + CSS 定位 + 当前样式（文字/alt/src 截断到 240 字）"组装成一段草稿填进当前对话，必须由用户点发送才会提交，插件也不会自动执行任何工具调用。
Q: 保存会覆盖我的手工编辑吗？
A: 不会。文本写入带 baseUpdatedAt 冲突检查——文件自上次读取后被外部改动时返回 409 让用户先刷新再保存；写入采用临时文件 + rename 的原子替换，避免半写状态。模板应用也是先在隔离目录校验再原子替换，失败时恢复旧项目。
Q: PPT 视图能不能和 Design 视图同时用？
A: 可以。两个视图独立注册（viewId: "ipollowork-ppt-studio" vs ipollowork-design-studio），且项目目录分别为 design/<sessionId>-ippt/ 与 design/<sessionId>/，互不覆盖；同时安装 deepseek-idesign 与 deepseek-ippt 即可。
上手难度
入门 — 在新对话里点 PPT 视图即开用，常见路径是"AI 生成大纲与初稿 → 在 Studio 逐页精调或 Ask AI 改元素 → 导出 PDF/PPTX"；想榨干选区上下文、设计令牌、manifest schema 则需要再读 iPolloWork 主仓库与子包 README。
已知问题与限制
- DSH 仍处开发者预览：Harness 主版本号与插件 peer 范围（
>=0.0.1-rc.1 <0.2.0-0）较宽，DSH 升级到下一个主版本时本插件需要重新验证（README.md:76-77） - 路径写入有强约束：写入路径必须落在工作区
design/前缀内，符号链接不能逃逸工作区，相对路径里含..或绝对路径会返回 400/403；这意味着"跨工作区移动项目"会被原样拒绝（lib/index.js:3889-3917） - 生成产物不可在
packages/直接改：仓库采用 iPolloWork 上游同步模型，packages/是构建产物，应改source/plugins/deepseek-ippt/并提交 PR，由上游合并后同步回来（source/README.md:1-7） - 每进程 Studio token 不可跨进程复用：进程级随机 base64url token 失效后所有 API 请求会 401，重启 Harness 即可（lib/index.js:4167、3899-3901）
- iDesign/iVideo 关闭 Studio 路径里的相同 token 通道：本插件的服务端用
x-ipollowork-design-token头校验 Studio iframe；同进程内的 iDesign/iVideo 复用同一套 host channel 和 token 协议，互不冲突但也不各自独立密钥（lib/index.js:3899-3901、source/shared/design-studio/src/bridge.ts:3-16）
DeepSeek Design
由 iPolloWork 推出的 DeepSeek Harness 核心设计系统
让 DeepSeek Harness 不只回答问题，也能生成、理解并持续修改真正可编辑的设计作品。
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 能力。
从一句话到可交付设计
- 在 DeepSeek Harness 中描述你想要的网站、App 原型、海报、信息卡、报告或演示文稿。
- Harness 在当前工作区生成或修改 HTML、CSS、设计令牌和项目说明文件。
- 打开对话旁的 Design 或 PPT 视图，实时查看结果。
- 直接编辑画布，或选中具体元素后使用 Ask AI 继续修改。
- 继续对话、切换模板或撤销修改；PPT 作品还可导出为 PDF 或 PPTX。
这是一条持续循环的创作流程，而不是一次性的图片生成：
描述需求 → AI 生成 → Studio 预览 → 手动精调 / Ask AI → 保存到工作区 → 继续迭代
三个独立插件，一套创作系统
| 插件 | 面向场景 | 核心能力 |
|---|---|---|
deepseek-idesign | 网站、App 原型、海报、信息卡、数据报告、杂志与其他非幻灯片设计 | Design 模板市场、桌面/移动预览、可视化元素编辑、主题与设计令牌、选区 Ask AI |
deepseek-ippt | 演示文稿与幻灯片 | 独立 PPT 模板市场、逐页编辑、可视化精调、选区 Ask AI、PDF/PPTX 导出 |
deepseek-ivideo | 动态视觉、产品演示、数据故事与短视频 | HyperFrames 时间线、动画与素材、27 个 Video 模板、选区 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
如何使用
- 在要作为工作区的项目目录中启动 DeepSeek Harness。
- 新建或打开一个对话，在对话视图中选择 Design、PPT 或 Video。
- 点击编辑开关旁的
+打开对应模板市场，或直接让 AI 从当前空白项目开始创作。 - 点击画布中的元素进行精调；需要 AI 帮助时，点击 Ask AI，检查自动填入的修改要求后再发送。
- 所有修改都会回到当前工作区，后续对话仍可继续读取和编辑。
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
- Describe a website, app prototype, poster, information card, report, or presentation.
- Harness creates or updates the HTML, CSS, design tokens, and project metadata in the current workspace.
- Open the Design or PPT conversation view to see the result immediately.
- Edit directly on the canvas or select an element and use Ask AI for a focused change.
- Continue the conversation, switch templates, or undo changes; presentations can also be exported to PDF or PPTX.
Three plugins, one creative system
| Plugin | Best for | Main capabilities |
|---|---|---|
deepseek-idesign | Websites, app prototypes, posters, cards, data reports, magazines, and other non-slide designs | Curated Design templates, desktop/mobile preview, direct element editing, themes and design tokens, selection-aware Ask AI |
deepseek-ippt | Presentations and slide decks | Dedicated slide templates, page-by-page editing, visual refinement, selection-aware Ask AI, PDF/PPTX export |
deepseek-ivideo | Motion design, product demos, data stories, and short video | HyperFrames timeline, animation and media, 27 Video templates, selection-aware Ask AI, validation, and video export |
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.0or>=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
- Start DeepSeek Harness from the directory you want to use as the workspace.
- Create or open a conversation and choose the Design, PPT, or Video view.
- Use the
+beside Edit to open the matching template catalog, or ask the AI to start from the blank project. - 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.
- 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.