前言¶
在 DeepSeek Harness（DSH）裏和 Agent 多輪對話時，助手回覆結束後，你往往還要想下一句怎麼寫。常見做法是盯着空白輸入框回憶上下文，或從最近幾條消息裏複製改幾個字。DSH 社區插件 dsh-prompt-prediction（維護者 QingJ01）在 Agent 正常完成一輪迴復後，用模型推測你可能輸入的下一句話，以灰字顯示在完全爲空的輸入框中；按 Tab 或 → 填入可編輯草稿，不會自動發送。交互思路參考 Codex 的下一句預測，但這是非官方插件，與 DeepSeek、OpenAI 無隸屬關係。
這是什麼¶
dsh-prompt-prediction 是運行在 DSH 內的客戶端插件（分類：客戶端），不是獨立聊天應用或瀏覽器擴展。它在 Cordis 宿主與 Web 前端注入輸入框浮層，由 Host 側發起額外模型請求，客戶端負責展示與鍵盤採納。GitHub 倉庫：QingJ01/dsh-prompt-prediction；社區目錄頁：skillhub.cn 條目。當前 package 版本爲 0.2.3，許可證 MIT。聲明兼容 DSH >=0.2.1-rc.5 <0.3.0，適配基於 0.2.1-rc.5，範圍內並非每個版本都已實測。
核心功能¶
下面介紹插件在資料中明確描述的能力。
觸發與展示條件¶
- 你先正常提問，等待 Agent 正常完成一輪迴復；失敗、中斷、取消等狀態不觸發預測。
- 輸入框完全爲空，且沒有附件、引用或排隊消息時，纔可能顯示灰字建議。
- 會話運行中、Plan 模式或輸入框禁用時，建議會隱藏。
鍵盤與輸入行爲¶
| 操作或狀態 | 行爲 |
|---|---|
| Tab / → | 填入可編輯草稿，支持撤銷、重做，不發送 |
| Esc | 忽略當前建議；隨後 Tab 可移動焦點；輪詢不恢復同一輪同一條建議 |
| Enter | 保留 DSH 原有發送、排隊、命令邏輯，不用於採納 |
| 輸入文字、IME 組字、打開菜單 | 隱藏建議 |
| 長建議 | 單行省略預覽，採納時填入完整建議；多段時預覽只顯示第一段，膠囊可標「2 段」，採納插入完整多段草稿 |
預測允許最多 3 個非空短段落；超過限制時整條丟棄。建議只是模型推測，採納後仍應檢查；插件不會替你發送消息或執行預測中的工具調用。
預測質量與本地過濾¶
Host 在請求中約束模型，並在結果回傳後做本地過濾，例如：用你最近 3 條真實用戶消息作風格錨點；優先短句；丟棄與上一條歸一化後完全相同的重複（repeated-user）；啓發式丟棄憑據形態（credential-shaped）；允許模型返回 null 表示棄權。這些規則用於減少無效建議，資料未聲稱已通過對照評估證明準確率或採納率提升。
費用與數據¶
默認沿用會話的模型路由與歷史，額外發起預測請求，可能計費。預測保存在插件內存，不加入 Agent 會話歷史。默認開啓本地審計日誌（可用 auditLog: false 關閉後續寫入）；路徑爲 $DSH_HOME/prompt-prediction/events.jsonl 或 ~/.dsh/prompt-prediction/events.jsonl。
安裝與啓用¶
前提：已安裝兼容的 DSH，終端可運行 dsh，目標 profile 中的會話已有可用模型路由。插件以當前 DSH 進程權限運行；安裝前可在 GitHub 查看源碼與 MIT 許可證。
從 npm 安裝（推薦）：
dsh plugin --profile desktop add dsh-prompt-prediction
使用其他 profile 時，將 desktop 替換爲對應名稱。安裝後刷新已有 DSH 窗口以加載前端；Host 插件未自動加載時重啓 DSH。無需 npm install 或構建步驟。
升級 npm 版本時需先移除再添加：
dsh plugin --profile desktop remove dsh-prompt-prediction
dsh plugin --profile desktop add dsh-prompt-prediction
移除：
dsh plugin --profile desktop remove dsh-prompt-prediction
配置¶
在 DSH 界面打開 插件 → 提示詞預測 → 預測設置，可調整預測開關、建議長度、模型請求超時、輸出 token 預算和本地審計日誌；保存後立即生效。
也可在目標 profile 的 cordis.patch.yml 中覆蓋 ID 爲 prompt-prediction 的配置行，例如關閉審計日誌：
- id: prompt-prediction
config:
enabled: true
maxSuggestionChars: 160
timeoutMs: 15000
auditLog: false
常用默認值（完整表見倉庫 README）：
| 參數 | 默認值 | 含義 |
|---|---|---|
enabled |
true |
是否啓用預測 |
timeoutMs |
20000 |
模型請求超時（毫秒） |
maxSuggestionChars |
1000 |
建議長度上限（UTF-16 單元） |
maxOutputTokens |
8192 |
預測輸出 token 預算 |
auditLog |
true |
是否寫入本地審計日誌 |
reasoningEffort |
inherit |
推理力度，默認沿用會話 |
provider 與 model 均未設置時沿用會話路由；必須同時設置才能使用獨立預測路由。關閉預測應使用 enabled: false，而不是 timeoutMs: 0。
典型用法¶
經過上面的安裝與配置，日常使用可以按下面步驟操作。
- 在 DSH 中正常對話，等 Agent 完整結束一輪迴復。
- 確認輸入框爲空且無附件、引用、排隊消息，聚焦輸入框。
- 若出現灰字建議，閱讀後按 Tab 或 → 採納爲草稿，修改無誤後再自行發送；不需要則按 Esc 忽略。
- 若你希望 Tab 只用於切換焦點，先 Esc 忽略建議，或使用 Shift+Tab 向前移動。
安裝後沒有灰字時，可檢查是否裝到當前 profile、是否刷新或重啓、enabled 與模型路由是否正常。
適用場景與注意¶
適合在 DSH Desktop（或對應 Web 客戶端 profile）裏高頻續寫提示詞、希望減少「下一句寫什麼」空窗時間的開發者。需要注意：
- 每次有效預測都會額外請求模型，長會話與冷緩存下費用需自行關注；省成本可設
reasoningEffort: min或關閉enabled。 - 默認審計日誌可能記錄預測與交互文本，敏感環境請關閉或自行清理日誌目錄。
- 依賴 DSH 內部接口，後續 DSH 版本可能變化；完整 Desktop IPC、所有外部模型提供商與各類屏幕閱讀器尚未在資料中聲明完成端到端驗證。
- 社區目錄 skillhub.cn 與 GitHub 爲獨立生態入口，不是 DeepSeek 或幻方官方應用商店。
結尾¶
dsh-prompt-prediction 把「下一句提示詞」做成可選的灰字草稿，Tab 採納、不自動發送，在 DSH「一切皆插件」的思路里補了一塊客戶端輸入體驗。進一步瞭解安裝、排障與開發測試，見 GitHub README 與 社區目錄頁。
