@kaitranntt/ccs 3.4.6 → 3.5.0

package/README.ja.md

@@ -1,45 +1,39 @@
-# CCS - Claude Code Switch
-
 <div align="center">
 
+# CCS - Claude Code Switch
+
 ![CCS Logo](docs/assets/ccs-logo-medium.png)
 
-**1コマンド、ダウンタイムなし、複数アカウント**
+### 1コマンド、ダウンタイムなし、複数アカウント
 
-複数のClaudeアカウント、GLM、Kimiを瞬時に切り替え。<br>
+**複数のClaudeアカウント、GLM、Kimiを瞬時に切り替え。**
 レート制限を回避し、継続的に作業。
 
+<br>
 
 [![License](https://img.shields.io/badge/license-MIT-C15F3C?style=for-the-badge)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=for-the-badge)]()
 [![npm](https://img.shields.io/npm/v/@kaitranntt/ccs?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@kaitranntt/ccs)
 [![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN)
 
-**Languages**: [English](README.md) | [Tiếng Việt](README.vi.md) | [日本語](README.ja.md)
+**Languages**: [English](README.md) · [Tiếng Việt](README.vi.md) · [日本語](README.ja.md)
 
 </div>
 
----
+<br>
 
-## 🚀 クイックスタート
+## クイックスタート
 
-### 🔑 前提条件
+### インストール
 
-**CCSをインストールする前に、サブスクリプションアカウントでClaude CLIにログインしていることを確認してください：**
-```bash
-claude /login
-```
-
-### 主なインストール方法
-
-#### オプション1: npmパッケージ（推奨）
+**npmパッケージ（推奨）**
 
 **macOS / Linux / Windows**
 ```bash
 npm install -g @kaitranntt/ccs
 ```
 
-主要なパッケージマネージャーすべてに対応：
+**主要なパッケージマネージャーすべてに対応：**
 
 ```bash
 # yarn
@@ -52,7 +46,10 @@ pnpm add -g @kaitranntt/ccs
 bun add -g @kaitranntt/ccs
 ```
 
-#### オプション2: 直接インストール（従来型）
+<details>
+<summary><strong>代替案：直接インストール（従来型）</strong></summary>
+
+<br>
 
 **macOS / Linux**
 ```bash
@@ -64,7 +61,11 @@ curl -fsSL ccs.kaitran.ca/install | bash
 irm ccs.kaitran.ca/install | iex
 ```
 
-> **💡 パフォーマンス**: 従来型インストールはNode.jsルーティングをバイパスし起動が高速ですが、デプロイ自動化が容易なためnpm更新を優先します。
+**注**: 従来型インストールはNode.jsルーティングをバイパスし起動が高速ですが、デプロイ自動化が容易なためnpmを優先します。
+
+</details>
+
+<br>
 
 ### 設定（自動作成）
 
@@ -75,188 +76,503 @@ irm ccs.kaitran.ca/install | iex
 {
   "profiles": {
     "glm": "~/.ccs/glm.settings.json",
+    "glmt": "~/.ccs/glmt.settings.json",
     "kimi": "~/.ccs/kimi.settings.json",
     "default": "~/.claude/settings.json"
   }
 }
 ```
 
-### カスタムClaude CLIパス
+<details>
+<summary><h3>カスタムClaude CLIパス</h3></summary>
+
+<br>
 
 Claude CLIが標準以外の場所（Dドライブ、カスタムディレクトリ）にインストールされている場合は、`CCS_CLAUDE_PATH`を設定してください：
 
 ```bash
-export CCS_CLAUDE_PATH="/path/to/claude"              # Unix
-$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe"   # Windows
+# Unix/Linux/macOS
+export CCS_CLAUDE_PATH="/path/to/claude"
+
+# Windows PowerShell
+$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe"
 ```
 
-**詳細な設定手順については、[トラブルシューティングガイド](./docs/en/troubleshooting.md#claude-cli-in-non-standard-location)を参照してください。**
+**参照**: [トラブルシューティングガイド](./docs/en/troubleshooting.md#claude-cli-in-non-standard-location) 詳細な設定手順
 
----
+</details>
+
+<details>
+<summary><h3>Windowsシンボリックリンクサポート（開発者モード）</h3></summary>
+
+<br>
+
+**Windowsユーザー**: 本物のシンボリックリンクで高速な動作と即時同期を得るために開発者モードを有効にしてください：
+
+1. **設定** → **プライバシーとセキュリティ** → **開発者向け** を開く
+2. **開発者モード** を有効にする
+3. CCSを再インストール: `npm install -g @kaitranntt/ccs`
+
+**警告**: 開発者モードなしの場合、CCSは自動的にディレクトリコピーにフォールバック（動作しますが、プロファイル間の即時同期はありません）
+
+</details>
+
+<br>
 
 ### 最初の切り替え
 
-> **⚠️ 重要**: GLMまたはKimiプロファイルを使用する前に、対応する設定ファイルでAPIキーを更新する必要があります：
-> - **GLM**: `~/.ccs/glm.settings.json`を編集してGLM APIキーを追加
+> [!IMPORTANT]
+> **代替モデルを使用する前に、設定ファイルでAPIキーを更新してください：**
+>
+> - **GLM**: `~/.ccs/glm.settings.json`を編集してZ.AI Coding Plan APIキーを追加
+> - **GLMT**: `~/.ccs/glmt.settings.json`を編集してZ.AI Coding Plan APIキーを追加
 > - **Kimi**: `~/.ccs/kimi.settings.json`を編集してKimi APIキーを追加
 
+<br>
+
+**並列ワークフロー：計画 + 実行**
+
 ```bash
-# Claudeサブスクリプションを使用（デフォルト）で高レベルの計画
-ccs "マイクロサービスアーキテクチャの実装計画を立てて"
+# Terminal 1 - 計画（Claude Sonnet）
+ccs "認証とレート制限付きREST APIの計画"
+
+# Terminal 2 - 実行（GLM、コスト最適化）
+ccs glm "計画からユーザー認証エンドポイントを実装"
+```
 
-# GLMに切り替えてコスト最適化されたタスクを実行
-ccs glm "シンプルなREST APIを作成して"
+<details>
+<summary><strong>思考モデル（Kimi & GLMT）</strong></summary>
 
-# Kimiに切り替えて思考能力を活用
-ccs kimi "適切なエラーハンドリングで統合テストを書いて"
+<br>
+
+```bash
+# Kimi - 安定した思考サポート
+ccs kimi "トレードオフ分析付きキャッシュ戦略の設計"
+
+# GLMT - 実験的（詳細は下記参照）
+ccs glmt "推論ステップ付き複雑なアルゴリズムのデバッグ"
 ```
 
----
+**注**: GLMTは実験的で不安定です。詳細については下記の[GLM with Thinking (GLMT)](#glm-with-thinking-glmt)セクションを参照してください。
+
+</details>
+
+<br>
+
+## 開発者の日常的な課題
+
+<div align="center">
+
+### **切り替えを停止。調整を開始。**
+
+**セッション制限がフロー状態を殺すべきではありません。**
+</div>
+
+実装に深く集中しています。コンテキストが読み込まれました。解決策が結晶化しています。<br>
+その後: 🔴 _"使用制限に達しました。"_
+
+**モチベーションが失われました。コンテキストが失われました。生産性が崩壊しました。**
+
+## **解決策：並列ワークフロー**
 
-## 日常の開発者の課題
+<details>
+<summary><strong>❌ 古い方法：</strong> 制限に達した時に切り替える（反応的）</summary>
 
-開発者は日々多くのサブスクリプションシナリオに直面します：
+### 現在のワークフロー：
+- **14時:** 機能開発、ゾーン状態
+- **15時:** 🔴 使用制限に達した
+- **15:05:** 作業停止、`~/.claude/settings.json`を編集
+- **15:15:** アカウント切り替え、コンテキストが失われる
+- **15:30:** フロー状態に戻ろうと試みる
+- **16時:** ついに生産性が回復
 
-1. **アカウント分離**: 会社のClaudeアカウントと個人のClaude → 業務と個人のコンテキストを手動で切り替える必要
-2. **レート制限**: Claudeがプロジェクト途中で停止 → 手動で`~/.claude/settings.json`を編集
-3. **コスト管理**: 2-3つのProサブスクリプション（月$20） vs Claude Maxの5倍コスト（月$100）→ Pro階層が実用的な上限
-4. **モデル選択**: タスクごとに異なるモデルの強みを活用 → 手動切り替え
+- **結果:** 1時間失われ、モチベーションが破壊され、不満が蓄積
 
-手動コンテキスト切り替えはワークフローを中断します。**CCSがシームレスに管理します**。
+</details>
+
+<details open>
+<summary><strong>✨ 新しい方法：</strong> 最初から並列で実行（主導的） - <strong>推奨</strong></summary>
+
+### 新しいワークフロー：
+- **14時:** **ターミナル1:** `ccs "APIアーキテクチャを計画"` → 戦略的思考（Claude Pro）
+- **14時:** **ターミナル2:** `ccs glm "エンドポイントを実装"` → コード実行（GLM）
+- **15時:** まだ開発継続、割れなし
+- **16時:** フロー状態達成、生産性急上昇
+- **17時:** 機能が完了、コンテキスト維持
+
+- **結果:** ダウムタイムなし、継続的生産性、不満減少
+
+### 💰 **価値提案:**
+- **設定:** 既存のClaude Pro + GLM Lite（費用対効果の高い追加）
+- **価値:** 1時間/日 × 20労働日 = 20時間/月を回収
+- **ROI:** 開発時間は設定コスト以上の価値がある
+- **現実:** オーバーヘッドより速く出荷
+
+</details>
+
+## あなたの道を選択
+
+<details>
+<summary><strong>予算重視：</strong> GLMのみ</summary>
+
+- **最適:** 費用意識の高い開発、基本的なコード生成
+- **使用法:** 費用効果の高いAI支援のために`ccs glm`を直接使用
+- **現実:** Claudeアクセスなし、多くのコーディングタスクに対応可能
+- **設定:** GLM APIキーのみ、非常に手頃
+
+</details>
+
+<details open>
+<summary><strong>✨ 日々の開発に推奨：</strong> 1 Claude Pro + 1 GLM Lite</summary>
+
+- **最適:** 日々のコードデリバリー、真剣な開発作業
+- **使用法:** `ccs`で計画 + `ccs glm`で実行（並列ワークフロー）
+- **現実:** ほとんどの開発者にとって能力と費用の完璧なバランス
+- **価値:** セッション制限に達せず、継続的生産性
+
+</details>
+
+<details>
+<summary><strong>パワーユーザー：</strong> 複数のClaude Pro + GLM Pro</summary>
+
+- **最適:** 重い作業量、並行プロジェクト、ソロ開発
+- **解放:** セッション・週次制限を決して枯渇させない
+- **ワークフロー:** 3+以上のターミナルで専門タスクを同時実行
+
+</details>
+
+<details>
+<summary><strong>プライバシー重視：</strong> 仕事/個人の分離</summary>
+
+- **必要時:** 仕事と個人AIコンテキストの厳格な分離
+- **設定:** `ccs auth create work` + `ccs auth create personal`
+- **注意:** 高度な機能 - ほとんどのユーザーには不要
+
+</details>
+
+---
 
 ## 手動切り替えではなくCCSを使う理由は？
 
 <div align="center">
 
-| 機能 | メリット |
-|---------|---------|
-| **アカウント分離** | 業務と個人を分離 |
-| **コスト最適化** | 2-3つのProアカウント vs Max 5倍コスト |
-| **即座の切り替え** | 1コマンド、ファイル編集不要 |
-| **ゼロダウンタイム** | ワークフロー中断なし |
-| **レート制限管理** | 制限時にアカウント切り替え |
-| **クロスプラットフォーム** | macOS、Linux、Windows |
+**CCSは「午後3時に制限に達したら切り替える」ことではありません。**
+
+## **それは最初から並列で実行することです。**
 
 </div>
 
-**ソリューション**:
+### コアな違い
+
+| **手動切り替え** | **CCSオーケストレーション** |
+|:---|:---|
+| 🔴 制限達成 → 作業停止 → 設定ファイル編集 → 再起動 | ✅ 最初から異なるモデルで複数ターミナルを実行 |
+| 😰 コンテキストロスとフロー状態中断 | 😌 コンテキスト維持での継続的生産性 |
+| 📝 逐次的タスク処理 | ⚡ 並列ワークフロー（計画 + 実行を同時に） |
+| 🛠️ ブロックされた時の反応的問題解決 | 🎯 ブロックを防ぐ主導的ワークフロー設計 |
+
+### CCSが提供するもの
+
+- **ゼロコンテキスト切り替え:** 割れずにフロー状態を維持
+- **並列生産性:** 1ターミナルで戦略計画、もう1つでコード実行
+- **即座アカウント管理:** 1コマンド切り替え、設定ファイル編集不要
+- **仕事と生活の分離:** ログアウトせずにコンテキストを分離
+- **クロスプラットフォーム一貫性:** macOS、Linux、Windowsで同じスムーズな体験
+
+<br>
+
+## アーキテクチャ
+
+### プロファイルタイプ
+
+**設定ベース**: GLM, GLMT, Kimi, default
+- 設定ファイルを指す`--settings`フラグを使用
+- GLMT: 思考モードサポートの埋め込みプロキシ
+
+**アカウントベース**: work, personal, team
+- 分離されたインスタンスに`CLAUDE_CONFIG_DIR`を使用
+- `ccs auth create <profile>`で作成
+
+### 共有データ（v3.1）
+
+コマンドとスキルは`~/.ccs/shared/`からシンボリックリンク - プロファイル間の重複なし。
+
+```plaintext
+~/.ccs/
+├── shared/                  # すべてのプロファイルで共有
+│   ├── agents/
+│   ├── commands/
+│   └── skills/
+├── instances/               # プロファイル固有のデータ
+│   └── work/
+│       ├── agents@ → shared/agents/
+│       ├── commands@ → shared/commands/
+│       ├── skills@ → shared/skills/
+│       ├── settings.json    # APIキー、認証情報
+│       ├── sessions/        # 会話履歴
+│       └── ...
+```
+
+| タイプ | ファイル |
+|:-----|:------|
+| **共有** | `commands/`, `skills/`, `agents/` |
+| **プロファイル固有** | `settings.json`, `sessions/`, `todolists/`, `logs/` |
+
+> [!NOTE]
+> **Windows**: シンボリックリンクが利用できない場合はディレクトリをコピー（本物のシンボリックリンクには開発者モードを有効にしてください）
+
+<br>
+
+## 使用例
+
+### 基本的な切り替え
+
 ```bash
-ccs work          # 会社のClaudeアカウントを使用
-ccs personal      # 個人Claudeアカウントに切り替え
-ccs glm           # コスト効率の良いタスク用にGLMに切り替え
-ccs kimi          # 代替オプション用にKimiに切り替え
-# レート制限に達した？即座に切り替え：
-ccs glm           # GLMで作業を続行
-# 別の会社アカウントが必要？
-ccs work-2        # 2番目の会社アカウントに切り替え
+ccs              # Claudeサブスクリプション（デフォルト）
+ccs glm          # GLM（コスト最適化）
+ccs kimi         # Kimi（思考サポート付き）
 ```
 
----
+### マルチアカウント設定
 
-## 🏗️ アーキテクチャ概要
+```bash
+# アカウントを作成
+ccs auth create work
+ccs auth create personal
+```
+
+**別々のターミナルで同時に実行：**
+
+```bash
+# Terminal 1 - 業務用
+ccs work "機能を実装"
+
+# Terminal 2 - 個人用（同時）
+ccs personal "コードレビュー"
+```
+
+### ヘルプとバージョン
+
+```bash
+ccs --version    # バージョンを表示
+ccs --help       # すべてのコマンドとオプションを表示
+```
 
-**v3.0 Login-Per-Profileモデル**: 各プロファイルは独立したClaudeインスタンスで、ユーザーが直接ログインします。資格情報のコピーやvault暗号化は不要です。
+<br>
 
-```mermaid
-flowchart TD
-    subgraph "ユーザー入力"
-        USER["ユーザー実行: ccs &lt;profile&gt; [args...]"]
-    end
+## GLM with Thinking (GLMT)
 
-    subgraph "プロファイル検出エンジン"
-        DETECT[ProfileDetector]
-        PROFILE_CHECK{プロファイル存在?}
+> [!CAUTION]
+> ### 本番環境未対応 - 実験的機能
+>
+> **GLMTは実験的で広範なデバッグが必要です**：
+> - ストリーミングとツールサポートはまだ開発中
+> - 予期せぬエラー、タイムアウト、不完全な応答が発生する可能性
+> - 頻繁なデバッグと手動介入が必要
+> - **重要なワークフローや本番使用には推奨されません**
+>
+> **GLM Thinkingの代替案**: **CCR hustle**と**BedollaのTransformer**（[ZaiTransformer](https://github.com/Bedolla/ZaiTransformer/)）を通じて、より安定した実装を検討してください。
 
-        subgraph "プロファイルタイプ"
-            SETTINGS["Settings-based<br/>glm, kimi, default"]
-            ACCOUNT["Account-based<br/>work, personal, team"]
-        end
-    end
+> [!IMPORTANT]
+> GLMTはnpmインストールが必要です（`npm install -g @kaitranntt/ccs`）。ネイティブシェルバージョンでは利用できません（Node.js HTTPサーバーが必要）。
+
+<br>
+
+> [!NOTE]
+> ### 謝辞：GLMTを可能にした基盤
+>
+> **CCSのGLMT実装は、[@Bedolla](https://github.com/Bedolla)の画期的な仕事に存在を負っています**。彼は[Claude Code Router (CCR)](https://github.com/musistudio/claude-code-router)とZ.AIの推論能力をブリッジする[最初の統合](https://github.com/Bedolla/ZaiTransformer/)を作成しました。
+>
+> ZaiTransformer以前、誰もZ.AIの思考モードとClaude Codeのワークフローを正常に統合できませんでした。Bedollaの仕事は単なる有用なものではなく、**基盤的**でした。彼のリクエスト/レスポンストランスフォーメーションアーキテクチャ、思考モード制御メカニズム、埋め込みプロキシ設計の実装は、GLMTの設計に直接インスピレーションを与え、可能にしました。
+>
+> **ZaiTransformerの先駆的な仕事なしでは、GLMTは現在の形では存在しませんでした。** GLMTの思考能力から利益を得る場合は、Claude Codeエコシステムでの先駆的な仕事をサポートするために[ZaiTransformer](https://github.com/Bedolla/ZaiTransformer/)にスターを付けてください。
+
+<br>
+
+<details>
+<summary><h3>GLM vs GLMT 比較</h3></summary>
+
+<br>
+
+<div align="center">
+
+| 機能 | GLM (`ccs glm`) | GLMT (`ccs glmt`) |
+|:--------|:----------------|:------------------|
+| **エンドポイント** | Anthropic互換 | OpenAI互換 |
+| **思考** | なし | 実験的（reasoning_content） |
+| **ツールサポート** | 基本的 | **不安定（v3.5+）** |
+| **MCPツール** | 制限あり | **バグあり（v3.5+）** |
+| **ストリーミング** | 安定 | **実験的（v3.4+）** |
+| **TTFB** | <500ms | <500ms（時々）、2-10秒+（頻繁） |
+| **使用例** | 信頼性の高い作業 | **デバッグ実験のみ** |
+
+</div>
 
-    subgraph "CCSコア処理"
-        CONFIG["config.jsonと<br/>profiles.jsonを読み込み"]
+</details>
 
-        subgraph "プロファイルハンドラー"
-            SETTINGS_MGR["SettingsManager<br/>→ --settings flag"]
-            INSTANCE_MGR["InstanceManager<br/>→ CLAUDE_CONFIG_DIR"]
-        end
-    end
+<br>
 
-    subgraph "Claude CLI実行"
-        CLAUDE_DETECT["Claude CLI検出<br/>CCS_CLAUDE_PATHサポート"]
+<details>
+<summary><h3>ツールサポート（v3.5） - 実験的</h3></summary>
 
-        subgraph "実行方法"
-            SETTINGS_EXEC["claude --settings &lt;path&gt;"]
-            INSTANCE_EXEC["CLAUDE_CONFIG_DIR=&lt;instance&gt; claude"]
-        end
-    end
+<br>
 
-    subgraph "APIレイヤー"
-        API["API Response<br/>Claude Sonnet 4.5<br/>GLM 4.6<br/>Kimi K2 Thinking"]
-    end
+**GLMTはMCPツールと関数呼び出しを試行：**
 
-    %% Flow connections
-    USER --> DETECT
-    DETECT --> PROFILE_CHECK
-    PROFILE_CHECK -->|はい| SETTINGS
-    PROFILE_CHECK -->|はい| ACCOUNT
+- **双方向トランスフォーメーション**: Anthropicツール ↔ OpenAI形式（不安定）
+- **MCP統合**: MCPツールが時々実行（多くの場合XMLガベージを出力）
+- **ストリーミングツール呼び出し**: リアルタイムツール呼び出し（クラッシュしない場合）
+- **後方互換**: 既存の思考サポートを破壊する可能性
+- **設定が必要**: 頻繁な手動デバッグが必要
 
-    SETTINGS --> CONFIG
-    ACCOUNT --> CONFIG
+</details>
 
-    CONFIG --> SETTINGS_MGR
-    CONFIG --> INSTANCE_MGR
+<details>
+<summary><h3>ストリーミングサポート（v3.4） - しばしば失敗</h3></summary>
 
-    SETTINGS_MGR --> SETTINGS_EXEC
-    INSTANCE_MGR --> INSTANCE_EXEC
+<br>
 
-    SETTINGS_EXEC --> CLAUDE_DETECT
-    INSTANCE_EXEC --> CLAUDE_DETECT
+**GLMTは増分推論コンテンツ配信でリアルタイムストリーミングを試行：**
 
-    CLAUDE_DETECT --> API
+- **デフォルト**: ストリーミング有効（動作時TTFB <500ms）
+- **自動フォールバック**: エラーにより頻繁にバッファモードに切り替え
+- **思考パラメータ**: Claude CLI `thinking`パラメータが時々動作
+  - `thinking.type`と`budget_tokens`を無視する場合
+  - 優先順位: CLIパラメータ > メッセージタグ > デフォルト（破壊されていない場合）
+
+**ステータス**: Z.AI（テスト済み、ツール呼び出しが頻繁に破壊、継続的なデバッグが必要）
+
+</details>
+
+<details>
+<summary><h3>動作原理（動作時）</h3></summary>
+
+<br>
+
+1. CCSがlocalhostに埋め込みHTTPプロキシを生成（クラッシュしない場合）
+2. プロキシがAnthropic形式 → OpenAI形式への変換を試行（多くの場合失敗）
+3. Anthropicツール → OpenAI関数呼び出し形式への変換を試行（バグあり）
+4. 推論パラメータとツールを付けてZ.AIに転送（タイムアウトしない場合）
+5. `reasoning_content` → 思考ブロックへの変換を試行（部分的または破壊）
+6. OpenAI `tool_calls` → Anthropic `tool_use` ブロックへの変換を試行（XMLガベージが一般的）
+7. 思考とツール呼び出しが時々Claude Code UIに表示（破壊されていない場合）
+
+</details>
+
+<details>
+<summary><h3>制御タグとキーワード</h3></summary>
+
+<br>
+
+**制御タグ**:
+- `<Thinking:On|Off>` - 推論ブロックの有効/無効（デフォルト: On）
+- `<Effort:Low|Medium|High>` - 推論深度の制御（非推奨 - Z.AIはバイナリ思考のみサポート）
+
+**思考キーワード**（不安定なアクティベーション）:
+- `think` - 時々推論を有効化（低労力）
+- `think hard` - 時々推論を有効化（中労力）
+- `think harder` - 時々推論を有効化（高労力）
+- `ultrathink` - 最大推論深度を試行（多くの場合破壊）
+
+</details>
+
+<details>
+<summary><h3>環境変数</h3></summary>
+
+<br>
+
+**GLMT機能**（すべて実験的）:
+- 強制的な英語出力強制（時々動作）
+- ランダムな思考モードアクティベーション（予測不可能）
+- 頻繁なバッファモードへのフォールバック付きストリーミング試行
+
+**一般**:
+- `CCS_DEBUG_LOG=1` - デバッグファイルロギングを有効化
+- `CCS_CLAUDE_PATH=/path/to/claude` - カスタムClaude CLIパス
+
+</details>
+
+<details>
+<summary><h3>APIキー設定</h3></summary>
+
+<br>
+
+```bash
+# GLMT設定を編集
+nano ~/.ccs/glmt.settings.json
 ```
 
----
+Z.AI APIキーを設定（コーディングプランが必要）：
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-z-ai-api-key"
+  }
+}
+```
 
-## ⚡ 機能
+</details>
 
-- **即座の切り替え** - `ccs glm`でGLMに切り替え、設定編集不要
-- **同時セッション** - 複数のプロファイルを異なるターミナルで同時実行
-- **独立したインスタンス** - 各プロファイルが独自の設定を保持 (`~/.ccs/instances/<profile>/`)
-- **クロスプラットフォーム** - macOS、Linux、Windows - 同一動作
-- **ダウンタイムなし** - 即座に切り替え、ワークフロー中断なし
+<details>
+<summary><h3>セキュリティ制限（DoS保護）</h3></summary>
 
+<br>
 
----
+**v3.4 保護制限**:
+
+| 制限 | 値 | 目的 |
+|:------|:------|:--------|
+| **SSEバッファ** | イベントあたり最大1MB | バッファオーバーフローを防止 |
+| **コンテンツバッファ** | ブロックあたり最大10MB | 思考/テキストブロックを制限 |
+| **コンテンツブロック** | メッセージあたり最大100 | DoS攻撃を防止 |
+| **リクエストタイムアウト** | 120秒 | ストリーミングとバッファの両方 |
+
+</details>
 
-## 💻 使用例
+<details>
+<summary><h3>デバッグ</h3></summary>
 
+<br>
+
+**詳細ロギングを有効化**:
 ```bash
-ccs              # Claudeサブスクリプションを使用（デフォルト）
-ccs glm          # GLMフォールバックを使用
-ccs kimi         # Kimi for Codingを使用
-ccs --version    # CCSバージョンとインストール場所を表示
+ccs glmt --verbose "your prompt"
 ```
 
-### 同時セッション (Multi-Account)
+**デバッグファイルロギングを有効化**:
 ```bash
-# 複数のClaudeアカウントを作成
-ccs auth create work       # 業務用アカウント
-ccs auth create personal   # 個人用アカウント
-ccs auth create team       # チーム用アカウント
+export CCS_DEBUG_LOG=1
+ccs glmt --verbose "your prompt"
+# ログ: ~/.ccs/logs/
+```
 
-# ターミナル1 - 業務用アカウント
-ccs work "implement feature"
+**GLMTデバッグ**:
+```bash
+# 詳細ロギングでストリーミングステータスと推論詳細を表示
+ccs glmt --verbose "test"
+```
 
-# ターミナル2 - 個人用アカウント（同時実行）
-ccs personal "review code"
+**推論コンテンツを確認**:
+```bash
+cat ~/.ccs/logs/*response-openai.json | jq '.choices[0].message.reasoning_content'
 ```
 
----
+**トラブルシューティング**:
+- **存在しない場合**: Z.AI APIの問題（キー、アカウントステータスを確認）
+- **存在する場合**: トランスフォーメーションの問題（`response-anthropic.json`を確認）
+
+</details>
+
+<br>
+
+## アンインストール
+
+<details>
+<summary><h3>パッケージマネージャー</h3></summary>
 
-### 🗑️ アンインストール
+<br>
 
-**パッケージマネージャー**
 ```bash
 # npm
 npm uninstall -g @kaitranntt/ccs
@@ -271,19 +587,24 @@ pnpm remove -g @kaitranntt/ccs
 bun remove -g @kaitranntt/ccs
 ```
 
-**公式アンインストーラー**
+</details>
+
+<details>
+<summary><h3>公式アンインストーラー</h3></summary>
+
+<br>
 
-**macOS / Linux**
 ```bash
+# macOS / Linux
 curl -fsSL ccs.kaitran.ca/uninstall | bash
-```
 
-**Windows PowerShell**
-```powershell
+# Windows PowerShell
 irm ccs.kaitran.ca/uninstall | iex
 ```
 
----
+</details>
+
+<br>
 
 ## 🎯 哲学
 
@@ -291,30 +612,33 @@ irm ccs.kaitran.ca/uninstall | iex
 - **KISS**: シンプルなbash、複雑さなし
 - **DRY**: 単一の情報源（設定）
 
----
-
 ## 📖 ドキュメント
 
 **[docs/](./docs/)の完全なドキュメント**:
 - [インストールガイド](./docs/en/installation.md)
 - [設定](./docs/en/configuration.md)
 - [使用例](./docs/en/usage.md)
+- [システムアーキテクチャ](./docs/system-architecture.md)
+- [GLMT制御メカニズム](./docs/glmt-controls.md)
 - [トラブルシューティング](./docs/en/troubleshooting.md)
-- [コントリビューション](./CONTRIBUTING.md)
+- [貢献](./CONTRIBUTING.md)
 
----
+## 🤝 貢献
 
-## 🤝 コントリビューション
+貢献を歓迎します！詳細については[貢献ガイド](./CONTRIBUTING.md)をご覧ください。
 
-コントリビューションを歓迎します！詳細については[コントリビューションガイド](./CONTRIBUTING.md)をご覧ください。
+## Star History
 
----
+<div align="center">
 
-## 📄 ライセンス
+<img src="https://api.star-history.com/svg?repos=kaitranntt/ccs&type=timeline&logscale&legend=top-left" alt="Star History Chart" width="800">
 
-CCSは[MITライセンス](LICENSE)の下でライセンスされています。
+</div>
 
----
+
+## ライセンス
+
+CCSは[MITライセンス](LICENSE)の下でライセンスされています。
 
 <div align="center">
 
@@ -322,4 +646,4 @@ CCSは[MITライセンス](LICENSE)の下でライセンスされています。
 
 [⭐ このリポジトリにスター](https://github.com/kaitranntt/ccs) | [🐛 問題を報告](https://github.com/kaitranntt/ccs/issues) | [📖 ドキュメントを読む](./docs/en/)
 
-</div>
+</div>