@claudecodelaunch/ccl 1.1.0 → 1.2.0

package/README.md

@@ -2,224 +2,267 @@
 
 `ccl` 是一个专门为 Anthropic 官方 CLI 工具 **Claude Code** 开发的多模型网关代理与极速启动器。
 
-它可以帮助你在运行 Claude Code 时，无缝对接 OpenAI 兼容格式的网关（如官方 DeepSeek、SiliconFlow、OpenRouter、OneAPI 等），实现超低成本运行。
+它可以帮助你在运行 Claude Code 时，无缝对接 OpenAI 兼容格式的网关（如 DeepSeek、SiliconFlow、OpenRouter、OneAPI 等），实现超低成本运行。
 
 ## ✨ 核心亮点
 
 1. **智能多档模型映射 (无需复杂配置)**
-   - 当 `config.yaml` 里的 `model` 字段留空时，`ccl` 将进入 **「智能协议代理映射模式」**。
-   - 自动在启动时拉取接口提供商的可用模型库。
-   - 动态分析 Claude Code 的模型档位（Opus / Sonnet / Haiku），匹配最佳替代：
-     - 💎 **Opus 强推理档** (Claude Opus, Claude 4.8 / 4.7 等) $\Rightarrow$ 优先匹配 `deepseek-reasoner` (R1) 或 `o1`、`o3-mini`、`gpt-4o`。
-     - 🚀 **Sonnet 黄金档** (Claude 3.5 Sonnet 等) $\Rightarrow$ 优先匹配 `deepseek-chat` (V3)、`gpt-4o`、`claude-3-5-sonnet`。
-     - ⚡ **Haiku 极速档** (Claude 3.5 Haiku 等) $\Rightarrow$ 优先匹配 `gpt-4o-mini`、`gpt-3.5-turbo`。
+   - 当槽位未手动配置时，`ccl` 自动进入 **「智能协议代理映射模式」**。
+   - 自动在启动时拉取接口提供商的可用模型库，按关键词动态分析并分配到各档位：
+     - 💎 **Opus 强推理档** → 优先匹配 `deepseek-reasoner` (R1) 或 `o1`、`o3-mini`、`gpt-4o`
+     - 🚀 **Sonnet 黄金档** → 优先匹配 `deepseek-chat` (V3)、`gpt-4o`、`claude-3-5-sonnet`
+     - ⚡ **Haiku 极速档** → 优先匹配 `gpt-4o-mini`、`gpt-3.5-turbo`
+   - 若通过 `ccl set` / `ccl conf set` 手动为某个档位指定了模型，则该档位的自动映射被覆盖，其余未配置的档位仍走自动映射。
 
 2. **零感协议翻译与流式代理**
    - 采用本地轻量级的高性能并发 socket 服务（TCP），自动拦截并完美将 Anthropic 专有的 `Messages` 协议以及 `Streaming (SSE)` 转换为标准的 `OpenAI / Chat Completions` 协议。
-   - 完美适配 Claude Code CLI 所有的 Tools（工具调用）和 System Prompt，使用体验 100% 丝滑。
 
-3. **智能环境探针与诊断 (`ccl doctor`)**
+3. **交互式 TUI 配置向导**
+   - 全新的 bubbletea 驱动的全屏 TUI：多页表单，键盘导航（方向键 / Tab / Enter / Esc），实时协议探测与模型拉取。
+   - 支持 6 档 Reasoning Effort（`low` ~ `ultracode`）、每个槽位独立配置模型、一键启用 1M 上下文。
+   - **多语言支持**：中文 / English，运行时通过 `ccl lang` 随时切换。
+
+4. **智能环境探针与诊断 (`ccl doctor`)**
    - 自动检查本地环境依赖（Node.js, Claude CLI）。
-   - 如果系统未安装 Claude CLI，`ccl` 将触发**全自动静默安装**，无需你手动运行 `npm install -g`。
+   - 如果系统未安装 Claude CLI，`ccl` 将触发**全自动静默安装**。
    - 提供连接探针，对各 Provider 的 Endpoint 连通性、API 鉴权密钥进行安全测试。
 
-4. **多通道配置与灵活切换**
-   - 支持添加、切换、列出、删除以及管理多个独立网关。
-   - 极简 CLI 交互界面，支持漂亮的终端可视化菜单。
+5. **多通道配置与灵活切换**
+   - 支持添加、切换、列出、复制、重命名、删除以及管理多个独立网关。
+   - 配置统一存储在 `~/.ccl/config.yaml`，方便备份与迁移。
 
 ---
 
 ## 🚀 安装与编译
 
 ### 快速安装
