docs: refresh user manual for current app support (#3411)

* docs(usage): document pricing model matching rules

* docs: refresh user manual for current app support

* docs: clarify Hermes configuration files

* docs: align feature docs with visible app support

docs/user-manual/README.md

@@ -1,6 +1,6 @@
 # CC Switch User Manual / 用户手册 / ユーザーマニュアル
 
-> Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw
+> Claude Code / Claude Desktop / Codex / Gemini CLI / OpenCode / OpenClaw / Hermes
 
 ## Language / 语言 / 言語
 
@@ -12,9 +12,9 @@
 
 ## Version / 版本 / バージョン
 
-- Documentation version: v3.15.0
-- Last updated: 2026-05-16
-- Compatible with CC Switch v3.15.0+
+- Documentation version: v3.16.0
+- Last updated: 2026-05-29
+- Compatible with CC Switch v3.16.0+
 
 ## Links
 

docs/user-manual/en/1-getting-started/1.1-introduction.md

@@ -2,7 +2,7 @@
 
 ## What is CC Switch
 
-CC Switch is a cross-platform desktop application designed for developers who use AI coding tools. It helps you centrally manage configurations for **Claude Code**, **Claude Desktop**, **Codex**, **Gemini CLI**, **OpenCode**, **OpenClaw**, and **Hermes**.
+CC Switch is a cross-platform desktop application designed for developers who use AI tools. It helps you centrally manage configurations for **Claude Code**, **Claude Desktop**, **Codex**, **Gemini CLI**, **OpenCode**, **OpenClaw**, and **Hermes**.
 
 ## What Problems Does It Solve
 
@@ -45,7 +45,7 @@ CC Switch solves these problems through a unified interface.
 | **Codex** | OpenAI's code generation tool |
 | **Gemini CLI** | Google's AI command-line tool |
 | **OpenCode** | Open-source AI coding terminal tool |
-| **OpenClaw** | Open-source AI coding assistant (multi-provider gateway) |
+| **OpenClaw** | Open-source AI assistant (multi-provider gateway) |
 | **Hermes** | Hermes Agent provider, MCP, Skills, and Memory management |
 
 ## Supported Platforms

docs/user-manual/en/1-getting-started/1.3-interface.md

@@ -12,7 +12,7 @@
 | 2 | Settings Button | Open the settings page (shortcut `Cmd/Ctrl + ,`) |
 | 3 | Proxy Toggle | Start/stop the local proxy service |
 | 4 | App Switcher | Switch between Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes |
-| 5 | Feature Area | Skills / Prompts / MCP entry points |
+| 5 | Feature Area | App-specific feature entry points |
 | 6 | Add Button | Add a new provider |
 
 ### App Switcher
@@ -33,9 +33,9 @@ After switching, the provider list displays the configurations for the selected
 
 | Button | Function | Visibility |
 |--------|----------|------------|
-| Skills | Skill extension management | Always visible |
-| Prompts | System prompt management | Always visible |
-| MCP | MCP server management | Always visible |
+| Skills | Skill extension management | Claude / Codex / Gemini / OpenCode / Hermes |
+| Prompts | System prompt management | Claude / Codex / Gemini / OpenCode |
+| MCP | MCP server management | Claude / Codex / Gemini / OpenCode / Hermes |
 
 ## Provider Cards
 
@@ -113,13 +113,14 @@ CC Switch displays an icon in the system tray, providing quick access to operati
 
 ### Multi-language Support
 
-The tray menu supports three languages, automatically switching based on settings:
+The tray menu supports four languages, automatically switching based on settings:
 
 | Language | Open Main Window | Quit |
 |----------|-----------------|------|
-| Chinese | Open Main Window | Quit |
+| Simplified Chinese | 打开主界面 | 退出 |
+| Traditional Chinese | 開啟主介面 | 退出 |
 | English | Open main window | Quit |
-| Japanese | Open main window | Quit |
+| Japanese | メインウィンドウを開く | 終了 |
 
 ### Lightweight Mode
 
@@ -147,7 +148,7 @@ The settings page is divided into multiple tabs:
 
 ### General Tab
 
-- Language settings (Chinese/English/Japanese)
+- Language settings (Simplified Chinese/Traditional Chinese/English/Japanese)
 - Theme settings (System/Light/Dark)
 - Window behavior (launch on startup, close behavior)
 

docs/user-manual/en/1-getting-started/1.5-settings.md

@@ -9,11 +9,12 @@ This section describes how to configure CC Switch according to your preferences.
 
 ## Language Settings
 
-CC Switch supports three languages:
+CC Switch supports four languages:
 
 | Language | Description |
 |----------|-------------|
 | Simplified Chinese | Default language |
+| Traditional Chinese | Traditional Chinese interface |
 | English | English interface |
 | Japanese | Japanese interface |
 
@@ -124,8 +125,9 @@ You can customize each CLI tool's configuration directory:
 | Claude Directory | `~/.claude/` | Claude Code configuration directory |
 | Codex Directory | `~/.codex/` | Codex configuration directory |
 | Gemini Directory | `~/.gemini/` | Gemini CLI configuration directory |
-| OpenCode Directory | `~/.opencode/` | OpenCode configuration directory |
+| OpenCode Directory | `~/.config/opencode/` | OpenCode configuration directory |
 | OpenClaw Directory | `~/.openclaw/` | OpenClaw configuration directory |
+| Hermes Directory | `~/.hermes/` | Hermes configuration directory |
 
 > **Note**: After changing directories, the app must be restarted, and the corresponding CLI tools must also be configured to use the same directory.
 
@@ -133,14 +135,15 @@ You can customize each CLI tool's configuration directory:
 
 ### Export Configuration
 
-Click the "Export" button to save a backup file containing:
+Click the "Export" button to save a SQL backup file containing:
 
 - All provider configurations
 - MCP server configurations
 - Prompt presets
+- Usage logs
 - App settings
 
-The backup file is in JSON format and can be viewed with a text editor.
+The exported file name format is `cc-switch-export-{timestamp}.sql`.
 
 ### Import Configuration
 

docs/user-manual/en/3-extensions/3.1-mcp.md

@@ -103,15 +103,16 @@ Each MCP server can independently control which apps it is enabled for.
 | Claude | Sync to Claude Code | `~/.claude.json`'s `mcpServers` |
 | Codex | Sync to Codex | `~/.codex/config.toml`'s `[mcp_servers]` |
 | Gemini | Sync to Gemini CLI | `~/.gemini/settings.json`'s `mcpServers` |
-| OpenCode | Sync to OpenCode | `~/.opencode/config.json`'s `mcpServers` |
+| OpenCode | Sync to OpenCode | `~/.config/opencode/opencode.json`'s `mcp` |
+| Hermes | Sync to Hermes | `~/.hermes/config.yaml`'s `mcp_servers` |
 
-> **Note**: OpenClaw does not currently support MCP server management. MCP functionality is currently only supported for Claude, Codex, Gemini, and OpenCode.
+> **Note**: OpenClaw and Claude Desktop do not currently support CC Switch MCP sync. MCP functionality is supported for Claude, Codex, Gemini, OpenCode, and Hermes.
 
 ### Toggle Implementation
 
 When enabling an app's toggle, CC Switch will:
 
-1. **Update database**: Set the server's `apps.claude/codex/gemini/opencode` status to `true`
+1. **Update database**: Set the server's `apps.claude/codex/gemini/opencode/hermes` status to `true`
 2. **Sync to live configuration**: Write the server configuration to the corresponding app's configuration file
 3. **Take effect immediately**: The new MCP server is automatically loaded the next time the CLI tool starts
 
@@ -128,7 +129,8 @@ MCP server sync only executes when the corresponding app is installed:
 - **Claude**: Requires `~/.claude/` directory or `~/.claude.json` file to exist
 - **Codex**: Requires `~/.codex/` directory to exist
 - **Gemini**: Requires `~/.gemini/` directory to exist
-- **OpenCode**: Requires `~/.opencode/` directory to exist
+- **OpenCode**: Requires `~/.config/opencode/` directory to exist
+- **Hermes**: Requires `~/.hermes/` directory to exist
 
 > **Tip**: If a CLI tool is not installed, enabling its toggle will not cause an error, but the configuration will not be written.
 
@@ -154,7 +156,7 @@ After deletion, the configuration is removed from all app configuration files.
 If you have already configured MCP servers in CLI tools, you can import them into CC Switch:
 
 1. Click the "Import" button
-2. Select the app to import from (Claude/Codex/Gemini/OpenCode)
+2. Select the app to import from (Claude/Codex/Gemini/OpenCode/Hermes)
 3. CC Switch reads the existing configuration and imports it
 
 ## Configuration File Formats

docs/user-manual/en/3-extensions/3.2-prompts.md

@@ -81,8 +81,7 @@ After activation, the prompt is written to the corresponding app's file:
 | Claude | `~/.claude/CLAUDE.md` |
 | Codex | `~/.codex/AGENTS.md` |
 | Gemini | `~/.gemini/GEMINI.md` |
-| OpenCode | `~/.opencode/AGENTS.md` |
-| OpenClaw | `~/.openclaw/AGENTS.md` |
+| OpenCode | `~/.config/opencode/AGENTS.md` |
 
 ## Edit a Preset
 
@@ -141,7 +140,6 @@ Prompts are managed separately per app:
 - When switched to Codex, Codex's presets are shown
 - When switched to Gemini, Gemini's presets are shown
 - When switched to OpenCode, OpenCode's presets are shown
-- When switched to OpenClaw, OpenClaw's presets are shown
 
 To use the same prompt across multiple apps, you need to create them separately.
 

docs/user-manual/en/3-extensions/3.3-skills.md

@@ -12,18 +12,17 @@ Skills exist as folders containing:
 
 ## Supported Applications
 
-Skills are supported across all four applications:
+Skills are supported across five applications:
 
 - **Claude Code**
 - **Codex**
 - **Gemini CLI**
 - **OpenCode**
+- **Hermes**
 
 ## Open the Skills Page
 
-Click the **Skills** button in the top navigation bar.
-
-> Note: The Skills button is visible in all app modes.
+Click the **Skills** button in the top navigation bar when the selected app supports Skills.
 
 ## Page Overview
 
@@ -93,7 +92,8 @@ Click the "Refresh" button to re-scan repositories for the latest skills.
 | Claude | `~/.claude/skills/` |
 | Codex | `~/.codex/skills/` |
 | Gemini | `~/.gemini/skills/` |
-| OpenCode | `~/.opencode/skills/` |
+| OpenCode | `~/.config/opencode/skills/` |
+| Hermes | `~/.hermes/skills/` |
 
 ### Installation Contents
 
@@ -119,7 +119,7 @@ Installation copies the skill folder to your local machine:
 ### Uninstall Effect
 
 - **Automatic backup**: Before deletion, the skill is backed up to `~/.cc-switch/skill-backups/`
-- Removes the skill from all app directories (Claude, Codex, Gemini, OpenCode)
+- Removes the skill from all app directories (Claude, Codex, Gemini, OpenCode, Hermes)
 - Removes the skill from the SSOT directory (`~/.cc-switch/skills/`)
 - Deletes the skill record from the database
 

docs/user-manual/en/4-proxy/4.4-usage.md

@@ -215,9 +215,11 @@ Set prices for each model (per million tokens):
 
 Before matching pricing, CC Switch normalizes the requested model ID:
 
-- Remove everything before the last `/`
-- Remove everything after `:`
+- Remove everything before the last `/` and convert to lowercase
+- Remove everything after `:` and trim a trailing `[1m]`
 - Replace `@` with `-`
+- Remove common wrapper prefixes, version suffixes, and date suffixes (`-YYYY-MM-DD`, `-YYYYMMDD`)
+- Some model families can match a short ID to a versioned pricing entry
 
 When adding pricing entries, enter the normalized Model ID rather than the full raw model name from the request.
 
@@ -226,6 +228,10 @@ When adding pricing entries, enter the normalized Model ID rather than the full
 | `stepfun-ai/step-3.5-flash` | `step-3.5-flash` | Removes the provider prefix |
 | `moonshotai/kimi-k2-0905:exa` | `kimi-k2-0905` | Removes the prefix and the `:` suffix |
 | `gpt-5.2-codex@low` | `gpt-5.2-codex-low` | Replaces `@` with `-` |
+| `OpenAI/GPT-5.5-2026-05-14` | `gpt-5.5` | Removes the prefix and date suffix |
+| `anthropic/claude-opus-4.8` | `claude-opus-4-8` | Removes the prefix and matches dotted format |
+| `global.anthropic.claude-opus-4-8-v1:0` | `claude-opus-4-8` | Removes wrapper prefix, version suffix, and `:` suffix |
+| `claude-haiku-4-5` | `claude-haiku-4-5-20251001` | Matches a short ID to versioned pricing |
 
 ### Operations
 

docs/user-manual/en/5-faq/5.1-config-files.md

@@ -16,7 +16,7 @@ Customizable location in settings (for cloud sync).
 ├── settings.json     # Device-level settings
 ├── skills/           # Skill SSOT directory
 ├── skill-backups/    # Skill backups (created on uninstall)
-└── db_backup_*.db    # Database backups
+└── backups/          # Database backups
 ```
 
 ### Database Contents
@@ -51,7 +51,8 @@ Customizable location in settings (for cloud sync).
   "codexConfigDir": null,
   "geminiConfigDir": null,
   "opencodeConfigDir": null,
-  "openclawConfigDir": null
+  "openclawConfigDir": null,
+  "hermesConfigDir": null
 }
 ```
 
@@ -196,17 +197,41 @@ GEMINI_MODEL=gemini-pro
 
 ### Configuration Directory
 
-Default: `~/.opencode/`
+Default: `~/.config/opencode/`
 
 ### Key Files
 
 ```
-~/.opencode/
-├── config.json       # Main configuration file
+~/.config/opencode/
+├── opencode.json     # Main configuration file
 ├── AGENTS.md         # System prompt
 └── skills/           # Skills directory
     └── ...
 ```
+## Hermes Configuration
+
+### Configuration Directory
+
+Default: `~/.hermes/`
+
+### Key Files
+
+```
+~/.hermes/
+├── config.yaml       # Main settings, providers, and MCP configuration
+├── .env              # API keys and secrets
+├── SOUL.md           # Profile identity/persona
+├── memories/
+│   ├── MEMORY.md     # Agent memory
+│   └── USER.md       # User profile memory
+├── skills/           # Active skills directory
+├── state.db          # SQLite session database
+└── sessions/         # Gateway transcripts and optional JSON snapshots
+```
+
+### config.yaml
+
+Hermes uses YAML configuration. CC Switch writes MCP servers to `mcp_servers`, writes editable provider entries to `custom_providers`, reads read-only entries from Hermes' `providers` dict, and updates `model.provider` / `model.default` when switching providers.
 
 ## OpenClaw Configuration
 
@@ -219,7 +244,6 @@ Default: `~/.openclaw/`
 ```
 ~/.openclaw/
 ├── openclaw.json     # Main configuration file (JSON5 format)
-├── AGENTS.md         # System prompt
 └── skills/           # Skills directory
     └── ...
 ```
@@ -246,18 +270,17 @@ OpenClaw uses a JSON5 format configuration file with the following main sections
   env: {
     ANTHROPIC_API_KEY: "sk-..."
   },
-  // Agent default model configuration
+  // Agent default configuration
   agents: {
     defaults: {
       model: {
         primary: "provider/model"
-      }
+      },
+      workspace: "~/.openclaw/workspace"
     }
   },
   // Tool configuration
