dsh-clipfile：在 DSH Composer 中掛載文件與文件夾

在 DeepSeek Harness (DSH) 的 Web 端編輯器中，直接傳遞文件或文件夾結構往往需要手動上傳或編寫複雜的路徑引用。dsh-clipfile 插件爲 DSH Composer 增加了原生的文件掛載能力，支持剪貼板粘貼、原生文件選擇器以及路徑模糊搜索，解決文件傳遞的交互瓶頸。

這是一個由 whyzsm 維護的客戶端插件，旨在簡化 DSH Web 端編輯器中的文件交互。

核心功能¶

該插件提供了以下四種文件交互方式：

1. 剪貼板粘貼：在 macOS Finder 中複製文件或文件夾，在編輯器中直接按 ⌘V 粘貼。插件通過 osascript furl 檢測剪貼板內容，無需上傳文件。
2. 原生文件選擇器：點擊編輯器旁的 ＋ 按鈕，調用 macOS 原生文件選擇器（NSOpenPanel），支持多選文件或文件夾。
3. @ 提及路徑補全：在編輯器中輸入 @ 後跟關鍵詞，利用 mdfind 進行路徑模糊搜索，自動補全文件路徑。
4. 分頁 Markdown 轉換：粘貼的文件夾會轉換爲 INDEX.md（索引頁）和 pages/*.md（分頁內容），供智能體按頁閱讀，避免一次性加載過多數據。
5. 可移除的標籤：每個附件以標籤形式顯示，點擊 ✕ 即可移除。標籤僅對當前會話有效，切換對話時顯示該對話的附件，發送消息後自動清理。

安裝與啓用¶

安裝該插件只需執行以下命令：

dsh plugin --profile web add whyzsm/dsh-clipfile

典型用法¶

1. 在 Finder 中選中文件或文件夾，在 DSH 編輯器中按下 ⌘V 粘貼。
2. 點擊編輯器旁的 ＋ 按鈕，打開系統文件選擇器進行多選。
3. 輸入 @ 後跟文件路徑中的關鍵詞，系統會自動補全路徑。

注意事項¶

• 平臺限制：該插件僅支持 macOS 平臺，依賴 osascript、NSOpenPanel 和 /opt/homebrew/bin/python3。
• 零拷貝機制：附件處理採用零拷貝機制：插件讀取原始路徑的只讀內容，並將轉換後的分頁 Markdown 打包寫入 .dsh-clipfiles/md/ 目錄。
• 會話作用域：附件標籤僅對當前會話可見，切換對話時顯示該對話的附件，發送消息後自動清除。

總結¶

dsh-clipfile 通過原生的文件交互方式，提升了 DSH Web 端處理本地文件和文件夾的效率。更多細節可查看插件目錄或源碼。