DSH Design Mode

中文

An image-first Design Mode for DeepSeek Harness, built on the idea that everything is a plugin.

DSH Design Mode connects the native DSH conversation to an infinite canvas, guided intent clarification, focused image tools, and location-aware comments. The goal is not to put another image generator beside chat. The goal is to make the whole image workflow—from an ambiguous idea to a traceable series of edits—part of one Agent session.

Developer preview based on dsh-v0.1.1-rc.2. This is an independent community project and is not an official DeepSeek release.

Why this exists

Powerful open design environments can expose too many choices before a new user has a clear brief. DSH Design Mode starts from ordinary language, lets the Agent clarify material ambiguity, and opens the canvas only when there is an image to work with. Experienced users still get direct tools, while new users get a guided path instead of a wall of controls.

What is included

• Intent-first entry: Design Mode can be armed and disarmed. Arming it does not open an empty canvas; sending text, an image, or both starts the workflow.
• Adaptive ask_user: new-image requests use 3–5 sequential clarification cards. Each card provides three suggested choices plus a UI-owned “Other” input.
• Infinite canvas: pan, pointer-centered zoom, selection, multi-selection, move, proportional resize, rotate, lock, hide, download, fit-to-view, and local undo/redo.
• Image-only creation: upload, paste, drop, generate, or add an existing chat image. Video generation and video controls are intentionally excluded from v1.
• Task-specific tools: background removal/replacement, erase, upscale, outpaint, OCR-assisted text editing and translation, angle change, recolor, and authorized mark removal.
• Location-aware comments: point, rectangle, and brush comments return to the native conversation. Multiple comments are processed in order so the chat remains the auditable record of every change.
• One Host-owned gateway: the UI and Agent call the same Design service, job queue, persistence layer, and provider routing.
• Private credentials: OPENAI_API_KEY and FAL_KEY are read from the DSH credential vault and never shipped to the browser or written into the workspace.
• Desktop and Web: the same profile and browser surface run in both DSH Desktop and DSH Web.
• Canvas export: PNG, PDF, standalone HTML, ZIP, and PPTX.

Demo chapters

The repository includes four compressed walkthroughs recorded from the working build:

1. Enter Design Mode and start from chat
2. Clarify an image request with ask_user
3. Work on the canvas with object tools
4. Place comments and continue the edit in chat

The interactive product story is in showcase/. Run it with npm install && npm run dev.

The editable investor/client deck is available as DSH Design Mode product introduction (PPTX).

Run the Design profile from source

Requirements: Node.js compatible with the upstream DSH checkout and pnpm.

git clone https://github.com/KaichenCurry/dsh-design-mode.git
cd dsh-design-mode
corepack enable
pnpm install
pnpm run build
pnpm run design:install
pnpm run design:start

The installer creates an isolated design profile. It does not replace the normal DSH executable or change the default web profile.

Useful commands:

pnpm run design:status
pnpm run design:upgrade
pnpm run design:uninstall

Canvas, comments, context, persistence, and keyless contract tests work without provider credentials. For real provider jobs, open Settings → Design Mode and add the required key to the write-only credential surface.

Architecture

Native DSH Composer
  ├─ text / images / removable Design context chips
  └─ ask_user clarification
          ↓
DSH Agent
  ├─ design_read_context
  ├─ design_generate_image
  ├─ design_edit_image
  └─ design_update_comments
          ↓
Design Job Router + per-session queue
  ├─ GPT Image: generation and generative editing
  ├─ FAL providers: background removal and upscale
  └─ OCR provider: region detection for text workflows
          ↓
Local canvas document, assets, comments, versions, and journal

The core packages are:

• packages/design/design-mode: Host service, storage, provider routing, and Agent tools.
• packages/client/ui-design-mode: React/Konva canvas and DSH client integration.
• packages/bundle/design-app: optional bundle layer used by the isolated design profile.

Privacy and safety

• Only assets referenced by the current job are sent to the selected provider.
• Local canvas documents and history stay in the workspace.
• Provider failures never trigger an automatic paid retry.
• Watermark/mark removal requires the user to confirm ownership or authorization.
• Do not commit .env files, workspace data, or provider keys. See SECURITY.md.

Roadmap

• Strengthen real-provider success/failure smoke tests and cost-aware routing.
• Package signed Desktop installers and reproducible upgrade/uninstall flows.
• Add team review, permissions, approvals, and shared asset governance.
• Open an adapter surface for third-party providers, Agent skills, and reusable workflows.

License and attribution

This repository is derived from DeepSeek Harness and retains its MIT license and third-party notices. New Design Mode code is released under the same MIT license. DeepSeek and DeepSeek Harness are trademarks of their respective owners.