-  tools: {},
-  // Workspace file configuration
-  workspace: {}
+  tools: {}
 }
 ```
 
@@ -267,7 +290,7 @@ OpenClaw uses a JSON5 format configuration file with the following main sections
 | `env` | Environment variable configuration |
 | `agents.defaults` | Agent default model settings |
 | `tools` | Tool configuration |
-| `workspace` | Workspace file management |
+| `agents.defaults.workspace` | Workspace directory path |
 
 ## Configuration Priority
 

docs/user-manual/en/README.md

@@ -106,15 +106,15 @@ CC Switch User Manual
 
 ## Version Information
 
-- Documentation version: v3.15.0
-- Last updated: 2026-05-16
-- Applicable to CC Switch v3.15.0+
+- Documentation version: v3.16.0
+- Last updated: 2026-05-29
+- Applicable to CC Switch v3.16.0+
 
-### v3.15.0 Highlights
+### v3.16.0 Highlights
 
-- **First-class Claude Desktop panel**: supports third-party providers, direct / model mapping modes, Copilot / Codex OAuth reuse, and 3P profile writing. See [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md)
-- **Role-based model mapping**: adapts Claude Desktop model validation with Sonnet / Opus / Haiku routes and `supports1m`
-- **Claude Desktop local routing**: provides a local gateway at `127.0.0.1:15721/claude-desktop` for providers that need conversion
+- **Codex Chat Completions routing**: route Chat-only providers such as DeepSeek, Kimi, GLM, and MiniMax through Codex. See [2.1 Add Provider](./2-providers/2.1-add.md)
+- **Managed CLI tool lifecycle**: install, update, update all, and diagnose Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes from Settings / About. See [1.5 Personalization](./1-getting-started/1.5-settings.md)
+- **Provider and model refresh**: new partner presets, refreshed default models and pricing, Claude Opus 4.8 defaults, and GPT 5.5 defaults where applicable
 - **Routing support badges**: Claude Code / Codex provider cards indicate whether a provider can be served through Local Routing
 - **Codex OAuth live model discovery**: ChatGPT Codex providers fetch available models from the ChatGPT backend on demand
 - **Filter-driven Usage Hero**: shows cache-normalized real total tokens and cache hit rate, updating with date / provider / model filters — see [4.4 Usage Statistics](./4-proxy/4.4-usage.md)
@@ -124,7 +124,7 @@ CC Switch User Manual
 - **Per-App Tray Submenus**: Claude / Codex / Gemini submenus show the current provider and available usage summaries — see [2.2 Switch Provider](./2-providers/2.2-switch.md)
 - **Skills Discovery & Batch Updates**: SHA-256 update detection, batch updates, skills.sh public registry search — see [3.3 Skills Management](./3-extensions/3.3-skills.md)
 - **Full URL Endpoint Mode**: Advanced option to treat `base_url` as the full upstream endpoint — see [2.1 Add Provider](./2-providers/2.1-add.md)
-- **OpenCode / OpenClaw Stream Check Coverage**: Stream Check covers Claude / Codex / Gemini / OpenCode / OpenClaw — see [4.5 Model Test](./4-proxy/4.5-model-test.md)
+- **OpenCode / OpenClaw / Hermes Stream Check Coverage**: Stream Check covers Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes — see [4.5 Model Test](./4-proxy/4.5-model-test.md)
 
 ## Contributing
 

docs/user-manual/ja/1-getting-started/1.1-introduction.md

@@ -2,7 +2,7 @@
 
 ## CC Switch とは
 
-CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI プログラミングツールを使用する開発者向けに設計されています。**Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw**、**Hermes** などの管理対象アプリの設定を統一的に管理できます。
+CC Switch はクロスプラットフォームのデスクトップアプリケーションで、AI ツールを使用する開発者向けに設計されています。**Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw**、**Hermes** などの管理対象アプリの設定を統一的に管理できます。
 
 ## どのような問題を解決するか
 
@@ -45,7 +45,7 @@ CC Switch は統一されたインターフェースでこれらの問題を解
 | **Codex** | OpenAI のコード生成ツール |
 | **Gemini CLI** | Google の AI コマンドラインツール |
 | **OpenCode** | オープンソース AI プログラミングターミナルツール |
-| **OpenClaw** | オープンソース AI プログラミングアシスタント（マルチプロバイダーゲートウェイ） |
+| **OpenClaw** | オープンソース AI アシスタント（マルチプロバイダーゲートウェイ） |
 | **Hermes** | Hermes Agent のプロバイダー、MCP、Skills、Memory 管理 |
 
 ## 対応プラットフォーム

docs/user-manual/ja/1-getting-started/1.3-interface.md

@@ -12,7 +12,7 @@
 | ② | 設定ボタン | 設定ページを開く（ショートカット `Cmd/Ctrl + ,`） |
 | ③ | プロキシスイッチ | ローカルプロキシサービスの起動/停止 |
 | ④ | アプリ切り替え | Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes を切り替え |
-| ⑤ | 機能エリア | Skills / Prompts / MCP の入口 |
+| ⑤ | 機能エリア | 現在のアプリで利用できる機能入口 |
 | ⑥ | 追加ボタン | 新しいプロバイダーを追加 |
 
 ### アプリ切り替え
@@ -33,9 +33,9 @@
 
 | ボタン | 機能 | 表示条件 |
 |------|------|----------|
-| Skills | スキル拡張管理 | 常に表示 |
-| Prompts | システムプロンプト管理 | 常に表示 |
-| MCP | MCP サーバー管理 | 常に表示 |
+| Skills | スキル拡張管理 | Claude / Codex / Gemini / OpenCode / Hermes |
+| Prompts | システムプロンプト管理 | Claude / Codex / Gemini / OpenCode |
+| MCP | MCP サーバー管理 | Claude / Codex / Gemini / OpenCode / Hermes |
 
 ## プロバイダーカード
 
@@ -113,11 +113,12 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操
 
 ### 多言語対応
 
-トレイメニューは 3 つの言語に対応し、設定に応じて自動的に切り替わります：
+トレイメニューは 4 つの言語に対応し、設定に応じて自動的に切り替わります：
 
 | 言語 | メインウィンドウを開く | 終了 |
 |------|-----------|------|
-| 中文 | 打开主界面 | 退出 |
+| 簡体中文 | 打开主界面 | 退出 |
+| 繁體中文 | 開啟主介面 | 退出 |
 | English | Open main window | Quit |
 | 日本語 | メインウィンドウを開く | 終了 |
 
@@ -147,7 +148,7 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操
 
 ### 一般タブ
 
-- 言語設定（中文/English/日本語）
+- 言語設定（簡体中文/繁體中文/English/日本語）
 - テーマ設定（システムに合わせる/ライト/ダーク）
 - ウィンドウ動作（起動時に自動実行、閉じる動作）
 

docs/user-manual/ja/1-getting-started/1.5-settings.md

@@ -9,11 +9,12 @@
 
 ## 言語設定
 
-CC Switch は 3 つの言語に対応しています：
+CC Switch は 4 つの言語に対応しています：
 
 | 言語     | 説明     |
 | -------- | -------- |
 | 簡体中文 | デフォルト言語 |
+| 繁體中文 | 繁体字中国語インターフェース |
 | English  | 英語インターフェース |
 | 日本語   | 日本語インターフェース |
 
@@ -124,8 +125,9 @@ CC Switch 自体のデータの保存場所で、デフォルトは `~/.cc-switc
 | Claude ディレクトリ   | `~/.claude/`   | Claude Code 設定ディレクトリ |
 | Codex ディレクトリ    | `~/.codex/`    | Codex 設定ディレクトリ       |
 | Gemini ディレクトリ   | `~/.gemini/`   | Gemini CLI 設定ディレクトリ  |
