对话里点开 .md，不再跳 VSCode——右侧并排预览，随手可读。

DeepSeek Harness（DSH）插件：在会话头部加一个「MD 预览」入口，自动跟踪本会话读写/打开过的 .md 文件，点击对话中的 md 引用时在右侧栏并排打开预览，而不是跳转到系统编辑器（如 VSCode）。

与 dsh-vision-opencode 协同

本插件与 dsh-vision-opencode 配合使用，效果成倍提升——它也是在这个视觉插件的能力基础上开发完善起来的：

• 视觉驱动的工作流闭环：dsh-vision-opencode 给纯文本主模型补上识图能力（vision_read_image），让模型能"看见"渲染出的文档页面；而本插件让你在右侧栏即时打开并排预览对应的 .md 源文件——先看渲染图，再对照源稿，改稿、验证、记录一气呵成
• 图文对照：左侧对话流里是视觉验证结论（"表格 III 渲染干净、无溢出"），右侧预览栏里就是对应的 Markdown 源稿，边看边改
• 适合文档 / 论文工作流：LaTeX 编译检查、排版 QA、版本修订记录等场景下，视觉确认 + 源稿预览双栏并排，效果大大提高

两个插件搭配安装：

cd ~/.dsh/profiles/web
npm pkg set "dependencies.dsh-vision-opencode=github:poiuyjie/dsh-vision-opencode"
npm pkg set "dependencies.dsh-md-preview=github:poiuyjie/dsh-md-preview"

功能

• 右侧并排预览：点击对话中的 .md 文件引用（产物芯片 / 行内引用 / 工具卡片路径），在右侧栏打开预览，与对话内容顶部对齐、宽度可拖（支持拖到屏幕中间），布局自动让位、不遮挡对话
• 会话隔离的最近列表：自动收集本会话读写/打开过的 .md 文件（读/写/改/删 + 时间 + 文件 mtime），每个会话只看到自己访问过的文件，互不串扰
• 两类打开方式：
  • 浮动窗口：可拖动、可缩放，位置/大小记忆（localStorage）
  • 右侧停靠：与对话并排，左缘分隔线可拖动调宽
• 修饰键逃生：按住 Ctrl/Cmd/Shift 点击 md 引用，仍走系统默认应用打开（VSCode）
• 手动打开：输入相对工作目录的 .md 路径即可预览
• 完整 Markdown 渲染：标题 / 列表 / 表格 / 代码块 / 引用 / 行内代码 / 公式片段 / 图片链接
• 「对话/轨迹」栏页签：也提供整页「MD 预览」页签

系统支持

⚠️ 仅在 Ubuntu 上安装测试过（Ubuntu 24.04 / Bash，DSH 0.1.0-rc.6）。在 Windows、macOS 或其他 Linux 发行版上安装，需要自行修改：安装路径、~/.dsh profile 目录、cordis.patch.yml 的写法以及包管理命令（npm/pnpm）均可能不同，请按你的环境调整。

安装

方式一：本地克隆（推荐，便于改代码和跟随更新）

从 GitHub 克隆到本地（以 ~/plugins 为例）：

mkdir -p ~/plugins && cd ~/plugins
git clone https://github.com/poiuyjie/dsh-md-preview.git
cd dsh-md-preview

然后在你的 DSH web profile 中引用本地路径（Ubuntu 为 ~/.dsh/profiles/web）：

cd ~/.dsh/profiles/web
npm pkg set "dependencies.dsh-md-preview=file:~/plugins/dsh-md-preview"
npm install

方式二：直接引用 GitHub（不克隆，省事）

cd ~/.dsh/profiles/web
npm pkg set "dependencies.dsh-md-preview=github:poiuyjie/dsh-md-preview"
npm install

启用插件（两种方式都要做）

在 profile 的 cordis.patch.yml 中启用：

- insert:
    - id: md-preview
      name: 'dsh-md-preview'

重启 dsh web，刷新页面即可在会话头部看到「MD 预览」按钮。

提示：方式一克隆到本地后，git pull 即可跟随更新；插件本体是纯 JS、无构建步骤，改完代码刷新页面即生效（client 半边支持 HMR）。

卸载

在 profile 目录（Ubuntu 为 ~/.dsh/profiles/web）执行：

cd ~/.dsh/profiles/web
npm pkg delete dependencies.dsh-md-preview
npm install

（方式一本地克隆安装的，依赖会自动解除；想彻底删掉再执行 rm -rf ~/plugins/dsh-md-preview。）

然后从 cordis.patch.yml 中删除对应的 insert 条目：

# 删除这一段：
- insert:
    - id: md-preview
      name: 'dsh-md-preview'

最后重启 dsh web。卸载不会删除你的任何 .md 文件或会话记录，只移除预览面板功能。

使用

1. 点击会话头部的「MD 预览」按钮打开面板；
2. 面板默认显示本会话最近访问的 .md 文件卡片（文件名 / 路径 / 操作历史 / 摘要）；
3. 点击对话消息流中的 .md 引用 → 右侧栏自动打开并加载该文件；
4. 拖动面板左缘分隔线调整宽度；点「浮动」切换为浮动窗口；点「✕」关闭；
5. 按住 Ctrl/Cmd/Shift 点击引用 → 用系统默认编辑器打开。

开发

# 插件本体（Host 半边 + Client 半边均为纯 JS，无构建步骤）
ls index.js client.js

• index.js：Host 半边。监听 fs/observed 记录 md 文件访问（按会话隔离），提供 /md-preview/api/{recent,read,peek} 三个 HTTP 端点
• client.js：Client 半边。面板 UI、点击拦截（document 捕获阶段识别 md 引用按钮）、右侧停靠 + 布局让位

许可

MIT