wingoo/codex-plugin-dsh 预览 preview

wingoo/codex-plugin-dsh

Plugin插件 Native原生 ⭐ 9 MIT Models & Routing模型与路由

在DeepSeek Harness中使用本地Codex App Server作为模型提供方

Project Overview项目介绍

This is a native DSH plugin that adds OpenAI Codex App Server as an LLM provider to DeepSeek Harness. It lets users connect to their already logged-in local Codex account without requiring an OpenAI API key to be configured in DSH. After installation and restarting DSH, the new “Codex App Server (local)” option will appear in DSH’s existing model selector, so users can just pick a model and start chatting. All conversation management and tool calling remains handled by DSH, so existing DSH plugins and tools work normally without changes.

Users can install this plugin multiple ways, depending on their current DSH setup. If your active DSH session has full host machine permissions, you can simply paste the provided installation prompt into DSH and it will complete the entire process automatically. You can also install it manually via the DSH CLI, with separate commands available for global DSH installs, npx-run DSH, and DSH built from source. You can lock the install to a specific commit hash to ensure consistency before the official stable release. Local checkouts of the repository can also be added directly via the CLI.

This plugin is released under the open-source MIT license, and has clear environment requirements that users must meet before installation. You need Node.js version ^22.19.0 or higher, DSH version between 0.1.0-rc.5 and 0.2.0, and a local Codex CLI of at least version 0.147.0 with a logged-in Codex account. Currently, the plugin has been verified on macOS, though Windows support has unit tests but remains untested on real Windows hosts. There are also known limitations, such as no DSH interaction question bridging yet, and some existing conversation content cannot be imported losslessly when switching providers.

这是一个专门为 DeepSeek Harness (DSH) 开发的原生 LLM 提供商插件,核心功能是让用户能够在 DSH 中直接使用本地已登录的 OpenAI Codex 账户,无需在 DSH 中额外配置 OpenAI API 密钥。安装并重启 DSH 后,用户就可以在 DSH 原生的模型选择器中找到「Codex App Server (local)」选项,选中对应 Codex 模型就能开始对话。会话和工具调用仍由 DSH 原生管理,现有 DSH 插件和工具都可以正常使用。

该插件面向同时使用 DSH 和 OpenAI Codex 的开发者,简化了 Codex 模型调用的配置流程。你可以直接让拥有宿主机完整权限的 DSH 会话自动完成安装,也可以通过 DSH 命令行手动安装,支持从 GitHub 远程仓库、本地检出目录两种安装方式,还支持锁定特定 commit 保证安装结果一致。安装完成后只需要沿用原有 DSH 启动方式重启服务,刷新页面就能在模型选择器中切换 Codex 模型。

该插件使用 MIT 许可开源,对运行环境有明确要求:需要 Node.js 版本不低于 22.19.0,DSH 版本在 0.1.0-rc.5 到 0.2.0 之间,本地 Codex CLI 版本不低于 0.147.0,还要有已通过 codex login 登录的 Codex 账户。目前已知存在部分限制,比如暂未实现 DSH 交互问题桥接,部分历史会话内容无法无损导入。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:wingoo/codex-plugin-dsh

把 wingoo/codex-plugin-dsh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

codex-plugin-dsh

中文 | English

Codex App Server 与 DeepSeek Harness 的本地 provider 架构

在 DeepSeek Harness 里直接使用你本机已经登录的 Codex,无需在 DSH 中配置 OpenAI API Key。安装并重启后,现有模型选择器中会出现 Codex App Server (local),选择模型即可开始对话。

会话和工具调用仍由 DSH 管理,现有 DSH 插件与工具可以照常使用;模型请求通过本地 Codex App Server 连接当前 Codex 账户。插件也支持图片输入,并能把 Codex 原生图片生成结果直接回写到 DSH 对话。

快速安装:直接让 DSH 完成

如果当前 DSH 会话具有完整的宿主机权限,把下面这段话直接发给它:

请将 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 并在宿主机上运行插件代码,请先确认仓库来源。重启期间当前连接会暂时中断,服务恢复后刷新页面即可。

通过命令行安装

dsh plugin --profile web add github:wingoo/codex-plugin-dsh

如果从 DeepSeek Harness 源码仓库运行:

pnpm dsh plugin --profile web add github:wingoo/codex-plugin-dsh

正式版本发布前,可以锁定已验证的 commit,让安装结果保持一致:

dsh plugin --profile web add github:wingoo/codex-plugin-dsh#<commit-sha>

安装本地 checkout

dsh plugin --profile web add /absolute/path/to/codex-plugin-dsh

从 DeepSeek Harness 源码仓库运行时:

pnpm dsh plugin --profile web add /absolute/path/to/codex-plugin-dsh

安装后使用

沿用原来的启动方式重启 DSH Web 服务,不要在同一端口启动第二个实例。服务恢复后刷新浏览器,在输入框下方打开现有模型选择器,然后从 Codex App Server (local) 分组中选择模型。

空白工作区会话最初使用当前默认模型;发送第一条消息前也可以先切换到 Codex。

更新已安装插件:直接让 DSH 完成

已经安装过插件时不需要先卸载。把下面这段话发给具有完整宿主机权限的 DSH 会话:

请把当前 DSH web profile 中已经安装的 codex-plugin-dsh 更新到 GitHub main 的最新版本,不要修改 DeepSeek Harness 源码,也不要先卸载插件。

1. 先运行 command -v dsh,确认当前环境能否直接调用 dsh。
2. 如果可以,运行 dsh plugin --profile web update codex-plugin-dsh;如果没有全局 dsh 命令且当前服务通过 npx 启动,改用 npx --yes @deepseek-ai/dsh plugin --profile web update codex-plugin-dsh。
3. 检查 ~/.dsh/profiles/web/pnpm-lock.yaml,确认 codex-plugin-dsh 的 GitHub tarball commit 已更新;同时运行 dsh --profile web --dump-config(npx 启动时使用对应的 npx 命令)确认 codex-app-server-provider 仍然存在。
4. 更新成功后,沿用当前 Web 服务原来的启动方式重启,不要在同一端口启动第二个实例。重启前提醒我连接会暂时中断。
5. 服务恢复后提醒我刷新页面,并新建一个会话测试 Codex 模型。

如果更新命令被 sandbox 拒绝,请只为这个更新操作请求所需权限;如果无法可靠判断原来的启动方式,不要猜测或结束无关进程,直接告诉我应该执行的重启命令。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev book-deepseek-harness 下一个 Next dshelm →