前言¶
在使用 DeepSeek Harness Web (dsh web) 時，助手經常會在回覆中生成文件，並顯示在「產物」/ “Produces” 行中。默認情況下，點擊這些文件芯片通常會直接打開文件。dsh-reveal-files 插件修改了這一行爲，爲每個文件芯片添加了一個緊湊的下拉菜單，提供打開、複製路徑、在文件瀏覽器中顯示以及打開終端目錄等操作，無需額外配置工具。
插件簡介¶
該插件由 yumm007 維護，許可證爲 MIT。它主要解決的問題是：在智能體開發中，快速對生成的文件執行常見文件系統操作（如查看、複製路徑、在終端中進入目錄）的需求。通過在文件芯片上點擊，用戶可以直接選擇操作，而不是直接打開文件。
核心功能¶
- 下拉菜單交互：點擊每個文件芯片時，會打開一個緊湊的菜單，而不是直接打開文件。
- 打開文件：使用系統默認應用打開文件。
- 複製文件路徑：將文件的絕對路徑複製到剪貼板。
- 在文件瀏覽器中顯示：調用系統原生文件管理器定位文件（macOS 使用 Finder，Linux 使用文件管理器，Windows 使用 Explorer）。
- 在終端打開目錄：打開系統首選終端，並自動
cd到文件所在目錄。 - 本地化支持：菜單標籤跟隨 UI 語言（簡體中文 / 英語）。
- 零運行時依賴：除了 Harness 本身外，無需額外的運行時依賴。
環境要求¶
- DeepSeek Harness Web (
dsh web)。 - Node.js >= 22.6.0。
- 桌面環境（macOS 和 Windows 始終可用；Linux 需要顯示服務器或 WSL）。
安裝與啓用¶
使用以下命令安裝插件。安裝後需要重啓 dsh web 使其生效。
dsh plugin --profile web add github:yumm007/dsh-reveal-files#main
安裝完成後，插件會在 Web 服務器啓動時加載，並註冊相應的路由和前端組件。
典型用法¶
- 讓助手生成文件（任何包含
write或edit工具結果的回覆）。 - 在回覆下方找到「產物」/ “Produces” 行，點擊文件芯片。
- 從下拉菜單中選擇操作（打開、複製路徑、在文件瀏覽器中顯示、在終端打開目錄）。
配置說明¶
插件在 cordis.patch.yml 中接受配置。默認情況下，插件已啓用。
- insert:
- id: dsh-reveal-files
name: 'dsh-reveal-files'
config:
enabled: true # 註冊文件操作路由（默認爲 true）
revealTimeoutMs: 10000 # 單個命令超時時間（毫秒，默認 10000）
如果需要覆蓋默認配置，可以在 Profile 的 cordis.patch.yml 中進行修改。
注意事項¶
- 插件以當前
dsh進程的權限運行。在 Linux 上，如果當前環境沒有顯示服務器或未使用 WSL，文件瀏覽器功能將無法工作。 - 錯誤信息（例如沙箱拒絕、平臺不支持）會顯示在打開的菜單中以紅色文字呈現。
- 插件在 Host 端僅使用
node:child_process，在客戶端僅使用 React，沒有額外的運行時依賴。
總結¶
dsh-reveal-files 通過在 DeepSeek Harness 的產物行中引入下拉菜單，簡化了與生成文件的交互流程。對於需要在本地查看或進一步編輯文件的開發者來說，這是一個提升效率的工具。
