@kaitranntt/ccs 3.4.6 → 4.1.0

package/README.vi.md

@@ -1,44 +1,39 @@
-# CCS - Claude Code Switch
-
 <div align="center">
 
+# CCS - Claude Code Switch
+
 ![CCS Logo](docs/assets/ccs-logo-medium.png)
 
-**Một lệnh, không downtime, nhiều tài khoản**
+### Một lệnh, không downtime, nhiều tài khoản
 
-Chuyển đổi giữa nhiều tài khoản Claude, GLM, và Kimi ngay lập tức.<br>
+**Chuyển đổi giữa nhiều tài khoản Claude, GLM, và Kimi ngay lập tức.**
 Ngừng hitting rate limits. Làm việc liên tục.
 
+<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)
 
-**Ngôn ngữ**: [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>
 
----
-
-## 🚀 Bắt Đầu Nhanh
+<br>
 
-### 🔑 Điều Kiện Tiên Quyết
+## Bắt Đầu Nhanh
 
-**Trước khi cài đặt CCS, hãy đảm bảo bạn đã đăng nhập vào Claude CLI với tài khoản subscription:**
-```bash
-claude /login
-```
+### Cài Đặt
 
-### Phương Pháp Cài Đặt Chính
-
-#### Option 1: npm Package (Được khuyến nghị)
+**npm Package (Được khuyến nghị)**
 
 **macOS / Linux / Windows**
 ```bash
 npm install -g @kaitranntt/ccs
 ```
 
-Tất cả các trình quản lý package chính đều được hỗ trợ:
+**Tất cả các trình quản lý package chính đều được hỗ trợ:**
 
 ```bash
 # yarn
@@ -51,7 +46,10 @@ pnpm add -g @kaitranntt/ccs
 bun add -g @kaitranntt/ccs
 ```
 
-#### Option 2: Cài Đặt Trực Tiếp (Truyền thống)
+<details>
+<summary><strong>Phương án thay thế: Cài Đặt Trực Tiếp (Truyền thống)</strong></summary>
+
+<br>
 
 **macOS / Linux**
 ```bash
@@ -63,7 +61,11 @@ curl -fsSL ccs.kaitran.ca/install | bash
 irm ccs.kaitran.ca/install | iex
 ```
 
-> **💡 Mẹo hiệu năng**: Cài truyền thống bỏ qua Node.js routing để khởi động nhanh hơn, nhưng tôi ưu tiên cập nhật npm do triển khai dễ dàng hơn.
+**Lưu ý**: Cài truyền thống bỏ qua Node.js routing để khởi động nhanh hơn, nhưng ưu tiên npm cho dễ dàng tự động hóa triển khai.
+
+</details>
+
+<br>
 
 ### Cấu Hình (Tự Tạo)
 
@@ -74,186 +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"
   }
 }
 ```
 
-### Đường Dẫn Claude CLI Tùy Chỉnh
+<details>
+<summary><h3>Custom Claude CLI Path</h3></summary>
+
+<br>
 
 Nếu Claude CLI được cài đặt ở vị trí không chuẩn (ổ D, thư mục tùy chỉnh), đặt `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"
 ```
 
-**Xem [Hướng dẫn Khắc phục Sự cố](./docs/vi/troubleshooting.vi.md#claude-cli-ở-vị-trí-không-chuẩn) để biết chi tiết cài đặt.**
+**Xem thêm**: [Hướng dẫn Khắc phục Sự cố](./docs/en/troubleshooting.md#claude-cli-in-non-standard-location) để biết chi tiết cài đặt.
 
----
+</details>
+
+<details>
+<summary><h3>Windows Symlink Support (Developer Mode)</h3></summary>
+
+<br>
+
+**Người dùng Windows**: Bật Chế độ Nhà phát triển để có symlink thực sự (hiệu suất tốt hơn, đồng bộ hóa tức thì):
+
+1. Mở **Settings** → **Privacy & Security** → **For developers**
+2. Bật **Developer Mode**
+3. Cài đặt lại CCS: `npm install -g @kaitranntt/ccs`
+
+**Cảnh báo**: Nếu không có Chế độ Nhà phát triển, CCS tự động chuyển sang sao chép thư mục (hoạt động nhưng không đồng bộ tức thì trên các profile).
+
+</details>
+
+<br>
 
 ### Lần Chuyển Đổi Đầu Tiên
 
-> **⚠️ Quan trọng**: Trước khi dùng profile GLM hay Kimi, bạn cần cập nhật API key trong file settings tương ứng:
-> - **GLM**: Chỉnh sửa `~/.ccs/glm.settings.json` và thêm GLM API key của bạn
+> [!IMPORTANT]
+> **Trước khi dùng các mô hình thay thế, cập nhật API keys trong file settings:**
+>
+> - **GLM**: Chỉnh sửa `~/.ccs/glm.settings.json` và thêm Z.AI Coding Plan API Key của bạn
+> - **GLMT**: Chỉnh sửa `~/.ccs/glmt.settings.json` và thêm Z.AI Coding Plan API Key của bạn
 > - **Kimi**: Chỉnh sửa `~/.ccs/kimi.settings.json` và thêm Kimi API key của bạn
 
+<br>
+
+**Parallel Workflow: Planning + Execution**
+
 ```bash
