dsh-import-newapi: Import New API Connection into DeepSeek Harness

在 DeepSeek Harness (DSH) 的开发流程中，配置第三方供应商（如 New API）通常需要手动编辑配置文件和凭据文件。这容易出错，且流程繁琐。dsh-import-newapi 插件解决了这个问题，它允许开发者直接从 New API 复制的 JSON 信息中提取连接数据，并将其适配到 @deepseek-ai/dsh-llm-pi-ai 适配器中，同时自动管理密钥。

插件概况¶

这是一个由 Deanyu148 维护的插件，属于联网工具分类。它的核心功能是将 New API 的站点地址和密钥写入 DSH 的 cordis.patch.yml，并将密钥引用写入 .credentials.yaml，从而实现一键导入供应商配置。

安装与启用¶

使用 DSH CLI 进行安装：

dsh plugin --profile desktop add dsh-import-newapi

安装完成后刷新页面，在 DSH 设置面板的「模型」下方会出现「New API 导入」选项。

使用流程¶

1. 连接信息
   将 New API 复制的 JSON 信息粘贴到输入框（例如 {"_type":"newapi_channel_conn","key":"sk-…","url":"https://…"}）。识别成功后，插件会自动填好站点地址与密钥，也可以完全手填。

2. 供应商配置
   填写供应商 ID、显示名和协议。插件会根据站点地址和协议自动推导 baseURL：

   • OpenAI Chat Completions / OpenAI Responses：自动添加 /v1
   • Anthropic Messages：不添加 /v1（由 SDK 处理）
   • 也可以手动修改 baseURL。

3. 模型管理
   点击「获取模型列表」，使用搜索栏过滤模型，然后逐个勾选。对于每个模型，可以设置：

   • 名称：该模型的显示名，留空或与 ID 相同时不会写入配置。
   • 容量：支持 256K、1.05M 这种写法（1K=1000），留空则不写入。
   • 输入格式：勾选文本或图像。
   • 思考强度：设置 reasoningEfforts，提供六个档位，可自定义键名和值。

4. 导入
   点击「导入」，插件会将供应商信息写入 cordis.patch.yml，密钥写入 .credentials.yaml。导入前可以展开预览框查看将要写入的数据。

规则与限制¶

• 供应商 ID 规则：必须小写字母开头，只能包含小写字母、数字和连字符，且连字符不能开头、结尾或连续出现。已存在的 ID 一律拒绝导入，插件只新增不覆盖。
• 密钥命名约定：密钥引用名由供应商 ID 推导，格式为全大写、连字符换成下划线、末尾加 _API_KEY。例如 example-api → EXAMPLE_API_API_KEY。
• 环境变量处理：如果密钥已由环境变量提供（writable: false），导入时会跳过写入 .credentials.yaml。
• 依赖要求：插件需要 Node.js 版本 ^22.19.0 || >=24.0.0，依赖 @deepseek-ai/cordis (^4.0.2) 和 React (^18.3.1)。

总结¶

该插件将 New API 的繁琐配置流程标准化，适合需要频繁接入或管理多个 New API 站点的开发者。它通过界面化的操作替代了手动编辑 YAML 文件，同时保留了严格的格式校验。

• 仓库地址：https://github.com/Deanyu148/dsh-import-newapi