-| OpenCode ディレクトリ | `~/.opencode/` | OpenCode 設定ディレクトリ    |
+| OpenCode ディレクトリ | `~/.config/opencode/` | OpenCode 設定ディレクトリ    |
 | OpenClaw ディレクトリ | `~/.openclaw/` | OpenClaw 設定ディレクトリ    |
+| Hermes ディレクトリ   | `~/.hermes/`   | Hermes 設定ディレクトリ      |
 
 > **注意**：ディレクトリを変更した後はアプリの再起動が必要で、対応する CLI ツールも同じディレクトリを設定する必要があります。
 
@@ -133,14 +135,15 @@ CC Switch 自体のデータの保存場所で、デフォルトは `~/.cc-switc
 
 ### 設定のエクスポート
 
-「エクスポート」ボタンをクリックして、以下の内容を含むバックアップファイルを保存します：
+「エクスポート」ボタンをクリックして、以下の内容を含む SQL バックアップファイルを保存します：
 
 - すべてのプロバイダー設定
 - MCP サーバー設定
 - Prompts プリセット
+- 使用量ログ
 - アプリ設定
 
-バックアップファイルは JSON 形式で、テキストエディタで確認できます。
+エクスポートされるファイル名の形式は `cc-switch-export-{timestamp}.sql` です。
 
 ### 設定のインポート
 

docs/user-manual/ja/3-extensions/3.1-mcp.md

@@ -103,15 +103,16 @@ SSE プロトコルでサーバーと通信し、リアルタイムプッシュ
 | Claude | Claude Code に同期 | `~/.claude.json` の `mcpServers` |
 | Codex | Codex に同期 | `~/.codex/config.toml` の `[mcp_servers]` |
 | Gemini | Gemini CLI に同期 | `~/.gemini/settings.json` の `mcpServers` |
-| OpenCode | OpenCode に同期 | `~/.opencode/config.json` の `mcpServers` |
+| OpenCode | OpenCode に同期 | `~/.config/opencode/opencode.json` の `mcp` |
+| Hermes | Hermes に同期 | `~/.hermes/config.yaml` の `mcp_servers` |
 
-> **注意**：OpenClaw は現在 MCP サーバー管理に対応していません。MCP 機能は現在 Claude、Codex、Gemini、OpenCode の 4 つのアプリのみサポートしています。
+> **注意**：OpenClaw と Claude Desktop は現在 CC Switch MCP 同期に対応していません。MCP 機能は Claude、Codex、Gemini、OpenCode、Hermes に対応しています。
 
 ### スイッチの動作
 
 あるアプリのスイッチをオンにすると、CC Switch は以下を実行します：
 
-1. **データベースの更新**：サーバーの `apps.claude/codex/gemini/opencode` のステータスを `true` に設定
+1. **データベースの更新**：サーバーの `apps.claude/codex/gemini/opencode/hermes` のステータスを `true` に設定
 2. **Live 設定に同期**：サーバー設定を対応アプリの設定ファイルに書き込み
 3. **即時反映**：次回 CLI ツール起動時に新しい MCP サーバーが自動的にロード
 
@@ -128,7 +129,8 @@ MCP サーバーの同期は、対応アプリがインストールされてい
 - **Claude**：`~/.claude/` ディレクトリまたは `~/.claude.json` ファイルが存在する必要あり
 - **Codex**：`~/.codex/` ディレクトリが存在する必要あり
 - **Gemini**：`~/.gemini/` ディレクトリが存在する必要あり
-- **OpenCode**：`~/.opencode/` ディレクトリが存在する必要あり
+- **OpenCode**：`~/.config/opencode/` ディレクトリが存在する必要あり
+- **Hermes**：`~/.hermes/` ディレクトリが存在する必要あり
 
 > **ヒント**：CLI ツールがインストールされていない場合、対応するスイッチをオンにしてもエラーにはなりませんが、設定は書き込まれません。
 
@@ -154,7 +156,7 @@ MCP サーバーの同期は、対応アプリがインストールされてい
 CLI ツールで既に MCP サーバーを設定している場合、CC Switch にインポートできます：
 
 1. 「インポート」ボタンをクリック
-2. インポートするアプリを選択（Claude/Codex/Gemini/OpenCode）
+2. インポートするアプリを選択（Claude/Codex/Gemini/OpenCode/Hermes）
 3. CC Switch が既存の設定を読み取ってインポート
 
 ## 設定ファイル形式

docs/user-manual/ja/3-extensions/3.2-prompts.md

@@ -81,8 +81,7 @@ CC Switch を使用すると：
 | Claude | `~/.claude/CLAUDE.md` |
 | Codex | `~/.codex/AGENTS.md` |
 | Gemini | `~/.gemini/GEMINI.md` |
-| OpenCode | `~/.opencode/AGENTS.md` |
-| OpenClaw | `~/.openclaw/AGENTS.md` |
+| OpenCode | `~/.config/opencode/AGENTS.md` |
 
 ## プリセットの編集
 
@@ -141,7 +140,6 @@ Prompts はアプリごとに個別に管理されます：
 - Codex に切り替えると、Codex のプリセットが表示
 - Gemini に切り替えると、Gemini のプリセットが表示
 - OpenCode に切り替えると、OpenCode のプリセットが表示
-- OpenClaw に切り替えると、OpenClaw のプリセットが表示
 
 複数のアプリで同じプロンプトを使用する場合は、それぞれで作成する必要があります。
 

docs/user-manual/ja/3-extensions/3.3-skills.md

@@ -12,18 +12,17 @@ Skills は再利用可能な機能拡張で、AI ツールに特定分野の専
 
 ## 対応アプリ
 
-Skills 機能は以下の 4 つのアプリに対応しています：
+Skills 機能は以下の 5 つのアプリに対応しています：
 
 - **Claude Code**
 - **Codex**
 - **Gemini CLI**
 - **OpenCode**
+- **Hermes**
 
 ## Skills ページを開く
 
-上部ナビゲーションバーの **Skills** ボタンをクリックします。
-
-> 注意：Skills ボタンはすべてのアプリモードで表示されます。
+選択中のアプリが Skills に対応している場合、上部ナビゲーションバーの **Skills** ボタンをクリックします。
 
 ## ページ概要
 
@@ -93,7 +92,8 @@ CC Switch は強力な検索とフィルタリング機能を提供していま
 | Claude   | `~/.claude/skills/`   |
 | Codex    | `~/.codex/skills/`    |
 | Gemini   | `~/.gemini/skills/`   |
-| OpenCode | `~/.opencode/skills/` |
+| OpenCode | `~/.config/opencode/skills/` |
+| Hermes | `~/.hermes/skills/` |
 
 ### インストール内容
 
@@ -119,7 +119,7 @@ CC Switch は強力な検索とフィルタリング機能を提供していま
 ### アンインストールの効果
 
 - **自動バックアップ**：削除前にスキルが `~/.cc-switch/skill-backups/` にバックアップされる
-- すべてのアプリディレクトリ（Claude、Codex、Gemini、OpenCode）からスキルを削除
+- すべてのアプリディレクトリ（Claude、Codex、Gemini、OpenCode、Hermes）からスキルを削除
 - SSOT ディレクトリ（`~/.cc-switch/skills/`）からスキルを削除
 - データベースからスキルレコードを削除
 

docs/user-manual/ja/4-proxy/4.4-usage.md

@@ -215,9 +215,11 @@ Token 使用量の変化を表示：
 
 料金を照合する前に、CC Switch はリクエスト内のモデル ID を正規化します：
 
-- 最後の `/` より前の接頭辞を削除
-- `:` 以降の接尾辞を削除
+- 最後の `/` より前の接頭辞を削除し、小文字に変換
+- `:` 以降の接尾辞を削除し、末尾の `[1m]` を削除
 - `@` を `-` に置換
+- 一般的なラッパー接頭辞、バージョン接尾辞、日付接尾辞（`-YYYY-MM-DD`、`-YYYYMMDD`）を削除
+- 一部のモデルファミリーでは、短い ID からバージョン付き価格エントリに照合できます
 
 料金設定では、リクエスト内の完全な元のモデル名ではなく、正規化後のモデル ID を入力してください。
 
@@ -226,6 +228,10 @@ Token 使用量の変化を表示：
 | `stepfun-ai/step-3.5-flash` | `step-3.5-flash` | プロバイダー接頭辞を削除 |
 | `moonshotai/kimi-k2-0905:exa` | `kimi-k2-0905` | 接頭辞と `:` 以降を削除 |
 | `gpt-5.2-codex@low` | `gpt-5.2-codex-low` | `@` を `-` に置換 |
+| `OpenAI/GPT-5.5-2026-05-14` | `gpt-5.5` | 接頭辞と日付接尾辞を削除 |
+| `anthropic/claude-opus-4.8` | `claude-opus-4-8` | 接頭辞を削除し、ドット形式に照合 |
+| `global.anthropic.claude-opus-4-8-v1:0` | `claude-opus-4-8` | ラッパー接頭辞、バージョン接尾辞、`:` 以降を削除 |
+| `claude-haiku-4-5` | `claude-haiku-4-5-20251001` | 短い ID からバージョン付き価格に照合 |
 
 ### 操作
 

docs/user-manual/ja/5-faq/5.1-config-files.md

@@ -16,7 +16,7 @@
 ├── settings.json     # デバイスレベルの設定
 ├── skills/           # スキル SSOT ディレクトリ
 ├── skill-backups/    # スキルバックアップ（アンインストール時に作成）
-└── db_backup_*.db    # データベースバックアップ
+└── backups/          # データベースバックアップ
 ```
 
 ### データベースの内容
