前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许用户根据实际需求扩展功能。在对话中插入 Mermaid 图表是常见需求，但浏览器原生的渲染往往缺乏交互性，难以进行缩放或局部查看。dsh-chat-enhancer 插件专注于解决这一问题，通过专门的预览窗口提升图表的可读性与操作体验。
插件简介¶
这是一个由 Tieboyh 维护的插件，旨在为 DeepSeek Harness Web 提供聚焦的对话增强功能。它从 Mermaid 图表的可视化交互入手，通过居中预览、缩放与平移等功能，改善开发与讨论过程中的图表展示效果。
核心功能¶
该插件当前版本 0.2 的核心能力集中在 Mermaid 代码块的处理上：
- 多格式渲染：支持将对话中的
mermaid、mermaidjs和mmdfenced blocks 直接渲染为 SVG。 - 居中预览窗口：图表不再占据浏览器全屏，而是在一个居中的预览窗口中显示，保持上下文。
- 平滑缩放：提供以指针为中心的鼠标滚轮缩放，操作手感平滑。
- 平移与控制：支持点击拖拽平移，并提供“适应窗口”、“100% 缩放”以及通过键盘快捷键控制视图。
- 主题响应：当 DSH 的浅色或深色主题切换时，图表会自动重新渲染以适配当前配色。
- 安全与容错：使用 Mermaid 的
securityLevel: strict，若渲染失败则回退显示源码。
安装与启用¶
在终端中执行以下命令即可安装插件：
dsh plugin --profile web add dsh-chat-enhancer
安装、升级或移除插件后，需要重启 DSH Web 才能生效。
典型用法¶
在对话中请求模型返回 Mermaid 代码块，例如：
```mermaid
flowchart LR
A[开始] --> B[完成]
```
点击渲染结果上的“Open”按钮进入预览窗口。在预览窗口内：
- 缩放：滚动鼠标滚轮围绕指针缩放，或使用
+/-键。 - 平移：按住鼠标左键拖动。
- 视图控制：按下
0键适应窗口，按下Esc键关闭预览。
注意事项¶
该插件使用 Mermaid 的严格安全级别，渲染出错时会回退显示源码。安装后请务必重启 DSH Web 进程。
总结¶
dsh-chat-enhancer 通过引入专门的预览交互层，解决了 Mermaid 图表在纯文本对话中难以精细查看的问题。对于需要频繁讨论架构、流程或数据流的技术场景，该插件能提供更清晰的视觉反馈。
