前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許通過擴展功能來適配不同的模型或工具。在使用本地工具鏈（如 Cursor CLI）時，一種常見需求是將 Web UI 中的對話請求直接路由到本地已登錄的 CLI，而不是通過 DSH 的 API 網關轉發。dsh-cursor-passthrough 插件正是爲此設計，它通過在模型選擇器中增加一個專用分組，實現這一路由邏輯。
插件定位¶
這是一個社區維護的插件，由用戶 mingzhong15 開發。它的核心功能是在 DSH 的聊天模型選擇器中添加一個名爲 Cursor 直通 的分組。當用戶選擇該分組時，Web UI 會攔截對話輪次，並在本地直接運行 agent acp，從而利用本地已登錄的 Cursor CLI 處理請求。
與 dsh-cursor-acp 的區別¶
該插件與 dsh-cursor-acp 不同：
* dsh-cursor-acp：在父聊天使用 DSH 模型時，註冊一個 cursor_agent 工具。
* dsh-cursor-passthrough：修改模型選擇器的路由，讓整輪對話直接走 Cursor CLI。
安裝前準備¶
在安裝本插件前，請確保環境滿足以下條件：
- 已安裝 DeepSeek Harness 和 Cursor CLI，並運行過
agent login登錄。 - 在同一 Profile 下安裝了
dsh-cursor-acp。本插件複用了該插件的 CLI 發現輔助工具，但不會重複註冊工具。
安裝步驟¶
根據你的運行環境，選擇對應的安裝命令。
Web Profile:
dsh plugin --profile web add github:mingzhong15/dsh-cursor-passthrough
Desktop:
dsh plugin --profile desktop add github:mingzhong15/dsh-cursor-passthrough
本地檢出 (Local Checkout):
dsh plugin --profile web add link:/path/to/dsh-cursor-passthrough
安裝完成後，需要重啓 DeepSeek Harness。如果是遠程瀏覽器，建議硬刷新（Ctrl+Shift+R）。
啓用與使用¶
- 安裝完成後，進入 Settings（設置） -> Cursor 直通。
- 使用右側的開關控制該分組在模型選擇器中的可見性。
- 在聊天界面，從模型選擇器中選擇 Cursor 直通 分組。
- 選擇具體的 Cursor 模型（如 Paratera、DeepSeek 等），對話將直接通過本地 CLI 處理。
此時，Composer 區域會顯示一個綠色徽章，表明當前會話處於 Cursor 直通模式。
工作原理¶
當選中的 Provider 爲 cursor 時，DSH 會攔截 llm/stream 請求，並在本地執行 agent acp。對於 Cursor 會話，會話標題和壓縮邏輯也會使用本地佔位符，從而跳過 DSH 的 API 適配層。
注意事項¶
- 本插件不是官方 Cursor 產品。
- 需要確保本地環境已正確登錄 Cursor CLI。
- 需要配合
dsh-cursor-acp使用以獲取 CLI 發現輔助功能。 - 代碼基於 MIT 協議開源。
結語¶
dsh-cursor-passthrough 提供了一種在 DSH 中直接調用本地 Cursor 能力的標準化路由方式。如果你需要在 Web 界面中無縫切換使用本地 CLI 而不改變 DSH 的模型選擇邏輯，這是一個實用的工具。
