前言¶
在 DeepSeek Harness(DSH)裏做智能體或對話應用時,模型來源往往分散:有的走 API Key,有的走各家賬號體系。若希望用 OpenAI 官方賬號 登錄後,在 Harness 裏直接選 GPT 模型、並在同一路由下使用賬號側的生圖能力,就需要一個把「瀏覽器登錄 → 模型列表 → 文本/圖片輸出」接到 ctx.llm 的連接器,而不是在插件裏手填 Token。
下面介紹社區插件 dsh-openai-account-connector(維護者 lxy271713),它面向 DSH Desktop,把 OpenAI 賬號登錄、實時 GPT 模型目錄和生圖能力掛到 Harness 的單一模型目錄上。
這是什麼¶
dsh-openai-account-connector 是 DSH 的社區插件,分類爲模型推理。簡介爲:OpenAI account model and image connector for DeepSeek Harness。
用戶只在 OpenAI 官方瀏覽器頁面 完成登錄;插件不提供 Token 輸入框,也不讀取、複製、記錄或返回 OAuth Token。連接成功後,在 ctx.llm 中註冊 openai-codex 路由;DSH 原生 Composer 可從 app-server 拉取模型目錄,並在所選路由上接收文本或 Harness 可持久化的圖片塊。生成文件在進入 Harness 附件存儲前,會經過路徑 containment、符號鏈接、文件類型和字節上限等檢查。
核心功能¶
賬號與模型¶
- 官方 OpenAI 賬號登錄(瀏覽器側),Harness 憑據庫只保存非機密的已連接標記。
- 插件內置經測試的 Codex runtime;用戶完成瀏覽器登錄即可。每次請求模型列表時,從該 runtime 刷新可用模型。
- 高級安裝可設置環境變量
CODEX_BIN或插件的executable選項,改用系統 Codex CLI。
文本與圖片¶
- 文本對話走同一
openai-codex路由。 - 生圖作爲實時賬號能力暴露,不一定在模型列表裏單獨佔一項。
- 每次請求在新的臨時執行工作區中運行;圖片只從官方 runtime 聲明的
generated_images根目錄導入,避免對項目目錄的隱式寫入。 - DSH 原生工具 schema 以 app-server 動態工具形式暴露;調用回到 Harness 智能體循環,並在所選 DSH 權限策略下執行。
與 account 表面的分工¶
需先安裝 Provider 中性的賬號表面包 dsh-account-authorization,再安裝本 OpenAI 專用 Connector。本包只負責 OpenAI 流程與適配器,並把 openai-codex 指給該適配器,避免與通用 pi-ai 適配器爭用同一路由。卸載本 Connector 不會移除其他 Provider 的賬號表面。
安全與狀態(README 摘要)¶
- Codex app-server 獨佔 ChatGPT OAuth 存儲與刷新。
- Harness
ctx.llm仍是唯一的 Provider/模型目錄;附件系統持有生成圖片字節與回放引用。 - 斷開連接只移除 DSH 連接與路由,不會把用戶從其他 Codex 客戶端登出。
環境與依賴¶
本版本面向正式 DSH Desktop 2.0.3,並在 dsh-account-authorization@0.1.0 提供「保留 authorization target」的兼容層時使用。更高版本的 Harness 可能在 authorization-target 相關改動(commit 732a504 之後)原生提供同等契約。另需 llm-pi-ai.delegatedProviders。
更新 Connector 會更新其綁定的兼容 Codex runtime,不會賦予 OpenAI 未給當前賬號開通的模型。
安裝與啓用¶
先做 Provider 中性賬號表面,再安裝 OpenAI Connector(命令來自項目 README,版本號以發佈包爲準):
dsh plugin --profile desktop add --save-exact dsh-account-authorization@0.1.0
dsh plugin --profile desktop add --save-exact dsh-openai-account-connector@0.1.4
安裝完成後,在 DSH Desktop 中按賬號連接流程在瀏覽器完成 OpenAI 登錄;連接成功後可在模型目錄中看到經 runtime 刷新的 GPT 模型,並選用 openai-codex 路由進行對話或生圖(具體 UI 以 Desktop 2.0.3 爲準)。
典型用法(文檔級流程)¶
README 未給出單獨的「curl 示例」,發佈驗收路徑可概括爲:
- 在 DSH Desktop 2.0.3 中完成上述插件安裝與 OpenAI 瀏覽器登錄。
- 確認模型列表隨請求刷新,發起一輪短文本對話。
- 在賬號具備生圖能力時驗證生成圖片預覽、重啓後的附件回放。
- 斷開連接後確認
openai-codex路由被移除。
開發者本地驗證構建與測試可使用倉庫腳本:
pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm pack:check
說明:單元測試不構成發佈證據;正式發佈要求真實 Desktop 窗口下完成連接、模型刷新、文本輪次、生圖預覽、重啓回放與斷連後路由移除。
已知限制與注意¶
- app-server 的圖片完成項與動態工具協議仍爲實驗性;Connector 會探測實時生圖能力,協議漂移時失敗關閉。
- app-server 不暴露 DSH 的
temperature、maxTokens、stop;請求若設置這些參數(含輔助標題請求)會顯式失敗,而不是靜默忽略或在 Harness 側解析標題 prompt。 - 生圖輪次在 runtime 確認輪次被中斷後,才發佈第一張完成的圖片。
- 因 app-server 無穩定 image-creation id,該 Provider 路由禁用整輪重試(含純文本);瞬時錯誤會直接呈現給用戶。
- Harness 附件暫無 staging 事務;成功保存附件後立即取消,可能留下一條未引用的內容尋址對象(由附件保留策略處理)。
- 其他 Provider 需要獨立的 Connector 包,不宜在本 UI 或 Harness 核心裏用分支堆疊。
適用場景¶
- 已在 DSH Desktop 2.0.3 生態中開發,希望用 OpenAI 賬號而非自管 API Key 接入 GPT 與賬號側生圖。
- 需要與 dsh-account-authorization 分工清晰、路由固定爲
openai-codex的集成方式。
安裝前請知悉¶
社區插件在 當前 dsh 進程權限下運行;安裝前應閱讀源碼與 MIT 許可證(見 GitHub 倉庫),並理解 OAuth 與 Codex runtime 由 app-server 側持有。DSH 社區插件目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-openai-account-connector 把 OpenAI 官方賬號登錄、動態 GPT 模型目錄與受控的生圖導入接到 Harness 的 ctx.llm,適合在 Desktop 2.0.3 上走賬號路線而非 Token 粘貼的開發者。