dsh-local-path-attachments：將本地文件拖入 DSH Desktop 作爲絕對路徑引用

在 DeepSeek Harness (DSH) Desktop 中處理本地文件時，通常需要複製文件到工作區或上傳二進制內容。這個插件提供了另一種方式：直接將文件拖入對話窗口，生成以絕對路徑爲依據的引用卡片，而不涉及文件字節的傳輸。

這是什麼¶

dsh-local-path-attachments 是一個 DSH 插件，由 WangZetian-IVERSON 維護。它的核心作用是將 Windows 資源管理器或 Finder 拖入的文件對象轉換爲可視化的絕對路徑卡片。這些卡片顯示文件名、完整絕對路徑，並提供一鍵移除的操作，最終將純淨的路徑字符串提交給 Agent。

核心功能¶

拖放與展示：支持在 DSH Desktop 窗口內拖入單個或多個文件，生成包含文件名、完整絕對路徑及移除按鈕的卡片。
路徑處理：支持包含空格、中文文件名、盤符路徑、UNC 路徑及 POSIX 路徑。支持 Windows 路徑不區分大小寫的去重。
數量限制：每個草稿限制 50 個本地路徑卡片。
原生集成：將每個卡片存儲爲 Composer 的原生引用節點，遵循正常的提交、失敗恢復、草稿清除和會話隔離行爲。

安裝與啓用¶

下載：從 Releases 頁面下載 dsh-local-path-attachments-0.1.1.tgz。
安裝：在 Desktop Profile 目錄下執行安裝命令：

    pnpm add "D:\path\to\dsh-local-path-attachments-0.1.1.tgz"

配置：打開 Desktop Profile 的 package.json，將插件名稱追加到 dsh.profile.bundles 數組中：

    {
      "dsh": {
        "profile": {
          "bundles": [
            "dsh-local-path-attachments"
          ]
        }
      }
    }

重啓 DSH Desktop 完成啓用。

典型用法¶

打開 DSH 對話窗口。
從文件資源管理器或 Finder 中拖拽文件到 Desktop 窗口內。
在 Composer 區域查看生成的路徑卡片，確認文件名和路徑無誤，或點擊移除按鈕刪除不需要的卡片。
提交消息。此時 Agent 收到的消息中包含完整的絕對路徑字符串，而非文件內容。

適用場景與注意¶

適用場景：適合需要在 Agent 上下文中引用本地文件，但不想或無法將文件複製到工作區的場景。
安全與權限：
- 絕對路徑會作爲用戶消息的一部分發送，可能包含用戶名或敏感目錄名。
- 文件字節不會經過該插件傳輸。
- 讀取工作區外文件仍受當前 DSH 沙箱和審批策略限制。
- 一張路徑卡片無法繞過操作系統權限或 DSH 安全邊界。
文件狀態：移動或刪除源文件不會更新已存在的卡片。
平臺差異：macOS/Linux 的 DSH Desktop 路徑感知功能已實現，但尚未經過維護者的實地測試。Web GUI 僅在無法安全解析絕對路徑時才保持原有拖放行爲。

該插件基於 MIT 許可證開源，維護者提供了完整的測試覆蓋。如需查看源碼或提交問題，可訪問 GitHub 倉庫。