runcc 0.1.2 → 0.1.4

package/.claude/skills/publish/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: publish
+description: 自动化 npm 包发布准备工作流。预检查 → 询问版本 → npm version → 测试 → 构建 → CHANGELOG → 提交 → 推送 → 打印发布命令（用户手动执行 npm publish）。触发词：发布新版本/publish to npm/bump version/release。
+---
+
+# NPM 发布工作流
+
+预检查 → 提交未保存更改 → 询问版本 → npm version → 测试 → 构建 → CHANGELOG → 提交 → 推送 → 打印发布命令
+
+## 工作流程
+
+### 0. 预检查（重要！）
+
+在开始任何操作前，**必须先检查 git 状态**：
+
+```bash
+# 检查当前分支
+git branch --show-current
+
+# 检查工作区状态
+git status --short
+```
+
+**如果工作区干净**：直接进入步骤 1。
+
+**如果有未提交更改**：使用 `AskUserQuestion` 询问用户：
+- 先提交更改（**必须使用 `/commit-commands:commit` skill**）
+- 丢弃更改（`git restore .`）
+- 中止流程
+
+**关键原因**：`npm version` 命令要求工作目录必须是干净状态，否则会报错退出。
+
+### 1. 询问目标版本
+
+使用 `AskUserQuestion` 询问用户要升级到什么版本：
+
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| patch | 错误修复、小改动 | 1.0.0 → 1.0.1 |
+| minor | 新功能、向后兼容 | 1.0.0 → 1.1.0 |
+| major | 破坏性更改 | 1.0.0 → 2.0.0 |
+| custom | 指定确切版本号 | 1.0.0 → 1.2.3 |
+
+### 2. 修改 npm 版本
+
+```bash
+npm version <patch|minor|major|x.y.z>
+```
+
+此命令会：
+- 更新 package.json 和 package-lock.json 版本号
+- 创建 git 提交（消息格式：`v<x.y.z>`）
+- 创建 git 标签（`v<x.y.z>`）
+
+### 3. 运行测试
+
+```bash
+bun run test
+```
+
+- 如果 package.json 有 test 脚本，执行测试
+- 测试失败则中止流程，提示用户修复
+- 无 test 脚本则跳过
+
+### 4. 打包编译
+
+```bash
+bun run build
+```
+
+- 如果 package.json 有 build 脚本，执行构建
+- 构建失败则中止流程，提示用户修复
+- 无 build 脚本则跳过
+
+### 5. 创建 CHANGELOG
+
+#### 存在 CHANGELOG.md 时
+
+```bash
+# 查看自上次发布的提交
+git log $(git tag -l | tail -n 1)..HEAD --oneline
+```
+
+**生成条目**：
+- 格式：`## [<版本号>] - YYYY-MM-DD`
+- 按类型分组：新功能、错误修复、破坏性更改
+
+**审核流程**：
+1. 显示生成的变更日志
+2. 使用 `AskUserQuestion` 确认或修改
+3. 更新 CHANGELOG.md
+
+#### 不存在 CHANGELOG.md 时
+
+询问用户是否创建。
+
+### 6. 提交 git
+
+```bash
+git add CHANGELOG.md
+git commit -m "docs: update CHANGELOG for <版本号>"
+```
+
+### 7. 询问是否 git push
+
+使用 `AskUserQuestion` 询问是否推送：
+
+```
+是否推送到远程仓库？
+```
+
+用户确认后执行：
+```bash
+git push && git push --tags
+```
+
+### 8. 打印 npm publish 命令
+
+显示发布命令，要求用户复制手动执行：
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📦 准备发布: <package-name>@<new-version>
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+请复制以下命令并执行：
+
+npm publish
+
+（如需公共作用域包，使用: npm publish --access public）
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### 发布摘要
+
+```
+✅ 准备工作完成
+
+- 包名: <package-name>
+- 新版本: <new-version>
+- Git 标签: v<new-version>
+- CHANGELOG: 已更新
+
+请执行上方 npm publish 命令完成发布。
+```
+
+## 最佳实践
+
+- 发布前运行测试
+- 保持 CHANGELOG.md 最新
+- 遵循语义化版本规范
+- 确认前审查更改
+- 始终先提交再发布
+- 为发布打标签
+- 清楚标注破坏性更改

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.4] - 2026-01-19
+
+### Added
+- Support `runcc -- <args>` syntax for directly launching official Claude mode with argument passthrough
+- This provides a more concise way to launch official Claude when no provider is needed
+
+### Changed
+- Updated usage examples in error messages to include the new `runcc -- <args>` syntax
+- Enhanced publish skill with better pre-check workflow documentation
+- Reorganized CLAUDE.md with clearer structure
+
+## [0.1.3] - 2026-01-19
+
+### Changed
+- Renamed `npm-publish` skill to `publish` for consistency
+- Removed deprecated `PLAN.md` file
+- Updated project documentation and test files
+
 ## [0.1.2] - 2026-01-19
 
 ### Changed
@@ -23,5 +41,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for official Claude API and third-party providers (GLM, DeepSeek, Minimax)
 - Custom endpoint management (add/remove)
 - Proxy configuration support
-- Configuration persistence in `~/.cc-run/config.json`
+- Configuration persistence in `~/.runcc/config.json`
 - Integration with Claude CLI settings (`~/.claude/settings.json`)

package/CLAUDE.md