@@ -51,7 +51,8 @@
   "codexConfigDir": null,
   "geminiConfigDir": null,
   "opencodeConfigDir": null,
-  "openclawConfigDir": null
+  "openclawConfigDir": null,
+  "hermesConfigDir": null
 }
 ```
 
@@ -196,17 +197,41 @@ GEMINI_MODEL=gemini-pro
 
 ### 設定ディレクトリ
 
-デフォルト：`~/.opencode/`
+デフォルト：`~/.config/opencode/`
 
 ### 主要ファイル
 
 ```
-~/.opencode/
-├── config.json       # メイン設定ファイル
+~/.config/opencode/
+├── opencode.json     # メイン設定ファイル
 ├── AGENTS.md         # システムプロンプト
 └── skills/           # スキルディレクトリ
     └── ...
 ```
+## Hermes の設定
+
+### 設定ディレクトリ
+
+デフォルト：`~/.hermes/`
+
+### 主要ファイル
+
+```
+~/.hermes/
+├── config.yaml       # メイン設定、プロバイダー、MCP 設定
+├── .env              # API キーとシークレット
+├── SOUL.md           # Profile identity/persona
+├── memories/
+│   ├── MEMORY.md     # エージェント記憶
+│   └── USER.md       # ユーザープロファイル記憶
+├── skills/           # 有効なスキルディレクトリ
+├── state.db          # SQLite セッションデータベース
+└── sessions/         # Gateway transcript と任意の JSON snapshot
+```
+
+### config.yaml
+
+Hermes は YAML 設定を使用します。CC Switch は MCP サーバーを `mcp_servers` に書き込み、編集可能なプロバイダーエントリを `custom_providers` に書き込み、Hermes の `providers` dict にある読み取り専用エントリを読み取り、プロバイダー切り替え時に `model.provider` / `model.default` を更新します。
 
 ## OpenClaw の設定
 
@@ -219,7 +244,6 @@ GEMINI_MODEL=gemini-pro
 ```
 ~/.openclaw/
 ├── openclaw.json     # メイン設定ファイル（JSON5 形式）
