dsh-gpt-adapter

DSH GPT Adapter

English | Simplified Chinese

A third-party DeepSeek Harness (DSH) plugin for GPT models and existing Codex environments. Install one plugin to reuse local Codex instructions, skills, enabled plugin resources, and MCP server configurations without moving or rewriting Codex files.

Features

• Discover upstream models with GET /models and retain stale entries until explicit cleanup.
• Provide the GPT reasoning preset low / medium / high / xhigh / max / ultra through the native Models page and conversation menu.
• Offer independent Standard and Fast speed choices. Fast sends service_tier: "priority"; Ultrafast requires an explicit upstream declaration or override.
• Preserve optional function arguments on GPT Responses requests by setting missing strict values to false.
• Read Codex instruction files and refresh them at the next model step without repeating unchanged baselines.
• Register Codex local skills and enabled plugin skills with their original resource paths.
• Mount enabled Codex MCP servers through the official DSH MCP client and reconcile changed connections automatically.

Reasoning and speed presets are requests to the configured gateway, not guarantees of upstream support. User overrides, explicit upstream capability metadata, and external catalogs take precedence over presets.

Compatibility and installation

The native integration targets DSH 0.2.2-rc.1, Cordis 4.1.0, and the pinned adapter source hash. The development dependency uses Pi AI 1.3.0. Installed third-party package files are never edited. The package has not been published to npm.

Requires Node.js >=24.9.0 and pnpm.

git clone https://github.com/lxjmaster/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.1.tgz

pnpm pack runs the production build. Restart the DSH host after upgrading the installed package. Configure GPT connections as usual under Settings → Models. The plugin extends the existing native settings and conversation controls.

Codex environment reuse

Codex compatibility is enabled by default. The root is the plugin's codexHome override, then CODEX_HOME, then ~/.codex.

Resource	Behavior
config.toml	Read user configuration in place, then trusted project .codex/config.toml layers from repository root to cwd; connection secrets stay in memory
Global instructions	First nonempty AGENTS.override.md, otherwise AGENTS.md
Project instructions	Repository root to current DSH working directory; first nonempty override, base file, or configured fallback per directory
DSH/shared global instructions	Retained from ~/.dsh/AGENTS.md and ~/.agents/AGENTS.md (or their configured environment roots)
Local overlays	Existing AGENTS.local.md and CLAUDE.local.md remain applicable
Codex skills	Discover skills/ and skills/.system/; bodies load on demand
Shared/project skills	Retain native discovery and include .agents/skills at every directory from cwd to repository root; nearer project skills take precedence
Skill enablement	Honor ordered skills.config name/path selectors and skills.bundled.enabled
Enabled plugins	Read declared skill roots and inline or file-referenced mcpServers; disabled plugins stay disabled

The compatibility layer reads project instructions through DSH's filesystem, selects candidates using Codex precedence, and replaces native messages only for covered scopes. Additional nested instruction updates remain applicable. It does not import Codex's built-in system prompt. Configured fallback filenames such as CLAUDE.md are used only when supplied in Codex configuration. Instructions are recorded as ordinary user context with a bounded byte budget, including an explicit zero budget; they do not override system, developer, or direct user instructions. Existing conversation history is retained when the plugin is removed.

Plugin resources are resolved from the configured local marketplace, or the newest locally cached version in the matching marketplace. Nothing is downloaded automatically. Plugin skills use <plugin>-<skill> names to fit DSH's skill-name format and avoid cross-plugin collisions. Original skill paths and relative resources remain intact.

MCP compatibility

The plugin automatically starts enabled MCP commands and connects configured HTTP endpoints for each Agent session. It imports mcp_servers and the MCP resources declared by enabled plugins. Trusted project overrides apply within that Agent's scope; concurrent sessions do not share imported tool registrations. Untrusted project configuration is skipped.

Supported configuration includes:

• stdio command, args, cwd, env, and env_vars;
• Streamable HTTP url, http_headers, env_http_headers, and bearer_token_env_var;
• enabled, startup/tool timeouts, enabled_tools, and disabled_tools;
• plugin-root substitutions in plugin server declarations.

Global server names are retained where DSH permits them. Plugin servers use a plugin prefix. Unchanged connections are preserved. Changed or removed connections are disposed before replacement. Invalid configuration retains the last working snapshot, including individually invalid server entries. With automatic refresh enabled, failed startup retries with exponential backoff for up to ten attempts; a manual refresh resets that budget. The default two-second refresh detects configuration and plugin-resource changes; native skill watchers detect skill file changes.

Credentials are not copied into DSH settings, plugin caches, or this repository. Status responses contain only resource names, states, and sanitized reason codes. Missing environment variables must exist in the DSH host environment to be inherited.

This is environment compatibility, not a replacement Codex runtime. Codex OAuth/keychain sessions, Codex App IPC services, hooks, app components, permission policies, and proprietary commands are not automatically reproduced. Standard MCPs using configured headers/environment can be reused; servers requiring unavailable runtime authentication or services report a connection failure. Plugin hooks/apps/commands are reported as unsupported rather than executed. DSH retains its own approval and sandbox behavior.

Inspect status through the authenticated host method gptModels/codexStatus; use gptModels/refreshCodex to request a configuration refresh. Resource states are loading, loaded, disabled, unsupported, or failed. A loaded MCP entry means its initial connection and tool discovery completed; subsequent reconnection is managed by DSH.

Optional controls

No per-server reconfiguration is needed. The existing gpt-adapter plugin settings also expose:

codexCompatibility:
  enabled: true
  # codexHome: /path/to/existing/codex-home
  importInstructions: true
  importSkills: true
  importMcpServers: true
  importPluginResources: true
  watch: true
  pollIntervalMs: 2000
  mcpAllowlist: []

An empty mcpAllowlist imports all enabled declared servers. A nonempty list filters by the original server key. Disabling or removing the plugin withdraws its runtime registrations and leaves Codex files untouched. Native DSH model configuration and other plugins remain in place.

GPT model controls and storage

Capability precedence is user override, explicit upstream metadata, external catalog, then preset. Catalog requests never receive the provider API key. Model-list responses may omit capability metadata. Reasoning is sent as reasoning.effort for Responses and reasoning_effort for Chat Completions; the selected protocol is preserved.

Preset reasoning fields are projected into the native UI rather than persisted into native model configuration. Disabling GPT adaptation restores the native model values and schema. Speed selections are persisted per session. Synchronization failures retain the previous snapshot; absent models remain stale until explicit cleanup.

GPT model snapshots and speed selections are stored under $DSH_HOME/storages/gpt-adapter. Codex source files and imported MCP credentials are not copied there. The DSH host owns normal session transcripts and logs.

Development

pnpm install --frozen-lockfile
pnpm check
pnpm test
pnpm build

Tests use temporary directories, synthetic credentials, simulated upstream streams, and a real local fixture MCP process. They do not establish real-account support, upstream reasoning quality, external MCP authentication, or Codex App runtime availability.

License

MIT. See third-party notices for reused DeepSeek Harness assets. This project is independently maintained and is not affiliated with DeepSeek or OpenAI.