@@ -4,146 +4,162 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## 项目概述
 
-**cc-run** 是一个 Claude CLI 启动器，使用 TypeScript + Bun 开发。核心功能是在官方 API 和多个第三方 API endpoints 之间快速切换。这是一个单文件可执行 CLI 工具，可作为全局命令安装。
+**runcc** 是一个 TypeScript CLI 工具，用于在 Claude Code 中切换不同的 API 端点。它允许用户使用第三方 API 提供商（GLM、DeepSeek、Minimax）或自定义端点，同时保持与 Claude 原生配置的无缝集成。
 
 ## 开发命令
 
+### 运行与构建
 ```bash
-# 安装依赖
-bun install
-
-# 开发模式（直接运行 TypeScript 源码）
-bun run dev
-
-# 构建输出到 dist/index.js
-bun run build
-
-# 构建独立二进制可执行文件
-bun run build:bin
-
-# 全局安装（本地测试）
-bun install -g .
+bun run dev              # 开发模式运行
+bun run build           # 编译到 dist/
+bun run build:bin       # 编译独立二进制文件
+```
 
-# 配置验证测试工具
-bun test/dry-run.ts config
-bun test/dry-run.ts glm
+### 测试
+```bash
+bun test                # 运行所有测试
+bun test --watch        # 监视模式
+bun run test:unit       # 仅单元测试
+bun run test:integration # 仅集成测试
 ```
 
-**注意**: 项目无自动化测试框架、无 linting 配置、无 pre-commit hooks。
+### 发布
+```bash
+/publish                # 使用 publish skill 自动化发布流程
+```
 
 ## 核心架构
 
-项目采用三层架构设计：
-
-```
-┌─────────────────────────────────────────┐
-│          CLI Layer (commands)           │
-│  - 参数解析、用户交互、命令编排            │
-├─────────────────────────────────────────┤
-│        Business Logic (utils)           │
-│  - 启动器、环境变量、Claude 配置管理       │
-├─────────────────────────────────────────┤
-│         Data Layer (config)             │
-│  - 配置存储、类型定义、endpoints 管理     │
-└─────────────────────────────────────────┘
-```
+### 双配置系统
+
+1. **RunCC Config** (`~/.runcc/config.json`)
+   - 存储自定义端点、API token、代理设置
+   - 通过 `src/config/storage.ts` 管理
+   - 结构示例：
+   ```json
+   {
+     "endpoints": [...],
+     "tokens": {"glm": "sk-...", "deepseek": "sk-..."},
+     "lastUsed": "glm",
+     "proxy": {"enabled": true, "url": "http://...", "clearForOfficial": false}
+   }
+   ```
+
+2. **Claude Settings** (`~/.claude/settings.json`)
+   - Claude 原生配置文件
+   - 通过 `src/utils/claude-settings.ts` 管理
+   - 包含 proxy、apiUrl、anthropicApiKey 和 env 配置
+   - 结构示例：
+   ```json
+   {
+     "proxy": "http://...",
+     "apiUrl": "https://...",
+     "anthropicApiKey": "sk-...",
+     "env": {
+       "ANTHROPIC_BASE_URL": "...",
+       "ANTHROPIC_AUTH_TOKEN": "..."
+     }
+   }
+   ```
+
+**关键设计模式：临时修改模式** - 在官方模式下启动时，临时清除第三方配置并在 Claude 退出后恢复。
 
 ### 目录结构
 
 ```
 src/
-├── index.ts              # CLI 入口，Commander 配置，命令路由
-├── commands/             # 命令实现层
-│   ├── run.ts           # 核心启动逻辑（官方/provider/配置模式）
-│   ├── proxy.ts         # 代理管理命令
-│   ├── list.ts          # 列出 endpoints（UTF-8 处理）
-│   ├── add.ts           # 添加自定义 endpoint
-│   └── remove.ts        # 删除 endpoint
-├── config/              # 配置数据层
-│   ├── types.ts         # TypeScript 类型定义
-│   ├── endpoints.ts     # 内置 endpoints (glm/deepseek/minimax)
-│   └── storage.ts       # ~/.cc-run/config.json 读写
-└── utils/               # 工具层
-    ├── launcher.ts      # spawn Claude 进程
-    ├── env.ts           # 环境变量构建
-    └── claude-settings.ts # ~/.claude/settings.json 读写
+├── index.ts              # CLI 入口，使用 Commander.js
+├── commands/             # CLI 命令实现
+│   ├── run.ts           # 核心启动逻辑，支持官方/提供商/配置模式
+│   ├── list.ts          # 列出可用端点
+│   ├── add.ts           # 添加自定义端点
+│   ├── remove.ts        # 删除自定义端点
+│   └── proxy.ts         # 代理管理（on/off/reset/status/help）
+├── config/
+│   ├── types.ts         # TypeScript 接口定义
+│   ├── endpoints.ts     # 内置端点定义和模型映射
+│   └── storage.ts       # 配置文件 CRUD 操作
+└── utils/
+    ├── claude-settings.ts  # Claude 配置读写、备份/恢复
+    ├── launcher.ts         # 进程启动和退出码处理
+    ├── env.ts              # ANTHROPIC_* 环境变量构建
+    ├── passthrough-args.ts # -- 分隔符后的参数解析
+    └── output.ts           # UTF-8 安全输出（修复中文显示）
 ```
 
