wss534857356/dsh-plugin-codex 预览 preview

wss534857356/dsh-plugin-codex

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

使用本地 Codex 登录的 DeepSeek Harness 的 Codex 应用服务器模型提供程序。

Project Overview项目介绍

This is a native DSH plugin that registers a locally authenticated Codex App Server as a selectable main LLM provider for DeepSeek Harness. As an out-of-tree bundle, it does not modify the core deepseek-harness repository during installation, which keeps your core DSH setup clean and separate from third-party provider code. Unlike DSH’s built-in codex subagent that treats Codex as a delegated child agent, this plugin registers Codex directly on ctx.llm, so you can select codex-local as the provider for the entire DSH agent loop. It reuses your existing Codex account authentication from CODEX_HOME, and never reads, logs, or stores your OAuth tokens or API keys.

During a standard conversation, the plugin pins a single Codex App Server thread and reuses it for the duration of the cache lease. It injects DSH system text as base instructions, rebuilds cold threads by adding all previous logged DSH messages, and maps DSH tools to the deepseek_harness namespace in Codex. All incoming Codex outputs, including reasoning, diagnostics, tool actions, and images, are converted to standard DSH stream events so they display correctly in DSH’s interface. This plugin is targeted at developers who already run a local Codex App Server and want to use Codex as the main LLM for their DSH agent workflows.

This plugin is released under the open-source MIT license, and uses pnpm as its package manager for development and building. You must already have a local Codex installation that you have logged into, as the plugin does not provide any UI for entering or managing credentials. All authentication and subscription status is handled by your existing local Codex installation, and any login failure is passed through as a DSH authentication error. To install the plugin, you need to run pnpm install, pnpm run build, and pnpm pack to create the bundle, then load the packed bundle into your DSH plugin directory.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,为 DSH 注册了基于本地已认证 Codex App Server 的主模型提供商。它属于树外捆绑包,安装过程不会修改 deepseek-harness 核心仓库,还会复用你本地 Codex 的账户认证状态,不会读取或存储你的 OAuth 令牌和 API 密钥。和 DSH 内置的 @deepseek-ai/dsh-subagent-codex 不同,该插件将 Codex 注册在 ctx.llm 下,因此 codex-local 可作为 DSH 主代理循环的可选提供商使用。

普通 DSH 对话会话会复用固定的 Codex App Server 线程,在缓存租期有效时保持会话连接。插件会将 DSH 系统提示作为基础指令传入,重建冷线程时会注入所有历史日志消息,按命名空间声明 DSH 工具,再将用户消息通过原生回合输入传递给 Codex。它适配了图片附件的双向转换,适配 DSH 的缓存统计和会话重放功能,适合已经本地安装 Codex App Server、希望在 DSH 中将 Codex 作为主模型使用的开发人员。

本插件基于 MIT 许可证开源,开发依赖 pnpm 包管理器,需要用户本地已经完成 Codex 登录认证,插件本身不提供凭据界面,登录失败会直接返回 DSH 认证错误。安装后自带浏览器端渲染插件,可兼容 DSH 标准界面显示 Codex 动作块、推理内容和图片。安装需要先构建打包,再加载到 DSH 的插件目录中使用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
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:wss534857356/dsh-plugin-codex

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

READMEREADME

dsh-llm-codex-app-server

English | 中文

dsh-llm-codex-app-server registers a DeepSeek Harness main-model provider backed by the locally authenticated Codex App Server. It is an out-of-tree Harness bundle, so installing it does not modify the deepseek-harness repository.

This differs from Harness's built-in @deepseek-ai/dsh-subagent-codex. The built-in package exposes Codex as a delegated child Agent. This package registers on ctx.llm, so codex-local is a selectable provider for the Harness Agent loop.

Screenshot

Conversation screenshot

Model selector

Codex App Server settings card

CDP capture log and verification details

How it works

An ordinary Harness conversation session reuses one pinned @openai/codex@0.154.0 App Server in a private empty directory and one ephemeral thread while its bounded cache lease remains valid. The process uses the native Codex account state under CODEX_HOME; the plugin never reads, copies, logs, or stores OAuth tokens or API keys. Requests without a session id and auxiliary requests remain one-shot.

The adapter supplies the Harness system text as App Server base instructions, reconstructs cold threads by injecting all logged Harness messages before an empty turn, declares Harness tools under the deepseek_harness App Server namespace, and sends later ordinary user messages through native turn input. When one DSH step appends several inbox messages, the first starts the turn and the rest enter that same turn through ordered turn/steer requests. The outer Harness skill tool is exposed there as harness_skill; its argument schema accepts only names from the current Harness session catalog, while Codex-native skills stay on Codex's own loader. A warm thread is reused only when the complete request is an append-only continuation the adapter can reproduce; otherwise it is discarded and rebuilt. App Server still adds Codex-owned instructions and tools. This is deliberately a layered provider, not a raw-model transport or a claim that Harness replaces the Codex prompt.

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

← 上一个 Prev DSH-LLM-wiki-plugin 下一个 Next organon →