前言¶
在 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
