前言¶
在使用 DeepSeek Harness Web 進行開發或交互時，輸入框缺乏智能建議是常見的體驗斷層。與 Claude Code 等工具不同，DSH Web 界面本身不提供輸入預測功能。dsh-suggest-ghost 插件通過掛載機制，在回合結束後自動預測下一句提示詞，或在輸入過程中根據歷史記錄進行前綴補全，模擬類似 IDE 或聊天工具的自動補全體驗。
是什麼¶
dsh-suggest-ghost 是一個純插件掛載組件，不修改 DSH 核心代碼。它通過監聽回合事件和客戶端 DOM overlay，實現兩種自動補全模式：
- LLM 下一條建議：在草稿爲空時，利用輔助 LLM 調用預測用戶下一步輸入。默認繼承主請求路由，不額外配置。
- 歷史前綴補全：在草稿非空時，類似
zsh autosuggestions，從會話歷史中查找前綴匹配項進行補全。
幽靈文本採用 DOM overlay 近似渲染，跟隨輸入框字體與滾動，不依賴官方 setGhost 能力，且在中文輸入法組合期間不會攔截按鍵。
核心功能¶
- 幽靈文本顯示：草稿爲空時，建議內容以幽靈文本形式顯示在輸入框中；輸入過程中從歷史找前綴補全。
- 快捷採納：
Tab鍵一鍵採納整條建議，→鍵逐詞采納。 - 全程有界：對輸入字節、輸出 token 和超時時間均設置封頂，防止資源耗盡。
- 模式切換：根據輸入框草稿狀態自動在 LLM 建議和歷史前綴補全間切換。
安裝與啓用¶
安裝該插件需要 DeepSeek Harness 內核版本 0.2.0-rc.2 或更低版本。安裝命令如下：
dsh plugin --profile web add dsh-suggest-ghost
安裝完成後重啓 DSH Web，頁面刷新即可使用。
配置¶
所有設置位於 Settings -> Plugins 面板中的 Suggest ghost 卡片。
UI 設置¶
- LLM 下一條建議：啓用開關、輸出令牌上限、建議字符上限、參考回合數、轉錄字符預算、超時（毫秒）、採納快捷鍵、provider/model 路由（留空繼承主請求）。
- 歷史前綴補全：啓用開關、跨會話搜索、最大歷史條目、最少輸入字符、逐詞采納。
- 熱度管理：管理跨會話高頻短語列表，支持固定（不淘汰）、刪除、手工新增和清空。
代碼級配置¶
也可以通過 cordis.patch.yml 覆蓋初始值：
- id: suggest-ghost
config:
maxInputBytes: 4096
maxOutputTokens: 512
timeoutMs: 60000
maxRecentTurns: 3
maxTranscriptChars: 12000
contextSummaryEnabled: true
contextSummaryChars: 1500
maxSuggestionChars: 240
acceptKey: Tab
llmEnabled: true
兼容性與依賴¶
該插件需要 DSH 內核 0.2.0-rc.2 或更低版本。從 0.2.0 開始，peer 依賴檢查變爲加載期硬拒絕，不滿足版本會直接跳過插件加載。
在 0.1.7 版本中，DSH 移除了 settings.yaml 體系，本插件的數據通道隨之遷移至新的 Config 結構。客戶端通過 remote.settings.describe() 讀取配置，host 端通過 ctx.settings.update() 推送 _push 字段。
使用示例¶
- 歷史前綴補全：在輸入框輸入“列出 do”，插件自動補全這條歷史消息的剩餘部分。
- LLM 下一條建議：回合結束後，如果輸入框爲空，插件會根據上下文預測下一步輸入，灰色顯示建議內容。
- 採納建議：按
Tab鍵採納整條建議，按→鍵逐詞采納。
注意事項¶
- 版本要求：必須使用 0.2.0-rc.2 或更低版本的 DSH 內核。
- 重啓生效：重啓 DSH Web 後立即可用，歷史記錄存儲在會話日誌中。
- 輸入法干擾：在中文輸入法組合期間，插件不會攔截按鍵，避免打斷輸入。
- 許可證：默認爲 MIT 許可證。
結語¶
dsh-suggest-ghost 通過輕量級的 DOM overlay 和智能補全策略，爲 DeepSeek Harness Web 用戶提供了實用的輸入輔助能力。無論是利用 LLM 進行預測，還是利用歷史記錄進行快速補全，都能顯著提升交互效率。
插件目錄：https://www.skillhub.cn/plugins/dsh-plugin-collection/dsh-suggest-ghost
GitHub 倉庫：https://github.com/dsh-plugin-collection/dsh-suggest-ghost
