前言¶
在使用 DeepSeek Harness (DSH) 進行開發時,往輸入框粘貼一段帶路徑的代碼,如果沒有引用機制,它通常以原始多行文本進入草稿。dsh-code-quote 插件提供了一種“方案 b(內聯快照)”的體驗:輸入框內自動摺疊成一行緊湊引用,發送時將完整代碼快照作爲獨立上下文消息內聯給模型。
這是什麼¶
dsh-code-quote 是 DeepSeek Harness Web 輸入框的代碼引用摺疊插件,由 hanrr92 維護。它解決了代碼粘貼冗長、模型無法獲取完整上下文的問題。
核心功能¶
- 自動摺疊引用:粘貼帶路徑行號的代碼自動摺疊爲緊湊引用。
- 真 Chip 模式:默認開啓真 chip 模式,支持 Ctrl+Z 還原。輸入框中直接顯示文件圖標 + 文件名:行號。
- 側邊欄支持:支持 dsh-better-sidebar 側邊欄的“添加到對話框”功能,選中 >500 字符的代碼可自動摺疊。
- 快照持久化:代碼快照持久化到本地,進程重啓後仍可用,模型可獲取完整代碼上下文。
- 形態兼容:支持新舊 token 形態兼容。
- 快照管理:快照上限 64 塊 / 單塊 128KB,採用 LRU 淘汰策略。
安裝與啓用¶
安裝插件需要執行以下命令:
dsh plugin --profile web add dsh-code-quote
安裝後需重啓 profile 使配置生效。
典型用法¶
- 粘貼引用:在編輯器中選中代碼,複製包含路徑和行號的部分(例如
dsh-web-launcher/package.:13-15),粘貼到 DSH 輸入框。 - 側邊欄引用:在側邊欄選中代碼(大於 500 字符),點擊“添加到對話框”,插件會自動識別並摺疊。
- 發送:發送消息時,插件會將完整代碼快照作爲獨立上下文消息追加給模型。
注意事項¶
- 衝突處理:與動態版插件(如
quote-1)二選一,同時啓用會重複注入。 - 環境要求:需要 Node >= 20 環境,依賴
@deepseek-ai/cordis ^4.0.1。 - 配置切換:默認開啓真 chip 模式。若需退回 token 模式,可設置環境變量
DSH_CODE_QUOTE_CHIP_MODE=0。 - 識別閾值:識別閾值偏保守,純代碼無 header 不會摺疊。
- 快照限制:快照上限 64 塊 / 單塊 128KB(LRU 淘汰)。
總結¶
dsh-code-quote 通過將代碼粘貼操作轉化爲結構化引用並持久化快照,有效解決了 DSH 上下文窗口中代碼展示冗長的問題。開發者可以使用 Ctrl+Z 快速撤銷,側邊欄也能無縫支持,適合需要頻繁引用項目代碼進行調試或開發的場景。