-# Dùng Claude subscription (mặc định) cho lập trình cấp cao
-ccs "Lên kế hoạch triển khai kiến trúc microservices"
+# Terminal 1 - Planning (Claude Sonnet)
+ccs "Plan a REST API with authentication and rate limiting"
+
+# Terminal 2 - Execution (GLM, cost-optimized)
+ccs glm "Implement the user authentication endpoints from the plan"
+```
+
+<details>
+<summary><strong>Thinking Models (Kimi & GLMT)</strong></summary>
 
-# Chuyển sang GLM cho tác vụ tối ưu chi phí
-ccs glm "Tạo REST API đơn giản"
+<br>
 
-# Chuyển sang Kimi để sử dụng khả năng thinking
-ccs kimi "Viết integration tests với xử lý lỗi phù hợp"
+```bash
+# Kimi - Stable thinking support
+ccs kimi "Design a caching strategy with trade-off analysis"
+
+# GLMT - Experimental (see full disclaimer below)
+ccs glmt "Debug complex algorithm with reasoning steps"
 ```
 
----
+**Lưu ý:** GLMT là thử nghiệm và không ổn định. Xem phần [GLM with Thinking (GLMT)](#glm-with-thinking-glmt) dưới đây để biết chi tiết.
+
+</details>
+
+<br>
+
+## The Daily Developer Pain Point
+
+<div align="center">
+
+### **DỪNG việc chuyển đổi. BẮT ĐẦU điều phối.**
+
+**Giới hạn phiên không nên phá hỏng trạng thái dòng chảy của bạn.**
+</div>
+
+Bạn đang sâu trong triển khai. Ngữ cảnh đã tải. Giải pháp đang kết tinh.<br>
+Sau đó: 🔴 _"Bạn đã đạt đến giới hạn sử dụng."_
+
+**Động lực mất đi. Ngữ cảnh mất. Năng suất sụp đổ.**
 
-## Điểm Đau Hàng Ngày Của Lập Trình Viên
+## **Giải pháp: Quy trình công việc song song**
 
-Lập trình viên đối mặt nhiều kịch bản subscription hàng ngày:
+<details>
+<summary><strong>❌ CÁCH CŨ:</strong> Chuyển đổi khi bạn đạt đến giới hạn (Phản ứng)</summary>
 
-1. **Phân Tách Account**: Tài khoản Claude công ty vs Claude cá nhân → bạn phải tự chuyển context để giữ công việc và cá nhân riêng biệt
-2. **Hết Rate Limit**: Claude dừng giữa chừng project → bạn phải tự tay sửa `~/.claude/settings.json`
-3. **Quản Lý Chi Phí**: 2-3 subscriptions Pro ($20/tháng) vs Claude Max với chi phí 5x ($100/tháng) → Tier Pro là ngưỡng thực tế cho hầu hết lập trình viên
-4. **Lựa Chọn Model**: Tác vụ khác nhau hưởng lợi từ thế mạnh model khác nhau → chuyển đổi thủ công
+### Quy trình làm việc hiện tại của bạn:
+- **2pm:** Xây dựng tính năng, trong vùng
+- **3pm:** 🔴 Đạt giới hạn sử dụng
+- **3:05pm:** Dừng công việc, chỉnh sửa `~/.claude/settings.json`
+- **3:15pm:** Chuyển tài khoản, mất ngữ cảnh
+- **3:30pm:** Cố gắng quay lại trạng thái dòng chảy
+- **4pm:** Cuối cùng cũng năng suất trở lại
 
-Chuyển đổi context thủ công làm gián đoạn workflow. **CCS quản lý liền mạch**.
+- **Kết quả:** Mất 1 giờ, động lực bị phá hủy, sự thất vọng tăng lên
 
-## Tại Sao CCS Thay Vì Chuyển Đổi Thủ Công?
+</details>
+
+<details open>
+<summary><strong>✨ CÁCH MỚI:</strong> Chạy song song ngay từ đầu (Chủ động) - <strong>ĐƯỢC KHUYÊN NGHỊ</strong></summary>
+
+### Quy trình làm việc mới của bạn:
+- **2pm:** **Terminal 1:** `ccs "Lập kế hoạch kiến trúc API"` → Tư duy chiến lược (Claude Pro)
+- **2pm:** **Terminal 2:** `ccs glm "Triển khai các điểm cuối API"` → Thực thi mã (GLM)
+- **3pm:** Vẫn đang giao hàng, không có gián đoạn
+- **4pm:** Đạt trạng thái dòng chảy, năng suất tăng vọt
+- **5pm:** Tính năng đã giao hàng, ngữ cảnh được duy trì
+
+- **Kết quả:** Không có thời gian chết, năng suất liên tục, ít thất vọng hơn
+
+### 💰 **Giá trị đề xuất:**
+- **Thiết lập:** Claude Pro hiện tại của bạn + GLM Lite (add-on hiệu quả về chi phí)
+- **Giá trị:** Tiết kiệm 1 giờ/ngày × 20 ngày làm việc = 20 giờ/tháng được phục hồi
+- **ROI:** Thời gian phát triển của bạn có giá trị hơn chi phí thiết lập
+- **Thực tế:** Giao hàng nhanh hơn chi phí vận hành
+
+</details>
+
+## Chọn con đường của bạn
+
+<details>
+<summary><strong>Tập trung vào ngân sách:</strong> Chỉ GLM</summary>
+
+- **Tốt nhất cho:** Phát triển tiết kiệm chi phí, tạo mã cơ bản
+- **Sử dụng:** Chỉ sử dụng `ccs glm` trực tiếp để được trợ giúp AI hiệu quả về chi phí
+- **Thực tế:** Không có quyền truy cập Claude, nhưng có khả năng cho nhiều nhiệm vụ mã hóa
+- **Thiết lập:** Chỉ cần API key GLM, rất phải chăng
+
+</details>
+
+<details open>
+<summary><strong>✨ Được khuyên nghị cho phát triển hàng ngày:</strong> 1 Claude Pro + 1 GLM Lite</summary>
+
+- **Tốt nhất cho:** Giao hàng mã hàng ngày, công việc phát triển nghiêm túc
+- **Sử dụng:** `ccs` để lập kế hoạch + `ccs glm` để thực thi (quy trình công việc song song)
+- **Thực tế:** Cân bằng hoàn hảo giữa khả năng và chi phí cho hầu hết các nhà phát triển
+- **Giá trị:** Không bao giờ đạt đến giới hạn phiên, năng suất liên tục
+
+</details>
+
+<details>
+<summary><strong>Power User:</strong> Nhiều Claude Pro + GLM Pro</summary>
+
+- **Tốt nhất cho:** Nhiều công việc, dự án đồng thời, solo dev
+- **Mở khóa:** Không bao giờ cạn kiệt giới hạn phiên hoặc hàng tuần
+- **Quy trình làm việc:** 3+ terminal chạy các nhiệm vụ chuyên biệt đồng thời
+
+</details>
+
+<details>
+<summary><strong>Tập trung vào quyền riêng tư:</strong> Cách ly Công việc/Cá nhân</summary>
+
+- **Khi cần:** Cách ly nghiêm ngặt ngữ cảnh AI công việc và cá nhân
+- **Thiết lập:** `ccs auth create work` + `ccs auth create personal`
+- **Lưu ý:** Tính năng nâng cao - hầu hết người dùng không cần điều này
+
+</details>
+
+---
+
+## Why CCS Instead of Manual Switching?
 
 <div align="center">
 
-| Tính năng | Lợi ích |
-|-----------|---------|
-| **Phân Cách Account** | Giữ công việc riêng với cá nhân |
-| **Tối Ưu Chi Phí** | 2-3 account Pro vs Max 5x chi phí |
-| **Chuyển Đổi Tức Thì** | Một lệnh, không sửa file |
-| **Không Downtime** | Không gián đoạn workflow |
-| **Quản Lý Rate Limit** | Chuyển account khi hết limit |
-| **Đa Nền Tảng** | macOS, Linux, Windows |
+**CCS không phải về "chuyển đổi khi bạn đạt đến giới hạn lúc 3pm."**
+
+## **Nó về việc chạy song song ngay từ đầu.**
 
 </div>
 
-**Giải pháp**:
+### Sự khác biệt cốt lõi
+
+| **Chuyển đổi thủ công** | **Điều phối CCS** |
+|:---|:---|
+| 🔴 Đạt giới hạn → Dừng công việc → Chỉnh sửa tệp cấu hình → Khởi động lại | ✅ Nhiều terminal chạy các mô hình khác nhau ngay từ đầu |
+| 😰 Mất ngữ cảnh và gián đoạn trạng thái dòng chảy | 😌 Năng suất liên tục với ngữ cảnh được bảo toàn |
+| 📝 Xử lý nhiệm vụ tuần tự | ⚡ Quy trình công việc song song (lập kế hoạch + thực thi đồng thời) |
+| 🛠️ Giải quyết vấn đề phản ứng khi bị chặn | 🎯 Thiết kế quy trình công việc chủ động ngăn chặn chặn |
+
+### CCS mang lại cho bạn
+
+- **Không chuyển đổi ngữ cảnh:** Duy trì trạng thái dòng chảy của bạn mà không bị gián đoạn
+- **Năng suất song song:** Lập kế hoạch chiến lược trong một terminal, thực thi mã trong terminal khác
+- **Quản lý tài khoản tức thì:** Một lệnh chuyển đổi, không cần chỉnh sửa tệp cấu hình
+- **Cách ly công việc-cuộc sống:** Cách ly ngữ cảnh mà không cần đăng xuất
+- **Tính nhất quán đa nền tảng:** Trải nghiệm mượt mà tương tự trên macOS, Linux, Windows
+
+<br>
+
+## Architecture
+
+### Profile Types
+
+**Settings-based**: GLM, GLMT, Kimi, default
+- Uses `--settings` flag pointing to config files
+- GLMT: Embedded proxy for thinking mode support
+
+**Account-based**: work, personal, team
+- Uses `CLAUDE_CONFIG_DIR` for isolated instances
+- Create with `ccs auth create <profile>`
+
+### Shared Data (v3.1)
+
+Commands and skills symlinked from `~/.ccs/shared/` - **no duplication across profiles**.
+
+```plaintext
+~/.ccs/
+├── shared/                  # Shared across all profiles
+│   ├── agents/
+│   ├── commands/
+│   └── skills/
+├── instances/               # Profile-specific data
+│   └── work/
+│       ├── agents@ → shared/agents/
+│       ├── commands@ → shared/commands/
+│       ├── skills@ → shared/skills/
+│       ├── settings.json    # API keys, credentials
+│       ├── sessions/        # Conversation history
+│       └── ...
+```
+
+| Type | Files |
+|:-----|:------|
+| **Shared** | `commands/`, `skills/`, `agents/` |
+| **Profile-specific** | `settings.json`, `sessions/`, `todolists/`, `logs/` |
+
+> [!NOTE]
+> **Windows**: Copies directories if symlinks unavailable (enable Developer Mode for true symlinks)
+
+<br>
+
+## Usage Examples
+
+### Basic Switching
+
 ```bash
