docs(readme): 重写项目文档并补充功能状态说明

优化 README 首页结构，补充快速开始、功能分组和 AI 接口说明，
并新增面向用户的功能状态文档，便于了解当前支持情况与未完成功能。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

README.md

@@ -1,22 +1,67 @@
-# chatgpt2api
+<h1 align="center">ChatGPT2API</h1>
 
-本项目仅供学习与研究交流。请务必遵循 OpenAI 的使用条款及当地法律法规，不得用于非法用途！
 
-ChatGPT 图片生成代理与账号池管理面板，提供账号维护、额度刷新和图片生成接口。
+<p align="center">ChatGPT2API 主要是对 ChatGPT 官网相关能力进行逆向整理与封装，提供面向 ChatGPT 图片生成、图片编辑、多图组图编辑场景的 OpenAI 兼容图片 API / 代理，并集成在线画图、号池管理、多种账号导入方式与 Docker 自托管部署能力。</p>
+
+> [!WARNING]
+> 免责声明：
+>
+> 本项目涉及对 ChatGPT 官网文本生成、图片生成与图片编辑等相关接口的逆向研究，仅供个人学习、技术研究与非商业性技术交流使用。
+>
+> - 严禁将本项目用于任何商业用途、盈利性使用、批量操作、自动化滥用或规模化调用。
+> - 严禁将本项目用于破坏市场秩序、恶意竞争、套利倒卖、二次售卖相关服务，以及任何违反 OpenAI 服务条款或当地法律法规的行为。
+> - 严禁将本项目用于生成、传播或协助生成违法、暴力、色情、未成年人相关内容，或用于诈骗、欺诈、骚扰等非法或不当用途。
+> - 使用者应自行承担全部风险，包括但不限于账号被限制、临时封禁或永久封禁以及因违规使用等所导致的法律责任。
+> - 使用本项目即视为你已充分理解并同意本免责声明全部内容；如因滥用、违规或违法使用造成任何后果，均由使用者自行承担。
+
+> [!IMPORTANT]
+> 本项目基于对 ChatGPT 官网相关能力的逆向研究实现，存在账号受限、临时封禁或永久封禁的风险。请勿使用你自己的重要账号、常用账号或高价值账号进行测试。
+
+## 快速开始
+
+已发布镜像支持 `linux/amd64` 与 `linux/arm64`，在 x86 服务器和 Apple Silicon / ARM Linux 设备上都会自动拉取匹配架构的版本。
+
+```bash
+git clone git@github.com:basketikun/chatgpt2api.git
+# 按需编辑 config.json 的密钥和 `refresh_account_interval_minute`
+# 也可以直接通过环境变量 CHATGPT2API_AUTH_KEY 覆盖 auth-key
+docker compose up -d
+```
 
 ## 功能
 
-- 兼容 OpenAI `Chat Completions` 图片响应
-- 兼容 OpenAI `Responses API` 图片生成接口
-- 支持导入 CPA 格式文件
-- 支持多种方式导入 `access_token`
-- 自动刷新账号邮箱、类型、图片额度、恢复时间
-- 轮询可用账号进行图片生成
-- 失效 Token 自动剔除
-- 提供 Web 后台管理账号和生成图片 
-- 支持文生图、编辑图
+### API 兼容能力
+
+- 兼容 `POST /v1/images/generations` 图片生成接口
+- 兼容 `POST /v1/images/edits` 图片编辑接口
+- 兼容面向图片场景的 `POST /v1/chat/completions`
+- 兼容面向图片场景的 `POST /v1/responses`
+- `GET /v1/models` 返回 `gpt-image-1` 与 `gpt-image-2`
+- 支持通过 `n` 返回多张生成结果
+
+### 在线画图功能
+
+- 内置在线画图工作台，支持生成、图片编辑与多图组图编辑
+- 支持 `gpt-image-1` / `gpt-image-2` 模型选择
+- 编辑模式支持参考图上传
+- 前端支持多图生成交互
+- 本地保存图片会话历史，支持回看、删除和清空
 
-> gpt-image-2灰度中，不保证完全是gpt-image-2
+### 号池管理功能
+
+- 自动刷新账号邮箱、类型、额度和恢复时间
+- 轮询可用账号执行图片生成与图片编辑
+- 遇到 Token 失效类错误时自动剔除无效 Token
+- 定时检查限流账号并自动刷新
+- 支持搜索、筛选、批量刷新、导出、手动编辑和清理账号
+- 支持三种导入方式：本地 CPA JSON 文件导入、远程 CPA 服务器导入、`access_token` 导入
+
+### 实验性 / 规划中
+
+- `gpt-image-2` 仍在灰度中，部分能力仍在完善
+- 详细状态说明见：[功能清单](./docs/feature-status.en.md)
+
+## Screenshots
 
 文生图界面：
 
@@ -26,8 +71,7 @@ ChatGPT 图片生成代理与账号池管理面板，提供账号维护、额度
 
 ![image](assets/image_edit.png)
 
-
-Chery Studio 中使用：
+Cherry Studio 中使用：
 
 ![image](assets/chery_studio.png)
 
