适配 GPT 模型的推理等级与上下文设置,并复用本地 Codex 指令、技能、插件资源和 MCP 配置。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-gpt-adapter
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:oh-dsh-plugins/dsh-gpt-adapter
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 简体中文
面向 DeepSeek Harness(DSH)的第三方插件,提供 GPT 模型适配,并复用已有 Codex 环境。无需移动或改写原文件,即可读取 Codex 指令、技能、已启用插件资源和 MCP 服务器配置。
功能
- 自动发现上游模型,在原生模型设置页中管理。
- 提供
low、medium、high、xhigh、max、ultra六档 GPT 思考等级。 - 为每个模型选择「默认」「516K」「1M」或「自定义」上下文窗口。
- 在聊天栏选择 Standard 或 Fast 速度,也支持上游声明或自行配置的 Ultrafast 档位。
- 复用 Codex 指令文件、本地及插件技能、MCP 服务器。
- 将受信任项目的配置应用到对应会话代理(Agent)。
思考等级、速度档位和上下文上限取决于所连接的模型网关。本地预设不会提高上游实际能力。
界面文案、上下文预设、插件配置说明和插件自有校验错误跟随 DSH 原生语言设置,支持简体中文和英文;其他原生语言使用英文回退。切换语言保留正在编辑的草稿。模型/技能名称、用户自定义标签、协议标识和上游错误原文保持原样。
安装
需要 Node.js >=24.9.0、Cordis 4.1.0,以及 DSH 0.2.2-rc.1、0.2.2-rc.2 或 0.2.2-rc.3。
在 DSH 的 web 配置档(profile)中安装 npm 包:
dsh plugin --profile web add dsh-gpt-adapter@0.2.9
安装或升级后重启 DSH。使用其他配置档时,将 web 替换为对应名称。
如需从源码安装本地构建,还需要 pnpm:
git clone https://github.com/oh-dsh-plugins/dsh-gpt-adapter.git
cd dsh-gpt-adapter
pnpm install --frozen-lockfile
mkdir -p artifacts
pnpm pack --pack-destination artifacts
dsh plugin --profile web add ./artifacts/dsh-gpt-adapter-0.2.9.tgz
使用 GPT 模型
- 打开「设置 → 模型」,配置提供商的服务地址、API 密钥和模型列表。支持 OpenAI Responses 和 Chat Completions 协议。
- 查看提供商卡片上的「GPT 自动适配」。插件会自动识别符合条件的 GPT 提供商,也可使用开关启用或停用适配。
- 在对话中选择模型和思考等级,通过聊天栏的速度菜单选择 Standard 或 Fast。
Fast 会请求上游优先档位。只有上游明确声明或通过能力覆盖配置时,才会显示 Ultrafast。速度选择按会话保存。
使用提供商卡片上的「立即同步」刷新模型列表。上游不再列出的模型会保留到主动移除。卡片还可配置同步间隔、可选的能力目录地址和模型能力覆盖。显式覆盖优先于上游元数据、外部能力目录和预设。
上下文窗口
打开「设置 → 模型 → 自定义设置 → 模型目录」,使用模型的「上下文窗口」字段:
| 选项 | 行为 |
|---|---|
| 默认 | 根据提供商默认值、模型元数据、能力目录和内置预设自动解析。 |
| 516K | 设置为 516000 个词元(token)。 |
| 1M | 设置为 1000000 个词元。 |
| 自定义 | 输入词元数,或十进制 K/M 数值,例如 750K、1.2M。 |
仅「自定义」显示输入框,修改后使用原生「保存」按钮提交。已有明确容量在主动修改前继续生效;不同提供商下的同名模型独立设置。
上下文容量需要大于最大输出预算与 DSH 压缩预留之和。最大输出和自动压缩仍由 DSH 控制。修改本地窗口不会改变上游实际限制,修改对下一次准备的请求生效。
复用 Codex 环境
Codex 兼容默认开启。目录优先采用插件配置中的 codexHome,其次为 CODEX_HOME,最后为 ~/.codex。
| 资源 | 支持行为 |
|---|---|
config.toml |
读取用户配置和受信任项目的 .codex/config.toml 配置层。 |
| 全局指令 | 优先使用非空的 AGENTS.override.md,否则使用 AGENTS.md。 |
| 项目指令 | 从仓库根目录读取到 DSH 当前工作目录,支持配置中指定的后备文件名。 |
| 共享指令 | 保留 DSH、共享指令和适用的本地指令覆盖。 |
| 技能 | 加载 Codex 的 skills/、skills/.system/、已启用插件技能,以及原生共享和项目技能;遵循技能启用配置,保留原始资源路径。 |
| 已启用插件 | 读取支持的本地插件声明及其技能、MCP 资源;禁用插件保持禁用。 |
| MCP 服务器 | 导入已启用的 mcp_servers 和已启用插件声明的 MCP。 |
指令变化在下一模型步骤生效。插件读取指令文件,不会导入 Codex 内置系统提示词。移除插件后,已有对话历史继续保留。
插件资源需要已存在于配置的本地市场或 Codex 插件缓存中,适配器不会下载资源。插件技能和服务器会在需要时添加插件名前缀,避免名称冲突。
MCP 服务器
支持标准输入输出(stdio)和流式 HTTP(Streamable HTTP)两种传输方式。可以复用已有配置中的命令、参数、工作目录、环境变量、请求头、令牌环境变量、超时,以及工具启用和禁用列表。
MCP 连接在代理首次执行模型步骤前建立。每个代理独立持有连接,受信任项目的覆盖配置只在对应代理内生效。未显式配置 cwd 时,stdio 服务器使用代理的工作目录。代理空闲一分钟后释放连接,在下一步骤前重新连接。启用配置监听时,正在执行的代理自动更新连接;空闲代理在恢复执行时应用配置变化。
可通过 mcpIdleTimeoutMs 调整空闲保留时间,设为 0 则保留连接直到代理销毁。重新连接可能重置服务器仅保存在内存中的状态;需要跨轮次保留这些状态的服务器应设为 0。
认证所需环境变量需要存在于 DSH 宿主环境。依赖 Codex App 认证、浏览器扩展或其他本地服务的服务器,仍需要这些服务可用。适配器不会复现 Codex 的 OAuth、钥匙串会话、App 进程间通信服务、Hooks、专用命令和权限策略。审批与沙箱仍由 DSH 管理。
可选配置
现有 gpt-adapter 插件设置提供以下选项:
codexCompatibility:
enabled: true
# codexHome: /path/to/existing/codex-home
importInstructions: true
importSkills: true
importMcpServers: true
importPluginResources: true
watch: true
mcpIdleTimeoutMs: 60000
pollIntervalMs: 2000
mcpAllowlist: []
mcpAllowlist 为空时导入所有已启用的声明服务器;非空时按原始服务器名筛选。将单项导入选项设为 false 可关闭对应资源类型;将 enabled 设为 false 可关闭 Codex 兼容。
数据与移除
模型快照和已保存的速度选择位于 $DSH_HOME/storages/gpt-adapter,Codex 源文件和导入的 MCP 凭证不会复制到该目录。
停用 GPT 自动适配后恢复原生推理等级控件;上下文窗口预设继续可用,并通过 DSH 原生设置保存。禁用或移除插件会撤销其运行时注册,不改动 Codex 源文件,也不删除 DSH 对话历史。
许可证
链接
同类插件
Ebony-Vinyl/dsh-our-free-model★ 77208
为 dsh 接入免费模型车道(含 DeepSeek V4.1 Flash、Kimi K3 等),无需登录、注册或填写 API Key,并提供本地 OpenAI 兼容网关、降级路由与用量看板。
dingminhua/dsh-connect-workbuddy★ 1681
将本机登录的 WorkBuddy 模型(国内版与国际版)接入 DSH,每次刷新按上游目录读取每个模型的积分倍率,支持逐模型图片输入开关、带自动换号的账号池、手动每日签到,以及卡片与输入框里的只读积分胶囊读数。
Alice-Marx/dsh-model-router★ 966
为 DeepSeek Harness 规划有依赖的工作包,将其分配给已配置的模型 API 或支持的厂商 CLI,并提供费用预览。
V1ki/dsh-plugin-subscriptions★ 618
把 ChatGPT(Codex)、Claude、Grok 订阅当作 DeepSeek Harness 的 LLM 提供方:设置页登录、模型目录、用量展示,以及 image_generate、video_generate 与 x_search 工具。
XDTrees/dsh-workbuddy-xdpool★ 541
把本机 WorkBuddy 桌面 App 登录过的所有账号自动并入 DSH 模型池:多账号轮换自动容错、实时积分,模型目录按模型标注积分倍率与限时免费 / 夜间折扣。
XDTrees/dsh-xdpool★ 541
把本机 WorkBuddy 桌面 App 登录过的所有账号自动并入 DSH 模型池:多账号轮换自动容错、429 冷却、实时积分,模型目录按模型标注积分倍率与限时免费 / 夜间折扣,扫码登录 13 家厂商,聚合免费额度渠道。账号重启不丢。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。