前言¶

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