-ccs cong-ty      # Dùng account Claude công ty
-ccs ca-nhan      # Chuyển sang account Claude cá nhân
-ccs glm          # Chuyển sang GLM cho tác vụ tối ưu chi phí
-ccs kimi         # Chuyển sang Kimi cho lựa chọn thay thế
-# Hết rate limit? Chuyển ngay:
-ccs glm          # Tiếp tục làm việc với GLM
-# Cần account công ty khác?
-ccs cong-ty-2    # Chuyển sang account công ty thứ hai
+ccs              # Claude subscription (default)
+ccs glm          # GLM (cost-optimized)
+ccs kimi         # Kimi (with thinking support)
 ```
 
----
+### Multi-Account Setup
+
+```bash
+# Create accounts
+ccs auth create work
+ccs auth create personal
+```
+
+**Run concurrently in separate terminals:**
+
+```bash
+# Terminal 1 - Work
+ccs work "implement feature"
+
+# Terminal 2 - Personal (concurrent)
+ccs personal "review code"
+```
+
+### Help & Version
+
+```bash
+ccs --version    # Show version
+ccs --help       # Show all commands and options
+```
+
+<br>
+
+## GLM with Thinking (GLMT)
+
+> [!CAUTION]
+> ### NOT PRODUCTION READY - EXPERIMENTAL FEATURE
+>
+> **GLMT is experimental and requires extensive debugging**:
+> - Streaming and tool support still under active development
+> - May experience unexpected errors, timeouts, or incomplete responses
+> - Requires frequent debugging and manual intervention
+> - **Not recommended for critical workflows or production use**
+>
+> **Alternative for GLM Thinking**: Consider going through the **CCR hustle** with the **Transformer of Bedolla** ([ZaiTransformer](https://github.com/Bedolla/ZaiTransformer/)) for a more stable implementation.
+
+> [!IMPORTANT]
+> GLMT requires npm installation (`npm install -g @kaitranntt/ccs`). Not available in native shell versions (requires Node.js HTTP server).
+
+<br>
+
+> [!NOTE]
+> ### Acknowledgments: The Foundation That Made GLMT Possible
+>
+> **CCS's GLMT implementation owes its existence to the groundbreaking work of [@Bedolla](https://github.com/Bedolla)**, who created [ZaiTransformer](https://github.com/Bedolla/ZaiTransformer/) - the **first integration** to bridge [Claude Code Router (CCR)](https://github.com/musistudio/claude-code-router) with Z.AI's reasoning capabilities.
+>
+> Before ZaiTransformer, no one had successfully integrated Z.AI's thinking mode with Claude Code's workflow. Bedolla's work wasn't just helpful - it was **foundational**. His implementation of request/response transformation architecture, thinking mode control mechanisms, and embedded proxy design directly inspired and enabled GLMT's design.
+>
+> **Without ZaiTransformer's pioneering work, GLMT wouldn't exist in its current form.** If you benefit from GLMT's thinking capabilities, please consider starring [ZaiTransformer](https://github.com/Bedolla/ZaiTransformer/) to support pioneering work in the Claude Code ecosystem.
+
+<br>
+
+<details>
+<summary><h3>GLM vs GLMT Comparison</h3></summary>
+
+<br>
+
+<div align="center">
+
+| Feature | GLM (`ccs glm`) | GLMT (`ccs glmt`) |
+|:--------|:----------------|:------------------|
+| **Endpoint** | Anthropic-compatible | OpenAI-compatible |
+| **Thinking** | No | Experimental (`reasoning_content`) |
+| **Tool Support** | Basic | **Unstable (v3.5+)** |
+| **MCP Tools** | Limited | **Buggy (v3.5+)** |
+| **Streaming** | Stable | **Experimental (v3.4+)** |
+| **TTFB** | <500ms | <500ms (sometimes), 2-10s+ (often) |
+| **Use Case** | Reliable work | **Debugging experiments only** |
+
+</div>
+
+</details>
+
+<br>
+
+<details>
+<summary><h3>Tool Support (v3.5) - EXPERIMENTAL</h3></summary>
+
+<br>
+
+**GLMT attempts MCP tools and function calling:**
+
+- **Bidirectional Transformation**: Anthropic tools ↔ OpenAI format (unstable)
+- **MCP Integration**: MCP tools sometimes execute (often output XML garbage)
+- **Streaming Tool Calls**: Real-time tool calls (when not crashing)
+- **Backward Compatible**: May break existing thinking support
+- **Configuration Required**: Frequent manual debugging needed
+
+</details>
+
+<details>
+<summary><h3>Streaming Support (v3.4) - OFTEN FAILS</h3></summary>
+
+<br>
+
+**GLMT attempts real-time streaming** with incremental reasoning content delivery:
+
+- **Default**: Streaming enabled (TTFB <500ms when it works)
+- **Auto-fallback**: Frequently switches to buffered mode due to errors
+- **Thinking parameter**: Claude CLI `thinking` parameter sometimes works
+  - May ignore `thinking.type` and `budget_tokens`
+  - Precedence: CLI parameter > message tags > default (when not broken)
+
+**Status**: Z.AI (tested, tool calls frequently break, requires constant debugging)
 
-## 🏗️ Tổng Quan Kiến Trúc
+</details>
 
-**v3.0 Mô hình Login-Per-Profile**: Mỗi profile là một Claude instance riêng biệt nơi người dùng đăng nhập trực tiếp. Không cần sao chép credentials hay vault encryption.
+<details>
+<summary><h3>How It Works (When It Works)</h3></summary>
 
-```mermaid
-flowchart TD
-    subgraph "Người Dùng Input"
-        USER["User chạy: ccs &lt;profile&gt; [args...]"]
-    end
+<br>
 
