跳到主内容

dsh-mermaid 使用指南

在 DSH Web 会话中把 Mermaid 代码块渲染为 SVG 图表。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

在 DSH Web 会话中把 Mermaid 代码块渲染为 SVG 图表。

— 源: plugins.ai_summary

安装与验证

dsh plugin --profile web add dsh-mermaid

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • Host 半部(src/index.ts):注册 webServer 前缀路由 /mermaid-dist,从插件自己的 node_modules/mermaid 惰性提供 UMD 构建,并提供固定的 config.json 端点。
  • Client 半部(src/client/):监听会话 DOM,把 infostring 为 mermaid 的围栏渲染为 SVG:
    • id: mermaid
  • 助手输出不可信:securityLevel 锁定 strict,标签中的 HTML 由 mermaid 内部 DOMPurify 消毒;不调用 bindFunctions,点击处理保持惰性。
  • 渲染失败时保留原纯文本代码块(绝不渲染错误 HTML),并在图框下方显示错误摘要(可复制、可一键发送给 AI 修复);控制台同时输出完整错误。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则