前言¶
在 DeepSeek Harness（DSH）的 web 会话中，点击 .md 引用时，常见做法是跳转到系统编辑器查看源文件。这会离开当前对话上下文，尤其在校对、改稿或对照输出结果时不太方便。
poiuyjie/dsh-md-preview 针对这个流程，把 .md 预览放到 DSH 右侧栏并排打开，而不是直接启动系统默认编辑器。下面介绍它的定位、功能、安装方式和典型用法。
这是什么¶
dsh-md-preview 是 DeepSeek Harness 的一个 Markdown 预览插件，仓库为 poiuyjie/dsh-md-preview，由 poiuyjie 维护，许可证为 MIT。
它解决的是 DSH web 会话中的一个具体问题：点击对话中的 .md 引用时，在右侧栏并排预览该文件，同时记录本会话访问过的 .md 文件。
根据 package.json，插件声明 node >=20.3。插件本体为纯 JS，无构建步骤，client 半边支持 HMR。
核心功能¶
核心能力如下：
- 右侧栏并排预览
.md引用，与对话内容顶部对齐、宽度可拖。 - 会话隔离的最近
.md文件列表，记录本会话读写/打开过的文件。 - 支持浮动窗口和右侧停靠两种打开方式，位置/大小记忆。
- 按住
Ctrl/Cmd/Shift点击.md引用时，仍用系统默认应用打开。 - 支持手动输入相对工作目录的
.md路径打开预览。 - 完整 Markdown 渲染：标题、列表、表格、代码块、引用、行内代码、公式片段、图片链接。
- 跟随 DSH shell 的深色/浅色主题自动切换。
- 提供「对话/轨迹」栏页签和整页「MD 预览」页签。
- 可与
dsh-vision-opencode搭配，用于视觉验证与源稿预览工作流。
安装与启用¶
推荐安装¶
先确认 DSH profile 为 web，然后执行：
dsh plugin --profile web add github:poiuyjie/dsh-md-preview
这条命令用于添加插件。Windows 下需把 dsh 换成 dsh.ps1，或使用：
powershell dsh.ps1
安装注意¶
推荐用 dsh plugin add 原生安装。不要只用 npm pkg set 代替：后者不会下载包，也不会把插件登记进 dsh.profile.bundles 装配层。
如果使用手动安装方式，需要在 profile 的 cordis.patch.yml 中启用 md-preview insert 条目：
- insert:
- id: md-preview
name: 'dsh-md-preview'
pnpm 注意¶
如果 profile 使用 pnpm，且采用 file: 本地依赖，注意本地依赖会被快照复制到 node_modules/.pnpm/。修改源码后，需要重新执行 pnpm install，或手动把修改后的文件同步到对应目录，再刷新页面。
典型用法¶
经过上面的安装步骤，刷新页面后，可以按下面方式使用。
1、点击会话头部的「MD 预览」按钮打开面板。
2、面板默认显示本会话最近访问的 .md 文件卡片，包括文件名、路径、操作历史和摘要。
3、点击对话消息流中的 .md 引用，右侧栏会自动打开并加载该文件。
4、拖动面板左缘分隔线调整宽度；点「浮动」切换浮动窗口；点关闭按钮收起面板。
5、按住 Ctrl/Cmd/Shift 点击 .md 引用，仍会用系统默认应用打开。
6、也可以输入相对工作目录的 .md 路径，手动打开预览。
与 dsh-vision-opencode 搭配¶
如果需要在视觉验证和源稿预览之间切换，可以搭配 dsh-vision-opencode。安装命令如下：
dsh plugin --profile web add github:poiuyjie/dsh-vision-opencode
dsh plugin --profile web add github:poiuyjie/dsh-md-preview
这个组合用于视觉验证与源稿预览工作流：一边查看渲染或验证结果，一边对照右侧的 Markdown 源稿。
卸载与注意事项¶
卸载插件只会移除预览面板功能，不会删除 .md 文件或会话记录。
插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。本插件许可证为 MIT，仓库地址为：
https://github.com/poiuyjie/dsh-md-preview
结尾¶
如果你希望在 DSH web 会话中频繁查看 .md 源稿，同时保持对话上下文，dsh-md-preview 的价值比较直接：右侧并排预览、会话内最近文件列表、跟随主题切换，以及和 dsh-vision-opencode 搭配使用。
目录页：
https://www.skillhub.cn/plugins/poiuyjie/dsh-md-preview
GitHub：
https://github.com/poiuyjie/dsh-md-preview
