admin/CC-Switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-08-04 03:32:25 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: update user manual to v3.12.3 with new features coverage (en/zh/ja)

Browse Source 
Add documentation for features introduced since v3.12.0:

New docs:
- 3.4 Session Manager: browse, search, resume, delete sessions
- 3.5 Workspace & Daily Memory: OpenClaw workspace file editing

Updated docs:
- Add Lightweight Mode to interface overview and FAQ
- Add tray submenu structure (providers grouped by app)
- Add API Format selection (Anthropic/OpenAI Chat/OpenAI Responses)
- Add Auto-Fetch Models button documentation
- Add Claude Common Config quick toggles
- Add Codex 1M Context Window toggle
- Add Skill backup/restore lifecycle
- Expand Backup Management panel documentation
- Update WebDAV sync to v2 protocol with dual-layer versioning
- Add OpenCode/OpenClaw to quickstart activation table
- Update README version to v3.12.3

All changes synced across en, zh, and ja locales.
This commit is contained in:
Jason
2026-04-04 12:20:13 +08:00
parent fe525891d4
commit d9c0e4c452
39 changed files with 1282 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/user-manual/ja/1-getting-started/1.3-interface.md
+17 -2
View File
@@ -100,10 +100,13 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操
| メニュー項目 | 機能 |
|--------|------|
| メインウィンドウを開く | メインウィンドウを表示してフォーカス |
| アプリグループ | Claude/Codex/Gemini/OpenCode/OpenClaw ごとにプロバイダーを表示 |
| プロバイダーリスト | クリックで切り替え、現在有効なものにはチェックマークを表示 |
| アプリサブメニュー | Claude/Codex/Gemini/OpenCode/OpenClaw ごとの折りたたみサブメニュー（例：「Claude · PackyCode」） |
| プロバイダーリスト | 各サブメニュー内でクリックして切り替え、現在有効なものにはチェックマークを表示 |
| ライトウェイトモード | トグルチェックボックスでトレイ専用モードの開始/終了 |
| 終了 | アプリを完全に終了 |
> **注意**：各アプリのサブメニュータイトルには現在のプロバイダー名が表示されます（例：「Claude · PackyCode」）。プロバイダーが設定されていないアプリでは、無効化された「(プロバイダーなし)」エントリが表示されます。アプリの表示はアプリの表示設定で制御されます。
### 多言語対応
トレイメニューは 3 つの言語に対応し、設定に応じて自動的に切り替わります：
@@ -114,6 +117,17 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操
| English | Open main window | Quit |
| 日本語 | メインウィンドウを開く | 終了 |
### ライトウェイトモード
トレイメニューには **ライトウェイトモード** のトグル（チェックボックス）があります。有効にすると：
- メインウィンドウが閉じられ、リソースが解放される
- アプリはシステムトレイのみで動作を継続
- トレイのサブメニューからプロバイダーの切り替えが可能
- macOS では Dock アイコンも非表示になる
ライトウェイトモードを終了するには、トグルのチェックを外すか「メインウィンドウを開く」をクリックします。メインウィンドウが再構築されて表示されます。
### 使用シーン
トレイからのプロバイダー切り替えはメイン画面を開く必要がなく、以下の場面に適しています：
@@ -121,6 +135,7 @@ CC Switch はシステムトレイにアイコンを表示し、クイック操
- 頻繁にプロバイダーを切り替える場合
- メインウィンドウが最小化されているときの素早い操作
- バックグラウンド実行中の設定管理
- ライトウェイトモードでリソース使用量を最小化
## 設定ページ
docs/user-manual/ja/1-getting-started/1.4-quickstart.md
+11 -1
View File
@@ -33,8 +33,10 @@
| アプリ | 反映方法 |
|------|----------|
| Claude Code | 即時反映（ホットリロード対応） |
| Codex | ターミナルを閉じて再度開く必要あり |
| Codex | ターミナルの再起動が必要 |
| Gemini | 即時反映（リクエストごとに設定を再読み込み） |
| OpenCode | ターミナルの再起動が必要 |
| OpenClaw | ターミナルの再起動が必要 |
### Claude Code の初回インストール時の注意
@@ -64,6 +66,14 @@ codex
# Gemini - 起動後にテスト質問を入力
gemini
> こんにちは、簡単に自己紹介してください
# OpenCode - 起動後にテスト質問を入力
opencode
> こんにちは、簡単に自己紹介してください
# OpenClaw - 起動後にテスト質問を入力
openclaw
> こんにちは、簡単に自己紹介してください
```
AI が正常に回答すれば、設定は成功です。
docs/user-manual/ja/1-getting-started/1.5-settings.md
+52 -15
View File
@@ -167,37 +167,74 @@ CC Switch の送信 HTTP/HTTPS プロキシを設定します。外部 API に
### バックアップと復元
自動バックアップの管理：
バックアップ管理パネルでは、データベースバックアップを完全に管理できます。
| 設定 | 説明 |
| -------- | -------------------------- |
| バックアップ間隔 | 自動バックアップの時間間隔（時間） |
| 保持数量 | 保持するバックアップの数 |
#### 自動バックアップ設定
バックアップリストの表示とバックアップからの復元をサポートします。
| 設定 | オプション | デフォルト |
|------|---------|---------|
| バックアップ間隔 | 無効、6時間、12時間、24時間、48時間、7日 | 24時間 |
| 保持数 | 3、5、10、15、20、30、50 | 10件 |
間隔を設定すると、CC Switch はスケジュールに従って自動的にデータベースをバックアップします。保持数を超えた古いバックアップは自動的に削除されます。
#### バックアップリスト
パネルには既存のすべてのバックアップが以下の情報とともに表示されます：
- **表示名**（タイムスタンプから自動生成、例：`db_backup_20260315_143000`）
- **作成日時**
- **ファイルサイズ**（例：「1.5 MB」）
#### バックアップ操作
| 操作 | 説明 |
|------|------|
| **今すぐバックアップ** | 即座にバックアップを作成 |
| **復元** | 選択したバックアップからデータベースを復元。復元前に現在のデータベースの安全バックアップが自動的に作成される |
| **名前変更** | バックアップの表示名を変更 |
| **削除** | バックアップを完全に削除（確認あり） |
> **重要**：バックアップの復元は現在のデータベースを上書きします。復元前に安全バックアップが自動作成されるため、必要に応じて元に戻すことができます。
### クラウド同期（WebDAV）
WebDAV プロトコルを使用して複数のデバイス間で設定を同期します。
WebDAV プロトコルを使用して複数のデバイス間で設定を同期します。信頼性の向上のため、デュアルレイヤーバージョニングを備えた **v2 プロトコル** を使用しています。
| 設定項目 | 説明 |
| -------- | ------------------------------------- |
| サービスプリセット | 坚果云 / Nextcloud / Synology / カスタム |
| サーバー URL | WebDAV サーバー URL |
| ユーザー名 | ログインユーザー名 |
| パスワード | ログインパスワード（アプリ専用パスワード） |
| パスワード | ログインパスワード（アプリ専用パスワード、保存済みの場合は未変更で保持） |
| リモートディレクトリ | リモート保存パス（デフォルト `cc-switch-sync`） |
| プロファイル名 | デバイスプロファイル名（デフォルト `default`） |
| 自動同期 | 有効にすると変更を自動アップロード |
| 自動同期 | 設定可能な間隔で自動同期を有効化 |
操作：
#### 操作
- **接続テスト**：WebDAV 設定が正しいか確認
- **保存**：設定を保存して自動テスト
- **アップロード**：ローカルデータをリモートにアップロード
- **ダウンロード**：リモートからローカルにデータをダウンロード
| 操作 | 説明 |
|------|------|
| **接続テスト** | WebDAV の URL、ユーザー名、パスワードが有効か確認 |
| **アップロード** | ローカルデータベースをリモートにアップロード。進捗スピナーを表示 |
| **ダウンロード** | リモートデータベースをダウンロード。確認前にリモートスナップショット情報（プロトコルバージョン、DB バージョン、タイムスタンプ、サイズ）を表示。上書き前にローカルデータベースの安全バックアップを自動作成 |
> **注意**：アップロードはリモートデータを、ダウンロードはローカルデータを上書きします。操作前にご確認ください。
#### 自動同期
**自動同期** を有効にすると：
- 初回有効化時に確認ダイアログが表示される
- CC Switch は設定された間隔で自動的にデータベースを WebDAV に同期
- 同期ステータスがパネルに表示される
#### リモートスナップショット情報
ダウンロード前に、CC Switch はリモートスナップショットの詳細を表示します：
- プロトコルバージョン（v2）
- データベース互換バージョン
- リモートバックアップのタイムスタンプ
- ファイルサイズ
- 互換性ステータス（非互換の場合は警告）
> **注意**：アップロードはリモートデータを、ダウンロードはローカルデータを上書きします。ダウンロード前に安全バックアップが自動作成されます。
### ログ設定
docs/user-manual/ja/2-providers/2.1-add.md
+55
View File
@@ -152,6 +152,22 @@
| AWS Bedrock | AWS Bedrock サービス |
| OpenAI Compatible | OpenAI 互換インターフェース |
## モデル自動取得
プロバイダーの追加や編集時に、プロバイダーのエンドポイントから利用可能なモデルを自動取得できます：
1. **API Key** と **エンドポイントアドレス** が入力されていることを確認
2. モデル入力フィールドの横にある **モデル取得** ボタン（ダウンロードアイコン）をクリック
3. CC Switch がプロバイダーの `/v1/models` エンドポイントを呼び出してモデルリストを取得
4. ベンダー別にグループ化されたドロップダウンからモデルを選択
この機能は、OpenAI 互換の `/v1/models` API をサポートするすべてのプロバイダーで動作します。Claude、Codex、Gemini、OpenCode、OpenClaw のプロバイダーで利用可能です。
**よくあるエラー：**
- **認証失敗（401/403）**：API Key を確認してください
- **エンドポイント未対応（404/405）**：プロバイダーが `/v1/models` エンドポイントを公開していません
- **タイムアウト**：エンドポイントの応答が遅いです。後ほど再試行してください
## カスタム設定
「カスタム」プリセットを選択した場合、JSON 設定を手動で編集する必要があります。
@@ -316,6 +332,45 @@ SQL バックアップファイルから一括インポート：
## 高度なオプション
### API フォーマット（Claude のみ）
サードパーティ API を使用する Claude プロバイダーを追加する際、高度なオプションセクションで正しい **API フォーマット** を選択する必要がある場合があります：
| フォーマット | 説明 | 使用場面 |
|------|------|------|
| **Anthropic Messages** | ネイティブ Anthropic API フォーマット（デフォルト） | Anthropic API に直接接続、または互換プロキシ |
| **OpenAI Chat Completions** | OpenAI Chat API フォーマット、プロキシが自動変換 | プロバイダーが OpenAI Chat フォーマットのみ対応 |
| **OpenAI Responses API** | OpenAI Responses API フォーマット、プロキシが自動変換 | プロバイダーが OpenAI Responses フォーマットのみ対応 |
> **注意**：API フォーマットの変換はプロキシサービスが担当します。Anthropic 以外のフォーマットを使用する場合、リクエスト/レスポンスの正しい変換のためにプロキシが接管有効の状態で稼働している必要があります。詳しくは [4.1 プロキシサービス](../4-proxy/4.1-service.md) をご覧ください。
デフォルト以外の API フォーマットが設定されている場合、高度なオプションセクションが自動展開されます。
### Claude 共通設定クイックトグル
Claude プロバイダーの編集時、JSON エディタの上部に **クイックトグル** が利用できます：
| トグル | 効果 | 設定変更 |
|------|------|------|
| **帰属情報を非表示** | コミット/PR の帰属メタデータをクリア | `attribution: {commit: "", pr: ""}` を設定 |
| **チームメイトを有効化** | エージェントチーム機能を有効化 | `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = "1"` を設定 |
| **ツール検索を有効化** | ツール検索機能を有効化 | `env.ENABLE_TOOL_SEARCH = "true"` を設定 |
| **高強度** | エフォートレベルを高に設定 | `effortLevel = "high"` を設定 |
| **自動アップグレードを無効化** | Claude Code の自動更新を防止 | `env.DISABLE_AUTOUPDATER = "1"` を設定 |
トグルのチェックを外すと、対応する設定エントリが完全に削除されます。変更は JSON エディタにリアルタイムで反映されます。
また、**共通設定を書き込み** チェックボックスを有効にすると、グローバル設定スニペットをプロバイダーにマージできます。**共通設定を編集** をクリックして共有スニペットをカスタマイズできます。
### Codex 1M コンテキストウィンドウ
Codex プロバイダーの追加時、**1M コンテキストウィンドウを有効化** トグルが利用できます：
- **有効時**：config.toml に `model_context_window = 1000000` を設定し、`model_auto_compact_token_limit = 900000` を自動入力
- **無効時**：両方のフィールドを削除
トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。
### カスタムアイコン
名前の左側にあるアイコンエリアをクリックすると：
docs/user-manual/ja/2-providers/2.2-switch.md
+3 -1
View File
@@ -26,10 +26,12 @@
### 操作手順
1. システムトレイの CC Switch アイコンを右クリック
2. メニューで対応するアプリ（Claude/Codex/Gemini/OpenCode）を見つける
2. 対応するアプリのサブメニュー（例：「Claude · 現在のプロバイダー」）にマウスを合わせる
3. 切り替えたいプロバイダー名をクリック
4. 切り替え完了、トレイに短い通知が表示
> プロバイダーはアプリタイプ（Claude/Codex/Gemini）ごとに折りたたみサブメニューに整理されています。サブメニューのタイトルには現在有効なプロバイダー名が表示されます。
### トレイメニュー構造
![image-20260108004348993](../../assets/image-20260108004348993.png)
docs/user-manual/ja/2-providers/2.3-edit.md
+14
View File
@@ -52,6 +52,20 @@ JSON 形式の設定内容（以下を含む）：
これにより、CC Switch と CLI ツールの設定が常に同期されます。
## モデル自動取得
プロバイダーの編集時に、プロバイダーのエンドポイントから利用可能なモデルリストを自動取得できます：
1. API Key とエンドポイントアドレスが入力されていることを確認
2. モデル入力フィールドの横にある **モデル取得** ボタン（ダウンロードアイコン）をクリック
3. グループ化されたドロップダウンからモデルを選択
詳しくは [2.1 プロバイダーの追加 - モデル自動取得](./2.1-add.md#モデル自動取得) をご覧ください。
## 共通設定クイックトグル（Claude）
Claude プロバイダーの編集時、JSON エディタの上部にツール検索、自動アップグレード無効化、チームメイト、高強度などの共通設定のクイックトグルスイッチが利用できます。詳しくは [2.1 プロバイダーの追加 - Claude 共通設定クイックトグル](./2.1-add.md#claude-共通設定クイックトグル) をご覧ください。
## API Key の変更
プロバイダーの編集時に、**API Key** 入力ボックスから直接変更できます：
docs/user-manual/ja/3-extensions/3.3-skills.md
+21 -2
View File
@@ -118,8 +118,27 @@ CC Switch は強力な検索とフィルタリング機能を提供していま
### アンインストールの効果
- ローカルのスキルフォルダを削除
- インストール状態を更新
- **自動バックアップ**：削除前にスキルが `~/.cc-switch/skill-backups/` にバックアップされる
- すべてのアプリディレクトリ（Claude、Codex、Gemini、OpenCode）からスキルを削除
- SSOT ディレクトリ（`~/.cc-switch/skills/`）からスキルを削除
- データベースからスキルレコードを削除
### バックアップから復元
以前アンインストールしたスキルを復元する場合：
1. Skills ページを開く
2. **バックアップから復元** ボタンをクリック
3. リスト（スキル名とバックアップ日が表示）から復元したいバックアップを選択
4. スキルが復元され、現在のアプリで有効化される
### バックアップの削除
古いスキルバックアップを削除するには：
1. 復元ダイアログで削除したいバックアップを見つける
2. バックアップエントリの横にある **削除** ボタンをクリック
3. 削除を確認（この操作は取り消せません）
## リポジトリ管理
docs/user-manual/ja/3-extensions/3.4-sessions.md
+131
View File
@@ -0,0 +1,131 @@
# 3.4 セッションマネージャー
セッションマネージャーでは、対応するすべての CLI ツールの会話セッションを一か所で閲覧、検索、管理できます。
## 対応アプリ
| アプリ | セッション保存場所 |
|------|----------|
| Claude Code | `~/.cache/claude/projects/*.jsonl` |
| Codex | Codex 設定のセッションディレクトリ |
| OpenCode | `~/.local/share/opencode/`（JSON または SQLite） |
| OpenClaw | `~/.openclaw/agents/<agent>/sessions/*.jsonl` |
| Gemini CLI | `~/.cache/gemini/tmp/<project_hash>/chats/` |
## セッションマネージャーを開く
メインナビゲーションバーの **セッション** ボタンをクリックします。
> **注意**：セッションボタンは対応する 5 つのアプリすべてで表示されます。
## インターフェースのレイアウト
セッションマネージャーは **2 カラムレイアウト** を採用しています：
- **左パネル**：検索とフィルターツールバー付きのセッションリスト
- **右パネル**：選択したセッションの詳細と会話履歴
### セッションリスト（左パネル）
各セッションエントリには以下が表示されます：
- プロバイダーアイコン
- セッションタイトル
- 最終アクティブ時間（相対形式、例：「5分前」）
### セッション詳細（右パネル）
セッションを選択すると、右パネルに以下が表示されます：
- **タイトル**：セッションタイトル、プロジェクトディレクトリ名、またはセッション ID から取得
- **最終アクティブ日時**：完全なタイムスタンプ
- **プロジェクトディレクトリ**：クリックでフルパスをコピー（ベース名とツールチップでフルパスを表示）
- **再開コマンド**：利用可能な場合、モノスペースフォントで表示
- **会話履歴**：メッセージの全文記録
## 検索とフィルタリング
### 全文検索
左パネル上部の検索ボックスを使用して、以下の項目を横断的に検索できます：
- セッション ID
- タイトル
- サマリー
- プロジェクトディレクトリ
- ソースファイルパス
前方一致検索に対応し、リアルタイムで結果をフィルタリングします。**Esc** で検索をクリアできます。
### プロバイダーフィルター
左パネル右上のプロバイダーフィルタードロップダウンをクリックして、アプリ別にフィルタリングします：
- **すべて** — すべてのプロバイダーのセッションを表示
- **Claude Code**
- **Codex**
- **OpenCode**
- **OpenClaw**
- **Gemini CLI**
フィルターは検索と組み合わせて使用できます。
### 更新
更新ボタン（循環矢印アイコン）をクリックすると、すべてのプロバイダーディレクトリを再スキャンして新しいセッションや削除済みセッションを検出します。
## セッション操作
### セッションの再開
選択したセッションの **再開** ボタン（再生アイコン）をクリックして、会話を続行します。
**macOS の場合：**
- CC Switch は設定済みのターミナルで再開コマンドを起動します
- ターミナルはセッションのプロジェクトディレクトリで開きます
- ターミナルの起動に失敗した場合、コマンドがクリップボードにコピーされます
**対応ターミナル（macOS）：** Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty
**その他のプラットフォーム：**
- 再開コマンドがクリップボードにコピーされます
- ターミナルに貼り付けてセッションを再開してください
> 再開コマンドが利用できないセッションでは、再開ボタンは無効になります。
### セッションの削除
**削除** ボタン（ゴミ箱アイコン）をクリックすると、セッションファイルが完全に削除されます。削除前に確認ダイアログが表示されます。
> ローカルソースパスのないセッション（不変のセッションなど）は削除できません。
### 一括操作
複数のセッションを一度に管理するには：
1. 左パネルツールバーの **一括モード** ボタン（チェックボックスアイコン）をクリック
2. 表示されるチェックボックスでセッションを選択
3. **すべて選択** でフィルタリング結果をすべて選択、または **クリア** で選択解除
4. **一括削除**（赤いゴミ箱アイコン）をクリックして選択したすべてのセッションを削除
削除前に件数を表示する確認ダイアログが表示されます。結果には成功した削除件数と失敗件数が報告されます。
## 会話履歴
### メッセージの表示
メッセージは役割ごとに色分けされます：
- **ユーザー** メッセージ：緑、左寄せ
- **AI**（アシスタント）メッセージ：青、右寄せ
- **システム** メッセージ：アンバー
- **ツール** メッセージ：パープル
### 目次
長い会話の場合、目次機能が利用できます：
- **デスクトップ（XL+ 画面）**：右側のサイドバーにユーザーメッセージのプレビューを表示
- **小さい画面**：右下のフローティングボタン（リストアイコン）をクリックするとダイアログが開く
エントリをクリックすると該当メッセージにスクロールし、一時的にハイライト表示されます。
## ヒント
- セッションは最終アクティブ時間の新しい順にソートされます
- セッション数バッジは検索やフィルタリングに応じて更新されます
- OpenCode のセッションは JSON ファイルと SQLite データベースの両方から取得される場合があります（重複は自動的に除去されます）
docs/user-manual/ja/3-extensions/3.5-workspace.md
+85
View File
@@ -0,0 +1,85 @@
# 3.5 ワークスペースファイルとデイリーメモリー
## 概要
ワークスペースパネルは、**OpenClaw** 向けのファイル管理とデイリーメモリー機能を提供します。ワークスペース設定ファイルの編集やデイリーメモリージャーナルの管理が可能です。
> この機能は OpenClaw 専用です。ワークスペースボタンは、OpenClaw が選択されている場合にナビゲーションバーに表示されます。
## ワークスペースファイル
### ファイルの保存場所
すべてのワークスペースファイルは `~/.openclaw/workspace/` に保存されます。
パネル上部のディレクトリパスをクリックすると、ファイルマネージャーで開きます。
### 利用可能なファイル
CC Switch は 9 つのワークスペースファイルを管理しており、それぞれ特定の役割を持っています：
| ファイル | 説明 |
|------|------|
| **AGENTS.md** | エージェントの定義と設定 |
| **SOUL.md** | システムのソウル/パーソナリティ設定 |
| **USER.md** | ユーザープロファイル情報 |
| **IDENTITY.md** | アイデンティティとロールの定義 |
| **TOOLS.md** | 利用可能なツールの設定 |
| **MEMORY.md** | システムメモリー |
| **HEARTBEAT.md** | ハートビート設定 |
| **BOOTSTRAP.md** | ブートストラップシーケンス |
| **BOOT.md** | ブート設定 |
### ファイルステータス
各ファイルにはステータスインジケーターが表示されます：
- **緑のチェックマーク**：ファイルがディスク上に存在
- **空の円**：ファイルがまだ存在しない（初回保存時に作成）
### ファイルの編集
1. ファイルカードをクリックして Markdown エディタを開く
2. コンテンツを編集
3. **保存** をクリックしてディスクに書き込み
ファイルがまだ存在しない場合は、初回保存時に作成されます。
## デイリーメモリー
デイリーメモリー機能は、`~/.openclaw/workspace/memory/` に保存される日付別のジャーナルシステムを提供します。
### デイリーメモリーへのアクセス
ワークスペースファイルグリッドの **デイリーメモリー** カードをクリックして、メモリーパネルを開きます。
### ファイルリスト
パネルには日付の新しい順にすべてのデイリーメモリーファイルが表示されます。各エントリには以下が表示されます：
- **日付**（ファイル名から変換、例：`2026-04-01.md`）
- **ファイルサイズ**
- **プレビュー**（コンテンツの最初の 2 行）
### 今日のノートを作成
**今日のノートを作成** ボタンをクリックすると：
- 今日の日付（`YYYY-MM-DD.md`）で新しいノートを開く
- 今日のノートがすでに存在する場合は、編集用に開く
- ファイルは保存をクリックした後に保存される
### 検索
すべてのデイリーメモリーファイルを横断検索できます：
1. **Cmd/Ctrl+F** を押すか、検索アイコンをクリック
2. 検索語を入力
3. 結果には以下が表示されます：
- ファイルごとのマッチ数
- マッチした行のスニペットプレビュー
- ファイルの日付とサイズ
**Esc** で検索を閉じます。
### 編集と削除
- **編集**：ファイルエントリをクリックして Markdown エディタで開く
- **削除**：ファイルエントリにマウスをホバーして削除アイコンをクリック。確認ダイアログが表示されます（削除は取り消せません）。
docs/user-manual/ja/4-proxy/4.1-service.md
+14
View File
@@ -150,6 +150,20 @@ base_url = "http://127.0.0.1:15721/v1"
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721
```
## API フォーマット変換
プロキシは、Anthropic 以外のフォーマットが設定されたプロバイダーに対して、API フォーマットの自動変換をサポートします。これにより、OpenAI 互換 API のみをサポートするプロバイダーを Claude Code で使用できます。
| プロバイダー API フォーマット | プロキシの動作 |
|------|------|
| **Anthropic Messages** | パススルー（変換なし） |
| **OpenAI Chat Completions** | Anthropic リクエストを OpenAI Chat フォーマットに変換し、レスポンスを逆変換 |
| **OpenAI Responses API** | Anthropic リクエストを OpenAI Responses フォーマットに変換し、レスポンスを逆変換 |
API フォーマットはプロバイダーごとに、Claude プロバイダーの追加・編集時の[高度なオプション](../2-providers/2.1-add.md#api-フォーマットclaude-のみ)で設定します。
> **注意**：フォーマット変換にはプロキシがアプリ接管有効の状態で稼働している必要があります。変換はストリーミングと非ストリーミングの両方のリクエストに対応しています。
## プロキシの停止
### 方法 1：メイン画面のスイッチ
docs/user-manual/ja/5-faq/5.1-config-files.md
+4 -5
View File
@@ -12,12 +12,11 @@
```
~/.cc-switch/
├── cc-switch.db # SQLite データベース
├── cc-switch.db # SQLite データベース（SSOT）
├── settings.json # デバイスレベルの設定
└── backups/ # 自動バックアップ
├── backup-20251230-120000.json
├── backup-20251229-180000.json
└── ...
├── skills/ # スキル SSOT ディレクトリ
├── skill-backups/ # スキルバックアップ（アンインストール時に作成）
└── db_backup_*.db # データベースバックアップ
```
### データベースの内容
docs/user-manual/ja/5-faq/5.2-questions.md
+10
View File
@@ -183,6 +183,16 @@ chmod +x CC-Switch-*.AppImage
2. 最新版を手動でダウンロードしてインストール
3. Homebrew を使用する場合：`brew upgrade --cask cc-switch`
## ライトウェイトモード
### ライトウェイトモードに入るには？
システムトレイメニューから「ライトウェイトモード」をトグルします。メインウィンドウが閉じ、CC Switch はトレイ専用アプリとして動作します。再度トグルするか「メインウィンドウを開く」をクリックすると終了します。
### ライトウェイトモードではメモリ使用量が少なくなる？
はい。ライトウェイトモードではメインウィンドウとその Web ビューを破棄するため、トレイメニュー機能を維持しながらメモリ使用量を大幅に削減します。
## ヘルプの入手
### Issue の提出
docs/user-manual/ja/README.md
+8 -4
View File
@@ -24,7 +24,9 @@ CC Switch ユーザーマニュアル
├── 3. 拡張機能
│ ├── 3.1 MCP サーバー管理
│ ├── 3.2 Prompts プロンプト管理
│ └── 3.3 Skills スキル管理
│ ├── 3.3 Skills スキル管理
│ ├── 3.4 セッションマネージャー
│ └── 3.5 ワークスペースとメモリー
│
├── 4. プロキシと高可用性
│ ├── 4.1 プロキシサービス
@@ -69,6 +71,8 @@ CC Switch ユーザーマニュアル
| [3.1-mcp.md](./3-extensions/3.1-mcp.md) | MCP プロトコル、サーバーの追加、アプリバインド |
| [3.2-prompts.md](./3-extensions/3.2-prompts.md) | プリセットの作成、有効化の切り替え、スマートバックフィル |
| [3.3-skills.md](./3-extensions/3.3-skills.md) | スキルの発見、インストール・アンインストール、リポジトリ管理 |
| [3.4-sessions.md](./3-extensions/3.4-sessions.md) | セッションマネージャー：閲覧、検索、再開、削除 |
| [3.5-workspace.md](./3-extensions/3.5-workspace.md) | ワークスペースファイルとデイリーメモリー（OpenClaw） |
### 4. プロキシと高可用性
@@ -99,9 +103,9 @@ CC Switch ユーザーマニュアル
## バージョン情報
- ドキュメントバージョン：v3.12.0
- 最終更新：2026-03-09
- CC Switch v3.12.0+ 対応
- ドキュメントバージョン：v3.12.3
- 最終更新：2026-04-04
- CC Switch v3.12.3+ 対応
## コントリビュート