前言¶
在 DeepSeek Harness（DSH）Web GUI 中，輸入框已經支持 @ 觸發引用。若只引用技能或子代理，原生能力已經夠用；但如果在消息裏引用當前工作目錄下的文件，就會缺少一個直接的選擇入口。
AFAP/dsh-input-file-ref 是一個 DSH 輸入框文件引用插件：輸入 @ 後打開可搜索、可逐級下鑽的文件選擇面板，選中文件後把 @相對路徑 回填到輸入框，模型再按路徑讀取文件內容。
需要先說明：這個項目已歸檔，不再維護、不再更新。DeepSeek Harness 0.1.2-alpha.3 起已原生支持 @ 選取文件、文件夾與會話。README 明確建議不要再安裝本插件，直接升級到最新的 DeepSeek Harness 即可。
這是什麼¶
這是一個面向 DSH Web GUI 輸入框的文件引用插件，由 AFAP 維護，許可證爲 MIT。
它做的事情比較單一：
- 在輸入框輸入
@時彈出文件選擇面板； - 支持搜索當前工作目錄下的文件；
- 支持進入子目錄瀏覽；
- 選中文件後把
@相對路徑作爲普通文本回填到輸入框； - 發送消息後，由模型按相對路徑讀取文件內容。
它的適用前提也很明確：會話需要已經選擇工作目錄。沒有工作目錄時，面板會顯示提示，不會崩潰。
核心功能¶
下面介紹插件的主要能力。
- 輸入
@時，彈出與輸入框同寬的文件選擇面板，頂部帶搜索欄。 - 支持關鍵字即時遞歸搜索文件，匹配規則爲大小寫不敏感子串匹配。
- 支持逐級下鑽文件夾，可以進入
.git、node_modules、target等目錄。 - 搜索模式默認排除
.git、node_modules、target等忽略目錄；瀏覽模式下仍可逐級進入這些目錄。 - 文件行顯示相對全路徑，路徑過長時中間用
…省略。 - 默認展示 50 條結果；繼續輸入關鍵字後，可逐步放寬到 100 / 200 / 500 條。
- 支持鍵盤選擇：
↑、↓、Enter、Esc，也支持鼠標選擇。 - 選中文件後保留
@，並回填文件相對全路徑，末尾保留一個空格。 - 支持連續引用多個文件。
- 插件只讀、零外部依賴，並具備瀏覽器信任圍欄（防 DNS 重綁定 / 跨站）。
- 界面文案支持中英雙語，跟隨界面語言。
這個插件不內聯文件內容到消息，不做文件預覽 / 語法高亮，也不支持多選批量。它只負責把文件路徑以文本形式放入輸入框。
安裝與啓用¶
由於項目已歸檔，新環境不建議安裝本插件。若要查看舊實現或驗證等價安裝，可使用 README 給出的安裝命令：
dsh plugin --profile web add github:AFAP/dsh-input-file-ref
安裝後需要重啓 dsh web 生效。
插件會隨 DSH Web 端加載並運行，安裝前建議檢查源碼與 MIT 許可證，確認它符合你的使用環境和安全要求。
典型用法¶
下面是一組可復現的使用步驟。
1、打開一個已選擇工作目錄的 DSH 會話。
2、在輸入框中輸入 @，打開文件選擇面板。
3、面板頂層展示當前目錄內容。可以直接點擊文件夾，逐級進入子目錄。
4、在頂部搜索欄中輸入關鍵字，或在 @ 後繼續輸入關鍵字，進行遞歸搜索。
5、搜索結果默認顯示 50 條。繼續輸入關鍵字後，可顯示更多結果。
6、進入某個子目錄後，可通過“↑ 上級目錄”或 Backspace 返回上級目錄。
7、選中文件後，輸入框會回填類似下面的文本：
@src/main.ts
注意末尾有一個空格。這個空格會讓 @ 停止再次觸發選擇，方便繼續輸入或編輯。
8、發送消息後，消息中包含相對路徑文本。模型可以使用 fs 工具按該路徑讀取文件內容。
如果需要引用多個文件，可以再次輸入空格和 @，重新打開選擇面板。回填內容是普通文本，可以直接編輯或刪除。
適用場景與注意¶
這個插件適合用於瞭解舊版 DSH 輸入框的文件引用實現，也適合作爲文件選擇面板的參考實現。但作爲生產使用，當前更推薦直接升級 DeepSeek Harness，使用原生 @ 選取文件、文件夾與會話的能力。
需要注意幾點：
- 項目已歸檔，不再維護、不再更新。
- README 建議不要再安裝本插件，直接升級到最新的 DeepSeek Harness。
- 會話需要已選擇工作目錄；未選擇工作目錄時，面板會顯示提示。
- 搜索結果默認排除
.git、node_modules、target等忽略目錄；如需選擇這些目錄中的文件，應使用瀏覽模式逐級進入。 - 插件只讀，不修改、不刪除任何文件。
- 宿主只讀取會話日誌頭部與文件系統元信息，不讀取文件內容。
- 瀏覽器信任圍欄要求 loopback 或
trustedHosts同源請求，拒絕跨站請求。 - MVP 暫不支持內聯文件內容、文件預覽 / 語法高亮和多選批量。
結尾¶
AFAP/dsh-input-file-ref 的價值在於給出一個比較剋制、邊界清晰的 DSH 輸入框文件引用實現：搜索、瀏覽、路徑回填和模型讀取被拆分成清楚的步驟，同時保持只讀、零外部依賴和瀏覽器側的安全限制。
當前更推薦直接使用最新 DeepSeek Harness 的原生 @ 文件選擇能力。下面鏈接可用於查看源碼和目錄信息。
GitHub：
https://github.com/AFAP/dsh-input-file-ref
目錄頁：
https://www.skillhub.cn/plugins/AFAP/dsh-input-file-ref
