Skip to main content

deepseek-harness-desktop-app/packages/dsh-product-bridge

606Stars32Forks6Issues0Watchers

Register 10 items/dialogs/Canvas/Office tools with ui_render into DSH Web Profile via IPC, with identity managed by the parent process.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
MIT
Branch
dev
agentic-workflowsai-agentai-workbenchdata-analysisdeepseek-harnessdesktop-appdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add @vibeinging/dsh-product-bridge

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 vibeinging/deepseek-harness-desktop-app/packages/dsh-product-bridge for me: review the repository at https://github.com/vibeinging/dsh-desktop 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

The product bridge Profile Bundle for DeepSeek Harness Desktop App. It registers 10 project/conversation/Canvas/Site/Office tools and ui_render to the current DSH Web Profile's Agent tool directory via IPC, and injects key context such as application instructions, project memory, and model targets into model steps in a controlled manner, enabling DSH to access desktop app's local data without modifying official source code.

Core Capabilities

  • Exposes 2 project context tools: project_list (lists projects visible to current user) and conversation_list (lists conversations under current project, supports including archived)
  • Exposes 4 Canvas/Site tools: canvas_inspect / canvas_create / canvas_edit / canvas_suggest, all based on immutable base versions; edit and suggest require prior inspect
  • Exposes 3 Office artifact tools: artifact_office_inspect / artifact_office_create / artifact_office_edit, covering Markdown / DOCX / XLSX / PPTX / PDF five formats
  • Exposes 1 structured UI tool ui_render: renders interactive interfaces within a bounded schema validated by parent process; buttons and forms only emit visible user messages
  • Contributes 5 workbench pages (Results & Evidence, Browser, Files, Artifacts, Site) to agent.workbench.tool product position via product.json; application shell reads from current Profile directory
  • Intercepts write tools: 5 write operations all trigger DSH's built-in approval flow; child process holds no identity or permissions, all handled by parent process binding authorized Session, user and project for post-processing

Technical Implementation

  • Language: JavaScript (ESM, "type": "module")
  • Key Dependencies: @deepseek-ai/cordis ^4.0.1、@deepseek-ai/dsh-agent ^0.1.0-rc.6、@deepseek-ai/dsh-invariants ^0.1.0-rc.6、@deepseek-ai/dsh-tools ^0.1.0-rc.6
  • Architecture Pattern: Cordis plugin (inject: ["agents","tools","webServer"]), declared as product-bridge type via cordis.patch.yml; workbench product position contributions declared via product.json; runtime uses IPC with parent process, child process only carries Session id
  • Entry File: packages/dsh-product-bridge/src/index.js (apply(ctx) is Cordis startup hook, contains IPC host, tool registration, memory/instruction injection, model target tracking, lifecycle cleanup)

Use Cases

Use this Bundle when you want DSH in DeepSeek Harness Desktop App to directly read/write local project files, Canvas, Office artifacts, and structured UI. It extends the official DSH Web Profile into a form capable of calling desktop app capabilities, eliminating the need to fork or maintain a local SDK. Regular users don't need to install it separately—it loads with the desktop app as part of Profile.

Prerequisites & Compatibility

DependencyMin VersionDescription
DSH Agent0.1.0-rc.6Explicitly pinned via peerDependencies to ^0.1.0-rc.6, must use next/rc.6 series; latest still points to old version
DSH Tools0.1.0-rc.6Same as above, peerDependencies locked
DSH Invariants0.1.0-rc.6Same as above, peerDependencies locked
Cordis^4.0.1Provides plugin runtime
Node^22.19.0 or >=24.0.0Declared in engines field
PlatformCross-platformFollows host desktop app (macOS / Windows / Linux)

Installation

dsh plugin --profile web add github:vibeinging/deepseek-harness-desktop-app/packages/dsh-product-bridge

Configuration

This plugin requires no additional configuration. All capabilities are statically injected via cordis.patch.yml (declares Cordis plugin type product-bridge), product.json (declares workbench 5 pages and display info), and package.json#dshWork/#dsh (declares Bundle metadata); runtime negotiates context with parent process via IPC.

FAQ

Q: After installing this package, what additional capabilities will DSH have?

A: DSH Agent tool directory will gain 10 tools: project_list / conversation_list for reading projects and conversations, 4 Canvas/Site tools (inspect/create/edit/suggest), 3 Office artifact tools (inspect/create/edit), and one ui_render for rendering structured interactive UI.

Q: How are these tools intercepted before the model sees them?

A: Any write tools that would modify desktop app's local data (canvas_create / canvas_edit / canvas_suggest / artifact_office_create / artifact_office_edit) all trigger DSH's built-in approval flow; the model must get user confirmation before proceeding.

Q: Child process only sends one Session id, who manages identity and permissions?

A: All handled by parent process (DeepSeek Harness Desktop App's Electron main process). After child process gets Session id and sends request, parent process binds it to the unique authorized Session, user and project, then processes project/conversation/Canvas/Site/Office requests; requests cannot cross identity or project boundaries.

Q: How are application instructions and project memory from context injected?

A: Before each model step, the bridge reads the parent process snapshot once, packages allowed application instructions, project instructions, global/project memory into immutable user messages attached to agent/pre-step batch, and marks them with dsh-work-context / dsh-work-memory sources; read failure only skips this supplementary step, won't replace user messages.

Q: Will child agents inherit parent agent's model configuration?

A: Yes. The bridge records the parent agent's finally resolved provider/model, and fixes the target when DSH creates a child agent before the first request, preventing child agent from falling back to process startup default model; parent agent's requests still follow its own normal settings.

Q: What's the relationship between this package and dsh-work-shell, dsh-theme-pack in the same repo?

A: All three belong to DeepSeek Harness Desktop App's private Profile Bundle trilogy: dsh-work-shell replaces default shell, dsh-theme-pack provides themes, dsh-product-bridge injects product tools; all three are required for complete desktop app functionality.

Q: If parent process closes, will child process leave unprocessed errors?

A: No. Runtime sends both ready message and product IPC as callback-style; parent process closing will normally win over late-arriving Loader, unsent requests get rejected instead of becoming unhandled channel errors.

Q: Can third-party Bundles bypass this mechanism to inject UI into renderer process?

A: No. Community Bundles containing dsh.client get rejected during pre-check phase; workbench pages only render components in local whitelist; user-installed Bundles cannot run Client code, nor enter Renderer relying only on JSON names.

Difficulty

Advanced — requires understanding DSH Profile Bundle, Cordis injection points, and IPC mechanism to modify; regular users typically don't need manual adjustment.

Known Issues & Limitations

  • peerDependencies forced to lock to 0.1.0-rc.6 because some leaf packages' latest still points to old version; during development, linking DSH source or mixing different RC series will break compatibility
  • This package is private (package.json marks private: true), not published to public registry; final product must carry the same reviewed version and matching official NPM SDK version
  • rc.6 SDK no longer ships original ProductHost and project tool packages; tools and IPC bridge are held directly by this Bundle; when upgrading DSH SDK, need to sync adjustments
  • KV Cache: Bundle version or order changes within same Profile will restart DSH runtime; reusable tool prefixes may change
  • Regular request 30 second timeout, write operation approval end-to-end 60 second timeout (PRODUCT_REQUEST_TIMEOUT_MS / PRODUCT_MCP_TIMEOUT_MS)
  • Removed "project Plugin mount, Skill, MCP data" directory method returns empty directory, continued management by DSH native registry

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/vibeinging/deepseek-harness-desktop-app/packages/dsh-product-bridge)

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