前言¶

DeepSeek Harness (DSH) 在對接某些提供者時，可能因無法通過 GET /models 端點進行模型發現而受限。Cherry Studio 內置了這些提供者和模型配置。本插件通過讀取 Cherry Studio 的 SQLite 數據庫（只讀模式），將這些配置同步到 DSH，從而繞過模型發現過程。

插件定位¶

這是一個獨立的社區插件，用於將 Cherry Studio 的提供者和模型目錄同步到 DeepSeek Harness。它讀取 Cherry 的 SQLite 數據庫，並定期同步憑據和手動模型路由。插件會自動補全 OpenAI 風格的 /v1 後綴，並保留模型元數據和兼容的推理選項。

環境與依賴¶

使用前需滿足以下條件：
* Node.js 24 和 npm。
* DSH 版本 0.1.7-rc.2，需啓用其憑據/設置提供者。
* Cherry Studio 的數據庫表 user_provider 和 user_model 結構需與測試版本一致。

安裝與配置¶

1. 編輯配置文件：在插件目錄下編輯 cordis.patch.yml。
   • providerName：設置爲 Cherry 中啓用的提供者名稱（精確匹配）。
   • routeId 和 credentialRef：如不覆蓋現有路由/憑據，需設置新的 ID。
   • syncIntervalMs：默認爲 5000（5秒）。

    providerName: My Provider
    routeId: cherry
    credentialRef: CHERRY_API_KEY
    modelIds: []
    databasePath: ''
    modelRegistryPath: ''
    syncIntervalMs: 5000

2. 構建項目：

    npm ci
    npm run check
    npm run build

3. 安裝插件：

    npx --yes @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web add .

啓動與使用¶

1. 重啓 DSH 主機：安裝後需重啓正在運行的 DSH 進程。
2. 選擇提供者：在 DSH 的用戶界面中，選擇已同步的提供者和模型。modelIds 爲空時包含所有啓用的兼容模型；指定列表則限制選擇範圍。
3. 數據庫路徑：默認路徑爲 %APPDATA%/CherryStudio/Data/cherrystudio.sqlite。Windows 路徑會自動發現，其他系統需顯式指定 databasePath。

數據安全與同步機制¶

• 密鑰存儲：插件會將選中的 API Key 複製到 DSH 的憑據存儲中，而非 Cherry 的配置文件。此過程在本地完成，不會向任何服務發送數據庫內容。
• 同步頻率：同步每 5 秒運行一次，僅同步變更值，並會重試因臨時鎖定或 Profile 配置失敗的情況。

卸載與維護¶

如需停止同步，可移除插件並重啓 DSH：

npx --yes @deepseek-ai/dsh@0.1.7-rc.2 plugin --profile web remove dsh-cherry-provider-bridge

注意：卸載不會撤銷已同步的路由和憑據，需在 DSH 界面中手動刪除。

注意事項¶

• 本插件爲獨立社區項目，非 DeepSeek AI 或 Cherry Studio 的官方插件或分叉。
• 代碼運行在 DSH 進程權限下，使用前請檢查源碼與許可證。
• MIT 許可證。

總結¶

此插件解決了特定提供者在 DSH 中無法自動發現模型的問題，通過 Cherry Studio 的數據庫橋接實現配置複用。