wingoo/codex-plugin-dsh
40最近提交 2026年8月14日
codex-plugin-dsh DSH 插件
本插件让 DSH 通过本地 Codex CLI 连接你的 Codex 账户，无需额外配置 API Key。安装后模型选择器会出现“Codex App Server (local)”分组，支持图片输入和 Codex 原生图片生成结果回写。会话管理、工具调用和权限控制仍由 DSH 负责。
如何安装 codex-plugin-dsh DSH 插件
dsh plugin --profile web add github:wingoo/codex-plugin-dsh复制不会执行命令。安装 codex-plugin-dsh DSH 插件前请核对仓库和版本。
codex-plugin-dsh DSH 插件数据来源
codex-plugin-dsh DSH 插件快照日期：2026年8月16日
discovered
codex-plugin-dsh DSH 插件能做什么
- 无需 OpenAI API Key，使用本地 Codex 登录状态
- 支持图片输入和 Codex 原生图片生成输出
- 与现有 DSH 插件及工具完全兼容，工具调用仍由 DSH 管理
- 通过 stdio 子进程与本地 Codex App Server 通信
- 利用 App Server 线程检查点保留动态工具目录
- 从其他 DSH 模型切换时可导入对话历史
codex-plugin-dsh DSH 插件适合哪些场景
- 在 DSH 中使用 Codex 模型进行对话，免去 API Key 管理
- 在 DSH 对话中调用 Codex 的图片生成能力
- 将 DSH 的工具生态（如文件编辑、网页浏览）与 Codex 的推理能力结合
- 无缝迁移现有 DSH 会话到 Codex 模型
codex-plugin-dsh DSH 插件适合谁
- 已安装并登录 Codex CLI 的开发者
- 希望使用 Codex 模型但不想在 DSH 中配置 OpenAI API Key 的用户
codex-plugin-dsh DSH 插件的限制
- 尚未实现 DSH 交互问题桥接，App Server 的 item/tool/requestUserInput 会失败
- 其他 provider 的 reasoning 块或 assistant 图片无法导入 App Server
- 不支持的配置字段（temperature、maxTokens、stop）会被拒绝，而非静默忽略
- 目前仅在 macOS 上验证，Windows 测试尚未完成
- 需要本地 Codex CLI >=0.147.0，Node.js ^22.19.0 或 >=24
codex-plugin-dsh DSH 插件的仓库 README 摘录
以下文字摘自 codex-plugin-dsh DSH 插件的上游仓库 wingoo/codex-plugin-dsh 的 README，版权归原作者，仅作引用。
中文 | [English](https://github.com/wingoo/codex-plugin-dsh/blob/main/README.en.md)  在 DeepSeek Harness 里直接使用你本机已经登录的 Codex，无需在 DSH 中配置 OpenAI API Key。安装并重启后，现有模型选择器中会出现 **Codex App Server (local)**，选择模型即可开始对话。 会话和工具调用仍由 DSH 管理，现有 DSH 插件与工具可以照常使用；模型请求通过本地 Codex App Server 连接当前 Codex 账户。插件也支持图片输入，并能把 Codex 原生图片生成结果直接回写到 DSH 对话。 ## 快速安装：直接让 DSH 完成 如果当前 DSH 会话具有完整的宿主机权限，把下面这段话直接发给它： ```text 请将 github:wingoo/codex-plugin-dsh 安装到当前 DSH 的 web profile，不要修改 DeepSeek Harness 源码。 1. 检查本机是否已经安装符合插件要求的 Codex CLI；如果尚未安装或版本过旧，请先按照 OpenAI 官方方式安装或升级。 2. 运行 codex login status 检查登录状态。如果尚未登录，请让我在运行 DSH 的主机终端执行 codex login；等我完成浏览器登录并回复“已登录”后再继续。 3. 确认 codex app-server --help 可以正常运行。 4. 安装插件，并通过 dsh --profile web --dump-config 确认 codex-app-server-provider 已加载。 5. 沿用当前 DSH Web 服务原来的启动方式完成重启，不要在同一端口启动第二个实例。重启前提醒我连接会暂时中断。 6. 服务恢复后提醒我刷新页面，并在现有模型选择器中选择 Codex App Server (local)。 如果无法可靠判断原来的启动方式，不要猜测或结束无关进程，直接告诉我应该执行的重启命令。 ``` 这会修改 DSH profile 并在宿主机上运行插件代码，请先确认仓库来源。重启期间当前连接会暂时中断，服务恢复后刷新页面即可。 ## 通过命令行安装 ```sh dsh plugin --profile web add github:wingoo/codex-plugin-dsh ``` 如果从 DeepSeek Harness 源码仓库运行： ```sh pnpm dsh
阅读完整 README仓库许可: MIT
codex-plugin-dsh DSH 插件常见问题
如何安装这个插件？
你可以将安装命令发送给具有完整宿主机权限的 DSH 会话，或者在终端中运行 `dsh plugin --profile web add github:wingoo/codex-plugin-dsh`。插件会自动检查 Codex CLI 是否已安装并登录，然后重启 DSH Web 服务。详细步骤请参考 README 中的“快速安装”部分。
安装前需要准备什么环境？
需要 Node.js >=22.19.0 或 >=24，DeepSeek Harness >=0.1.0-rc.5 <0.2.0，以及已安装并登录的 Codex CLI >=0.147.0（通过 `codex login` 登录）。插件不会为你下载或升级 Codex，请手动准备。
如何更新已安装的插件？
你可以将更新命令发送给具有完整宿主机权限的 DSH 会话，或者在终端中运行 `dsh plugin --profile web update codex-plugin-dsh`。更新会刷新 GitHub 依赖的 commit 引用，同时保留已有的插件配置。更新完成后必须重启 DSH Web 服务才能加载新代码。
插件支持图片输入和图片生成吗？
支持。插件允许以 data URL 形式输入图片（无需共享文件路径）。Codex 的原生图片生成功能被特意保留，生成的图片会保存为 DSH 图片附件并显示在对话中。图片生成是否可用取决于你的 Codex 账户、所选模型和 App Server 的能力。
可以使用所有 Codex 模型吗？
插件会展示本地 Codex App Server 中可用的模型列表，具体取决于你的 Codex 账户和 App Server 的目录。你可以在 DSH 模型选择器的“Codex App Server (local)”分组中选择模型。部分模型可能不支持图片生成等特性。