-```
-    npm install -g @claudecodelaunch/ccl
+```bash
+npm install -g @claudecodelaunch/ccl
 ```
 
-### 方法一：直接下载预编译二进制
-我们利用 GitHub Actions 实现了完美的 CI/CD 流程，所有发布版本均包含多平台的开箱即用二进制。
+### 预编译二进制
+前往 [GitHub Releases](https://github.com/claude-code-launch/ccl/releases) 下载适合您平台的压缩包：
 
-请前往 [GitHub Releases](https://github.com/claude-code-launch/ccl/releases) 页面，下载适合您平台的压缩包：
-- **Apple macOS**: `ccl-darwin-amd64` (Intel) / `ccl-darwin-arm64` (Apple Silicon M1/M2/M3)
-- **Linux**: `ccl-linux-amd64` / `ccl-linux-arm64`
-- **Windows**: `ccl-windows-amd64.exe`
+| 平台 | 文件名 |
+|------|--------|
+| macOS Intel | `ccl-darwin-amd64` |
+| macOS Apple Silicon | `ccl-darwin-arm64` |
+| Linux amd64 | `ccl-linux-amd64` |
+| Linux arm64 | `ccl-linux-arm64` |
+| Windows x64 | `ccl-win32-x64.exe` |
+| Windows arm64 | `ccl-win32-arm64.exe` |
 
-下载后将其移动到您的系统 `PATH` 目录（例如 macOS/Linux 下的 `/usr/local/bin`），并赋予执行权限：
 ```bash
 chmod +x ccl-darwin-arm64
 mv ccl-darwin-arm64 /usr/local/bin/ccl
 ```
 
-### 方法二：本地源码编译
-如果您希望从源码编译，确保您本地已经安装了 Go (推荐 1.22+)。
-
+### 源码编译
 ```bash
-# 克隆仓库
 git clone https://github.com/claude-code-launch/ccl.git
-cd claude-code-launch
-
-# 编译生成 ccl 执行文件
-go build -o ccl main.go
+cd ccl
+go build -o ccl .
 ```
-### 方法三：Go 安装
-确保您本地已经安装了 Go（推荐 1.22+）。
 
-```
+### Go 安装
+```bash
 go install github.com/claude-code-launch/ccl@latest
 ```
-⚠️ 注意：安装完成后，您需要将 GOBIN 目录添加到系统的 PATH 环境变量中，否则可能无法在终端直接运行 ccl 命令。
 
-如何配置 PATH 环境变量？
-根据您的操作系统，选择对应的配置方式：
+---
 
-macOS / Linux (Bash/Zsh)
-打开终端并运行以下命令（根据你使用的 shell，修改 ~/.zshrc 或 ~/.bashrc）：
+## 🛠️ 命令参考
 
