前言¶
DeepSeek Harness (DSH) 是一個以插件爲核心的智能體開發平臺，編寫器是其核心交互組件。原生的 + 按鈕功能較爲單一，難以滿足在對話中快速引用文件、管理附件或使用斜槓命令的需求。dsh-add-assets 插件旨在擴展編寫器的交互能力，通過菜單化和可視化界面，提供更豐富的文件操作入口。
介紹¶
該插件是 DeepSeek Harness Web 客戶端的擴展，由 navid-kianfar 維護。它將編寫器工具欄開頭的 + 按鈕替換爲一個選項菜單，允許用戶直接添加文件、文件夾、上傳本地圖片或觸發斜槓命令。選中的路徑會以內聯引用芯片的形式進入草稿，支持全屏圖片預覽和文件卡片展示。
核心功能¶
- 菜單集成：提供四個主要選項：添加文件、添加文件夾、上傳設備圖片和斜槓命令。這些選項由對應的鍵盤快捷鍵觸發。
- 路徑選擇器：支持 Project（工作區）和 This machine（主機）兩個作用域。
- Project 作用域通過 Harness 的文件引用服務瀏覽項目文件。
- This machine 作用域通過插件提供的接口瀏覽主機文件系統，支持路徑搜索和導航。
- 內聯引用芯片：選中的路徑會被轉換爲內聯芯片。其隱藏值爲
@path提及格式，便於模型識別。若缺少觸發管道，則退化爲純文本。 - 附件預覽：接管編寫器的附件展示區域。圖片支持點擊全屏查看，其他文件顯示爲帶有縮略圖和元數據的卡片。
- 設置卡片：在插件設置頁面集中管理所有配置項，支持保存和丟棄修改。
典型用法¶
- 快捷鍵操作：
- 按
⌘U或Ctrl+U打開文件選擇器。 - 按
⇧⌘U或Ctrl+Shift+U打開文件夾選擇器。 - 按
⌘/或Ctrl+/打開斜槓命令菜單。
- 按
- 選擇器交互：
- 在搜索框輸入路徑（如
~/Down）可過濾目錄。 - 使用
↑/↓鍵移動高亮，Enter選中，Esc關閉。 - 選中項目後，按
Cmd+Enter或Ctrl+Enter一次性添加所有選中的項目。
- 在搜索框輸入路徑（如
環境與依賴¶
- DeepSeek Harness：需要版本 0.1.5-rc.2，且必須使用 Web 客戶端 (
dsh web)。 - 運行環境：Node.js 版本需爲
^22.19或>=24。 - 包管理器：PATH 環境變量中需包含
pnpm。 - 依賴服務：插件依賴 Harness 的以下服務（若缺失將導致對應功能不可用）：
dsh-file-reference服務：Project 標籤頁不可用，僅顯示 This machine。inputTriggers服務：斜槓命令行不可用，且選中路徑將作爲純文本追加。
注意事項¶
- 在 IME（輸入法）組合輸入期間，快捷鍵可能會被攔截。
- 如果沒有觸發管道，被選中的芯片會被追加爲純文本而非芯片形式。
- 路徑中包含雙引號或控制字符時，無法寫入爲提及文本，此類選擇會被跳過。
結語¶
該插件通過菜單化和可視化預覽，優化了在 DSH 編寫器中管理文件和附件的流程。對於需要在對話中頻繁引用本地文件或項目資源的場景，提供了直接的操作入口。
