Skip to main content

iPolloWork/external-plugins/deepseek-harness/ppt-studio

4.3kStars833Forks76Issues552Watchers

Add PPT view to DeepSeek Harness dialogue, generate editable slides directly in workspace and export as PDF/PPTX.

Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
TypeScript
License
NOASSERTION
Branch
main
agent-collaborationagent-skillsai-agentsai-workclaude-codecodexdeepseek-harnessdsh-plugin

Install

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

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/iPolloWork/external-plugins/deepseek-harness/ppt-studio for me: review the repository at https://github.com/Devin-AXIS/iPolloWork 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-Line Pitch

deepseek-ippt injects iPolloWork's PPT Studio as a native PPT view into DeepSeek Harness, allowing you to have AI draft or modify slides within conversations, then directly fine-tune text, images, layout, colors, and positioning on the canvas page by page, with the ability to export the result as PDF or PPTX.

Core Capabilities

  • Provides a native PPT view in the DeepSeek Harness conversation tab bar, alongside Design and Video views
  • Generate complete slides through conversation, and initiate precise Ask AI modifications for selected pages/elements (drafts require user confirmation)
  • Preview slides page by page in Studio, directly edit text, images, layout, colors, dimensions, positioning, and global themes
  • Offers a slide-specific template marketplace (+ entry only shows slides templates), preventing website, poster, and report templates from mixing in
  • Supports save, undo, and file version conflict detection; writes use temporary file + rename for atomic replacement
  • Export work as PDF (all PPT templates support this) or PPTX (only templates marked PPTX-compatible support this)

Technical Implementation

  • Language: TypeScript + React (Studio frontend) + Node.js (HTTP bridging)
  • Key Dependencies: @deepseek-ai/cordis (plugin injection and effects), @deepseek-ai/dsh-host-webserver (route registration), @deepseek-ai/dsh-workspace (workspace parsing), @deepseek-ai/dsh-client-ui-conversation (frontend view slot)
  • Architecture Pattern: This directory's src/index.ts is a 12-line thin shell that calls the createDeepSeekDesignStudioPlugin factory from ../../design-studio/src/index.ts with mode: "slides", routeRoot: "/ipollowork-ppt", studioTitle: "DeepSeek iPPT", defaultTemplateId: "ipollowork.deepseek-harness.ppt", projectSuffix: "-ippt"; the apply phase registers webServer routes under the /ipollowork-ppt prefix, and the frontend uses dsh.client.inject to register a conversation.view slot in the Harness conversation for rendering the Studio iframe
  • Entry Files: src/index.ts (service registration and HTTP API), src/client.tsx (frontend PPT view), studio/vite.config.ts (Studio frontend build)

Use Cases

Ideal for users who need to directly produce editable slides, external reporting materials, or classroom presentations within the DeepSeek Harness workspace. The pain point is that previously you could only get one-off images or screenshots in conversations and couldn't continue fine-tuning individual page elements; this plugin keeps real HTML/CSS projects in the workspace and allows three interaction modes: AI generation, canvas direct editing, and selection-level Ask AI.

Prerequisites & Compatibility

DependencyMin VersionDescription
@deepseek-ai/dsh-client-runtime>=0.0.1-rc.1 <0.2.0-0Client runtime, required for DSH web client
@deepseek-ai/dsh-client-ui-conversation>=0.0.1-rc.1 <0.2.0-0Conversation view slot mechanism
@deepseek-ai/dsh-host-webserver>=0.0.1-rc.1 <0.2.0-0Host HTTP route registration capability
@deepseek-ai/dsh-workspace>=0.0.1-rc.1 <0.2.0-0Workspace parsing (required for slide file read/write)
@deepseek-ai/cordis^4.0.1Injection and effect framework (optional at build time)
react^18.2.0Studio frontend runtime
Node.jsNot declaredPlugin package.json has no engines; upper DeepSeek Design docs suggest ^22.19.0 or >=24.0.0
PlatformCross-platformOnly depends on host DSH's web services, OS-independent

Installation

dsh plugin --profile web add github:Devin-AXIS/iPolloWork/external-plugins/deepseek-harness/ppt-studio

Configuration

No user-level configuration required. After installation, the plugin injects itself into the host as ipollowork-ppt-studio (cordis.patch.yml), automatically registers the PPT view on the DSH web client, uses a 32-byte random token to protect iframe communication and API calls, and restricts all read/write to the current workspace's design/ directory.

FAQ

Q: What is the relationship between deepseek-ippt and the iPolloWork main project?

