Skip to main content

deepseek-design/packages/deepseek-idesign

195Stars67Forks2Issues29Watchers

Adds a visual Design view to DeepSeek Harness for generating and refining website and app prototypes, posters, info cards, and other non-slide works directly within conversations. Includes 29 curated templates.

Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the Devin-AXIS/deepseek-design monorepo — stars and activity count the whole repository.

Language
JavaScript
License
NOASSERTION
Branch
main
ai-designdeepseekdeepseek-harnessdesigndesign-studiodsh-pluginipolloworkipollowork-plugin

Install

cmdweb profile
$ dsh plugin --profile web add deepseek-idesign

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin Devin-AXIS/deepseek-design/packages/deepseek-idesign for me: review the repository at https://github.com/Devin-AXIS/deepseek-design first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Sentence Positioning

deepseek-idesign is a Design view plugin for DeepSeek Harness launched by iPolloWork, bringing iPolloWork Design Studio as a native Design view in Harness conversations where AI generates and modifies real HTML/CSS project files in the workspace. You can also select elements in the canvas to fine-tune text, font, color, spacing, and images.

Core Capabilities

  • Adds a Design view (label Design, coexists with PPT view) in Harness conversations for preview and editing
  • AI directly generates or makes large-scale modifications in conversations, supporting zone-level Ask AI (draft filled after selecting elements, submitted by user)
  • 29 non-slide精选 templates covering 7 categories: site / app / article / poster / cards / report / other
  • Direct in-canvas editing of text, typography, color, size, spacing, background, links and images, with desktop and mobile preview support
  • Shared iPolloWork design token system: unified management of colors, fonts, backgrounds, border-radius, shadows, and spacing via design-tokens.css
  • Saves with baseUpdatedAt conflict detection + atomic replacement; template application validates in isolated directory before atomic replacement, restores old project on failure

