前言¶

在 DSH（DeepSeek Harness）的使用场景中，智能体生成的输出常为 Markdown 文件。点击这些链接时，系统通常会唤起默认的 Markdown 编辑器或查看器，这会打断当前的工作流，需要频繁切换窗口。我们需要一种方式，能在 DSH 界面内直接预览这些文档。

插件介绍¶

dsh-markdown-link-preview 是一个由 Lukeknow0 维护的插件。它的核心作用是拦截聊天区中指向同源 Markdown 文件的点击事件，将内容直接渲染在 DSH Better Sidebar 中，替代外部应用打开。

安装与前置条件¶

安装前，请确保已安装并启用 dsh-better-sidebar 插件。

执行以下命令安装插件：

dsh plugin --profile web add github:Lukeknow0/dsh-markdown-link-preview

安装完成后，重启或刷新 DSH Web 页面。

核心功能¶

该插件主要提供以下能力：

• 点击捕获与渲染：捕获聊天区中指向同源 Markdown 文件的普通左键点击，在侧边栏中为每个文档打开独立标签。
• 多文档并排：支持在侧边栏中同时打开多个 Markdown 文件，便于对照阅读。
• Markdown 渲染：支持 GitHub Flavored Markdown、代码块、表格、图片以及相对链接的渲染。
• 安全清洗：使用 marked 进行解析，并配合 DOMPurify 对生成的 HTML 进行清洗，防止 XSS 攻击。
• 同源限制：仅接管与 DSH 页面同源的 HTTP(S) URL。插件不会接管跨域链接、file:、data: 或 javascript: URL。
• 保留原生行为：对于 Cmd/Ctrl 点击、右键菜单或新窗口操作，完全保留原始浏览器行为，不进行干预。

适用场景与注意¶

• 依赖环境：该插件依赖 dsh-better-sidebar 插件运行，且要求 React 版本不低于 18.2.0。
• 隐私与安全：插件不上传文档内容，不连接任何远程服务。Markdown HTML 在渲染前会经过 DOMPurify 清洗。
• 源码审查：虽然许可证为 MIT，但在生产环境使用前，建议检查 GitHub 仓库源码，确保符合当前的安全与合规要求。

总结¶

通过 dsh-markdown-link-preview，可以在 DSH Better Sidebar 中无缝预览同源 Markdown 文件，避免频繁切换外部应用。插件通过同源限制和 DOMPurify 清洗保障了基本的安全性。更多细节可访问 GitHub 仓库。