mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-24 18:33:38 +08:00
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.
This commit is contained in:
170
docs/user-manual/ja/1-getting-started/1.3-interface.md
Normal file
170
docs/user-manual/ja/1-getting-started/1.3-interface.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# 1.3 インターフェース概要
|
||||
|
||||
## メイン画面のレイアウト
|
||||
|
||||

|
||||
|
||||
## 上部ナビゲーションバー
|
||||
|
||||
| 番号 | 要素 | 機能説明 |
|
||||
|------|------|----------|
|
||||
| ① | 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 はシステムトレイにアイコンを表示し、クイック操作の入口を提供します。
|
||||
|
||||
### トレイメニュー構造
|
||||
|
||||

|
||||
|
||||
### メニュー機能
|
||||
|
||||
| メニュー項目 | 機能 |
|
||||
|--------|------|
|
||||
| メインウィンドウを開く | メインウィンドウを表示してフォーカス |
|
||||
| アプリグループ | 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
Block a user