# deepseek-design

> A visual creation suite for DeepSeek Harness provided by iPolloWork, featuring three

## Metadata

- Author: [@Devin-AXIS](https://github.com/Devin-AXIS)
- Repo: <https://github.com/Devin-AXIS/deepseek-design.git>
- GitHub: [Devin-AXIS/deepseek-design](https://github.com/Devin-AXIS/deepseek-design)
- Stars: 195
- Language: JavaScript
- License: [NOASSERTION](https://spdx.org/licenses/NOASSERTION.html)
- Homepage: <https://github.com/Devin-AXIS/iPolloWork>
- Topics: `ai-design`, `deepseek`, `deepseek-harness`, `design`, `design-studio`, `dsh-plugin`, `ipollowork`, `ipollowork-plugin`, `plugin`, `ppt`, `presentation`, `prototyping`, `visual-editor`
- Forks: 67
- Open Issues: 2
- Last push: 2026-08-18T09:54:38.000Z
- Added: 2026-08-17T00:00:00.000Z

## Install

```bash
dsh plugin --profile web add github:Devin-AXIS/deepseek-design
```

## Wiki

## One-Line Positioning
DeepSeek Design is a native visual creation suite by iPolloWork for DeepSeek Harness, embedding three work types—"web pages/posters/cards (iDesign)", "slides (iPPT)", and "short videos (iVideo)"—as independent conversation views directly into Harness, reusing the same session, model, and workspace. Works are saved as real HTML/CSS/project files in the current directory rather than on a closed cloud canvas.

## Core Capabilities
- Provides **Design** view (iDesign) in Harness conversations to generate and fine-tune websites, app prototypes, posters, info cards, data reports and other non-slide works, with 29 curated templates
- Provides **PPT** view (iPPT) in Harness conversations to generate and fine-tune slides page by page, supporting **PDF/PPTX** export, with 5 slide templates, stored in separate directories from iDesign without overwriting
- Provides **Video** view (iVideo) in Harness conversations using iPolloWork's same HyperFrames timeline, visual editor, animations and assets for short videos, with 27 editable video templates and native video export support
- Selection-level **Ask AI**: After selecting an element, assembles file path, CSS positioning, text, alt, src and other context into a conversation draft, requires user confirmation to send, never auto-submits
- Real workspace files + template atomic replacement: All works are saved in Harness workspace (`design/<sessionId>/`, `design/<sessionId>-ippt/`, `video/<sessionId>/`), with version conflict detection on save, template application first validates in isolated directory then atomically replaces
- Three plugins share iPolloWork Studio protocol but have isolated project directories, each can be installed independently without pulling the other two

## Technical Implementation
- **Language**: TypeScript (sub-packages `package.json#type: module`, main source in `source/plugins/*/src/`, build output in `packages/*/lib/`); Studio side uses React 18 + Vite + Tailwind CSS v4
- **Key dependencies**: `@deepseek-ai/cordis`, `@deepseek-ai/dsh-host-webserver`, `@deepseek-ai/dsh-workspace`, `@deepseek-ai/dsh-client-runtime`, `@deepseek-ai/dsh-client-ui-conversation` as peer; `deepseek-ivideo` additionally imports `puppeteer-core`, `sharp`, `onnxruntime-node`, `fontkit`, `hono` for driving HyperFrames preview
- **Architecture pattern**: DSH adapter plugin — each sub-package inserts a Cordis plugin with `id: ipollowork-{design,ppt,video}-studio` into the host via `cordis.patch.yml`, `client.tsx` uses `ctx.slots.inject("conversation.view")` to register `Design / PPT / Video` view components in Harness conversations, `index.ts` uses `ctx.webServer.register` to mount `/ipollowork-design/`, `/ipollowork-ppt/`, `/ipollowork-video/` prefixes to Harness's built-in web server for serving Studio static resources and restricted APIs
- **Entry files**: `source/plugins/deepseek-idesign/src/index.ts` (iDesign main), `source/plugins/deepseek-ippt/src/index.ts` (iPPT reuses iDesign factory), `source/plugins/deepseek-ivideo/src/index.ts` (iDesign main + `runtime.ts` drives HyperFrames child process), client entry `source/plugins/*/src/client.tsx`

## Use Cases
For users in DeepSeek Harness who want to directly produce savable, manually editable designs/H5/posters/info cards/data reports, or need to quickly create presentations exportable to PDF/PPTX, or want to use the same HyperFrames flow/animation templates for short videos/product demos. Each of the three plugins is independent; the most common combinations are: iDesign alone for web-based designs, iPPT alone for slides, iVideo alone for dynamic visuals. Installing all three won't cause mutual overwrites; works are always real files in the workspace, convenient for scripts/CI post-processing.

## Prerequisites and Compatibility

| Dependency | Minimum Version | Notes |
|---|---|---|
| DSH | `>=0.0.1-rc.1`, dev locked to `0.1.0-rc.6` | All three sub-packages declare in `peerDependencies` that `@deepseek-ai/dsh-host-webserver`, `@deepseek-ai/dsh-client-runtime`, `@deepseek-ai/dsh-client-ui-conversation`, `@deepseek-ai/dsh-workspace` require `>=0.0.1-rc.1 <0.2.0-0`; dev dependencies actually lock to `0.1.0-rc.6` |
| Node.js | `^22.19.0` or `>=24.0.0` | Declared in README line 79; only `deepseek-ivideo` has explicit `package.json#engines.node: ">=22"`, iDesign/iPPT follow DSH host's Node compatibility requirements |
| pnpm | Not required | README mentions DSH plugin management needs pnpm, unrelated to this suite |
| Platform | Cross-platform (macOS / Windows / Linux) | None of the three `package.json` declare `os`/`cpu` restrictions; iVideo's HyperFrames child process tries 32 ports and safely falls back |
| Native modules | `sharp`, `onnxruntime-node`, `fontkit` | Only appear in `packages/deepseek-ivideo/package.json#dependencies`, iDesign/iPPT are pure JS; installation pulls precompiled binaries |
| Browser runtime | Chromium (downloaded at first startup by `puppeteer-core` via `@puppeteer/browsers`) | iVideo preview spawns HyperFrames Studio child process, doesn't hard-bundle browser binary |

## Installation

```bash
dsh plugin --profile web add github:Devin-AXIS/deepseek-design
```

## Configuration

| Config | Type | Notes | Default |
|---|---|---|---|
| No additional config needed | — | None of the three sub-packages define Cordis `Schema`, `cordis.patch.yml` doesn't read any fields; `createDeepSeekDesignStudioPlugin` only receives construct parameters like `mode/routeRoot/studioTitle/defaultTemplateId/projectSuffix` at compile time. All runtime interactions (selection context, workspace ID, session ID, template ID) are passed via URL parameters or PostMessage between Studio and Harness | — |

## FAQ

**Q: What's the relationship between this repo and the npm packages it builds?**

A: The repo root doesn't publish npm packages; it's a distribution and coordination repo for three independently installable plugins: `packages/deepseek-idesign`, `packages/deepseek-ippt`, `packages/deepseek-ivideo` each publish as independent npm packages; `source/` contains source code for these three adapters, `source/shared/` contains their shared Studio protocol and types. When modifying adapters, edit `source/plugins/...`, don't directly modify generated outputs in `packages/` (README lines 140–158).

**Q: Which of the three plugins should I install? Can I install just one?**

A: You can install any one independently, they have no dependencies: install `deepseek-idesign` for web/posters/cards only; install `deepseek-ippt` for slides only; install `deepseek-ivideo` for short videos only. Installing all three simultaneously is also fine since their project directories are isolated (`design/<sessionId>/`, `design/<sessionId>-ippt/`, `video/<sessionId>/`), they won't overwrite each other.

**Q: Where are the real files for these works saved? Can I continue editing manually?**

A: All works land in the Harness workspace as real HTML, CSS, design tokens, manifest.json files, not closed canvases on the cloud that can't be edited. iDesign/iPPT projects are in `design/<sessionId>/`, `design/<sessionId>-ippt/`, iVideo projects in `video/<sessionId>/`; you can directly edit these files with an editor, or let AI modify them through conversation. Saves include conflict detection, template application is "stash first then atomic replace".

**Q: Will installation also download the iPolloWork desktop app?**

A: No. Each npm package includes its own browser resources and HyperFrames runtime (ivideo has built-in customized version `0.7.60`), installing these packages won't pull the iPolloWork desktop app, nor install or launch it. Each plugin only loads its own Studio; the three independent npm packages can be installed separately.

**Q: What limitations does the first version of iVideo have?**

A: The initial release of iVideo doesn't include voice cloning, voice settings, or the iPolloWork global Design System drawer; beyond that, core capabilities (HyperFrames timeline, visual editing, animations, assets, 27 editable video templates, full and selection-level Ask AI, `ipollowork_video_validate` validation tool, native video export) are all available.

**Q: Does clicking Ask AI directly send the message?**

A: No. Ask AI only assembles "target element + file path + CSS positioning + current styles (text/alt/src truncated to 240~1000 chars)" into a draft filled into the current conversation; you must click send to submit; the plugin also won't automatically execute any tool calls.

**Q: What to do if iVideo errors or fails to start?**

A: First confirm Node ≥ 22 and no polluted symlinks in workspace `video/`, `design/`; iVideo will reject directory traversal and symlinks escaping the workspace, port conflicts safely fall back (tries 32 ports total), concurrent starts are merged. If HyperFrames startup times out (default 45s), the plugin errors directly instead of zombie-ing; if Harness host goes offline, IPC disconnect triggers preview-owner-guard to kill the process group, no orphans left.

## Learning Curve
Beginner — DSH users can start by selecting Design / PPT / Video in a new conversation; the most common zero-config path is "AI generate → Studio fine-tune → save/export"; to fully leverage each plugin (like selection context, manifest.json editing, design tokens), read the sub-package README and iPolloWork main repo.

## Known Issues and Limitations

- **iVideo first edition feature cuts**: iVideo's initial release doesn't include voice cloning, voice settings, iPolloWork global Design System drawer; other HyperFrames timeline, animations, 27 video templates, `ipollowork_video_validate` model validation tool, native video export are available (`packages/deepseek-ivideo/README.md:30`)
- **Publishing disabled on Harness side**: The `callStorage` called inside iDesign Studio returns `"Publishing is owned by iPolloWork and is disabled in the DeepSeek Harness host."`, so the "Publish to iPolloWork Template Market" button won't actually execute in DSH (`source/plugins/deepseek-idesign/studio/src/deepseek-client.ts:79`)
- **iVideo strongly depends on host environment**: iVideo requires `sharp` / `onnxruntime-node` / `fontkit` precompiled native modules and will download Chromium via `@puppeteer/browsers` on first startup; if all 32 ports are occupied, throws `"No available local port could be found for HyperFrames Studio."` directly (`packages/deepseek-ivideo/package.json:58-71`, `source/plugins/deepseek-ivideo/src/runtime.ts:295-307`)
- **Strong path write constraints**: Written paths must fall within workspace `design/` or `video/<sessionId>/` prefixes, symlinks cannot escape workspace, paths containing `..` or absolute paths return 400/403; this means "cross-workspace project moves" are rejected as-is (`source/shared/studio-host/src/http.ts:35-58`)
- **DSH still in developer preview**: Harness major version and plugin peer range (`>=0.0.1-rc.1 <0.2.0-0`) are relatively wide; this suite needs revalidation when DSH upgrades to the next major version (README lines 76–77)
- **iVideo doesn't expose debug window source paths**: HyperFrames Studio is published as precompiled ESM to `lib/hyperframes/` (includes CLI and client), error messages only return `output` field (max 32 KB), don't treat upstream HyperFrames as modifiable source during custom builds

---

This document is auto-generated by [deepseek-plugin.org](https://deepseek-plugin.org). HTML page: [deepseek-design](https://deepseek-plugin.org/plugins/Devin-AXIS/deepseek-design)
Wiki generated by AI (model: `MiniMax-M2.5`)