A: deepseek-ippt is a separate PPT sub-plugin published by iPolloWork for DeepSeek Harness (package.json name is deepseek-ippt), containing only browser resources needed for the PPT view; installing it won't download or launch the iPolloWork desktop client, nor will it pull in the Design (deepseek-idesign) and Video (deepseek-ivideo) plugins together.

Q: Where are slide files saved?

A: All files are written directly to the current registered workspace's design/<sessionId>-ippt/ directory (src/index.ts:9 / design-studio/src/index.ts:87-92), including index.html, design-tokens.css, manifest.json, brief.json, and other genuinely editable files. The -ippt suffix strictly isolates iDesign projects to prevent overwrites.

Q: Will Design or Video views be automatically included after installation?

A: No. PPT template filtering only allows templates with category === "slides" and surface === "design" (design-studio/src/index.ts:132-135). Website, poster, and report templates are provided by the separate deepseek-idesign plugin, and Video Studio is provided by deepseek-ivideo; the three plugins' project directories are isolated from each other.

Q: Will Ask AI automatically send messages?

A: No. Ask AI only organizes the current slide or selected element's file path, styles, and modification requirements as a conversation draft in the Harness input box (src/client.tsx:32-43), requiring user confirmation before manually sending to avoid uncontrollable AI-submitted changes.

Q: Will multiple people editing simultaneously overwrite each other's work?

A: No. Studio writes include baseUpdatedAt; if files have been modified since last loading, it returns a 409 conflict prompt for users to reload (studio-host/src/http.ts:161-163); writes themselves use temporary file + rename for atomic replacement to avoid half-written states.

Q: What formats can be exported?

A: It depends on template compatibility: templates marked PPTX-compatible can export PPTX (apps/app/.../design-panel.tsx:2556-2561), where text, shapes, and images are converted to editable PowerPoint objects; any PPT template can export PDF via html2canvas + jsPDF page-by-page screenshot export (design-panel.tsx:1155-1225).

Q: Is there a file size limit?

A: Yes. Both text files and HTTP request bodies have a 20 MB limit (design-studio/src/index.ts:60 / studio-host/src/http.ts:10, 140, 155), returning 413 when exceeded.

Q: How to uninstall?

A: Run dsh plugin --profile web remove deepseek-ippt. After uninstallation, the PPT view will disappear from the conversation tab bar, but the workspace's design/<sessionId>-ippt/ files won't be automatically deleted—please manually clean up if no longer needed.

Learning Curve

Beginner — No configuration needed after installation. Start creating by selecting PPT view in the conversation. AI generation, canvas fine-tuning, and Ask AI interactions can all be completed in the same interface without writing code or adjusting configuration files.

Known Issues & Limitations

  • Publishing to production not supported: Publishing capability is taken over by the iPolloWork main project. Like the Design plugin, the PPT plugin doesn't have built-in publishing capability to go online (reference iDesign's implementation in studio/src/deepseek-client.ts:76-80). The final deliverable needs to be obtained via PDF/PPTX export within Studio.
  • Can only read/write design/ subdirectory: All APIs force path restriction to the design/ prefix via safeRelativePath (design-studio/src/index.ts:75-77 / studio-host/src/http.ts:55-72). The plugin won't access other workspace directories.
  • Single file and request body limit of 20 MB: Single file read/write is constrained by MAX_TEXT_BYTES = 20 * 1024 * 1024 (design-studio/src/index.ts:60), and HTTP request body limit is also 20 MB (studio-host/src/http.ts:10), returning 413 when exceeded.
  • Directory enumeration limit of 1000 items: listFiles stops when traversing 1000 entries (design-studio/src/index.ts:61, 191). Large projects may not list all files.
  • Session ID format restricted: Must match ^[A-Za-z0-9_-]{1,128}$ (design-studio/src/index.ts:62). Session IDs that are too short or contain special characters will directly return 400.
  • PPTX export only valid for PPTX-compatible templates: Only templates built with markers like data-pptx-text / data-pptx-shape / data-pptx-image can export as editable PPTX. Other templates can only use PDF screenshot export (design-panel.tsx:451, 1380, 2556-2561 / pptx-compatible-export.ts:267, 305, 395).
  • Cross-plugin templates and projects won't interoperate: Installing only this package won't download deepseek-idesign or deepseek-ivideo templates. Design project directories won't be readable by the PPT plugin (README.md:128 / external-plugins/deepseek-harness/README.md:56).
  • Studio communication uses process-level token: iframe and host API authenticate with a 32-byte random token (design-studio/src/index.ts:281) and verify same-origin messages. Old tokens become invalid after DSH restart or workspace switch, requiring page refresh.

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/iPolloWork/external-plugins/deepseek-harness/ppt-studio)

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