diff --git a/.gitignore b/.gitignore
index 923e8fa..e285e3f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -44,7 +44,6 @@ skills-lock.json
 .local-tests/
 service/relayconvert/chat_responses_live_local_test.go
 service/openaicompat/chat_responses_live_local_test.go
-岗位任务升级.txt
 
 branch_doc/
 scripts/sh/
diff --git "a/docs/FAQ\344\270\216\345\270\270\350\247\201\346\212\245\351\224\231\346\216\222\346\237\245.md" "b/docs/FAQ\344\270\216\345\270\270\350\247\201\346\212\245\351\224\231\346\216\222\346\237\245.md"
deleted file mode 100644
index 3ecdcc3..0000000
--- "a/docs/FAQ\344\270\216\345\270\270\350\247\201\346\212\245\351\224\231\346\216\222\346\237\245.md"
+++ /dev/null
@@ -1 +0,0 @@
-# FAQ 与常见报错排查
\ No newline at end of file
diff --git "a/docs/HotAI\345\233\275\345\206\205API\345\271\263\345\217\260\347\224\250\346\210\267\346\211\213\345\206\214v1.md" "b/docs/HotAI\345\233\275\345\206\205API\345\271\263\345\217\260\347\224\250\346\210\267\346\211\213\345\206\214v1.md"
deleted file mode 100644
index cbb3712..0000000
--- "a/docs/HotAI\345\233\275\345\206\205API\345\271\263\345\217\260\347\224\250\346\210\267\346\211\213\345\206\214v1.md"
+++ /dev/null
@@ -1,50 +0,0 @@
-# HotAI 国内 API 平台用户手册
-
-## 一、平台简介
-
-HotAI 是一款国内 AI 模型 API 聚合平台，可一站式接入 DeepSeek、xxx、xxx 等多种主流模型。
-
-
-
-
-
-## 二、快速入门
-
-### 1. 访问平台
-
-
-
-
-### 2. 账号注册与登录
-
-
-
-
-### 3. 控制台概览
-
-
-
-
-## 三、API Key 管理
-
-
-
-
-
-## 四、模型列表与选择
-
-
-
-
-
-## 五、用量与计费
-
-
-
-
-
-## 六、常见问题快速索引
-
-
-
-
diff --git "a/docs/SSE\351\227\256\351\242\230\346\216\222\346\237\245.md" "b/docs/SSE\351\227\256\351\242\230\346\216\222\346\237\245.md"
deleted file mode 100644
index c50eb23..0000000
--- "a/docs/SSE\351\227\256\351\242\230\346\216\222\346\237\245.md"
+++ /dev/null
@@ -1,26 +0,0 @@
-  Stream 输出问题的定位路径
-
-  Stream 处理分三层，从外到内：
-
-  第一层：通用 SSE 扫描器（所有渠道共用）
-
-  relay/helper/stream_scanner.go — StreamScannerHandler()
-  负责从上游 HTTP 响应读取 SSE 行、解析 data: 前缀、超时控制、ping、goroutine 生命周期管理。如果流根本没数据或中途断掉，问题在这里。
-
-  第二层：OpenAI 格式的流处理（大多数渠道走这里）
-
-  relay/channel/openai/relay-openai.go — OaiStreamHandler()
-  relay/channel/openai/helper.go      — HandleStreamFormat() / handleLastResponse()
-  负责逐帧处理 ChatCompletionsStreamResponse、thinking content 转换（<think> 标签）、提取最终 usage、发送 [DONE]。如果输出内容乱、usage 不对、thinking 标签异常，问题在这里。
-
-  第三层：各渠道专属适配器
-
-  relay/channel/<provider>/relay-<name>.go
-  例如 Claude 走 relay/channel/claude/relay-claude.go，有自己的 stream handler。如果只有特定渠道有问题，先看对应的 relay-*.go。
-
-  定位顺序建议：
-
-  1. 开日志（设置 common.DebugEnabled = true 或环境变量），看 stream scanner data: 的原始输出，确认上游是否正常返回数据
-  2. 如果原始数据正常，问题在 relay-openai.go 的 OaiStreamHandler 或 HandleStreamFormat
-  3. 如果特定渠道才复现，直接看 relay/channel/<provider>/ 下的适配器
-  4. 如果流挂起、超时，看 stream_scanner.go 里的 streamingTimeout 和 stopChan 逻辑
\ No newline at end of file
diff --git a/docs/Structrue.md b/docs/Structrue.md
deleted file mode 100644
index dd48d82..0000000
--- a/docs/Structrue.md
+++ /dev/null
@@ -1,142 +0,0 @@
-这是一个基于 Go 的 AI API 网关/代理系统，聚合了 40+ 个上游 AI 提供商（OpenAI、Claude、Gemini、Azure、AWS Bedrock 等），提供统一的 API 接口，并包含用户管理、计费、限流和管理后台。
-
-  核心架构
-
-  分层架构模式
-
-  采用经典的分层架构：Router → Controller → Service → Model
-
-  客户端请求
-      ↓
-  Router（路由层）- 定义 HTTP 端点
-      ↓
-  Controller（控制器层）- 处理请求/响应
-      ↓
-  Service（业务逻辑层）- 核心业务逻辑
-      ↓
-  Model（数据层）- GORM 模型和数据库访问
-
-  目录结构与职责
-
-  核心业务模块：
-  - router/ - HTTP 路由定义（API、relay、dashboard、web）
-  - controller/ - 请求处理器，参数验证，响应封装
-  - service/ - 业务逻辑实现，事务处理
-  - model/ - GORM 数据模型，数据库操作
-
-  AI 代理核心：
-  - relay/ - AI API 转发/代理引擎
-  - relay/channel/ - 各提供商适配器（openai/, claude/, gemini/, aws/ 等）
-    - 每个提供商有独立的请求/响应适配逻辑
-
-  基础设施：
-  - middleware/ - 认证、限流、CORS、日志、请求分发
-  - setting/ - 配置管理（比率、模型、操作、系统、性能）
-  - common/ - 共享工具（JSON、加密、Redis、环境变量、限流等）
-  - pkg/ - 内部包（cachex 缓存、ionet 网络）
-
-  数据定义：
-  - dto/ - 数据传输对象（请求/响应结构体）
-  - constant/ - 常量定义（API 类型、渠道类型、上下文键）
-  - types/ - 类型定义（relay 格式、文件源、错误）
-
-  国际化与认证：
-  - i18n/ - 后端国际化（go-i18n，英文/中文）
-  - oauth/ - OAuth 提供商实现
-
-  前端：
-  - web/default/ - React 19 + Rsbuild + Base UI + Tailwind CSS
-  - web/classic/ - React 18 + Vite + Semi Design（经典版）
-
-  关键技术模式
-
-  1. 统一 JSON 处理
-
-  所有 JSON 操作必须使用 common/json.go 的包装函数：
-  common.Marshal(v any) ([]byte, error)
-  common.Unmarshal(data []byte, v any) error
-  common.UnmarshalJsonStr(data string, v any) error
-  common.DecodeJson(reader io.Reader, v any) error
-  禁止直接使用 encoding/json，确保全局一致性。
-
-  2. 多数据库兼容
-
-  必须同时支持 SQLite、MySQL (≥5.7.8)、PostgreSQL (≥9.6)：
-  - 优先使用 GORM 方法而非原始 SQL
-  - 处理数据库方言差异（引号、布尔值、保留字）
-  - 使用 common.UsingMainDatabase(...) / common.UsingLogDatabase(...) 进行分支
-  - 迁移必须在三个数据库上都能工作
-
-  3. Relay 提供商适配模式
-
-  每个 AI 提供商在 relay/channel/ 下有独立适配器：
-  - 请求结构体：可选标量字段必须使用指针类型 + omitempty
-  type Request struct {
-      Temperature *float64 `json:"temperature,omitempty"` // 正确
-      MaxTokens   int      `json:"max_tokens"`            // 错误（如果是可选）
-  }
-  - 保留显式零值：客户端明确传 0 应发送上游，nil 应省略
-  - 支持 StreamOptions 的渠道需加入 streamSupportedChannels
-
-  4. 计费表达式系统
-
-  动态计费基于表达式系统，开发前必读 pkg/billingexpr/expr.md：
-  - 分层定价、令牌归一化、配额转换
-  - 表达式语言、版本管理
-  - 所有计费改动必须遵循该文档
-
-  5. 国际化 (i18n)
-
-  后端：
-  - 库：nicksnyder/go-i18n/v2
-  - 语言：en, zh
-
-  前端：
-  - 库：i18next + react-i18next + i18next-browser-languagedetector
-  - 语言：en（基础）、zh（fallback）、fr、ru、ja、vi
-  - 文件：web/default/src/i18n/locales/{lang}.json（扁平 JSON，键为英文源字符串）
-  - 用法：useTranslation() hook，调用 t('English key')
-
-  开发模式与规范
-
-  代码质量原则
-
-  - 直接可读：优先使用早返回、清晰分支、命名良好的局部变量
-  - 避免过度嵌套：函数定义仅在回调 API 或闭包明显更简单时使用
-  - 最小化辅助函数：单次调用的辅助函数应内联，除非代表可复用业务概念
-
-  测试质量
-
-  - 保护真实行为、API 契约、计费不变性、数据兼容性或回归路径
-  - 新测试必须使用 github.com/stretchr/testify/require（致命断言）和 assert（非致命检查）
-  - 避免仅提升覆盖率数字的测试、随机输入的假模糊测试、重复测试
-  - 优先确定性表驱动测试，显式输入和精确预期输出
-
-  前端开发
-
-  - 包管理器：bun（优先于 npm/yarn/pnpm）
-  bun install
-  bun run dev
-  bun run build
-  bun run i18n:sync
-  - 所有用户界面文本必须通过 t('English key') 支持 i18n
-  - 详细规范见 web/default/AGENTS.md
-
-  Git 与 PR
-
-  - PR 必须使用 .github/PULL_REQUEST_TEMPLATE.md 模板
-  - 如当前 git 用户非历史核心开发者，需在 PR 中说明代码为 AI 生成或辅助
-  - 保护项目信息（new-api、QuantumNous）不可修改或删除
-
-  技术栈总结
-    后端语言: Go 1.22+
-    Web 框架: Gin
-    ORM: GORM v2
-    数据库: SQLite + MySQL + PostgreSQL（多选一运行时）
-    缓存: Redis (go-redis) + 内存缓存
-    认证: JWT + WebAuthn/Passkeys + OAuth
-    前端框架: React 19 + TypeScript
-    前端构建: Rsbuild
-    I 库: Base UI + Tailwind CSS
-    包管理: Bun
-  这是一个生产级的多租户 AI 网关系统，强调数据库兼容性、类型安全、国际化支持和严格的编码规范。
diff --git a/docs/ionet-client.md b/docs/ionet-client.md
deleted file mode 100644
index a4d40b1..0000000
--- a/docs/ionet-client.md
+++ /dev/null
@@ -1,7 +0,0 @@
-Request URL
-https://api.io.solutions/v1/io-cloud/clusters/654fc0a9-0d4a-4db4-9b95-3f56189348a2/update-name
-Request Method
-PUT
-
-{"status":"succeeded","message":"Cluster name updated successfully"}
-
diff --git a/docs/sse-utf8-streaming-fix.md b/docs/sse-utf8-streaming-fix.md
deleted file mode 100644
index 60bc50c..0000000
--- a/docs/sse-utf8-streaming-fix.md
+++ /dev/null
@@ -1,74 +0,0 @@
-# SSE UTF-8 Streaming Fix
-
-## Symptom
-
-OpenAI-compatible streaming requests could fail with `stream_non_json_chunk`.
-The client received a truncated JSON prefix such as:
-
-```text
-{"choices":[{"delta":{"reasoning_content":"...
-```
-
-The gateway log then reported `client_gone` because the client stopped reading
-after it could not decode that SSE data block.
-
-## Root Cause
-
-The relay emitted `Content-Type: text/event-stream` without a charset.
-Clients that use `requests.iter_lines(decode_unicode=True)` may default to a
-single-byte encoding. UTF-8 bytes in Chinese output can then be interpreted as
-line separators, splitting one JSON SSE event into multiple client lines.
-
-`helper.SetEventStreamHeaders` set the intended header, but the first
-`common.CustomEvent` render replaced it with the charset-less value. Both paths
-must declare UTF-8.
-
-## Fix
-
-Use this header for every SSE response:
-
-```http
-Content-Type: text/event-stream; charset=utf-8
-```
-
-The header is set in both locations that can write SSE output:
-
-- `relay/helper/common.go`: `SetEventStreamHeaders`
-- `common/custom-event.go`: `CustomEvent.WriteContentType`
-
-The shared stream scanner also preserves malformed upstream continuation data
-without forwarding a physically split JSON data line.
-
-## Verification
-
-Build and restart the local backend:
-
-```bash
-docker compose -f docker-compose.dev.yml up -d --build new-api
-```
-
-Confirm a streaming response includes `charset=utf-8` and that every `data:`
-payload is valid JSON until `[DONE]`.
-
-Run the B streaming regression suite:
-
-```bash
-cd /home/yihan/internship_project/test_files
-python3 test_b_samples.py
-```
-
-The generated `openai_compatible_b_test_results_*.json` must report:
-
-```json
-{
-  "success_count": 5,
-  "failed_count": 0,
-  "success_rate_percent": 100
-}
-```
-
-Run relay unit tests before merging:
-
-```bash
-go test ./relay/...
-```
diff --git a/docs/translation-glossary.fr.md b/docs/translation-glossary.fr.md
deleted file mode 100644
index d73d0da..0000000
--- a/docs/translation-glossary.fr.md
+++ /dev/null
@@ -1,107 +0,0 @@
-# Glossaire Français (French Glossary)
-
-Ce document fournit des traductions standards françaises pour la terminologie clé du projet afin d'assurer la cohérence et la précision des traductions.
-
-This document provides standard French translations for key project terminology to ensure consistency and accuracy in translations.
-
-## Concepts de Base (Core Concepts)
-
-- L'utilisation d'émojis dans les traductions est autorisée s'ils sont présents dans l'original
-- L'utilisation de termes purement techniques est autorisée s'ils sont présents dans l'original
-- L'utilisation de termes techniques en anglais est autorisée s'ils sont largement utilisés dans l'environnement technique francophone (par exemple, API)
-
-| Chinois | Français | Anglais | Description |
-|---------|----------|---------|-------------|
-| 倍率 | Ratio | Ratio/Multiplier | Multiplicateur utilisé pour le calcul des prix. **Important :** Dans le contexte des calculs de prix, toujours utiliser "Ratio" plutôt que "Multiplicateur" pour assurer la cohérence terminologique |
-| 令牌 | Jeton | Token | Identifiants d'accès API ou unités de texte traitées par les modèles |
-| 渠道 | Canal | Channel | Canal d'accès aux fournisseurs d'API |
-| 分组 | Groupe | Group | Classification des utilisateurs ou des jetons |
-| 额度 | Quota | Quota | Quota de services disponible pour l'utilisateur |
-
-## Modèles (Model Related)
-
-| Chinois | Français | Anglais | Description |
-|---------|----------|---------|-------------|
-| 提示 | Invite | Prompt | Contenu d'entrée du modèle |
-| 补全 | Complétion | Completion | Contenu de sortie du modèle. **Important :** Ne pas utiliser "Achèvement" ou "Finalisation" - uniquement "Complétion" pour correspondre à la terminologie technique |
-| 输入 | Entrée | Input/Prompt | Contenu envoyé au modèle |
-| 输出 | Sortie | Output/Completion | Contenu retourné par le modèle |
-| 模型倍率 | Ratio du modèle | Model Ratio | Ratio de tarification pour différents modèles |
-| 补全倍率 | Ratio de complétion | Completion Ratio | Ratio de tarification supplémentaire pour la sortie |
-| 固定价格 | Prix fixe | Price per call | Prix par appel |
-| 按量计费 | Paiement à l'utilisation | Pay-as-you-go | Tarification basée sur l'utilisation |
-| 按次计费 | Paiement par appel | Pay-per-view | Prix fixe par appel |
-
-## Gestion des Utilisateurs (User Management)
-
-| Chinois | Français | Anglais | Description |
-|---------|----------|---------|-------------|
-| 超级管理员 | Super-administrateur | Root User | Administrateur avec les privilèges les plus élevés |
-| 管理员 | Administrateur | Admin User | Administrateur système |
-| 普通用户 | Utilisateur normal | Normal User | Utilisateur avec privilèges standards |
-
-## Recharge et Échange (Recharge & Redemption)
-
-| Chinois | Français | Anglais | Description |
-|---------|----------|---------|-------------|
-| 充值 | Recharge | Top Up | Ajout de quota au compte |
-| 兑换码 | Code d'échange | Redemption Code | Code qui peut être échangé contre du quota |
-
-## Gestion des Canaux (Channel Management)
-
-| Chinois | Français | Anglais | Description |
-|---------|----------|---------|-------------|
-| 渠道 | Canal | Channel | Canal du fournisseur d'API |
-| API密钥 | Clé API | API Key | Clé d'accès API. **Important :** Utiliser "Clé API" au lieu de "Jeton API" pour plus de précision et conformément à la terminologie technique francophone établie. Le terme "Clé" reflète mieux la fonctionnalité d'accès aux ressources, tandis que "Jeton" est plus souvent associé aux unités de texte dans le contexte du traitement des modèles linguistiques. |
-| 优先级 | Priorité | Priority | Priorité de sélection du canal |
-| 权重 | Poids | Weight | Poids d'équilibrage de charge |
-| 代理 | Proxy | Proxy | Adresse du serveur proxy |
-| 模型重定向 | Redirection de modèle | Model Mapping | Remplacement du nom du modèle dans le corps de la requête |
-| 供应商 | Fournisseur | Provider/Vendor | Fournisseur de services ou d'API |
-
-## Sécurité (Security Related)
-
-| Chinois | Français | Anglais | Description |
-|---------|----------|---------|-------------|
-| 两步验证 | Authentification à deux facteurs | Two-Factor Authentication | Méthode de vérification de sécurité supplémentaire pour les comptes |
-| 2FA | 2FA | Two-Factor Authentication | Abréviation de l'authentification à deux facteurs |
-
-## Recommandations de Traduction (Translation Guidelines)
-
-### Variantes Contextuelles de Traduction
-
-**Invite/Entrée (Prompt/Input)**
-
-- **Invite** : Lors de l'interaction avec les LLM, dans l'interface utilisateur, lors de la description de l'interaction avec le modèle
-- **Entrée** : Dans la tarification, la documentation technique, la description du processus de traitement des données
-- **Règle** : S'il s'agit de l'expérience utilisateur et de l'interaction avec l'IA → "Invite", s'il s'agit du processus technique ou des calculs → "Entrée"
-
-**Jeton (Token)**
-
-- Jeton d'accès API (API Token)
-- Unité de texte traitée par le modèle (Text Token)
-- Jeton d'accès système (Access Token)
-
-**Quota (Quota)**
-
-- Quota de services disponible pour l'utilisateur
-- Parfois traduit comme "Crédit"
-
-### Particularités de la Langue Française
-
-- **Formes plurielles** : Nécessite une implémentation correcte des formes plurielles (_one, _other)
-- **Accords grammaticaux** : Attention aux accords grammaticaux dans les termes techniques
-- **Genre grammatical** : Accord du genre des termes techniques (par exemple, "modèle" - masculin, "canal" - masculin)
-
-### Termes Standardisés
-
-- **Complétion (Completion)** : Contenu de sortie du modèle
-- **Ratio (Ratio)** : Multiplicateur pour le calcul des prix
-- **Code d'échange (Redemption Code)** : Utilisé au lieu de "Code d'échange" pour plus de précision
-- **Fournisseur (Provider/Vendor)** : Organisation ou service fournissant des API ou des modèles d'IA
-
----
-
-**Note pour les contributeurs :** Si vous trouvez des incohérences dans les traductions de terminologie ou si vous avez de meilleures suggestions de traduction pour le français, n'hésitez pas à créer une Issue ou une Pull Request.
-
-**Contribution Note for French:** If you find any inconsistencies in terminology translations or have better translation suggestions for French, please feel free to submit an Issue or Pull Request.
\ No newline at end of file
diff --git a/docs/translation-glossary.md b/docs/translation-glossary.md
deleted file mode 100644
index c5f68ad..0000000
--- a/docs/translation-glossary.md
+++ /dev/null
@@ -1,86 +0,0 @@
-# 翻译术语表 (Translation Glossary)
-
-本文档为翻译贡献者提供项目中关键术语的标准翻译参考，以确保翻译的一致性和准确性。
-
-This document provides standard translation references for key terminology in the project to ensure consistency and accuracy for translation contributors.
-
-## 核心概念 (Core Concepts)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 倍率 | Ratio | 用于计算价格的乘数因子 | Multiplier factor used for price calculation |
-| 令牌 | Token | API访问凭证，也指模型处理的文本单元 | API access credentials or text units processed by models |
-| 渠道 | Channel | API服务提供商的接入通道 | Access channel for API service providers |
-| 分组 | Group | 用户或令牌的分类，影响价格倍率 | Classification of users or tokens, affecting price ratios |
-| 额度 | Quota | 用户可用的服务额度 | Available service quota for users |
-
-## 模型相关 (Model Related)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 提示 | Prompt | 模型输入内容 | Model input content |
-| 补全 | Completion | 模型输出内容 | Model output content |
-| 输入 | Input/Prompt | 发送给模型的内容 | Content sent to the model |
-| 输出 | Output/Completion | 模型返回的内容 | Content returned by the model |
-| 模型倍率 | Model Ratio | 不同模型的计费倍率 | Billing ratio for different models |
-| 补全倍率 | Completion Ratio | 输出内容的额外计费倍率 | Additional billing ratio for output content |
-| 固定价格 | Price per call | 按次计费的价格 | Fixed price per call |
-| 按量计费 | Pay-as-you-go | 根据使用量计费 | Billing based on usage |
-| 按次计费 | Pay-per-view | 每次调用固定价格 | Fixed price per invocation |
-
-## 用户管理 (User Management)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 超级管理员 | Root User | 最高权限管理员 | Administrator with highest privileges |
-| 管理员 | Admin User | 系统管理员 | System administrator |
-| 普通用户 | Normal User | 普通权限用户 | Regular user with standard privileges |
-
-## 充值与兑换 (Recharge & Redemption)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 充值 | Top Up | 为账户增加额度 | Add quota to account |
-| 兑换码 | Redemption Code | 可兑换额度的代码 | Code that can be redeemed for quota |
-
-## 渠道管理 (Channel Management)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 渠道 | Channel | API服务提供通道 | API service provider channel |
-| 密钥 | Key | API访问密钥 | API access key |
-| 优先级 | Priority | 渠道选择优先级 | Channel selection priority |
-| 权重 | Weight | 负载均衡权重 | Load balancing weight |
-| 代理 | Proxy | 代理服务器地址 | Proxy server address |
-| 模型重定向 | Model Mapping | 请求体中模型名称替换 | Model name replacement in request body |
-
-## 安全相关 (Security Related)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 两步验证 | Two-Factor Authentication | 为账户提供额外安全保护的验证方式 | Additional security verification method for accounts |
-| 2FA | Two-Factor Authentication | 两步验证的缩写 | Abbreviation for Two-Factor Authentication |
-
-## 计费相关 (Billing Related)
-
-| 中文 | English | 说明 | Description |
-|------|---------|------|-------------|
-| 倍率 | Ratio | 价格计算的乘数因子 | Multiplier factor used for price calculation |
-| 倍率 | Multiplier | 价格计算的乘数因子（同义词） | Multiplier factor used for price calculation (synonym) |
-
-## 翻译注意事项 (Translation Guidelines)
-
-- **提示 (Prompt)** = 模型输入内容 / Model input content
-- **补全 (Completion)** = 模型输出内容 / Model output content
-- **倍率 (Ratio)** = 价格计算的乘数因子 / Multiplier factor for price calculation
-- **额度 (Quota)** = 可用的用户服务额度，有时也翻译为 Credit / Available service quota for users, sometimes also translated as Credit
-- **Token** = 根据上下文可能指 / Depending on context, may refer to:
-  - API访问令牌 (API Token)
-  - 模型处理的文本单元 (Text Token)
-  - 系统访问令牌 (Access Token)
-
----
-
-**贡献说明**: 如发现术语翻译不一致或有更好的翻译建议，欢迎提交 Issue 或 Pull Request。
-
-**Contribution Note**: If you find any inconsistencies in terminology translations or have better translation suggestions, please feel free to submit an Issue or Pull Request.
diff --git a/docs/translation-glossary.ru.md b/docs/translation-glossary.ru.md
deleted file mode 100644
index 60a9bd2..0000000
--- a/docs/translation-glossary.ru.md
+++ /dev/null
@@ -1,107 +0,0 @@
-# Русский глоссарий (Russian Glossary)
-
-Данный раздел предоставляет стандартные переводы ключевой терминологии проекта на русский язык для обеспечения согласованности и точности переводов.
-
-This section provides standard Russian translations for key project terminology to ensure consistency and accuracy in translations.
-
-## Основные концепции (Core Concepts)
-
-- Допускается использовать символы Emoji в переводе, если они были в оригинале.
-- Допускается использование сугубо технических терминов, если они были в оригинале.
-- Допускается использование технических терминов на английском языке, если они широко используются в русскоязычной технической среде (например, API).
-
-| Китайский | Русский | Английский | Описание |
-|-----------|--------|-----------|----------|
-| 倍率 | Коэффициент | Ratio/Multiplier | Множитель для расчета цены. **Важно:** В контексте расчетов цен всегда использовать "Коэффициент", а не "Множитель" для обеспечения консистентности терминологии |
-| 令牌 | Токен | Token | Учетные данные API или текстовые единицы |
-| 渠道 | Канал | Channel | Канал доступа к поставщику API |
-| 分组 | Группа | Group | Классификация пользователей или токенов |
-| 额度 | Квота | Quota | Доступная квота услуг для пользователя |
-
-## Модели (Model Related)
-
-| Китайский | Русский | Английский | Описание |
-|-----------|--------|-----------|----------|
-| 提示 | Промпт/Ввод | Prompt | Содержимое ввода в модель |
-| 补全 | Вывод | Completion | Содержимое вывода модели. **Важно:** Не использовать "Дополнение" или "Завершение" - только "Вывод" для соответствия технической терминологии |
-| 输入 | Ввод | Input/Prompt | Содержимое, отправляемое в модель |
-| 输出 | Вывод | Output/Completion | Содержимое, возвращаемое моделью |
-| 模型倍率 | Коэффициент модели | Model Ratio | Коэффициент тарификации для разных моделей |
-| 补全倍率 | Коэффициент вывода | Completion Ratio | Дополнительный коэффициент тарификации для вывода |
-| 固定价格 | Цена за запрос | Price per call | Цена за один вызов |
-| 按量计费 | Оплата по объему | Pay-as-you-go | Тарификация на основе использования |
-| 按次计费 | Оплата за запрос | Pay-per-view | Фиксированная цена за вызов |
-
-## Управление пользователями (User Management)
-
-| Китайский | Русский | Английский | Описание |
-|-----------|--------|-----------|----------|
-| 超级管理员 | Суперадминистратор | Root User | Администратор с наивысшими привилегиями |
-| 管理员 | Администратор | Admin User | Системный администратор |
-| 普通用户 | Обычный пользователь | Normal User | Пользователь со стандартными привилегиями |
-
-## Пополнение и обмен (Recharge & Redemption)
-
-| Китайский | Русский | Английский | Описание |
-|-----------|--------|-----------|----------|
-| 充值 | Пополнение | Top Up | Добавление квоты на аккаунт |
-| 兑换码 | Код купона | Redemption Code | Код, который можно обменять на квоту |
-
-## Управление каналами (Channel Management)
-
-| Китайский | Русский | Английский | Описание |
-|-----------|--------|-----------|----------|
-| 渠道 | Канал | Channel | Канал поставщика API |
-| API密钥 | API ключ | API Key | Ключ доступа к API. **Важно:** Использовать "API ключ" вместо "API токен" для большей точности и соответствия общепринятой русскоязычной технической терминологии. Термин "ключ" более точно отражает функционал доступа к ресурсам, в то время как "токен" чаще ассоциируется с текстовыми единицами в контексте обработки языковых моделей. |
-| 优先级 | Приоритет | Priority | Приоритет выбора канала |
-| 权重 | Вес | Weight | Вес балансировки нагрузки |
-| 代理 | Прокси | Proxy | Адрес прокси-сервера |
-| 模型重定向 | Перенаправление модели | Model Mapping | Замена имени модели в теле запроса |
-| 供应商 | Поставщик | Provider/Vendor | Поставщик услуг или API |
-
-## Безопасность (Security Related)
-
-| Китайский | Русский | Английский | Описание |
-|-----------|--------|-----------|----------|
-| 两步验证 | Двухфакторная аутентификация | Two-Factor Authentication | Дополнительный метод проверки безопасности для аккаунтов |
-| 2FA | 2FA | Two-Factor Authentication | Аббревиатура двухфакторной аутентификации |
-
-## Рекомендации по переводу (Translation Guidelines)
-
-### Контекстуальные варианты перевода
-
-**Промпт/Ввод (Prompt/Input)**
-
-- **Промпт**: При общении с LLM, в пользовательском интерфейсе, при описании взаимодействия с моделью
-- **Ввод**: При тарификации, технической документации, описании процесса обработки данных
-- **Правило**: Если речь о пользовательском опыте и взаимодействии с AI → "Промпт", если о техническом процессе или расчетах → "Ввод"
-
-**Token**
-
-- API токен доступа (API Token)
-- Текстовая единица, обрабатываемая моделью (Text Token)
-- Токен доступа к системе (Access Token)
-
-**Квота (Quota)**
-
-- Доступная квота услуг пользователя
-- Иногда переводится как "Кредит"
-
-### Особенности русского языка
-
-- **Множественные формы**: Требуется правильная реализация множественных форм (_one,_few, _many,_other)
-- **Падежные окончания**: Внимательное отношение к падежным окончаниям в технических терминах
-- **Грамматический род**: Согласование рода технических терминов (например, "модель" - женский род, "канал" - мужской род)
-
-### Стандартизированные термины
-
-- **Вывод (Completion)**: Содержимое вывода модели
-- **Коэффициент (Ratio)**: Множитель для расчета цены
-- **Код купона (Redemption Code)**: Используется вместо "Код обмена" для большей точности
-- **Поставщик (Provider/Vendor)**: Организация или сервис, предоставляющий API или AI-модели
-
----
-
-**Примечание для участников:** При обнаружении несогласованности в переводах терминологии или наличии лучших предложений по переводу, не стесняйтесь создавать Issue или Pull Request.
-
-**Contribution Note for Russian:** If you find any inconsistencies in terminology translations or have better translation suggestions for Russian, please feel free to submit an Issue or Pull Request.
diff --git "a/docs/\344\276\235\350\265\226\345\256\211\350\243\205.md" "b/docs/\344\276\235\350\265\226\345\256\211\350\243\205.md"
deleted file mode 100644
index 4dae4e2..0000000
--- "a/docs/\344\276\235\350\265\226\345\256\211\350\243\205.md"
+++ /dev/null
@@ -1,101 +0,0 @@
-  路线 A：最简单（SQLite，无需 Docker）
-
-  1. 安装依赖
-
-  Go 1.25+
-  # Linux/macOS（用官方脚本）
-  wget https://go.dev/dl/go1.25.1.linux-amd64.tar.gz
-  sudo tar -C /usr/local -xzf go1.25.1.linux-amd64.tar.gz
-  echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
-  source ~/.bashrc
-  go version
-
-  Bun（前端包管理器）
-  curl -fsSL https://bun.sh/install | bash
-  source ~/.bashrc
-  bun --version
-
-  2. 安装前端依赖并构建
-
-  cd /home/yihan/HotAI/web/default
-  bun install
-  bun run build
-
-  构建产物会输出到 web/default/dist/，Go 编译时会通过 //go:embed 打包进二进制。
-
-  3. 编译并运行后端
-
-  cd /home/yihan/HotAI
-  go build -o new-api .
-  ./new-api
-
-  默认监听 http://localhost:3000，首次启动会自动创建 SQLite 数据库文件（/data/new-api.db 或当前目录）。初始 root 密码会打印在终端日志里。
-
-  ---
-  路线 B：开发模式（前后端分离，PostgreSQL + Redis）
-
-  适合频繁改代码，前端有热更新，后端不用重新打包前端。
-
-  1. 额外依赖：Docker + Docker Compose
-
-  # Ubuntu/Debian
-  sudo apt-get update
-  sudo apt-get install -y docker.io docker-compose-plugin
-
-  # 将当前用户加入 docker 组（免 sudo）
-  sudo usermod -aG docker $USER
-  newgrp docker
-
-  2. 启动数据库和 Redis
-
-  cd /home/yihan/HotAI
-
-  # 构建后端镜像（跳过前端，用占位 HTML）并启动 PostgreSQL + Redis
-  docker compose -f docker-compose.dev.yml up -d --build
-
-  第一次会拉取镜像并编译 Go，稍等片刻。完成后后端运行在 localhost:3000。
-
-  验证是否正常：
-  docker compose -f docker-compose.dev.yml logs -f new-api
-
-  看到类似 Server started on :3000 即成功。
-
-  3. 启动前端 dev server
-
-  另开一个终端：
-  cd /home/yihan/HotAI/web/default
-  bun install
-  bun run dev
-
-  前端运行在 http://localhost:3001，API 请求自动代理到 :3000。
-
-  4. 后续开发流程
-
-  - 改了 Go 代码：重新构建后端镜像
-  docker compose -f docker-compose.dev.yml up -d --build new-api
-  - 改了前端代码：Rsbuild 自动热更新，无需操作
-  - 停止所有服务：
-  docker compose -f docker-compose.dev.yml down
-  - 清空数据重来：
-  docker compose -f docker-compose.dev.yml down -v
-
-  ---
-  路线 C：完整 Docker Compose（最接近生产）
-
-  cd /home/yihan/HotAI
-  cp .env.example .env
-  # 按需修改 .env 里的密码（SESSION_SECRET 建议改成随机字符串）
-
-  docker compose up -d
-
-  访问 http://localhost:3000，首次进入会有初始化向导。
-
-  ---
-              路线 A         路线 B            路线 C
-适合场景       快速体验        日常开发            完整测试/生产
-依赖           Go + Bun      Go + Bun + Docker  Docker
-数据库         SQLite        PostgreSQL 15      PostgreSQL 17
-前端热更新      无             有                 无
-重新打包前端    每次改代码都要   不需要              不需要
-
-
diff --git "a/docs/\350\277\234\347\250\213\351\203\250\347\275\262\346\214\207\345\257\274.md" "b/docs/\350\277\234\347\250\213\351\203\250\347\275\262\346\214\207\345\257\274.md"
deleted file mode 100644
index 331139e..0000000
--- "a/docs/\350\277\234\347\250\213\351\203\250\347\275\262\346\214\207\345\257\274.md"
+++ /dev/null
@@ -1,92 +0,0 @@
-### 远程部署流程
-
-#### 1. 本地开发
-
-#### 1.5 本地构建可能遇到的问题
-
-##### 问题:
-
-```text
-ERROR [internal] load metadata for docker.io/library/debian:bookworm-slim  
-```
-
-##### 解决方法:
-
-没招了，纯靠VPN解决。
-可以试试改 docker Desktop -> Setting -> Docker Engine -> Add the following to the JSON configuration file:
-
-```json
-{
-  "registry-mirrors": [
-    "https://docker.m.daocloud.io",
-    "https://dockerproxy.com"
-  ]
-}
-```
-
-但大概率没有效果。
-
-##### 问题：
-
-```text
-卡在: RUN go mod download
-```
-
-##### 解决方法：
-
-实测有效：
-
-```bash
-go env -w GOPROXY=https://goproxy.cn,direct
-go env -w GOSUMDB=sum.golang.google.cn
-```
-
-#### 2. 本地部署和测试
-
-```bash
-# 只有前段改动的话
-docker compose -f docker-compose.dev.yml up -d
-cd web/default
-bun install
-bun run dev
-```
-
-```bash
-# 有后端改动的话（Go 代码改动），需要重新 build new-api 镜像
-docker compose -f docker-compose.dev.yml up -d --build new-api
-```
-
-#### 3. 远程部署
-
-在本地开发和测试完成后，确认代码没有问题后，就可以进行远程部署了。
-
-##### 3.1 构建docker镜像
-
-```bash
-# docker 镜像的 tag 名
-export APP_IMAGE=ghcr.io/betterlol/hotai:版本号
-# 呃，建议使用 git tag 来管理版本号，或者使用 git commit hash 来管理版本号
-# export APP_IMAGE=ghcr.io/betterlol/hotai:$(git rev-parse --short HEAD)
-# 构建docker镜像
-docker compose -f docker-compose.build.yml build
-```
-
-##### 3.2 推送docker镜像到远程仓库
-
-```bash
-# 将本地构建的镜像推送到远程仓库，方便远程服务器拉取
-export APP_IMAGE=ghcr.io/betterlol/hotai:版本号
-# docker login ghcr.io
-# docker login ghcr.io -u Betterlol
-# 密码向本人索取....
-docker compose -f docker-compose.build.yml push
-```
-
-##### 3.3 拉取远程仓库的镜像并启动服务
-
-```bash
-# 登陆远程服务器后，cd 到 /home/admin/newapi 目录下，修改 .env 文件中的 APP_IMAGE 为你刚刚构建的镜像名后，执行如下命令：
-docker compose pull
-docker compose up -d
-```
-
diff --git a/scripts/feishu/.env.example b/scripts/feishu/.env.example
index 608ab72..9062e28 100644
--- a/scripts/feishu/.env.example
+++ b/scripts/feishu/.env.example
@@ -13,4 +13,4 @@ FEISHU_FETCH_DOC_AFTER_AUTH=true
 
 FEISHU_DOC_OUTPUT=docs/feishu_content.txt
 FEISHU_SYNC_MODEL_INFO=true