-├── AGENTS.md         # システムプロンプト
 └── skills/           # スキルディレクトリ
     └── ...
 ```
@@ -246,18 +270,17 @@ OpenClaw は JSON5 形式の設定ファイルを使用し、主に以下のセ
   env: {
     ANTHROPIC_API_KEY: "sk-..."
   },
-  // Agent デフォルトモデル設定
+  // Agent デフォルト設定
   agents: {
     defaults: {
       model: {
         primary: "provider/model"
-      }
+      },
+      workspace: "~/.openclaw/workspace"
     }
   },
   // ツール設定
-  tools: {},
-  // ワークスペースファイル設定
-  workspace: {}
+  tools: {}
 }
 ```
 
@@ -267,7 +290,7 @@ OpenClaw は JSON5 形式の設定ファイルを使用し、主に以下のセ
 | `env` | 環境変数設定 |
 | `agents.defaults` | Agent デフォルトモデル設定 |
 | `tools` | ツール設定 |
-| `workspace` | ワークスペースファイル管理 |
+| `agents.defaults.workspace` | ワークスペースディレクトリパス |
 
 ## 設定の優先順位
 

docs/user-manual/ja/5-faq/5.2-questions.md

@@ -144,7 +144,7 @@ chmod +x CC-Switch-*.AppImage
 - バージョンの非互換性
 
 **解決方法**：
-1. ファイルが CC Switch からエクスポートされた JSON ファイルであることを確認
+1. ファイルが CC Switch からエクスポートされた SQL バックアップファイルであることを確認
 2. ファイル内容が完全であるか確認
 3. テキストエディタで開いてフォーマットを確認
 

docs/user-manual/ja/README.md

@@ -106,15 +106,15 @@ CC Switch ユーザーマニュアル
 
 ## バージョン情報
 
-- ドキュメントバージョン：v3.15.0
-- 最終更新：2026-05-16
-- CC Switch v3.15.0+ 対応
+- ドキュメントバージョン：v3.16.0
+- 最終更新：2026-05-29
+- CC Switch v3.16.0+ 対応
 
-### v3.15.0 の注目機能
+### v3.16.0 の注目機能
 
