前言¶
在 DeepSeek Harness（DSH）裏，對話正文裏的文件鏈接、行內路徑、右側文件樹裏的條目，普通左鍵點擊都會進右側 Sidebar 預覽。對習慣在 IDE 或 Office 裏改文檔的人來說，多一步「先進預覽再打開」往往多餘；小屏上側欄還要和主對話搶寬度，長 Markdown、PDF、表格在窄面板裏也不順手。DSH 生態裏客戶端能力可以插件化擴展。下面介紹社區插件 dsh-skip-preview（維護者 finalrgy）：在不改掉原有預覽的前提下，給文件打開加一條並行出口——按住修飾鍵再點鏈接，跳過預覽，交給系統默認應用處理。
這是什麼¶
dsh-skip-preview 是 DSH 客戶端插件（分類：客戶端）。它包裝宿主服務 sidebarRight.openResource——會話正文裏文件進入右側面板的統一入口——在檢測到特定修飾鍵組合時，改爲調用系統默認打開方式，而不是打開側欄預覽。普通點擊行爲與未裝插件時一致。插件 MIT 許可，源碼與說明見 GitHub：finalrgy/dsh-skip-preview；社區目錄頁：skillhub.cn/plugins/finalrgy/dsh-skip-preview。社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
-
並行出口，不替換預覽
左鍵點擊仍爲 DSH 原有側欄預覽；只有帶指定修飾鍵的點擊纔會走「系統默認應用」路徑。 -
平臺修飾鍵
- macOS：⌘ + 左鍵（認metaKey）。
- Windows / Linux：Ctrl + 左鍵（認ctrlKey）。
- 若同時帶 Shift、Alt 等其它修飾鍵，一律仍走預覽，插件不攔截。
- macOS 上 Ctrl+點擊多爲系統右鍵菜單，仍按預覽處理。 -
覆蓋的入口（均經
openResource）
- 正文 Markdown 鏈接，例如[report.md](report.md)。
- 行內代碼裏的路徑，例如`docs/spec.md`。
- 右側文件樹中點擊文件。
不覆蓋：present交付卡片（走ui-deliverables自有路由）。 -
打開失敗時回退
路徑不在工作區、文件不存在等導致宿主拒絕打開時，會自動退回側欄預覽，並在 Console 記錄原因，避免「點了沒反應」。 -
具體用哪個應用
由操作系統文件關聯決定；插件不指定、也不修改默認程序。 -
啓動自檢
若 DSH 變更了sidebarRight.openResource等方法名，Console 會打印[dsh-skip-preview] 啓動自檢失敗並說明受影響行爲，而不是靜默失效。
安裝與啓用¶
官方安裝命令（來自 README）：
dsh plugin --profile desktop add dsh-skip-preview
從 GitHub 源碼安裝：
dsh plugin --profile desktop add github:finalrgy/dsh-skip-preview
裝完後需要完全退出並重啓 DSH；僅刷新頁面不足以重載客戶端 bundle。
兼容性（見 package.json 的 dsh.engines.dsh）：需要 DSH >= 0.2.1-rc.5。當前插件版本在資料中爲 0.1.4。
安裝前建議自行查看倉庫源碼與 MIT 許可證。客戶端插件隨 DSH 桌面進程運行，打開文件使用的是當前用戶對系統的訪問權限，請只在信任的來源安裝。
典型用法¶
| 操作 | macOS | Windows / Linux |
|---|---|---|
| 左鍵點擊文件鏈接 | 側欄預覽（原行爲） | 側欄預覽（原行爲） |
| ⌘ + 左鍵 | 系統默認應用打開 | — |
| Ctrl + 左鍵 | 預覽（Ctrl+點擊多爲右鍵） | 系統默認應用打開 |
| 帶 Shift / Alt 等其它修飾鍵 | 一律預覽 | 一律預覽 |
| 打開失敗 | 回退預覽，Console 記原因 | 同左 |
在會話裏找到 Agent 提到的文件鏈接或路徑，按住對應平臺的修飾鍵再左鍵點擊即可。界面無額外提示，需自行記住手勢。
適用場景與注意¶
適合誰
- 小屏筆記本上不想在窄側欄裏讀長文檔，希望用全屏編輯器或 PDF 閱讀器打開。
- 點擊鏈接的本意就是在外部編輯器裏修改，不想多經過預覽。
- 希望
.xlsx、.pdf等由 Excel / WPS、系統預覽器等關聯程序處理。
已知限制（README 原文）
- 依賴
sidebarRight.openResource方法名；DSH 大版本升級後可能需要插件更新。 - 修飾鍵手勢在模塊內爲全局單例快照，任意點擊會覆蓋，有 1 秒 TTL，極端併發點擊理論上可能誤判。
- 觸發鍵寫死在代碼中（
TRIGGER_IS_META附近），無配置項。 - Windows/Linux 上
ctrlKey分支有測試覆蓋，維護者註明未在真實 Windows 環境實測。 - 交付卡片不支持。
插件在服務層包裝、不直接改 DOM；除上述單一修飾鍵組合外，不接管其它點擊，全部交回 DSH 與瀏覽器。
結尾¶
dsh-skip-preview 給 DSH 會話裏的文件鏈接增加「預覽 / 系統默認應用」雙路徑：默認仍是側欄預覽，⌘ 或 Ctrl 加左鍵則跳過預覽直接打開。若你在桌面版 DSH 裏頻繁從對話跳進本地文件，可按上文命令安裝並重啓後再試手勢。
- 目錄頁：https://www.skillhub.cn/plugins/finalrgy/dsh-skip-preview
- GitHub：https://github.com/finalrgy/dsh-skip-preview