-FEISHU_MODEL_INFO_PATH=web/HotAI/dist/docs/model-info.md
+FEISHU_MODEL_INFO_PATH=web/HotAI/dist/docs/user/103-model-info.md
diff --git a/scripts/feishu/README.md b/scripts/feishu/README.md
index 4a30de0..839a6f0 100644
--- a/scripts/feishu/README.md
+++ b/scripts/feishu/README.md
@@ -8,7 +8,7 @@
 2. 使用 token 读取配置的飞书 Wiki 文档或电子表格。
 3. 将抓取结果转换为 Markdown。
 4. 从 Markdown 中提取第一张表格。
-5. 根据表格中的 `模型ID` 列生成 `web/HotAI/dist/docs/model-info.md`。
+5. 根据表格中的 `模型ID` 列生成 `web/HotAI/dist/docs/user/103-model-info.md`。
 
 ## 文件说明
 
@@ -81,7 +81,7 @@ FEISHU_REDIRECT_URI=http://localhost:9000/
 FEISHU_WIKI_URL=https://pcn43kg7pnzs.feishu.cn/wiki/DG5cwq12EiuaQGk8UbtcaQKdnif
 FEISHU_DOC_OUTPUT=docs/feishu_content.txt
 FEISHU_SYNC_MODEL_INFO=true