-- **Claude Desktop の一等管理パネル**：サードパーティプロバイダー、直結 / モデルマッピングの 2 モード、Copilot / Codex OAuth 再利用、3P profile 書き込みに対応 — 詳細は [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md)
-- **役割別モデルマッピング**：Sonnet / Opus / Haiku ルートと `supports1m` フラグで Claude Desktop のモデル検証に対応
-- **Claude Desktop ローカルルーティング**：変換が必要なプロバイダー向けに `127.0.0.1:15721/claude-desktop` のローカルゲートウェイを提供
+- **Codex Chat Completions ルーティング**：DeepSeek、Kimi、GLM、MiniMax など Chat 専用プロバイダーを Codex で利用可能 — 詳細は [2.1 プロバイダーの追加](./2-providers/2.1-add.md)
+- **管理対象 CLI ツールのライフサイクル**：設定 / About で Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes のインストール、更新、一括更新、診断に対応 — 詳細は [1.5 個人設定](./1-getting-started/1.5-settings.md)
+- **プロバイダーとモデルマトリクス更新**：提携プリセットを追加し、既定モデルと価格表を更新。Claude Opus は 4.8、該当する GPT 既定値は 5.5 に更新
 - **ルーティング対応バッジ**：Claude Code / Codex のプロバイダーカードで Local Routing 対応可否を確認可能
 - **Codex OAuth ライブモデル検出**：ChatGPT Codex 系プロバイダーは必要に応じて ChatGPT バックエンドから利用可能モデルを取得
 - **フィルター連動 Usage Hero**：キャッシュ正規化後の実消費 Token とキャッシュヒット率を表示し、日付 / プロバイダー / モデルフィルターに追従 — 詳細は [4.4 使用量統計](./4-proxy/4.4-usage.md)
@@ -124,7 +124,7 @@ CC Switch ユーザーマニュアル
 - **アプリ別トレイサブメニュー**：Claude / Codex / Gemini のサブメニューで現在のプロバイダーと使用量サマリーを確認可能 — 詳細は [2.2 プロバイダーの切り替え](./2-providers/2.2-switch.md)
 - **Skills の発見と一括更新**：SHA-256 ハッシュによる更新検出、一括更新、skills.sh 公式レジストリ検索 — 詳細は [3.3 Skills スキル管理](./3-extensions/3.3-skills.md)
 - **完全URLエンドポイントモード**：高度なオプションで `base_url` を完全なアップストリームエンドポイントとして扱う — 詳細は [2.1 プロバイダーの追加](./2-providers/2.1-add.md)
-- **OpenCode / OpenClaw ストリームチェック対応**：Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw をカバー — 詳細は [4.5 モデルテスト](./4-proxy/4.5-model-test.md)
+- **OpenCode / OpenClaw / Hermes ストリームチェック対応**：Stream Check は Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes をカバー — 詳細は [4.5 モデルテスト](./4-proxy/4.5-model-test.md)
 
 ## コントリビュート
 

docs/user-manual/zh/1-getting-started/1.1-introduction.md

@@ -2,7 +2,7 @@
 
 ## 什么是 CC Switch
 
-CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助你统一管理 **Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** 和 **Hermes** 等受管应用的配置。
+CC Switch 是一款跨平台桌面应用，专为使用 AI 工具的开发者设计。它帮助你统一管理 **Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** 和 **Hermes** 等受管应用的配置。
 
 ## 解决什么问题
 
@@ -45,7 +45,7 @@ CC Switch 通过统一的界面解决这些问题。
 | **Codex** | OpenAI 的代码生成工具 |
 | **Gemini CLI** | Google 的 AI 命令行工具 |
 | **OpenCode** | 开源 AI 编程终端工具 |
-| **OpenClaw** | 开源 AI 编程助手（多供应商网关） |
+| **OpenClaw** | 开源 AI 助手（多供应商网关） |
 | **Hermes** | Hermes Agent，支持供应商、MCP、Skills 和 Memory 管理 |
 
 ## 支持的平台

docs/user-manual/zh/1-getting-started/1.3-interface.md

@@ -12,7 +12,7 @@
 | ② | 设置按钮 | 打开设置页面（快捷键 `Cmd/Ctrl + ,`） |
 | ③ | 代理开关 | 启动/停止本地代理服务 |
 | ④ | 应用切换器 | 切换 Claude / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes |
-| ⑤ | 功能区 | Skills / Prompts / MCP 入口 |
+| ⑤ | 功能区 | 当前应用支持的功能入口 |
 | ⑥ | 添加按钮 | 添加新供应商 |
 
 ### 应用切换器
@@ -33,9 +33,9 @@
 
 | 按钮 | 功能 | 可见条件 |
 |------|------|----------|
-| Skills | 技能扩展管理 | 始终可见 |
-| Prompts | 系统提示词管理 | 始终可见 |
-| MCP | MCP 服务器管理 | 始终可见 |
+| Skills | 技能扩展管理 | Claude / Codex / Gemini / OpenCode / Hermes |
+| Prompts | 系统提示词管理 | Claude / Codex / Gemini / OpenCode |
+| MCP | MCP 服务器管理 | Claude / Codex / Gemini / OpenCode / Hermes |
 
 ## 供应商卡片
 
@@ -113,11 +113,12 @@ CC Switch 在系统托盘显示图标，提供快速操作入口。
 
 ### 多语言支持
 
-托盘菜单支持三种语言，根据设置自动切换：
+托盘菜单支持四种语言，根据设置自动切换：
 
 | 语言 | 打开主界面 | 退出 |
 |------|-----------|------|
-| 中文 | 打开主界面 | 退出 |
+| 简体中文 | 打开主界面 | 退出 |
+| 繁體中文 | 開啟主介面 | 退出 |
 | English | Open main window | Quit |
 | 日本語 | メインウィンドウを開く | 終了 |
 
@@ -147,7 +148,7 @@ CC Switch 在系统托盘显示图标，提供快速操作入口。
 
 ### 通用 Tab
 
-- 语言设置（中文/English/日本語）
+- 语言设置（简体中文/繁體中文/English/日本語）
 - 主题设置（跟随系统/浅色/深色）
 - 窗口行为（开机自启、关闭行为）
 

docs/user-manual/zh/1-getting-started/1.5-settings.md

@@ -9,11 +9,12 @@
 
 ## 语言设置
 
-CC Switch 支持三种语言：
+CC Switch 支持四种语言：
 
 | 语言     | 说明     |
 | -------- | -------- |
 | 简体中文 | 默认语言 |
+| 繁體中文 | 繁体中文界面 |
 | English  | 英文界面 |
 | 日本語   | 日文界面 |
 
@@ -124,8 +125,9 @@ CC Switch 自身数据的存储位置，默认为 `~/.cc-switch/`。
 | Claude 目录   | `~/.claude/`   | Claude Code 配置目录 |
 | Codex 目录    | `~/.codex/`    | Codex 配置目录       |
 | Gemini 目录   | `~/.gemini/`   | Gemini CLI 配置目录  |
-| OpenCode 目录 | `~/.opencode/` | OpenCode 配置目录    |
+| OpenCode 目录 | `~/.config/opencode/` | OpenCode 配置目录    |
 | OpenClaw 目录 | `~/.openclaw/` | OpenClaw 配置目录    |
+| Hermes 目录   | `~/.hermes/`   | Hermes 配置目录      |
 
 > ⚠️ **注意**：修改目录后需要重启应用，且对应的 CLI 工具也需要配置相同的目录。
 
@@ -133,14 +135,15 @@ CC Switch 自身数据的存储位置，默认为 `~/.cc-switch/`。
 
 ### 导出配置
 
