前言¶

DeepSeek Harness（DSH）以插件方式扩展客户端能力。对智能体开发者来说，一个常见需求是把已经可用的 OpenAI-compatible provider 接入 DSH，或者在自定义 endpoint 上完成 provider、模型和 API key 配置。

loongport 是 SailingLoong 维护的 DSH Cordis bundle 和 setup CLI。它面向已验证的 LoongPort OpenAI-compatible providers，也提供用于自定义 OpenAI-compatible endpoint 的 advanced CLI。

这是什么¶

SailingLoong/loongport-dsh 的包名为 loongport，版本为 0.2.0，许可证为 MIT，要求 Node.js >=20。

它主要解决两件事：

1. 在 DSH 中提供 Settings → LoongPort 配置入口。
2. 提供 CLI，用于把自定义 OpenAI-compatible endpoint 写入 DSH 配置。

核心功能¶

下面介绍插件当前提供的主要能力。

• 提供 DeepSeek Harness（DSH）Cordis bundle。
• 面向已验证的 LoongPort OpenAI-compatible providers。
• 提供用于自定义 OpenAI-compatible endpoint 的 advanced CLI。
• 支持在 DSH 的 Settings → LoongPort 中选择 provider、粘贴 API key 并选择模型。
• CLI 支持 --base-url、--model、--route、--credential-name、--write。
• --model 可重复使用，用于注册多个模型。
• CLI 默认执行 dry run，添加 --write 后更新 DSH 配置。
• 使用 DSH 内置 llm-pi-ai transport，不自行实现 streaming、retries 或 tool calls。

安装与启用¶

先安装到当前使用的 DSH profile：

dsh plugin --profile <profile> add loongport

安装完成后，在 DSH 中打开 Settings → LoongPort，按下面步骤配置：

1、选择 provider
2、粘贴 API key
3、选择 deepseek-v4-flash 或 deepseek-v4-pro
4、保存

自定义 endpoint 用法¶

如果你的 endpoint 是手动提供的 OpenAI-compatible endpoint，可以直接运行 CLI：

LOONGPORT_API_KEY='your-api-key' npx loongport dsh setup \
  --base-url https://relay.example.com/v1 \
  --model model-id \
  --write

这个示例会向 DSH 写入一个 provider route 和对应 credential。API key 只从 LOONGPORT_API_KEY 读取，不能放在命令参数中。

默认情况下，该命令执行 dry run。添加 --write 后，才会更新 DSH 配置。如果需要暴露多个模型，可以重复使用 --model。

涉及到的 CLI 选项包括：

--base-url
--model
--route
--credential-name
--write

配置写入¶

CLI 会优先使用 $DSH_HOME；未设置时，使用 ~/.dsh。

使用 --write 后，会写入：

• settings.yaml 中一个 selected llm-pi-ai.providers.<route> entry
• .credentials.yaml 中 selected credential name 和 API key（owner-only）

其他 DSH settings、provider routes 和 credentials 会被保留。

适用场景与注意¶

适合这些场景：

• 需要在 DSH 的 Settings → LoongPort 中完成 provider 选择、API key 填写和模型选择。
• 已有手动提供的 OpenAI-compatible endpoint，希望显式写入 DSH 配置。
• 希望复用 DSH 内置 llm-pi-ai transport，而不是在插件中重新实现 streaming、retries 或 tool calls。

需要注意：

• Version 0.2.0 不自动浏览器授权、不收集 browser sessions、不访问 cookies/local storage。
• 注册/登录和 API key 创建仍在 provider 网站完成。
• VeriDrop 数据仅为 display-only health observation，不能改变 provider configuration。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

链接¶

• 目录页：https://www.skillhub.cn/plugins/SailingLoong/loongport-dsh
• GitHub：https://github.com/SailingLoong/loongport-dsh