-FEISHU_MODEL_INFO_PATH=web/HotAI/dist/docs/model-info.md
+FEISHU_MODEL_INFO_PATH=web/HotAI/dist/docs/user/103-model-info.md
 ```
 
 说明：
@@ -89,7 +89,7 @@ FEISHU_MODEL_INFO_PATH=web/HotAI/dist/docs/model-info.md
 - `FEISHU_WIKI_URL`：要抓取的飞书 Wiki 链接，也可以填写 Wiki token。
 - `FEISHU_DOC_OUTPUT`：保存原始抓取结果的路径。相对路径按仓库根目录解析。
 - `FEISHU_SYNC_MODEL_INFO`：是否在抓取后同步生成模型介绍页，默认 `true`。
-- `FEISHU_MODEL_INFO_PATH`：模型介绍页输出路径，默认 `web/HotAI/dist/docs/model-info.md`。
+- `FEISHU_MODEL_INFO_PATH`：模型介绍页输出路径，默认 `web/HotAI/dist/docs/user/103-model-info.md`。
 
 ### 可选配置
 
@@ -137,7 +137,7 @@ http://localhost:9000/auth
 文档标题: xxx
 文档类型: sheet
 文档 token: xxx
-模型介绍页已更新: /path/to/HotAI/web/HotAI/dist/docs/model-info.md
+模型介绍页已更新: /path/to/HotAI/web/HotAI/dist/docs/user/103-model-info.md
 文档内容已写入: /path/to/HotAI/docs/feishu_content.txt
 ```
 
@@ -288,13 +288,13 @@ python scripts/feishu/main.py check --input docs/feishu_content.txt
 执行更新后，检查以下文件：
 
 ```bash
-ls -l docs/feishu_content.txt web/HotAI/dist/docs/model-info.md
+ls -l docs/feishu_content.txt web/HotAI/dist/docs/user/103-model-info.md
 ```
 
 查看模型介绍页头部和前几个模型：
 
 ```bash
-sed -n '1,80p' web/HotAI/dist/docs/model-info.md
+sed -n '1,80p' web/HotAI/dist/docs/user/103-model-info.md
 ```
 
 如果本次更新正确，应看到：
diff --git a/scripts/feishu/main.py b/scripts/feishu/main.py
index 351990b..dabed5f 100644
--- a/scripts/feishu/main.py
+++ b/scripts/feishu/main.py
@@ -27,7 +27,7 @@
 SCRIPT_DIR = Path(__file__).resolve().parent
 REPO_ROOT = SCRIPT_DIR.parents[1]
 DEFAULT_WIKI_URL = "https://pcn43kg7pnzs.feishu.cn/wiki/DG5cwq12EiuaQGk8UbtcaQKdnif"
-DEFAULT_MODEL_INFO_PATH = "web/HotAI/dist/docs/model-info.md"
+DEFAULT_MODEL_INFO_PATH = "web/HotAI/dist/docs/user/103-model-info.md"
 
 
 def load_local_env():
