前言¶
在 DeepSeek Harness (DSH) 的 Web 界面中，向模型提供代碼上下文通常需要手動複製粘貼。這種方式不僅打斷心流，還容易產生“草稿污染”（即代碼意外進入可見的輸入框）。針對這一場景，dsh-codex-select 插件通過模擬 Codex 的交互邏輯，實現了在文件樹和查看器中直觀地選中代碼或文件，並自動將其轉化爲消息上下文。
插件定位¶
dsh-codex-select 是一個爲 DeepSeek Harness Web GUI 設計的插件，由用戶 light-only 維護。它主要解決“如何在 Web 界面高效地將文件或代碼片段作爲上下文發送給模型”的問題，替代了傳統的手動複製粘貼方式。
核心功能¶
該插件主要提供以下能力：
- 懶加載文件樹與只讀查看器：左側展示工作區文件樹，默認跳過
node_modules和.git目錄；右側爲只讀文件查看器，支持 UTF-8 文本，限制爲 1 MiB，拒絕二進制文件。 - Codex 風格的選擇交互：在查看器中選中代碼，或通過文件樹行上的
＋按鈕加入文件，都會自動生成“引用芯片”（已選中 N 行 · 文件名）並插入到輸入框上方，無需點擊額外按鈕。 - 無草稿污染與芯片管理：選中的內容不會進入可見的草稿文本，僅在發送時通過插件編解碼器序列化爲代碼塊。點擊芯片上的
×可清除選擇，新的選擇會替換舊的選擇。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add dsh-codex-select
dsh web
安裝後需要重啓 dsh web 服務，插件纔會生效。
典型用法¶
- 安裝並重啓
dsh web後，打開一個會話，點擊頂部的 文件 / Files 選項卡。 - 展開左側的文件樹，點擊任意文件以在右側查看內容。
- 在右側查看器中選中需要提供的代碼片段，輸入框上方會自動出現引用芯片。
- 在輸入框中輸入你的 Prompt，發送消息。模型將直接使用選中的代碼作爲上下文。
- 若要移除當前選中的上下文，點擊芯片上的
×即可。
適用場景與注意¶
- 適用場景：適合需要頻繁向模型提供代碼片段上下文，且希望保持輸入界面整潔的開發者。
- 權限與安全：該插件的主機路由共享 Harness Web 服務器的信任模型。任何能訪問 Harness Web 的人都可以列出和讀取主機賬戶的絕對路徑（與核心目錄選擇器權限一致）。插件本身是隻讀的，不會寫入或執行文件。
- 格式限制：文件查看器僅支持 UTF-8 文本，且文件大小限制在 1 MiB 以內，超出該範圍的二進制文件會被拒絕。
總結¶
dsh-codex-select 通過芯片化的交互設計，讓代碼上下文的傳遞變得流暢且不污染輸入流。對於習慣使用 DSH Web 界面的開發者，這是一個提升效率的實用工具。更多詳情可參考 GitHub 或 DSH 插件目錄。
