- ホーム
- プラグイン
- モデルとプロバイダー
- dsh-codex
dsh-codex
goodjin/dsh-codex
Adds Codex (ChatGPT subscription) models to DeepSeek Harness as a model row, calling the Codex /responses endpoint directly with the local Codex CLI OAuth credential, and shows the official usage windows as a quota pill under the composer. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
インストール
dsh plugin --profile web add github:goodjin/dsh-codexREADME
@goodjin2/dsh-codex
DSH plugin: Codex 模型行 — 直接 HTTP 调用 Codex /responses 端点,复用本地 Codex CLI 的 OAuth 凭据。
恢复基线与验证记录见 2026-11-14 恢复记录。
安装
在 DSH profile 的 package.json 中添加:
dsh plugin --profile <your profile> add github:goodjin/dsh-codex
或者安装 npm 上发布的包(效果相同,同样免构建步骤):
dsh plugin --profile <your profile> add @goodjin2/dsh-codex
也可以下载 v0.1.0 发布页 的 tarball 安装:
dsh plugin --profile <你的 profile> add ./dsh-codex-0.1.0.tgz
或手工安装:
{
"dependencies": {
"@goodjin2/dsh-codex": "github:goodjin/dsh-codex"
}
}
然后运行 pnpm install 并把 insert 段合并到 profile 的 cordis.patch.yml。
前提条件
- 本地已安装 Codex CLI 并完成登录(
codex login) ~/.codex/auth.json存在且包含有效凭据
功能
- 将 Codex 模型(GPT-6.x、GPT-5.6 系列)作为 DSH 模型行
- 自动 OAuth 凭据读取与刷新
- 从
~/.codex/models_cache.json读取模型目录(带静态回退) - 配额信息从
x-codex-*响应头提取 - 推理强度折叠(
base[effort]→ 一条 + 强度轴)
开发
pnpm install
pnpm typecheck
pnpm test
pnpm build # 宿主产物 lib/host + 浏览器产物 lib/client.js
仓库随附编译产物(lib/host/** 与 lib/client.js):git 与 npm 安装都不在用户机器上跑构建脚本,
因此改完源码要跑 npm run build 并提交产物;npm run check 会检查产物是否与源码一致。
架构
src/codex/— 凭据管理、目录、请求构建、流解析、配额提取src/modelkit/— 模型行机器(适配、类型、路由、运行时账本、强度折叠)src/client/— 浏览器侧设置段
许可证
MIT
流式错误诊断
错误提示与会话 assistant/attempt 保留异常名称、消息、底层 cause 错误码,以及响应提供的 request ID;区分响应流读取失败、解析失败、缺少结束帧和请求取消。相同的脱敏摘要以 [codex] 前缀写入宿主 stderr。诊断最多保留五层原因链、2000 字符,不序列化请求/响应对象或记录认证凭据。历史中已被旧版本丢弃的异常无法补回。
官方额度胶囊
选择 acp:acp-codex-global(Codex Direct)时,输入框下方显示官方返回的用量窗口和积分;账号设置页也显示同一份数据。显示的是已用百分比,窗口长度按返回值标注,不固定假定为 5 小时/周。胶囊正文只显示周期与已用百分比;悬停可见来源、套餐、更新时间、重置时间,以及旧快照的“待刷新”状态。
宿主只读请求 https://chatgpt.com/backend-api/wham/usage,复用当前本机 Codex 登录凭据;同账号至少间隔 60 秒刷新,并合并并发读取。推理响应(含错误响应)的官方额度头也可更新快照。浏览器可见时每 30 秒向同源 /acp-codex/quota 取快照,离开组件会停止轮询。
未提供明确周期的次窗口不展示;原始额度数据仍保留,有明确周期的真实 0% 正常显示。缺失字段不会填 0。接口失败保留旧快照并标记“待刷新”;超过 5 分钟或窗口重置时间已过也标旧,不推算用量归零。切换账号、退出登录或认证失效时清除不适用的快照。缓存仅在内存中,宿主重启后重新取数。不会执行推理来查询额度,也不消耗重置额度。
字段依据:官方用量接口客户端、官方响应头解析。当前胶囊展示普通 Codex 限额,不把 additional_rate_limits 的模型专属额度混入。
官方请求重试
Codex 将明确的连接中断(如 UND_ERR_SOCKET、ECONNRESET)及流提前结束报告为
宿主标准 TRANSPORT,网络超时报告为 TIMEOUT;原始异常与底层错误码仍保留在错误详情中。
由 DSH 基础 bundle 的 dsh-llm-retry 执行默认有限重试(最多 5 次,指数退避),
持久化 llm/retry / llm/retry-started 事件。插件内部不另建请求重试循环。
用户取消、登录失败、普通 HTTP 错误与解析错误不因本次映射而重试。
这属于请求级恢复;auto-resume 的应用退出/崩溃后会话恢复仍是独立职责。