diff --git a/scripts/feishu/oauth_server.py b/scripts/feishu/oauth_server.py
index bd780f2..9b314f9 100644
--- a/scripts/feishu/oauth_server.py
+++ b/scripts/feishu/oauth_server.py
@@ -7,6 +7,7 @@
 """
 
 from urllib.parse import urlencode
+import time
 
 from flask import Flask, redirect, request
 import requests
@@ -93,13 +94,14 @@ def auth():
     @app.route("/")
     def callback():
         # 飞书 OAuth 回调会携带 code 和 state，state 用于防止串改请求。
+        callback_time = time.strftime("%Y/%m/%d %H:%M:%S", time.localtime())
         code = request.args.get("code")
         state = request.args.get("state")
 
         if not code:
-            return "授权失败，未获取到授权码", 400
+            return f"授权失败，未获取到授权码<br>当前时间：{callback_time}", 400
         if state != config["oauth_state"]:
-            return "授权失败，state 不匹配", 400
+            return f"授权失败，state 不匹配<br>当前时间：{callback_time}", 400
 
         print(f"✅ 成功获取授权码: {code}")
 
@@ -112,7 +114,7 @@ def callback():
             )
         except Exception as exc:
             print(f"❌ 获取 Token 失败: {exc}")
-            return f"授权失败: {exc}", 400
+            return f"授权失败: {exc}<br>当前时间：{callback_time}", 400
 
         access_token = token_data["access_token"]
         print(f"✅ 获取 Token 成功: {access_token}")
@@ -121,13 +123,13 @@ def callback():
             config["save_user_access_token"](access_token)
 
         if not config["fetch_doc_after_auth"]:
-            return "授权成功！user_access_token 已打印到控制台，已跳过文档抓取。"
+            return f"授权成功！user_access_token 已打印到控制台，已跳过文档抓取。<br>当前时间：{callback_time}"
 
         try:
             node, content = fetch_doc_after_auth(access_token, config)
         except Exception as exc:
             print(f"❌ 文档抓取失败: {exc}")
-            return f"授权成功，但文档抓取失败: {exc}", 500
+            return f"授权成功，但文档抓取失败: {exc}<br>当前时间：{callback_time}", 500
 
         output_msg = (
             f"文档内容已写入 {config['doc_output']}"
@@ -138,6 +140,7 @@ def callback():
             f"授权成功，并已完成文档抓取！<br>"
             f"标题：{node['title']}<br>"
             f"内容长度：{len(content)} 字符<br>"
+            f"当前时间：{callback_time}<br>"
             f"{output_msg}"
         )
 
diff --git a/scripts/feishu/table_processor.py b/scripts/feishu/table_processor.py
index 4c72ec0..f0c8bc8 100644
--- a/scripts/feishu/table_processor.py
+++ b/scripts/feishu/table_processor.py
@@ -11,7 +11,7 @@
 
 MODEL_ID_COLUMN = "模型ID"
 MODEL_INFO_IGNORED_COLUMNS = {"编号", MODEL_ID_COLUMN}
-MODEL_INFO_HEADER = "# 模型总览\n\n本平台提供的模型及其属性如下（共{count}款）："
+MODEL_INFO_HEADER = "# 模型总览\n\n本平台提供的模型及其属性如下（**共 {count} 款**）："
 
 CHECK_REQUIRED_FIELD_ALIASES = (
     ("模型ID", ("模型ID", "名称", "模型名", "模型名称")),
diff --git a/web/HotAI/dist/assets/00-homepage.png b/web/HotAI/dist/assets/00-homepage.png
new file mode 100644
index 0000000..1f89f63
Binary files /dev/null and b/web/HotAI/dist/assets/00-homepage.png differ
diff --git a/web/HotAI/dist/assets/01-register.png b/web/HotAI/dist/assets/01-register.png
new file mode 100644
index 0000000..52f100a
Binary files /dev/null and b/web/HotAI/dist/assets/01-register.png differ
diff --git a/web/HotAI/dist/assets/02-login.png b/web/HotAI/dist/assets/02-login.png
new file mode 100644
index 0000000..f199365
Binary files /dev/null and b/web/HotAI/dist/assets/02-login.png differ
diff --git a/web/HotAI/dist/css/docs.css b/web/HotAI/dist/css/docs.css
index e750c59..019593e 100644
--- a/web/HotAI/dist/css/docs.css
+++ b/web/HotAI/dist/css/docs.css
@@ -362,6 +362,17 @@ body {
     margin: 16px 0;
 }
 
+#md-content .manual-screenshot {
+    display: block;
+    width: min(100%, 760px);
+    border: 1px solid var(--c-border);
+    box-shadow: var(--shadow-card);
+}
+
+#md-content .manual-screenshot-wide {
+    width: min(100%, 860px);
+}
+
 #md-content hr {
     border: none;
     border-top: 1px solid var(--c-border);
@@ -415,4 +426,4 @@ body {
     .docs-sidebar-left { width: 100%; max-height: 200px; border-bottom: 1px solid var(--c-border); }
     .docs-content { padding: 20px; }
     .doc-toolbar { flex-wrap: wrap; }
-}
\ No newline at end of file
+}
diff --git a/web/HotAI/dist/css/index.css b/web/HotAI/dist/css/index.css
index 6a6b3ae..1faa460 100644
--- a/web/HotAI/dist/css/index.css
+++ b/web/HotAI/dist/css/index.css
@@ -548,6 +548,7 @@ body {
 
 /* 调整长标题样式，防止视觉失衡 */
 .brand-logo {
+    display: block;
     font-size: 42px; /* 缩小字号以适应长文本 */
     font-weight: 900;
     letter-spacing: 1px;
@@ -559,6 +560,20 @@ body {
     max-width: 90%;
 }
 
+.brand-logo .brand-logo-line {
+    display: inline-block;
+    line-height: 1.15;
+}
+
+.brand-logo .brand-logo-cn {
+    font-size: 1em;
+}
+
+.brand-logo .brand-logo-en {
+    margin-top: 6px;
+    font-size: 0.72em;
+}
+
 /* 拉伸输入框宽度，配合长标题 */
 .input-container {
     width: 100%;
diff --git a/web/HotAI/dist/docs.html b/web/HotAI/dist/docs.html
index 56541b9..09752b1 100644
--- a/web/HotAI/dist/docs.html
+++ b/web/HotAI/dist/docs.html
@@ -108,23 +108,28 @@ <h3 data-i18n="notice.title">公告</h3>
             <span data-i18n="docs.search_shortcut">Ctrl K</span>
         </div>
 
-        <div class="menu-section-title" data-i18n="docs.section_intro">介绍</div>
+        <div class="menu-section-title" data-i18n="docs.section_users">我是用户</div>
         <div class="menu-list">
-            <a href="docs/quickstart.md" class="menu-item" data-i18n="docs.menu_quickstart">快速开始</a>
-            <a href="docs/intro.md" class="menu-item" data-i18n="docs.menu_intro">项目介绍</a>
-            <a href="docs/model-info.md" class="menu-item" data-i18n="docs.menu_model_info">模型总览</a>
-            <a href="docs/features.md" class="menu-item" data-i18n="docs.menu_features">特性说明</a>
-            <a href="docs/architecture.md" class="menu-item" data-i18n="docs.menu_architecture">技术架构</a>
-            <a href="docs/analytics.md" class="menu-item" data-i18n="docs.menu_analytics">分析工具设置指南</a>
-            <a href="docs/performance.md" class="menu-item" data-i18n="docs.menu_performance">性能分析设置指南</a>
-            <a href="docs/changelog.md" class="menu-item" data-i18n="docs.menu_changelog">更新日志</a>
+            <a href="docs/user/101-user-guide.md" class="menu-item" data-i18n="docs.menu_user_manual">用户手册</a>
+            <a href="docs/user/102-quickstart.md" class="menu-item" data-i18n="docs.menu_api_quickstart">API 快速开始</a>
+            <a href="docs/user/103-model-info.md" class="menu-item" data-i18n="docs.menu_model_info">模型总览</a>
+            <a href="docs/user/104-faq.md" class="menu-item" data-i18n="docs.menu_faq">FAQ 与常见报错</a>
         </div>
 
-        <div class="menu-section-title" data-i18n="docs.section_guides">功能指南</div>
+        <div id="docsAdminSection" class="hidden">
+            <div class="menu-section-title" data-i18n="docs.section_admins">我是管理员</div>
+            <div class="menu-list">
+                <a href="docs/admin/201-admin-guide.md" class="menu-item" data-i18n="docs.menu_admin_guide">管理员指南</a>
+            </div>
+        </div>
+
+        <div class="menu-section-title" data-i18n="docs.section_developers">我是开发者</div>
         <div class="menu-list">
-            <a href="docs/guide-overview.md" class="menu-item" data-i18n="docs.menu_guide_overview">功能指南概述</a>
-            <a href="docs/user-guide.md" class="menu-item" data-i18n="docs.menu_user_guide">用户指南</a>
-            <a href="docs/admin-guide.md" class="menu-item" data-i18n="docs.menu_admin_guide">管理员指南</a>
+            <a href="docs/developer/301-overview.md" class="menu-item" data-i18n="docs.menu_dev_overview">项目概览与开发规范</a>
+            <a href="docs/developer/302-deployment.md" class="menu-item" data-i18n="docs.menu_dev_deployment">部署与运维指南</a>
+            <a href="docs/developer/303-streaming.md" class="menu-item" data-i18n="docs.menu_dev_stream">流式输出排查与修复</a>
+            <a href="docs/developer/304-glossary.md" class="menu-item" data-i18n="docs.menu_dev_i18n">翻译术语表</a>
+            <a href="docs/developer/305-records-and-apis.md" class="menu-item" data-i18n="docs.menu_dev_records">项目记录与第三方接口</a>
         </div>
 
         <div class="sidebar-bottom">
@@ -179,6 +184,6 @@ <h3 data-i18n="notice.title">公告</h3>
 <script src="js/i18n.js"></script>
 <script src="js/api.js"></script>
 <script src="js/auth.js"></script>
-<script src="js/docs.js"></script>
+<script src="js/docs.js?v=202607230742"></script>
 </body>
-</html>
\ No newline at end of file
+</html>
diff --git a/web/HotAI/dist/docs/admin-guide.md b/web/HotAI/dist/docs/admin-guide.md
deleted file mode 100644
index dd42874..0000000
--- a/web/HotAI/dist/docs/admin-guide.md
+++ /dev/null
@@ -1,124 +0,0 @@
-# 管理员指南
-
-## 系统管理
-
-作为系统管理员，您需要负责 HotAI 的整体运维和配置。本节介绍系统管理的主要任务。
-
-### 访问管理后台
-
-使用管理员账号登录后，访问 `/admin` 路径进入管理后台。管理后台提供了完整的系统管理功能。
-
-### 系统配置
-
-在"系统设置"页面，您可以配置：
-
-- 系统名称和Logo
-- 用户注册开关和默认配额
-- 邮件服务器配置
-- OAuth 提供商配置
-- 安全策略（密码策略、会话超时等）
-
-## 用户管理
-
-在"用户管理"页面，您可以：
-
-- 查看所有用户列表和详细信息
-- 创建新用户或批量导入
-- 修改用户的角色和权限
-- 为用户充值或调整配额
-- 禁用或删除用户账户
-- 查看用户的使用记录和 API Key
-
-### 用户组管理
-
-通过用户组功能，您可以：
-
-- 创建部门或项目组
-- 为组设置独立的配额和权限
-- 批量管理组内用户
-- 查看组级别的使用统计
-
-## 渠道管理
-
-渠道管理是 HotAI 的核心功能之一。在"渠道管理"页面配置 AI 模型提供商。
-
-### 添加新渠道
-
-1. 点击"添加渠道"按钮
-2. 选择提供商类型（OpenAI、Claude、Gemini 等）
-3. 填写 API Key 和 Base URL
-4. 配置模型列表和优先级
-5. 设置速率限制和超时参数
-6. 启用该渠道
-
-### 渠道负载均衡
-
-对于同一个模型，您可以配置多个渠道实现负载均衡：
-
-- **轮询：**依次调用各个渠道
-- **优先级：**按优先级顺序调用
-- **权重：**按权重比例分配流量
-
-## 模型配置
-
-在"模型配置"页面，您可以：
-
-- 查看系统中所有可用的模型
-- 自定义模型的显示名称和描述
-- 配置模型的计费倍率
-- 启用或禁用特定模型
-- 设置模型的访问权限
-
-### 计费配置
-
-为不同模型配置计费规则：
-
-- 按 Token 计费（输入/输出分别计费）
-- 按次数计费
-- 按时长计费
-- 自定义计费表达式
-
-## 系统监控
-
-在"系统监控"页面，实时查看系统运行状态：
-
-- 实时 QPS 和响应时间
-- 各渠道的健康状态和成功率
-- 系统资源使用情况（CPU、内存、磁盘）
-- 数据库连接池状态
-- Redis 缓存命中率
-
-### 告警配置
-
-配置告警规则，在异常情况下及时收到通知：
-
-- 渠道不可用告警
-- 高错误率告警
-- 配额耗尽告警
-- 系统资源告警
-
-## 日志管理
-
-在"日志管理"页面，查看和分析系统日志：
-
-- **API 调用日志：**记录所有 API 请求和响应
-- **用户操作日志：**记录用户的操作行为
-- **系统日志：**记录系统事件和错误
-
-### 日志搜索和过滤
-
-使用强大的搜索功能快速定位问题：
-
-- 按用户、模型、时间范围搜索
-- 按状态码、错误类型过滤
-- 查看请求详情和响应内容
-- 导出日志用于离线分析
-
-## 系统设置
-
-在"系统设置"页面，配置系统的高级参数：
-
-- **性能优化：**goroutine 池大小、缓存策略
-- **安全策略：**IP 白名单、防 SSRF、请求签名
-- **数据保留：**日志保留期限、自动清理策略
-- **集成配置：**Webhook、Prometheus、Pyroscope
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/admin/201-admin-guide.md b/web/HotAI/dist/docs/admin/201-admin-guide.md
new file mode 100644
index 0000000..052b53a
--- /dev/null
+++ b/web/HotAI/dist/docs/admin/201-admin-guide.md
@@ -0,0 +1,105 @@
+# 管理员指南
+
+## 系统管理
+
+作为系统管理员，您需要负责图灵智算的整体运维和配置。本节介绍当前管理台已接入的主要入口和注意事项。
+
+### 访问管理后台
+
+使用管理员账号登录后，通过控制台侧边栏进入管理页面。当前管理功能拆分为多个页面，包括渠道管理、模型管理、用户管理、订阅管理、兑换码管理和系统设置。
+
+### 系统配置
+
+在"系统设置"页面，您可以配置：
+
+- 系统名称和 Logo。
+- 用户注册开关、密码登录开关和新用户默认额度。
+- GitHub OAuth、Turnstile 等配置项；是否生效以当前登录页、后端配置和实际接入情况为准。
+- 模型倍率、分组倍率、限流、缓存、SSRF 防护和性能指标等运行参数。
+
+密码复杂度、会话超时、完整 OAuth 提供商矩阵等高级策略不作为当前管理台已接入功能，相关能力以后端和页面实际支持为准。
+
+## 用户管理
+
+在"用户管理"页面，您可以：
+
+- 查看用户列表和用户详细信息。
+- 创建新用户。
+- 修改用户角色、状态、分组和额度。
+- 为用户充值或调整配额。
+- 禁用、解封或删除用户账户。
+- 批量封禁、批量解封或批量删除已选择用户。
+
+当前页面不提供用户批量导入；用户第三方绑定管理入口仍未开放。
+
+### 用户分组
+
+当前用户分组以用户记录中的分组字段和系统设置中的分组倍率、可用组配置为主。它可用于模型可用性、倍率和权限控制。
+
+当前管理台不提供独立的部门/项目组实体、组内成员批量管理或组级使用统计页面。
+
+## 渠道管理
+
+渠道管理是图灵智算的核心功能之一。在"渠道管理"页面配置 AI 模型提供商。
+
+### 添加新渠道
+
+1. 点击"添加渠道"按钮。
+2. 选择提供商类型。
+3. 填写 API Key 和 Base URL。
+4. 配置模型列表、优先级、标签和分组。
+5. 设置速率限制和超时参数。
+6. 启用该渠道。
+
+### 渠道负载均衡
+
+对于同一个模型，您可以配置多个渠道，由系统按当前路由策略进行分发。常见影响因素包括渠道状态、优先级、权重、标签、分组和成功率路由配置。
+
+## 模型配置
+
+在"模型管理"页面，您可以：
+
+- 查看和维护模型展示信息。
+- 自定义模型名称、描述、标签和图标。
+- 配置模型可用分组。
+- 维护模型预填分组，便于复用常见模型组合。
+
+### 计费配置
+
+在"系统设置"的计费相关区域，可以配置模型价格、倍率和计费表达式。实际计费结果以后台计费逻辑和调用日志为准。
+
+## 系统监控
+
+控制台和相关管理页面可查看平台运行状态与用量信息，包括：
+
+- 调用量、消耗额度和余额。
+- 模型与渠道维度的调用统计。
+- 响应时间和渠道响应时间排行。
+- 性能指标、内存和磁盘缓存相关信息。
+
+当前管理台不提供数据库连接池状态、Redis 缓存命中率等完整基础设施监控视图。
+
+### 告警配置
+
+当前后端告警检查主要覆盖平台成功率下降和模型不可用。渠道不可用、配额耗尽、系统资源等完整告警规则，需要以后端配置和实际接入情况为准。
+
+## 日志管理
+
+在"日志管理"页面，查看和分析调用日志：
+
+- **API 调用日志：** 记录用户、模型、Token、额度、耗时、渠道、分组、IP、请求 ID 等调用元数据。
+- **任务日志：** 查看异步任务或绘图相关任务记录。
+- **系统任务：** 查看系统任务执行结果。
+
+### 日志搜索和过滤
+
+日志页面支持按用户、模型、渠道、时间范围等条件定位调用记录。当前日志不通用保存完整请求体和完整响应体，不能作为请求/响应正文审计系统使用。
+
+## 系统设置
+
+在"系统设置"页面，配置系统高级参数：
+
+- **性能优化：** 缓存、性能指标、磁盘缓存和部分运行保护参数。
+- **安全策略：** 敏感词过滤、SSRF 防护、令牌数量和 API 速率限制。
+- **数据保留：** 日志记录开关和历史日志清理。
+- **集成配置：** 已接入的通知、监控或第三方功能配置。
diff --git a/web/HotAI/dist/docs/analytics.md b/web/HotAI/dist/docs/analytics.md
deleted file mode 100644
index 0b28e55..0000000
--- a/web/HotAI/dist/docs/analytics.md
+++ /dev/null
@@ -1,109 +0,0 @@
-# 分析工具设置指南
-
-## 概述
-
-HotAI 支持集成 Prometheus 和 Grafana 进行系统监控和数据分析。通过这些工具，您可以实时监控系统性能、API 调用情况、资源使用等关键指标，并通过可视化面板直观地展示数据趋势。
-
-本指南将帮助您完成 Prometheus 和 Grafana 的部署配置，建立完整的监控体系。
-
-## 配置 Prometheus
-
-### 1. 启用 Prometheus 指标
-
-在 HotAI 中启用 Prometheus 指标导出：
-yaml
-environment:
-
-ENABLE_PPROF=true
-
-### 2. 重启应用
-
-应用 pprof 配置后重启服务：
-
-bash
-docker compose restart hotai
-
-
-### 3. 验证
-
-访问 pprof 端点确认启用成功：
-
-bash
-curl http://localhost:6060/debug/pprof/
-
-
-成功访问后，您可以使用 go tool pprof 进行离线分析，或通过浏览器查看实时火焰图。
-
-## Pyroscope 设置
-
-### 1. 准备 Pyroscope 服务
-
-使用 Docker 部署 Pyroscope 服务器：
-
-bash
-docker run -d
--p 4040:4040
-–name pyroscope
-grafana/pyroscope:latest
-
-
-### 2. 配置环境变量
-
-在 HotAI 中启用 Pyroscope 集成：
-
-yaml
-environment:
-
-ENABLE_PYROSCOPE=true
-PYROSCOPE_SERVER_ADDRESS=http://pyroscope:4040
-PYROSCOPE_APPLICATION_NAME=hotai
-
-### 3. 重启应用
-
-应用配置后重启 HotAI：
-
-bash
-docker compose restart hotai
-
-
-### 4. 验证
-
-访问 Pyroscope Web UI 查看性能数据：
-
-- 打开浏览器访问：http://localhost:4040
-- 选择应用名称：hotai
-- 查看 CPU、内存、goroutine 等性能指标的火焰图
-
-## 故障排除
-
-### pprof 无法访问
-
-检查以下配置：
-
-- 确认 ENABLE_PPROF=true 已设置
-- 确认端口 6060 没有被占用
-- 检查防火墙设置
-
-### Pyroscope 连接失败
-
-可能的原因和解决方案：
-
-- Pyroscope 服务未启动：检查服务状态
-- 网络不通：确认 HotAI 可以访问 Pyroscope 服务地址
-- 配置错误：检查 PYROSCOPE_SERVER_ADDRESS 是否正确
-
-## 环境变量参考
-
-完整的性能分析相关环境变量：
-
-- **ENABLE_PPROF：**是否启用 pprof（默认 false）
-- **PPROF_PORT：**pprof 监听端口（默认 6060）
-- **ENABLE_PYROSCOPE：**是否启用 Pyroscope（默认 false）
-- **PYROSCOPE_SERVER_ADDRESS：**Pyroscope 服务器地址
-- **PYROSCOPE_APPLICATION_NAME：**应用名称标识
-
-## 相关链接
-
-- [Go pprof 官方文档](https://pkg.go.dev/net/http/pprof)
-- [Pyroscope 官方文档](https://grafana.com/oss/pyroscope/)
-- [pprof 使用指南](https://go.dev/blog/pprof)
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/architecture.md b/web/HotAI/dist/docs/architecture.md
deleted file mode 100644
index 720ac81..0000000
--- a/web/HotAI/dist/docs/architecture.md
+++ /dev/null
@@ -1,80 +0,0 @@
-# 技术架构
-
-## 系统架构概览
-
-HotAI 采用分层架构设计，清晰地分离了不同的职责和关注点。整体架构包括以下几层：
-
-- **路由层：** HTTP 路由和请求分发
-- **控制器层：** 请求处理和参数验证
-- **服务层：** 业务逻辑实现
-- **模型层：** 数据模型和数据库访问
-- **中继层：** AI 提供商适配和代理
-
-这种分层设计使得系统易于理解、测试和维护。每一层都有明确的职责边界，层与层之间通过接口进行通信。
-
-## 核心组件
-
-### 路由层（router/）
-
-负责 HTTP 请求的路由和分发，包括：
-
-- API 路由：处理 /v1/* 的 AI API 请求
-- 管理路由：处理后台管理相关请求
-- Web 路由：处理前端页面请求
-- 中继路由：处理 AI 提供商的请求代理
-
-### 中间件（middleware/）
-
-提供横切关注点的功能：
-
-- 认证中间件：JWT 验证、API Key 验证
-- 授权中间件：权限检查和访问控制
-- 速率限制：基于令牌桶的限流
-- 日志记录：请求日志和审计日志
-- CORS 处理：跨域资源共享
-
-### 中继层（relay/）
-
-最核心的组件之一，负责 AI 提供商的适配和代理：
-
-- 统一接口：将不同提供商的 API 统一为 OpenAI 格式
-- 请求转换：将标准请求转换为提供商特定格式
-- 响应转换：将提供商响应转换为标准格式
-- 流式处理：支持 SSE 流式响应
-- 错误处理：统一的错误处理和重试机制
-
-## 数据流
-
-一个典型的 API 请求会经过以下流程：
-
-1. **接收请求：** Gin 框架接收 HTTP 请求
-2. **路由匹配：** Router 将请求路由到对应的 Controller
-3. **中间件处理：** 依次经过认证、授权、限流等中间件
-4. **参数验证：** Controller 验证请求参数
-5. **业务处理：** Service 层执行业务逻辑
-6. **AI 代理：** Relay 层将请求转发给 AI 提供商
-7. **响应转换：** 将提供商响应转换为标准格式
-8. **计费扣费：** 根据使用量进行扣费
-9. **日志记录：** 记录请求和响应详情
-10. **返回响应：** 将结果返回给客户端
-
-## 扩展性设计
-
-HotAI 在设计时充分考虑了扩展性：
-
-- **水平扩展：** 支持多实例部署，通过负载均衡器分发流量
-- **数据库扩展：** 支持主从复制、读写分离
-- **缓存层：** 使用 Redis 缓存热点数据，减少数据库压力
-- **异步处理：** 使用 goroutine 和 channel 进行异步任务处理
-- **插件式架构：** 新增 AI 提供商只需实现统一接口
-
-## 安全架构
-
-安全是 HotAI 的重要设计考量：
-
-- **认证安全：** 支持 JWT、API Key、OAuth 等多种认证方式
-- **传输安全：** 强制使用 HTTPS，支持 TLS 1.2+
-- **数据安全：** 敏感数据加密存储，API Key 哈希保存
-- **访问控制：** 基于角色的访问控制（RBAC）
-- **防护机制：** 速率限制、IP 白名单、防 SSRF 攻击
-- **审计日志：** 完整记录所有操作，支持追溯和审计
diff --git a/web/HotAI/dist/docs/changelog.md b/web/HotAI/dist/docs/changelog.md
deleted file mode 100644
index 37af7d4..0000000
--- a/web/HotAI/dist/docs/changelog.md
+++ /dev/null
@@ -1,102 +0,0 @@
-# 更新日志
-
-## v1.0.0
-
-发布日期：2026-01-15
-
-### 🎉 重要特性
-
-- 正式发布 1.0 稳定版本
-- 全新的 React 19 前端界面
-- 支持 40+ AI 模型提供商
-- 完整的多租户管理系统
-
-### ✨ 新增功能
-
-- 新增 WebAuthn/Passkeys 认证支持
-- 新增 Prometheus 和 Grafana 集成
-- 新增性能分析工具（pprof、Pyroscope）
-- 新增自定义计费表达式系统
-- 新增审计日志导出功能
-
-### 🐛 问题修复
-
-- 修复 PostgreSQL 数据库兼容性问题
-- 修复流式响应中断的问题
-- 修复并发场景下的配额扣减错误
-- 修复 Redis 缓存穿透问题
-
-### ⚡ 性能优化
-
-- 优化数据库查询性能，降低 50% 延迟
-- 优化 Redis 缓存策略，提高命中率
-- 优化 goroutine 池管理
-
-## v0.9.0
-
-发布日期：2025-12-01
-
-### ✨ 新增功能
-
-- 新增 Claude 3.5 Sonnet 支持
-- 新增 Gemini 2.0 支持
-- 新增国内模型提供商支持（通义千问、文心一言）
-- 新增 API Key 自动轮换功能
-
-### 🐛 问题修复
-
-- 修复大文件上传超时问题
-- 修复多模态请求的参数解析
-- 修复统计数据不准确的问题
-
-### 📝 文档改进
-
-- 完善部署文档
-- 新增最佳实践指南
-- 新增常见问题解答
-
-## v0.8.0
-
-发布日期：2025-10-15
-
-### ✨ 新增功能
-
-- 新增模型回退（fallback）机制
-- 新增智能负载均衡
-- 新增请求重试策略配置
-- 新增 IP 白名单功能
-
-### 🐛 问题修复
-
-- 修复 SSE 连接泄漏问题
-- 修复令牌桶算法的精度问题
-- 修复用户配额统计不准确
-
-### ⚡ 性能优化
-
-- 优化中继层性能
-- 减少不必要的数据库查询
-- 优化内存使用
-
-## v0.7.0
-
-发布日期：2025-09-01
-
-### ✨ 新增功能
-
-- 新增 Docker Compose 一键部署
-- 新增环境变量配置支持
-- 新增健康检查端点
-- 新增优雅关闭机制
-
-### 🐛 问题修复
-
-- 修复并发写入导致的数据竞争
-- 修复 JWT 过期时间计算错误
-- 修复跨域请求配置问题
-
-### 📦 依赖更新
-
-- 升级 Go 至 1.22
-- 升级 GORM 至 v2 最新版本
-- 升级 Gin 框架
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/developer/301-overview.md b/web/HotAI/dist/docs/developer/301-overview.md
new file mode 100644
index 0000000..ab86f82
--- /dev/null
+++ b/web/HotAI/dist/docs/developer/301-overview.md
@@ -0,0 +1,176 @@
+# 项目概览与开发规范
+
+## 项目定位
+
+图灵智算是一个基于 Go 的 AI API 网关/代理系统，聚合 OpenAI、Claude、Gemini、Azure、AWS Bedrock 等 40+ 个上游 AI 提供商，向用户提供统一的 API 接口，并包含用户管理、计费、限流、日志和管理后台。
+
+项目基于 new-api 进行二次开发。涉及 Go module、import path、许可、版权、原项目说明等信息时，必须保留 new-api 与 QuantumNous 相关引用，不得删除或替换。
+
+## 核心能力
+
+- **多模型接入：** 统一接入国内外主流模型提供商。
+- **OpenAI 兼容接口：** 降低迁移成本，减少不同供应商 API 差异。
+- **多租户管理：** 支持用户、分组、权限、API Key 和配额管理。
+- **计费系统：** 支持按 Token、按次、动态表达式等计费方式。
+- **速率限制：** 支持用户、模型、渠道和系统级限流。
+- **审计日志：** 记录 API 调用、用户操作和管理动作，便于排障和合规。
+- **运维能力：** 支持 Redis 缓存、性能分析、日志和健康检查。
+
+## 使用场景
+
+个人开发者可以使用图灵智算快速接入多个模型提供商，无需为每家供应商单独编写适配逻辑。
+
+企业团队可以通过图灵智算统一管理团队内的 API Key、额度、模型权限、审计日志和成本。
+
+SaaS 平台可以把图灵智算作为后端 AI 服务聚合层，通过账户、分组和计费能力支撑商业化。
+
+## 架构分层
+
+项目采用分层架构：
+
+```text
+客户端请求
+  -> Router（路由层）
+  -> Middleware（中间件）
+  -> Controller（控制器层）
+  -> Service（业务逻辑层）
+  -> Model（数据层）
+  -> Relay（AI 提供商适配和代理）
+  -> 上游模型服务
+```
+
+**主要职责：**
+
+- **`router/`：** HTTP 路由定义，包括 API、relay、dashboard、web。
+- **`middleware/`：** 认证、授权、限流、CORS、日志、请求分发。
+- **`controller/`：** 请求处理、参数验证和响应封装。
+- **`service/`：** 业务逻辑、计费、渠道选择、事务处理。
+- **`model/`：** GORM 模型和数据库访问。
+- **`relay/`：** AI API 转发/代理引擎。
+- **`relay/channel/`：** 各供应商适配器，例如 `openai/`、`claude/`、`gemini/`、`aws/`。
+- **`setting/`：** 配置管理，包括倍率、模型、操作、系统、性能配置。
+- **`common/`：** 共享工具，包括 JSON、加密、Redis、环境变量、限流等。
+- **`dto/`：** 请求和响应结构体。
+- **`constant/`：** API 类型、渠道类型、上下文键等常量。
+- **`types/`：** relay 格式、文件源、错误等类型。
+- **`i18n/`：** 后端国际化。
+- **`oauth/`：** OAuth 提供商实现。
+- **嵌入静态前端目录：** 当前嵌入并实际服务的图灵智算静态前端，包括 HTML、CSS、JavaScript 和 Markdown 文档。
+- **`web/default/`：** new-api 上游 React 19 + Rsbuild + Base UI + Tailwind CSS 前端，当前不作为图灵智算嵌入前端入口。
+- **`web/classic/`：** new-api 上游 React 18 + Vite + Semi Design 经典前端，当前不作为图灵智算嵌入前端入口。
+
+## 典型请求链路
+
+一个典型的 API 请求会经过：
+
+1. Gin 接收 HTTP 请求。
+2. Router 匹配到对应 API 或 relay 路由。
+3. Middleware 执行认证、授权、限流和日志逻辑。
+4. Controller 验证参数并构造上下文。
+5. Service 执行业务逻辑，包括渠道选择、配额校验和计费预处理。
+6. Relay 将统一请求转换为上游供应商格式。
+7. 上游响应返回后，Relay 转换为统一响应格式。
+8. Service 结算实际用量并写入日志。
+9. Controller 将结果返回给客户端。
+
+## 技术栈
+
+- **后端：** Go 1.22+、Gin、GORM v2。
+- **数据库：** SQLite、MySQL、PostgreSQL。
+- **缓存：** Redis + 内存缓存。
+- **认证：** 后台用户登录使用 Gin session/cookie，API 调用使用 Bearer API Key；OAuth、Passkey、2FA 等能力以后端路由和当前前端接入状态为准。
+- **当前运行前端：** 嵌入静态 HTML、CSS、JavaScript。
+- **上游参考前端：** `web/default` 和 `web/classic` 保留在仓库中，但当前二进制嵌入的不是这两套前端。
+- **前端包管理器：** 当前静态前端不依赖包管理器；维护 `web/default` 上游 React 前端时使用 Bun。
+
+## 开发规范
+
+### JSON 处理
+
+业务代码中的 JSON marshal/unmarshal 必须使用 `common/json.go` 的包装函数：
+
+```go
+common.Marshal(v any) ([]byte, error)
+common.Unmarshal(data []byte, v any) error
+common.UnmarshalJsonStr(data string, v any) error
+common.DecodeJson(reader io.Reader, v any) error
+common.GetJsonType(data json.RawMessage) string
+```
+
+不要在业务代码中直接调用 `encoding/json` 的 marshal/unmarshal 函数。`json.RawMessage`、`json.Number` 等类型仍可作为类型引用。
+
+### 数据库兼容
+
+所有数据库代码必须同时支持 SQLite、MySQL 5.7.8+ 和 PostgreSQL 9.6+。
+
+- 优先使用 GORM 方法，避免 raw SQL。
+- raw SQL 必须处理方言差异，包括字段引号、布尔值和保留字。
+- `group`、`key` 等保留字字段使用 `commonGroupCol`、`commonKeyCol`。
+- 主库/日志库分支使用 `common.UsingMainDatabase(...)`、`common.UsingLogDatabase(...)`。
+- 迁移必须在三类数据库上都能运行。
+
+### Relay 适配
+
+新增或修改供应商适配器时：
+
+- 请求结构体中从客户端 JSON 解析并转发给上游的可选标量字段，必须使用指针类型配合 `omitempty`。
+- 显式零值必须保留。例如客户端传入 `0`、`0.0`、`false` 时不能被误删。
+- 如果供应商支持 `StreamOptions`，需要加入 `streamSupportedChannels`。
+- 不要为了单个渠道把错误的协议语义写入通用逻辑。
+
+示例：
+
+```go
+type Request struct {
+	Temperature *float64 `json:"temperature,omitempty"`
+	MaxTokens   *uint    `json:"max_tokens,omitempty"`
+	Stream      *bool    `json:"stream,omitempty"`
+}
+```
+
+### 计费表达式
+
+涉及分层定价、动态计费、Token 归一化或表达式版本时，先阅读：
+
+```text
+pkg/billingexpr/expr.md
+```
+
+计费改动必须保护额度扣减、结算、退款和审计日志等真实业务不变量。
+
+### 国际化
+
+**后端国际化：**
+
+- **库：** `nicksnyder/go-i18n/v2`。
+- **语言：** `en`、`zh`。
+
+**前端国际化：**
+
+- 当前图灵智算静态前端使用嵌入静态前端中的 `js/i18n.js`。
+- `web/default` 的 React i18n 体系使用 `i18next`、`react-i18next` 和 `web/default/src/i18n/locales/{lang}.json`，仅适用于维护该上游前端时参考。
+
+### 测试
+
+后端测试应保护真实行为、API 契约、计费/accounting 不变量、数据库兼容性或回归路径。
+
+- 新测试使用 `github.com/stretchr/testify/require` 做 setup 和 fatal assertion。
+- 使用 `github.com/stretchr/testify/assert` 做非 fatal 值检查。
+- 优先确定性表驱动测试。
+- 避免仅提高覆盖率、随机输入、睡眠、日志型断言或重复测试。
+
+### 前端开发
+
+当前图灵智算前端在嵌入静态前端目录下维护，修改 HTML、CSS、JavaScript 或 Markdown 后，需要重建后端二进制或镜像，使 Go embed 使用最新静态资源。
+
+仅在维护 `web/default/` 上游 React 前端时使用：
+
+```bash
+cd web/default
+bun install
+bun run dev
+bun run build
+bun run i18n:sync
+```
+
+当前图灵智算静态前端的用户可见文本，应尽量沿用现有 `data-i18n` 和嵌入静态前端中的 `js/i18n.js` 机制。维护 `web/default` 上游 React 前端时，详细约束以 `web/default/AGENTS.md` 为准。
diff --git a/web/HotAI/dist/docs/developer/302-deployment.md b/web/HotAI/dist/docs/developer/302-deployment.md
new file mode 100644
index 0000000..9742f86
--- /dev/null
+++ b/web/HotAI/dist/docs/developer/302-deployment.md
@@ -0,0 +1,243 @@
+# 部署与运维指南
+
+## 本地运行方式
+
+### 路线 A：SQLite 快速体验
+
+适合快速启动，不依赖 Docker。
+
+1. 安装 Go。
+
+Go 建议使用项目当前支持的版本。安装后确认：
+
+```bash
+go version
+```
+
+当前图灵智算运行前端由 Go embed 嵌入后端二进制。仅修改这套静态前端时，不需要单独启动 React/Rsbuild 前端。
+
+2. 编译并运行后端。
+
+```bash
+cd ~/projects/<your-project-dir>
+go build -o new-api .
+./new-api
+```
+
+**默认监听：**
+
+```text
+http://localhost:3000
+```
+
+首次启动会自动创建 SQLite 数据库文件。初始 root 密码会打印在终端日志里。
+
+### 路线 B：开发模式
+
+适合日常开发。后端、PostgreSQL、Redis 使用 Docker Compose，当前图灵智算静态前端由后端直接服务。
+
+**启动后端、数据库和 Redis：**
+
+```bash
+cd ~/projects/<your-project-dir>
+docker compose -f docker-compose.dev.yml up -d --build
+```
+
+**查看后端日志：**
+
+```bash
+docker compose -f docker-compose.dev.yml logs -f new-api
+```
+
+**访问地址：**
+
+```text
+图灵智算：http://localhost:3000
+```
+
+如果专门维护 `web/default` 上游 React 前端，可单独使用 Bun 和 Rsbuild dev server；这不是当前图灵智算嵌入前端的默认开发方式。
+
+**后续开发常用命令：**
+
+```bash
+# Go 代码或嵌入静态资源变更后，重建后端镜像
+docker compose -f docker-compose.dev.yml up -d --build new-api
+
+# 静态资源缓存异常时，强制无缓存重建
+docker compose -f docker-compose.dev.yml build --no-cache new-api
+docker compose -f docker-compose.dev.yml up -d new-api
+
+# 停止服务
+docker compose -f docker-compose.dev.yml down
+
+# 清空数据卷后重来
+docker compose -f docker-compose.dev.yml down -v
+```
+
+### 路线 C：完整 Docker Compose
+
+适合完整测试或接近生产的本地验证。
+
+```bash
+cd ~/projects/<your-project-dir>
+cp .env.example .env
+docker compose up -d
+```
+
+**访问：**
+
+```text
+http://localhost:2000
+```
+
+## 远程部署流程
+
+### 1. 本地验证
+
+本地开发和测试通过后再构建远程镜像。
+
+后端 Go 代码或嵌入静态资源改动需要重建后端：
+
+```bash
+docker compose -f docker-compose.dev.yml up -d --build new-api
+```
+
+### 2. 构建镜像
+
+建议使用 git tag 或 commit hash 管理镜像 tag。
+
+```bash
+export APP_IMAGE=ghcr.io/betterlol/hotai:版本号
+docker compose -f docker-compose.build.yml build
+```
+
+也可以使用当前 commit：
+
+```bash
+export APP_IMAGE=ghcr.io/betterlol/hotai:$(git rev-parse --short HEAD)
+docker compose -f docker-compose.build.yml build
+```
+
+### 3. 推送镜像
+
+```bash
+export APP_IMAGE=ghcr.io/betterlol/hotai:版本号
+docker login ghcr.io
+docker compose -f docker-compose.build.yml push
+```
+
+### 4. 远程拉取并启动
+
+登录远程服务器后，进入部署目录，修改 `.env` 中的 `APP_IMAGE`，然后执行：
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+## 常见构建问题
+
+### 拉取 Docker 基础镜像失败
+
+**典型错误：**
+
+```text
+ERROR [internal] load metadata for docker.io/library/debian:bookworm-slim
+```
+
+**处理方式：**
+
+- 检查网络和代理。
+- 必要时配置 Docker registry mirrors。
+- 在受限网络下，通常需要可访问 Docker Hub 的网络环境。
+
+**示例 Docker Engine registry mirror 配置：**
+
+```json
+{
+  "registry-mirrors": [
+    "https://docker.m.daocloud.io",
+    "https://dockerproxy.com"
+  ]
+}
+```
+
+### 卡在 `go mod download`
+
+可配置 Go 代理：
+
+```bash
+go env -w GOPROXY=https://goproxy.cn,direct
+go env -w GOSUMDB=sum.golang.google.cn
+```
+
+Docker 构建时也可以通过 compose build args 使用 `GOPROXY`。
+
+## 性能分析
+
+图灵智算支持 pprof 和 Pyroscope 两类性能分析能力：
+
+- **pprof：** 适合临时诊断与离线分析。
+- **Pyroscope：** 适合线上持续分析与火焰图可视化。
+
+### pprof
+
+**配置环境变量：**
+
+```yaml
+environment:
+  ENABLE_PPROF: "true"
+```
+
+**重启服务：**
+
+```bash
+docker compose restart new-api
+```
+
+**验证：**
+
+```bash
+curl http://localhost:8005/debug/pprof/
+```
+
+pprof 监听端口当前在代码中固定为 `8005`。容器部署时需要映射该端口。
+
+### Pyroscope
+
+**启动 Pyroscope：**
+
+```bash
+docker run -d \
+  -p 4040:4040 \
+  --name pyroscope \
+  grafana/pyroscope:latest
+```
+
+**配置图灵智算：**
+
+```yaml
+environment:
+  PYROSCOPE_URL: "http://pyroscope:4040"
+  PYROSCOPE_APP_NAME: "hotai"
+```
+
+**重启后访问：**
+
+```text
+http://localhost:4040
+```
+
+## 性能分析故障排查
+
+**pprof 无法访问时：**
+
+- 确认 `ENABLE_PPROF=true`。
+- 确认 `8005` 端口已映射且未被占用。
+- 检查容器端口映射、防火墙和反向代理配置。
+
+**Pyroscope 连接失败时：**
+
+- 确认 Pyroscope 服务已启动。
+- 确认图灵智算容器能访问 `PYROSCOPE_URL`。
+- 检查应用名称和网络配置。
diff --git a/web/HotAI/dist/docs/developer/303-streaming.md b/web/HotAI/dist/docs/developer/303-streaming.md
new file mode 100644
index 0000000..b3e6111
--- /dev/null
+++ b/web/HotAI/dist/docs/developer/303-streaming.md
@@ -0,0 +1,160 @@
+# 流式输出排查与修复
+
+## Stream 处理链路
+
+流式输出处理分三层，从外到内排查。
+
+### 第一层：通用 SSE 扫描器
+
+**位置：**
+
+```text
+relay/helper/stream_scanner.go
+```
+
+**核心入口：**
+
+```text
+StreamScannerHandler()
+```
+
+**职责：**
+
+- 从上游 HTTP 响应读取 SSE 行。
+- 解析 `data:` 前缀。
+- 处理超时、ping、goroutine 生命周期。
+- 控制流式读取是否继续。
+
+如果流根本没有数据、中途断掉或一直挂起，优先检查这一层。
+
+### 第二层：OpenAI 格式流处理
+
+**位置：**
+
+```text
+relay/channel/openai/relay-openai.go
+relay/channel/openai/helper.go
+```
+
+**核心入口：**
+
+```text
+OaiStreamHandler()
+HandleStreamFormat()
+handleLastResponse()
+```
+
+**职责：**
+
+- 逐帧处理 `ChatCompletionsStreamResponse`。
+- 处理 reasoning/thinking content 和 `<think>` 标签转换。
+- 提取最终 usage。
+- 发送 `[DONE]`。
+
+如果输出内容乱码、usage 不对、thinking 标签异常或 OpenAI 兼容渠道普遍异常，重点看这一层。
+
+### 第三层：渠道专属适配器
+
+**位置：**
+
+```text
+relay/channel/<provider>/relay-<name>.go
+```
+
+**例如 Claude 走：**
+
+```text
+relay/channel/claude/relay-claude.go
+```
+
+如果只有某个供应商复现，先看对应渠道的 relay 文件和 stream handler。
+
+## 排查顺序
+
+1. 打开 debug 日志，查看 stream scanner 收到的原始 `data:` 内容，确认上游是否正常返回。
+2. 如果原始数据正常，检查 `OaiStreamHandler()`、`HandleStreamFormat()` 和 `handleLastResponse()`。
+3. 如果只有特定渠道异常，直接检查 `relay/channel/<provider>/` 下的适配器。
+4. 如果流挂起或超时，检查 `stream_scanner.go` 中 timeout、stop channel 和 goroutine 生命周期。
+
+## UTF-8 流式乱码问题
+
+### 现象
+
+OpenAI 兼容流式请求可能失败并出现：
+
+```text
+stream_non_json_chunk
+```
+
+**客户端收到类似被截断的 JSON 前缀：**
+
+```text
+{"choices":[{"delta":{"reasoning_content":"...
+```
+
+网关日志可能随后记录 `client_gone`，因为客户端无法解码 SSE data block 后停止读取。
+
+### 根因
+
+relay 输出 `Content-Type: text/event-stream` 时没有声明 charset。
+
+**一些客户端使用：**
+
+```python
+requests.iter_lines(decode_unicode=True)
+```
+
+如果响应头没有声明 UTF-8，客户端可能使用单字节编码。中文 UTF-8 字节被错误解释后，单个 JSON SSE 事件会被拆成多行，最终导致客户端认为收到非 JSON 数据块。
+
+`helper.SetEventStreamHeaders` 设置过预期 header，但第一次 `common.CustomEvent` render 会写出不带 charset 的值。因此两个路径都必须声明 UTF-8。
+
+### 修复要求
+
+**所有 SSE 响应统一使用：**
+
+```http
+Content-Type: text/event-stream; charset=utf-8
+```
+
+**需要覆盖两个可能写 SSE header 的位置：**
+
+- **`relay/helper/common.go`：** `SetEventStreamHeaders`
+- **`common/custom-event.go`：** `CustomEvent.WriteContentType`
+
+共享 stream scanner 还需要在遇到格式异常的上游 continuation data 时，避免把物理拆分的 JSON data line 继续错误转发给客户端。
+
+## 验证
+
+**重建并启动本地后端：**
+
+```bash
+docker compose -f docker-compose.dev.yml up -d --build new-api
+```
+
+**检查流式响应 header：**
+
+```text
+Content-Type: text/event-stream; charset=utf-8
+```
+
+**确认每个 `data:` payload 都是合法 JSON，直到收到：**
+
+```text
+[DONE]
+```
+
+**运行 relay 单元测试：**
+
+```bash
+go test ./relay/...
+```
+
+**如果需要跑外部 B 样例回归测试，确认生成结果中：**
+
+```json
+{
+  "success_count": 5,
+  "failed_count": 0,
+  "success_rate_percent": 100
+}
+```
diff --git a/web/HotAI/dist/docs/developer/304-glossary.md b/web/HotAI/dist/docs/developer/304-glossary.md
new file mode 100644
index 0000000..cf2581c
--- /dev/null
+++ b/web/HotAI/dist/docs/developer/304-glossary.md
@@ -0,0 +1,96 @@
+# 翻译术语表
+
+## 使用原则
+
+- 翻译应保持项目术语一致，优先使用本表标准译法。
+- 原文存在技术术语时，可以保留行业通用英文。
+- 原文包含 emoji 时，翻译可保留 emoji。
+- UI、文档、错误信息和配置项翻译应避免同一概念多种译法混用。
+
+## 核心概念
+
+| 中文 | English | Français | Русский | 说明 |
+| ---- | ---- | ---- | ---- | ---- |
+| 倍率 | Ratio | Ratio | Коэффициент | 用于计算价格的乘数因子；计费 UI 中优先使用该译法 |
+| 令牌 | Token | Jeton | Токен | API 访问凭证，也指模型处理的文本单元 |
+| 渠道 | Channel | Canal | Канал | API 服务提供商的接入通道 |
+| 分组 | Group | Groupe | Группа | 用户或令牌的分类，影响价格倍率 |
+| 额度 | Quota | Quota | Квота | 用户可用的服务额度 |
+
+## 模型相关
+
+| 中文 | English | Français | Русский | 说明 |
+| ---- | ---- | ---- | ---- | ---- |
+| 提示 | Prompt | Invite | Промпт/Ввод | 模型输入内容；不同语言可按交互或技术语境选择 |
+| 补全 | Completion | Complétion | Вывод | 模型输出内容 |
+| 输入 | Input/Prompt | Entrée | Ввод | 发送给模型的内容 |
+| 输出 | Output/Completion | Sortie | Вывод | 模型返回的内容 |
+| 模型倍率 | Model Ratio | Ratio du modèle | Коэффициент модели | 不同模型的计费倍率 |
+| 补全倍率 | Completion Ratio | Ratio de complétion | Коэффициент вывода | 输出内容的额外计费倍率 |
+| 固定价格 | Price per call | Prix fixe | Цена за запрос | 每次调用固定价格 |
+| 按量计费 | Pay-as-you-go | Paiement à l'utilisation | Оплата по объему | 根据使用量计费 |
+| 按次计费 | Pay-per-view | Paiement par appel | Оплата за запрос | 按调用次数计费 |
+
+## 用户与账户
+
+| 中文 | English | Français | Русский | 说明 |
+| ---- | ---- | ---- | ---- | ---- |
+| 超级管理员 | Root User | Super-administrateur | Суперадминистратор | 最高权限管理员 |
+| 管理员 | Admin User | Administrateur | Администратор | 系统管理员 |
+| 普通用户 | Normal User | Utilisateur normal | Обычный пользователь | 普通权限用户 |
+| 充值 | Top Up | Recharge | Пополнение | 为账户增加额度 |
+| 兑换码 | Redemption Code | Code d'échange | Код купона | 可兑换额度的代码 |
+
+## 渠道管理
+
+| 中文 | English | Français | Русский | 说明 |
+| ---- | ---- | ---- | ---- | ---- |
+| 渠道 | Channel | Canal | Канал | API 服务提供通道 |
+| 密钥 | Key | Clé | Ключ | API 访问密钥的通用说法 |
+| API 密钥 | API Key | Clé API | API ключ | API 访问密钥 |
+| 优先级 | Priority | Priorité | Приоритет | 渠道选择优先级 |
+| 权重 | Weight | Poids | Вес | 负载均衡权重 |
+| 代理 | Proxy | Proxy | Прокси | 代理服务器地址 |
+| 模型重定向 | Model Mapping | Redirection de modèle | Перенаправление модели | 请求体中模型名称替换 |
+| 供应商 | Provider/Vendor | Fournisseur | Поставщик | 提供 API 或模型服务的组织或服务 |
+
+## 安全与计费
+
+| 中文 | English | Français | Русский | 说明 |
+| ---- | ---- | ---- | ---- | ---- |
+| 两步验证 | Two-Factor Authentication | Authentification à deux facteurs | Двухфакторная аутентификация | 为账户提供额外安全保护的验证方式 |
+| 2FA | Two-Factor Authentication | 2FA | 2FA | 两步验证缩写 |
+| 倍率 | Multiplier | Multiplicateur | Множитель | `Ratio` 的同义词；计费 UI 中优先使用核心概念中的译法 |
+
+## 翻译注意
+
+### 英语
+
+- **`Prompt`：** 指模型输入内容。
+- **`Completion`：** 指模型输出内容。
+- **`Ratio`：** 用于计费倍率语境；`Multiplier` 可作为解释性同义词，但 UI 中优先使用 `Ratio`。
+- **`Token`：** 需要结合上下文区分 API Token、文本 Token 和系统 Access Token。
+
+### 法语
+
+- **用户体验和 LLM 交互语境：** 使用 `Invite`。
+- **技术流程或计费语境：** 使用 `Entrée`。
+- **`Completion`：** 统一译为 `Complétion`，不要使用 `Achèvement` 或 `Finalisation`。
+- **API 访问密钥：** 使用 `Clé API`，不要译为 `Jeton API`。
+- **复数形式、语法一致性和技术术语性别：** 翻译时需要注意。
+
+### 俄语
+
+- **LLM 交互语境：** 使用 `Промпт`。
+- **技术流程或计费语境：** 使用 `Ввод`。
+- **`Completion`：** 统一译为 `Вывод`，不要使用容易和完成动作混淆的译法。
+- **API 访问密钥：** 使用 `API ключ`，不要译为 `API токен`。
+- **复数形式、格变化和技术术语性别：** 翻译时需要注意。
+
+## 术语选择说明
+
+- **`Prompt`：** 在用户交互中可译为“提示”，在计费或技术数据流中可译为“输入”。
+- **`Completion`：** 统一指模型输出。
+- **`Ratio`：** 在计费语境中优先译为“倍率”。
+- **`Quota`：** 指用户可用额度，也可能在部分上下文中表达为 credit。
+- **`Token`：** 需要结合上下文区分 API Token、文本 Token 和系统 Access Token。
diff --git a/web/HotAI/dist/docs/developer/305-records-and-apis.md b/web/HotAI/dist/docs/developer/305-records-and-apis.md
new file mode 100644
index 0000000..b140a59
--- /dev/null
+++ b/web/HotAI/dist/docs/developer/305-records-and-apis.md
@@ -0,0 +1,31 @@
+# 项目记录与第三方接口
+
+## 历史占位更新记录
+
+原前端文档中曾包含一组占位式版本更新记录。这些内容仅能作为历史来源参考，不代表当前图灵智算已实现功能。当前功能说明应以实际代码、真实 git tag、GitHub Releases、PR 记录和管理台页面为准。
+
+以下条目不要作为当前版本能力声明：
+
+- **React 19 前端界面：** 当前实际嵌入并服务的是图灵智算静态前端。
+- **WebAuthn/Passkeys 登录：** 后端保留相关路由，但当前图灵智算登录页未接入完整登录流程。
+- **Prometheus 和 Grafana 集成：** Prometheus 指标接口可按后端实际路由确认，Grafana 集成不作为当前文档承诺。
+- **API Key 自动轮换：** 当前文档不声明已实现。
+- **优雅关闭机制：** 当前文档不声明已实现。
+- **JWT 用户登录态：** 当前后台用户登录态使用 Gin session/cookie，不以 JWT 作为主登录态。
+
+如需发布版本说明，请基于真实变更重新整理，不要直接沿用占位更新记录。
+
+## io.net 接口调试记录
+
+**原始记录：**
+
+```text
+Request URL
+https://api.io.solutions/v1/io-cloud/clusters/654fc0a9-0d4a-4db4-9b95-3f56189348a2/update-name
+Request Method
+PUT
+
+{"status":"succeeded","message":"Cluster name updated successfully"}
+```
+
+该记录仅用于追踪一次外部接口调试结果，不属于用户前端文档。
diff --git a/web/HotAI/dist/docs/features.md b/web/HotAI/dist/docs/features.md
deleted file mode 100644
index 3bddcb2..0000000
--- a/web/HotAI/dist/docs/features.md
+++ /dev/null
@@ -1,74 +0,0 @@
-# 特性说明
-
-## 多模型支持
-
-HotAI 支持 40+ 主流 AI 模型提供商，包括但不限于：
-
-- OpenAI (GPT-4, GPT-3.5, DALL-E, Whisper)
-- Anthropic Claude (Claude 3 系列)
-- Google Gemini (Gemini Pro, Gemini Ultra)
-- Azure OpenAI Service
-- AWS Bedrock (Claude, Llama, Titan)
-- 阿里云通义千问、百度文心一言、讯飞星火等国内模型
-
-所有模型通过统一的 API 接口访问，无需针对每个提供商编写不同的代码。支持文本生成、对话、图像生成、语音识别等多种 AI 能力。
-
-## 统一 API 接口
-
-HotAI 完全兼容 OpenAI API 规范，这意味着：
-
-- 只需修改 API 端点和 Key，即可从 OpenAI 无缝迁移
-- 支持流式响应（Server-Sent Events）
-- 支持 Function Calling 和 Tools
-- 支持自定义参数（temperature、top_p、max_tokens 等）
-- bash
-  curl https://your-hotai-domain/v1/chat/completions
-  -H “Authorization: Bearer YOUR_API_KEY”
-  -H “Content-Type: application/json”
-  -d ‘{
-  “model”: “gpt-4”,
-  “messages”: [{“role”: “user”, “content”: “Hello!”}]
-  }’
-
-
-## 用户管理
-
-完善的多租户用户管理系统：
-
-- **用户注册与认证：**支持邮箱注册、OAuth 登录（GitHub、Google 等）
-- **组织管理：**支持创建多个组织，每个组织独立管理用户和资源
-- **角色权限：**管理员、普通用户、只读用户等多级权限
-- **API Key 管理：**用户可创建多个 API Key，设置不同的权限和配额
-
-## 计费系统
-
-灵活的计费和配额管理：
-
-- 支持按次数、按 Token、按时长等多种计费模式
-- 支持预付费和后付费
-- 实时扣费，精确到每次 API 调用
-- 支持充值、赠送、退款等操作
-- 配额预警和自动限流
-- 详细的账单和消费记录
-
-## 速率限制
-
-多维度的速率限制和流量控制：
-
-- **全局限流：**限制整个系统的 QPS
-- **用户限流：**为每个用户设置不同的速率限制
-- **模型限流：**针对不同模型设置不同的调用频率
-- **IP 限流：**防止恶意攻击和滥用
-- **令牌桶算法：**支持突发流量，提供更好的用户体验
-
-## 审计日志
-
-完整的操作审计和日志记录：
-
-- 记录所有 API 调用的详细信息（请求参数、响应结果、耗时等）
-- 记录用户的操作行为（登录、创建 Key、修改配置等）
-- 支持日志搜索和过滤
-- 支持日志导出和归档
-- 可配置日志保留策略
-
-审计日志可用于问题排查、成本分析、合规审计等多种场景。
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/guide-overview.md b/web/HotAI/dist/docs/guide-overview.md
deleted file mode 100644
index 805952d..0000000
--- a/web/HotAI/dist/docs/guide-overview.md
+++ /dev/null
@@ -1,74 +0,0 @@
-# 功能指南概述
-
-## 功能概览
-
-HotAI 提供了丰富的功能来帮助用户和管理员高效地使用和管理 AI API 服务。本指南将带您了解系统的主要功能模块，无论您是普通用户还是系统管理员，都能快速找到所需的操作指导。
-
-功能指南分为两个主要部分：
-
-- **用户指南：**面向使用 API 服务的普通用户
-- **管理员指南：**面向负责系统管理和配置的管理员
-
-## 快速导航
-
-### 对于普通用户
-
-如果您是使用 HotAI API 服务的开发者或用户，请查看 [用户指南](user-guide.md)，了解如何：
-
-- 注册账户和登录系统
-- 创建和管理 API Key
-- 调用 AI API 接口
-- 查看使用量和费用统计
-- 管理个人账户设置
-
-### 对于系统管理员
-
-如果您是 HotAI 系统的管理员，请查看 [管理员指南](admin-guide.md)，了解如何：
-
-- 管理用户和组织
-- 配置 AI 模型提供商
-- 设置计费规则和配额
-- 监控系统运行状态
-- 查看和导出审计日志
-- 配置系统参数和安全策略
-
-## 使用场景
-
-### 场景一：个人开发者
-
-您是一位独立开发者，想要在自己的应用中集成 AI 功能。您可以：
-
-1. 注册 HotAI 账户
-2. 创建一个 API Key
-3. 参考 API 文档进行集成
-4. 通过控制台实时查看调用情况和费用
-
-### 场景二：企业团队
-
-您是企业的技术负责人，需要为团队提供统一的 AI API 服务。您可以：
-
-1. 部署私有化的 HotAI 实例
-2. 为不同团队创建独立的用户组
-3. 为每个团队分配配额和权限
-4. 配置多个 AI 提供商实现负载均衡
-5. 通过监控面板实时掌握使用情况
-
-### 场景三：SaaS 平台
-
-您正在构建一个 AI SaaS 平台，需要为最终用户提供 AI 能力。您可以：
-
-1. 使用 HotAI 作为后端 AI 服务
-2. 通过 API 为每个最终用户创建独立的账户
-3. 设置灵活的计费规则
-4. 利用审计日志追踪用户行为
-5. 通过 Webhook 接收使用量通知
-
-## 更多资源
-
-除了功能指南，我们还提供以下资源帮助您更好地使用 HotAI：
-
-- **API 文档：**详细的 API 接口说明和示例代码
-- **SDK 和工具：**多语言 SDK 和命令行工具
-- **示例项目：**完整的应用示例和最佳实践
-- **社区论坛：**与其他用户交流经验和问题
-- **技术博客：**深入的技术文章和使用技巧
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/intro.md b/web/HotAI/dist/docs/intro.md
deleted file mode 100644
index 129eaaa..0000000
--- a/web/HotAI/dist/docs/intro.md
+++ /dev/null
@@ -1,51 +0,0 @@
-# 项目介绍
-
-## 项目背景
-
-HotAI 是一个开源的 AI API 网关和代理服务，旨在解决企业和开发者在使用多个 AI 模型提供商时面临的复杂性问题。随着 AI 技术的快速发展，市场上涌现出众多优秀的 AI 模型服务商，但每家的 API 规范、计费方式、性能特点各不相同。
-
-HotAI 通过统一的 API 接口，将 40+ 个主流 AI 提供商整合在一起，让开发者只需对接一次，就能自由切换和调用不同的模型服务。同时，HotAI 还提供了用户管理、配额控制、使用统计、性能监控等企业级功能，帮助您更好地管理和优化 AI 服务的使用。
-
-## 核心功能
-
-- 支持 40+ AI 提供商：OpenAI、Claude、Gemini、Azure OpenAI、AWS Bedrock 等
-- 统一 API 接口：兼容 OpenAI API 规范，无缝迁移
-- 多租户管理：用户组织、权限控制、配额管理
-- 灵活计费：支持按次数、按 Token、按时长等多种计费模式
-- 高可用架构：支持负载均衡、故障转移、重试策略
-- 完善监控：实时统计、性能分析、告警通知
-
-## 适用场景
-
-### 个人开发者
-
-如果您正在开发 AI 应用，HotAI 可以帮助您快速接入多个模型提供商，无需为每个提供商单独编写适配代码。同时，HotAI 的配额管理和使用统计功能，能帮助您更好地控制成本。
-
-### 企业用户
-
-对于企业级应用，HotAI 提供了完整的用户管理、权限控制、审计日志等功能。您可以为不同的团队和项目分配独立的 API Key，精确控制每个团队的使用配额和成本。
-
-### SaaS 平台
-
-如果您正在构建面向最终用户的 AI SaaS 平台，HotAI 的多租户架构和灵活计费系统，可以帮助您快速实现用户管理和商业化变现。
-
-## 技术栈
-
-HotAI 采用现代化的技术栈构建，确保系统的高性能和可维护性：
-
-- **后端：**Go 1.22+，使用 Gin 框架和 GORM ORM
-- **前端：**React 19，TypeScript，Rsbuild，Base UI，Tailwind CSS
-- **数据库：**支持 SQLite、MySQL、PostgreSQL
-- **缓存：**Redis + 内存缓存
-- **认证：**JWT、WebAuthn/Passkeys、OAuth 2.0
-
-## 社区支持
-
-HotAI 是一个完全开源的项目，我们欢迎社区的贡献和反馈。您可以通过以下方式参与到项目中：
-
-- 在 GitHub 上提交 Issue 和 Pull Request
-- 加入我们的社区讨论组，与其他开发者交流
-- 查看我们的开发路线图，了解未来规划
-- 分享您的使用经验和最佳实践
-
-我们相信开源的力量，希望通过社区的共同努力，让 HotAI 成为最好用的 AI API 网关解决方案。
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/performance.md b/web/HotAI/dist/docs/performance.md
deleted file mode 100644
index 65c749a..0000000
--- a/web/HotAI/dist/docs/performance.md
+++ /dev/null
@@ -1,119 +0,0 @@
-# 性能分析设置指南
-
-## 概述
-
-HotAI 提供两类性能分析能力：
-
-- **pprof (内置)**：适合临时诊断与离线分析。
-- **Pyroscope (可选)**：适合线上持续分析与火焰图可视化。
-
-两者可以同时启用，互不冲突。本文将详细说明如何配置这两种性能分析工具。
-
-## 功能特点
-
-- 零代码集成 - 仅通过环境变量配置
-- 支持 Docker 和独立部署
-- 支持临时诊断与持续分析并存
-- 可选鉴权与实例区分
-
-## pprof (内置) 设置
-
-### 1. 配置环境变量
-
-使用 Docker Compose：
-yaml
-environment:
-
-ENABLE_PPROF=true
-
-### 2. 重启应用
-
-应用 pprof 配置后重启服务：
-
-bash
-docker compose restart hotai
-
-
-### 3. 验证
-
-访问 pprof 端点确认启用成功：
-
-bash
-curl http://localhost:6060/debug/pprof/
-
-
-成功访问后，您可以使用 go tool pprof 进行离线分析，或通过浏览器查看实时火焰图。
-
-## Pyroscope 设置
-
-### 1. 准备 Pyroscope 服务
-
-使用 Docker 部署 Pyroscope 服务器：
-
-bash
-docker run -d
--p 4040:4040
-–name pyroscope
-grafana/pyroscope:latest
-
-
-### 2. 配置环境变量
-
-在 HotAI 中启用 Pyroscope 集成：
-
-yaml
-environment:
-
-ENABLE_PYROSCOPE=true
-PYROSCOPE_SERVER_ADDRESS=http://pyroscope:4040
-PYROSCOPE_APPLICATION_NAME=hotai
-
-### 3. 重启应用
-
-应用配置后重启 HotAI：
-
-bash
-docker compose restart hotai
-
-
-### 4. 验证
-
-访问 Pyroscope Web UI 查看性能数据：
-
-- 打开浏览器访问：http://localhost:4040
-- 选择应用名称：hotai
-- 查看 CPU、内存、goroutine 等性能指标的火焰图
-
-## 故障排除
-
-### pprof 无法访问
-
-检查以下配置：
-
-- 确认 ENABLE_PPROF=true 已设置
-- 确认端口 6060 没有被占用
-- 检查防火墙设置
-
-### Pyroscope 连接失败
-
-可能的原因和解决方案：
-
-- Pyroscope 服务未启动：检查服务状态
-- 网络不通：确认 HotAI 可以访问 Pyroscope 服务地址
-- 配置错误：检查 PYROSCOPE_SERVER_ADDRESS 是否正确
-
-## 环境变量参考
-
-完整的性能分析相关环境变量：
-
-- **ENABLE_PPROF：**是否启用 pprof（默认 false）
-- **PPROF_PORT：**pprof 监听端口（默认 6060）
-- **ENABLE_PYROSCOPE：**是否启用 Pyroscope（默认 false）
-- **PYROSCOPE_SERVER_ADDRESS：**Pyroscope 服务器地址
-- **PYROSCOPE_APPLICATION_NAME：**应用名称标识
-
-## 相关链接
-
-- [Go pprof 官方文档](https://pkg.go.dev/net/http/pprof)
-- [Pyroscope 官方文档](https://grafana.com/oss/pyroscope/)
-- [pprof 使用指南](https://go.dev/blog/pprof)
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/quickstart.md b/web/HotAI/dist/docs/quickstart.md
deleted file mode 100644
index d28b326..0000000
--- a/web/HotAI/dist/docs/quickstart.md
+++ /dev/null
@@ -1,122 +0,0 @@
-# 快速开始
-
-欢迎使用 HotAI 文档中心！这是一个基于 Markdown 的文档系统示例。
-
-## 系统要求
-
-在开始之前，请确保您的环境满足以下要求：
-
-- Node.js >= 16.0.0
-- Go >= 1.22
-- Docker (可选)
-- Redis (可选)
-
-## 安装步骤
-
-### 1. 克隆仓库
-
-首先克隆项目仓库到本地：
-
-```bash
-git clone https://github.com/Betterlol/HotAI.git
-cd HotAI
-```
-
-### 2. 安装依赖
-
-使用以下命令安装项目依赖：
-
-```bash
-# 前端依赖
-cd web/default
-bun install
-
-# 返回根目录
-cd ../..
-
-# Go 依赖
-go mod download
-```
-
-### 3. 配置环境变量
-
-复制环境变量模板文件并进行配置：
-
-```bash
-cp .env.example .env
-```
-
-编辑 `.env` 文件，配置必要的参数：
-
-```env
-# 数据库配置
-DB_TYPE=sqlite
-DB_PATH=./data/hotai.db
-
-# Redis 配置（可选）
-REDIS_HOST=localhost
-REDIS_PORT=6379
-
-# 服务端口
-PORT=3000
-```
-
-## 启动服务
-
-### 开发模式
-
-```bash
-# 启动后端
-go run main.go
-
-# 启动前端（新终端）
-cd web/default
-bun run dev
-```
-
-### 生产模式
-
-使用 Docker Compose 快速启动：
-
-```bash
-docker-compose up -d
-```
-
-## 验证安装
-
-访问以下地址验证服务是否正常运行：
-
-- 前端界面: [http://localhost:3000](http://localhost:3000)
-- API 文档: [http://localhost:3000/swagger](http://localhost:3000/swagger)
-
-## 下一步
-
-- 阅读 [项目介绍](intro.md) 了解更多架构信息
-- 查看 [用户指南](user-guide.md) 学习如何使用系统
-- 浏览 [管理员指南](admin-guide.md) 了解管理功能
-
-## 常见问题
-
-### 端口被占用
-
-如果 3000 端口已被占用，可以在 `.env` 中修改端口号：
-
-```env
-PORT=8080
-```
-
-### 数据库连接失败
-
-确保数据库配置正确，并且数据库服务已启动。对于 SQLite，确保数据目录有写入权限。
-
-## 获取帮助
-
-如果遇到问题，可以：
-
-- 查看 [GitHub Issues](https://github.com/Betterlol/HotAI/issues)
-- 加入我们的社区讨论
-- 阅读详细文档
-
----
-
-**提示**: 本文档是使用 Markdown 格式编写的示例文档，右侧目录是根据标题自动生成的。
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/user-guide.md b/web/HotAI/dist/docs/user-guide.md
deleted file mode 100644
index 94648df..0000000
--- a/web/HotAI/dist/docs/user-guide.md
+++ /dev/null
@@ -1,112 +0,0 @@
-# 用户指南
-
-## 注册和登录
-
-### 注册新账户
-
-访问 HotAI 首页，点击"注册"按钮：
-
-1. 填写邮箱地址和密码
-2. 验证邮箱（系统会发送验证链接）
-3. 完成注册，自动登录
-
-注册成功后，系统会为您分配初始配额，您可以立即开始使用 API 服务。
-
-### 使用 OAuth 登录
-
-HotAI 支持多种 OAuth 登录方式：
-
-- GitHub 账号登录
-- Google 账号登录
-- 其他 OIDC 提供商
-
-使用 OAuth 登录无需单独注册，首次登录时会自动创建账户。
-
-## 创建 API Key
-
-API Key 是调用 HotAI API 的凭证。创建步骤如下：
-
-1. 登录后进入控制台
-2. 点击"API Keys"菜单
-3. 点击"创建新 Key"按钮
-4. 填写 Key 名称和备注
-5. （可选）设置 Key 的权限和配额
-6. 点击"创建"
-
-**重要：**Key 创建后只显示一次，请妥善保管。如果丢失，需要重新创建。
-
-### 管理 API Key
-
-在 API Keys 页面，您可以：
-
-- 查看所有 Key 的状态和使用情况
-- 启用或禁用 Key
-- 修改 Key 的配额限制
-- 删除不再使用的 Key
-
-## 调用 API
-
-HotAI 完全兼容 OpenAI API 格式，您可以使用 OpenAI 的 SDK 或直接调用 HTTP 接口。
-
-### 使用 curl 调用
-bash
-curl https://your-hotai-domain/v1/chat/completions
--H “Authorization: Bearer YOUR_API_KEY”
--H “Content-Type: application/json”
--d ‘{
-“model”: “gpt-4”,
-“messages”: [
-{“role”: “user”, “content”: “Hello!”}
-]
-}’
-
-
-### 使用 Python SDK
-
-python
-from openai import OpenAI
-
-client = OpenAI(
-api_key=“YOUR_API_KEY”,
-base_url=“https://your-hotai-domain/v1”
-)
-
-response = client.chat.completions.create(
-model=“gpt-4”,
-messages=[
-{“role”: “user”, “content”: “Hello!”}
-]
-)
-print(response.choices[0].message.content)
-
-
-## 查看使用量
-
-在控制台的"使用统计"页面，您可以查看：
-
-- 实时的 API 调用次数
-- Token 使用量统计
-- 费用明细和趋势图表
-- 按模型、按时间的使用分布
-
-您还可以导出使用记录，用于内部审计或成本分析。
-
-## 管理账户
-
-### 个人信息
-
-在"个人设置"页面，您可以：
-
-- 修改用户名和头像
-- 更改密码
-- 绑定或解绑 OAuth 账号
-- 设置双因素认证（2FA）
-
-### 充值和账单
-
-在"账户余额"页面，您可以：
-
-- 查看当前余额和配额
-- 在线充值（支持多种支付方式）
-- 查看历史账单和交易记录
-- 设置余额预警通知
\ No newline at end of file
diff --git a/web/HotAI/dist/docs/user/101-user-guide.md b/web/HotAI/dist/docs/user/101-user-guide.md
new file mode 100644
index 0000000..564953c
--- /dev/null
+++ b/web/HotAI/dist/docs/user/101-user-guide.md
@@ -0,0 +1,110 @@
+# 图灵智算用户手册
+
+## 一、平台简介
+
+图灵智算是一款国内 AI 模型 API 聚合平台，可一站式接入 DeepSeek、Kimi 等多种国内主流模型，并通过统一的 OpenAI 兼容接口对外提供服务。
+
+对于普通用户，主要操作路径是：
+
+1. 注册并登录平台。
+2. 创建或复制 API Key。
+3. 选择可用模型。
+4. 按 API 文档发起请求。
+5. 在控制台查看用量、余额和调用日志。
+
+## 二、快速入门
+
+### 1. 访问平台
+
+打开平台地址后，可通过顶部导航进入首页、控制台、模型广场和文档中心。
+
+<img src="assets/00-homepage.png?v=20260723" alt="首页" class="manual-screenshot manual-screenshot-wide">
+
+### 2. 账号注册与登录
+
+访问图灵智算首页，点击右上角“注册”按钮：
+
+<img src="assets/01-register.png?v=20260723" alt="注册页面" class="manual-screenshot">
+
+1. 填写用户名、邮箱地址和密码。
+2. 按页面提示完成邮箱验证。
+3. 注册完成后，进入登录页。
+4. 使用用户名/邮箱及密码登录。
+
+<img src="assets/02-login.png?v=20260723" alt="登录页面" class="manual-screenshot">
+
+当前登录页以账号密码登录为主。是否开放第三方登录入口，以平台实际页面显示为准。
+
+### 3. 控制台概览
+
+登录后，控制台通常包含以下入口：
+
+- **API Key / Token 管理：** 创建、查看、禁用或删除 API Key。
+- **模型列表：** 查看当前账号可用模型。
+- **使用统计：** 查看 API 调用次数、Token 消耗和费用。
+- **账户设置：** 管理个人信息和密码。
+- **充值与账单：** 查看余额、充值记录和交易明细。
+
+## 三、令牌管理
+
+令牌 (API Key) 是调用图灵智算 API 的凭证。创建步骤：
+
+1. 登录后进入控制台。
+2. 找到令牌管理页面。
+3. 点击创建新 API Key。
+4. 填写名称。
+5. 按需设置权限、额度或有效期。
+6. 保存并复制 API Key。
+
+**注意事项：**
+
+- API Key 创建后通常只完整显示一次，请妥善保存。
+- 不要把真实 API Key 写入公开文档、截图、前端代码或 Git 仓库。
+- 如果 API Key 泄露，应立即禁用或删除，并重新创建。
+- 不同项目建议使用不同 API Key，便于统计和停用。
+
+## 四、模型列表与选择
+
+可通过控制台或 API 查询当前账号可用模型：
+
+```bash
+curl https://api.example.com/v1/models \
+  -H "Authorization: Bearer sk-xxxxxxxx"
+```
+
+选择模型时建议关注：
+
+- **模型 ID：** API 请求中的 `model` 字段。
+- **适用场景：** 对话、代码、长上下文、批处理等。
+- **上下文长度：** 输入和输出可用窗口。
+- **流式输出：** 是否支持 `stream: true`。
+- **JSON 输出：** 是否适合结构化返回。
+- **并发限制：** 高频调用时需要重点确认。
+- **价格：** 输入、输出和缓存命中的计费规则。
+
+详细信息见：[模型总览](#docs/user/103-model-info.md)。
+
+## 五、用量与计费
+
+在控制台的使用统计或日志页面，可以查看：
+
+- API 调用次数。
+- 输入、输出和总 Token 消耗。
+- 按模型、时间、Key 维度的使用分布。
+- 调用状态、错误信息和请求耗时。
+- 费用明细和余额变化。
+
+建议上线前确认：
+
+- 示例请求中的 Base URL、API Key、模型 ID 已替换为真实值。
+- API Key 权限和额度符合业务需要。
+- 业务代码设置了合理的请求超时时间。
+- 对 `401`、`403`、`429`、`500` 等错误码做了基础处理。
+- 已在控制台确认请求日志和 Token 消耗符合预期。
+
+## 六、常见问题快速索引
+
+- **首次接入 API：** 查看 [API 快速开始](#docs/user/102-quickstart.md)。
+- **不确定模型怎么选：** 查看 [模型总览](#docs/user/103-model-info.md)。
+- **API Key 无效、权限不足或触发限流：** 查看 [FAQ 与常见报错排查](#docs/user/104-faq.md)。
+- **余额、账单或额度异常：** 先查看控制台用量记录，再联系平台管理员。
diff --git "a/docs/API\345\277\253\351\200\237\345\274\200\345\247\213\346\226\207\346\241\243.md" b/web/HotAI/dist/docs/user/102-quickstart.md
similarity index 83%
rename from "docs/API\345\277\253\351\200\237\345\274\200\345\247\213\346\226\207\346\241\243.md"
rename to web/HotAI/dist/docs/user/102-quickstart.md
index a7c5197..d7373d2 100644
--- "a/docs/API\345\277\253\351\200\237\345\274\200\345\247\213\346\226\207\346\241\243.md"
+++ b/web/HotAI/dist/docs/user/102-quickstart.md
@@ -1,6 +1,6 @@
 # API 快速开始文档
 
-若您是第一次接入 HotAI API，可以先阅读前四小节，了解从准备 API Key 到完成首次调用的基本流程，用时约 3 分钟。
+若您是第一次接入图灵智算 API，可以先阅读前四小节，了解从准备 API Key 到完成首次调用的基本流程，用时约 3 分钟。
 后面小节的语言示例、流式输出和错误码说明，可在实际开发时按需参考。
 
 ## 一、操作步骤速览
@@ -14,7 +14,7 @@
 | 5 | 读取模型回复 | 看 `choices[0].message.content` |
 | 6 | 查看 Token 消耗 | 看 `usage.total_tokens` |
 
-最小调用示例：
+**最小调用示例：**
 
 ```bash
 curl https://api.example.com/v1/chat/completions \
@@ -25,17 +25,17 @@ curl https://api.example.com/v1/chat/completions \
     "messages": [
       {
         "role": "user",
-        "content": "请用一句话介绍一下 HotAI。"
+        "content": "请用一句话介绍一下图灵智算。"
       }
     ]
   }'
 ```
 
-把示例中的三项内容替换成你的真实信息即可：
+**把示例中的三项内容替换成你的真实信息即可：**
 
-- `https://api.example.com`：平台或管理员提供的 API 地址。
-- `sk-xxxxxxxx`：你在控制台创建或复制的 API Key。
-- `deepseek-v4-flash`：你要调用的模型 ID。
+- **`https://api.example.com`：** 平台或管理员提供的 API 地址。
+- **`sk-xxxxxxxx`：** 你在控制台创建或复制的 API Key。
+- **`deepseek-v4-flash`：** 你要调用的模型 ID。
 
 ## 二、准备调用信息
 
@@ -43,12 +43,12 @@ curl https://api.example.com/v1/chat/completions \
 
 | 项目 | 说明 | 示例 |
 | ---- | ---- | ---- |
-| Base URL | HotAI API 服务地址，由平台或管理员提供 | `https://api.example.com` |
+| Base URL | 图灵智算 API 服务地址，由平台或管理员提供 | `https://api.example.com` |
 | API Key | 在控制台的 Token Management / API token management 中创建或复制 | `sk-xxxxxxxx` |
 | 模型 ID | 需要调用的模型名称，可先用 `/v1/models` 查询 | `deepseek-v4-flash` |
 
 - API Key 只在请求头中使用，不要写入公开文档、截图、前端代码或 Git 仓库。
-- 更多模型信息可参考：[模型总览](web/HotAI/dist/docs/model-info.md)。
+- 更多模型信息可参考：[模型总览](#docs/user/103-model-info.md)。
 
 ## 三、验证 API Key 和模型列表
 
@@ -76,7 +76,7 @@ deepseek-v4-flash
     {
       "message": {
         "role": "assistant",
-        "content": "HotAI 是一个聚合多种 AI 模型的 API 调用平台。"
+        "content": "图灵智算是一个聚合多种 AI 模型的 API 调用平台。"
       },
       "finish_reason": "stop"
     }
@@ -89,7 +89,7 @@ deepseek-v4-flash
 }
 ```
 
-常用字段：
+**常用字段：**
 
 | 字段 | 说明 |
 | ---- | ---- |
@@ -112,7 +112,7 @@ curl https://api.example.com/v1/chat/completions \
     "messages": [
       {
         "role": "user",
-        "content": "请用一句话介绍 HotAI。"
+        "content": "请用一句话介绍图灵智算。"
       }
     ],
     "stream": false,
@@ -139,7 +139,7 @@ response = requests.post(
         "messages": [
             {
                 "role": "user",
-                "content": "请用一句话介绍 HotAI。",
+                "content": "请用一句话介绍图灵智算。",
             }
         ],
         "stream": False,
@@ -153,7 +153,7 @@ data = response.json()
 print(data["choices"][0]["message"]["content"])
 ```
 
-如果本地没有安装 `requests`，可先执行：
+**如果本地没有安装 `requests`，可先执行：**
 
 ```bash
 python -m pip install requests
@@ -179,7 +179,7 @@ async function main() {
       messages: [
         {
           role: 'user',
-          content: '请用一句话介绍 HotAI。',
+          content: '请用一句话介绍图灵智算。',
         },
       ],
       stream: false,
@@ -236,11 +236,11 @@ curl https://api.example.com/v1/chat/completions \
 | `429` | 触发请求频率限制或并发限制 | 降低请求频率，稍后重试，或联系管理员调整限额 |
 | `500` | 服务端或上游模型服务异常 | 稍后重试；如持续出现，记录请求时间、模型 ID 和错误信息后反馈 |
 
-更多排查方法详见：[FAQ 与常见报错排查](./FAQ与常见报错排查.md)。
+更多排查方法详见：[FAQ 与常见报错排查](#docs/user/104-faq.md)。
 
 ## 八、接入检查清单
 
-上线或交付前，建议逐项确认：
+**上线或交付前，建议逐项确认：**
 
 - 已使用 `/v1/models` 验证 API Key 和模型列表。
 - 示例请求中的 Base URL、API Key、模型 ID 均已替换。
diff --git a/web/HotAI/dist/docs/model-info.md b/web/HotAI/dist/docs/user/103-model-info.md
similarity index 74%
rename from web/HotAI/dist/docs/model-info.md
rename to web/HotAI/dist/docs/user/103-model-info.md
index 600c075..199450b 100644
--- a/web/HotAI/dist/docs/model-info.md
+++ b/web/HotAI/dist/docs/user/103-model-info.md
@@ -1,6 +1,6 @@
 # 模型总览
 
-本平台提供的模型及其属性如下（共6款）：
+本平台提供的模型及其属性如下（**共 5 款**）：
 
 ## deepseek-v4-flash
 
@@ -16,13 +16,13 @@
 | 流式输出 | 支持 |
 | JSON输出 | 支持 |
 | 基础测试 | 已完成 |
-| 响应速度 | 非流式总延迟：约 1372ms 流式首 token 延迟：约 1274ms |
+| 响应速度 | P95 4728ms |
 | key状态 | 可用 |
 | 并发限制 | 2500 |
 | 接入状态 | 已接入 |
 | 链接 | https://api-docs.deepseek.com/zh-cn |
-| 更新时间 | 2026/7/1 |
-| 备注 | 流式对话中存在乱码 |
+| 更新时间 | 2026/7/22 |
+| 备注 | 通过测试 |
 
 ## deepseek-v4-pro
 
@@ -38,13 +38,13 @@
 | 流式输出 | 支持 |
 | JSON输出 | 支持 |
 | 基础测试 | 已完成 |
-| 响应速度 | 非流式总延迟：约 1822ms 流式首 token 延迟：约 1107ms |
+| 响应速度 | P95 18183ms |
 | key状态 | 可用 |
 | 并发限制 | 500 |
 | 接入状态 | 已接入 |
 | 链接 | https://api-docs.deepseek.com/zh-cn |
-| 更新时间 | 2026/7/1 |
-| 备注 | 基础对话和流式对话中存在输出空白的现象 |
+| 更新时间 | 2026/7/22 |
+| 备注 | 通过测试 |
 
 ## kimi-k2.6
 
@@ -60,13 +60,13 @@
 | 流式输出 | 支持 |
 | JSON输出 | 支持 |
 | 基础测试 | 已完成 |
-| 响应速度 | 待测试 |
+| 响应速度 | P95 77702ms |
 | key状态 | 可用 |
 | 并发限制 | 3 |
 | 接入状态 | 已接入 |
 | 链接 | https://platform.kimi.com/docs/overview |
-| 更新时间 | 2026/7/2 |
-| 备注 | 模型可用性有待进一步测试。 |
+| 更新时间 | 2026/7/22 |
+| 备注 | 通过测试 |
 
 ## kimi-k2.7-code
 
@@ -82,13 +82,13 @@
 | 流式输出 | 支持 |
 | JSON输出 | 支持 |
 | 基础测试 | 已完成 |
-| 响应速度 | 待测试 |
+| 响应速度 | P95 35337ms |
 | key状态 | 可用 |
 | 并发限制 | 3 |
 | 接入状态 | 已接入 |
 | 链接 | https://platform.kimi.com/docs/overview |
 | 更新时间 | 2026/7/3 |
-| 备注 | 模型可用性有待进一步测试。 |
+| 备注 | 通过测试 |
 
 ## kimi-k2.5
 
@@ -104,32 +104,10 @@
 | 流式输出 | 支持 |
 | JSON输出 | 支持 |
 | 基础测试 | 已完成 |
-| 响应速度 | 待测试 |
+| 响应速度 | P95 36314ms |
 | key状态 | 可用 |
 | 并发限制 | 3 |
 | 接入状态 | 已接入 |
 | 链接 | https://platform.kimi.com/docs/overview |
-| 更新时间 | 2026/7/15 |
-| 备注 | 待测试 |
-
-## kimi-k3
-
-| 属性 | 内容 |
-| ---- | ---- |
-| 提供商 | 官方渠道 |
-| 适用场景 | 适合大型开发、长文档分析、深度调研、复杂设计等专业高阶任务，不适合日常闲聊、简单问答、高并发轻量化使用。 |
-| 模型能力 | Kimi K3 是旗舰大模型，支持百万级超长上下文与多模态解析，长代码编写、复杂逻辑推理能力突出，但调用成本高、响应速度一般。 |
-| 鉴权类型 | API BASE |
-| API格式 | OPENAI |
-| 价格 | 缓存命中输入仅 2 元 / 百万 tokens，缓存未命中输入20 元 / 百万 tokens，输出100 元 / 百万 tokens。 |
-| 上下文长度 | 1M |
-| 流式输出 | 支持 |
-| JSON输出 | 支持 |
-| 基础测试 | 已完成 |
-| 响应速度 | 待测试 |
-| key状态 | 可用 |
-| 并发限制 | 3 |
-| 接入状态 | 已接入 |
-| 链接 | https://platform.kimi.com/docs/overview |
-| 更新时间 | 2026/7/20 |
-| 备注 | 待测试 |
+| 更新时间 | 2026/7/22 |
+| 备注 | 通过测试 |
diff --git a/web/HotAI/dist/docs/user/104-faq.md b/web/HotAI/dist/docs/user/104-faq.md
new file mode 100644
index 0000000..757f07d
--- /dev/null
+++ b/web/HotAI/dist/docs/user/104-faq.md
@@ -0,0 +1,111 @@
+# FAQ 与常见报错排查
+
+## API Key 无效或返回 401
+
+**常见原因：**
+
+- 请求头缺少 `Authorization`。
+- API Key 没有加 `Bearer` 前缀。
+- Key 已删除、禁用、过期或复制不完整。
+
+**处理建议：**
+
+```bash
+curl https://api.example.com/v1/models \
+  -H "Authorization: Bearer sk-xxxxxxxx"
+```
+
+确认请求头格式正确后，重新复制或创建 API Key。
+
+## 返回 403
+
+**常见原因：**
+
+- 当前账号、分组或 API Key 无权访问该模型。
+- 选择了未开通的模型。
+- 管理员限制了用户组权限。
+
+**处理建议：**
+
+- 换用已开通模型。
+- 检查控制台中的模型权限。
+- 联系管理员开通模型或调整分组。
+
+## 返回 404
+
+**常见原因：**
+
+- Base URL 写错。
+- 接口路径写错。
+- 模型 ID 不存在或拼写错误。
+
+**处理建议：**
+
+- 确认接口路径为 `/v1/models` 或 `/v1/chat/completions`。
+- 先调用 `/v1/models` 查询可用模型 ID。
+- 检查 Base URL 是否包含多余路径或缺少协议。
+
+## 返回 429
+
+**常见原因：**
+
+- 请求频率过高。
+- 并发数超过模型或账号限制。
+- Key、用户或分组触发限流。
+
+**处理建议：**
+
+- 降低请求频率。
+- 增加重试间隔和指数退避。
+- 避免大量请求同时启动。
+- 联系管理员调整限额。
+
+## 返回 500 或上游异常
+
+**常见原因：**
+
+- 上游模型服务异常。
+- 渠道暂时不可用。
+- 请求参数被上游拒绝。
+
+**处理建议：**
+
+- 稍后重试。
+- 换用其他可用模型。
+- 记录请求时间、模型 ID、错误内容和 request id 后反馈。
+
+## 流式输出没有内容或中途中断
+
+**处理建议：**
+
+- 确认请求中设置了 `"stream": true`。
+- 确认客户端支持 Server-Sent Events。
+- 检查网络代理是否缓冲或截断 SSE。
+- 如果持续复现，记录模型 ID、请求时间和错误信息后反馈给管理员。
+
+## 如何确认模型 ID
+
+**可以通过模型列表接口查询：**
+
+```bash
+curl https://api.example.com/v1/models \
+  -H "Authorization: Bearer sk-xxxxxxxx"
+```
+
+也可以查看 [模型总览](#docs/user/103-model-info.md) 中列出的模型名称。
+
+## 如何查看 Token 消耗
+
+**非流式请求通常会在响应中返回：**
+
+```json
+{
+  "usage": {
+    "prompt_tokens": 18,
+    "completion_tokens": 20,
+    "total_tokens": 38
+  }
+}
+```
+
+也可以在控制台的使用统计或日志页面查看每次调用的 Token 消耗和费用。
diff --git a/web/HotAI/dist/index.html b/web/HotAI/dist/index.html
index 906a3a2..5a54885 100644
--- a/web/HotAI/dist/index.html
+++ b/web/HotAI/dist/index.html
@@ -282,7 +282,10 @@ <h3 data-i18n="notice.title">公告</h3>
 
 <!-- 右侧主体 -->
 <main class="main-content">
-    <h1 class="brand-logo">Turing Intelligent Computing</h1>
+    <h1 class="brand-logo" data-no-i18n>
+        <span class="brand-logo-line brand-logo-cn" data-no-i18n style="font-size: 1em;">欢迎来到图灵智算</span><br>
+        <span class="brand-logo-line brand-logo-en" data-no-i18n style="font-size: 0.72em;">Welcome to Turing Intelligent Computing</span>
+    </h1>
 
     <!-- 聊天对话区域 -->
     <div id="chatArea" class="chat-area" style="display: none;"></div>
@@ -299,7 +302,7 @@ <h1 class="brand-logo">Turing Intelligent Computing</h1>
         </button>
     </div>
 
-    <p class="subtitle" data-i18n="main.subtitle">国内外 AI api 智能聚合平台，众多合作模型供您选择</p>
+    <p class="subtitle" data-i18n="main.subtitle">国内外 AI API 智能聚合平台，众多合作模型供您选择</p>
 
     <!-- 合作平台图标 -->
     <div class="platform-area" id="platformArea">
diff --git a/web/HotAI/dist/js/docs.js b/web/HotAI/dist/js/docs.js
index 4523dd1..836f78a 100644
--- a/web/HotAI/dist/js/docs.js
+++ b/web/HotAI/dist/js/docs.js
@@ -26,6 +26,7 @@ document.addEventListener('DOMContentLoaded', () => {
     const sidebar = document.querySelector('.docs-sidebar-left');
     const bottomBtns = document.querySelectorAll('.bottom-icon-btn');
     const docsContent = document.querySelector('.docs-content');
+    const docsAdminSection = document.getElementById('docsAdminSection');
 
     // ========== 初始化 markdown-it ==========
     const md = markdownit({
@@ -106,6 +107,23 @@ document.addEventListener('DOMContentLoaded', () => {
         }
     }
 
+    // ========== 管理员文档显隐 ==========
+    async function updateAdminSectionVisibility() {
+        if (!docsAdminSection) return;
+
+        try {
+            const result = await API.getUserInfo();
+            if (result.success && result.data && (result.data.role || 0) >= 10) {  // 用户属于管理员 (10) 或超管 (100)
+                docsAdminSection.classList.remove('hidden');  // 显示管理员文档
+                return;
+            }
+        } catch (error) {
+            console.warn('Failed to load user role for docs admin section:', error);
+        }
+
+        docsAdminSection.classList.add('hidden');  // 隐藏管理员文档
+    }
+
     // ========== 生成目录 (TOC) ==========
     function generateTOC() {
         const headings = mdContent.querySelectorAll('h1, h2, h3');
@@ -351,7 +369,7 @@ document.addEventListener('DOMContentLoaded', () => {
         // 检查 URL hash
         const hash = window.location.hash.substring(1);
         
-        let initialDoc = 'docs/quickstart.md';
+        let initialDoc = 'docs/user/101-user-guide.md';
         
         if (hash && hash.startsWith('docs/')) {
             initialDoc = hash;
@@ -392,6 +410,7 @@ document.addEventListener('DOMContentLoaded', () => {
     });
 
     // ========== 启动 ==========
+    updateAdminSectionVisibility();
     init();
     console.log('文档页面已加载 (Markdown 渲染模式)');
-});
\ No newline at end of file
+});
diff --git a/web/HotAI/dist/js/i18n.js b/web/HotAI/dist/js/i18n.js
index 058ebdf..656f609 100644
--- a/web/HotAI/dist/js/i18n.js
+++ b/web/HotAI/dist/js/i18n.js
@@ -178,11 +178,17 @@ const I18n = {
             // === 文档页面 ===
             'docs.search_placeholder': '搜索文档',
             'docs.search_shortcut': 'Ctrl K',
-            'docs.section_intro': '介绍',
+            'docs.section_intro': '文档',
             'docs.section_guides': '功能指南',
+            'docs.section_users': '我是用户',
+            'docs.section_admins': '我是管理员',
+            'docs.section_developers': '我是开发者',
             'docs.menu_quickstart': '快速开始',
+            'docs.menu_api_quickstart': 'API 快速开始',
             'docs.menu_intro': '项目介绍',
             'docs.menu_model_info': '模型总览',
+            'docs.menu_user_manual': '用户手册',
+            'docs.menu_faq': 'FAQ 与常见报错',
             'docs.menu_features': '特性说明',
             'docs.menu_architecture': '技术架构',
             'docs.menu_analytics': '分析工具设置指南',
@@ -191,6 +197,11 @@ const I18n = {
             'docs.menu_guide_overview': '功能指南概述',
             'docs.menu_user_guide': '用户指南',
             'docs.menu_admin_guide': '管理员指南',
+            'docs.menu_dev_overview': '项目概览与开发规范',
+            'docs.menu_dev_deployment': '部署与运维指南',
+            'docs.menu_dev_stream': '流式输出排查与修复',
+            'docs.menu_dev_i18n': '翻译术语表',
+            'docs.menu_dev_records': '项目记录与第三方接口',
             'docs.toc_title': '目录',
             'docs.loading': '正在加载文档...',
             'docs.btn_help': '帮助',
@@ -549,11 +560,17 @@ const I18n = {
             // === Docs page ===
             'docs.search_placeholder': 'Search docs',
             'docs.search_shortcut': 'Ctrl K',
-            'docs.section_intro': 'Introduction',
+            'docs.section_intro': 'Docs',
             'docs.section_guides': 'Guides',
+            'docs.section_users': 'For Users',
+            'docs.section_admins': 'For Admins',
+            'docs.section_developers': 'For Developers',
             'docs.menu_quickstart': 'Quick Start',
+            'docs.menu_api_quickstart': 'API Quick Start',
             'docs.menu_intro': 'Introduction',
             'docs.menu_model_info': 'Model Information',
+            'docs.menu_user_manual': 'User Manual',
+            'docs.menu_faq': 'FAQ & Troubleshooting',
             'docs.menu_features': 'Features',
             'docs.menu_architecture': 'Architecture',
             'docs.menu_analytics': 'Analytics Setup',
@@ -562,6 +579,11 @@ const I18n = {
             'docs.menu_guide_overview': 'Guide Overview',
             'docs.menu_user_guide': 'User Guide',
             'docs.menu_admin_guide': 'Admin Guide',
+            'docs.menu_dev_overview': 'Project Overview & Development Rules',
+            'docs.menu_dev_deployment': 'Deployment & Operations',
+            'docs.menu_dev_stream': 'Streaming Troubleshooting',
+            'docs.menu_dev_i18n': 'Translation Glossary',
+            'docs.menu_dev_records': 'Project Records & Third-Party APIs',
             'docs.toc_title': 'Contents',
             'docs.loading': 'Loading docs...',
             'docs.btn_help': 'Help',
@@ -924,4 +946,4 @@ if (document.readyState === 'loading') {
     document.addEventListener('DOMContentLoaded', () => I18n.init());
 } else {
     I18n.init();
-}
\ No newline at end of file
+}