-```
-export GOPATH=$(go env GOPATH)
-export PATH=$PATH:$GOPATH/bin
-source ~/.zshrc # 如果使用的是 bash，请改为 source ~/.bashrc
+### `ccl set` / `ccl conf set` — 添加/更新 Provider
+
+```bash
+# 交互式选择已有 provider 或新建
+ccl set
+
+# 直接指定名称新建或更新
+ccl set my-provider
+ccl conf set my-provider
 ```
 
-Windows (PowerShell)
-在 PowerShell 中运行以下命令（仅对当前用户永久生效）：
+无参数时弹出 **Provider 选择框**（↑↓ 选择，Enter 确认）：
 
-```PowerShell
-[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$(go env GOPATH)\bin", "User")
 ```
-注：重启终端后生效。
+┌─ Select a provider or create new: ─────────────────┐
+│                                                     │
+│  ▸ + Create new provider                            │
+│    deepseek                                         │
+│    oc1 (active)                                     │
+│    zhipu                                            │
+│                                                     │
+│  ↑↓ choose · enter confirm · esc cancel             │
+└─────────────────────────────────────────────────────┘
+```
+
+选择后进入**全屏 TUI 配置向导**，分 5 页完成：
+
+| 页面 | 内容 | 操作 |
+|------|------|------|
+| Page 0 | **凭据配置** — Endpoint URL + API Key | ↑↓ 切换输入框 · Enter 下一步 |
+| Page 1 | **Slot 映射** — Opus / Sonnet / Haiku / Custom 模型选择 | ↑↓ 选槽位 · Enter 进入模型列表 · 打字过滤 · Enter 锁定 |
+| Page 2 | **1M 上下文** — 每槽位独立开关 | Space 切换 · Enter 下一步 |
+| Page 3 | **Reasoning Effort** — low ~ ultracode 6 档 | ↑↓ 选择 · Enter 确认 |
+| Page 4 | **核对保存** — 确认配置并设为激活 | ←→ 切换是/否 · Enter 保存 |
 
-## 🛠️ 自动化发布指南 (CI/CD)
+页面间通过 `Tab` / `Shift+Tab` 或底部按钮 `[Next]` / `[Back]` 导航。
 
-项目配置了 GitHub Actions 自动化工作流。当需要发布新版本时，无需手动编译多平台包，只需直接在本地推送标签即可：
+### `ccl conf` — Provider 配置管理
 
 ```bash
-# 1. 创建符合 v* 规范的版本 tag
-git tag v1.0.1
+# 列出所有 provider
+ccl conf ls
+ccl conf ls -a        # 显示全部模型（默认只显示前 3 个）
 
-# 2. 推送到 GitHub
-git push origin v1.0.1
-```
-GitHub Actions 会自动触发并执行以下操作：
-- 拉取代码，配置 Go 1.24 运行环境。
-- 使用 `-ldflags="-s -w"` 深度压缩二进制体积（剔除符号调试表，缩减 35%+）。
-- 跨平台交叉编译 macOS、Linux、Windows 5 大核心架构的目标文件。
-- 自动提取标签之间的 Commit 历史生成发布日志并发布。
+# 复制配置
+ccl conf cp source target
 
----
+# 重命名
+ccl conf mv old-name new-name
 
-## 🛠️ 快速上手
+# 删除
+ccl conf rm name
+```
 
-### 极速免配置模式 (推荐 🚀)
-如果你已经在终端的环境变量中配置了 `OPENAI_API_KEY` 和 `OPENAI_BASE_URL`，`ccl` 将会自动识别并直接以此作为服务源，**完全零配置运行**！
+### `ccl env` — 环境变量管理
 
 ```bash
-# 1. 注入你的环境变量（例如使用 DeepSeek 官方）
-export OPENAI_API_KEY="sk-your-deepseek-api-key"
-export OPENAI_BASE_URL="https://api.deepseek.com" # 选填，默认指向官方 OpenAI
-
-# 2. 直接一行启动
-ccl
-```
-> 💡 在此模式下，依旧享受超强的 **「智能模型映射」**：常规对话走 `deepseek-chat`，深度推理全自动路由至 `deepseek-reasoner`！
+# 列出所有环境变量
+ccl env ls
 
----
+# 设置/修改
+ccl env KEY VALUE
 
-### 交互配置模式
-如果你需要管理多个网关通道，可以使用 `ccl` 的配置管理系统：
+# 重命名
+ccl env mv OLD_KEY NEW_KEY
 
-#### 1. 添加你的 AI 接口服务商 (Provider)
+# 删除
+ccl env rm KEY
+```
 
-运行 `ccl add` 命令，开始添加。如果你使用的是 DeepSeek 官方，可以配置如下：
+### `ccl use` — 切换激活 Provider
 
 ```bash
-./ccl add
+ccl use provider-name
 ```
 
-交互引导中填入信息：
-* **Provider Name**: `deepseek` (名字可自定义)
-* **Provider Type**: 选择 `openai` (哪怕是 DeepSeek、OpenRouter 均选此项以启用本地协议代理)
-* **API Key**: 填入你的 DeepSeek API Key (形如 `sk-...`)
-* **Endpoint**: 填入 `https://api.deepseek.com` 或中转服务地址（不带 `/v1/chat/completions` 后缀）
-* **Model**: **[推荐留空]** 直接按回车跳过。这样代理层将为你开启全自动的「智能模型映射」，在发送普通对话时跑 `deepseek-chat` (V3)，在调用深度推理时完美、低延迟地跑 `deepseek-reasoner` (R1)。
+### `ccl lang` — 切换显示语言
+
+```bash
+# 交互式选择
+ccl lang
 
-### 2. 查看与切换 Provider
+# 直接指定
+ccl lang zh       # 中文
+ccl lang en       # English
+```
 
-你可以管理和随时切换当前处于 Active 激活状态的服务商：
+设置后立即生效并持久化到 `~/.ccl/config.yaml`。优先级：`CCL_LANG` 环境变量 > config.yaml > 系统语言。
 
-```bash
-# 查看所有已添加的服务商 (带有 * 的为当前激活)
-./ccl list
+### `ccl doctor` — 环境诊断
 
-# 切换到指定的 provider
-./ccl use deepseek
+```bash
+ccl doctor
 ```
 
-### 3. 环境诊断
+检查本地依赖、Endpoint 连通性、API 鉴权。如果 Claude CLI 未安装，自动触发一键安装。
 
-在正式跑 Claude 之前，可以测试网关的健康度和密钥是否有效：
+### `ccl list` — 查看所有 Provider
 
 ```bash
-./ccl doctor
+ccl list
+# 或
+ccl conf ls
 ```
 
-如果检测到本地没有全局安装 `@anthropic-ai/claude-code`，它会提示并尝试为你一键静默安装。
+### `ccl update` — 升级
 
-### 4. 开启 Claude Code 奇妙旅程
+```bash
+ccl update
+```
+
+支持通过 `npm` / `go install` 一键升级。
 
-直接输入 `ccl`，即可丝滑进入 Claude Code CLI 原生界面：
+### `ccl` — 启动 Claude Code
 
 ```bash
-# 启动 Claude Code 交互，所有请求均自动经本地 ccl 代理安全转换
-./ccl
+# 直接启动
+ccl
 
-# 支持将后续的所有参数直接透传给 Claude Code：
-./ccl resume
-./ccl --dangerously-skip-permissions
+# 透传参数
+ccl resume
+ccl --dangerously-skip-permissions
+ccl claude --dangerously-skip-permissions
+```
 
-# 也可以显式使用 claude 命令来透传后面的所有参数：
-./ccl claude resume
-./ccl claude --dangerously-skip-permissions
+---
 
-# 你也可以像原来一样跟上其他的子命令或路径：
-./ccl --help
-./ccl /compact
+## ⚙️ 配置存储
+
+所有配置统一存储在 `~/.ccl/config.yaml`：
+
+```yaml
+active_provider: deepseek
+lang: zh-CN
+providers:
+  deepseek:
+    name: deepseek
+    type: openai
+    endpoint: https://api.deepseek.com
+    apikey: sk-xxx
+    model: deepseek-chat,deepseek-reasoner
+    opusModel: deepseek-reasoner
+    sonnetModel: deepseek-chat
+    effortLevel: max
 ```
 
-### 5. 一键自我升级
+---
+
+## 🔧 CI/CD
 
-`ccl` 提供了非常便捷的在线检测及升级命令：
+推送符合 `v*` 规范的 tag 触发自动编译发布：
 
 ```bash
-ccl update
+git tag v1.2.0
+git push origin v1.2.0
 ```
 
-运行后，`ccl` 会：
-- 自动查询 npm 镜像源上的最新版本。
-- 比对当前版本，若有新版本，将提示您选择升级方式（支持通过 `npm` 或 `go install` 一键自动下载并完成覆盖更新）。
+GitHub Actions 自动构建 6 个平台二进制并发布到 GitHub Releases + npm。
 
 ---
 
 ## 📁 目录结构
 
 ```text
-├── cmd/                # CLI 命令定义 (Cobra)
-│   ├── add.go          # 添加/更新提供商 (交互式)
-│   ├── delete.go       # 删除提供商
-│   ├── doctor.go       # 环境及密钥连通性自检
-│   ├── list.go         # 列表展示提供商
-│   ├── root.go         # ccl 主入口及 Claude 进程拉起
-│   ├── update.go       # 自动检查并更新 ccl 版本
-│   └── use.go          # 快速切换激活提供商
+├── cmd/
+│   ├── advanced_config.go     # TUI 配置向导（5 页表单 + 协议探测）
+│   ├── conf.go                # Provider 配置管理（cp/ls/mv/rm/set）
+│   ├── env.go                 # 环境变量管理（ls/rm/mv）
+│   ├── set.go                 # set 命令入口 + RunConfSet 共享逻辑
+│   ├── select.go              # 通用 TUI 选择器组件
+│   ├── doctor.go              # 环境及密钥连通性自检
+│   ├── install.go             # Claude CLI 自动安装
+│   ├── lang_cmd.go            # ccl lang 命令
+│   ├── list.go                # list 命令
+│   ├── models.go              # 模型列表展示
+│   ├── root.go                # ccl 主入口 + passthrough 模式
+│   ├── settings.go            # 预览 settings.json
+│   ├── update.go              # 自动升级
+│   ├── use.go                 # 切换激活 provider
+│   └── version.go             # 版本信息
 ├── internal/
-│   ├── claude/         # Claude Code CLI 自动安装、进程拉起及端口注入逻辑
-│   ├── config/         # 极简 yaml 配置文件加解密与载入
-│   ├── protocol/       # Anthropic <=> OpenAI 核心协议数据结构转换与 Stream 事件转换
-│   ├── provider/       # 提供商实体定义
-│   └── proxy/          # 本地自愈并发 TCP 代理服务、模型自动感知与映射
-└── main.go             # 引导文件
+│   ├── claude/                # Claude Code 进程拉起 & 端口注入
+│   ├── config/                # yaml 配置文件读写
+│   ├── locale/                # 多语言支持（中文 / English）
+│   ├── protocol/              # Anthropic ↔ OpenAI 协议转换
+│   ├── provider/              # Provider & Config 数据结构
+│   └── proxy/                 # 本地 TCP 代理服务
+└── main.go
 ```
 
 ## 📄 开源许可
 
-本项目采用 MIT 协议开源。
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudecodelaunch/ccl",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Launcher and proxy wrapper for Claude Code CLI",
   "repository": {
     "type": "git",