-## 双配置文件系统
+### 关键设计决策
 
-### ~/.cc-run/config.json (启动器私有配置)
+1. **UTF-8 处理**：在编译后的二进制文件中 monkey-patch `console.log/error` 确保中文字符正确显示
 
-存储自定义 endpoints、API tokens、最后使用的 endpoint、代理配置。
+2. **临时修改模式**：启动官方 Claude 时临时清除第三方配置，退出后恢复
 
-### ~/.claude/settings.json (Claude 官方配置)
+3. **环境变量策略**：使用 `ANTHROPIC_*` 环境变量而非文件修改来使用第三方 API
 
-存储 `proxy`、`apiUrl`、`anthropicApiKey`，由 Claude CLI 原生读取。
+4. **模型映射**：支持将 Claude 模型层级（haiku/opus/sonnet）映射到提供商特定模型
 
-**关键机制**: 使用 `--claude` 标志可以将第三方 endpoint 配置写入 `~/.claude/settings.json`，使原生 `claude` 命令默认使用该 endpoint。
+5. **代理灵活性**：支持每会话代理配置，可选在官方模式下清除（clearForOfficial）
 
-## 三种启动模式
+6. **参数透传**：通过 `--` 分隔符支持透传参数给 Claude CLI
 
-### 1. 官方模式 (`cc-run`)
-1. 备份当前 Claude 配置
-2. 清除第三方 endpoint 配置
-3. 根据 `clearForOfficial` 决定是否清除 proxy
-4. 启动 Claude（不设置第三方环境变量）
-5. 退出后恢复配置
+7. **交互式提示**：使用 Node.js readline 在未预配置时获取 token 和代理输入
 
-### 2. Provider 模式 (`cc-run glm`)
-1. 从内置或自定义 endpoints 查找配置
-2. 获取 token（首次提示输入并保存）
-3. 通过环境变量启动 Claude:
-   - `ANTHROPIC_BASE_URL`
-   - `ANTHROPIC_AUTH_TOKEN`
-   - `http_proxy`/`https_proxy`
+## 测试策略
 
-### 3. 配置模式 (`cc-run glm --claude`)
-1. 执行 provider 模式启动
-2. 额外写入 `~/.claude/settings.json`
-3. 使原生 `claude` 命令默认使用此 endpoint
+- **单元测试**：测试独立模块（storage、endpoints、env 等）
+- **集成测试**：测试命令工作流（run、list、add、remove、proxy）
+- **测试夹具**：`src/__tests__/fixtures/` 下的 mock 实现（mock-fs、mock-readline、mock-process）
+- **环境隔离**：使用 `CC_RUN_TEST_HOME` 环境变量
+- **手动测试**：`test/` 目录下的 dry-run、mock-claude、verify-passthrough
 
-## 内置 Endpoints
+测试文件位于 `src/__tests__/`，使用 Bun Test 框架。
 
-| 名称 | Endpoint URL |
-|------|--------------|
-| glm | https://open.bigmodel.cn/api/paas/v4/ |
-| deepseek | https://api.deepseek.com |
-| minimax | https://api.minimax.chat/v1 |
+## 发布流程
+
+项目包含自定义 **publish skill**，自动化 npm 发布：
+1. 预检查（git 状态必须干净）
+2. 版本 bump（`npm version`，创建 commit + tag）
+3. 运行测试
+4. 构建
+5. 生成/更新 CHANGELOG
+6. Git 提交
+7. Git push（需用户确认）
+8. 输出 `npm publish` 命令供手动执行
+
+## 安装测试
+
+```bash
+./test-install.sh       # 完整的安装/测试/卸载循环
+```
 
-**扩展点**: 添加内置 endpoint 需修改 `src/config/endpoints.ts`
+## 技术栈
 
-## 代码风格约定
+- **Runtime**: Bun
+- **Language**: TypeScript (strict mode, ES2022 target)
+- **CLI Framework**: Commander.js ^12.0.0
+- **Testing**: Bun Test
+- **Minimum Node**: >=18.0.0
+- **License**: Apache-2.0
 
-- **模块系统**: ES Modules（import 必须显式包含 `.js` 扩展名）
-- **类型系统**: 严格模式 TypeScript
-- **注释风格**: JSDoc 风格（中文）
-- **错误处理**: 使用 `process.exit(1)` 终止，无异常抛出
-- **文件组织**: 按功能分层，单一职责原则
-- **命名约定**:
-  - 文件名: kebab-case (`claude-settings.ts`)
-  - 函数: camelCase
-  - 类型: PascalCase
-  - 常量: UPPER_SNAKE_CASE
+## 内置 Endpoints
 
-## 关键技术实现
+| 名称 | Endpoint |
+|------|----------|
+| glm | https://open.bigmodel.cn/api/paas/v4/ |
+| deepseek | https://api.deepseek.com |
+| minimax | https://api.minimax.chat/v1 |
 
-### 环境变量隔离
-使用 `spawn` 的 `env` 选项实现环境变量隔离，避免污染全局环境。
+## Claude Code 技能
 
-### 配置原子操作
-- 官方模式使用备份-修改-恢复模式确保配置安全
-- 文件操作使用同步 API (`readFileSync`, `writeFileSync`)
-- 目录不存在时自动创建 (`mkdirSync` with `recursive: true`)
+项目在 `.claude/skills/` 中包含 Claude Code 技能：
+- **publish** - 自动化 npm 发布工作流（预检查 → 版本 bump → 测试 → 构建 → CHANGELOG → 提交 → 推送）
 
