dsh-pele-mermaid
在终端中运行以下命令:
dsh plugin install A-Zee029/dsh-pele-mermaid
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install A-Zee029/dsh-pele-mermaid 安装本插件(源码:https://github.com/A-Zee029/dsh-pele-mermaid),安装后重启 DSH 或重载 Web GUI。
插件介绍
DeepSeek Harness 自带的侧边栏文档预览会把 Markdown 当成纯文本展示,其中的 Mermaid 代码块只能看到源码,无法在界面里直接读图。对话区同样缺少针对围栏代码块的专用渲染路径,Mermaid 往往只是一段未高亮的 pre。这个插件用 Pele——轻量、无额外依赖、可换肤的 Mermaid 转 SVG 引擎——在 Web GUI 里补上这一块。
在文档侧,它为 .md、.markdown、.mmd、.mermaid 注册「Markdown + Mermaid」预览并设为默认:带 mermaid 标签的围栏块渲染成 SVG,样式跟随 DSH 主题令牌在明暗模式下切换;其余内容仍走原有 Markdown 流程。整份 .mmd / .mermaid 文件则整页当作一张图。解析失败会显示错误信息,预览头里可随时切回内置 Markdown 渲染。
聊天 transcript 通过 conversation 的 turnTail 插槽监听 DOM:识别形状与内容都像 Mermaid 的代码块,在原地隐藏源码并在旁插入 Pele 生成的 SVG,尽量不干扰流式输出与 React 更新;尚未解析完成时仍显示普通代码块。过高的图在对话列里收成约 340px 的紧凑卡片,点击后用 shell.overlay 打开全宽查看器,支持拖拽平移、滚轮缩放、适应图幅/适应宽度/1:1/重置与 Esc 关闭;较矮的图仍内联展示。
适合经常在 Harness 里写架构图、流程图、时序图的人——无论是 README、设计文档还是助手回复里的 mermaid 块,都希望「打开就能看图」而不是对着源码脑补的用户。
截图预览
使用场景
- 在侧边栏预览 README 或设计文档里的 Mermaid 围栏块
- 在助手回复中直接查看流程图、架构图而非源码
- 打开 .mmd 或 .mermaid 文件整页当作一张图阅读
适合人员
- 在 Harness 里写带 Mermaid 的 Markdown 文档的用户
- 需要在对话 transcript 里快速读懂图表的开发者
- 经常维护架构图、时序图、流程图的技术写作者