-    subgraph "Engine Phát Hiện Profile"
-        DETECT[ProfileDetector]
-        PROFILE_CHECK{Profile tồn tại?}
+1. CCS spawns embedded HTTP proxy on localhost (if not crashing)
+2. Proxy attempts to convert Anthropic format → OpenAI format (often fails)
+3. Tries to transform Anthropic tools → OpenAI function calling format (buggy)
+4. Forwards to Z.AI with reasoning parameters and tools (when not timing out)
+5. Attempts to convert `reasoning_content` → thinking blocks (partial or broken)
+6. Attempts to convert OpenAI `tool_calls` → Anthropic `tool_use` blocks (XML garbage common)
+7. Thinking and tool calls sometimes appear in Claude Code UI (when not broken)
 
-        subgraph "Loại Profile"
-            SETTINGS["Settings-based<br/>glm, kimi, default"]
-            ACCOUNT["Account-based<br/>work, personal, team"]
-        end
-    end
+</details>
 
-    subgraph "Xử Lý Core CCS"
-        CONFIG["Đọc config.json<br/>và profiles.json"]
+<details>
+<summary><h3>Control Tags & Keywords</h3></summary>
 
-        subgraph "Profile Handlers"
-            SETTINGS_MGR["SettingsManager<br/>→ --settings flag"]
-            INSTANCE_MGR["InstanceManager<br/>→ CLAUDE_CONFIG_DIR"]
-        end
-    end
+<br>
 