-### UTF-8 输出处理
-`list.ts` 使用 `TextEncoder` 确保中文正确显示（标准 console.log 在某些环境下可能乱码）
+这体现了项目的 dogfooding 方法——使用 Claude Code 工具管理自己的开发工作流。
 
-### 交互式输入
-使用 Node.js 原生 `readline` 模块实现 token 和代理地址输入
+## 发布到 npm 的文件
 
-## 依赖外部条件
+- `dist/` - 编译后的 JavaScript
+- `package.json` - 包元数据
+- `README.md` - 用户文档
+- `CHANGELOG.md` - 版本历史
 
-1. **Claude CLI**: 系统必须已安装 `claude` 命令
-2. **配置目录**: 自动创建 `~/.cc-run/` 和 `~/.claude/`
-3. **Node 版本**: >= 18.0.0
+**排除**：`src/`、`test/`、`*.test.ts`、`tsconfig.json`、`runcc` 二进制文件

package/README.md

@@ -1,4 +1,4 @@
-# cc-run
+# runcc
 
 Claude CLI 启动器，支持切换不同的 API endpoint。
 
@@ -24,19 +24,19 @@ npm install -g .
 
 ```bash
 # 查看所有可用的 endpoints
-cc-run list
+runcc list
 
 # 使用第三方 endpoint
-cc-run glm
+runcc glm
 
 # 配置原生 claude 命令使用 glm
-cc-run glm --claude
+runcc glm --claude
 
 # 恢复原生 claude 使用官方 endpoint
-cc-run --claude
+runcc --claude
 
 # 启动官方 claude
-cc-run
+runcc
 ```
 
 ## 命令说明
@@ -45,29 +45,29 @@ cc-run
 
 | 命令 | 说明 |
 |------|------|
-| `cc-run` | 启动官方 claude |
-| `cc-run glm` | 使用 glm endpoint |
-| `cc-run deepseek` | 使用 deepseek endpoint |
-| `cc-run minimax` | 使用 minimax endpoint |
-| `cc-run list` | 列出所有 endpoints |
-| `cc-run add <name> <endpoint> [token]` | 添加自定义 endpoint |
-| `cc-run remove <name>` | 删除自定义 endpoint |
+| `runcc` | 启动官方 claude |
+| `runcc glm` | 使用 glm endpoint |
+| `runcc deepseek` | 使用 deepseek endpoint |
+| `runcc minimax` | 使用 minimax endpoint |
+| `runcc list` | 列出所有 endpoints |
+| `runcc add <name> <endpoint> [token]` | 添加自定义 endpoint |
+| `runcc remove <name>` | 删除自定义 endpoint |
 
 ### 原生命令配置
 
 | 命令 | 说明 |
 |------|------|
-| `cc-run <provider> --claude` | 配置原生 `claude` 命令使用第三方 endpoint |
-| `cc-run --claude` | 恢复原生 `claude` 命令使用官方 endpoint |
+| `runcc <provider> --claude` | 配置原生 `claude` 命令使用第三方 endpoint |
+| `runcc --claude` | 恢复原生 `claude` 命令使用官方 endpoint |
 
 ### 代理管理
 
 | 命令 | 说明 |
 |------|------|
-| `cc-run proxy on` | 开启代理 |
-| `cc-run proxy off` | 关闭代理 |
-| `cc-run proxy status` | 查看代理状态 |
-| `cc-run proxy reset` | 重置代理配置 |
+| `runcc proxy on` | 开启代理 |
+| `runcc proxy off` | 关闭代理 |
+| `runcc proxy status` | 查看代理状态 |
+| `runcc proxy reset` | 重置代理配置 |
 
 ## 内置 Endpoints
 
@@ -79,7 +79,7 @@ cc-run
 
 ## 配置文件
 
-### ~/.cc-run/config.json
+### ~/.runcc/config.json
 
 ```json
 {
@@ -117,46 +117,46 @@ cc-run
 ### 添加自定义 endpoint
 
 ```bash
-cc-run add my-api https://api.my-service.com/v1 sk-my-token
+runcc add my-api https://api.my-service.com/v1 sk-my-token
 ```
 
 ### 切换 endpoint
 
 ```bash
 # 使用 glm
-cc-run glm
+runcc glm
 
 # 使用 deepseek
-cc-run deepseek
+runcc deepseek
 
 # 使用自定义 endpoint
-cc-run my-api
+runcc my-api
 ```
 
 ### 配置代理
 
 ```bash
 # 开启代理（首次会提示输入代理地址）
-cc-run proxy on
+runcc proxy on
 
 # 查看代理状态
-cc-run proxy status
+runcc proxy status
 
 # 关闭代理
-cc-run proxy off
+runcc proxy off
 ```
 
 ### 配置原生命令
 
 ```bash
 # 让原生 claude 命令使用 glm
-cc-run glm --claude
+runcc glm --claude
 
 # 之后直接使用 claude 命令即可
 claude "你好"
 
 # 恢复使用官方 endpoint
-cc-run --claude
+runcc --claude
 ```
 
 ## Token 管理
@@ -164,11 +164,11 @@ cc-run --claude
 首次使用某个 endpoint 时，如果未配置 token，会提示输入：
 
 ```bash
