前言¶

在 DSH 會話裏處理文件時，常見的問題是文件並不只在當前工作目錄中：一部分在本地磁盤，一部分在 WSL 文件系統裏，還有一些是當前項目中的資料。已有做法通常更圍繞工作目錄展開，跨目錄、跨文件系統時需要手動查找，再切換到其他窗口預覽。

PeekFile 是一個面向 DeepSeek Harness（DSH）的插件，提供全盤文件搜索、目錄瀏覽和多格式預覽。它把搜索、瀏覽、預覽、引用、截圖、OCR、格式轉換等操作放進 DSH 會話內，減少文件分散帶來的來回切換。

基本信息¶

• 插件：fastengiel-kurai/dsh-peekfile-everything
• 維護者：fastengiel-kurai
• 許可證：AGPL-3.0-only
• GitHub：https://github.com/fastengiel-kurai/dsh-peekfile-everything
• 已驗證環境：DSH 0.1.0-rc.8、Node.js >= 22、Windows 11 + WSL2 Ubuntu 24.04

Better Sidebar、Everything、文檔轉換與 OCR 工具均爲可選組件。不安裝這些組件時，仍可使用工作目錄/WSL 搜索、目錄瀏覽和基礎格式預覽。

核心功能¶

全盤文件搜索¶

PeekFile 支持三類文件搜索來源：

• 工作目錄
• WSL
• Windows Everything

三類來源可以組合使用。搜索結果支持多來源分頁和排序，並保留最近 10 條去重歷史。搜索結果只緩存在當前頁面內存中，不寫入磁盤；開始全新搜索時釋放舊緩存。

如果已有結果需要進一步縮小範圍，可以在原查詢後追加 +關鍵詞 二次篩選，例如：

動畫片 +合集

目錄瀏覽¶

PeekFile 支持繼續瀏覽目錄。對於壓縮包等不支持內嵌預覽的文件，PeekFile 不自動解包，而是交給系統關聯程序打開。

對話路徑接管¶

如果模型在對話中輸出了有效本地路徑，PeekFile 會自動識別這些路徑，並將其轉換爲可點擊的預覽鏈接。支持的路徑類型包括：

• Windows 路徑
• WSL/POSIX 路徑
• 工作區本地路徑

PeekFile 還支持 DSH 原生文件引用膠囊，以及類似下面的行號範圍引用：

@路徑:起始行-結束行

非圖片文件可拖入輸入框，並保存到工作區 .dsh-drops/；默認單文件上限爲 10 MB。

浮動預覽窗口¶

PeekFile 默認使用浮動預覽窗口，而不是固定側邊欄。窗口支持：

• 多 Tab
• 中鍵關閉
• 刷新
• 另存爲
• 系統打開

本地預覽默認不限制文件大小，預覽上限可單獨配置。

文件預覽與轉換¶

PeekFile 支持預覽以下類型：

• 文本
• 代碼
• Markdown
• CSV
• 圖片
• 視頻
• PDF
• Office
• EPUB
• Calibre 可轉換的電子書

同時提供以下能力：

• 截圖
• 畫框截圖
• OCR
• FFmpeg 轉 MP4
• OfficeCLI 轉 HTML 預覽
• AnyDoc 全文發送

視頻無法播放時，可顯示“轉 MP4”，由 FFmpeg 轉爲 H.264/AAC 的 MP4 後自動播放。

與 Better Sidebar 配合¶

PeekFile 可與 Better Sidebar 配合。可按文件類型指定由 PeekFile 或 Better Sidebar 處理。

需要注意，Better Sidebar 只能預覽工作目錄內文件；工作目錄以外的文件始終由 PeekFile 預覽。

安裝與啓用¶

使用 DSH 插件命令安裝：

dsh plugin --profile web add @fastengiel/dsh-peekfile-everything

安裝後需重啓 DSH Web，並在瀏覽器中執行硬刷新。

如果啓用外掛工具，PeekFile 不會自動修改操作系統環境。需要在設置中啓用對應工具，並填寫命令路徑。

典型用法¶

1. 啓動 DSH Web，進入任意會話後點擊會話右上角的 PeekFiles。
2. 在搜索框輸入文件名，例如：

   report.pdf

保持“工作目錄 / WSL / Everything”全選，並點擊搜索。
3. 點擊目錄可繼續瀏覽；點擊文件會切換到預覽區。
4. 如果 Everything 未安裝，可在搜索按鈕後的範圍菜單中取消 Everything，仍可使用工作目錄和 WSL 搜索。
5. 如果需要對當前緩存結果繼續篩選，可在原查詢後追加 +關鍵詞，例如：

   動畫片 +合集

6. 讓模型在對話中輸出有效本地路徑，然後直接點擊路徑預覽。
7. 如果視頻無法播放，點擊“轉 MP4”，由 FFmpeg 轉爲 H.264/AAC 的 MP4 後自動播放。

適用場景與注意¶

適合在 DSH Web 中使用，並且經常需要查找當前工作目錄之外的文件，例如 Windows 本地磁盤、WSL 文件系統中的文檔、PDF、Office、圖片、視頻或電子書。

使用前需要注意以下幾點：

• Better Sidebar、Everything、文檔轉換與 OCR 工具均爲可選組件。
• 其他 Linux 環境可能可以運行，但尚未完成同等實機驗證。
• macOS 目前隱藏畫框截圖入口。
• Everything 1.5 才能加載 CLI；低於 1.5 的版本不能加載 CLI。
• 搜索結果只緩存在當前頁面內存中，不寫入磁盤。
• 非圖片文件拖入輸入框後會保存到工作區 .dsh-drops/，默認單文件上限爲 10 MB。
• 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證；本插件許可證爲 AGPL-3.0-only，可在 GitHub 倉庫中查看源碼。

鏈接¶

• GitHub：https://github.com/fastengiel-kurai/dsh-peekfile-everything