前言¶
在 DeepSeek Harness（DSH）中處理文件附件通常需要手動複製路徑或依賴原生附件機制，流程較爲繁瑣。DragView 插件通過監聽拖拽事件，將本地文件直接注入到聊天界面，並生成結構化的 Codex 風格附件卡片，支持安全預覽、系統打開以及路徑解析或文件複製兩種模式。
插件簡介¶
該插件由用戶 anzhaohao 維護，包名爲 dsh-dragview。它解決了在智能體開發場景下快速引入文件、預覽非圖片格式內容以及安全訪問本地文件路徑的需求。
核心功能¶
DragView 提供了以下能力：
* 拖拽交互：將本地文件拖入聊天界面，鬆手後根據配置決定行爲。
* 卡片渲染：生成 280×64 px 的 Codex 風格附件卡片，顯示文件名、大小及類型。
* 預覽機制：支持 PDF、音視頻、文本的安全預覽（文本限制 10MB，顯示前 1MB）。
* 系統打開：點擊卡片或按 Enter/Space，使用系統默認應用打開 Office 文檔、壓縮包及未知文件。
* 路徑解析：支持 Windows Everything CLI、macOS Spotlight、Linux plocate/locate 進行路徑定位。
* 圖片處理：圖片不經過本插件，保留平臺原生附件通道。
安裝與配置¶
插件可以通過官方命令安裝。
dsh plugin add dsh-dragview
安裝後，需在 DSH 設置中新增 drag-file 分區進行配置。
模式與使用¶
插件支持兩種工作模式，通過設置中的 drag-file 分區切換，重啓生效。
resolve 模式（默認）¶
拖入文件後解析真實絕對路徑，不復制原文件，適合引用工作區已有文件。
copy 模式¶
拖入文件後直接複製字節到工作區，適合拖入工作區外的文件，確保模型穩定讀取。
操作步驟¶
- 拖拽本地文件到聊天界面。
- 鬆手時根據模式顯示「複製」或「引用」提示。
- 在輸入框附件欄查看生成的 Codex 風格卡片。
- 點擊卡片或按 Enter/Space 進行預覽或系統打開。
- 發送消息時，內容中會追加每行一個
@"<絕對路徑>"的文件引用。
安全與邊界¶
插件對文件訪問進行了多層安全控制：
* 不透明 ID：每次解析或複製成功後，host 生成短期、不透明的 fileId，所有後續操作均需通過該 ID 覈對。
* 路徑驗證：寫入流程逐層拒絕 symlink/junction，並在創建後重新驗證，防止路徑逃逸。
* 沙箱預覽：文本預覽響應強制 text/plain 並附加 CSP，防止主動內容執行。
* 錯誤提示：路徑解析失敗或能力校驗不通過時會彈出提示，不靜默。
注意事項¶
copy模式只能寫入當前 session 在 workspace registry 中權威綁定的工作區。- 插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證。
- 圖片不經過本插件，保留平臺原生附件通道。
相關鏈接¶
- GitHub 倉庫：anzhaohao/DragView
- 插件目錄：anzhaohao/DragView
