前言¶
在 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 粘贴的开发者。
