DeepSeek Harness Hub
← 返回列表

MrmoLabs/dsh-mermaid

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
✓ 可直接安装

在 DeepSeek Harness Web 会话中把 Mermaid 围栏代码块渲染为 SVG 图形,并提供代码 /…

自动检查通过:npm 包已发布且 engines 声明满足基线(声明 Node >=22.19.0);该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/9/5 · 已提供中文文档

在 DeepSeek Harness Web 中将 Mermaid 代码块渲染为 SVG 图表,支持图表/代码切换、流式传输、深色模式、严格安全性以及 npm/GitHub 安装。

综合分
39.3
GitHub 分
39.3
用户评分
★ Stars
11
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dsh-mermaid
npm 包 dsh-mermaid 已校验归属本仓库,走 npm 安装最省事
数据截至 2026/9/19(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包dsh-mermaid @ 0.4.0
Node 引擎要求 >=22.19.0 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/19 16:49:14

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dsh-mermaid

简体中文 | English

在 DeepSeek Harness Web 会话中把 Mermaid 围栏代码块渲染为 SVG 图形,并提供代码 / 图形双向切换。插件支持流式输出、深色主题、全屏查看、缩放与拖拽、SVG 导出,并在渲染失败时自动回退到源代码。

npm version

功能特性

- 支持 mermaid、mermaidjs 和 mmd 围栏代码块
- 兼容 DSH/Shiki plain fallback,此时代码元素可能没有 language class
- 固定并打包 Mermaid 11.17.0,运行时不依赖 CDN
- 仅在首次检测到 Mermaid 代码块后,才从 DSH 同源加载已打包的 Mermaid 运行时
- 多图通过串行队列逐个渲染,并在图形之间让出主线程,降低页面卡顿
- 使用 Mermaid securityLevel: strict
- 抑制 Mermaid 内置的解析错误 SVG,使渲染失败时干净地回退源码,不在页面中遗留临时错误图
- 支持全屏查看,并提供缩放、拖拽、恢复 100% 和适应窗口操作
- 全屏查看时把键盘焦点限制在对话框内、隔离背景内容,并在关闭后把焦点还给触发按钮
- 向辅助技术播报渲染与下载状态,并为生成的 SVG 图形提供可访问名称
- 可直接通过卡片按钮把已渲染图形导出为独立 SVG 文件
- 在代码和图形视图中始终提供全屏与 SVG 下载操作,并在切换时保持工具栏位置稳定
- 根据页面和浏览器语言自动使用简体中文或英文界面及状态文案
- 只增强  代码块,不处理行内代码
- 防止旧的异步渲染结果覆盖较新的流式内容
- 单图超过 50,000 字符或 2,000 行时,在调用 Mermaid 前拒绝渲染并回退源码

兼容性

最后验证环境为 2026-09-05 的 @deepseek-ai/dsh 0.1.2-rc.1 与 Node.js 22.23.2。DSH 当前仍处于开发预览阶段,后续版本可能包含破坏性兼容变化;如果新版 DSH 调整了插件加载器或 Markdown DOM,请提交 issue。

安装

如果已经全局安装 dsh,通过 npm 稳定版安装:

dsh plugin --profile web add -w dsh-mermaid

如果没有全局 dsh 命令,可以通过 npx 调用 DSH:

npx.cmd --yes @deepseek-ai/dsh plugin --profile web add -w dsh-mermaid

DSH 会通过 pnpm 安装包、识别其中的 dsh.bundle 声明,并自动把 dsh-mermaid 加入 web profile 的 bundles。安装完成后重启 DSH Web 或刷新页面。

安装 GitHub 最新源码版

npx.cmd -y github:MrmoLabs/dsh-mermaid install

该命令会运行仓库提供的 dsh-mermaid 安装器,再让 DSH 把 GitHub 源安装到 web profile。GitHub 源会在安装阶段构建。如果 pnpm 提示阻止了 build script,请把它输出的精确包名加入 profile 的 pnpm-workspace.yaml allowBuilds,然后重新执行命令。普通用户建议优先使用 npm 稳定版。

更新和卸载

更新 npm 稳定版:

dsh plugin --profile web update -w dsh-mermaid

卸载:

dsh plugin --profile web remove -w dsh-mermaid

更新或卸载后请重启 DSH Web。

使用方法

让模型输出 Mermaid 围栏代码块:

mermaid
flowchart LR
A[代码] --> B[图形]

代码块上方会出现代码 / 图形按钮,默认显示图形。

从源码开发

需要 Node.js 22.19 或更高版本。

npm.cmd install
npm.cmd run check
npm.cmd run build
dsh plugin --profile web add -w .

构建产物位于 lib/。轻量的 client.js 启动器由 DSH 客户端模块加载器注册为 dsh-mermaid,打包后的 Mermaid 运行时则通过插件的同源宿主路由按需加载。DSH 会以当前插件项目为基准解析相对安装路径。

本地开发时,也可以手动把构建后的包复制到:

C:\Users\\.dsh\profiles\web\node_modules\dsh-mermaid

不要把整个 .dsh 目录提交到 Git,其中可能包含会话和凭据。

发布检查

npm.cmd run check
npm.cmd run build
npm.cmd pack --dry-run
git status --short
git diff --cached

许可证

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群