在 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 导入」选项。
使用流程¶
-
连接信息
将 New API 复制的 JSON 信息粘贴到输入框（例如{"_type":"newapi_channel_conn","key":"sk-…","url":"https://…"}）。识别成功后，插件会自动填好站点地址与密钥，也可以完全手填。 -
供应商配置
填写供应商 ID、显示名和协议。插件会根据站点地址和协议自动推导baseURL：- OpenAI Chat Completions / OpenAI Responses：自动添加
/v1 - Anthropic Messages：不添加
/v1（由 SDK 处理） - 也可以手动修改
baseURL。
- OpenAI Chat Completions / OpenAI Responses：自动添加
-
模型管理
点击「获取模型列表」，使用搜索栏过滤模型，然后逐个勾选。对于每个模型，可以设置：- 名称：该模型的显示名，留空或与 ID 相同时不会写入配置。
- 容量：支持
256K、1.05M这种写法（1K=1000），留空则不写入。 - 输入格式：勾选文本或图像。
- 思考强度：设置
reasoningEfforts，提供六个档位，可自定义键名和值。
-
导入
点击「导入」，插件会将供应商信息写入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 文件，同时保留了严格的格式校验。
