@unitsvc/cc-helper 1.0.17 → 1.0.19

package/README-zh.md

@@ -17,6 +17,18 @@
 npm install -g @anthropic-ai/claude-code@v2.1.76
 ```
 
+## 安装
+
+```bash
+npm install -g @unitsvc/cc-helper@latest
+```
+
+或直接使用 npx 运行：
+
+```bash
+npx @unitsvc/cc-helper enable
+```
+
 ## 使用方法
 
 ```bash
@@ -50,6 +62,19 @@ npx @unitsvc/cc-helper disable
 | `disable`            | 恢复原始状态                                                   |
 | `status`             | 查看当前状态及版本要求                                         |
 
+**注意**: 运行 `cc-helper enable` 时会自动在 `~/.claude/settings.json` 中配置推荐的环境变量：
+
+- `DISABLE_INSTALLATION_CHECKS=1` - 禁用 npm 安装警告
+- `DISABLE_AUTOUPDATER=1` - 禁用自动更新
+- `DISABLE_BUG_COMMAND=1` - 禁用 bug 命令
+- `DISABLE_ERROR_REPORTING=1` - 禁用错误报告
+- `DISABLE_TELEMETRY=1` - 禁用遥测
+- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` - 禁用非必要流量
+- `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` - 禁用反馈调查
+- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` - 启用实验性 Agent Teams
+- `CLAUDE_CODE_HIDE_ACCOUNT_INFO=1` - 隐藏账户信息
+- `API_TIMEOUT_MS=3000000` - 设置 API 超时为 50 分钟
+
 ---
 
 ## 什么是 `/loop`？
@@ -216,27 +241,116 @@ npx @unitsvc/cc-helper enable 1m
 npx @unitsvc/cc-helper enable 1M
 ```
 
-### 扩展思维支持
+### 扩展思维与上下文长度
+
+使用第三方 API 代理时，扩展思维（推理）能力和上下文窗口大小因模型而异：
+
+| 模型                 | 最大思维链长度          | 上下文长度（Tokens） |
+| -------------------- | ----------------------- | -------------------- |
+| qwen3.5-plus         | 81,920                  | 1,000,000            |
+| qwen3-coder-plus     | 不支持思考模式          | 1,000,000            |
+| qwen3-max-2026-01-23 | 81,920                  | 262,144              |
+| qwen3-coder-next     | 不支持思考模式          | 262,144              |
+| kimi-k2.5            | 81,920                  | 262,144              |
+| MiniMax-M2.5         | 32,768（思维链 + 回复） | 204,800              |
+| glm-5                | 32,768                  | 202,752              |
+| glm-4.7              | 32,768                  | 202,752              |
+
+## plan 命令 - 配置 Provider
+
+`cc-helper plan` 命令帮助配置 AI Provider，支持 vault 加密存储。
+
+```bash
+# 添加 Provider（自动保存到 vault + settings.json）
+cc-helper plan add -p bailian -k YOUR_API_KEY
+cc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp
+
+# 切换 Provider（自动从 vault 获取密钥）
+cc-helper plan switch -p zai
+
+# 列出已配置的 Provider
+cc-helper plan list
+
+# 导出配置
+cc-helper plan export --all-env -o config.json
+```
+
+**支持的 Provider:**
+
+- `bailian` - (CN) Aliyun
+- `minimaxi` - (CN) MiniMax
+- `glm` - (CN) Zhipu
+- `zai` - (EN) Zhipu
+
+---
+
+## vault 命令 - 密钥管理
+
+安全的密钥存储，加密存储在 `cc-helper.json` 中。
+
+```bash
+# 列出所有密钥
+cc-helper vault list
+
+# 设置密钥
+cc-helper vault set bailian default -k "YOUR_API_KEY"
+
+# 获取并解密密钥
+cc-helper vault get bailian default
+
+# 删除密钥
+cc-helper vault delete bailian default
+```
+
+---
+
+## env 命令 - 环境管理
+
+支持多环境配置（default、work、staging 等）。
+
+```bash
+# 列出环境
+cc-helper env list
+
+# 创建环境
+cc-helper env create work
+
+# 切换环境
+cc-helper env switch work
+```
+
+---
+
+## sync 命令 - 配置同步
 
-使用第三方 API 代理时，扩展思维（推理）能力因模型而异：
+将配置导出/导入到 Git 仓库，支持 JWE 加密。
 
-| 模型                 | 最大思维链长度        |
-| -------------------- | --------------------- |
-| qwen3.5-plus         | 81,920                |
-| qwen3-max-2026-01-23 | 81,920                |
-| kimi-k2.5            | 81,920                |
-| glm-5                | 32,768                |
-| glm-4.7              | 32,768                |
-| MiniMax-M2.5         | 32,768（思维链+回复） |
-| qwen3-coder-next     | 不支持思考模式        |
-| qwen3-coder-plus     | 不支持思考模式        |
+```bash
+# 登录 GitHub
+cc-helper sync login -r https://github.com/user/repo -t ghp_xxx
+
+# 导出到 Git 仓库
+cc-helper sync export
+
+# 导出到文件
+cc-helper sync export --file config.json
+cc-helper sync export --workspace test  # 使用工作区配置
+
+# 导入配置
+cc-helper sync import
+```
+
+---
 
 ## 功能特点
 
 - 一键启用 `/loop`、`/btw`、`/keybindings` 功能
 - 可选 `/toolsearch` 用于第三方 API 代理
 - 可选 `/context1m` 用于 1M 上下文窗口（v2.1.76+）
-- 可单独启用特定功能
+- `plan` 命令支持 vault 加密存储 API 密钥
+- `vault` 命令安全管理密钥
+- `env` 命令支持多环境配置
+- `sync` 命令支持 Git 仓库同步
 - 轻松恢复原始状态
 - 自动备份原文件
 - 自动禁用 npm 弃用警告

package/README.md

@@ -17,6 +17,18 @@
 npm install -g @anthropic-ai/claude-code@v2.1.76
 ```
 
