前言¶
DSH 的理念是“一切皆插件”,能力可以按插件方式加入。社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係,不應理解爲官方應用商店。
對使用 DSH 的開發者來說,一個具體需求是:已經有 GitHub Copilot 訂閱,希望把訂閱裏的模型放進 DSH 的模型選擇器中用於聊天與推理,但不想額外安裝 Copilot CLI,也不想讓 Copilot 的工具在本地執行。
下面介紹 dsh-copilot-sdk。它橋接 GitHub Copilot 訂閱到 DeepSeek Harness,註冊一個 copilot provider,並保留上游 @github/copilot-sdk 的 SDK 庫、文檔、樣例和測試套件。
這是什麼¶
dsh-copilot-sdk 是由 GongYuanCaiJi 維護的 DSH 插件。它是 @github/copilot-sdk 的 DSH 移植,用於把 GitHub Copilot 訂閱作爲模型池接入 DSH。
插件與上游版本信息如下:
plugin: dsh-copilot-sdk
upstream: @github/copilot-sdk
pinned version: 1.0.11
commit: 18002a81
許可證方面,dsh-copilot-sdk 爲 MIT,上游 github/copilot-sdk 亦爲 MIT。
核心功能¶
下面列出的能力均來自已覈實事實。
- 註冊
copilotprovider,把 GitHub Copilot 訂閱作爲模型池。 - 在模型選擇器中可使用以下訂閱模型:
copilot / gpt-5copilot / claude-sonnet-4.5copilot / deepseek-r1- SDK 自帶 Copilot CLI runtime,無需單獨安裝 CLI。
- 認證可使用已有 GitHub 登錄、token 或 BYOK。
- 純聊天橋接:橋接層拒絕 Copilot 工具執行請求。
- 支持 assistant 文本與 reasoning 流式輸出。
- 提供以下 DSH 側命令:
/copilot status/copilot models/copilot stop- SDK 庫、docs、samples、測試套件 100% 逐字移植自上游。
安裝與啓用¶
dsh-copilot-sdk 尚未發佈到 npm,需要從 GitHub 或本地目錄安裝。
如果從 GitHub 安裝,先執行下面命令:
dsh plugin --profile <你的-profile> add github:GongYuanCaiJi/dsh-copilot-sdk
如果從本地目錄安裝,先準備好插件目錄,再執行下面命令:
dsh plugin --profile <你的-profile> add /path/to/dsh-copilot-sdk
安裝後重啓 dsh。插件按需拉起 Copilot CLI;首次模型調用或執行 /copilot status 時會啓動。
如果環境使用 pnpm,並且安裝時報 allowBuilds 錯誤,通常是 pnpm 默認阻止 git 安裝的 prepare 構建腳本。處理方式是:把 pnpm 打印的精確 key 加進 profile 的 pnpm-workspace.yaml 的 allowBuilds,再重試。可以按下面形式寫入,具體 key 以 pnpm 輸出爲準:
# pnpm-workspace.yaml
allowBuilds:
- <pnpm 打印的精確 key>
典型用法¶
安裝並重啓後,有兩種常見用法。
- 在 DSH 會話的模型選擇器中選擇
copilotprovider,然後選擇其中的訂閱模型。 - 在 agent 配置裏指定
provider: copilot和具體模型 id。具體模型 id 取決於你的 Copilot 訂閱可用模型,可先使用/copilot models查看。
DSH 側可用命令如下:
/copilot status
/copilot models
/copilot stop
說明:/copilot status 用於查看連接狀態;/copilot models 用於列出可用模型;/copilot stop 用於停止 Copilot CLI runtime。
如果暫時沒有 Copilot 訂閱,也可以按 BYOK 方式使用,在 session/agent 配置裏指定自己的 API key。
適用場景與注意¶
適合的場景:
- 已有 GitHub Copilot 訂閱,包括免費額度檔,希望把訂閱模型接入 DSH。
- 希望 DSH 中可以直接調用
copilot / gpt-5、copilot / claude-sonnet-4.5、copilot / deepseek-r1等模型。 - 只需要聊天與 reasoning 輸出,不需要 Copilot 的工具執行。
需要注意:
- 需要 GitHub Copilot 訂閱,除非使用 BYOK。
- 每次模型調用對應一次性 Copilot 會話;每次 prompt 計入 Copilot 用量。
- 橋接層拒絕所有權限請求,Copilot 只作爲聊天模型回答,不執行工具。
- 遙測代碼逐字保留,但橋接層默認不發送;若自行構造
CopilotClient並啓用,則以上游行爲爲準。 - 插件會在當前
dsh進程權限下運行,安裝前應檢查源碼、依賴和許可證。
結尾¶
dsh-copilot-sdk 的價值在於把已有的 GitHub Copilot 訂閱作爲 DSH 的聊天模型池接入,同時保持純聊天橋接和明確的命令入口。
GitHub 倉庫地址:
https://github.com/GongYuanCaiJi/dsh-copilot-sdk
也可以在 DSH 插件目錄中按插件名 dsh-copilot-sdk 查找。