-    subgraph "Thực Thi Claude CLI"
-        CLAUDE_DETECT["Claude CLI Detection<br/>Hỗ trợ CCS_CLAUDE_PATH"]
+**Control Tags**:
+- `<Thinking:On|Off>` - Enable/disable reasoning blocks (default: On)
+- `<Effort:Low|Medium|High>` - Control reasoning depth (deprecated - Z.AI only supports binary thinking)
 
-        subgraph "Phương Thức Thực Thi"
-            SETTINGS_EXEC["claude --settings &lt;path&gt;"]
-            INSTANCE_EXEC["CLAUDE_CONFIG_DIR=&lt;instance&gt; claude"]
-        end
-    end
+**Thinking Keywords** (inconsistent activation):
+- `think` - Sometimes enables reasoning (low effort)
+- `think hard` - Sometimes enables reasoning (medium effort)
+- `think harder` - Sometimes enables reasoning (high effort)
+- `ultrathink` - Attempts maximum reasoning depth (often breaks)
 
-    subgraph "API Layer"
-        API["API Response<br/>Claude Sonnet 4.5<br/>GLM 4.6<br/>Kimi K2 Thinking"]
-    end
+</details>
 
-    %% Flow connections
-    USER --> DETECT
-    DETECT --> PROFILE_CHECK
-    PROFILE_CHECK -->|Có| SETTINGS
-    PROFILE_CHECK -->|Có| ACCOUNT
+<details>
+<summary><h3>Environment Variables</h3></summary>
 
