@lizhecome/dsh-flowchart
适用于 DeepSeek Harness 的精美主题 SVG 流程图工具包
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lizhecome/deepseek-harness-flowchart#b7cc45be4727fd15b1909f9bd6040a39dda592f0Flowchart 以 @lizhecome/dsh-flowchart 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
An installable DeepSeek Harness profile bundle that adds a render_flowchart tool. The tool turns Mermaid flowchart source into a polished, themed, self-contained SVG and delegates file creation to Harness's existing write tool.
Requires DeepSeek Harness 0.1.0-rc.6 or later and GitHub CLI access to this private repository.
gh repo clone lizhecome/deepseek-harness-flowchart
cd deepseek-harness-flowchart
dsh plugin --profile web add --ignore-workspace-root-check .
Use headless instead of web for one-shot tasks. DeepSeek Harness anchors add . to the invoking checkout before pnpm switches to the profile directory. The package manifest declares a dsh.bundle patch, so installation mounts the tool and its invariant companion automatically.
To remove it:
dsh plugin --profile web remove --ignore-workspace-root-check @lizhecome/dsh-flowchart
Ask the agent for a flowchart and name the SVG destination, for example:
Create a left-to-right flowchart of the checkout process and save it as docs/checkout.svg. Use the catppuccin-mocha theme.
The model calls render_flowchart with Mermaid source similar to:
flowchart LR
cart([Cart]) --> payment{Payment valid?}
payment -->|Yes| success([Order placed])
payment -->|No| retry[Retry payment]
retry --> payment
The tool accepts only Mermaid flowchart/graph documents with an explicit TD, TB, BT, LR, or RL direction. The destination must end in .svg.
| Argument | Required | Meaning |
|---|---|---|
source | yes | Complete Mermaid flowchart source. |
file_path | yes | SVG destination resolved by the installed write tool. |
theme | no | One of the 15 themes below; defaults to the deployment setting. |
transparent | no | Remove the theme background; default false. |
padding | no | Canvas padding, 0–200; default 40. |
node_spacing | no | Horizontal sibling spacing, 8–160; default 24. |
layer_spacing | no | Vertical layer spacing, 8–240; default 40. |
Themes: zinc-light, zinc-dark, tokyo-night, tokyo-night-storm, tokyo-night-light, catppuccin-mocha, catppuccin-latte, nord, nord-light, dracula, github-light, github-dark, solarized-light, solarized-dark, and one-dark.
Later profile patches replace a row's complete config, so restate every field you want to keep:
- id: flowchart
config:
defaultTheme: github-light
maxSourceChars: 50000
maxSvgBytes: 2000000
| Field | Default | Meaning |
|---|---|---|
defaultTheme | tokyo-night | Theme used when a tool call omits theme. |
maxSourceChars | 50000 | Positive integer limit on complete Mermaid input. |
maxSvgBytes | 2000000 | Positive integer limit on the complete UTF-8 SVG. |
Invalid bounds or an unavailable configured theme fail at plugin load.
The plugin never writes through Node's ambient filesystem. It dispatches the generated content to the registered Harness write tool as a nested call, so tool restrictions, approval, sandbox policy, read-before-overwrite rules, cancellation, and final result normalization remain authoritative. If write is unavailable or denied, render_flowchart fails without claiming success.
Before dispatching the SVG, the plugin removes renderer-owned external font imports, rejects scripts, event handlers, embedded browser documents, JavaScript URLs, and external href values, and applies maxSvgBytes to the complete self-contained result.
The model sees one tool schema. A successful call returns only the output path, theme, and byte count; the SVG body is passed to the nested write tool but is not copied into the parent model result. Changing package configuration or tool availability changes the request's tool-schema prefix.
Rendering is local and deterministic; it makes no LLM or network request. The implementation uses beautiful-mermaid 1.1.3 for Mermaid parsing, layout, theming, and SVG generation.
write tool policy and may require the agent to read the file first.Inter or system sans-serif font.pnpm install
pnpm run check
Tests boot the published Harness tool runtime, filesystem provider, and real write tool. They verify themed SVG creation, concise result/file agreement, limits, unsupported input, missing-write failure, presentation metadata, and registration disposal.