DeepSeek Harness (DSH) 的設計理念強調插件化擴展。原生側邊欄文件樹是基礎組件，提供了核心的瀏覽能力，但在引用、元數據展示和交互細節上相對簡陋。dsh-at-sider 插件接管了原生的 files 標籤頁，在不改變快捷鍵、入口和圖標的前提下，補上了六項實用功能，將原生文件樹轉化爲一個具備引用、元數據、搜索和 Git 狀態感知的增強版樹。
這是什麼¶
- 插件名稱：dsh-at-sider
- 維護者：aiyacharley
- 許可協議：MIT
- 核心價值：爲 DSH web 的原生側邊欄文件樹補充六件事：
@ 引用·文件大小·文件修改時間·排序·快速搜索定位·側邊欄底部 git commit 信息。
核心功能¶
-
行內引用按鈕
每行緊跟文件名顯示@文件按鈕（目錄顯示爲@文件夾）。點擊可插入引用文本，按住 Alt/⌥ 點擊可直接複製引用文本。輸入框不可達時自動降級爲複製文本。 -
文件元數據列
行尾顯示文件大小和修改時間兩列。寬度自適應，確保內容不被裁切。修改時間懸停可顯示完整本地時間，大小列懸停可顯示精確字節數。 -
全工作區快速搜索
頁頭提供全工作區遞歸搜索。搜索結果支持@引用和直接跳轉，不侷限於當前展開的層級。 -
排序功能
支持按名稱、修改時間、大小、類型循環排序。排序偏好會通過本地存儲記憶。目錄始終優先顯示。 -
Git 狀態欄
側邊欄底部新增 Git 狀態欄，顯示當前分支、領先/落後情況以及最近提交摘要。點擊狀態欄可展開最近 20 條提交記錄。支持多倉庫工作區，狀態欄會出現倉庫下拉選擇器。文件行名後會有狀態色點（未跟蹤、有未暫存修改、已暫存）。 -
運行時回退原生
無需卸載插件，通過右鍵「文件」頁籤菜單即可隨時切回原生文件樹。 -
快捷定位與引用
在文件預覽頁籤的右鍵菜單中，提供「在文件樹中定位」和「@文件」兩個選項。前者會自動展開祖先目錄並高亮該行，後者可直接插入當前預覽文件的引用。 -
全鍵盤操作
支持方向鍵、Home/End、Tab 等全鍵盤操作，配合@鍵即可插入引用，符合無障礙語義。
安裝與啓用¶
安裝前需滿足以下前置條件：
* 已安裝 DeepSeek Harness CLI。
* 環境中安裝了 Node.js ≥ 20。
使用官方 CLI 一條命令安裝：
dsh plugin --profile web add dsh-at-sider@latest
安裝完成後，需要重啓 DSH web 才能生效。
典型用法¶
- 打開文件樹：按
Mod+P打開右側欄的「文件」標籤頁。 - 插入引用：鼠標懸停在任意文件行上，點擊出現的
@文件按鈕，引用文本會自動插入到當前輸入框中。 - 快速搜索：在頁頭搜索框輸入關鍵詞，插件會遞歸搜索整個工作區。
- Git 查看與切換：在側邊欄底部查看當前倉庫狀態。若工作區包含多個 Git 倉庫，可在狀態欄下拉選擇器中切換查看目標倉庫的提交記錄。
- 從預覽頁籤操作：打開一個文件預覽頁籤，右鍵點擊該頁籤，選擇「在文件樹中定位」，側邊欄會自動跳轉並高亮對應文件。
注意事項¶
- 重啓生效：安裝或更新後必須重啓 DSH web 進程，Host 半的路由註冊纔會生效。
- 數據緩存：Git 狀態緩存時間爲 30 秒。展開狀態與滾動位置按頁籤記憶，但層級數據不緩存，刷新頁面後會重新讀取。
- 原生接管機制：插件加載期間原生樹會被遮蔽（而非組合），通過右鍵菜單可以隨時回退到原生模式。
