前言¶
在 DeepSeek Harness（DSH）裏做智能體或項目開發時，右側欄往往同時承擔工作區文件樹和預覽。默認佈局下，點開文件容易佔滿整塊區域，樹被擋住，來回切換成本高。若你習慣 VS Code / Codex 那套「樹在右、預覽在左、單擊預覽 / 雙擊固定」的交互，原生側欄不一定能對上。
dsh-file-pane 是社區維護的客戶端插件，把 DSH 右側欄拆成「左側預覽 + 右側文件樹」，並補上預覽標籤、右鍵開終端、Copy to Chat 等能力。下面介紹它是什麼、怎麼裝、怎麼用，以及使用時要注意的限制。
這是什麼¶
- 名稱：dsh-file-pane（npm 包名同插件 id）
- 維護者：sinvacn
- 分類：客戶端（通過 Cordis patch 注入
@deepseek-ai/dsh-client-ui-sidebar-right） - 許可證：MIT
- 目錄頁：https://www.skillhub.cn/plugins/sinvacn/dsh-file-pane
- 源碼：https://github.com/sinvacn/dsh-file-pane
一句話定位：在 DSH 右側欄實現 VS Code / Codex 風格的文件窗格——文件樹保持在右側可見，打開的文件落在樹左側；支持預覽 / 固定標籤、在樹中右鍵開終端、從預覽把選區引用進對話輸入框。
README 標明在 DSH 0.2.1-rc.5 上做過測試；插件 package.json 版本爲 0.1.0。SkillHub 目錄與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；安裝前建議自行查看源碼與許可證。
核心功能¶
四格佈局：預覽與文件樹並排¶
原先右側一欄會被拆成兩列：左側爲文件 / 終端預覽，右側仍爲 Workspace 文件樹。整體從「三欄感」變爲更易對照代碼與目錄的並排佈局（倉庫 README 提供 docs/layout-4-pane.png 示意）。
默認左右比例約爲 70% / 30%（預覽在左、樹在右）。若 DSH 無法完成 split 或移動標籤，會回退到內置行爲。
預覽標籤（VS Code 風格）¶
- 單擊文件：打開或替換唯一的預覽標籤。
- 雙擊文件或標籤：固定（pin） 該標籤；預覽標籤以斜體顯示，固定狀態按會話保持。
Open Terminal¶
在文件樹中 右鍵 文件（在該文件所在目錄打開）、文件夾或空白處，可在對應路徑打開終端。終端以文件窗格內的 同級標籤 出現，不會蓋住文件樹。
終端啓動後會 cd 到目標目錄，因此 cd 會留在 shell 歷史與回滾輸出中（README limitations 中已說明）。
Copy / Copy to Chat¶
在文件預覽中選中文本後右鍵：
- Copy：保持瀏覽器原生複製。
- Copy to Chat：向對話 composer 插入
@file #Lx-Ly引用和選中內容的 fenced 代碼塊，不會自動發送。
示例插入內容形態：
@src/app.ts #L12-L14
```ts
export const b = 2
```
行號來自代碼與普通文本預覽；Markdown / PDF 預覽會插入文件引用與選中文本，但 不帶行號。若沒有掛載 composer，payload 會 複製到剪貼板。
安裝與啓用¶
官方安裝命令（README 原文）：
dsh plugin --profile desktop add github:sinvacn/dsh-file-pane
也可以在對話裏讓智能體執行上述命令（需 shell 權限並在提示時批准）。無論哪種方式，插件會加入當前 profile，側欄行會自動註冊。若插件處於關閉狀態，在 Settings → Plugins 中啓用。
安裝後 刷新頁面 一次；若側欄未更新，可重啓 desktop 應用。
卸載：在 Settings → Plugins 移除 dsh-file-pane，或執行：
dsh plugin --profile desktop remove dsh-file-pane
然後刷新頁面。
典型用法¶
- 安裝並啓用插件，刷新 DSH 頁面。
- 在右側 Workspace 文件樹中 單擊 某文件，在左側預覽窗格查看；需要長期保留時 雙擊 固定標籤。
- 在樹上 右鍵 目標目錄或文件，選擇打開終端，在同一窗格區域以標籤形式使用終端。
- 在預覽裏選中代碼，右鍵 Copy to Chat，到 composer 中核對
@路徑 #行號與代碼塊後再自行發送。
調整默認分欄比例（對新 split 生效；已有 split 保持實際比例，可拖拽分隔條）：
在頁面控制台執行：
localStorage.setItem('dsh.file-pane.share', '0.7')
取值會被限制在 0.2–0.8 之間；默認即爲 0.7。
適用場景與注意¶
適合誰
- 長期在 DSH desktop profile 裏讀代碼、改文件，希望文件樹始終可見的開發者。
- 需要把預覽選區以
@file+ 行號形式貼進對話、減少手工敲路徑的人。
限制（來自 README）
- 右側欄總寬度上限不變；已有分欄比例不會因改 localStorage 而全部重算。
- 若你自行把樹放在左側，文件與終端會在 右側 兄弟窗格打開，而不是對調左右。
- Copy to Chat 只寫入 composer，不代發消息。
安全與權限
插件在 當前 DSH 進程與頁面上下文 中運行，會參與側欄 UI 與終端等行爲。安裝前請閱讀 倉庫源碼 與 MIT 許可證，確認符合你的環境與合規要求。
結尾¶
dsh-file-pane 把 DSH 右側欄改成更接近 VS Code 的文件 + 樹並排體驗，並補齊預覽標籤、目錄內開終端和 Copy to Chat，適合在 Harness 裏高頻對照目錄與代碼的場景。更多信息見 SkillHub 目錄頁與 GitHub README：
- https://www.skillhub.cn/plugins/sinvacn/dsh-file-pane
- https://github.com/sinvacn/dsh-file-pane
