## 痛点与解决
@@ -148,8 +174,9 @@ Codex++ 启动后会解锁插件入口，并在会话列表悬停时显示删除
1. 确认已经检测到 ChatGPT 登录状态。
2. 添加一个或多个中转配置，填写 Base URL 和 Key。
-3. 选择当前配置并应用中转注入。
-4. 启动 `Codex++`。
+3. 按需打开“允许当前中转使用图片生成”。如果主中转组没有图片权限，保持关闭；如果希望图片生成走单独通道，填写独立图片 Base URL 和 Key。
+4. 选择当前配置并应用中转注入。
+5. 启动 `Codex++`。
Codex++ 会在 `~/.codex/config.toml` 中写入类似配置：
@@ -160,10 +187,16 @@ model_provider = "CodexPlusPlus"
name = "CodexPlusPlus"
wire_api = "responses"
requires_openai_auth = true
-base_url = "https://example.com/v1"
+base_url = "http://127.0.0.1:57323/v1"
+disabled_tools = ["image_generation"]
+codex_plus_text_base_url = "https://example.com/v1"
experimental_bearer_token = "sk-..."
```
+图片生成关闭时，Codex++ 会把 provider 写到本地 `127.0.0.1:57323` 代理。代理会在转发到当前中转前裁剪 `image_generation` 工具，避免部分中转组未开启图片生成权限时，Codex 会话请求被上游以 `Image generation is not enabled for this group` 拒绝。
+
+如果在管理工具中开启“图片生成使用独立 API 和 Key”，同一个本地代理会把普通请求转发到当前中转，把包含 `image_generation` 工具的 Responses 请求转发到图片生成 API。
+
如果需要回到官方登录态，在“中转注入”页面点击清除 API 模式即可移除 `OPENAI_API_KEY` 相关配置并切回官方 ChatGPT 登录模式。
## 增强功能
@@ -221,6 +254,10 @@ Invoke-RestMethod -Method Post -Uri http://127.0.0.1:57321/backend/status -Body
可以。Release 会分别提供 `macos-x64.dmg` 和 `macos-arm64.dmg`。Intel Mac 下载 x64 包，Apple Silicon 下载 arm64 包。
+### macOS 找不到 Codex App
+
+Codex++ 会优先检查 `/Applications`，再检查 `~/Applications`，并通过 `Info.plist` 中的 OpenAI Codex bundle 标识识别应用。若你把 Codex 放在其他目录，可以在管理工具中填写 Codex App 路径，或通过启动参数指定 `--app-path "/path/to/Codex.app"`。
+
## 开发
```bash
@@ -235,6 +272,9 @@ cd ../..
cargo fmt --check
cargo test
cargo build --release
+
+# macOS 打包
+scripts/installer/macos/package-dmg.sh 1.1.1 arm64
```
主要结构：
diff --git a/README_EN.md b/README_EN.md
index f26b5b8..0b23a4b 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -102,11 +102,21 @@ The Windows installer creates desktop and Start Menu shortcuts. The macOS DMG in
- Relay injection mode with multiple relay profiles, `CodexPlusPlus` provider configuration, and a one-click switch back to official ChatGPT login mode.
- Traditional enhancement mode with plugin entry unlock, forced plugin install, session delete, Markdown export, project move, Timeline, and more.
- Independent user script management with startup injection.
-- Provider Sync to keep historical sessions visible after switching providers.
+- Provider Sync to switch model_provider without losing historical conversations.
- Zed open entry detects remote SSH context and opens the matching remote file in Zed Remote Development from Codex.
- GitHub Release updates. Both the manager and silent launcher can detect available updates.
- Windows single instance, no console window, administrator manifest, and system Desktop path detection.
-- Separate macOS x64 and arm64 DMGs. The silent launcher hides its Dock icon.
+- Separate macOS x64 and arm64 DMGs, automatic Codex bundle detection, and a hidden Dock icon for the silent launcher.
+
+## Project Stats
+
+
+
+
+
+
+
+
## Relay Injection
@@ -116,8 +126,9 @@ In the manager's Relay Injection page:
1. Make sure ChatGPT login status is detected.
2. Add one or more relay profiles with Base URL and Key.
-3. Select the active profile and apply relay injection.
-4. Launch `Codex++`.
+3. Enable image generation for the current relay only when that relay group has image permission. To use a separate image-generation provider, enter the image Base URL and Key.
+4. Select the active profile and apply relay injection.
+5. Launch `Codex++`.
Codex++ writes configuration similar to this into `~/.codex/config.toml`:
@@ -128,10 +139,16 @@ model_provider = "CodexPlusPlus"
name = "CodexPlusPlus"
wire_api = "responses"
requires_openai_auth = true
-base_url = "https://example.com/v1"
+base_url = "http://127.0.0.1:57323/v1"
+disabled_tools = ["image_generation"]
+codex_plus_text_base_url = "https://example.com/v1"
experimental_bearer_token = "sk-..."
```
+When image generation is disabled, Codex++ writes the provider through a local `127.0.0.1:57323` proxy. The proxy removes the `image_generation` tool before forwarding regular requests to the current relay, preventing relays without image-generation permission from rejecting Codex session requests with `Image generation is not enabled for this group`.
+
+When the manager is configured to use a separate image-generation API, the same local proxy forwards regular requests to the current relay and forwards Responses requests containing the `image_generation` tool to the image-generation API.
+
To return to the official login mode, use the clear API mode button in the Relay Injection page. This removes `OPENAI_API_KEY` related configuration and switches Codex back to official ChatGPT authentication.
## Enhancements
@@ -189,6 +206,10 @@ Unsigned and unnotarized builds may be blocked by Gatekeeper. Allow the app in S
Yes. Releases provide both `macos-x64.dmg` and `macos-arm64.dmg`. Intel Macs should use the x64 package, while Apple Silicon Macs should use the arm64 package.
+### Codex++ cannot find Codex App on macOS
+
+Codex++ checks `/Applications` first, then `~/Applications`, and identifies Codex through the OpenAI Codex bundle identifier in `Info.plist`. If Codex is installed somewhere else, set the Codex App path in the manager or launch with `--app-path "/path/to/Codex.app"`.
+
## Development
```bash
@@ -203,6 +224,9 @@ cd ../..
cargo fmt --check
cargo test
cargo build --release
+
+# macOS package
+scripts/installer/macos/package-dmg.sh 1.1.1 arm64
```
Project structure:
diff --git a/apps/codex-plus-launcher/src/main.rs b/apps/codex-plus-launcher/src/main.rs
index bb1b7f8..9d8a232 100644
--- a/apps/codex-plus-launcher/src/main.rs
+++ b/apps/codex-plus-launcher/src/main.rs
@@ -6,6 +6,7 @@ use codex_plus_core::launcher::{
};
use codex_plus_core::models::{DeleteResult, ExportResult, SessionRef};
use codex_plus_core::routes::{BridgeContext, BridgeDataService, BridgeRuntimeService};
+use codex_plus_core::settings::BackendSettings;
use codex_plus_core::user_scripts::UserScriptManager;
use serde_json::{Value, json};
#[cfg(windows)]
@@ -163,8 +164,12 @@ impl LaunchHooks for LauncherHooks {
Ok(())
}
- async fn start_helper(&self, helper_port: u16) -> anyhow::Result<()> {
- self.core.start_helper(helper_port).await
+ async fn start_helper(
+ &self,
+ helper_port: u16,
+ settings: &BackendSettings,
+ ) -> anyhow::Result<()> {
+ self.core.start_helper(helper_port, settings).await
}
async fn launch_codex(
diff --git a/apps/codex-plus-manager/src-tauri/src/commands.rs b/apps/codex-plus-manager/src-tauri/src/commands.rs
index c7ade59..6bd1893 100644
--- a/apps/codex-plus-manager/src-tauri/src/commands.rs
+++ b/apps/codex-plus-manager/src-tauri/src/commands.rs
@@ -3,6 +3,7 @@ use std::path::{Path, PathBuf};
use std::time::{SystemTime, UNIX_EPOCH};
use codex_plus_core::install::SILENT_BINARY;
+use codex_plus_core::relay_config::RelayApplyOptions;
use codex_plus_core::settings::{BackendSettings, SettingsStore};
use codex_plus_core::status::{LaunchStatus, StatusStore};
use codex_plus_core::user_scripts::UserScriptManager;
@@ -576,11 +577,15 @@ pub fn apply_relay_injection() -> CommandResult {
let settings = SettingsStore::default().load().unwrap_or_default();
let relay = settings.active_relay_profile();
- match codex_plus_core::relay_config::apply_relay_config_to_home(
- &home,
- &relay.base_url,
- &relay.api_key,
- ) {
+ let options = RelayApplyOptions {
+ base_url: relay.base_url,
+ bearer_token: relay.api_key,
+ image_generation_enabled: relay.image_generation_enabled,
+ image_generation_use_separate_api: relay.image_generation_use_separate_api,
+ image_generation_base_url: relay.image_generation_base_url,
+ image_generation_bearer_token: relay.image_generation_api_key,
+ };
+ match codex_plus_core::relay_config::apply_relay_config_to_home_with_options(&home, &options) {
Ok(result) => {
let status = codex_plus_core::relay_config::relay_status_from_home(&home);
ok(
diff --git a/apps/codex-plus-manager/src/App.tsx b/apps/codex-plus-manager/src/App.tsx
index 87853b5..bcff999 100644
--- a/apps/codex-plus-manager/src/App.tsx
+++ b/apps/codex-plus-manager/src/App.tsx
@@ -4,6 +4,7 @@ import {
Activity,
Bell,
CheckCircle2,
+ Image,
CircleArrowUp,
Info,
ExternalLink,
@@ -89,6 +90,10 @@ type RelayProfile = {
name: string;
baseUrl: string;
apiKey: string;
+ imageGenerationEnabled: boolean;
+ imageGenerationUseSeparateApi: boolean;
+ imageGenerationBaseUrl: string;
+ imageGenerationApiKey: string;
};
type UserScriptInventory = {
@@ -200,6 +205,10 @@ const defaultSettings: BackendSettings = {
name: "默认中转",
baseUrl: "",
apiKey: "",
+ imageGenerationEnabled: false,
+ imageGenerationUseSeparateApi: false,
+ imageGenerationBaseUrl: "",
+ imageGenerationApiKey: "",
},
],
activeRelayId: "default",
@@ -955,6 +964,18 @@ function RelayScreen({
+
+## 赞赏支持
+
如果 Codex++ 帮到了你，可以请我喝杯咖啡，或者随手赞赏支持一下继续维护。
