DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-ichuny-codex

d

dsh-ichuny-codex

Manifest valid
UI (client)hasBundlePatch

dsh-ichuny-codex

English | 简体中文

在 DeepSeek Harness 中使用本机已登录的 Codex。@ipedia/dsh-ichuny-codex 把 Codex 作为 My Codex 模型提供者接入 DSH,让对话、模型选择和额度查看留在同一个工作界面中。插件通过本机 codex app-server 通信,不另建登录流程,也不读取或保存 Codex 凭据。

能做什么

  • 使用已有 ChatGPT 登录:认证由 Codex CLI 负责;插件只读取登录状态和模型列表。当前适配器要求 chatgpt 登录,不支持 API-key 账户模式。
  • 在 DSH 中对话:支持文本和模型推理内容的流式输出,以及图片输入、文件句柄输入和请求取消。图片与文件需要 DSH 提供附件服务。
  • 接入 DSH 工具:当 DSH 请求携带工具时,Codex 可发起工具调用,由 DSH 执行并返回文本结果;此功能需要持久化 DSH 会话,并使用 Codex app-server 的实验性 API。
  • 查看 Codex 额度:选中 My Codex 时,Web 界面可显示 5 小时窗口的剩余额度;点击可查看套餐、每周额度和余额。额度数据由插件自己的本地路由提供。

插件默认使用依赖中固定版本的 Codex 原生程序,不依赖全局 codex 命令的版本。它直接启动子进程,不通过 shell 执行命令;不添加遥测或直连 OpenAI HTTP API。

安装

快速安装

已发布版本可直接通过 npm 包名安装到 DSH web profile:

dsh plugin --profile web add @ipedia/dsh-ichuny-codex --ignore-scripts --workspace-root

安装完成后重启 dsh web,在模型选择器中选择 My Codex。上述命令安装 npm 的 latest;如需在 1.7.14 发布后固定该版本,可使用 @ipedia/dsh-ichuny-codex@1.7.14 并添加 --save-exact。尚未发布时,可按下文从源码构建并安装本地包。

从源码安装

GitHub 仓库不提交生成的 lib/,从源码安装时需先构建并打包;不要直接把仓库 URL 当作已构建的插件包。下面以 Windows PowerShell 为例:

git clone https://github.com/ipedia825/dsh-ichuny-codex.git
cd dsh-ichuny-codex
npm ci --ignore-scripts --legacy-peer-deps
npm run verify
npm run build
$plugin = npm pack --ignore-scripts --silent
dsh plugin --profile web add "file:$((Get-Location).Path)\$plugin" --save-exact --ignore-scripts --workspace-root

安装后重启对应 DSH profile,在模型选择器中选择 My Codex。补丁条目为 llm-codex,实际 provider ID 是 my-codex。浏览器刷新不能替代宿主进程重启。

运行条件

  • Node.js 22.19 或更高版本;peer 声明支持 DSH 0.2.2-rc.1 和 0.2.2-rc.3。两套依赖已分别通过类型检查、现存测试和构建;rc.3 宿主还完成了安装并收到一次 My Codex 实际回复。rc.1 宿主固定的旧 Zod 版本仍有高危安全公告,建议尽可能升级至 rc.3。
  • 安装依赖时保持 optional dependencies 启用,以便安装 @openai/codex@0.169.0 对应平台的原生程序。
  • 运行 DSH 的同一系统用户已通过 Codex CLI 完成 ChatGPT 登录。可运行 codex login status 检查;全局 CLI 仅用于检查登录,不决定插件内置程序的版本。

如果 Codex 平台包缺失,重新安装并启用 optional dependencies,或在插件配置中将 command 设为 Codex 原生可执行文件的绝对路径。不要传入 shell 命令或 .cmd/.ps1 包装器。

使用与配置

插件通过 DSH 的插件配置机制接受以下字段:

字段默认值作用
commandbundled使用内置 Codex 原生程序,或指定原生可执行文件路径
cwd当前工作目录Codex thread 的工作目录
sandboxworkspace-writeCodex 沙箱模式:read-only、workspace-write、danger-full-access
approvalPolicyuntrustedCodex 审批策略:never、on-request、untrusted
requestTimeoutMs30000单个 app-server 请求超时,范围 1000–300000 毫秒

文本对话无需附件服务。图片由 DSH 附件存储读取并转成 data URL;文件以只读路径描述交给 Codex,而不是由插件直接读取任意文件。动态工具由 DSH 执行,支持文本以及来自 DSH 附件存储的图片工具结果(如 read_image);图片经请求投影后作为 Codex inputImage 回传,文本不丢失,整批编码后内容以 UTF-8 计不超过 4 MiB。同轮已到达的并发调用会一同交给 DSH,之后才到达的调用留到下一步,只有确实交给 DSH 的调用才要求在本次续接中回传结果。重复、缺失、超限或非文本结果会拒绝已暴露调用的待答批次。已完成的 Codex turn 若遇到 DSH 工具目录增删或 schema 变动,会在下一轮通过 thread/resume 更新工具声明;等待工具结果期间保留原目录直至该轮完成。每个 DSH 会话在插件进程中复用同一个 Codex thread;下一轮仅发送游标之后的新 user 消息,不再把历史系统指令或 assistant 回复当作新用户输入。新建 thread 时系统提示进入 Codex thread 指令。成功完成的回复把非敏感的 thread ID 和消息游标保存在 DSH replay 元数据中,插件重启后会尝试 thread/resume;旧版本已完成的回复没有此元数据,或压缩后游标与回复边界都消失时,无法安全恢复。恢复失败会报错,不会静默新建另一个 thread。

Web 额度控件仅在选择 my-codex 时出现。插件通过 /api/dsh-ichuny-codex/rate-limits 返回选定的额度字段,成功响应不包含账户 ID;错误消息会经过凭据样式脱敏后返回,但部署到非受信任环境前仍应审查访问控制。额度详情由 Codex 返回的数据决定,无法获取时控件会隐藏。

开发与验证

npm run verify
npm run typecheck
npm run lint
npm test
npm run build
npm run audit
npm run audit:permissions
npm run package:check

npm test 运行 vitest.config.ts 选中的全部 12 个现存 spec 文件,包含 adapter、动态工具和 Cordis 组合测试。构建、打包和这些自动测试不替代目标 DSH 宿主的实际对话验证;rc.3 的 My Codex 实际回复已由用户确认。实现边界与进一步的排障说明见 架构、配置 和 常见问题。

Apache-2.0 许可及原作者归属见 LICENSE 和 NOTICE。

Comments

Loading…