前言¶
DSH 的插件生態支持按 profile 擴展 Web 端能力。dsh-filescope 對應的能力是文件瀏覽：把當前工作區的目錄樹和文件預覽放進 Web 頁面右側抽屜，適合在會話之間切換時查看對應工作區內容。
它定位是隻讀瀏覽：只展示目錄、文件和文件內容，不提供寫操作。
這是什麼¶
dsh-filescope 是一個 DeepSeek Harness 插件，名稱爲 FileScope · 文件視界，包名爲 dsh-filescope。
它解決的問題是：在 DSH Web 會話裏，不離開當前頁面，直接查看當前會話所屬工作區的目錄結構、文件大小、文本文件內容、二進制文件摘要和超大文件提示。
倉庫地址爲：
https://github.com/KunIsMe/dsh-filescope
許可證爲 MIT；許可證標註爲 © 2025 zhangkun，GitHub owner 爲 KunIsMe。
核心功能¶
下面按實際使用過程列出已覈實的能力。
入口與佈局¶
- 右側全高抽屜式文件瀏覽器。
- 可從側邊欄底部打開。
- 可從會話頂部操作欄打開。
- 點擊遮罩可收起抽屜。
- 抽屜左邊緣豎條可調整寬度，範圍爲
320px–85vw。 - 目錄樹與預覽區之間的橫條可調整高度。
工作區跟隨¶
- 切換會話時，目錄樹自動跟隨該會話所屬工作區。
- 匹配邏輯是讀取當前會話
cwd，並匹配已註冊工作區。 - 也可以手動切換工作區。
- 頂部下拉可選擇工作區。
- 也可以輸入絕對路徑後回車。
目錄瀏覽¶
- 支持完整目錄層級的展開和摺疊。
- 目錄優先排序。
- 顯示文件大小。
- 「全部展開」會遞歸加載子孫層級，上限爲
3000節點。 - 「隱藏點文件」可過濾以
.開頭的條目。
文件預覽¶
- 文本文件即時預覽，帶行號。
- 文本預覽帶行號的範圍是前
2000行。 - 二進制文件顯示
hex摘要。 - 超大文件顯示提示。
即時刷新¶
開啓即時刷新後：
- 當前打開文件每
2s檢測版本變化，並自動重讀。 - 已展開目錄每
5s刷新。
安裝與啓用¶
插件會以當前 dsh 進程權限運行。安裝前建議先檢查源碼、只讀接口邊界和許可證。
安裝命令：
dsh plugin --profile web add dsh-filescope
安裝後，停掉當前 dsh web 進程，再運行：
dsh --profile web
Host 組合在進程啓動時加載，因此新內容需要重啓 dsh web 進程後纔會掛載。重啓後刷新瀏覽器頁面：
Cmd+Shift+R
刷新後即可看到入口。
環境要求：
dsh版本應與本包構建時的源碼樹一致。- Web profile 已掛載
dsh-web-app層，即@deepseek-ai/dsh-web-app。
典型用法¶
1、通過側邊欄底部或會話頂部操作欄的「文件視界」按鈕打開抽屜。
2、切換會話時，目錄樹自動跟隨該會話所屬工作區。
3、在頂部下拉選擇工作區，或輸入任意絕對路徑後回車。
4、使用「全部展開」遞歸加載所有層級，注意上限爲 3000 節點。
5、使用「隱藏點文件」過濾 . 開頭條目。
6、點擊文件查看預覽：文本文件帶行號，二進制文件顯示 hex 摘要，超大文件顯示提示。
7、開啓「即時刷新」後，當前文件每 2s 檢測變化，已展開目錄每 5s 刷新。
8、拖拽抽屜左邊緣調整寬度，拖拽目錄樹與預覽區之間的分隔條調整高度。
適用場景與注意¶
- 適合在 DSH Web 中只讀查看當前工作區的目錄、文件、文件大小和文件內容。
- 適合會話之間切換後快速確認當前工作區結構。
- 不提供任何寫操作。
- 接口邊界爲
GET-only JSON API。 - 文本預覽只展示前
2000行。 - 「全部展開」遞歸加載上限爲
3000節點。 - 修改插件配置或 Host 組合後，需要重啓
dsh web進程並刷新瀏覽器頁面。 - 已覈實資料中，README 手動接入示例依賴版本寫爲
0.1.2，而package.json的version字段爲0.1.3。安裝前可確認目標 profile 實際解析到的包版本。
鏈接¶
- GitHub：
https://github.com/KunIsMe/dsh-filescope - 社區目錄：社區目錄中的
dsh-filescope條目；本文未給出具體目錄頁 URL。
