ima2-gen 3.20.0 → 3.21.0

package/docs/CLI.zh-CN.md

@@ -81,7 +81,7 @@
 提供者覆盖语义：
 
 - `api`迫使API-key 响应路径并需要配置API钥匙。
-- `oauth`迫使当地OAuth代理路径。
+- `oauth` 强制使用 GPT OAuth：服务器直接调用 ChatGPT，GPT-6 规划、`gpt-image-2` 出图。
 - `grok`使用`~/.progrok/auth.json`中的xAI OAuth会话直接调用`https://api.x.ai`。经典一代首次运行强制xAI通过响应进行网络搜索API，然后询问`grok-4.5`打电话ima2是当地的`generate_image`工具，那么ima2执行xAI `/v1/images/generations`. `grok-4.3`仍然可以作为显式兼容性覆盖使用。如果`--ref`附加图像，最后一步使用xAI `/v1/images/edits`相反，图像到图像/参考上下文被保留。型号：`grok-imagine-image`, `grok-imagine-image-quality`。大小映射到xAI `aspect_ratio`和`resolution`;这UI网络搜索切换是OpenAI-仅提供者因为Grok搜索始终在此路径中进行。
 - `agy`产生Antigravity CLI通过Google生成Gemini (`nano-banana-2`）。固定1024×1024JPEG输出，最多 3 个参考值没有网络搜索、质量、尺寸或遮罩控制。如果`agy`不在服务器进程 PATH 上，ima2还检查常见的用户本地安装，例如`~/.local/bin/agy`;放`IMA2_AGY_BIN=/absolute/path/to/agy`强制使用特定的二进制文件。
 - `gemini-api`调用 Google 生成语言API直接地。型号：`nano-banana-2` (Gemini3.1 Flash 图像）和`nano-banana-pro` (Gemini3 专业图像）。使用`--model nano-banana-2`或者`--model nano-banana-pro`来选择。支持`--size`对于直接的宽高比和分辨率 (512px–4K)API小路;Vertex AI忽略方面/大小。需要`GEMINI_API_KEY`或一个Vertex AI服务帐户（`VERTEX_SERVICE_ACCOUNT_JSON`）。切换自`agy`或者`gemini-api`提供商自动选择相应的Gemini模型;切换离开重置为GPT默认。
@@ -110,7 +110,7 @@ Grok尺寸映射如下xAI的形象API， 不是OpenAI's `size`场地。ima2
 
 ```bash
 ima2 models --kind image
-ima2 defaults set image oauth/gpt-5.6-luna
+ima2 defaults set image oauth/gpt-6-luna
 ima2 gen "a poster of a samurai cat" --model api/gpt-5.4 --reasoning-effort high
 ima2 grok login
 ima2 gen "a cinematic neon city" --model grok/grok-imagine-image-quality
@@ -261,8 +261,8 @@ ima2 doctor image-probe --matrix --json > ima2-image-probe.json
 ```bash
 ima2 doctor
 ima2 doctor image-probe --json > ima2-image-probe.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --no-web-search --json > ima2-cat-no-search.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --no-web-search --json > ima2-cat-no-search.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --json > ima2-cat-current.json
 ```
 
 请勿分享ChatGPT曲奇饼，OAuth令牌文件，API键、提示历史记录、原始
@@ -351,7 +351,7 @@ Windows DNS/碎片绕过工具（例如 SecretDNS）正在使用。
 | `ima2 storage open` |在操作系统文件管理器（POST）中打开生成的目录|
 | `ima2 billing` | API使用探针通过`/api/billing` (OpenAI/API- 配置后的密钥积分）。Grok和NovelAI配额仅在网页UI中通过`GET /api/quota`：当前的每周百分比/重置Grok建造xAIauth，每月遗留`usedUsd`/`limitUsd`倒退。|
 | `ima2 providers` |配置的提供商|
-| `ima2 oauth status` | OAuth代理状态|
+| `ima2 oauth status` | GPT OAuth 状态|
 | `ima2 grok status` |保存的xAI OAuth会话状态，加`--probe`可查看图像模型可见性|
 | `ima2 ping` |健康检查正在运行的服务器|
 

package/docs/CLI.zh-TW.md

@@ -81,7 +81,7 @@
 提供者覆蓋語義：
 
 - `api`迫使API-key 回應路徑並需要配置API鑰匙。
-- `oauth`迫使當地OAuth代理路徑。
+- `oauth` 強制使用 GPT OAuth：伺服器直接呼叫 ChatGPT，GPT-6 規劃、`gpt-image-2` 出圖。
 - `grok`使用`~/.progrok/auth.json`中的xAI OAuth工作階段直接呼叫`https://api.x.ai`。經典一代首次運行強制xAI透過回應進行網路搜尋API，然後詢問`grok-4.5`打電話ima2是當地的`generate_image`工具，那麼ima2執行xAI `/v1/images/generations`. `grok-4.3`仍然可以作為顯式相容性覆蓋使用。如果`--ref`附加圖像，最後一步使用xAI `/v1/images/edits`相反，圖像到圖像/參考上下文被保留。型號：`grok-imagine-image`, `grok-imagine-image-quality`。大小映射到xAI `aspect_ratio`和`resolution`;這UI網路搜尋切換是OpenAI-僅提供者因為Grok搜尋始終在此路徑中進行。
 - `agy`產生Antigravity CLI透過Google生成Gemini (`nano-banana-2`）。固定1024×1024JPEG輸出，最多 3 個參考值沒有網路搜尋、品質、尺寸或遮罩控制。如果`agy`不在伺服器進程 PATH 上，ima2也檢查常見的用戶本地安裝，例如`~/.local/bin/agy`;放`IMA2_AGY_BIN=/absolute/path/to/agy`強制使用特定的二進位。
 - `gemini-api`呼叫 Google 生成語言API直接地。型號：`nano-banana-2` (Gemini3.1 Flash 影像）和`nano-banana-pro` (Gemini3 專業圖像）。使用`--model nano-banana-2`或者`--model nano-banana-pro`來選擇。支援`--size`對於直接的寬高比和解析度 (512px–4K)API小路;Vertex AI忽略方面/大小。需要`GEMINI_API_KEY`或一個Vertex AI服務帳戶（`VERTEX_SERVICE_ACCOUNT_JSON`）。切換自`agy`或者`gemini-api`提供者自動選擇相應的Gemini模型;切換離開重置為GPT預設.
@@ -110,7 +110,7 @@ Grok尺寸映射如下xAI的形象API， 不是OpenAI's `size`場地。ima2
 
 ```bash
 ima2 models --kind image
-ima2 defaults set image oauth/gpt-5.6-luna
+ima2 defaults set image oauth/gpt-6-luna
 ima2 gen "a poster of a samurai cat" --model api/gpt-5.4 --reasoning-effort high
 ima2 grok login
 ima2 gen "a cinematic neon city" --model grok/grok-imagine-image-quality
@@ -261,8 +261,8 @@ ima2 doctor image-probe --matrix --json > ima2-image-probe.json
 ```bash
 ima2 doctor
 ima2 doctor image-probe --json > ima2-image-probe.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --no-web-search --json > ima2-cat-no-search.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --no-web-search --json > ima2-cat-no-search.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --json > ima2-cat-current.json
 ```
 
 請勿分享ChatGPT餅乾,OAuth令牌文件，API鍵、提示歷史記錄、原始
@@ -351,7 +351,7 @@ Windows DNS/碎片繞過工具（例如 SecretDNS）正在使用。
 | `ima2 storage open` |在作業系統檔案管理器（POST）中開啟產生的目錄|
 | `ima2 billing` | API使用探針通過`/api/billing` (OpenAI/API- 配置後的金鑰積分）。Grok和NovelAI配額僅在網頁UI中透過`GET /api/quota`：目前的每週百分比/重置Grok建造xAIauth，每月遺留`usedUsd`/`limitUsd`倒退。|
 | `ima2 providers` |配置的提供者|
-| `ima2 oauth status` | OAuth代理狀態|
+| `ima2 oauth status` | GPT OAuth 狀態|
 | `ima2 grok status` |儲存的xAI OAuth工作階段狀態，加`--probe`可查看影像模型可見性|
 | `ima2 ping` |健康檢查正在運行的伺服器|
 

package/docs/FAQ.ko.md

@@ -14,12 +14,11 @@ English version: [FAQ.md](FAQ.md)
 | GPT OAuth 로그인이 안 됨 | `ima2 setup`을 다시 실행하고(옵션 1) `ima2 serve`를 다시 시작합니다. |
 | API key provider가 `API_KEY_REQUIRED`를 반환함 | API 키를 설정하거나 GPT OAuth 공급자로 다시 전환합니다. |
 | 업데이트 후 예전 이미지가 안 보임 | `ima2 doctor`를 실행한 뒤 [예전 이미지 복구 안내](RECOVER_OLD_IMAGES.md)를 확인합니다. |
-| `gpt-5.5`만 실패함 | Codex CLI를 업데이트하고, 안정 대안으로 `gpt-5.4`를 사용합니다. |
+| GPT OAuth에서 GPT-6 모델 하나만 실패함 | `ima2 gpt login`으로 다시 로그인하고 `ima2 models --kind image`를 확인한 뒤 `gpt-6-luna`로 바꿔 보세요. |
 | 레퍼런스 업로드 실패 | JPEG/PNG로 변환하고 해상도를 낮춰 보세요. 레퍼런스는 최대 5장입니다. |
 | Prompt Studio 기능이 헷갈림 | [Prompt Studio 사용 설명서](PROMPT_STUDIO.ko.md)에서 멀티모드, Direct, 추론 강도, 갤러리 동작을 확인하세요. |
 | 이미지 생성이 `EMPTY_RESPONSE` 또는 no image data로 끝남 | `ima2 doctor image-probe --json`을 실행한 뒤 아래의 안전한 지원 번들을 모아 주세요. |
-| Windows에서 `10531` 포트 관련 OAuth/proxy 오류가 남 | `ima2 doctor`를 실행하고, 필요하면 `IMA2_OAUTH_PROXY_PORT=11531 ima2 serve`로 시작하세요. |
-| 프록시/VPN 환경에서 `fetch failed`가 반복됨 | 프록시 클라이언트의 TUN/TURN류 모드를 켜거나, 같은 터미널에 `HTTP_PROXY` / `HTTPS_PROXY`를 설정하세요. |
+| 프록시/VPN 환경에서 `fetch failed`가 반복됨 | 프록시 클라이언트의 TUN/TURN류 모드를 켜거나, `HTTPS_PROXY`와 `NODE_USE_ENV_PROXY=1`을 설정하고 `ima2 serve`를 시작하세요. |
 
 ## 설치와 업데이트
 
@@ -101,16 +100,17 @@ ima2 serve
 
 ### 어떤 모델부터 쓰면 좋나요?
 
-앱은 `gpt-5.6-luna`로 시작합니다. 계정 지원 범위나 호환성 때문에 필요할 때만 다른 모델을 고르세요.
+GPT OAuth에서는 `gpt-6-luna`로 시작합니다. 이 레인에는 GPT-6 모델이 세 개 있고, 고른 모델이 이미지를 기획하면 `gpt-image-2`가 그립니다.
 
-- `gpt-5.6-luna`: 현재 앱 기본값입니다.
-- `gpt-6-astra`: 가장 최신 GPT 이미지 모델입니다. 선택 가능하지만 기본값은 아닙니다.
-- `gpt-5.6-terra` / `gpt-5.6-sol`: 계정에서 지원할 때 고를 수 있는 GPT-5.6 대안입니다.
-- `gpt-5.5` / `gpt-5.4` / `gpt-5.4-mini`: 호환 선택지로 유지합니다.
+- `gpt-6-luna`: 기본값입니다.
+- `gpt-6-sol`: 또 하나의 일상용 GPT-6 모델입니다.
+- `gpt-6-astra`: 가장 오래 추론하는 대신 가장 느립니다. 추론 강도 `none`은 `low`로 실행됩니다.
 
-### `gpt-5.5`만 실패하는 이유는 뭔가요?
+예전 OAuth 모델 ID(`gpt-5.6-sol`, `gpt-5.6-luna`, `gpt-5.6-terra`, `gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`)는 저장된 설정과 스크립트에서 그대로 동작합니다. `gpt-5.6-sol`은 `gpt-6-sol`로, 나머지는 `gpt-6-luna`로 실행됩니다. API 키 레인(`provider: "api"`)은 자체 목록을 유지하고 기본값은 `gpt-5.6-luna`입니다.
 
-`gpt-5.5`는 최신 Codex CLI, 백엔드 capability, 계정 또는 quota 상태의 영향을 받을 수 있습니다. 먼저 Codex CLI를 업데이트하세요. 그래도 실패하면 안정 대안으로 `gpt-5.4`를 사용하세요.
+### GPT-6 모델 하나만 실패하는 이유는 뭔가요?
+
+GPT OAuth 레인은 ChatGPT 요금제에 열린 GPT-6 모델을 씁니다. ima2-gen을 업데이트하고 `ima2 gpt login`으로 다시 로그인한 뒤 `ima2 models --kind image`로 확인하세요. 특정 모델만 계속 실패하면 `gpt-6-luna`로 바꿔 보세요.
 
 ### Plus/Pro는 몇 장까지 생성할 수 있나요?
 
@@ -207,29 +207,25 @@ API에서는 `REF_TOO_MANY`, `REF_TOO_LARGE`, `REF_NOT_BASE64`, `REF_EMPTY` 같
 
 ## 네트워크와 OAuth 오류
 
-### 백엔드나 OAuth 프록시가 왜 다른 포트로 열리나요?
+### 백엔드가 왜 다른 포트로 열리나요?
 
-`ima2-gen`은 로컬 앱입니다. 기본 백엔드 포트 `3333` 또는 OAuth 프록시 포트 `10531`이 이미 사용 중이면 다음 사용 가능한 포트로 fallback할 수 있고, 실제 URL은 아래 파일에 기록됩니다.
+`ima2-gen`은 로컬 앱입니다. 기본 백엔드 포트 `3333`이 이미 사용 중이면 다음 사용 가능한 포트로 fallback하고, 실제 URL은 아래 파일에 기록됩니다.
 
 ```text
 ~/.ima2/server.json
 ```
 
-아래 명령으로 configured/actual 포트를 확인하세요.
+아래 명령으로 설정한 백엔드 URL과 실제 URL을 확인하세요.
 
 ```bash
 ima2 doctor
 ```
 
-### Windows에서 `AnySign4PC.exe`가 `10531`을 쓰면 어떻게 하나요?
+GPT OAuth는 로컬 포트를 쓰지 않습니다. 서버가 ChatGPT를 직접 호출합니다.
 
-일부 Windows 보안 프로그램이 기본 OAuth 프록시 포트 `10531`을 점유할 수 있습니다. 현재 빌드는 fallback된 실제 포트를 추적하지만, 원하면 포트를 직접 바꿀 수 있습니다.
+### 프런트엔드를 따로 개발할 때 실제 백엔드는 어떻게 가리키나요?
 
-```bash
-IMA2_OAUTH_PROXY_PORT=11531 ima2 serve
-```
-
-프론트엔드만 따로 개발 서버로 띄우는 경우에는 Vite가 실제 백엔드를 보게 지정하세요.
+`ima2 doctor`가 알려 주는 백엔드 URL을 Vite에 넘기세요.
 
 ```bash
 VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
@@ -239,7 +235,7 @@ VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
 
 보통 아래 중 하나입니다.
 
-- 로컬 OAuth 프록시가 아직 준비되지 않았습니다.
+- GPT OAuth가 `chatgpt.com`에 닿지 못했습니다.
 - 서버가 재시작되었습니다.
 - VPN, 프록시, 방화벽이 요청을 막았습니다.
 - Windows에서 자동 실행되는 DNS/파편화 우회 프로그램(예: SecretDNS)이 OAuth 또는 스트리밍 이미지 응답을 깨뜨렸습니다.
@@ -272,8 +268,8 @@ ima2 doctor image-probe --json > ima2-image-probe.json
 `ima2 serve`가 실행 중이면 검색을 끈 생성과 일반 생성 결과도 하나씩 저장하세요.
 
 ```bash
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --no-web-search --json > ima2-cat-no-search.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --no-web-search --json > ima2-cat-no-search.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --json > ima2-cat-current.json
 ```
 
 probe JSON은 공개 이슈에 첨부할 수 있도록 설계되어 있습니다. 진단 코드,
@@ -301,24 +297,19 @@ generated base64는 공유하지 마세요.
 - 검색 끈 생성은 되지만 일반 생성이 실패: web-search/tool-choice 상호작용 가능성이 큽니다.
 - bytes는 읽었지만 event가 없음: SSE delimiter 또는 `data:` parsing 가능성이 큽니다.
 
-### 프록시나 VPN 뒤에서 `fetch failed`가 계속 나면 어떻게 하나요?
+### 프록시나 VPN 환경에서 `fetch failed`가 계속 나면 어떻게 하나요?
 
-대부분 로컬 OAuth 프록시가 현재 네트워크 경로로 upstream 서비스에 닿지 못하는 상황입니다. `openai-oauth`는 보통 `10531` 포트의 localhost 프록시로 실행됩니다.
+GPT OAuth 요청은 `ima2 serve` 프로세스에서 `chatgpt.com`으로 바로 나갑니다. 그래서 그 프로세스의 네트워크 경로가 중요합니다.
 
-먼저 시도하세요.
+프록시가 필요한 네트워크라면 터미널 프로세스도 프록시를 타도록 프록시 클라이언트의 TUN/TURN류 모드를 켜세요. Windows에서는 SecretDNS처럼 부팅 때 자동 실행되는 DNS/파편화 우회 프로그램도 잠시 끄고 재시도해 보세요. 그래도 안 되면 `ima2 serve`를 시작하는 터미널에 프록시를 설정하세요. Node.js 22.21 이상과 24 이상은 `NODE_USE_ENV_PROXY=1`이 함께 있어야 `HTTPS_PROXY`를 읽습니다. 그보다 오래된 Node.js는 둘 다 무시하니 TUN 모드를 쓰세요.
 
 ```bash
-openai-oauth --port 10531
-```
-
-프록시가 필요한 네트워크라면 터미널 프로세스도 프록시를 타도록 프록시 클라이언트의 TUN/TURN류 모드를 켜세요. Windows에서는 SecretDNS처럼 부팅 때 자동 실행되는 DNS/파편화 우회 프로그램도 잠시 끄고 재시도해 보세요. 그래도 안 되면 `openai-oauth` 또는 `ima2 serve`를 실행하는 같은 터미널에 프록시 환경 변수를 설정합니다.
-
-```bash
-export HTTP_PROXY=http://127.0.0.1:7890
 export HTTPS_PROXY=http://127.0.0.1:7890
+export NODE_USE_ENV_PROXY=1
+ima2 serve
 ```
 
-호스트와 포트는 사용하는 프록시 클라이언트 값에 맞춰 바꾸세요. 로컬 OAuth 프록시가 접근 가능한 상태에서도 `ima2-gen`이 계속 실패하면, 새 이슈를 열 때 실행 명령, OS, 프록시 설정, 터미널 오류를 함께 남겨 주세요.
+호스트와 포트는 사용하는 프록시 클라이언트 값에 맞춰 바꾸세요. 그래도 `ima2-gen`이 계속 실패하면, 새 이슈를 열 때 실행 명령, OS, 프록시 설정, 터미널 오류를 함께 남겨 주세요.
 
 ### 회사 컴퓨터에서는 무엇을 확인해야 하나요?
 

package/docs/FAQ.md

@@ -14,12 +14,11 @@ For Korean, see [FAQ.ko.md](FAQ.ko.md). For Traditional Chinese, see [FAQ.zh-TW.
 | GPT OAuth login fails | Re-run `ima2 setup` (option 1), then restart `ima2 serve`. |
 | API key provider says `API_KEY_REQUIRED` | Configure an API key, or switch back to the GPT OAuth provider. |
 | Old gallery images look missing | Run `ima2 doctor`, then see [Recover Old Generated Images](RECOVER_OLD_IMAGES.md). |
-| `gpt-5.5` fails | Update Codex CLI first, then try `gpt-5.4` as the stable fallback. |
+| A GPT-6 model fails on GPT OAuth | Run `ima2 gpt login` again, check `ima2 models --kind image`, then try `gpt-6-luna`. |
 | Reference upload fails | Use JPEG/PNG, lower the resolution, and keep references to 5 images or fewer. |
 | Prompt Studio controls are unclear | Read the [Prompt Studio manual](PROMPT_STUDIO.md) for multimode, Direct, reasoning, and gallery behavior. |
 | Image generation returns `EMPTY_RESPONSE` or no image data | Run `ima2 doctor image-probe --json`, then collect the safe support bundle below. |
-| Windows reports OAuth/proxy failures around port `10531` | Run `ima2 doctor`; if needed start with `IMA2_OAUTH_PROXY_PORT=11531 ima2 serve`. |
-| `fetch failed` repeats on a proxy/VPN network | Enable proxy TUN/TURN-style mode, or set `HTTP_PROXY` / `HTTPS_PROXY` in the same terminal. |
+| `fetch failed` repeats on a proxy/VPN network | Enable proxy TUN/TURN-style mode, or start `ima2 serve` with `HTTPS_PROXY` and `NODE_USE_ENV_PROXY=1`. |
 
 ## Install and update
 
@@ -134,18 +133,17 @@ Use the **Switch Account** button in Settings > QuotaCard for the provider. This
 
 ### Which model should I use?
 
-The app starts with `gpt-5.6-luna`; choose another model only when you need an explicit compatibility or account-specific override.
+On GPT OAuth the app starts with `gpt-6-luna`. The lane offers three GPT-6 models: the one you pick plans the image and `gpt-image-2` renders it.
 
-- `gpt-5.6-luna`: current app default.
-- `gpt-6-astra`: newest GPT image model; selectable, not the default.
-- `gpt-5.6-sol` / `gpt-5.6-terra`: current GPT-5.6 alternatives;
-  availability depends on your OAuth account access, so upstream may reject them
-  until the rollout reaches you.
-- `gpt-5.5` / `gpt-5.4` / `gpt-5.4-mini`: supported compatibility choices.
+- `gpt-6-luna`: the default.
+- `gpt-6-sol`: the other everyday GPT-6 model.
+- `gpt-6-astra`: reasons longest and is the slowest; a `none` reasoning effort runs as `low`.
 
-### Why does `gpt-5.5` fail when other models work?
+Older OAuth ids (`gpt-5.6-sol`, `gpt-5.6-luna`, `gpt-5.6-terra`, `gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`) still work in saved settings and scripts. `gpt-5.6-sol` runs as `gpt-6-sol` and the rest run as `gpt-6-luna`. The API-key lane (`provider: "api"`) keeps its own list, with `gpt-5.6-luna` as its default.
 
-`gpt-5.5` may require a newer Codex CLI, backend capability, or account/quota availability. Update Codex CLI first. If it still fails, use `gpt-5.4` as the stable fallback.
+### Why does one GPT-6 model fail when the others work?
+
+The GPT OAuth lane uses the GPT-6 models your ChatGPT plan exposes. Update ima2-gen, sign in again with `ima2 gpt login`, and check `ima2 models --kind image`. If one model keeps failing, switch to `gpt-6-luna`.
 
 ### How many images can Plus or Pro generate?
 
@@ -243,31 +241,25 @@ The API may report reference errors such as `REF_TOO_MANY`, `REF_TOO_LARGE`, `RE
 
 ## Network and OAuth errors
 
-### Why did the backend or OAuth proxy move to another port?
+### Why did the backend move to another port?
 
-`ima2-gen` is a local app. If the preferred backend port `3333` or OAuth proxy port `10531` is already in use, the runtime can fall back to the next available port and records the actual URLs in:
+`ima2-gen` is a local app. If the preferred backend port `3333` is already in use, the runtime falls back to the next available port and records the actual URL in:
 
 ```text
 ~/.ima2/server.json
 ```
 
-Use:
+Run this to see the configured and actual backend URLs:
 
 ```bash
 ima2 doctor
 ```
 
-to see the configured and actual backend/OAuth URLs.
-
-### Windows: what if `AnySign4PC.exe` owns port `10531`?
-
-Some Windows security software can occupy the default OAuth proxy port. Current builds track the actual fallback port, but you can also force a quieter range:
+GPT OAuth needs no local port: the server calls ChatGPT directly.
 
-```bash
-IMA2_OAUTH_PROXY_PORT=11531 ima2 serve
-```
+### How do I point split frontend development at the real backend?
 
-For split frontend development, point Vite at the actual backend:
+Pass the backend URL that `ima2 doctor` reports to Vite:
 
 ```bash
 VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
@@ -277,7 +269,7 @@ VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
 
 Usually one of these:
 
-- the local OAuth proxy is not ready,
+- GPT OAuth could not reach `chatgpt.com`,
 - the server was restarted,
 - a VPN/proxy/firewall blocked the request,
 - an auto-start Windows network interception tool, including a DNS/fragmentation
@@ -311,8 +303,8 @@ If `ima2 serve` is running, also capture one search-off and one normal cat
 generation result:
 
 ```bash
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --no-web-search --json > ima2-cat-no-search.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --no-web-search --json > ima2-cat-no-search.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --json > ima2-cat-current.json
 ```
 
 The probe JSON is designed to be safe to attach to a public issue. It reports
@@ -343,22 +335,17 @@ How to read the result:
 
 ### What if `fetch failed` keeps happening behind a proxy or VPN?
 
-This usually means the local OAuth proxy cannot reach the upstream service through your network path. `openai-oauth` runs as a local localhost proxy, commonly on port `10531`.
+GPT OAuth requests leave from the `ima2 serve` process and go straight to `chatgpt.com`, so the network path of that process is what matters.
 
-Try:
+If your network requires a proxy, enable your proxy client's TUN/TURN-style mode so terminal processes can use it. On Windows, also temporarily disable auto-start DNS or fragmentation bypass tools such as SecretDNS and retry. If that is not enough, set the proxy in the terminal that starts `ima2 serve`. Node.js 22.21+ and 24+ read `HTTPS_PROXY` only when `NODE_USE_ENV_PROXY=1` is also set (older Node.js ignores both; use TUN mode there):
 
 ```bash
-openai-oauth --port 10531
-```
-
-If your network requires a proxy, enable your proxy client's TUN/TURN-style mode so terminal processes can use it. On Windows, also temporarily disable auto-start DNS or fragmentation bypass tools such as SecretDNS and retry. If that is not enough, set the proxy variables in the same terminal that runs `openai-oauth` or `ima2 serve`:
-
-```bash
-export HTTP_PROXY=http://127.0.0.1:7890
 export HTTPS_PROXY=http://127.0.0.1:7890
+export NODE_USE_ENV_PROXY=1
+ima2 serve
 ```
 
-Use the host and port from your proxy client. If `ima2-gen` still fails after the local OAuth proxy is reachable, collect the exact command, OS, proxy setup, and terminal error before opening a new issue.
+Use the host and port from your proxy client. If `ima2-gen` still fails, collect the exact command, OS, proxy setup, and terminal error before opening a new issue.
 
 ### What should I check on a company computer?
 

package/docs/FAQ.zh-CN.md

@@ -14,12 +14,11 @@
 | GPT OAuth登录失败|重新运行`ima2 setup`（选项 1），然后重新启动`ima2 serve`. |
 | API关键提供商说`API_KEY_REQUIRED` |配置一个API键，或切换回GPT OAuth提供者。|
 |旧画廊图像看起来不见了|跑步`ima2 doctor`，然后看到[恢复旧生成的图像](RECOVER_OLD_IMAGES.md). |
-| `gpt-5.5`失败|更新Codex CLI首先，然后尝试`gpt-5.4`作为稳定的后备。|
+| GPT OAuth 上某个 GPT-6 模型失败 | 用 `ima2 gpt login` 重新登录，检查 `ima2 models --kind image`，再改用 `gpt-6-luna`。 |
 |参考资料上传失败|使用JPEG/PNG，降低分辨率，并保留对 5 个或更少图像的引用。|
 |提示Studio控件不清楚|阅读[提示工作室手册](PROMPT_STUDIO.md)用于多模式、直接、推理和画廊行为。|
 |图像生成返回`EMPTY_RESPONSE`或没有图像数据|跑步`ima2 doctor image-probe --json`，然后收集下面的安全支持包。|
-|Windows 报告OAuth/端口周围的代理失败`10531` |跑步`ima2 doctor`;如果需要从`IMA2_OAUTH_PROXY_PORT=11531 ima2 serve`. |
-| `fetch failed`在代理/VPN 网络上重复|启用代理 TUN/TURN 式模式，或设置`HTTP_PROXY` / `HTTPS_PROXY`在同一个终端。|
+| `fetch failed` 在代理/VPN 网络上反复出现 | 开启代理客户端的 TUN/TURN 类模式，或设置 `HTTPS_PROXY` 和 `NODE_USE_ENV_PROXY=1` 后启动 `ima2 serve`。 |
 
 ## 安装和更新
 
@@ -119,20 +118,19 @@ ima2 serve
 
 ## 型号及配额
 
-### 我应该使用哪种型号？
+### 我应该使用哪个模型？
 
-该应用程序开始于`gpt-5.6-luna`;仅当您需要显式兼容性或特定于帐户的覆盖时才选择其他模型。
+GPT OAuth 默认使用 `gpt-6-luna`。该通道提供三个 GPT-6 模型：你选择的模型负责规划画面，`gpt-image-2` 负责出图。
 
-- `gpt-5.6-luna`：当前应用程序默认值。
-- `gpt-6-astra`：最新的 GPT 图像模型；可选，但不是默认值。
-- `gpt-5.6-sol` / `gpt-5.6-terra`： 当前的GPT-5.6替代方案；
-可用性取决于您的OAuth帐户访问，因此上游可能会拒绝它们
-直到您收到推送通知。
-- `gpt-5.5` / `gpt-5.4` / `gpt-5.4-mini`：支持的兼容性选择。
+- `gpt-6-luna`：默认模型。
+- `gpt-6-sol`：另一个日常使用的 GPT-6 模型。
+- `gpt-6-astra`：推理时间最长、速度最慢；推理强度 `none` 会按 `low` 执行。
 
-### 为什么会`gpt-5.5`当其他模型工作时却失败？
+旧的 OAuth 模型 ID（`gpt-5.6-sol`、`gpt-5.6-luna`、`gpt-5.6-terra`、`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`）在已保存的设置和脚本中仍然可用。`gpt-5.6-sol` 会以 `gpt-6-sol` 运行，其余以 `gpt-6-luna` 运行。API key 通道（`provider: "api"`）保留自己的列表，默认是 `gpt-5.6-luna`。
 
-`gpt-5.5`可能需要更新的Codex CLI、后端功能或帐户/配额可用性。更新Codex CLI第一的。如果仍然失败，请使用`gpt-5.4`作为稳定的后备。
+### 为什么只有某个 GPT-6 模型失败？
+
+GPT OAuth 通道使用你的 ChatGPT 方案开放的 GPT-6 模型。请更新 ima2-gen，用 `ima2 gpt login` 重新登录，再用 `ima2 models --kind image` 检查。如果某个模型持续失败，请改用 `gpt-6-luna`。
 
 ### Plus 或 Pro 可以生成多少张图像？
 
@@ -230,31 +228,25 @@ ima2 doctor
 
 ## 网络和OAuth错误
 
-### 为什么后端或OAuth代理移动到另一个端口？
+### 为什么后端换到了另一个端口？
 
-`ima2-gen`是一个本地应用程序。如果首选后端端口`3333`或者OAuth代理端口`10531`已在使用中，运行时可以回退到下一个可用端口并将实际 URL 记录在：
+`ima2-gen` 是本地应用。如果首选后端端口 `3333` 已被占用，运行时会改用下一个可用端口，并把实际 URL 记录在：
 
 ```text
 ~/.ima2/server.json
 ```
 
-使用：
+运行下面的命令查看配置的和实际的后端 URL：
 
 ```bash
 ima2 doctor
 ```
 
-查看配置的和实际的后端/OAuth网址。
-
-### Windows：如果`AnySign4PC.exe`拥有港口`10531`?
-
-某些Windows安全软件可以占用默认值OAuth代理端口。当前版本跟踪实际的后备端口，但您也可以强制使用更安静的范围：
+GPT OAuth 不占用本地端口，服务器会直接调用 ChatGPT。
 
-```bash
-IMA2_OAUTH_PROXY_PORT=11531 ima2 serve
-```
+### 前后端分开开发时，如何指向实际的后端？
 
-对于拆分前端开发，点Vite在实际后端：
+把 `ima2 doctor` 报告的后端 URL 传给 Vite：
 
 ```bash
 VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
@@ -264,7 +256,7 @@ VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
 
 通常是以下之一：
 
-- 当地的OAuth代理尚未准备好，
+- GPT OAuth 无法连接到 `chatgpt.com`，
 - 服务器已重新启动，
 - VPN/代理/防火墙阻止了请求，
 - 一个自动启动的Windows网络拦截工具，包括DNS/碎片
@@ -298,8 +290,8 @@ ima2 doctor image-probe --json > ima2-image-probe.json
 生成结果：
 
 ```bash
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --no-web-search --json > ima2-cat-no-search.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --no-web-search --json > ima2-cat-no-search.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --json > ima2-cat-current.json
 ```
 
 探头JSON旨在安全地附加到公共问题上。据报道
@@ -328,24 +320,19 @@ ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
 - 搜索关闭生成有效，但正常生成失败：可能是网络搜索/工具选择交互。
 - 已读取字节但未解析任何事件：可能SSE分隔符或`data:`解析。
 
-### 如果什么`fetch failed`在代理或 VPN 后面不断发生？
+### 在代理或 VPN 后面反复出现 `fetch failed` 怎么办？
 
-这通常意味着本地OAuth代理无法通过您的网络路径到达上游服务。`openai-oauth`作为本地主机代理运行，通常在端口上`10531`.
+GPT OAuth 请求由 `ima2 serve` 进程直接发往 `chatgpt.com`，所以关键是这个进程的网络路径。
 
-尝试：
+如果你的网络需要代理，请开启代理客户端的 TUN/TURN 类模式，让终端进程也能走代理。在 Windows 上，还可以暂时关闭开机自启的 DNS 或分片绕过工具（例如 SecretDNS）后重试。如果仍然不行，请在启动 `ima2 serve` 的终端里设置代理。Node.js 22.21+ 和 24+ 只有同时设置 `NODE_USE_ENV_PROXY=1` 才会读取 `HTTPS_PROXY`（更早的版本两者都会忽略，请改用 TUN 模式）：
 
 ```bash
-openai-oauth --port 10531
-```
-
-如果您的网络需要代理，请启用代理客户端的 TUN/TURN 样式模式，以便终端进程可以使用它。在 Windows 上，还可以暂时禁用自动启动 DNS 或碎片绕过工具（例如 SecretDNS）并重试。如果这还不够，请在运行的同一终端中设置代理变量`openai-oauth`或者`ima2 serve`:
-
-```bash
-export HTTP_PROXY=http://127.0.0.1:7890
 export HTTPS_PROXY=http://127.0.0.1:7890
+export NODE_USE_ENV_PROXY=1
+ima2 serve
 ```
 
-使用代理客户端的主机和端口。如果`ima2-gen`本地后仍然失败OAuth代理可访问，在打开新问题之前收集确切的命令、操作系统、代理设置和终端错误。
+请使用你的代理客户端的主机和端口。如果 `ima2-gen` 仍然失败，请在提交新 issue 前收集确切的命令、操作系统、代理设置和终端错误。
 
 ### 我应该在公司计算机上检查什么？
 

package/docs/FAQ.zh-TW.md

@@ -14,12 +14,11 @@
 | GPT OAuth登入失敗|重新運行`ima2 setup`（選項 1），然後重新啟動`ima2 serve`. |
 | API關鍵提供者說`API_KEY_REQUIRED` |配置一個API鍵，或切換回GPT OAuth提供者。|
 |舊畫廊圖像看起來不見了|跑步`ima2 doctor`，然後看到[恢復舊生成的圖像](RECOVER_OLD_IMAGES.md). |
-| `gpt-5.5`失敗|更新Codex CLI首先，然後嘗試`gpt-5.4`作為穩定的後備。|
+| GPT OAuth 上某個 GPT-6 模型失敗 | 用 `ima2 gpt login` 重新登入，檢查 `ima2 models --kind image`，再改用 `gpt-6-luna`。 |
 |參考資料上傳失敗|使用JPEG/PNG，降低分辨率，並保留對 5 個或更少圖像的引用。|
 |提示Studio控制不清楚|閱讀[提示工作室手冊](PROMPT_STUDIO.md)用於多模式、直接、推理和畫廊行為。|
 |圖像生成返回`EMPTY_RESPONSE`或沒有影像數據|跑步`ima2 doctor image-probe --json`，然後收集下面的安全支援包。|
-|Windows 報告OAuth/連接埠周圍的代理失敗`10531` |跑步`ima2 doctor`;如果需要從`IMA2_OAUTH_PROXY_PORT=11531 ima2 serve`. |
-| `fetch failed`在代理/VPN 網路上重複|啟用代理 TUN/TURN 式模式，或設定`HTTP_PROXY` / `HTTPS_PROXY`在同一個終端。|
+| `fetch failed` 在代理/VPN 網路上反覆出現 | 開啟代理用戶端的 TUN/TURN 類模式，或設定 `HTTPS_PROXY` 與 `NODE_USE_ENV_PROXY=1` 後啟動 `ima2 serve`。 |
 
 ## 安裝和更新
 
@@ -119,20 +118,19 @@ ima2 serve
 
 ## 型號及配額
 
-### 我應該使用哪種型號？
+### 我應該使用哪個模型？
 
-該應用程式開始於`gpt-5.6-luna`;僅當您需要明確相容性或特定於帳戶的覆蓋時才選擇其他模型。
+GPT OAuth 預設使用 `gpt-6-luna`。此通道提供三個 GPT-6 模型：你選的模型負責規劃畫面，`gpt-image-2` 負責出圖。
 
-- `gpt-5.6-luna`：當前應用程式預設值。
-- `gpt-6-astra`：最新的 GPT 影像模型；可選，但不是預設值。
-- `gpt-5.6-sol` / `gpt-5.6-terra`： 當前的GPT-5.6替代方案；
-可用性取決於您的OAuth帳戶訪問，因此上游可能會拒絕它們
-直到您收到推播通知。
-- `gpt-5.5` / `gpt-5.4` / `gpt-5.4-mini`：支援的兼容性選擇。
+- `gpt-6-luna`：預設模型。
+- `gpt-6-sol`：另一個日常使用的 GPT-6 模型。
+- `gpt-6-astra`：推理時間最長、速度最慢；推理強度 `none` 會以 `low` 執行。
 
-### 為什麼會`gpt-5.5`當其他模型工作時卻失敗？
+舊的 OAuth 模型 ID（`gpt-5.6-sol`、`gpt-5.6-luna`、`gpt-5.6-terra`、`gpt-5.5`、`gpt-5.4`、`gpt-5.4-mini`）在已儲存的設定與腳本中仍可使用。`gpt-5.6-sol` 會以 `gpt-6-sol` 執行，其餘以 `gpt-6-luna` 執行。API key 通道（`provider: "api"`）保留自己的清單，預設是 `gpt-5.6-luna`。
 
-`gpt-5.5`可能需要更新的Codex CLI、後端功能或帳戶/配額可用性。更新Codex CLI第一的。如果仍然失敗，請使用`gpt-5.4`作為穩定的後備。
+### 為什麼只有某個 GPT-6 模型失敗？
+
+GPT OAuth 通道使用你的 ChatGPT 方案開放的 GPT-6 模型。請更新 ima2-gen，以 `ima2 gpt login` 重新登入，再用 `ima2 models --kind image` 檢查。若某個模型持續失敗，請改用 `gpt-6-luna`。
 
 ### Plus 或 Pro 可以產生多少張影像？
 
@@ -230,31 +228,25 @@ ima2 doctor
 
 ## 網路和OAuth錯誤
 
-### 為什麼後端或OAuth代理移動到另一個連接埠？
+### 為什麼後端換到了另一個連接埠？
 
-`ima2-gen`是一個本地應用程式。如果首選後端連接埠`3333`或者OAuth代理端口`10531`已在使用中，運行時可以回退到下一個可用連接埠並將實際 URL 記錄在：
+`ima2-gen` 是本機應用程式。若首選後端連接埠 `3333` 已被佔用，執行環境會改用下一個可用連接埠，並把實際 URL 記錄在：
 
 ```text
 ~/.ima2/server.json
 ```
 
-使用：
+執行下面的命令查看設定的與實際的後端 URL：
 
 ```bash
 ima2 doctor
 ```
 
-查看配置的和實際的後端/OAuth網址。
-
-### Windows：如果`AnySign4PC.exe`擁有港口`10531`?
-
-某些Windows安全軟體可以佔用預設值OAuth代理端口。當前版本追蹤實際的後備端口，但您也可以強制使用更安靜的範圍：
+GPT OAuth 不佔用本機連接埠，伺服器會直接呼叫 ChatGPT。
 
-```bash
-IMA2_OAUTH_PROXY_PORT=11531 ima2 serve
-```
+### 前後端分開開發時，如何指向實際的後端？
 
-對於分割前端開發，點Vite在實際後端：
+把 `ima2 doctor` 回報的後端 URL 傳給 Vite：
 
 ```bash
 VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
@@ -264,7 +256,7 @@ VITE_IMA2_API_TARGET=http://localhost:3334 npm run ui:dev
 
 通常是以下其中之一：
 
-- 當地的OAuth代理尚未準備好，
+- GPT OAuth 無法連線到 `chatgpt.com`，
 - 伺服器已重新啟動，
 - VPN/代理/防火牆阻止了請求，
 - 一個自動啟動的Windows網路攔截工具，包含DNS/片段
@@ -298,8 +290,8 @@ ima2 doctor image-probe --json > ima2-image-probe.json
 生成結果：
 
 ```bash
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --no-web-search --json > ima2-cat-no-search.json
-ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --no-web-search --json > ima2-cat-no-search.json
+ima2 gen "고양이" --model oauth/gpt-6-luna --json > ima2-cat-current.json
 ```
 
 探頭JSON旨在安全地附加到公共問題上。據報道
@@ -328,24 +320,19 @@ ima2 gen "고양이" --model oauth/gpt-5.6-luna --json > ima2-cat-current.json
 - 搜尋關閉生成有效，但正常生成失敗：可能是網路搜尋/工具選擇互動。
 - 已讀取位元組但未解析任何事件：可能SSE分隔符號或`data:`解析。
 
-### 如果什麼`fetch failed`在代理或 VPN 後面不斷發生？
+### 在代理或 VPN 後面反覆出現 `fetch failed` 怎麼辦？
 
-這通常意味著本地OAuth代理無法通過您的網路路徑到達上游服務。`openai-oauth`作為本機主機代理程式運行，通常在連接埠上`10531`.
+GPT OAuth 請求由 `ima2 serve` 行程直接送往 `chatgpt.com`，所以關鍵是這個行程的網路路徑。
 
-嘗試：
+若你的網路需要代理，請開啟代理用戶端的 TUN/TURN 類模式，讓終端機行程也能走代理。在 Windows 上，也可以暫時關閉開機自動啟動的 DNS 或封包分割繞過工具（例如 SecretDNS）後重試。若仍然不行，請在啟動 `ima2 serve` 的終端機設定代理。Node.js 22.21+ 與 24+ 只有同時設定 `NODE_USE_ENV_PROXY=1` 才會讀取 `HTTPS_PROXY`（更早的版本兩者都會忽略，請改用 TUN 模式）：
 
 ```bash
-openai-oauth --port 10531
-```
-
-如果您的網路需要代理，請啟用代理客戶端的 TUN/TURN 樣式模式，以便終端進程可以使用它。在 Windows 上，也可以暫時停用自動啟動 DNS 或碎片繞過工具（例如 SecretDNS）並重試。如果這還不夠，請在運行的同一終端機中設定代理變數`openai-oauth`或者`ima2 serve`:
-
-```bash
-export HTTP_PROXY=http://127.0.0.1:7890
 export HTTPS_PROXY=http://127.0.0.1:7890
+export NODE_USE_ENV_PROXY=1
+ima2 serve
 ```
 
-使用代理客戶端的主機和連接埠。如果`ima2-gen`本地後仍然失敗OAuth代理可訪問，在打開新問題之前收集確切的命令、作業系統、代理設定和終端錯誤。
+請使用你的代理用戶端的主機與連接埠。若 `ima2-gen` 仍然失敗，請在開新 issue 前收集確切的命令、作業系統、代理設定與終端機錯誤。
 
 ### 我應該在公司計算機上檢查什麼？