-点击「导出」按钮，保存包含以下内容的备份文件：
+点击「导出」按钮，保存包含以下内容的 SQL 备份文件：
 
 - 所有供应商配置
 - MCP 服务器配置
 - Prompts 预设
+- 用量日志
 - 应用设置
 
-备份文件格式为 JSON，可以用文本编辑器查看。
+导出文件名格式为 `cc-switch-export-{timestamp}.sql`。
 
 ### 导入配置
 

docs/user-manual/zh/3-extensions/3.1-mcp.md

@@ -103,15 +103,16 @@ MCP (Model Context Protocol) 是一种协议，允许 AI 工具访问外部数
 | Claude | 同步到 Claude Code | `~/.claude.json` 的 `mcpServers` |
 | Codex | 同步到 Codex | `~/.codex/config.toml` 的 `[mcp_servers]` |
 | Gemini | 同步到 Gemini CLI | `~/.gemini/settings.json` 的 `mcpServers` |
-| OpenCode | 同步到 OpenCode | `~/.opencode/config.json` 的 `mcpServers` |
+| OpenCode | 同步到 OpenCode | `~/.config/opencode/opencode.json` 的 `mcp` |
+| Hermes | 同步到 Hermes | `~/.hermes/config.yaml` 的 `mcp_servers` |
 
-> ⚠️ **注意**：OpenClaw 暂不支持 MCP 服务器管理。MCP 功能目前仅支持 Claude、Codex、Gemini 和 OpenCode 四个应用。
+> ⚠️ **注意**：OpenClaw 和 Claude Desktop 暂不支持 CC Switch MCP 同步。MCP 功能支持 Claude、Codex、Gemini、OpenCode 和 Hermes。
 
 ### 开关实现机制
 
 当开启某个应用的开关时，CC Switch 会：
 
-1. **更新数据库**：将服务器的 `apps.claude/codex/gemini/opencode` 状态设为 `true`
+1. **更新数据库**：将服务器的 `apps.claude/codex/gemini/opencode/hermes` 状态设为 `true`
 2. **同步到 Live 配置**：将服务器配置写入对应应用的配置文件
 3. **即时生效**：下次启动 CLI 工具时自动加载新的 MCP 服务器
 
@@ -128,7 +129,8 @@ MCP 服务器同步仅在对应应用已安装时执行：
 - **Claude**：需存在 `~/.claude/` 目录或 `~/.claude.json` 文件
 - **Codex**：需存在 `~/.codex/` 目录
 - **Gemini**：需存在 `~/.gemini/` 目录
-- **OpenCode**：需存在 `~/.opencode/` 目录
+- **OpenCode**：需存在 `~/.config/opencode/` 目录
+- **Hermes**：需存在 `~/.hermes/` 目录
 
 > 💡 **提示**：如果某个 CLI 工具未安装，开启对应开关不会报错，但配置不会写入。
 
@@ -154,7 +156,7 @@ MCP 服务器同步仅在对应应用已安装时执行：
 如果你已经在 CLI 工具中配置了 MCP 服务器，可以导入到 CC Switch：
 
 1. 点击「导入」按钮
-2. 选择要导入的应用（Claude/Codex/Gemini/OpenCode）
+2. 选择要导入的应用（Claude/Codex/Gemini/OpenCode/Hermes）
 3. CC Switch 会读取现有配置并导入
 
 ## 配置文件格式

docs/user-manual/zh/3-extensions/3.2-prompts.md

@@ -81,8 +81,7 @@ Prompts 功能用于管理系统提示词预设。系统提示词会影响 AI
 | Claude | `~/.claude/CLAUDE.md` |
 | Codex | `~/.codex/AGENTS.md` |
 | Gemini | `~/.gemini/GEMINI.md` |
-| OpenCode | `~/.opencode/AGENTS.md` |
-| OpenClaw | `~/.openclaw/AGENTS.md` |
+| OpenCode | `~/.config/opencode/AGENTS.md` |
 
 ## 编辑预设
 
@@ -141,7 +140,6 @@ Prompts 是按应用分开管理的：
 - 切换到 Codex 时，显示 Codex 的预设
 - 切换到 Gemini 时，显示 Gemini 的预设
 - 切换到 OpenCode 时，显示 OpenCode 的预设
-- 切换到 OpenClaw 时，显示 OpenClaw 的预设
 
 如需在多个应用使用相同的提示词，需要分别创建。
 

docs/user-manual/zh/3-extensions/3.3-skills.md

@@ -12,18 +12,17 @@ Skills 是可复用的能力扩展，让 AI 工具获得特定领域的专业能
 
 ## 支持的应用
 
-Skills 功能支持所有四种应用：
+Skills 功能支持五种应用：
 
 - **Claude Code**
 - **Codex**
 - **Gemini CLI**
 - **OpenCode**
+- **Hermes**
 
 ## 打开 Skills 页面
 
-点击顶部导航栏的 **Skills** 按钮。
-
-> 注意：Skills 按钮在所有应用模式下均可见。
+当当前应用支持 Skills 时，点击顶部导航栏的 **Skills** 按钮。
 
 ## 页面概览
 
@@ -93,7 +92,8 @@ CC Switch 提供强大的搜索和过滤功能：
 | Claude   | `~/.claude/skills/`   |
 | Codex    | `~/.codex/skills/`    |
 | Gemini   | `~/.gemini/skills/`   |
-| OpenCode | `~/.opencode/skills/` |
+| OpenCode | `~/.config/opencode/skills/` |
+| Hermes | `~/.hermes/skills/` |
 
 ### 安装内容
 
@@ -119,7 +119,7 @@ CC Switch 提供强大的搜索和过滤功能：
 ### 卸载效果
 
 - **自动备份**：删除前，技能会被备份到 `~/.cc-switch/skill-backups/`
-- 从所有应用目录（Claude、Codex、Gemini、OpenCode）移除技能
+- 从所有应用目录（Claude、Codex、Gemini、OpenCode、Hermes）移除技能
 - 从 SSOT 目录（`~/.cc-switch/skills/`）移除技能
 - 从数据库删除技能记录
 

docs/user-manual/zh/4-proxy/4.4-usage.md

@@ -215,9 +215,11 @@ v3.15.0 起，用量页顶部改为筛选驱动的 Hero 卡。切换日期范围
 
 在匹配定价前，CC Switch 会先对请求中的模型 ID 做标准化处理：
 
-- 去掉最后一个 `/` 之前的前缀
-- 去掉 `:` 之后的后缀
+- 去掉最后一个 `/` 之前的前缀，并转成小写
+- 去掉 `:` 之后的后缀，去掉末尾的 `[1m]`
 - 将 `@` 替换为 `-`
+- 去掉常见包装前缀、版本后缀、日期后缀（`-YYYY-MM-DD`、`-YYYYMMDD`）
+- 部分模型族支持短 ID 匹配带版本的定价项
 
 因此，在定价配置中请填写清洗后的模型 ID，而不是请求里的完整原始模型名。
 
@@ -226,6 +228,10 @@ v3.15.0 起，用量页顶部改为筛选驱动的 Hero 卡。切换日期范围
 | `stepfun-ai/step-3.5-flash` | `step-3.5-flash` | 去掉供应商前缀 |
 | `moonshotai/kimi-k2-0905:exa` | `kimi-k2-0905` | 去掉前缀和 `:` 后缀 |
 | `gpt-5.2-codex@low` | `gpt-5.2-codex-low` | 将 `@` 替换为 `-` |
