- Главная
- Плагины
- Модели и провайдеры
- dsh-codex-connect
dsh-codex-connect
franksong2702/dsh-codex-connect
Подключайте OAuth ChatGPT и модели OpenAI Codex к DeepSeek Harness, с опциональными инструментами поиска и работы с изображениями.
Установка
dsh plugin --profile web add github:franksong2702/dsh-codex-connectREADME
Codex Connect
Use your ChatGPT subscription as an openai-codex model provider in DeepSeek Harness. Codex Connect is a community Alpha plugin.
English | 中文
Quick start
1. Install
Run dsh --version first. For DSH 0.2.2-rc.1, install into your Web profile:
dsh plugin --profile web add dsh-codex-connect@0.2.0-alpha.15
dsh web
| Requirement | Verified default pairing |
|---|---|
| DeepSeek Harness | 0.2.2-rc.1 (DSH npm latest on 2026-11-17, with a consistent host package set) |
| Codex Connect | 0.2.0-alpha.15 (npm latest and alpha on 2026-11-17) |
| Node.js | ^22.19.0 || >=24.0.0 |
| Account | ChatGPT OAuth with access to the selected Codex model |
On this exact DSH version, dsh-codex-connect@latest resolved to Alpha 15 and passed isolated installation and keyless startup checks. For reproducible installs, use the exact version above. Check the full table before installing on another DSH version or in Desktop. Installation and upgrades · Alpha 15 release and promotion record
Replace web with your existing profile name and start Harness with that same profile. From a DSH source checkout, prefix the commands with pnpm.
2. Authorize and select a model
Open Settings → Models → Openai-Codex → Authorize, then complete approval yourself in the browser. If an embedded window is blocked, select Open ChatGPT sign-in page. Choose an openai-codex model in the normal Harness model picker.
Never paste an authorization URL, code, token, or account identifier into an issue, log, chat, or configuration file. For a browser on another device, the optional manual callback form can complete the pending login without forwarding the localhost callback port; follow Remote browser authorization.
3. Check the installation
For a package-manager-free diagnostic, run the already installed bin directly (replace these independently identified paths):
node /absolute/profile/node_modules/dsh-codex-connect/lib/bin.js doctor --json \
--install-anchor /absolute/dsh/node_modules/@deepseek-ai/dsh/package.json
doctor --json reports local installation metadata without a network request or raw credentials; an anchor does not prove that installation is running. Wrappers such as dsh plugin exec may reconcile dependencies. See runtime identity and direct diagnostics, including Desktop/ASAR limitations. Development builds containing that change also distinguish page, Host-loaded and installed plugin versions in settings. A passing diagnostic is not proof of model access; an actual request requires separate authorization.
Core capabilities
Codex Connect supplies the provider. Harness manages tools, permissions, approvals, attachments, sessions, compaction and recovery. Installing the plugin preserves your default model and search route. The plugin is independent of OpenAI and DeepSeek, and uses ChatGPT OAuth rather than an OpenAI Platform API key.
- Accounts: save up to 16 accounts on the DSH host and manually select the active account for subsequent requests. Account selection is not a per-session binding. Requests keep their captured account; the plugin does not rotate accounts or silently fail over.
- Models and Astra support: the currently verified DSH and plugin combination supports
gpt-6-astra. The plugin supplies its missing model definition with Low, Medium, High, Xhigh, and Max reasoning levels; Default preserves the provider default. Saved Off/Minimal selections require an explicit update. When the installed dependency catalog includes Astra, the plugin preserves its native metadata while retaining these five calibrated reasoning choices. A model appearing in the list does not mean the current account has permission to use it; overall compatibility with new dependency versions still requires separate verification. - Fast Mode: request priority service for one conversation, off by default. Optional, separate profile settings can enable it for newly started top-level or subagent conversations without changing existing conversations. Actual speed and quota consumption depend on the service; no fixed speed multiplier is guaranteed.
- Quota: show the server-returned
5hand7dwindows and reset times, normally refreshed every 60 seconds while signed in and the tab is visible; failures back off. Missing windows are not invented; Spark uses its separate quota bucket. - Plugin updates: check for newer Codex Connect releases without installing anything or recommending changes to DSH. Host compatibility is available through explicit local diagnostics.
Optional capabilities
Development now follows the core maintenance scope: maintain connection, compatibility, diagnostics and recovery; freeze Task orchestration and unproven optimization work. Existing published options are not removed or remotely disabled by this decision.
Alpha 4.40 also supplies gpt-6-sol and gpt-6-luna when older provider catalogs omit them, retaining native metadata when present. Both expose Low through Max (including Xhigh); Default omits an explicit effort. Codex Sol's Ultra orchestration mode is not implemented. New task grants can explicitly include these models, but existing grants and GPT-5.6 Sol/Medium startup remain unchanged; Luna Reserve has subsequently been removed. A catalog entry is not proof of account access. See compatibility scope and validation.
All options below are off on a fresh installation. Edit them in Settings → Plugins → Plugin configuration → Codex Connect or Settings → Models → Openai-Codex → More settings, then select Save changes. A conflict or failed save preserves your draft.
| Capability | Enable with | Important behavior |
|---|---|---|
| Proxy | enableProxy | Credential-free HTTP(S), scoped to this plugin's traffic, including compressed OAuth and quota responses. Unrelated Fetch calls retain the host's original transport. A failed proxy request does not silently retry directly. |
| Codex Search | enableSearch | Selects Codex for the entire profile's search route; disabling restores the previously active route. |
| Image viewing | enableImageTool | Adds view_image to vision-capable models for local files and validated public HTTP(S) images. |
| GPT Image generation and editing | enableImageGeneration | Generate from a prompt or edit selected conversation images with ordered references. Availability, dimensions, and quota remain account- and service-controlled. Also gates the cross-route image handle bridge, which persists the Codex Connect image selection handles into image tool results on non-Codex routes so image editing works there too; the openai-codex route is skipped because its adapter already injects the same handles per request. Optional imageHandleBridgeTools restricts the bridge to specific tools. |
| Auto-review | enableAutoReview | Sends bounded approval context, tool arguments, working directory, and the planned action to chatgpt.com, with confirmation on first enablement. Failures return to human approval. |
Luna Reserve has been removed. Legacy enableReserveFallback settings are ignored; no Reserve negotiation or automatic model switching remains. Select an ordinary model explicitly for an old gpt-reserve conversation. If the Host cannot change that conversation’s model, preserve it and start a new conversation with the model you choose. Old return files are not read, migrated or deleted. Account quota UI and the read-only quota tool retain ordinary 60-second caching and failure cooldowns, with no background polling. See migration guidance.
Use the image generation capability included with your current GPT subscription. Successful images appear below the conversation answer without opening its processing details; the original tool card remains available there. Generated originals are stored separately from attachment previews; disabling the capability or uninstalling the plugin does not delete them. See Configuration and recovery for storage and access rules.
Auto-review operates after Harness policy requires approval; it does not bypass that policy. See Auto-review behavior before enabling it.
Optional model quota observation: profile composition can set enableQuotaTool: true and reload the plugin to expose the read-only codex_connect_quota tool. It is off by default and has no custom settings-card toggle. It reports shared Codex window percentages, reset times and freshness, excluding balances and account identifiers. See quota observation and the optional skill example. Percentages are not task budgets; resource limits never justify dropping requirements, tests or safety checks.
FAQ and important limits
Where are my credentials stored?
OAuth credentials are stored on the host running DSH and used there to authenticate and send requests to OpenAI. Normal browser account responses return account summaries, not raw tokens. A remote browser device is not necessarily the DSH host.
Does uninstalling sign me out?
No. OAuth state is stored separately at $DSH_HOME/.openai-codex-auth.json (~/.dsh by default). The plugin does not copy or modify ~/.codex/auth.json. Use Sign out all accounts, or logout before uninstalling, only when deleting credentials is intentional.
Can I switch accounts for different conversations?
Subsequent Codex requests use the selected active account; conversations do not bind their own accounts. Fast Mode is conversation-scoped. Cancelling a new authorization preserves existing accounts; an explicit revoked-refresh response asks for reauthorization, while temporary failures preserve the account for retry. See Account behavior.
Why does a listed model fail?
Model HTTP/SSE failures include bounded, request-local diagnostic metadata after the existing error message. An overloaded message alone does not establish an account block. See persistent-error diagnostics for scope and reproduction.
Account permissions, plugin/host compatibility, and network conditions all affect availability. Access on another client does not guarantee this integration will work. OpenAI controls model access, quota, context capacity, and service behavior; catalog entries are not proof of entitlement.
Does changing client headers prevent persistent authorization failures?
No such guarantee is established. Codex Connect is a third-party integration; it does not impersonate Codex Desktop or fabricate installation/attestation headers. The pi-ai model/OAuth route and auxiliary routes currently identify themselves differently. OpenAI's App Server documentation asks integrations to identify their own client with clientInfo; it does not establish acceptance rules for this plugin's direct backend calls. An overloaded message is not proof of a block. Capture the bounded error metadata and compare successful and failed windows before attributing the cause; share request IDs privately, never tokens or full session archives.
Can I keep the original dsh-codex plugin installed?
Not in the same effective configuration: both register openai-codex. Follow MIGRATION.md; remove only the confirmed conflicting entry, not credentials or unrelated providers.
What do diagnostics prove?
doctor is local. Capability and reviewer probes may make network requests and consume quota when their preconditions are met. auto-review-probe checks only the reviewer route and structured response, not the full Harness approval integration or execution of the reviewed action. Commands, limits, and exit codes are in the diagnostics reference.
A missing entry in verified-compatibility.json means a DSH/plugin combination is unverified, not known to be broken. Do not infer support for newer hosts from an older pairing.
Documentation and development
- Installation and upgrades
- Release history
- Configuration, diagnostics, and recovery
- Local request metrics: enable, report, and disable
- Explicit, bounded bili preflight activity (source change; default off)
- Migration from
dsh-codex - Architecture and security details
- Auto-review behavior
- Release runbook, Contributing, and Security policy
pnpm install --frozen-lockfile
pnpm run check
pnpm run test:browser
pnpm run check:dsh-install
check covers static checks, unit tests, build, compatibility, and packaging. lint:metadata checks package and release rules; lint:source checks host and browser TypeScript for unhandled or misused promises, invalid awaits, duplicate cases, and unreachable code. Browser regression and isolated DSH installation are separate commands. These checks use no real OAuth authorization and do not replace real-account acceptance.
License and acknowledgements
Copyright 2026 Frank Song for Codex Connect modifications and additional work. This project contains software derived from Yan-Zero/dsh-codex; Copyright 2026 Yan-Zero is retained for upstream material. Both are distributed under Apache-2.0; see NOTICE.
Published 0.2.0-alpha.1 adds gpt-6.1-sol to the manual model catalog and configuration selector. It exposes Low, Medium, High, Xhigh and Max; Default omits effort, and Ultra orchestration is unsupported. At that release, the Codex fallback was 272,000 tokens with an optional 872,000 local ceiling, not the API product window or proof of account access. See metadata and validation. No Adaptive Task grants are expanded.
Alpha 5 capability calibration: the source comparison distinguishes the pinned 272k fallback/872k local ceiling, official Work/Codex product text advertising 500k surfaced in search results, and separate API limits. That historical change refreshed only Sol61's policy-source pin; then-current defaults, native-provider metadata precedence and Fast/effort behavior were unchanged. No account/endpoint capacity was verified.
Published base-default follow-up for #338: Sol61 now uses a dedicated 500,000-token base default for its missing entry and known old bundled-static metadata, following the official Work/Codex product default. Explicit provider metadata and user overrides keep precedence; other models, output limits and the 872,000 local override ceiling are unchanged. Scope and evidence distinguish the calibrated default from measured route capacity.
Published in Alpha 11: gpt-6.1-terra is available through the manual catalog and configuration selector, with text/image input and existing Responses tools. Its official Codex fallback is 500,000 tokens with an optional 872,000 local ceiling and 128,000 output limit; native provider metadata wins, with the same effort mask as Sol61. Low, Medium, High, Xhigh and Max are exposed; Default omits effort. API none is not advertised by the pinned OAuth catalog, and Ultra orchestration is unsupported. This does not add a desktop Computer Use executor or expand Ultrafast eligibility. Sources, scope and synthetic validation; real-account access remains unverified.
Похожие плагины
dsh-our-free-model
ebony-vinyl/dsh-our-free-model
dsh-routing-suite
yjh051108/dsh-routing-suite
dsh-connect-workbuddy
dingminhua/dsh-connect-workbuddy
dsh-workbuddy-connect
corrinehu/dsh-workbuddy-connect