Technical Implementation

  • Language: TypeScript (sub-package type: module, main source in source/plugins/deepseek-idesign/src/, build output in packages/deepseek-idesign/lib/); Studio side uses React 18 + Vite 6 + 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, react 18.2 (all optional peer dependencies); runtime only uses Node built-ins node:crypto / node:fs / node:fs/promises / node:path / node:url
  • Architecture Pattern: DSH adapter plugin — cordis.patch.yml inserts Cordis plugin id: ipollowork-design-studio into host; client.tsx uses ctx.slots.inject("conversation.view") to mount the Design view component into Harness conversations; index.ts uses ctx.webServer.register({ kind: "prefix", path: "/ipollowork-design" }) to mount Studio static resources and /ipollowork-design/api/* endpoints to Harness's built-in web server
  • Entry Files: source/plugins/deepseek-idesign/src/index.ts (server-side, calls createDeepSeekDesignStudioPlugin factory with mode: "design", routeRoot: "/ipollowork-design", studioTitle: "DeepSeek iDesign", defaultTemplateId: "ipollowork.deepseek-harness.design"), client entry source/plugins/deepseek-idesign/src/client.tsx, compiled to packages/deepseek-idesign/lib/index.js and packages/deepseek-idesign/lib/client.js respectively

Use Cases

Non-technical users who want to directly produce websites, app prototypes, posters, info cards, data reports, or magazine visual works within Harness conversations. Pain point: previously could only get one-off images or screenshots in conversations, unable to continue fine-tuning individual elements. This plugin keeps editable HTML/CSS projects in the workspace and allows canvas direct editing and zone-level AI modifications to alternate. Design projects land in design/<sessionId>/, not overwriting PPT view's design/<sessionId>-ippt/. You can install just this one, or install both deepseek-ippt simultaneously.

Prerequisites and Compatibility

DependencyMinimum VersionNotes
DSH>=0.0.1-rc.1 and <0.2.0-0, dev locked to 0.1.0-rc.6package.json#peerDependencies declares @deepseek-ai/dsh-host-webserver, @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-ui-conversation, @deepseek-ai/dsh-workspace need this range (package.json:52-57), dev dependencies actually locked to 0.1.0-rc.6 (package.json:80-83)
Node.js^22.19.0 or >=24.0.0Sub-package package.json has no engines field; follows parent repo README.md:74 declaration; @types/node devDep locked to 25.6.0 (package.json:85)
React^18.2.0Provided by Harness host, listed in peerDependencies (package.json:56)
PlatformCross-platform (macOS / Windows / Linux)package.json has no os/cpu restrictions; client uses iframe + sandbox attribute for isolation (lib/client.js:103)
Native ModulesNoneRuntime only uses Node built-in modules (lib/index.js:1-5), installation won't pull precompiled binaries like sharp/onnxruntime-node
Browser RuntimeChromium (provided by Harness host)Studio is a browser-based React/Vite application (packages/deepseek-idesign/studio/dist/), plugin doesn't bundle browser binaries

Installation

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

Configuration

ConfigTypeNotesDefault
This plugin requires no extra configuration—cordis.patch.yml reads no fields; createDeepSeekDesignStudioPlugin only receives compile-time construction parameters mode/routeRoot/studioTitle/defaultTemplateId/projectSuffix (hardcoded to design / /ipollowork-design / DeepSeek iDesign / ipollowork.deepseek-harness.design / no suffix). Runtime all interactions (workspace ID, session ID, template ID, selection context) are passed via URL query parameters and PostMessage between Studio and Harness—

FAQ

Q: What is the relationship between this plugin and the deepseek-design repository?

A: It is the Design (iDesign) branch of the deepseek-design suite. packages/deepseek-idesign/ is an independently published npm package (package.json name is deepseek-idesign), carrying only browser resources needed for the Design view; it won't pull iPolloWork desktop client, nor does it include PPT (deepseek-ippt) and Video (deepseek-ivideo) which are separate plugins.

Q: Will installing it also download iPolloWork desktop client or PPT, Video?

A: No. The npm package bundles Studio browser resources (packages/deepseek-idesign/lib/client.js, packages/deepseek-idesign/studio/dist/), neither downloading iPolloWork desktop application nor loading iPPT or iVideo; the installation command only pulls this one plugin.

Q: Where do the actual files land, can I continue manual editing?

A: They land under Harness workspace's design/<sessionId>/, as real index.html, design-tokens.css, manifest.json, brief.json files, not a closed cloud canvas; you can edit these files with any editor, or let AI continue modifying through conversations. The plugin's API path prefix forces acceptance of only design/ paths (lib/index.js:75-77 / 4046), other directories won't be read or written.

Q: What templates are bundled?

A: 29 non-slide精选 templates covering 7 categories: site (5, like Afterglow Festival, Orbit Data Cloud), app (3, like Calm Mobile App, Finance Dashboard), article (5, including Chinese WeChat long-form graphics), poster (3), cards (4, like Twitter Share Card, Spotify Now-Playing Card), report (4, like Data Visualization Report, Experiment Readout), other (5). Among these, ipollowork.wechat-article locks header/footer brand assets; editing only allows replacing middle body images and outer CTA links.

Q: What is the installation command?

A: dsh plugin --profile web add github:Devin-AXIS/deepseek-design/packages/deepseek-idesign. After installation, run dsh web in the project directory to start Harness Web interface, default http://127.0.0.1:3080. After creating a new conversation, select the Design view.

Q: Does Ask AI automatically send messages?

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

Q: Will saving overwrite my manual edits?

A: No. Text writing carries baseUpdatedAt conflict check — returns 409 if file was externally modified since last read, letting user refresh before saving; writing uses temp file + rename for atomic replacement, avoiding half-written state. Template application also validates in isolated directory before atomic replacement, restores old project on failure.

Q: Can Design view and PPT view be used simultaneously?

A: Yes. The two views are registered independently (viewId: "ipollowork-design-studio" vs ipollowork-ppt-studio), and project directories are design/<sessionId>/ and design/<sessionId>-ippt/ respectively, not overwriting each other; install both deepseek-idesign and deepseek-ippt together.

Getting Started

Beginner — Click Design view in a new conversation to start using it. Common flow: "AI generates draft → refine in Studio or Ask AI to modify elements → save to workspace → continue iterating"; to fully utilize selection context, design tokens, and manifest schema, you need to read the iPolloWork main repo and sub-package READMEs.

Known Issues and Limitations

  • DSH still in developer preview: Harness major version and plugin peer range (>=0.0.1-rc.1 <0.2.0-0) are relatively wide; when DSH upgrades to next major version, this plugin needs revalidation (README.md:76-77)
  • Strong constraints on path writing: Written paths must fall within workspace design/ prefix; symlinks cannot escape workspace; relative paths containing .. or absolute paths return 400/403; this means "cross-workspace project moving" will be rejected as-is (lib/index.js:3889-3917)
  • Generated output cannot be directly modified in packages/: Repository uses iPolloWork upstream sync model; packages/ is build output, should modify source/plugins/deepseek-idesign/ and submit PR, synced back after upstream merge (source/README.md:1-7)
  • Per-process Studio tokens cannot be reused across processes: Process-level random base64url token, once expired, all API requests return 401; restarting Harness fixes it (lib/index.js:4167, 3899-3901)
  • WeChat template locked assets cannot be edited: ipollowork.wechat-article template's header/footer JPG assets and :root colors are forced locked by applyChecklist, only allowing replacement of middle body images and outer CTA links; AI modifications violating rules are rejected by manifest (lib/templates/ipollowork.wechat-article/manifest.json:32-39)
  • iPPT/iVideo reuse same token protocol: This plugin's server uses x-ipollowork-design-token header to verify Studio iframe; iPPT / iVideo in same process reuse the same host channel and token protocol, not conflicting but also not having independent keys (lib/index.js:3899-3901, source/shared/design-studio/src/bridge.ts:3-16)

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/Devin-AXIS/deepseek-design/packages/deepseek-idesign)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory