前言¶
在 DeepSeek Harness（DSH）裏髮帶圖、帶文件的消息時，常見做法是把附件堆在輸入框上方，和正文分開。附件一多，讀者容易搞不清「這句話對應的是哪一張圖、哪一份文件」。如果你經常寫「參考這張圖」「按這份文件改」，更希望文件標籤就出現在光標附近、和文字同框表達，那麼可以看一下社區插件 dsh-inline-attachments（倉庫 wuzeno/dsh-inline-attachments）。它把拖入或選擇的文件插到當前光標所在的句子裏，用緊湊標籤顯示文件名，圖片可懸停預覽；發送後，文字與附件的相對位置仍保留。
這是什麼¶
dsh-inline-attachments 由維護者 wuzeno 發佈，Skillhub 分類爲客戶端插件。項目自述爲：把文件拖進輸入框，插到光標所在的句子裏；懸停查看圖片（Inline attachments for DeepSeek Harness）。當前 package 版本爲 0.1.3，階段標註爲實驗預覽版（experimental preview），許可證 MIT。項目未發佈到 npm 註冊表，需通過 DSH 插件管理器或 GitHub Releases 安裝。
核心功能¶
下面能力是 README 與工程說明中已寫明、且與實現模塊對應的要點。
- 句中插入：光標停在想插入的位置後，可從桌面或文件管理器把文件拖進輸入區域，也可點「行內附件」按鈕選文件，或直接粘貼。拖入與粘貼均按當前光標位置插入，不是按鼠標落點自動選位。
- 緊湊標籤與預覽：界面使用 DSH 原生引用芯片；圖片平時只佔小標籤，懸停可看細節，點擊可打開預覽，避免整張圖鋪滿輸入區。
- 發送後語義保持：消息發出後，句中的圖片標籤位置保留；歷史渲染層將引用還原爲標籤，並通過宿主授權 loader 請求圖片（桌面版實測截圖見倉庫文檔）。
- 與宿主流程對齊：上傳與投遞沿用 DSH 原生附件隊列與身份匹配；不修改 DSH 安裝目錄或宿主源碼，前置擴展鏈通過插槽鏡像層保留。
- 邊界與保護：插入位置變化時會保留文件並提示重新定位；文件丟失時不會把空標籤當有效附件發送。刪除已出現的標籤會移除相應草稿附件。
尚未接通或明確不支持的能力包括：已發送文檔的通用點擊預覽、未發送附件刷新恢復、芯片拖動重排、刪除後撤銷恢復文件、跨會話剪切等（詳見下文「適用場景與注意」）。
安裝與啓用¶
當前爲實驗預覽版，建議先在非關鍵會話中試用。
在 DSH 桌面版中：插件 → 添加插件右側菜單 → 安裝第三方插件，填寫倉庫地址：
https://github.com/wuzeno/dsh-inline-attachments
安裝完成後點擊立即啓用，回到聊天頁應能看到「行內附件」按鈕。也可從 Releases 獲取已構建的 npm 壓縮包，或安裝本地倉庫目錄（README 允許，但勿將倉庫名當作 npm 上的包名）。是否需要刷新或重啓以 DSH 插件管理器提示爲準；插件不會主動重啓應用。
package.json 中聲明的 DSH 版本範圍爲：
>=0.2.1-rc.3 <0.3.0
這是安裝聲明，不代表該範圍內每個版本都完成兼容測試。
典型用法¶
README 給出的首次體驗步驟可直接復現：
- 輸入「請比較」，光標停在這句話後面，把第一張圖片從文件夾拖進輸入區域（或點「行內附件」選擇）。
- 輸入「和」，把第二張圖片拖進來，再補上「的區別」。
- 檢查兩個標籤是否在預期位置，發送後懸停查看對應圖片。
效果上可寫成類似：
請比較 [參考圖 A] 和 [參考圖 B] 的區別。
方括號中的名稱在界面裏是文件標籤，無需手寫；寫到哪份素材，就把光標放在那裏再拖入文件。
不要用「刪除後撤銷」「跨會話剪切」或「刷新未發送草稿」來驗證正常恢復——這些屬於當前未支持的流程。
適用場景與注意¶
適合誰：經常在 DSH 裏寫多圖對比、按文件逐步說明的桌面用戶；希望附件與句子同框、減少「上面第幾張圖」歧義時，可試用本插件。
運行與安全：插件在當前 DSH 進程權限下運行，會注入客戶端 UI 插槽（conversation、input-trigger、chat 等）。安裝前建議瀏覽 GitHub 源碼 與 MIT 許可證，自行判斷是否用於生產會話。社區目錄 Skillhub 插件頁 與 GitHub 爲獨立信息源，不表示 DeepSeek 官方認證。
協議與可見性：未啓用插件的客戶端或模型側仍可能看到 @[名稱](dsh-attachment:v1:...) 形式的文本標記；原生複製也可能包含該標記。文件名與 attachmentId 可進入元數據；插件不提供匿名化保證。
當前邊界摘要（以 README「當前狀態與邊界」爲準）：
| 範圍 | 狀態 |
|---|---|
| 圖片句中引用、發送後標籤及懸停預覽 | 已有桌面實測確認（項目所有者 Windows DSH） |
| 按鈕、輸入區拖放與粘貼 | 已實現；拖放鏈路建議在本機驗證 |
| 輸入中文本原文查看 | 已實現，≤ 2 MiB |
| 已發送文檔點擊預覽 | 尚未接通 |
| 刷新恢復未發送附件、芯片剪切/撤銷/跨會話 | 不支持或尚不完善 |
卸載插件會恢復原生呈現，但不會自動改寫歷史消息中的引用標記。發佈前倉庫本地自動測試爲 28 項通過，主要覆蓋編碼器與模擬宿主，不能替代完整端到端實機驗收。
結尾¶
dsh-inline-attachments 的定位很明確：讓文件成爲表達的一部分，用行內標籤和懸停預覽減輕「附件與句子脫節」的問題。若你在 DSH 桌面版裏寫多素材說明，可按上文步驟安裝試用，並閱讀倉庫中的架構說明與 CHANGELOG 瞭解版本與邊界。