@@ -35,53 +79,186 @@ Chery Studio 中使用：
 
 ![image](assets/account_pool.png)
 
-## 接口
+## API
 
-所有接口都需要请求头：
+所有 AI 接口都需要请求头：
 
 ```http
 Authorization: Bearer <auth-key>
 ```
 
-### 图片生成
+<details>
+<summary><code>GET /v1/models</code></summary>
+<br>
 
-```http
-POST /v1/images/generations
+返回当前暴露的图片模型列表。
+
+```bash
+curl http://localhost:8000/v1/models \
+  -H "Authorization: Bearer <auth-key>"
 ```
 
-```http
-POST /v1/chat/completions
+<details>
+<summary>说明</summary>
+<br>
+
+| 字段   | 说明                                       |
+|:-----|:-----------------------------------------|
+| 返回模型 | 当前返回 `gpt-image-1`、`gpt-image-2`         |
+| 注意事项 | `gpt-image-2` 当前仍处于灰�� / 实验状态，不保证实际效果完全稳定 |
+
+<br>
+</details>
+</details>
+
+<details>
+<summary><code>POST /v1/images/generations</code></summary>
+<br>
+
+OpenAI 兼容图片生成接口，用于文生图。
+
+```bash
+curl http://localhost:8000/v1/images/generations \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <auth-key>" \
+  -d '{
+    "model": "gpt-image-1",
+    "prompt": "一只漂浮在太空里的猫",
+    "n": 1,
+    "response_format": "b64_json"
+  }'
 ```
 
-```http
-POST /v1/responses
+<details>
+<summary>字段说明</summary>
+<br>
+
+| 字段                | 说明                                                 |
+|:------------------|:---------------------------------------------------|
+| `model`           | 图片模型，当前可用值以 `/v1/models` 返回结果为准，推荐使用 `gpt-image-1` |
+| `prompt`          | 图片生成提示词                                            |
+| `n`               | 生成数量，当前后端限制为 `1-4`                                 |
+| `response_format` | 当前请求模型中包含该字段，默认值为 `b64_json`                       |
+
+<br>
+</details>
+</details>
+
+<details>
+<summary><code>POST /v1/images/edits</code></summary>
+<br>
+
+OpenAI 兼容图片编辑接口，用于上传图片并生成编辑结果。
+
+```bash
+curl http://localhost:8000/v1/images/edits \
+  -H "Authorization: Bearer <auth-key>" \
+  -F "model=gpt-image-1" \
+  -F "prompt=把这张图改成赛博朋克夜景风格" \
+  -F "n=1" \
+  -F "image=@./input.png"
 ```
 
-请求体示例：
+<details>
+<summary>字段说明</summary>
+<br>
+
+| 字段       | 说明                                  |
+|:---------|:------------------------------------|
+| `model`  | 图片模型，推荐使用 `gpt-image-1`             |
+| `prompt` | 图片编辑提示词                             |
+| `n`      | 生成数量，当前后端限制为 `1-4`                  |
+| `image`  | 需要编辑的图片文件，使用 multipart/form-data 上传 |
+
+<br>
+</details>
+</details>
+
+<details>
+<summary><code>POST /v1/chat/completions</code></summary>
+<br>
 
-```json
-{
-  "prompt": "a cyberpunk cat walking in rainy Tokyo street",
-  "model": "gpt-image-1",
-  "n": 1,
-  "response_format": "b64_json"
-}
+面向图片场景的 Chat Completions 兼容接口，不是完整通用聊天代理。
+
+```bash
+curl http://localhost:8000/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <auth-key>" \
+  -d '{
+    "model": "gpt-image-1",
+    "messages": [
+      {
+        "role": "user",
+        "content": "生成一张雨夜东京街头的赛博朋克猫"
+      }
+    ],
+    "n": 1
+  }'
 ```
 
-## 部署
+<details>
+<summary>字段说明</summary>
+<br>
 
-已发布镜像支持 `linux/amd64` 与 `linux/arm64`，在 x86 服务器和 Apple Silicon / ARM Linux 设备上都会自动拉取匹配架构的版本。
+| 字段         | 说明                   |
+|:-----------|:---------------------|
+| `model`    | 图片模型，默认按图片生成场景处理     |
+| `messages` | 消息数组，需要是图片相关请求内容     |
+| `n`        | 生成数量，按当前实现解析为图片数量    |
+| `stream`   | 当前不支持，传入 `true` 会被拒绝 |
+
+<br>
+</details>
+</details>
+
+<details>
+<summary><code>POST /v1/responses</code></summary>
+<br>
+
+面向图片生成工具调用的 Responses API 兼容接口，不是完整通用 Responses API 代理。
 
 ```bash
-git clone git@github.com:basketikun/chatgpt2api.git
-# 按需编辑 config.json 的密钥和 `refresh_account_interval_minute`
-# 也可以直接通过环境变量 CHATGPT2API_AUTH_KEY 覆盖 auth-key
-docker compose up -d
+curl http://localhost:8000/v1/responses \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <auth-key>" \
+  -d '{
+    "model": "gpt-5",
+    "input": "生成一张未来感城市天际线图片",
+    "tools": [
+      {
+        "type": "image_generation"
+      }
+    ]
+  }'
 ```
 
