github/cc-switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-08 15:10:34 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
c0737f2cfe0fc3216c2c5b56323e7ef78f4ed955
cc-switch/docs/user-manual/ja/1-getting-started/1.3-interface.md
Jason bbed2a1fe1 docs: restructure user manual for i18n and add EN/JA translations 
Reorganize docs/user-manual/ from flat structure to language subdirectories
(zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/,
fix image paths, add multilingual navigation README, and translate all 23
markdown files (~4500 lines each) to English and Japanese.
2026-03-03 08:40:52 +08:00

7.0 KiB
Raw Blame History

1.3 インターフェース概要

メイン画面のレイアウト

image-20260108001629138

上部ナビゲーションバー

番号 要素 機能説明
① Logo クリックで GitHub プロジェクトページにアクセス
② 設定ボタン 設定ページを開く（ショートカット Cmd/Ctrl + ,）
③ プロキシスイッチ ローカルプロキシサービスの起動/停止
④ アプリ切り替え Claude / Codex / Gemini / OpenCode / OpenClaw を切り替え
⑤ 機能エリア Skills / Prompts / MCP の入口
⑥ 追加ボタン 新しいプロバイダーを追加

アプリ切り替え

ドロップダウンメニューをクリックして、現在管理するアプリを切り替えます：

  • Claude - Claude Code の設定を管理
  • Codex - Codex の設定を管理
  • Gemini - Gemini CLI の設定を管理
  • OpenCode - OpenCode の設定を管理
  • OpenClaw - OpenClaw の設定を管理

切り替え後、プロバイダーリストに対応アプリの設定が表示されます。

機能エリアボタン

ボタン 機能 表示条件
Skills スキル拡張管理 常に表示
Prompts システムプロンプト管理 常に表示
MCP MCP サーバー管理 常に表示

プロバイダーカード

各プロバイダーはカード形式で表示されます。左から右へ以下の要素が含まれています：

カード要素（左から右）

番号 要素 アイコン 機能説明
① ドラッグハンドル ≡ 長押しして上下にドラッグしてプロバイダーの順序を調整
② プロバイダーアイコン - プロバイダーのブランドアイコンを表示、カラーのカスタマイズ可能
③ プロバイダー情報 - 名前、メモ/エンドポイントアドレス（クリックで公式サイトを開く）
④ 使用量情報 - 残額を表示、複数プランの場合はプラン数を表示
⑤ 有効化ボタン ▶ 現在使用中のプロバイダーに切り替え
⑥ 編集ボタン ✏️ プロバイダー設定を編集
⑦ 複製ボタン - プロバイダーを複製（コピーを作成）
⑧ テストボタン - モデルの可用性と応答速度をテスト
⑨ 使用量クエリ - 使用量クエリスクリプトを設定
⑩ 削除ボタン - プロバイダーを削除（現在有効な場合は無効）

ヒント：操作ボタンエリア（⑤-⑩）はマウスホバー時に表示され、通常は非表示で画面をすっきり保ちます。

ボタンの詳細説明

ボタン 状態変化 説明
有効化 有効化済みの場合は ✓ を表示して無効化 フェイルオーバーモードでは「参加/参加済み」に変化
編集 常に使用可能 編集パネルを開いて設定を変更
複製 常に使用可能 プロバイダーのコピーを作成、名前に copy が付加
テスト テスト中はローディングアニメーション プロキシサービス実行中のみ使用可能
使用量クエリ 常に使用可能 カスタム使用量クエリスクリプトを設定
削除 現在有効な場合は半透明で無効 先に他のプロバイダーに切り替える必要あり

カードの状態

状態 枠の色 説明
現在有効 青い枠 通常モードで現在使用中のプロバイダー
プロキシアクティブ 緑の枠 プロキシ接管モードで実際に使用中のプロバイダー
通常状態 デフォルトの枠 有効化されていないプロバイダー
フェイルオーバー中 優先度バッジを表示 P1、P2 などのフェイルオーバー優先度を表示

ヘルスステータスバッジ

プロキシモードでは、フェイルオーバーキューに参加しているプロバイダーにヘルスステータスが表示されます：

バッジ 色 説明
健康 緑 連続失敗回数 0
警告 黄 連続失敗回数 1-2
不健康 赤 連続失敗回数 ≥3、サーキットブレーカーが発動する可能性あり

システムトレイ

CC Switch はシステムトレイにアイコンを表示し、クイック操作の入口を提供します。

トレイメニュー構造

image-20260108002153668

メニュー機能

メニュー項目 機能
メインウィンドウを開く メインウィンドウを表示してフォーカス
アプリグループ Claude/Codex/Gemini/OpenCode/OpenClaw ごとにプロバイダーを表示
プロバイダーリスト クリックで切り替え、現在有効なものにはチェックマークを表示
終了 アプリを完全に終了

多言語対応

トレイメニューは 3 つの言語に対応し、設定に応じて自動的に切り替わります：

言語 メインウィンドウを開く 終了
中文 打开主界面 退出
English Open main window Quit
日本語 メインウィンドウを開く 終了

使用シーン

トレイからのプロバイダー切り替えはメイン画面を開く必要がなく、以下の場面に適しています：

  • 頻繁にプロバイダーを切り替える場合
  • メインウィンドウが最小化されているときの素早い操作
  • バックグラウンド実行中の設定管理

設定ページ

設定ページは複数のタブに分かれています：

一般タブ

  • 言語設定（中文/English/日本語）
  • テーマ設定（システムに合わせる/ライト/ダーク）
  • ウィンドウ動作（起動時に自動実行、閉じる動作）

詳細タブ

  • 設定ディレクトリの設定
  • プロキシサービスの設定
  • フェイルオーバーの設定
  • 料金設定
  • データのインポート/エクスポート

使用量タブ

  • リクエスト統計の概要
  • トレンドグラフ
  • リクエストログ
  • プロバイダー/モデル統計

バージョン情報タブ

  • バージョン情報
  • 更新の確認
  • オープンソースライセンス

ショートカットキー

ショートカット 機能
Cmd/Ctrl + , 設定を開く
Cmd/Ctrl + F プロバイダーを検索
Esc ダイアログ/検索を閉じる

検索機能

Cmd/Ctrl + F で検索ボックスを開きます：

  • 名前、メモ、URL で検索可能
  • プロバイダーリストをリアルタイムでフィルタリング
  • Esc で検索を閉じる
Reference in New Issue View Git Blame Copy Permalink