From 693c3872f042d3a578f4a45aa9897542a620b262 Mon Sep 17 00:00:00 2001 From: makoMakoGo <48956204+makoMakoGo@users.noreply.github.com> Date: Tue, 2 Jun 2026 22:17:42 +0800 Subject: [PATCH] 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 --- README.md | 34 +++++++------- README_DE.md | 32 ++++++------- README_JA.md | 32 ++++++------- README_ZH.md | 32 ++++++------- docs/user-manual/README.md | 8 ++-- .../en/1-getting-started/1.1-introduction.md | 4 +- .../en/1-getting-started/1.3-interface.md | 17 +++---- .../en/1-getting-started/1.5-settings.md | 11 +++-- docs/user-manual/en/3-extensions/3.1-mcp.md | 12 +++-- .../en/3-extensions/3.2-prompts.md | 4 +- .../user-manual/en/3-extensions/3.3-skills.md | 12 ++--- docs/user-manual/en/4-proxy/4.4-usage.md | 10 +++- docs/user-manual/en/5-faq/5.1-config-files.md | 47 ++++++++++++++----- docs/user-manual/en/README.md | 16 +++---- .../ja/1-getting-started/1.1-introduction.md | 4 +- .../ja/1-getting-started/1.3-interface.md | 15 +++--- .../ja/1-getting-started/1.5-settings.md | 11 +++-- docs/user-manual/ja/3-extensions/3.1-mcp.md | 12 +++-- .../ja/3-extensions/3.2-prompts.md | 4 +- .../user-manual/ja/3-extensions/3.3-skills.md | 12 ++--- docs/user-manual/ja/4-proxy/4.4-usage.md | 10 +++- docs/user-manual/ja/5-faq/5.1-config-files.md | 47 ++++++++++++++----- docs/user-manual/ja/5-faq/5.2-questions.md | 2 +- docs/user-manual/ja/README.md | 16 +++---- .../zh/1-getting-started/1.1-introduction.md | 4 +- .../zh/1-getting-started/1.3-interface.md | 15 +++--- .../zh/1-getting-started/1.5-settings.md | 11 +++-- docs/user-manual/zh/3-extensions/3.1-mcp.md | 12 +++-- .../zh/3-extensions/3.2-prompts.md | 4 +- .../user-manual/zh/3-extensions/3.3-skills.md | 12 ++--- docs/user-manual/zh/4-proxy/4.4-usage.md | 10 +++- docs/user-manual/zh/5-faq/5.1-config-files.md | 47 ++++++++++++++----- docs/user-manual/zh/5-faq/5.2-questions.md | 2 +- docs/user-manual/zh/README.md | 16 +++---- 34 files changed, 318 insertions(+), 219 deletions(-) diff --git a/README.md b/README.md index 57daf7d60..7b79b25b9 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ # CC Switch -### The All-in-One Manager for Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw & Hermes Agent +### The All-in-One Manager for Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw & Hermes Agent [![Version](https://img.shields.io/github/v/release/farion1231/cc-switch?color=blue&label=version)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) @@ -152,13 +152,13 @@ Register now via this lin ## Why CC Switch? -Modern AI-powered coding relies on CLI tools like Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw — but each has its own configuration format. Switching API providers means manually editing JSON, TOML, or `.env` files, and there is no unified way to manage MCP and Skills across multiple tools. +Modern AI-powered coding relies on tools like Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes — but each has its own configuration format. Switching API providers means manually editing JSON, TOML, or `.env` files, and there is no unified way to manage MCP and Skills across multiple tools. -**CC Switch** gives you a single desktop app to manage all five CLI tools. Instead of editing config files by hand, you get a visual interface to import providers with one click, switch between them instantly, with 50+ built-in provider presets, unified MCP and Skills management, and system tray quick switching — all backed by a reliable SQLite database with atomic writes that protect your configs from corruption. +**CC Switch** gives you a single desktop app to manage all supported AI tools. Instead of editing config files by hand, you get a visual interface to import providers with one click, switch between them instantly, with 50+ built-in provider presets, unified MCP and Skills management, and system tray quick switching — all backed by a reliable SQLite database with atomic writes that protect your configs from corruption. -- **One App, Five CLI Tools** — Manage Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw from a single interface +- **One App, Seven Tools** — Manage Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes from a single interface - **No More Manual Editing** — 50+ provider presets including AWS Bedrock, NVIDIA NIM, and community relays; just pick and switch -- **Unified MCP & Skills Management** — One panel to manage MCP servers and Skills across four apps with bidirectional sync +- **Unified MCP & Skills Management** — One panel to manage MCP servers and Skills across Claude, Codex, Gemini, OpenCode, and Hermes with bidirectional sync - **System Tray Quick Switch** — Switch providers instantly from the tray menu, no need to open the full app - **Cloud Sync** — Sync provider data across devices via Dropbox, OneDrive, iCloud, or WebDAV servers - **Cross-Platform** — Native desktop app for Windows, macOS, and Linux, built with Tauri 2 @@ -172,12 +172,12 @@ Modern AI-powered coding relies on CLI tools like Claude Code, Codex, Gemini CLI ## Features -[Full Changelog](CHANGELOG.md) | [Release Notes](docs/release-notes/v3.15.0-en.md) +[Full Changelog](CHANGELOG.md) | [Release Notes](docs/release-notes/v3.16.0-en.md) ### Provider Management -- **5 CLI tools, 50+ presets** — Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw; copy your key and import with one click -- **Universal providers** — One config syncs to multiple apps (OpenCode, OpenClaw) +- **7 supported tools, 50+ presets** — Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes; copy your key and import with one click +- **Universal providers** — One config syncs to Claude Code, Codex, and Gemini CLI - One-click switching, system tray quick access, drag-and-drop sorting, import/export ### Proxy & Failover @@ -187,7 +187,7 @@ Modern AI-powered coding relies on CLI tools like Claude Code, Codex, Gemini CLI ### MCP, Prompts & Skills -- **Unified MCP panel** — Manage MCP servers across 4 apps with bidirectional sync and Deep Link import +- **Unified MCP panel** — Manage MCP servers across Claude, Codex, Gemini, OpenCode, and Hermes with bidirectional sync and Deep Link import - **Prompts** — Markdown editor with cross-app sync (CLAUDE.md / AGENTS.md / GEMINI.md) and backfill protection - **Skills** — One-click install from GitHub repos or ZIP files, custom repository management, with symlink and file copy support @@ -197,21 +197,21 @@ Modern AI-powered coding relies on CLI tools like Claude Code, Codex, Gemini CLI ### Session Manager & Workspace -- Browse, search, and restore conversation history across all apps +- Browse, search, and restore conversation history across supported session sources - **Workspace editor** (OpenClaw) — Edit agent files (AGENTS.md, SOUL.md, etc.) with Markdown preview ### System & Platform - **Cloud sync** — Custom config directory (Dropbox, OneDrive, iCloud, NAS) and WebDAV server sync - **Deep Link** (`ccswitch://`) — Import providers, MCP servers, prompts, and skills via URL -- Dark / Light / System theme, auto-launch, auto-updater, atomic writes, auto-backups, i18n (zh/en/ja) +- Dark / Light / System theme, auto-launch, auto-updater, atomic writes, auto-backups, i18n (zh/zh-TW/en/ja) ## FAQ
-Which AI CLI tools does CC Switch support? +Which AI tools does CC Switch support? -CC Switch supports five tools: **Claude Code**, **Codex**, **Gemini CLI**, **OpenCode**, and **OpenClaw**. Each tool has dedicated provider presets and configuration management. +CC Switch supports seven tools: **Claude Code**, **Claude Desktop**, **Codex**, **Gemini CLI**, **OpenCode**, **OpenClaw**, and **Hermes**. Each tool has dedicated provider presets and configuration management.
@@ -280,8 +280,8 @@ For detailed guides on every feature, check out the **[User Manual](docs/user-ma - **MCP**: Click the "MCP" button → Add servers via templates or custom config → Toggle per-app sync - **Prompts**: Click "Prompts" → Create presets with Markdown editor → Activate to sync to live files -- **Skills**: Click "Skills" → Browse GitHub repos → One-click install to all apps -- **Sessions**: Click "Sessions" → Browse, search, and restore conversation history across all apps +- **Skills**: Click "Skills" → Browse GitHub repos → One-click install to supported apps +- **Sessions**: Click "Sessions" → Browse, search, and restore conversation history across supported session sources > **Note**: On first launch, you can manually import existing CLI tool configs as the default provider. @@ -372,7 +372,7 @@ Download the latest Linux build from the [Releases](../../releases) page: - **ProviderService**: Provider CRUD, switching, backfill, sorting - **McpService**: MCP server management, import/export, live file sync - **ProxyService**: Local proxy mode with hot-switching and format conversion -- **SessionManager**: Conversation history browsing across all supported apps +- **SessionManager**: Conversation history browsing across supported session sources - **ConfigService**: Config import/export, backup rotation - **SpeedtestService**: API endpoint latency measurement @@ -494,7 +494,7 @@ pnpm test:unit --coverage │ ├── lib/ │ │ ├── api/ # Tauri API wrapper (type-safe) │ │ └── query/ # TanStack Query config -│ ├── locales/ # Translations (zh/en/ja) +│ ├── locales/ # Translations (zh/zh-TW/en/ja) │ ├── config/ # Presets (providers/mcp) │ └── types/ # TypeScript definitions ├── src-tauri/ # Backend (Rust) diff --git a/README_DE.md b/README_DE.md index fc635ce19..84f6055da 100644 --- a/README_DE.md +++ b/README_DE.md @@ -2,7 +2,7 @@ # CC Switch -### Der All-in-One-Manager für Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw & Hermes Agent +### Der All-in-One-Manager für Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw & Hermes Agent [![Version](https://img.shields.io/github/v/release/farion1231/cc-switch?color=blue&label=version)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) @@ -152,13 +152,13 @@ Registrieren Sie sich jetzt über **Hinweis**: Beim Erststart können Sie bestehende CLI-Werkzeug-Konfigurationen manuell als Standardanbieter importieren. @@ -494,7 +494,7 @@ pnpm test:unit --coverage │ ├── lib/ │ │ ├── api/ # Tauri-API-Wrapper (typsicher) │ │ └── query/ # TanStack-Query-Konfiguration -│ ├── locales/ # Übersetzungen (zh/en/ja) +│ ├── locales/ # Übersetzungen (zh/zh-TW/en/ja) │ ├── config/ # Presets (providers/mcp) │ └── types/ # TypeScript-Definitionen ├── src-tauri/ # Backend (Rust) diff --git a/README_JA.md b/README_JA.md index 890c70e7d..d76d44e30 100644 --- a/README_JA.md +++ b/README_JA.md @@ -2,7 +2,7 @@ # CC Switch -### Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent のオールインワン管理ツール +### Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent のオールインワン管理ツール [![Version](https://img.shields.io/github/v/release/farion1231/cc-switch?color=blue&label=version)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) @@ -151,13 +151,13 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% / ## CC Switch を選ぶ理由 -最新の AI コーディングは Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw などの CLI ツールに依存していますが、各ツールの設定形式はバラバラです。API プロバイダを切り替えるたびに JSON、TOML、`.env` ファイルを手動で編集する必要があり、複数ツール間で MCP や Skills を統一的に管理する手段もありません。 +最新の AI コーディングは Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes などのツールに依存していますが、各ツールの設定形式はバラバラです。API プロバイダを切り替えるたびに JSON、TOML、`.env` ファイルを手動で編集する必要があり、複数ツール間で MCP や Skills を統一的に管理する手段もありません。 -**CC Switch** は、5 つの CLI ツールを 1 つのデスクトップアプリで一元管理できます。設定ファイルを手作業で編集する代わりに、ワンクリックでプロバイダをインポートし、瞬時に切り替えられるビジュアルインターフェースを提供します。50 以上の組み込みプリセット、統一 MCP・Skills 管理、システムトレイからの即時切り替え機能を搭載。すべてはアトミック書き込みによる信頼性の高い SQLite データベースに支えられており、設定の破損を防ぎます。 +**CC Switch** は、対応する AI ツールを 1 つのデスクトップアプリで一元管理できます。設定ファイルを手作業で編集する代わりに、ワンクリックでプロバイダをインポートし、瞬時に切り替えられるビジュアルインターフェースを提供します。50 以上の組み込みプリセット、統一 MCP・Skills 管理、システムトレイからの即時切り替え機能を搭載。すべてはアトミック書き込みによる信頼性の高い SQLite データベースに支えられており、設定の破損を防ぎます。 -- **1 つのアプリで 5 つの CLI ツール** -- Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw を単一インターフェースで管理 +- **1 つのアプリで 7 つのツール** -- Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes を単一インターフェースで管理 - **手動編集は不要** -- AWS Bedrock、NVIDIA NIM、コミュニティリレーなど 50 以上のプロバイダプリセットを内蔵。選んで切り替えるだけ -- **統一 MCP・Skills 管理** -- 1 つのパネルで 4 つのアプリの MCP サーバーと Skills を双方向同期で管理 +- **統一 MCP・Skills 管理** -- 1 つのパネルで Claude、Codex、Gemini、OpenCode、Hermes の MCP サーバーと Skills を双方向同期で管理 - **システムトレイでクイック切り替え** -- トレイメニューから即座にプロバイダを切り替え。アプリを開く必要なし - **クラウド同期** -- Dropbox、OneDrive、iCloud、または WebDAV サーバー経由でデバイス間のプロバイダデータを同期 - **クロスプラットフォーム** -- Tauri 2 で構築された Windows、macOS、Linux 対応のネイティブデスクトップアプリ @@ -171,12 +171,12 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% / ## 特長 -[完全な更新履歴](CHANGELOG.md) | [リリースノート](docs/release-notes/v3.15.0-ja.md) +[完全な更新履歴](CHANGELOG.md) | [リリースノート](docs/release-notes/v3.16.0-ja.md) ### プロバイダ管理 -- **5 つの CLI ツール、50 以上のプリセット** -- Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw。キーをコピーしてワンクリックでインポート -- **ユニバーサルプロバイダ** -- 1 つの設定を複数アプリに同期（OpenCode、OpenClaw） +- **7 つの対応ツール、50 以上のプリセット** -- Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes。キーをコピーしてワンクリックでインポート +- **ユニバーサルプロバイダ** -- 1 つの設定を Claude Code、Codex、Gemini CLI に同期 - ワンクリック切り替え、システムトレイクイックアクセス、ドラッグ＆ドロップ並び替え、インポート/エクスポート ### プロキシ & フェイルオーバー @@ -186,7 +186,7 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% / ### MCP、Prompts & Skills -- **統一 MCP パネル** -- 4 つのアプリの MCP サーバーを管理、双方向同期、Deep Link インポート対応 +- **統一 MCP パネル** -- Claude、Codex、Gemini、OpenCode、Hermes の MCP サーバーを管理、双方向同期、Deep Link インポート対応 - **Prompts** -- Markdown エディタ、クロスアプリ同期（CLAUDE.md / AGENTS.md / GEMINI.md）、バックフィル保護 - **Skills** -- GitHub リポジトリまたは ZIP ファイルからワンクリックインストール、カスタムリポジトリ管理、シンボリックリンクとファイルコピーに対応 @@ -196,21 +196,21 @@ Claude Code / Codex / Gemini 公式チャンネルが最安で元価格の 38% / ### Session Manager & ワークスペース -- すべてのアプリの会話履歴を閲覧・検索・復元 +- 対応するセッションソースの会話履歴を閲覧・検索・復元 - **ワークスペースエディタ**（OpenClaw）-- エージェントファイル（AGENTS.md、SOUL.md など）を Markdown プレビュー付きで編集 ### システム & プラットフォーム - **クラウド同期** -- カスタム設定ディレクトリ（Dropbox、OneDrive、iCloud、NAS）および WebDAV サーバー同期 - **Deep Link** (`ccswitch://`) -- URL 経由でプロバイダ、MCP サーバー、Prompts、Skills をワンクリックインポート -- ダーク / ライト / システムテーマ、自動起動、自動アップデーター、アトミック書き込み、自動バックアップ、多言語対応（中/英/日） +- ダーク / ライト / システムテーマ、自動起動、自動アップデーター、アトミック書き込み、自動バックアップ、多言語対応（簡体中文/繁體中文/英/日） ## よくある質問
-CC Switch はどの AI CLI ツールに対応していますか？ +CC Switch はどの AI ツールに対応していますか？ -CC Switch は **Claude Code**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** の 5 つのツールに対応しています。各ツールに専用のプロバイダプリセットと設定管理が用意されています。 +CC Switch は **Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw**、**Hermes** の 7 つのツールに対応しています。各ツールに専用のプロバイダプリセットと設定管理が用意されています。
@@ -279,8 +279,8 @@ CC Switch は「最小限の介入」という設計原則に従っています - **MCP**: 「MCP」ボタンをクリック → テンプレートまたはカスタム設定でサーバーを追加 → アプリごとの同期をトグルで切り替え - **Prompts**: 「Prompts」をクリック → Markdown エディタでプリセットを作成 → 有効化してライブファイルに同期 -- **Skills**: 「Skills」をクリック → GitHub リポジトリを閲覧 → ワンクリックですべてのアプリにインストール -- **Sessions**: 「Sessions」をクリック → すべてのアプリの会話履歴を閲覧・検索・復元 +- **Skills**: 「Skills」をクリック → GitHub リポジトリを閲覧 → 対応アプリへワンクリックでインストール +- **Sessions**: 「Sessions」をクリック → 対応するセッションソースの会話履歴を閲覧・検索・復元 > **補足**: 初回起動時に、既存の CLI ツール設定を手動でインポートしてデフォルトプロバイダとして使用できます。 @@ -493,7 +493,7 @@ pnpm test:unit --coverage │ ├── lib/ │ │ ├── api/ # Tauri API ラッパー（型安全） │ │ └── query/ # TanStack Query 設定 -│ ├── locales/ # 翻訳 (zh/en/ja) +│ ├── locales/ # 翻訳 (zh/zh-TW/en/ja) │ ├── config/ # プリセット (providers/mcp) │ └── types/ # TypeScript 型定義 ├── src-tauri/ # バックエンド (Rust) diff --git a/README_ZH.md b/README_ZH.md index a5f42d746..fb05d6fe6 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -2,7 +2,7 @@ # CC Switch -### Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的全方位管理工具 +### Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的全方位管理工具 [![Version](https://img.shields.io/github/v/release/farion1231/cc-switch?color=blue&label=version)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) @@ -152,13 +152,13 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更 ## 为什么选择 CC Switch？ -现代 AI 编程依赖于 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等 CLI 工具——但每个工具都有自己的配置格式。切换 API 供应商意味着手动编辑 JSON、TOML 或 `.env` 文件，而在多个工具之间缺乏一个统一管理 MCP, SKILLS 的方式。 +现代 AI 编程依赖于 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes 等工具——但每个工具都有自己的配置格式。切换 API 供应商意味着手动编辑 JSON、TOML 或 `.env` 文件，而在多个工具之间缺乏一个统一管理 MCP, SKILLS 的方式。 -**CC Switch** 为你提供一个桌面应用来管理所有五个 CLI 工具。无需手动编辑配置文件，你将获得一个可视化界面，一键将供应商导入应用，一键在不同的供应商之间进行切换，内置 50+ 供应商预设、统一的 MCP, SKILLS 管理以及系统托盘即时切换功能——所有操作都基于可靠的 SQLite 数据库和原子写入机制，保护你的配置不被损坏。 +**CC Switch** 为你提供一个桌面应用来管理所有支持的 AI 工具。无需手动编辑配置文件，你将获得一个可视化界面，一键将供应商导入应用，一键在不同的供应商之间进行切换，内置 50+ 供应商预设、统一的 MCP, SKILLS 管理以及系统托盘即时切换功能——所有操作都基于可靠的 SQLite 数据库和原子写入机制，保护你的配置不被损坏。 -- **一个应用，五个 CLI 工具** — 在单一界面中管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw +- **一个应用，七个工具** — 在单一界面中管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes - **告别手动编辑** — 50+ 供应商预设，包括 AWS Bedrock、NVIDIA NIM 和社区中转服务；一键即可切换 -- **统一 MCP, SKILLS 管理** — 一个面板管理四个应用的 MCP, SKILLS, 支持双向同步 +- **统一 MCP, SKILLS 管理** — 一个面板管理 Claude、Codex、Gemini、OpenCode 和 Hermes 的 MCP, SKILLS, 支持双向同步 - **系统托盘快速切换** — 从托盘菜单即时切换供应商，无需打开完整应用 - **云同步** — 通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器在不同设备之间同步供应商数据 - **跨平台** — 基于 Tauri 2 构建的原生桌面应用，支持 Windows、macOS 和 Linux @@ -172,12 +172,12 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更 ## 功能特性 -[完整更新日志](CHANGELOG.md) | [发布说明](docs/release-notes/v3.15.0-zh.md) +[完整更新日志](CHANGELOG.md) | [发布说明](docs/release-notes/v3.16.0-zh.md) ### 供应商管理 -- **5 个 CLI 工具，50+ 预设** — Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw；复制 key 即可一键导入 -- **通用供应商** — 一份配置同步到多个应用（OpenCode、OpenClaw） +- **7 个支持工具，50+ 预设** — Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes；复制 key 即可一键导入 +- **通用供应商** — 一份配置同步到 Claude Code、Codex 和 Gemini CLI - 一键切换、系统托盘快速访问、拖拽排序、导入导出 ### 代理与故障转移 @@ -187,7 +187,7 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更 ### MCP、Prompts 与 Skills -- **统一 MCP 面板** — 管理 4 个应用的 MCP 服务器，双向同步，支持 Deep Link 导入 +- **统一 MCP 面板** — 管理 Claude、Codex、Gemini、OpenCode 和 Hermes 的 MCP 服务器，双向同步，支持 Deep Link 导入 - **Prompts** — Markdown 编辑器，跨应用同步（CLAUDE.md / AGENTS.md / GEMINI.md），回填保护 - **Skills** — 从 GitHub 仓库或 ZIP 文件一键安装，自定义仓库管理，支持软连接和文件复制 @@ -197,21 +197,21 @@ Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折，充值更 ### 会话管理器与工作区 -- 浏览、搜索和恢复全部应用对话历史 +- 浏览、搜索和恢复支持的会话来源 - **工作区编辑器**（OpenClaw）— 编辑 Agent 文件（AGENTS.md、SOUL.md 等），支持 Markdown 预览 ### 系统与平台 - **云同步** — 自定义配置目录（Dropbox、OneDrive、iCloud、坚果云、NAS）及 WebDAV 服务器同步 - **Deep Link** (`ccswitch://`) — 通过 URL 一键导入供应商、MCP 服务器、提示词和技能 -- 深色 / 浅色 / 跟随系统主题、开机自启、自动更新、原子写入、自动备份、国际化（中/英/日） +- 深色 / 浅色 / 跟随系统主题、开机自启、自动更新、原子写入、自动备份、国际化（简中/繁中/英/日） ## 常见问题
-CC Switch 支持哪些 AI CLI 工具？ +CC Switch 支持哪些 AI 工具？ -CC Switch 支持五个工具：**Claude Code**、**Codex**、**Gemini CLI**、**OpenCode** 和 **OpenClaw**。每个工具都有专属的供应商预设和配置管理。 +CC Switch 支持七个工具：**Claude Code**、**Claude Desktop**、**Codex**、**Gemini CLI**、**OpenCode**、**OpenClaw** 和 **Hermes**。每个工具都有专属的供应商预设和配置管理。
@@ -282,8 +282,8 @@ CC Switch macOS 版本已通过 Apple 代码签名和公证，可直接下载安 - **MCP**：点击"MCP"按钮 → 通过模板或自定义配置添加服务器 → 切换各应用同步开关 - **Prompts**：点击"Prompts" → 使用 Markdown 编辑器创建预设 → 激活后同步到 live 文件 -- **Skills**：点击"Skills" → 浏览 GitHub 仓库 → 一键安装到全部应用 -- **会话**：点击"Sessions" → 浏览和搜索和恢复全部应用对话历史 +- **Skills**：点击"Skills" → 浏览 GitHub 仓库 → 一键安装到支持的应用 +- **会话**：点击"Sessions" → 浏览、搜索和恢复支持的会话来源 > **注意**：首次启动可以手动导入现有 CLI 工具配置作为默认供应商。 @@ -496,7 +496,7 @@ pnpm test:unit --coverage │ ├── lib/ │ │ ├── api/ # Tauri API 封装（类型安全） │ │ └── query/ # TanStack Query 配置 -│ ├── locales/ # 翻译 (zh/en/ja) +│ ├── locales/ # 翻译 (zh/zh-TW/en/ja) │ ├── config/ # 预设 (providers/mcp) │ └── types/ # TypeScript 类型定义 ├── src-tauri/ # 后端 (Rust) diff --git a/docs/user-manual/README.md b/docs/user-manual/README.md index e32a4867b..a81598cb3 100644 --- a/docs/user-manual/README.md +++ b/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 diff --git a/docs/user-manual/en/1-getting-started/1.1-introduction.md b/docs/user-manual/en/1-getting-started/1.1-introduction.md index cb9c582e8..ddac3a77d 100644 --- a/docs/user-manual/en/1-getting-started/1.1-introduction.md +++ b/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 diff --git a/docs/user-manual/en/1-getting-started/1.3-interface.md b/docs/user-manual/en/1-getting-started/1.3-interface.md index 1df69fc35..aba290b6b 100644 --- a/docs/user-manual/en/1-getting-started/1.3-interface.md +++ b/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) diff --git a/docs/user-manual/en/1-getting-started/1.5-settings.md b/docs/user-manual/en/1-getting-started/1.5-settings.md index 1668b7095..6a2308b9d 100644 --- a/docs/user-manual/en/1-getting-started/1.5-settings.md +++ b/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 diff --git a/docs/user-manual/en/3-extensions/3.1-mcp.md b/docs/user-manual/en/3-extensions/3.1-mcp.md index 02dcece06..e100512b6 100644 --- a/docs/user-manual/en/3-extensions/3.1-mcp.md +++ b/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 diff --git a/docs/user-manual/en/3-extensions/3.2-prompts.md b/docs/user-manual/en/3-extensions/3.2-prompts.md index d9bbd38ba..1c370042d 100644 --- a/docs/user-manual/en/3-extensions/3.2-prompts.md +++ b/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. diff --git a/docs/user-manual/en/3-extensions/3.3-skills.md b/docs/user-manual/en/3-extensions/3.3-skills.md index 9c42913c6..741be6265 100644 --- a/docs/user-manual/en/3-extensions/3.3-skills.md +++ b/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 diff --git a/docs/user-manual/en/4-proxy/4.4-usage.md b/docs/user-manual/en/4-proxy/4.4-usage.md index f52cf9988..095e41af2 100644 --- a/docs/user-manual/en/4-proxy/4.4-usage.md +++ b/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 diff --git a/docs/user-manual/en/5-faq/5.1-config-files.md b/docs/user-manual/en/5-faq/5.1-config-files.md index 4f1dfe041..f88dc79b9 100644 --- a/docs/user-manual/en/5-faq/5.1-config-files.md +++ b/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 diff --git a/docs/user-manual/en/README.md b/docs/user-manual/en/README.md index 619d13f35..01f55a6ef 100644 --- a/docs/user-manual/en/README.md +++ b/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 diff --git a/docs/user-manual/ja/1-getting-started/1.1-introduction.md b/docs/user-manual/ja/1-getting-started/1.1-introduction.md index b21e5677b..047430b8b 100644 --- a/docs/user-manual/ja/1-getting-started/1.1-introduction.md +++ b/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 管理 | ## 対応プラットフォーム diff --git a/docs/user-manual/ja/1-getting-started/1.3-interface.md b/docs/user-manual/ja/1-getting-started/1.3-interface.md index 2ef89d2f8..d2dc0a3bf 100644 --- a/docs/user-manual/ja/1-getting-started/1.3-interface.md +++ b/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/日本語） - テーマ設定（システムに合わせる/ライト/ダーク） - ウィンドウ動作（起動時に自動実行、閉じる動作） diff --git a/docs/user-manual/ja/1-getting-started/1.5-settings.md b/docs/user-manual/ja/1-getting-started/1.5-settings.md index c274efb49..57b29fbb2 100644 --- a/docs/user-manual/ja/1-getting-started/1.5-settings.md +++ b/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` です。 ### 設定のインポート diff --git a/docs/user-manual/ja/3-extensions/3.1-mcp.md b/docs/user-manual/ja/3-extensions/3.1-mcp.md index 0ccb0063f..2561e4e96 100644 --- a/docs/user-manual/ja/3-extensions/3.1-mcp.md +++ b/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 が既存の設定を読み取ってインポート ## 設定ファイル形式 diff --git a/docs/user-manual/ja/3-extensions/3.2-prompts.md b/docs/user-manual/ja/3-extensions/3.2-prompts.md index ed3a004f0..e93babad2 100644 --- a/docs/user-manual/ja/3-extensions/3.2-prompts.md +++ b/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 のプリセットが表示 複数のアプリで同じプロンプトを使用する場合は、それぞれで作成する必要があります。 diff --git a/docs/user-manual/ja/3-extensions/3.3-skills.md b/docs/user-manual/ja/3-extensions/3.3-skills.md index d3e84f203..11e3efbbb 100644 --- a/docs/user-manual/ja/3-extensions/3.3-skills.md +++ b/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/`）からスキルを削除 - データベースからスキルレコードを削除 diff --git a/docs/user-manual/ja/4-proxy/4.4-usage.md b/docs/user-manual/ja/4-proxy/4.4-usage.md index dd8e659b5..1ce1aff64 100644 --- a/docs/user-manual/ja/4-proxy/4.4-usage.md +++ b/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 からバージョン付き価格に照合 | ### 操作 diff --git a/docs/user-manual/ja/5-faq/5.1-config-files.md b/docs/user-manual/ja/5-faq/5.1-config-files.md index 09df32eec..713880d20 100644 --- a/docs/user-manual/ja/5-faq/5.1-config-files.md +++ b/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` | ワークスペースディレクトリパス | ## 設定の優先順位 diff --git a/docs/user-manual/ja/5-faq/5.2-questions.md b/docs/user-manual/ja/5-faq/5.2-questions.md index 930b81c57..92823792c 100644 --- a/docs/user-manual/ja/5-faq/5.2-questions.md +++ b/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. テキストエディタで開いてフォーマットを確認 diff --git a/docs/user-manual/ja/README.md b/docs/user-manual/ja/README.md index 296c4ffed..e96725002 100644 --- a/docs/user-manual/ja/README.md +++ b/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) ## コントリビュート diff --git a/docs/user-manual/zh/1-getting-started/1.1-introduction.md b/docs/user-manual/zh/1-getting-started/1.1-introduction.md index 05fa318e2..fa29d1032 100644 --- a/docs/user-manual/zh/1-getting-started/1.1-introduction.md +++ b/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 管理 | ## 支持的平台 diff --git a/docs/user-manual/zh/1-getting-started/1.3-interface.md b/docs/user-manual/zh/1-getting-started/1.3-interface.md index 2879ab441..5f23c21d0 100644 --- a/docs/user-manual/zh/1-getting-started/1.3-interface.md +++ b/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/日本語） - 主题设置（跟随系统/浅色/深色） - 窗口行为（开机自启、关闭行为） diff --git a/docs/user-manual/zh/1-getting-started/1.5-settings.md b/docs/user-manual/zh/1-getting-started/1.5-settings.md index 46c5792fc..eb0b12bc6 100644 --- a/docs/user-manual/zh/1-getting-started/1.5-settings.md +++ b/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`。 ### 导入配置 diff --git a/docs/user-manual/zh/3-extensions/3.1-mcp.md b/docs/user-manual/zh/3-extensions/3.1-mcp.md index 4a93d59df..fdd9fc22f 100644 --- a/docs/user-manual/zh/3-extensions/3.1-mcp.md +++ b/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 会读取现有配置并导入 ## 配置文件格式 diff --git a/docs/user-manual/zh/3-extensions/3.2-prompts.md b/docs/user-manual/zh/3-extensions/3.2-prompts.md index c8eb82e51..6833985b0 100644 --- a/docs/user-manual/zh/3-extensions/3.2-prompts.md +++ b/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 的预设 如需在多个应用使用相同的提示词，需要分别创建。 diff --git a/docs/user-manual/zh/3-extensions/3.3-skills.md b/docs/user-manual/zh/3-extensions/3.3-skills.md index 7af6dda0a..8ec3e7bd9 100644 --- a/docs/user-manual/zh/3-extensions/3.3-skills.md +++ b/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/`）移除技能 - 从数据库删除技能记录 diff --git a/docs/user-manual/zh/4-proxy/4.4-usage.md b/docs/user-manual/zh/4-proxy/4.4-usage.md index e7181159a..ee9822182 100644 --- a/docs/user-manual/zh/4-proxy/4.4-usage.md +++ b/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 匹配带版本定价 | ### 操作 diff --git a/docs/user-manual/zh/5-faq/5.1-config-files.md b/docs/user-manual/zh/5-faq/5.1-config-files.md index 5d19c8425..3f706a440 100644 --- a/docs/user-manual/zh/5-faq/5.1-config-files.md +++ b/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` | 工作区目录路径 | ## 配置优先级 diff --git a/docs/user-manual/zh/5-faq/5.2-questions.md b/docs/user-manual/zh/5-faq/5.2-questions.md index 927824dd3..1d55372a2 100644 --- a/docs/user-manual/zh/5-faq/5.2-questions.md +++ b/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. 尝试用文本编辑器打开检查格式 diff --git a/docs/user-manual/zh/README.md b/docs/user-manual/zh/README.md index 59d22fae2..48b213312 100644 --- a/docs/user-manual/zh/README.md +++ b/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) ## 贡献