DeepSeek Harness (DSH) 是一個以插件爲核心架構的模型推理工具。在 Vibe Coder 模式下,開發者習慣直接在編輯器中寫下自然語言請求,這些請求往往包含自我修正、碎片化表達或冗餘信息。如果直接發送給模型,容易導致指令不清、產生幻覺或執行不必要的操作。
vibe-intent-compiler 是一個 DeepSeek Harness 插件,由 Shhaaawwww 維護。它讀取 composer 中未發送的完整草稿,僅重組用戶實際表述的內容,並將結果填回原位。該插件不生成新的細節,專注於提升指令的清晰度與忠實度。
安裝與前置要求¶
安裝前請確保環境滿足以下條件:
- Node.js 版本爲
22.19.x或24+。 - DeepSeek Harness 版本爲
0.1.1-rc.2或更高。 - 系統已安裝
pnpm(DSH 內部依賴此包管理插件)。
在終端執行以下命令安裝插件:
dsh plugin --profile web add "github:Shhaaawwww/vibe-intent-compiler#v0.4.0"
安裝完成後,啓動 Web UI 並進入對話頁面,composer 中會出現 ✦ Clarify 按鈕。
典型用法¶
- 在 composer 中輸入自然、碎片化或自我修正的請求草稿。
- 可選:輸入
@符號,從 Harness 中選擇最多 3 個文件。只有被選中的文件會被讀取,用於解決草稿中已有的模糊引用。 - 點擊
✦ Clarify按鈕。 - 審查插件重寫後的草稿,如有需要可手動編輯,然後自行發送。
示例:
Before: Login keeps breaking lately, maybe it's the token. Make the UI nicer too—actually, leave the UI alone for now.
After: Fix the recent recurring login issue. Treat the token as a possible cause to investigate, and do not change the UI.
核心功能¶
1. 忠實上下文重寫 (Faithful Context Beta)
插件版本 0.4 處於 Faithful Context Beta 階段。它會檢查重寫後的文本是否保留了原始草稿中的受保護文本,並拒絕那些省略了關鍵信息或引入了新的 @reference 的結果。如果無法驗證安全且忠實的結果,原始草稿將保持不變。
2. 智能處理修正與撤回
插件會將後續的修正視爲對先前措辭的替換,僅當它們與之前的表述衝突時生效。同時,它會移除被明確撤回的想法,但會保留其中的約束條件、偏好和不確定性說明。
3. 技術細節保護
在重組過程中,插件會保留代碼片段、命令、路徑、URL、錯誤消息、標識符、Schema 鍵和專有名詞,防止因自然語言轉換導致的技術信息丟失。
4. 上下文引用解析
當用戶顯式選擇文件時,插件僅使用這些文件來解析草稿中已存在的引用,無需在項目中進行全局搜索或啓動代理循環。
邊界與限制¶
- 自動執行限制:插件永遠不會自動執行任務或發送消息,所有操作由用戶觸發。
- 文件上下文限制:文件上下文是確定性的,最多 3 個文件,每個文件 24 KiB,總計 48 KiB。
- 超長草稿:如果草稿長度超過 20,000 字符,插件將保持草稿不變。
- 安全路徑攔截:敏感路徑(如
.env、憑據文件、SSH 密鑰等)會被攔截,且草稿和選中的文件內容在發送前會檢查常見的憑證模式。 - 輸入日誌保護:原始草稿不會出現在命令輸入日誌中,僅重寫後的結果會作爲命令結果保留在會話中。
生態位置¶
本插件遵循 MIT 許可證,可通過 GitHub 倉庫獲取源碼。它屬於 DeepSeek Harness 社區插件生態的一部分,與 DeepSeek 官方無官方從屬關係。
- GitHub: https://github.com/Shhaaawwww/vibe-intent-compiler
- 插件目錄: https://www.skillhub.cn/plugins/Shhaaawwww/vibe-intent-compiler