-    SETTINGS --> CONFIG
-    ACCOUNT --> CONFIG
+<br>
 
-    CONFIG --> SETTINGS_MGR
-    CONFIG --> INSTANCE_MGR
+**GLMT features** (all experimental):
+- Forced English output enforcement (sometimes works)
+- Random thinking mode activation (unpredictable)
+- Attempted streaming with frequent fallback to buffered mode
 
-    SETTINGS_MGR --> SETTINGS_EXEC
-    INSTANCE_MGR --> INSTANCE_EXEC
+**General**:
+- `CCS_DEBUG_LOG=1` - Enable debug file logging
+- `CCS_CLAUDE_PATH=/path/to/claude` - Custom Claude CLI path
 
-    SETTINGS_EXEC --> CLAUDE_DETECT
-    INSTANCE_EXEC --> CLAUDE_DETECT
+</details>
 
-    CLAUDE_DETECT --> API
+<details>
+<summary><h3>API Key Setup</h3></summary>
+
+<br>
+
+```bash
+# Edit GLMT settings
+nano ~/.ccs/glmt.settings.json
 ```
 
----
+Set Z.AI API key (requires coding plan):
 
-## ⚡ Tính Năng
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-z-ai-api-key"
+  }
+}
+```
 
-- **Chuyển Đổi Ngay Lập Tức** - `ccs glm` chuyển sang GLM, không cần sửa config
-- **Phiên Đồng Thời** - Chạy nhiều profile cùng lúc ở các terminal khác nhau
-- **Instance Riêng Biệt** - Mỗi profile có config riêng (`~/.ccs/instances/<profile>/`)
-- **Đa Nền Tảng** - macOS, Linux, Windows - hoạt động giống nhau
-- **Không Downtime** - Chuyển đổi ngay lập tức, không gián đoạn workflow
+</details>
 
+<details>
+<summary><h3>Security Limits (DoS Protection)</h3></summary>
 
----
+<br>
 
-## 💻 Ví Dụ Sử Dụng
+**v3.4 Protection Limits**:
 
+| Limit | Value | Purpose |
+|:------|:------|:--------|
+| **SSE buffer** | 1MB max per event | Prevent buffer overflow |
+| **Content buffer** | 10MB max per block | Limit thinking/text blocks |
+| **Content blocks** | 100 max per message | Prevent DoS attacks |
+| **Request timeout** | 120s | Both streaming and buffered |
+
+</details>
+
+<details>
+<summary><h3>Debugging</h3></summary>
+
+<br>
+
+**Enable verbose logging**:
 ```bash