-如果之前在宿主机上没有 `config.json` 就直接执行了 `docker compose up -d`，Docker 可能会错误地创建一个 `config.json/` 目录。遇到这种情况请先删除这个目录，再重新创建 `config.json` 文件后启动。
+<details>
+<summary>字段说明</summary>
+<br>
+
+| 字段       | 说明                            |
+|:---------|:------------------------------|
+| `model`  | 响应中会回显该模型字段，但图片生成当前仍走图片生成兼容逻辑 |
+| `input`  | 输入内容，需要能解析出图片生成提示词            |
+| `tools`  | 必须包含 `image_generation` 工具请求  |
+| `stream` | 当前不支持，传入 `true` 会被拒绝          |
+
+<br>
+</details>
+</details>
 
 ## 社区支持
-学 AI , 上 L 站
 
-[LinuxDO](https://linux.do)
+学 AI , 上 L 站：[LinuxDO](https://linux.do)
+
+## Contributors
+
+感谢所有为本项目做出贡献的开发者：
+
+<a href="https://github.com/basketikun/chatgpt2api/graphs/contributors">
+  <img alt="Contributors" src="https://contrib.rocks/image?repo=basketikun/chatgpt2api" />
+</a>
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/chart?repos=basketikun/chatgpt2api&type=date&legend=top-left)](https://www.star-history.com/?repos=basketikun%2Fchatgpt2api&type=date&legend=top-left)

docs/feature-status.en.md

@@ -0,0 +1,34 @@
+# 功能状态
+
+本文基于当前仓库当前实现整理，用于帮助用户快速了解哪些功能已经可用、哪些仍在完善、哪些待实现。
+
+| 功能 | 状态 | 说明 |
+|:----------------------------------------|:--:|:--------------------------------------------------------------|
+| OpenAI 兼容 `POST /v1/images/generations` | ✅  | 已支持，用于图片生成，并可通过 `n` 返回多张图片。 |
+| OpenAI 兼容 `POST /v1/images/edits` | ✅  | 已支持，可上传图片进行编辑。 |
+| 面向图片工作流的 `POST /v1/chat/completions` | ✅  | 已支持图片相关请求。 |
+| 面向图片工作流的 `POST /v1/responses` | ✅  | 已支持图片生成工具调用。 |
+| `GET /v1/models` 接口 | ✅  | 当前返回 `gpt-image-1` 与 `gpt-image-2`。 |
+| 同时生成多张图片 | ✅  | 已支持，后端与前端都可进行多图生成。 |
+| 前端图片工作台 | ✅  | 已支持图片生成、图片编辑、模型选择、历史记录与查看大图。 |
+| 前端图片输入 / 参考图交互 | ✅  | 已支持参考图上传、预览、移除和编辑模式工作流。 |
+| 账号池管理 | ✅  | 已支持列表、筛选、批量操作、导出、手动编辑、刷新和删除。 |
+| 账号额度刷新与恢复时间同步 | ✅  | 已支持账号信息刷新，限流账号也会自动继续检查。 |
+| 失效 Token 自动清理 | ✅  | 已支持自动移除失效 Token。 |
+| CPA 连接管理 | ✅  | 已支持 CPA 连接的新增、修改、查询和删除。 |
+| CPA 文件浏览与按需导入 | ✅  | 已支持读取远程文件列表、筛选、勾选并导入到本地号池。 |
+| CPA 导入进度跟踪 | ✅  | 已支持导入进度展示与轮询更新。 |
+| Docker 自托管部署 | ✅  | 已支持 Docker Compose 部署，并提供多架构镜像。 |
+| 模型列表与实际能力是否完全一致 | ⚠️ | 模型列表会显示 `gpt-image-1` 和 `gpt-image-2`，但实际效果可能与上游状态有关。 |
+| `gpt-image-1` 与 `gpt-image-2` 的能力区分 | ⚠️ | `gpt-image-2` 已可选，但目前仍处于灰度 / 实验状态。 |
+| 兼容接口中的多参考图能力 | ⚠️ | 前端已支持多参考图交互，接口侧相关能力仍在完善中。 |
+| 更高级的 Token 调度策略 | ⚠️ | 当前已有基础轮询与限流刷新机制，更复杂的调度策略仍在完善中。 |
+| Render / Vercel 等部署表述 | ⚠️ | 当前主要以 Docker 部署为主，其他平台部署方式暂未重点说明。 |
+| `/v1/complete` 文本补全与流式输出 | ❌  | 待实现。 |
+| 流式输出支持 | ❌  | 待实现。 |
+| 图片尺寸参数 | ❌  | 待实现。 |
+| 服务端图片 URL 缓存 | ❌  | 待实现。 |
+| `sub2api` 导入 | ❌  | 待实现。 |
+| `rt_token` 刷新 | ❌  | 待实现。 |
+| 代理配置功能 | ❌  | 待实现。 |
+| Anthropic 协议支持 | ❌  | 待实现。 |