lj970926/dsh-plugin-mermaid

Plugin插件 Native原生 ⭐ 4 MIT Data & Analysis数据与分析

DeepSeek Harness Web 客户端插件:通过图表/源码切换来渲染 mermaid 代码块。

Project Overview项目介绍

This is a native plugin built exclusively for the DeepSeek Harness (DSH) web client, designed to add Mermaid diagram rendering support to DSH chat messages. It adds a toggle to switch between the raw Mermaid source code and the rendered SVG diagram, and automatically syncs its theme with DSH’s active dark or light appearance setting. The recommended install method is via the DSH CLI, running dsh plugin --profile web add github:lj970926/dsh-plugin-mermaid to pull the prebuilt package directly. After installation, you just need to restart dsh web and hard-refresh your browser to activate the plugin.

The plugin loads Mermaid v11 on demand from a public CDN, so it does not add unnecessary bloat to your DSH installation. It includes a 500ms debounce to prevent excessive re-renders when Mermaid code is streaming token by token from the LLM. It integrates natively with DSH’s existing code block banner UI, placing its toggle buttons right next to the default Copy button, and keeps Shiki syntax highlighting for the source view. This keeps the UI consistent with DSH’s native interface and does not require any extra configuration from users after installation.

This plugin requires DSH version 0.1.0-rc.6 or newer to work correctly. On first render, you need an active internet connection to load Mermaid from the jsDelivr CDN, after which Mermaid is cached by your browser. The plugin is released under the open source MIT license, and supports multiple alternate install methods including local development checkout, legacy script install, and manual install. Uninstalling only requires removing the plugin entry from your DSH profile’s cordis.patch.yml and deleting the plugin folder, then restarting dsh web.

这是一款专为DeepSeek Harness(DSH)网页客户端打造的原生插件,功能是渲染聊天消息中的Mermaid代码块。它支持在Mermaid源码和渲染后的图表之间互相切换,还能自动跟随DSH的深浅主题变更适配显示。用户可以直接通过DSH命令行工具一键安装,不需要本地编译构建步骤,安装后重启DSH网页服务并刷新浏览器即可使用。

插件采用按需加载的方式从CDN获取Mermaid v11资源,不会增大DSH的安装包体积。它自带500毫秒防抖处理,避免流式输出token时反复触发渲染,还原生集成了DSH的代码块栏,切换按钮就放在默认的复制按钮旁边,源码查看保留了Shiki语法高亮和复制功能。

插件要求DSH版本不低于0.1.0-rc.6,首次渲染需要访问cdn.jsdelivr.net加载Mermaid资源,后续浏览器会缓存资源。它采用MIT许可证开源,除了推荐的命令行安装,还支持本地检出、脚本和手动多种安装方式,卸载也只需要简单两步即可完成。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:lj970926/dsh-plugin-mermaid

把 lj970926/dsh-plugin-mermaid 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-mermaid

License: MIT Topic: dsh-plugin DSH version

A DeepSeek Harness (DSH) web client plugin that renders ```mermaid code blocks in chat messages, with a chart ↔ source toggle and live theme switching.

  • Mermaid v11 loaded on demand from a CDN (no bundle bloat).
  • Follows DSH dark/light theme automatically.
  • 500 ms debounce so streaming tokens don't thrash the renderer.
  • Native DSH code-block banner integration: buttons sit right next to the built-in Copy button; source view keeps Shiki highlight and copy.
  • Zero build step — the browser entry is hand-written factory-form CJS exactly as DSH's client-modules service expects.

Install

From GitHub (recommended)

This package ships prebuilt lib/ files and declares dsh.bundle, so it can be installed directly into the DSH web profile:

dsh plugin --profile web add github:lj970926/dsh-plugin-mermaid

Then restart dsh web and hard-refresh the browser (Cmd+Shift+R).

To pin a revision for reproducibility, append a commit SHA or tag:

dsh plugin --profile web add github:lj970926/dsh-plugin-mermaid#<commit-or-tag>

Because the published files are already in lib/, this package has no prepare build step and does not require pnpm allowBuilds authorization. If you fork the repository and add a build step, follow DSH's packaging docs and add the package key under allowBuilds in the profile's pnpm-workspace.yaml when prompted.

From a local checkout

If you are developing the plugin, install the checkout as a linked bundle:

dsh plugin --profile web add /absolute/path/to/dsh-plugin-mermaid

Legacy copy script

The repository also keeps install.sh for copying files directly into an existing web profile:

git clone https://github.com/lj970926/dsh-plugin-mermaid.git
bash dsh-plugin-mermaid/install.sh

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-mindmap 下一个 Next dsh-models-dev-reasoning →