前言¶
在 DeepSeek Harness（DSH）里接入 Codex，常见做法是准备 OpenAI API Key，或额外安装 Codex CLI 做中转。如果你本身已有 ChatGPT/Codex 订阅，更希望额度、搜索和图片能力都留在 DSH 会话里完成，就需要一条不依赖 API Key 的接入路径。
下面介绍社区插件 dsh-codex-subscription（维护者 WSL043，GitHub 仓库 WSL043/dsh-codex-subscription）。它在 DSH 内完成独立 OAuth 登录，把订阅模型、真实额度、搜索路由和图片生成接到同一套界面里，无需 OpenAI API Key，也无需 Codex CLI。
这是什么¶
dsh-codex-subscription 是 DeepSeek Harness 的模型推理类插件，npm 包名同为 dsh-codex-subscription，当前版本 v1.9.0，采用 MIT 许可证。插件在 SkillHub 社区目录 归类为「模型推理」；截至撰写时，GitHub 显示 22 stars、3 forks。
它的定位很直接：用你已有的 ChatGPT 账号（需当前具备 Codex 访问权限）在 DSH 里登录，随后像选普通模型一样选用 Codex 系列，并在设置页查看额度、选择搜索来源、切换 Fast 模式等。订阅路由失败时会显式报错，不会静默切到其他付费通道。
官方 README 写明，插件兼容 DeepSeek Harness 0.1.1-rc.2 及此前版本范围；使用前请确认本机 DSH 版本与插件 compatibility.json 一致。
核心功能¶
以下能力均来自仓库 README 与 package.json 描述，按使用路径归纳。
订阅登录与模型¶
- 通过 ChatGPT OAuth 在宿主机本地保存凭据，设置页提供浏览器登录，无需粘贴 token，也无需 Codex CLI。
- 登录后可在对话中选择 Codex 订阅模型；支持 Standard / Fast 模式切换（在 composer 内操作）。
- 上下文窗口可按模型目录默认值、各模型支持的 Extended 窗口，或为每个模型单独填写完整数值 token 上限；Custom 模式会校验模型容量，并接入 DSH 原生的 agent compaction 策略。
额度与重置¶
- 展示后端返回的真实额度，标准 Codex、Codex-Spark、Credits 等限额分开显示。
- 可查看下次到期时间与重置次数；如需提前重置，需经确认与冷却，不会自动重试。
- Composer 内可选紧凑百分比、进度条或不显示额度（默认关闭）。
搜索与图片¶
- 全局搜索路由可在「DSH 默认搜索」与「已登录的 Codex 订阅搜索」之间显式选择，对所有模型和会话生效，不随当前选中模型变化。
- 支持 Codex 图片生成与编辑（Beta）：可无参考图生成，或选定一张图片做区域标注后编辑；支持预览、缩放、下载原图，并在同一 composer 继续对话。
诊断与支持¶
- 登录状态会自动对账；设置页可生成不含凭据或账号标识的支持报告，包含有界请求阶段、HTTP/传输类型、耗时区间和路由来源等信息，便于排查订阅路由问题。
安装与启用¶
安装前请自行阅读仓库源码与 MIT 许可证。DSH 插件以当前 dsh 进程权限运行，安装命令会修改 profile 下的插件列表。
已有 dsh 命令¶
若本机已配置全局 dsh（含 DSH-Portable 的标准插件命令），执行：
dsh plugin --profile web add dsh-codex-subscription
验证是否安装成功：
dsh plugin --profile web list dsh-codex-subscription --depth 0
dsh --profile web --dump-config
插件列表应出现一条 dsh-codex-subscription，配置中应有 codex-subscription 条目。
官方 npm 路线（已安装 Node.js）¶
若通过 npx @deepseek-ai/dsh web 启动且没有全局 dsh 命令，需保留完整 npx 前缀，并锁定与插件兼容的 DSH 版本：
npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add dsh-codex-subscription
npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web list dsh-codex-subscription --depth 0
npx -y @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
Windows 一键脚本¶
在 Windows 上，也可在 PowerShell 中运行官方发布脚本，脚本会检测当前目录、系统命令、常见安装位置以及正在运行的官方 DSH 或 DSH-Portable，并在多个候选目标时询问后再安装：
irm 'https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1' | iex
安装后启用¶
安装完成后需手动重启 DSH，然后按 README 的三步流程操作：
- 打开 Settings → Codex。
- 使用具备 Codex 访问权限的 ChatGPT 账号完成浏览器登录。
- 选择搜索来源，并在模型列表中选中一个 Codex 模型。
若希望由 Agent 代为安装、更新或卸载，仓库提供 AGENTS.md 指引，其中包含校验步骤，并要求保留现有 DSH profile、登录状态与其他插件。
不想自行配置 Node.js 时，README 建议可考虑社区便携发行版 DSH-Portable；走官方路线则参考 DeepSeek Harness 运行指南。
典型用法¶
完成安装与登录后，日常流程与使用 DSH 内置模型类似，差异主要在 Codex 相关设置。
选择模型与模式。 在 composer 的模型选择器里挑选 Codex 订阅模型；对支持的模型可在 Standard 与 Fast 之间切换。
配置搜索。 在 Settings → Codex 中决定全局搜索走 DSH 默认搜索还是 Codex 订阅搜索。该选项作用于所有会话，不随单次对话的模型选择改变。
查看与管理额度。 在同一设置页查看各独立限额与到期时间；需要时可按界面提示尝试额度重置（带确认与冷却）。若希望在对话界面看到额度，可在设置里开启百分比或进度条显示。
图片生成与编辑（Beta）。 在支持该能力的 Codex 模型下，可直接发起无参考图生成，或选中一张图片、标注区域后继续编辑，并在同一 composer 里衔接后续对话。
排查问题。 若登录或路由异常，可在设置页导出支持报告，对照其中的请求阶段与路由来源类型定位问题，或通过 README 中的反馈链接提交 issue。
适用场景与注意¶
适合谁
- 已有 ChatGPT/Codex 订阅，希望在 DSH 智能体工作流里直接使用订阅额度，而不想维护 OpenAI API Key。
- 需要在 DSH 内区分标准 Codex、Spark、Credits 等限额，并希望在界面里看到真实后端额度而非估算值。
- 希望搜索、图片、Fast 模式与模型上下文设置都留在 DSH 同一套 UI 中完成。
使用前注意
- 账号需当前具备 Codex 访问权限；插件不会替你开通订阅。
- 插件与 DSH 版本有对应关系，README 以
0.1.1-rc.2为兼容基准，升级任一侧前建议核对compatibility.json。 - 安装、更新、卸载会改动 web profile 下的插件配置；多人共用机器时请确认 profile 路径。
- SkillHub 是独立于 DeepSeek / 幻方的社区插件目录，并非官方应用商店；插件质量与维护节奏以仓库与维护者为准。
结尾¶
dsh-codex-subscription 把 ChatGPT/Codex 订阅接到 DSH 的 OAuth、模型选择、额度展示、搜索路由和图片能力上，省去 API Key 与 Codex CLI 的额外配置。若你正在 DSH 生态里寻找订阅型 Codex 接入方案，可从社区目录页或 GitHub 仓库阅读完整文档后安装试用。
