前言¶

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 的数据库桥接实现配置复用。