dsh-llm-cursor：DeepSeek Harness 的非官方 Cursor 訂閱登錄和聊天

前言¶

DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。當需要對接 Cursor 的訂閱服務時，官方僅提供了 IDE 和 CLI 兩種官方客戶端入口，且沒有公開的 OpenAI 兼容 API。dsh-llm-cursor 插件通過實現 Cordis 插件契約，爲 DSH 提供了一條非官方的接入路徑，允許用戶通過 DSH 的界面直接使用 Cursor 的訂閱模型。

該插件由 NOirBRight 維護，採用 MIT 許可證。它通過 HTTP/2 協議與 Cursor 的私有端點通信，不依賴官方的 Cloud Agents 或 @cursor/sdk。

安裝¶

安裝過程需要通過 DeepSeek Harness 的 Web 端進行。請使用以下命令安裝 dsh-llm-providers-ui 和 dsh-llm-cursor 兩個組件：

dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.9/dsh-llm-providers-ui-0.2.9.tgz
dsh plugin --profile web add --force \
  https://github.com/NOirBRight/dsh-llm-cursor/releases/download/v0.2.23/dsh-llm-cursor-0.2.23.tgz
dsh web

安裝完成後，請重啓 DSH Web 端。

核心功能¶

登錄與配置¶

在 DSH 的設置中，進入 LLM Providers -> Cursor，即可看到該插件提供的配置卡片。
1. 點擊 Sign in with Cursor，系統會啓動 Deep Control PKCE 流程，打開系統瀏覽器完成登錄。
2. 登錄成功後，會話信息存儲在 Host 端的 $DSH_HOME/cursor-oauth.json（權限 0600），插件不會在瀏覽器中接收 Token。
3. 點擊 Fetch available models，插件會讀取賬戶的可用模型列表，將 Cursor 按思考級別拆分的 SKU 合併爲模型族，並區分 Fast SKU 和 Max Context SKU。

聊天與請求¶

配置好模型族後，即可進行聊天。
1. 聊天請求通過 HTTP/2 Connect + protobuf 協議發送至 POST https://api2.cursor.sh/agent.v1.AgentService/Run。
2. 插件會自動添加兼容性請求頭，包括 x-cursor-client-type: cli、x-cursor-client-version 和 x-ghost-mode: true。
3. 在卡片上可以看到訂閱使用情況（來自非官方儀表板數據），以及登錄後的賬戶郵箱。

技術細節¶

協議要求：插件強制要求與 api2.cursor.sh 建立 HTTP/2 連接（包含 ALPN）。插件不提供 HTTP/1 代理橋接，如果底層傳輸層不支持 HTTP/2，請求會直接失敗。
兼容性機制：插件在 package.json 的 dsh.compatibility.dshReleases 字段中維護了已驗證的 Host 版本列表，用於確認環境兼容性。
導出結構：插件根目錄導出 Cordis 插件契約，同時導出 ./client，爲 DSH 提供具體的實現。

風險與限制¶

ToS 違規風險¶

這是使用該插件必須首先考慮的問題。Cursor 員工明確表示，將私有客戶端端點用於登錄和聊天屬於 違反服務條款 的行爲。使用該插件進行登錄、發送聊天或僅在本機運行，都無法規避這一風險。執法措施可能包括賬戶限制或永久封禁。

功能與實現限制¶

緩存字段缺失：從 Run 接口返回的 Token 使用塊不包含緩存字段，因此 DSH 的緩存命中率統計爲空。
SKU 邏輯：Fast SKU 是獨立的模型族（如 gpt-5.2 vs gpt-5.2-fast），而非一個簡單的開關。1M 上下文 SKU 僅在 Cursor 實際提供 Max Context 的族中顯示，手動添加的通用上下文行不受此限制。
版本依賴：CLI 版本號被鎖定，當 Cursor 發佈新的 CLI 導致版本號不匹配時，插件可能會失效。
數據來源：卡片上顯示的使用百分比來自非官方的 Dashboard Rails，而非官方 API。

總結¶

dsh-llm-cursor 提供了在 DSH 中直接使用 Cursor 訂閱的可行方案。它通過 HTTP/2 Connect 和 Protobuf 協議實現了與 Cursor 私有端點的通信。但在使用前，請務必確認其違反 ToS 的風險是否在可接受範圍內，並確認當前 DSH 環境支持所需的 HTTP/2 特性。

項目主頁: https://github.com/NOirBRight/dsh-llm-cursor
社區目錄: https://www.skillhub.cn/plugins/NOirBRight/dsh-llm-cursor