-$ cc-run glm
+$ runcc glm
 请输入 glm 的 API Token: [输入框]
 ```
 
-Token 会被保存到 `~/.cc-run/config.json`，下次使用时无需再次输入。
+Token 会被保存到 `~/.runcc/config.json`，下次使用时无需再次输入。
 
 ## 开发
 

package/dist/index.js

@@ -1917,7 +1917,7 @@ import { join } from "node:path";
 import { homedir } from "node:os";
 function getConfigDir() {
   const home = process.env.CC_RUN_TEST_HOME || homedir();
-  return join(home, ".cc-run");
+  return join(home, ".runcc");
 }
 function getConfigFilePath() {
   return join(getConfigDir(), "config.json");
@@ -2215,7 +2215,7 @@ function proxyReset() {
 function proxyStatus() {
   const ccRunConfig = getProxyConfig();
   const claudeProxy = getClaudeProxy();
-  console.log("CC-Run 代理配置:");
+  console.log("RunCC 代理配置:");
   console.log(`  状态: ${ccRunConfig.enabled ? "开启" : "关闭"}`);
   if (ccRunConfig.url) {
     console.log(`  地址: ${ccRunConfig.url}`);
@@ -2235,16 +2235,16 @@ function proxyHelp() {
   console.log(`
 代理管理命令:
 
-  cc-run proxy on      开启代理（首次会提示输入代理地址）
-  cc-run proxy off     关闭代理
-  cc-run proxy reset   重置代理配置
-  cc-run proxy status  查看代理状态
-  cc-run proxy help    显示此帮助信息
+  runcc proxy on      开启代理（首次会提示输入代理地址）
+  runcc proxy off     关闭代理
+  runcc proxy reset   重置代理配置
+  runcc proxy status  查看代理状态
+  runcc proxy help    显示此帮助信息
 
 说明:
   - proxy on 会修改 ~/.claude/settings.json，添加 proxy 配置
   - proxy off 会删除 ~/.claude/settings.json 中的 proxy 配置
