前言¶
在 DeepSeek Harness（DSH）裏和智能體對話，大部分時間花在聊天輸入框：續寫半句話、在助手回覆後組織下一條指令。原生 Composer 不會根據上下文給出可採納的草稿，只能自己一字字打滿。社區插件 dsh-composer-autocomplete 掛在 Web 客戶端原生 Composer 上，用灰字 ghost text 做行內續寫和「下一句」預測，Tab 採納爲可編輯草稿，不會自動發送消息。下面介紹它的能力、安裝方式與使用注意。
這是什麼¶
dsh-composer-autocomplete 由維護者 liangzhiyu 發佈，許可證爲 MIT，在 SkillHub 等社區目錄中歸類爲客戶端相關能力（倉庫 catalog 標註爲 ui）。它面向 DeepSeek Harness Web 的原生聊天輸入框，增加：
- 輸入停頓後的草稿續寫（inline ghost text）
- 助手回合結束後、輸入框爲空時的下一條消息建議
- 鍵盤採納與多候選切換（Full 模式下最多三個候選）
預測默認走當前會話裏已配置的模型路由，會消耗該服務的 token；插件不單獨存儲 API Key。採納後插入的是可繼續編輯的文本，發送仍由用戶自己完成。
核心功能¶
兩種預測場景¶
- 空輸入框：助手回覆結束後，預測你可能發送的下一條消息。
- 草稿續寫：光標在末尾、停頓一段時間後，請求對當前草稿的續寫。默認停頓 150 ms（可在設置中改爲 100–5000 ms；若從未保存過偏好，才用 150 ms；從舊版升級後若仍保留 300 ms，需在設置裏手動選 150 ms）。
鍵盤與交互¶
| 操作 | 行爲 |
|---|---|
| Tab | 採納第一個完整候選；後續候選可能仍在生成。與中文 IME 組合輸入衝突時，Tab 歸輸入法所有。 |
| Esc | 關閉當前建議；改草稿後可重新預測。 |
| Alt+↓ / Alt+↑ | 在 Full 模式下在最多三個候選間切換。 |
Agent 運行中會暫停預測；不會干擾原生 /command 與 @reference 菜單。顯示建議時原生光標仍可見；採納後光標在插入文本末尾。
Fast 與 Full¶
- Fast（默認）：一個候選，更少上下文、更短輸出預算，延遲更低（README 中 0.2.3 在 150 ms 停寫下測得首段 ghost 中位約 256 ms）。
- Full：保留多個候選及
cordis.patch.yml裏配置的上下文上限。
若你輸入的文字已是某候選的精確前綴，會本地複用剩餘文本，不再發起模型請求（README 稱匹配已有候選約 11 ms，無網絡）。
設置入口¶
Settings → General → Composer predictions：總開關、預測模式、Fast/Full、輸入停頓。偏好保存在當前瀏覽器本機。切換會話會在繪製前清掉建議並重置 IME 與關閉狀態；每個候選綁定會話、草稿與請求，避免遲到的響應出現在別的視圖。
安裝與啓用¶
環境要求：Node.js ≥ 24.9、已安裝 DeepSeek Harness；README 寫明在 Harness 0.2.1-rc.2 Web 上測試過。插件聲明的 dsh 引擎範圍爲 >=0.2.1-rc.2 <0.3.0-0。
從 GitHub Releases 安裝預構建包（資料中的命令對應 v0.2.3）：
dsh plugin --profile web add https://github.com/liangzhiyu/dsh-composer-autocomplete/releases/download/v0.2.3/dsh-composer-autocomplete-0.2.3.tgz
dsh web
安裝或更新後需重啓正在運行的 Harness 實例。官方桌面應用可通過其插件安裝 UI 選擇本地包，或用捆綁的 dsh 管理 desktop profile；README 說明桌面 shell 未測試，插件使用的是 Web 客戶端上的 native composer 插槽。
卸載：
dsh plugin --profile web remove dsh-composer-autocomplete
重啓相關實例。瀏覽器裏的偏好會保留；要在開發者工具中刪除 dsh-composer-autocomplete.* 本地存儲鍵才能重置。
模型與高級配置¶
預測複用會話的模型路由與宿主認證；近期對話、工具活動與當前草稿會發給該模型並消耗 token。這些輔助調用不會作爲對話消息出現，也不計入會話界面展示的 token 用量。使用前請在 Harness 中配置可用模型。
可在 profile 的 cordis.patch.yml 中覆蓋宿主參數。若主對話用的是慢思考模型，可單獨爲預測配置更快的 provider 與 model，主對話模型不變。Fast 模式會把上限壓到：1 個候選、6 條消息、4000 上下文字符、2 條 tool notes、96 輸出 token；Full 模式使用下面配置項中的限制。
- id: composer-autocomplete
config:
maxOutputTokens: 220
timeoutMs: 20000
maxMessages: 10
maxChars: 8000
maxSuggestions: 3
maxToolNotes: 6
cacheTtlMs: 60000
maxCacheEntries: 200
# Set both to use a dedicated prediction model; otherwise use the session route.
# provider: your-provider
# model: your-model
# reasoningEffort: off
README 中的延遲錶針對確定性本地測試模型，衡量的是本地 UI/SSE 管線，不代表 DeepSeek 雲端速度；實際上還受網絡、首 token 時間等影響。更短的停頓會增加請求頻率，可在設置里加長停頓。
適用場景與注意¶
適合：主要在 DSH Web 裏寫長指令、反覆續寫同一段草稿，希望 Tab 快速填入可編輯下一句或補全的用戶。
注意：
- 插件以當前 DSH 進程及 Web 客戶端權限運行；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認接受向會話模型發送草稿與上下文。
- 社區目錄（如 SkillHub）是獨立站點，與 DeepSeek / 幻方無官方從屬關係；安裝命令以 README 發佈的 Release 包 URL 爲準，不要憑倉庫名自行拼接未文檔化的 add 形式。
- 文本插入走 Harness 公開 input actions；若插入被拒絕，不會覆蓋現有草稿。
- 桌面客戶端未經作者測試，Web 是主要目標環境。
結尾¶
dsh-composer-autocomplete 把 IDE 裏常見的 Tab 補全思路接到 Harness Web Composer：灰字續寫、回覆後的下一句預測、Esc 與 Alt 方向鍵切換候選，採納後不自動發消息。需要時可從 Release 安裝 v0.2.3 包，在 Composer predictions 裏調 Fast/Full 與停頓。
- 社區目錄頁：https://www.skillhub.cn/plugins/liangzhiyu/dsh-composer-autocomplete
- 源碼與文檔：https://github.com/liangzhiyu/dsh-composer-autocomplete