+## Installation
+
+```bash
+npm install -g @unitsvc/cc-helper@latest
+```
+
+Or use without installation:
+
+```bash
+npx @unitsvc/cc-helper enable
+```
+
 ## Usage
 
 ```bash
@@ -50,6 +62,19 @@ npx @unitsvc/cc-helper disable
 | `disable`            | Restore original                                                     |
 | `status`             | Check current status with version requirements                       |
 
+**Note**: Running `cc-helper enable` also automatically configures recommended environment variables in `~/.claude/settings.json`:
+
+- `DISABLE_INSTALLATION_CHECKS=1` - Disable npm installation warnings
+- `DISABLE_AUTOUPDATER=1` - Disable auto-updater
+- `DISABLE_BUG_COMMAND=1` - Disable bug command
+- `DISABLE_ERROR_REPORTING=1` - Disable error reporting
+- `DISABLE_TELEMETRY=1` - Disable telemetry
+- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` - Disable non-essential traffic
+- `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1` - Disable feedback survey
+- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` - Enable experimental agent teams
+- `CLAUDE_CODE_HIDE_ACCOUNT_INFO=1` - Hide account info
+- `API_TIMEOUT_MS=3000000` - Set API timeout to 50 minutes
+
 ### Proxy Support
 
 If download fails, use `--proxy` flag:
@@ -228,26 +253,116 @@ npx @unitsvc/cc-helper enable 1m
 npx @unitsvc/cc-helper enable 1M
 ```
 