-  - 代理地址保存在 ~/.cc-run/config.json 中
+  - 代理地址保存在 ~/.runcc/config.json 中
 `);
 }
 async function promptProxyUrl() {
@@ -2360,7 +2360,7 @@ async function runProvider(providerName, configureClaude, passthroughArgs = [])
   const endpoint = getEndpointConfig(providerName);
   if (!endpoint) {
     console.error(`错误: 未找到 endpoint "${providerName}"`);
-    console.log('使用 "cc-run list" 查看可用的 endpoints');
+    console.log('使用 "runcc list" 查看可用的 endpoints');
     process.exit(1);
   }
   let token = endpoint.token || getToken(providerName);
@@ -2386,7 +2386,7 @@ async function runProvider(providerName, configureClaude, passthroughArgs = [])
   if (configureClaude) {
     setThirdPartyApi(endpoint.endpoint, token);
     console.log(`已配置原生 claude 命令使用 ${providerName}`);
-    console.log('使用 "cc-run --claude" 可恢复官方配置');
+    console.log('使用 "runcc --claude" 可恢复官方配置');
   }
   const child = launchClaude({
     apiEndpoint: endpoint.endpoint,
@@ -2452,7 +2452,7 @@ function validateDashPosition(argv) {
     return;
   }
   if (dashIndex === 0) {
-    throw new PassthroughArgsError("必须在 provider 名称或 --claude 选项之后");
+    return;
   }
   const beforeDash = userArgs.slice(0, dashIndex);
   const hasValidPrefix = beforeDash.some((arg) => !arg.startsWith("-") || arg === "--claude");
@@ -2482,7 +2482,7 @@ if (isBunCompiled) {
   };
 }
 var program2 = new Command;
-program2.name("cc-run").description("Claude 启动器 - 支持切换不同的 API endpoint").version("0.1.0");
+program2.name("runcc").description("Claude 启动器 - 支持切换不同的 API endpoint").version("0.1.0");
 program2.command("list").description("列出所有可用的 endpoints").action(list);
 program2.command("add").description("添加自定义 endpoint").argument("<name>", "endpoint 名称").argument("<endpoint>", "API 地址").action(add);
 program2.command("remove").description("删除自定义 endpoint").argument("<name>", "endpoint 名称").action(remove);
@@ -2510,9 +2510,10 @@ program2.argument("[provider]", "provider 名称 (glm, deepseek, minimax 或自
       console.error("❌ 参数位置不正确");
       console.error("");
       console.error("正确的用法示例:");
-      console.error("  cc-run glm -- <claude参数>     # 使用 glm provider 并透传参数");
-      console.error("  cc-run --claude -- <参数>       # 恢复官方配置并透传参数");
-      console.error("  cc-run glm --claude -- <参数>   # 配置原生 claude 命令使用 glm");
+      console.error("  runcc -- <claude参数>          # 启动官方 Claude 并透传参数");
+      console.error("  runcc glm -- <claude参数>      # 使用 glm provider 并透传参数");
+      console.error("  runcc --claude -- <参数>        # 恢复官方配置并透传参数");
+      console.error("  runcc glm --claude -- <参数>    # 配置原生 claude 命令使用 glm");
       console.error("");
       console.error("说明: -- 分隔符用于将后续参数透传给 Claude CLI");
       process.exit(1);
@@ -2520,4 +2521,9 @@ program2.argument("[provider]", "provider 名称 (glm, deepseek, minimax 或自
     throw error;
   }
 });
-program2.parse();
+var userArgs = process.argv.slice(2);
+if (userArgs[0] === "--") {
+  program2.parse([process.argv[0], process.argv[1]]);
+} else {
+  program2.parse();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcc",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CC launcher with endpoint switching support",
   "type": "module",
   "main": "dist/index.js",

package/.claude/skills/npm-publish/SKILL.md

@@ -1,209 +0,0 @@
----
-name: npm-publish
-description: Automate npm package version bumping and publishing with comprehensive safety checks. Use when user requests "发布新版本", "publish to npm", "bump version", "release a new version", or similar package publishing tasks. Supports semantic versioning (patch/minor/major), git tagging, CHANGELOG updates, and pre-publish validation.
----
-
-# NPM Publish
-
-Automate the complete npm package release workflow with safety checks, version management, and changelog updates.
-
-## Workflow
-
-Follow this sequential workflow for publishing npm packages. Each step includes validation and confirmation points to ensure safe releases.
-
-### Step 1: Pre-flight Checks
-
-Before starting the release process, create a todo list with these items and verify the environment:
-
-1. **检查 git 工作区状态**
-   - Run `git status` to ensure working directory is clean
-   - If there are uncommitted changes, ask user whether to commit them or abort
-
-2. **确认当前分支**
-   - Check current branch with `git branch --show-current`
-   - Verify it's `main` or `master` (or other release branch)
-   - If not on release branch, warn user and ask to confirm or switch
-
-3. **检查 npm 登录状态**
-   - Run `npm whoami` to verify npm authentication
-   - If not logged in, instruct user to run `npm login`
-
-4. **拉取最新代码**
-   - Run `git pull` to ensure working with latest code
-   - Check for any conflicts
-
-### Step 2: Determine Version Bump Type
-
-Ask the user which type of version bump to perform, unless they've already specified:
-
-- **patch**: Bug fixes, minor changes (1.0.0 → 1.0.1)
-- **minor**: New features, backward compatible (1.0.0 → 1.1.0)
-- **major**: Breaking changes (1.0.0 → 2.0.0)
-- **custom**: Specify exact version number
-
-Use the `AskUserQuestion` tool if the version type wasn't specified in the initial request.
-
-### Step 3: Run Tests and Build
-
-Execute the project's quality checks:
-
-1. **运行测试**
-   - Check if `package.json` has a `test` script
-   - Run `npm test` or equivalent command
-   - If tests fail, abort the release and report errors
-
-2. **运行构建**
-   - Check if `package.json` has a `build` script
-   - Run `npm run build` or equivalent command
-   - If build fails, abort the release and report errors
-
-### Step 4: Update CHANGELOG
-
-If CHANGELOG.md exists in the project:
-
-1. **Read recent commits**
-   - Run `git log` to see commits since last release
-   - Look for previous version tags with `git tag -l`
-
-2. **Generate changelog entry**
-   - Create a new section for the new version
-   - List key changes based on commit messages
-   - Format: `## [Version] - YYYY-MM-DD`
-   - Group changes by type: Features, Bug Fixes, Breaking Changes, etc.
-
-3. **Let user review and edit**
-   - Show the generated changelog entry
-   - Use `AskUserQuestion` to confirm or request modifications
-   - Update CHANGELOG.md with the approved content
-
-If no CHANGELOG.md exists, ask user if they want to create one.
-
-### Step 5: Bump Version
-
-Use npm's built-in version command:
-
-```bash
-npm version <patch|minor|major|x.y.z> -m "chore: release v%s"
-```
-
-This command will:
-- Update version in `package.json` and `package-lock.json`
-- Create a git commit with the specified message
-- Create a git tag with the new version
-
-### Step 6: User Confirmation
-
-Before publishing, display a summary and ask for final confirmation:
-
-```
-Ready to publish:
-- Package: <package-name>
-- Current version: <old-version>
-- New version: <new-version>
-- Branch: <branch-name>
-- Changes: <summary from changelog>
-
-Proceed with publishing? (yes/no)
-```
-
-Use `AskUserQuestion` for this confirmation.
-
-### Step 7: Publish to NPM
-
-If user confirms, publish the package:
-
-```bash
-npm publish
-```
-
-Options to consider:
-- `--access public` for scoped public packages
-- `--tag <tag>` for pre-release versions (e.g., `beta`, `next`)
-- `--dry-run` to test without actually publishing (useful for first-time testing)
-
-### Step 8: Push to Git Remote
-
-After successful npm publish:
-
-1. **推送代码和标签**
-   ```bash
-   git push && git push --tags
-   ```
-
-2. **验证发布**
-   - Confirm the new version appears on npmjs.com
-   - Confirm the git tag appears on the remote repository
-
-### Step 9: Summary
-
-Report the successful release:
-
-```
-✅ Successfully published <package-name>@<new-version>
-
-- NPM: https://www.npmjs.com/package/<package-name>
-- Git tag: <tag-name>
-- Changelog updated: Yes/No
-
-Next steps:
-- Create GitHub release (if applicable)
-- Announce to team
-- Update dependent projects
-```
-
-## Error Handling
-
-If any step fails:
-
-1. **Clearly state which step failed and why**
-2. **Do not proceed to next steps**
-3. **Provide actionable recovery steps**
-4. **If version was bumped but publish failed:**
-   - The version commit and tag already exist
-   - User can either: fix the issue and run `npm publish` manually, or reset with `git reset --hard HEAD~1 && git tag -d v<version>`
-
-## Rollback
-
-If user needs to undo a release:
-
-1. **Unpublish from npm** (only within 72 hours):
-   ```bash
-   npm unpublish <package-name>@<version>
-   ```
-
-2. **Delete git tag**:
-   ```bash
-   git tag -d v<version>
-   git push origin :refs/tags/v<version>
-   ```
-
-3. **Revert version commit**:
-   ```bash
-   git reset --hard HEAD~1
-   git push --force
-   ```
-
-**Warning**: Unpublishing is discouraged by npm. Prefer deprecating instead:
-```bash
-npm deprecate <package-name>@<version> "Reason for deprecation"
-```
-
-## Customization
-
-Different projects may need adaptations:
-
-- **Monorepo**: Use tools like `lerna` or `nx` for versioning multiple packages
-- **Pre-release versions**: Use `npm version prerelease --preid=beta`
-- **CI/CD**: This workflow is for manual releases; adapt for automated pipelines
-- **Private registry**: Use `--registry` flag or `.npmrc` configuration
-- **2FA**: npm may require OTP code during publish, prompt user to enter it
-
-## Best Practices
-
-1. **Always run tests before publishing**
-2. **Keep CHANGELOG.md up to date**
-3. **Use semantic versioning correctly**
-4. **Review changes one final time before confirming**
-5. **Never publish with uncommitted changes**
-6. **Tag releases for easy reference**
-7. **Announce breaking changes clearly**

