@simonyea/holysheep-cli 1.1.6 → 1.1.8

package/README.md

@@ -16,7 +16,7 @@
 
 <br/>
 
-[🚀 Get Started](#quick-start) · [📦 npm](https://www.npmjs.com/package/@simonyea/holysheep-cli) · [🐑 HolySheep](https://shop.holysheep.ai)
+[🚀 Quick Start](#quick-start) · [📦 npm](https://www.npmjs.com/package/@simonyea/holysheep-cli) · [🌐 holysheep.ai](https://holysheep.ai)
 
 </div>
 
@@ -28,73 +28,50 @@
 
 ### What is HolySheep CLI?
 
-**HolySheep CLI** (`hs`) is a command-line tool that automatically configures all popular AI coding assistants to use [HolySheep API](https://shop.holysheep.ai) — a relay service that lets developers in China access Claude, GPT, and Gemini APIs **without a VPN**, at **¥1 = $1** exchange rate.
+**HolySheep CLI** (`hs`) is a command-line tool that automatically configures all popular AI coding assistants to use [HolySheep API](https://holysheep.ai) — a relay service for accessing Claude, GPT, and Gemini APIs in China without a VPN.
 
-Instead of manually editing config files and environment variables for each tool, just run `hs setup` and you're done.
+Instead of manually editing config files for each tool, run one command and you're done.
 
 ### Supported Tools
 
-| Tool | Install | Config Method | Status |
-|------|---------|---------------|--------|
-| [Claude Code](https://docs.anthropic.com/claude-code) | `npm i -g @anthropic-ai/claude-code` | `~/.claude/settings.json` | ✅ Auto |
-| [Codex CLI](https://github.com/openai/codex) | `npm i -g @openai/codex` | `~/.codex/config.toml` | ✅ Auto |
-| [Aider](https://aider.chat) | `pip install aider-install && aider-install` | `~/.aider.conf.yml` | ✅ Auto |
-| [Continue.dev](https://continue.dev) | VS Code marketplace | `~/.continue/config.yaml` | ✅ Auto |
-| [OpenCode](https://opencode.ai) | `brew install anomalyco/tap/opencode` | `~/.config/opencode/opencode.json` | ✅ Auto |
-| [OpenClaw](https://github.com/openclaw/openclaw) | `npm i -g openclaw@latest` | `~/.openclaw/openclaw.json` | ✅ Auto |
-| [Cursor](https://cursor.sh) | Download from website | GUI only (encrypted storage) | ⚠️ Manual |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm i -g @google/gemini-cli` | Google protocol only | ❌ Not supported |
-
-> **Note on Cursor**: Cursor (2025+) requires logging into the official Cursor account. API keys are stored in encrypted secret storage that CLI cannot access. Manual configuration via `Settings → Models → Override OpenAI Base URL` is required after login.
+| Tool | Config File | Status |
+|------|-------------|--------|
+| [Claude Code](https://docs.anthropic.com/claude-code) | `~/.claude/settings.json` | ✅ Auto |
+| [Codex CLI](https://github.com/openai/codex) | `~/.codex/config.toml` | ✅ Auto |
+| [Aider](https://aider.chat) | `~/.aider.conf.yml` | ✅ Auto |
+| [Continue.dev](https://continue.dev) | `~/.continue/config.yaml` | ✅ Auto |
+| [OpenCode](https://github.com/anomalyco/opencode) | `~/.config/opencode/opencode.json` | ✅ Auto |
+| [OpenClaw](https://github.com/openclaw/openclaw) | `~/.openclaw/openclaw.json` | ✅ Auto |
+| [Cursor](https://cursor.sh) | GUI (encrypted storage) | ⚠️ Manual |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google protocol only | ❌ Not supported |
+
+> **Cursor**: API keys are stored in encrypted secret storage. Configure manually via `Settings → Models → Override OpenAI Base URL`.
 >
-> **Note on Gemini CLI**: Gemini CLI uses Google's proprietary protocol and does not support custom relay endpoints. Use your own Google Gemini API Key from [aistudio.google.com](https://aistudio.google.com/apikey).
+> **Gemini CLI**: Uses Google's proprietary protocol and does not support custom relay endpoints.
 
-### Installation
-
-```bash
-npm install -g @simonyea/holysheep-cli
-```
-
-No npm? Try npx (no install needed):
+### Quick Start
 
 ```bash
 npx @simonyea/holysheep-cli@latest setup
 ```
 
-### Quick Start
-
-**Step 1** — Sign up at **[shop.holysheep.ai](https://shop.holysheep.ai)** and get your API Key (`cr_xxx`)
-
-**Step 2** — Run setup:
+Or install globally:
 
 ```bash
+npm install -g @simonyea/holysheep-cli
 hs setup
 ```
 
-```
-🐑  HolySheep CLI — Configure AI Tools
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-? API Key (cr_xxx): cr_xxxxxxxxxxxxxxxx
-? Select tools to configure:
-  ✅ ● Claude Code    (installed)
-  ✅ ● Gemini CLI     (installed)
-  ○  Codex CLI        (not installed)
-  ○  Aider            (not installed)
-
-✓ Claude Code   → ~/.claude/settings.json  (hot reload, no restart needed)
-✓ Gemini CLI    → ~/.gemini/settings.json
-✓ Env vars written to ~/.zshrc
-
-✅ Done! All tools configured.
-```
+You'll be prompted for your API Key (`cr_xxx`), then the tool will auto-detect installed AI tools and configure them all.
 
 ### Commands
 
 | Command | Description |
 |---------|-------------|
 | `hs setup` | Configure all AI tools interactively |
+| `hs login` | Save your API Key locally |
 | `hs doctor` | Check configuration status & connectivity |
-| `hs balance` | View account balance and usage |
+| `hs balance` | View account balance |
 | `hs tools` | List all supported tools |
 | `hs reset` | Remove all HolySheep configuration |
 
@@ -105,13 +82,6 @@ hs setup
 | Anthropic SDK / Claude Code | `https://api.holysheep.ai` (no `/v1`) |
 | OpenAI-compatible / Codex / Aider | `https://api.holysheep.ai/v1` (with `/v1`) |
 
-### Why HolySheep?
-
-- 🇨🇳 **China-accessible** — Direct connection, no VPN needed
-- 💰 **Best rate** — ¥1 = $1, balance never expires, pay-as-you-go
-- ⚡ **All major models** — Claude 3.5/3.7, GPT-4o, Gemini 1.5 Pro and more
-- 🔒 **Official relay** — Direct passthrough to official APIs, no censorship
-
 ---
 
 <a name="chinese"></a>
@@ -120,75 +90,50 @@ hs setup
 
 ### 什么是 HolySheep CLI？
 
-**HolySheep CLI**（命令 `hs`）是一个命令行工具，帮你一键配置所有主流 AI 编程助手接入 [HolySheep API](https://shop.holysheep.ai)。
-
-HolySheep 是面向中国开发者的 Claude/GPT/Gemini 官方 API 中转服务，**国内直连、无需翻墙、¥1=$1**。
+**HolySheep CLI**（命令 `hs`）是一个命令行工具，帮你一键配置所有主流 AI 编程助手接入 [HolySheep API](https://holysheep.ai)。
 
-不用再逐个工具手动改配置文件和环境变量，执行 `hs setup` 一步搞定。
+不用再逐个工具手动改配置文件和环境变量，运行一条命令全部搞定。
 
 ### 支持的工具
 
-| 工具 | 安装方式 | 配置方式 | 状态 |
-|------|---------|---------|------|
-| [Claude Code](https://docs.anthropic.com/claude-code) | `npm i -g @anthropic-ai/claude-code` | `~/.claude/settings.json` | ✅ 自动 |
-| [Codex CLI](https://github.com/openai/codex) | `npm i -g @openai/codex` | `~/.codex/config.toml` | ✅ 自动 |
-| [Aider](https://aider.chat) | `pip install aider-install && aider-install` | `~/.aider.conf.yml` | ✅ 自动 |
-| [Continue.dev](https://continue.dev) | VS Code 插件市场 | `~/.continue/config.yaml` | ✅ 自动 |
-| [OpenCode](https://opencode.ai) | `brew install anomalyco/tap/opencode` | `~/.config/opencode/opencode.json` | ✅ 自动 |
-| [OpenClaw](https://github.com/openclaw/openclaw) | `npm i -g openclaw@latest` | `~/.openclaw/openclaw.json` | ✅ 自动 |
-| [Cursor](https://cursor.sh) | 官网下载 | GUI 手动配置（加密存储） | ⚠️ 手动 |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm i -g @google/gemini-cli` | 仅支持 Google 官方协议 | ❌ 不支持 |
-
-> **关于 Cursor**：Cursor 新版（2025+）必须登录官方账号，API Key 存储在加密区域，CLI 无法写入。需登录后在 `Settings → Models → Override OpenAI Base URL` 手动填入。
+| 工具 | 配置文件 | 状态 |
+|------|---------|------|
+| [Claude Code](https://docs.anthropic.com/claude-code) | `~/.claude/settings.json` | ✅ 自动 |
+| [Codex CLI](https://github.com/openai/codex) | `~/.codex/config.toml` | ✅ 自动 |
+| [Aider](https://aider.chat) | `~/.aider.conf.yml` | ✅ 自动 |
+| [Continue.dev](https://continue.dev) | `~/.continue/config.yaml` | ✅ 自动 |
+| [OpenCode](https://github.com/anomalyco/opencode) | `~/.config/opencode/opencode.json` | ✅ 自动 |
+| [OpenClaw](https://github.com/openclaw/openclaw) | `~/.openclaw/openclaw.json` | ✅ 自动 |
+| [Cursor](https://cursor.sh) | GUI（加密存储） | ⚠️ 手动 |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | 仅支持 Google 官方协议 | ❌ 不支持 |
+
+> **Cursor**：API Key 存储在加密区域，CLI 无法写入。登录后在 `Settings → Models → Override OpenAI Base URL` 手动填入。
 >
-> **关于 Gemini CLI**：Gemini CLI 使用 Google 专有协议，不支持自定义中转地址。需使用从 [aistudio.google.com](https://aistudio.google.com/apikey) 获取的 Google Gemini API Key。
+> **Gemini CLI**：使用 Google 专有协议，不支持自定义中转地址。
 
-### 安装
-
-```bash
-npm install -g @simonyea/holysheep-cli
-```
-
-没有 npm？用 npx 免安装直接运行：
+### 快速开始
 
 ```bash
 npx @simonyea/holysheep-cli@latest setup
 ```
 
-### 快速开始
-
-**第一步** — 前往 **[shop.holysheep.ai](https://shop.holysheep.ai)** 注册账号，充值后创建 API Key（`cr_` 开头）
-
-**第二步** — 运行配置向导：
+或全局安装：
 
 ```bash
+npm install -g @simonyea/holysheep-cli
 hs setup
 ```
 
-```
-🐑  HolySheep CLI — 一键配置 AI 工具
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-? API Key (cr_xxx): cr_xxxxxxxxxxxxxxxx
-? 选择要配置的工具：
-  ✅ ● Claude Code    (已安装)
-  ✅ ● Gemini CLI     (已安装)
-  ○  Codex CLI        (未安装)
-  ○  Aider            (未安装)
-
-✓ Claude Code   → ~/.claude/settings.json  (热切换，无需重启)
-✓ Gemini CLI    → ~/.gemini/settings.json
-✓ 环境变量已写入 ~/.zshrc
-
-✅ 配置完成！
-```
+按提示输入 API Key（`cr_xxx`），工具会自动检测已安装的 AI 工具并完成配置。
 
 ### 命令说明
 
 | 命令 | 说明 |
 |------|------|
 | `hs setup` | 交互式配置所有 AI 工具 |
+| `hs login` | 登录并保存 API Key 到本地 |
 | `hs doctor` | 检查配置状态和连通性 |
-| `hs balance` | 查看账户余额和用量 |
+| `hs balance` | 查看账户余额 |
 | `hs tools` | 列出所有支持的工具 |
 | `hs reset` | 清除所有 HolySheep 配置 |
 
@@ -199,26 +144,22 @@ hs setup
 | Anthropic SDK / Claude Code | `https://api.holysheep.ai`（不带 /v1） |
 | OpenAI 兼容 / Codex / Aider | `https://api.holysheep.ai/v1`（带 /v1） |
 
-### 为什么选 HolySheep？
-
-- 🇨🇳 **国内直连** — 无需代理，开箱即用
-- 💰 **全网最优汇率** — ¥1=$1，余额永久有效，按量计费
-- ⚡ **全主流模型** — Claude 3.5/3.7、GPT-4o、Gemini 1.5 Pro 等
-- 🔒 **官方直转** — 直连官方 API，无任何阉割
-
 ### 常见问题
 
-**Q: API Key 格式是什么？**  
-A: `cr_` 开头的字符串，在 [shop.holysheep.ai](https://shop.holysheep.ai) 控制台「API 密钥」页面创建。
+**Q: API Key 在哪里获取？**  
+A: 在 [holysheep.ai](https://holysheep.ai) 注册后，在「API 密钥」页面创建，格式为 `cr_xxx`。
 
 **Q: 支持 Windows 吗？**  
-A: 支持，需要 Node.js 16+。环境变量会写入用户目录下的 shell 配置文件。
+A: 支持，需要 Node.js 16+。如果 `hs` 命令找不到，请重启终端，或直接用 `npx @simonyea/holysheep-cli@latest setup`。
 
 **Q: 如何恢复原来的配置？**  
-A: 运行 `hs reset` 即可清除所有 HolySheep 相关配置。
+A: 运行 `hs reset` 清除所有 HolySheep 相关配置。
+
+**Q: OpenClaw 安装失败？**  
+A: OpenClaw 需要 Node.js 22+，运行 `node --version` 确认版本后重试。
 
 ---
 
 ## License
 
-MIT © [HolySheep](https://shop.holysheep.ai)
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simonyea/holysheep-cli",
-  "version": "1.1.6",
+  "version": "1.1.8",
   "description": "一键配置所有 AI 编程工具接入 HolySheep API — Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw / Aider / Cursor",
   "keywords": [
     "claude",

package/src/commands/setup.js

@@ -51,6 +51,9 @@ async function tryAutoInstall(tool) {
     if (process.platform !== 'win32' && !tool.checkInstalled()) {
       console.log(chalk.yellow(`  ⚠ 安装后未检测到命令，尝试直接配置...`))
     }
+    if (process.platform === 'win32') {
+      tool._winJustInstalled = true  // 标记为 Windows 刚装的，摘要里特殊处理
+    }
     return true  // 安装成功就视为可配置
   } catch (e) {
     spinner.fail(`安装失败: ${e.message}`)
@@ -234,6 +237,24 @@ async function setup(options) {
       const hot = r.result?.hot ? chalk.cyan(' (热切换，无需重启)') : chalk.gray(' (重启终端生效)')
       console.log(`  ✓ ${r.tool.name}${hot}`)
       if (r.tool.hint) console.log(`    ${chalk.gray('💡 ' + r.tool.hint)}`)
+      // 显示启动命令
+      if (r.tool.launchCmd) {
+        if (r.tool._winJustInstalled) {
+          // Windows 刚安装：PATH 未刷新，提示用 npx 或重开终端
+          console.log(`    ${chalk.yellow('▶  Windows：新开一个终端后运行:')} ${chalk.cyan.bold(r.tool.launchCmd)}`)
+          const cmdBin = r.tool.launchCmd.split(' ')[0]
+          const cmdArgs = r.tool.launchCmd.split(' ').slice(1).join(' ')
+          console.log(`    ${chalk.gray('   或现在用 npx 直接运行:')} ${chalk.cyan.bold('npx ' + cmdBin + (cmdArgs ? ' ' + cmdArgs : ''))}`)
+          if (r.tool.launchNote) console.log(`    ${chalk.gray('   ' + r.tool.launchNote)}`)
+        } else {
+          console.log(`    ${chalk.gray('▶  启动命令:')} ${chalk.cyan.bold(r.tool.launchCmd)}`)
+        }
+      } else if (r.tool.launchNote) {
+        console.log(`    ${chalk.gray('▶  ' + r.tool.launchNote)}`)
+      }
+      if (r.tool.launchNote && r.tool.launchCmd && !r.tool._winJustInstalled) {
+        console.log(`    ${chalk.gray('   ' + r.tool.launchNote)}`)
+      }
     })
     console.log()
   }

package/src/tools/aider.js

@@ -66,6 +66,7 @@ model: openai/claude-sonnet-4-5
   },
   getConfigPath() { return CONFIG_FILE },
   hint: '也可用 aider --openai-api-base https://api.holysheep.ai/v1',
+  launchCmd: 'aider',
   installCmd: 'pip install aider-chat',
   docsUrl: 'https://aider.chat',
   // Aider 优先用环境变量

package/src/tools/claude-code.js

@@ -64,6 +64,7 @@ module.exports = {
   },
   getConfigPath() { return SETTINGS_FILE },
   hint: '支持热切换，无需重启终端',
+  launchCmd: 'claude',
   installCmd: 'npm install -g @anthropic-ai/claude-code',
   docsUrl: 'https://docs.anthropic.com/claude-code',
 }

package/src/tools/codex.js

@@ -154,6 +154,7 @@ module.exports = {
   },
   getConfigPath() { return CONFIG_FILE },
   hint: '切换后重开终端生效；Rust Codex (v0.111+) 使用 config.toml',
+  launchCmd: 'codex',
   installCmd: 'npm install -g @openai/codex',
   docsUrl: 'https://github.com/openai/codex',
   envVarFormat: 'openai',

package/src/tools/continue.js

@@ -139,6 +139,8 @@ module.exports = {
   },
   getConfigPath() { return fs.existsSync(CONFIG_YAML) ? CONFIG_YAML : CONFIG_JSON },
   hint: '新版使用 config.yaml；配置后在 VS Code Continue 面板选择 HolySheep 模型',
+  launchCmd: null,  // VS Code 插件，在编辑器内使用
+  launchNote: '在 VS Code 侧边栏打开 Continue 面板即可使用',
   installCmd: 'VS Code 插件市场搜索 "Continue"',
   docsUrl: 'https://continue.dev',
 }

package/src/tools/openclaw.js

@@ -98,6 +98,8 @@ module.exports = {
   },
   getConfigPath() { return CONFIG_FILE },
   hint: '切换后重启 OpenClaw 生效；支持 /model 命令切换模型',
+  launchCmd: 'openclaw dashboard',
+  launchNote: '启动后访问 http://127.0.0.1:18789/ 打开 WebUI',
   installCmd: 'npm install -g openclaw@latest',
   docsUrl: 'https://docs.openclaw.ai',
 }

package/src/tools/opencode.js

@@ -122,6 +122,7 @@ module.exports = {
   },
   getConfigPath() { return getConfigFile() },
   hint: '切换后重启 OpenCode 生效；配置文件: ~/.config/opencode/opencode.json',
+  launchCmd: 'opencode',
   installCmd: 'brew install anomalyco/tap/opencode  # 或: npm i -g opencode-ai@latest',
   docsUrl: 'https://opencode.ai',
 }