+| `OpenAI/GPT-5.5-2026-05-14` | `gpt-5.5` | 去掉前缀和日期后缀 |
+| `anthropic/claude-opus-4.8` | `claude-opus-4-8` | 去掉前缀并匹配点号格式 |
+| `global.anthropic.claude-opus-4-8-v1:0` | `claude-opus-4-8` | 去掉包装前缀、版本后缀和 `:` 后缀 |
+| `claude-haiku-4-5` | `claude-haiku-4-5-20251001` | 短 ID 匹配带版本定价 |
 
 ### 操作
 

docs/user-manual/zh/5-faq/5.1-config-files.md

@@ -16,7 +16,7 @@
 ├── settings.json     # 设备级设置
 ├── skills/           # 技能 SSOT 目录
 ├── skill-backups/    # 技能备份（卸载时创建）
-└── db_backup_*.db    # 数据库备份
+└── backups/          # 数据库备份
 ```
 
 ### 数据库内容
@@ -51,7 +51,8 @@
   "codexConfigDir": null,
   "geminiConfigDir": null,
   "opencodeConfigDir": null,
-  "openclawConfigDir": null
+  "openclawConfigDir": null,
+  "hermesConfigDir": null
 }
 ```
 
@@ -196,17 +197,41 @@ GEMINI_MODEL=gemini-pro
 
 ### 配置目录
 
-默认：`~/.opencode/`
+默认：`~/.config/opencode/`
 
 ### 主要文件
 
 ```
-~/.opencode/
-├── config.json       # 主配置文件
+~/.config/opencode/
+├── opencode.json     # 主配置文件
 ├── AGENTS.md         # 系统提示词
 └── skills/           # 技能目录
     └── ...
 ```
+## Hermes 配置
+
+### 配置目录
+
+默认：`~/.hermes/`
+
+### 主要文件
+
+```
+~/.hermes/
+├── config.yaml       # 主设置、供应商与 MCP 配置
+├── .env              # API keys 与 secrets
+├── SOUL.md           # Profile 身份/人格
+├── memories/
+│   ├── MEMORY.md     # Agent 记忆
+│   └── USER.md       # 用户画像记忆
+├── skills/           # 活跃技能目录
+├── state.db          # SQLite 会话数据库
+└── sessions/         # Gateway 转录与可选 JSON 快照
+```
+
+### config.yaml
+
+Hermes 使用 YAML 配置。CC Switch 将 MCP 服务器写入 `mcp_servers`，将可编辑的供应商条目写入 `custom_providers`，读取 Hermes `providers` 字典中的只读条目，并在切换供应商时更新 `model.provider` / `model.default`。
 
 ## OpenClaw 配置
 
@@ -219,7 +244,6 @@ GEMINI_MODEL=gemini-pro
 ```
 ~/.openclaw/
 ├── openclaw.json     # 主配置文件（JSON5 格式）
-├── AGENTS.md         # 系统提示词
 └── skills/           # 技能目录
     └── ...
 ```
@@ -246,18 +270,17 @@ OpenClaw 使用 JSON5 格式配置文件，主要包含以下部分：
   env: {
     ANTHROPIC_API_KEY: "sk-..."
   },
-  // Agent 默认模型配置
+  // Agent 默认配置
   agents: {
     defaults: {
       model: {
         primary: "provider/model"
-      }
+      },
+      workspace: "~/.openclaw/workspace"
     }
   },
   // 工具配置
-  tools: {},
-  // 工作区文件配置
-  workspace: {}
+  tools: {}
 }
 ```
 
@@ -267,7 +290,7 @@ OpenClaw 使用 JSON5 格式配置文件，主要包含以下部分：
 | `env` | 环境变量配置 |
 | `agents.defaults` | Agent 默认模型设置 |
 | `tools` | 工具配置 |
-| `workspace` | 工作区文件管理 |
+| `agents.defaults.workspace` | 工作区目录路径 |
 
 ## 配置优先级
 

docs/user-manual/zh/5-faq/5.2-questions.md

@@ -144,7 +144,7 @@ chmod +x CC-Switch-*.AppImage
 - 版本不兼容
 
 **解决方法**：
-1. 确认文件是 CC Switch 导出的 JSON 文件
+1. 确认文件是 CC Switch 导出的 SQL 备份文件
 2. 检查文件内容是否完整
 3. 尝试用文本编辑器打开检查格式
 

docs/user-manual/zh/README.md

@@ -106,15 +106,15 @@
 
 ## 版本信息
 
-- 文档版本：v3.15.0
-- 最后更新：2026-05-16
-- 适用于 CC Switch v3.15.0+
+- 文档版本：v3.16.0
+- 最后更新：2026-05-29
+- 适用于 CC Switch v3.16.0+
 
-### v3.15.0 亮点
+### v3.16.0 亮点
 
-- **Claude Desktop 一等管理面板**：支持第三方供应商、直连 / 模型映射两种模式、Copilot / Codex OAuth 复用与 3P profile 写入 — 详见 [2.6 Claude Desktop](./2-providers/2.6-claude-desktop.md)
-- **按角色的模型映射**：用 Sonnet / Opus / Haiku 路由和 `supports1m` 标志适配 Claude Desktop 的模型校验
-- **Claude Desktop 本地路由**：通过 `127.0.0.1:15721/claude-desktop` 为需要转换的供应商提供本地网关
+- **Codex Chat Completions 路由**：DeepSeek、Kimi、GLM、MiniMax 等仅支持 Chat 协议的供应商可通过 Codex 使用 — 详见 [2.1 添加供应商](./2-providers/2.1-add.md)
+- **托管 CLI 工具生命周期**：在设置 / 关于页安装、升级、全部升级并诊断 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes — 详见 [1.5 个性化配置](./1-getting-started/1.5-settings.md)
+- **供应商与模型矩阵刷新**：新增合作方预设，刷新默认模型与计费矩阵，Claude Opus 默认升级到 4.8，适用场景下 GPT 默认升级到 5.5
 - **路由支持徽章**：Claude Code / Codex 供应商卡片会标明是否支持 Local Routing，便于选择可代理的供应商
 - **Codex OAuth 实时模型发现**：ChatGPT Codex 类供应商按需从 ChatGPT 后端拉取最新模型列表
 - **用量看板筛选驱动 Hero**：展示缓存归一化后的真实总 token 与缓存命中率，并跟随日期 / 供应商 / 模型筛选实时更新 — 详见 [4.4 用量统计](./4-proxy/4.4-usage.md)
@@ -124,7 +124,7 @@
 - **托盘按应用分级菜单**：Claude / Codex / Gemini 独立子菜单，标题展示当前供应商与可用用量摘要 — 详见 [2.2 切换供应商](./2-providers/2.2-switch.md)
 - **Skills 发现与批量更新**：SHA-256 更新检测、批量更新、skills.sh 公共注册表搜索 — 详见 [3.3 Skills 技能管理](./3-extensions/3.3-skills.md)
 - **完整 URL 端点模式**：高级选项支持将 base_url 视作完整上游端点 — 详见 [2.1 添加供应商](./2-providers/2.1-add.md)
-- **OpenCode / OpenClaw 流式检测覆盖**：Stream Check 面板覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw — 详见 [4.5 模型检查](./4-proxy/4.5-model-test.md)
+- **OpenCode / OpenClaw / Hermes 流式检测覆盖**：Stream Check 面板覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes — 详见 [4.5 模型检查](./4-proxy/4.5-model-test.md)
 
 ## 贡献