package/PLAN.md

@@ -1,236 +0,0 @@
-# CC 启动器实现计划
-
-## 项目概述
-
-使用 TypeScript + bun 创建 CC 启动器，支持切换不同的 API endpoint。
-
-## 命令格式
-
-| 命令 | 功能 |
-|------|------|
-| `cc-run` | **总是**启动官方 claude（根据配置决定是否临时清除 proxy 和第三方 endpoint） |
-| `cc-run --claude` | 恢复原生 `claude` 命令使用官方 endpoint（删除 ~/.claude/settings.json 中的第三方配置） |
-| `cc-run glm` | 使用 glm endpoint |
-| `cc-run glm --claude` | 使用 glm，并配置原生 `claude` 命令默认使用 glm |
-| `cc-run deepseek` | 使用 deepseek endpoint |
-| `cc-run deepseek --claude` | 使用 deepseek，并配置原生 `claude` 命令默认使用 deepseek |
-| `cc-run minimax` | 使用 minimax endpoint |
-| `cc-run add <name> <endpoint> <token>` | 添加自定义 endpoint |
-| `cc-run list` | 列出所有 endpoint |
-| `cc-run remove <name>` | 删除自定义 endpoint |
-| `cc-run proxy on` | 开启代理（修改 ~/.claude/settings.json） |
-| `cc-run proxy off` | 关闭代理（修改 ~/.claude/settings.json） |
-| `cc-run proxy reset` | 重置代理配置 |
-| `cc-run proxy status` | 查看代理状态 |
-| `cc-run proxy help` | 代理帮助信息 |
-
-## 项目结构
-
-```
-cc-run/
-├── package.json
-├── tsconfig.json
-├── src/
-│   ├── index.ts              # CLI 入口
-│   ├── commands/
-│   │   ├── run.ts            # 启动命令
-│   │   ├── add.ts            # 添加 endpoint
-│   │   ├── list.ts           # 列出 endpoint
-│   │   ├── remove.ts         # 删除 endpoint
-│   │   └── proxy.ts          # 代理管理命令
-│   ├── config/
-│   │   ├── storage.ts        # 配置存储管理
-│   │   ├── endpoints.ts      # 内置 endpoint 定义
-│   │   └── types.ts          # 类型定义
-│   └── utils/
-│       ├── env.ts            # 环境变量设置
-│       └── launcher.ts       # 启动 claude
-└── README.md
-```
-
-## 内置 Endpoints
-
-| 名称 | Endpoint |
-|------|----------|
-| glm | https://open.bigmodel.cn/api/paas/v4/ |
-| deepseek | https://api.deepseek.com |
-| minimax | https://api.minimax.chat/v1 |
-
-## 配置存储
-
-### ~/.cc-run/config.json（启动器配置）
-`proxy.on/off` 会修改此文件的 proxy 配置，`cc-run <provider>` 会保存 token：
-```json
-{
-  "endpoints": [
-    {
-      "name": "my-custom",
-      "endpoint": "https://api.example.com/v1",
-      "token": "sk-xxxxxxxx"
-    }
-  ],
-  "tokens": {
-    "glm": "sk-xxxxxxxx",
-    "deepseek": "sk-yyyyyyyy",
-    "minimax": "sk-zzzzzzzz"
-  },
-  "lastUsed": "glm",
-  "proxy": {
-    "enabled": true,
-    "url": "http://agent.baidu.com:8891",
-    "clearForOfficial": false
-  }
-}
-```
-
-### ~/.claude/settings.json（Claude 官方配置）
-`proxy on/off` 会修改此文件的 proxy 配置：
-```json
-{
-  "proxy": "http://agent.baidu.com:8891"
-}
-```
-
-## Proxy 处理逻辑
-
-### cc-run proxy on
-1. 提示输入代理地址（首次）
-2. 保存到 `~/.cc-run/config.json`
-3. 修改 `~/.claude/settings.json`，添加 proxy 配置
-
-### cc-run proxy off
-1. 更新 `~/.cc-run/config.json`（enabled: false）
-2. 修改 `~/.claude/settings.json`，删除 proxy 配置
-
-## 运行逻辑
-
-### cc-run（无参数）
-
-总是启动官方 claude。启动前会检查并清理 `~/.claude/settings.json`：
-
-1. 读取当前的 `~/.claude/settings.json`
-2. 检查是否有 `proxy` 配置
-3. 检查是否有 `apiUrl` / `anthropicApiKey` 等第三方 endpoint 配置
-4. 根据清理策略清理：
-   - **proxy 清理**：由 `~/.cc-run/config.json` 中 `proxy.clearForOfficial` 决定
-   - **endpoint 清理**：总是清除第三方 endpoint 配置
-5. 启动 claude
-6. claude 退出后恢复被清除的配置
-
-**proxy 清理策略**（`~/.cc-run/config.json`）：
-```json
-{
-  "proxy": {
-    "clearForOfficial": true  // 启动官方 claude 时是否清除 proxy
-  }
-}
-```
-
-### cc-run <provider>
-
-使用指定 endpoint，通过环境变量启动。
-
-**Token 获取逻辑**：
-1. 检查 `~/.cc-run/config.json` 中是否已保存该 provider 的 token
-2. 如果没有，提示用户输入：
-   ```
-   请输入 glm 的 API Token: [输入框]
-   ```
-3. 保存 token 到 `~/.cc-run/config.json`：
-   ```json
-   {
-     "tokens": {
-       "glm": "sk-xxxxxxxx",
-       "deepseek": "sk-yyyyyyyy",
-       "minimax": "sk-zzzzzzzz"
-     }
-   }
-   ```
-4. 使用保存的 token 启动
-
-### cc-run <provider> --claude
-使用指定 endpoint，并**配置原生 `claude` 命令**的默认行为：
-1. 使用指定 endpoint 启动 cc-run
-2. 修改 `~/.claude/settings.json`，设置：
-   - `apiUrl`: 指定 provider 的 endpoint
-   - `anthropicApiKey`: 指定 provider 的 token
-3. 之后直接运行原生 `claude` 命令时，会使用这个第三方 endpoint
-4. **不影响** `cc-run` 无参数的行为（`cc-run` 仍然总是启动官方 claude）
-
-### cc-run --claude（无 provider）
-**恢复原生 `claude` 命令使用官方 endpoint**：
-1. 删除 `~/.claude/settings.json` 中的 `apiUrl` 和 `anthropicApiKey`
-2. 之后直接运行原生 `claude` 命令时，会使用官方 endpoint
-3. 不启动 cc-run
-
-> **注**：`--claude` 只影响原生 `claude` 命令，不影响 `cc-run`
-
-## 环境变量
-
-启动 CC 时设置：
-- `ANTHROPIC_BASE_URL` - API endpoint
-- `ANTHROPIC_AUTH_TOKEN` - API token
-- `http_proxy` / `https_proxy` - 代理（如果配置）
-
-## 关键文件
-
-| 文件 | 说明 |
-|------|------|
-| `src/index.ts` | CLI 入口，使用 commander 解析参数 |
-| `src/config/storage.ts` | 配置文件读写、token 管理、endpoint 管理 |
-| `src/utils/token.ts` | Token 获取和保存逻辑（首次使用时提示输入） |
-| `src/commands/run.ts` | 核心启动逻辑，处理官方模式的 proxy 临时清除 |
-| `src/commands/proxy.ts` | 代理管理命令（on/off/reset/status/help） |
-| `src/utils/launcher.ts` | spawn claude 进程 |
-| `src/utils/claude-settings.ts` | 读写 `~/.claude/settings.json` 的 proxy 和 endpoint 配置 |
-| `src/config/types.ts` | TypeScript 类型定义 |
-
-## 代理命令实现要点
-
-| 命令 | 说明 |
-|------|------|
-| `cc-run proxy on` | 首次运行时提示输入代理地址，保存并修改 `~/.claude/settings.json` |
-| `cc-run proxy off` | 关闭代理，删除 `~/.claude/settings.json` 中的 proxy 配置 |
-| `cc-run proxy reset` | 重置代理配置 |
-| `cc-run proxy status` | 显示代理状态（是否启用、地址） |
-| `cc-run proxy help` | 显示代理相关帮助 |
-
-## 依赖
-
-```json
-{
-  "dependencies": {
-    "commander": "^12.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "bun-types": "latest"
-  }
-}
-```
-
-## 验证方式
-
-```bash
-# 1. 构建
-bun run build
-
-# 2. 测试 list
-bun run src/index.ts list
-
-# 3. 测试 add
-bun run src/index.ts add test https://api.test.com sk-test
-
-# 4. 测试 proxy
-bun run src/index.ts proxy status
-bun run src/index.ts proxy on
-bun run src/index.ts proxy off
-
-# 5. 测试 run（需要已有 token）
-bun run src/index.ts glm
-
-# 6. 全局安装后测试
-bun install -g
-cc-run list
-cc-run proxy status
-```