-ccs              # Dùng Claude subscription (mặc định)
-ccs glm          # Dùng GLM fallback
-ccs --version    # Hiển thị phiên bản CCS và vị trí cài đặt
+ccs glmt --verbose "your prompt"
 ```
 
-### Phiên Đồng Thời (Multi-Account)
+**Enable debug file logging**:
 ```bash
-# Tạo nhiều tài khoản Claude
-ccs auth create cong-ty    # Tài khoản công ty
-ccs auth create ca-nhan    # Tài khoản cá nhân
-ccs auth create team       # Tài khoản team
+export CCS_DEBUG_LOG=1
+ccs glmt --verbose "your prompt"
+# Logs: ~/.ccs/logs/
+```
 
-# Terminal 1 - Tài khoản công ty
-ccs cong-ty "implement feature"
+**GLMT debugging**:
+```bash
+# Verbose logging shows streaming status and reasoning details
+ccs glmt --verbose "test"
+```
 
-# Terminal 2 - Tài khoản cá nhân (chạy đồng thời)
-ccs ca-nhan "review code"
+**Check reasoning content**:
+```bash
+cat ~/.ccs/logs/*response-openai.json | jq '.choices[0].message.reasoning_content'
 ```
 
----
+**Troubleshooting**:
+- **If absent**: Z.AI API issue (verify key, account status)
+- **If present**: Transformation issue (check `response-anthropic.json`)
+
+</details>
 
-### 🗑️ Gỡ Cài Đặt
+<br>
+
+## Uninstall
+
+<details>
+<summary><h3>Package Managers</h3></summary>
+
+<br>
 
-**Package Managers**
 ```bash
 # npm
 npm uninstall -g @kaitranntt/ccs
@@ -268,55 +587,63 @@ pnpm remove -g @kaitranntt/ccs
 bun remove -g @kaitranntt/ccs
 ```
 
-**Uninstaller Chính Thức**
+</details>
+
+<details>
+<summary><h3>Official Uninstaller</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>
 
-## 🎯 Triết Lý
+<br>
 
-- **YAGNI**: Không có tính năng "phòng hờ"
-- **KISS**: Bash đơn giản, không phức tạp
-- **DRY**: Một nguồn chân lý duy nhất (config)
+## 🎯 Philosophy
 
----
+- **YAGNI**: No features "just in case"
+- **KISS**: Simple bash, no complexity
+- **DRY**: One source of truth (config)
 
-## 📖 Tài Liệu
+## 📖 Documentation
 
-**Tài liệu đầy đủ trong [docs/](./docs/)**:
-- [Hướng dẫn Cài đặt](./docs/installation.md)
-- [Cấu hình](./docs/configuration.md)
-- [Ví dụ Sử dụng](./docs/usage.md)
-- [Khắc phục Sự cố](./docs/troubleshooting.md)
-- [Đóng góp](./CONTRIBUTING.md)
+**Complete documentation in [docs/](./docs/)**:
+- [Installation Guide](./docs/en/installation.md)
+- [Configuration](./docs/en/configuration.md)
+- [Usage Examples](./docs/en/usage.md)
+- [System Architecture](./docs/system-architecture.md)
+- [GLMT Control Mechanisms](./docs/glmt-controls.md)
+- [Troubleshooting](./docs/en/troubleshooting.md)
+- [Contributing](./CONTRIBUTING.md)
 
----
+## 🤝 Contributing
 
-## 🤝 Đóng Góp
+We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
 
-Chúng tôi chào mừng đóng góp! Vui lòng xem [Hướng dẫn Đóng góp](./CONTRIBUTING.md) để biết chi tiết.
+## Star History
 
----
+<div align="center">
 
-## 📄 Giấy Phép
+<img src="https://api.star-history.com/svg?repos=kaitranntt/ccs&type=timeline&logscale&legend=top-left" alt="Star History Chart" width="800">
 
-CCS được cấp phép theo [Giấy phép MIT](LICENSE).
+</div>
 
----
+
+## License
+
+CCS is licensed under the [MIT License](LICENSE).
 
 <div align="center">
 
-**Được tạo với ❤️ cho những lập trình viên hay hết rate limit**
+**Made with ❤️ for developers who hit rate limits too often**
 
-[⭐ Star repo này](https://github.com/kaitranntt/ccs) | [🐛 Báo cáo vấn đề](https://github.com/kaitranntt/ccs/issues) | [📖 Đọc tài liệu](./docs/)
+[⭐ Star this repo](https://github.com/kaitranntt/ccs) | [🐛 Report issues](https://github.com/kaitranntt/ccs/issues) | [📖 Read docs](./docs/en/)
 
-</div>
+</div>