Introduction

In DSH sessions, Agents can typically read articles and provide understanding. However, some tasks require not just “reading” but organizing content into editable diagrams: adding nodes, adjusting connections, and reflowing according to reports or architecture descriptions. dsh-diagram addresses this need: it converts the article content within the current Agent Session into an Excalidraw canvas, allowing you to continue editing, auto-saving, and exporting within DSH’s Canvas.

What is this

dsh-diagram is a DSH plugin maintained by hanzhangzzz. The current description provided is: converting articles in DeepSeek Harness into an editable Excalidraw canvas.

It runs on the web profile, the built-in editor is Excalidraw 0.18.1, and data is stored in a DSH storage-domain sidecar owned by the plugin. The plugin is not responsible for fetching articles or injecting UI into arbitrary websites; article acquisition is still handled by DSH sessions, file tools, or web tools.

Core Features

Below are several entry points related to sessions, editing, and exporting.

Graph Creation and Reading

  • diagram_create: Creates a graph for the current Agent Session based on a compact semantic specification.
  • diagram_read: Reads a bounded summary of the current editable scene into the session log, facilitating the Agent to continue working after manual modifications.

Routing and Preview

  • canvas-diagram is a built-in bilingual routing entry that can be selected from the composer or menu and matches general drawing requests.
  • Upon completion of diagram_create, an inline preview card appears in the session, rendering the current graph content as a static SVG.

Editing, Saving, and Exporting

  • The Canvas tab opens the Excalidraw editor only when selected, avoiding the chat startup path.
  • The diagram list is used to switch between diagrams; on narrow screens, it becomes a selector.
  • Auto-save provides debounced persistent writing, along with revision conflict protection and local pending-draft recovery for tabs.
  • Export allows downloading .excalidraw, SVG, or PNG files.

Supported Graph Types

Types listed in the documentation include: report dashboards, flowcharts, architecture diagrams, timelines, hierarchies, comparison charts, and relationship graphs.

Installation and Enablement

First, ensure the environment meets the following requirements:

  • DeepSeek Harness: 0.1.0-rc.6
  • Node.js: ^22.19.0 or >=24.0.0
  • pnpm: >=10 and in PATH
  • DSH Web: Bound to 127.0.0.1

The installation command provided is:

npx -y @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add dsh-diagram@latest

This command adds the plugin to the web profile. After adding or updating the plugin, if DSH Web is running, DSH Web needs to be restarted.

The installation artifact is a pre-built npm package or a GitHub Release tarball with SHA-256 checksum; the npm package has no install lifecycle script. Deleting the plugin bundle will not delete saved graph sidecar data.

Typical Usage

Here is a reproducible usage path:

  1. Open a DSH session that already contains an article.

  2. Type / in the composer and select canvas-diagram. You can also use natural language requests, for example:

把这篇文章画成架构图
  1. If you want the Agent to explicitly perform the creation action, you can use an explicit prompt:
Create one clear diagram for this article. Choose the most suitable diagram type, call diagram_create, and keep the title and node labels concise.

  1. After the tool completes, select the Canvas tab.

  2. Edit the diagram in the canvas and export the result; if you want the Agent to continue working based on your modified scene, you can ask it to call diagram_read.

Scenarios and Notes

Suitable for people processing long content like articles, reports, and architecture descriptions in DSH sessions who wish to preserve the output as an editable canvas.

Notes before installation and use:

  • The plugin runs with the current dsh process permissions; check the source code and license before installing.
  • Graph data is bound to its Session id and {createdAt, cwd} lifecycle fingerprint; reusing a Session id cannot read old data.
  • Session fork and Session export do not copy or include graph sidecar data.
  • Editor assets and fonts are self-hosted by the bundle; the canvas does not rely on external CDNs.
  • The community plugin directory is an independent site with no official affiliation to DeepSeek or Hypersphere; do not interpret it as an official app store.

Conclusion

Following the steps above, dsh-diagram can convert article understanding in DSH sessions into a maintainable Excalidraw canvas: creation, preview, editing, saving, and export are all completed within the same session workflow.

Project links:

  • GitHub: https://github.com/hanzhangzzz/dsh-diagram
  • Directory page (provided in documentation, please confirm site availability before use): https://www.skillhub.cn/plugins/hanzhangzzz/dsh-diagram