-### Extended Thinking Support
+### Extended Thinking and Context Length
+
+When using third-party API proxies, extended thinking (reasoning) capabilities and context window sizes vary by model:
+
+| Model                | Max Thinking Tokens          | Context Length (Tokens) |
+| -------------------- | ---------------------------- | ----------------------- |
+| qwen3.5-plus         | 81,920                       | 1,000,000               |
+| qwen3-coder-plus     | Not supported                | 1,000,000               |
+| qwen3-max-2026-01-23 | 81,920                       | 262,144                 |
+| qwen3-coder-next     | Not supported                | 262,144                 |
+| kimi-k2.5            | 81,920                       | 262,144                 |
+| MiniMax-M2.5         | 32,768 (thinking + response) | 204,800                 |
+| glm-5                | 32,768                       | 202,752                 |
+| glm-4.7              | 32,768                       | 202,752                 |
+
+## plan Command - Configure Provider
+
+Configure AI providers with vault-based secret storage.
+
+```bash
+# Add provider (auto-saves to vault + settings.json)
+cc-helper plan add -p bailian -k YOUR_API_KEY
+cc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp
+
+# Switch provider (auto-retrieves key from vault)
+cc-helper plan switch -p zai
+
+# List configured providers
+cc-helper plan list
+
+# Export configuration
+cc-helper plan export --all-env -o config.json
+```
+
+**Supported Providers:**
+
+- `bailian` - (CN) Aliyun
+- `minimaxi` - (CN) MiniMax
+- `glm` - (CN) Zhipu
+- `zai` - (EN) Zhipu
+
+---
+
+## vault Command - Secret Management
+
+Securely store API keys encrypted in `cc-helper.json`.
+
+```bash
+# List all secrets
+cc-helper vault list
+
+# Set a secret
+cc-helper vault set bailian default -k "YOUR_API_KEY"
+
+# Get and decrypt a secret
+cc-helper vault get bailian default
+
+# Delete a secret
+cc-helper vault delete bailian default
+```
+
+---
+
+## env Command - Environment Management
+
+Support multiple environments (default, work, staging, etc.).
+
+```bash
+# List environments
+cc-helper env list
+
+# Create environment
+cc-helper env create work
+
+# Switch environment
+cc-helper env switch work
+```
+
+---
+
+## sync Command - Configuration Sync
 
-When using third-party API proxies, extended thinking (reasoning) capabilities vary by model:
+Export/import configuration to/from Git repository with JWE encryption.
 
-| Model                | Max Thinking Tokens          |
-| -------------------- | ---------------------------- |
-| qwen3.5-plus         | 81,920                       |
-| qwen3-max-2026-01-23 | 81,920                       |
-| kimi-k2.5            | 81,920                       |
-| glm-5                | 32,768                       |
-| glm-4.7              | 32,768                       |
-| MiniMax-M2.5         | 32,768 (thinking + response) |
-| qwen3-coder-next     | Not supported                |
-| qwen3-coder-plus     | Not supported                |
+```bash
+# Login to GitHub
+cc-helper sync login -r https://github.com/user/repo -t ghp_xxx
+
+# Export to Git repository
+cc-helper sync export
+
+# Export to file
+cc-helper sync export --file config.json
+cc-helper sync export --workspace test  # Use workspace config
+
+# Import configuration
+cc-helper sync import
+```
+
+---
 
 ## Features
 
 - Enable `/loop`, `/btw`, `/keybindings` with one command
 - Optional `/toolsearch` for third-party API proxies
 - Optional `/context1m` for 1M context window (v2.1.76+)
+- `plan` command with vault-based API key storage
+- `vault` command for secure secret management
+- `env` command for multi-environment support
+- `sync` command for Git repository sync
 - Enable specific features individually
 - Easy restore functionality
 - Automatic backup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unitsvc/cc-helper",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "Claude Code /loop feature bypass tool",
   "main": "dist/index.js",
   "bin": {
@@ -14,7 +14,8 @@
   },
   "keywords": [
     "claude code",
-    "loop",
+    "coding plan",
+    "compliance",
     "cli"
   ],
   "author": "next-bin",