@simonyea/holysheep-cli 1.0.0

package/README.md

@@ -0,0 +1,159 @@
+# 🐑 HolySheep CLI
+
+> 一键配置所有 AI 编程工具接入 HolySheep API — 国内直连，¥1=$1，无需魔法
+
+[![npm version](https://img.shields.io/npm/v/holysheep-cli)](https://www.npmjs.com/package/holysheep-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey)](https://github.com/holysheep-ai/cli)
+
+**HolySheep CLI** 让你用一条命令，把 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、Aider、Cursor、Continue.dev 全部接入 [HolySheep API](https://shop.holysheep.ai)。
+
+无需逐个工具手动配置环境变量和配置文件，一键搞定。
+
+---
+
+## 安装
+
+```bash
+npm install -g holysheep-cli
+```
+
+或者无需安装直接运行：
+
+```bash
+npx holysheep-cli setup
+```
+
+---
+
+## 快速开始
+
+### 第一步：注册账号，获取 API Key
+
+前往 **[shop.holysheep.ai](https://shop.holysheep.ai)** 注册账号，充值后在「API 密钥」页面创建 `cr_xxx` 格式的密钥。
+
+> 💡 ¥1 = $1 美元额度，余额永久有效，按量计费
+
+### 第二步：一键配置
+
+```bash
+hs setup
+```
+
+按提示选择要配置的工具，输入 API Key，完成！
+
+```
+🐑  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
+
+✅ 配置完成！
+```
+
+---
+
+## 命令
+
+| 命令 | 说明 |
+|------|------|
+| `hs setup` | 一键配置所有 AI 工具 |
+| `hs doctor` | 检查配置状态和连通性 |
+| `hs balance` | 查看账户余额和用量 |
+| `hs tools` | 列出所有支持的工具 |
+| `hs reset` | 清除所有配置，恢复默认 |
+
+---
+
+## 支持的工具
+
+| 工具 | 安装方式 | 配置方式 | 热切换 |
+|------|---------|---------|-------|
+| **[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.yaml` + 环境变量 | — |
+| **[Gemini CLI](https://github.com/google-gemini/gemini-cli)** | `npm i -g @google/gemini-cli` | `~/.gemini/settings.json` | — |
+| **[OpenCode](https://github.com/sst/opencode)** | `npm i -g opencode-ai` | `~/.config/opencode/config.json` | — |
+| **[OpenClaw](https://github.com/iOfficeAI/AionUi)** | 官网下载 | `~/.openclaw/settings.json` | ✅ |
+| **[Aider](https://aider.chat)** | `pip install aider-chat` | `~/.aider.conf.yml` + 环境变量 | — |
+| **[Cursor](https://cursor.sh)** | 官网下载 | GUI 配置引导 | — |
+| **[Continue.dev](https://continue.dev)** | VS Code 插件市场 | `~/.continue/config.json` | ✅ |
+
+---
+
+## 接入信息
+
+| 用途 | 地址 |
+|------|------|
+| Anthropic SDK / Claude Code | `https://api.holysheep.ai` （不带 /v1） |
+| OpenAI 兼容 / Codex / Aider | `https://api.holysheep.ai/v1` （带 /v1） |
+
+---
+
+## 手动配置参考
+
+如果你不想用 CLI，也可以手动配置：
+
+### Claude Code
+```bash
+# ~/.claude/settings.json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "cr_xxx",
+    "ANTHROPIC_BASE_URL": "https://api.holysheep.ai"
+  }
+}
+```
+
+### 环境变量（适用于所有工具）
+```bash
+export ANTHROPIC_API_KEY="cr_xxx"
+export ANTHROPIC_BASE_URL="https://api.holysheep.ai"
+export OPENAI_API_KEY="cr_xxx"
+export OPENAI_BASE_URL="https://api.holysheep.ai/v1"
+```
+
+### Codex CLI (`~/.codex/config.yaml`)
+```yaml
+providers:
+  - name: HolySheep
+    baseURL: https://api.holysheep.ai/v1
+    envKey: OPENAI_API_KEY
+model: claude-sonnet-4-5
+```
+
+### Aider
+```bash
+aider --openai-api-base https://api.holysheep.ai/v1 \
+      --openai-api-key cr_xxx \
+      --model openai/claude-sonnet-4-5
+```
+
+---
+
+## 常见问题
+
+**Q: 支持哪些模型？**  
+A: 支持 Claude 3.5/3.7 全系、GPT-4o、Gemini 1.5 Pro 等主流模型，详见 [shop.holysheep.ai/app/apikeys](https://shop.holysheep.ai/app/apikeys)
+
+**Q: 国内能直接用吗？**  
+A: 能，`api.holysheep.ai` 国内直连，无需代理。
+
+**Q: API Key 格式是什么？**  
+A: `cr_` 开头的字符串，在控制台「API 密钥」页面创建。
+
+**Q: 和官方 API 有什么区别？**  
+A: 直接对接官方 API，无任何阉割，汇率 ¥1=$1 全网最优。
+
+---
+
+## License
+
+MIT © [HolySheep](https://shop.holysheep.ai)

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@simonyea/holysheep-cli",
+  "version": "1.0.0",
+  "description": "一键配置所有 AI 编程工具接入 HolySheep API — Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw / Aider / Cursor",
+  "keywords": [
+    "claude",
+    "codex",
+    "gemini",
+    "cursor",
+    "aider",
+    "opencode",
+    "openclaw",
+    "api",
+    "relay",
+    "china",
+    "holysheep",
+    "ai",
+    "coding"
+  ],
+  "homepage": "https://shop.holysheep.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/holysheep123/holysheep-cli"
+  },
+  "license": "MIT",
+  "bin": {
+    "hs": "src/index.js",
+    "holysheep": "src/index.js"
+  },
+  "type": "commonjs",
+  "main": "src/index.js",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "inquirer": "^8.2.6",
+    "node-fetch": "^2.7.0",
+    "ora": "^5.4.1"
+  }
+}

package/src/commands/balance.js

@@ -0,0 +1,56 @@
+/**
+ * hs balance — 查看账户余额和今日用量
+ */
+const chalk = require('chalk')
+const ora   = require('ora')
+const { getApiKey, SHOP_URL } = require('../utils/config')
+
+async function balance() {
+  const apiKey = getApiKey()
+  if (!apiKey) {
+    console.log(chalk.red('\n未找到 API Key，请先运行: hs setup\n'))
+    return
+  }
+
+  const spinner = ora('获取账户信息...').start()
+  try {
+    const fetch = require('node-fetch')
+    // shop 的 /api/stats/overview 需要 JWT，这里通过 /internal 接口查余额
+    // 或者通过 shop API 查询
+    const res = await fetch(`${SHOP_URL}/api/stats/overview`, {
+      headers: { 'Authorization': `Bearer ${apiKey}` },
+      timeout: 8000,
+    })
+
+    if (res.status === 401) {
+      spinner.fail('API Key 无效或已过期，请重新登录')
+      return
+    }
+
+    if (!res.ok) {
+      spinner.fail(`请求失败 (HTTP ${res.status})`)
+      return
+    }
+
+    const data = await res.json()
+    spinner.stop()
+
+    console.log()
+    console.log(chalk.bold('💰  账户余额'))
+    console.log(chalk.gray('━'.repeat(40)))
+    console.log()
+    console.log(`  ${chalk.cyan('余额')}       $${chalk.bold(Number(data.balance || 0).toFixed(4))}`)
+    console.log(`  ${chalk.cyan('今日消费')}   $${Number(data.todayCost || 0).toFixed(4)}`)
+    console.log(`  ${chalk.cyan('本月消费')}   $${Number(data.monthCost || 0).toFixed(4)}`)
+    console.log(`  ${chalk.cyan('累计调用')}   ${(data.totalCalls || 0).toLocaleString()} 次`)
+    console.log()
+    console.log(chalk.gray(`充值: ${SHOP_URL}/app/recharge`))
+    console.log()
+
+  } catch (e) {
+    spinner.fail(`获取失败: ${e.message}`)
+    console.log(chalk.gray(`\n请前往 ${SHOP_URL} 查看账户信息`))
+  }
+}
+
+module.exports = balance

package/src/commands/doctor.js

@@ -0,0 +1,109 @@
+/**
+ * hs doctor — 检查所有工具的配置状态
+ */
+const chalk = require('chalk')
+const { execSync } = require('child_process')
+const { getApiKey, BASE_URL_ANTHROPIC, BASE_URL_OPENAI } = require('../utils/config')
+const TOOLS = require('../tools')
+
+async function doctor() {
+  console.log()
+  console.log(chalk.bold('🔍  HolySheep Doctor — 环境检查'))
+  console.log(chalk.gray('━'.repeat(50)))
+  console.log()
+
+  // Node.js 版本
+  const nodeVer = process.version
+  const nodeOk = parseInt(nodeVer.slice(1)) >= 16
+  printCheck(nodeOk, `Node.js ${nodeVer}`, nodeOk ? '' : '需要 >= 16')
+
+  // API Key
+  const apiKey = getApiKey()
+  printCheck(!!apiKey, 'API Key', apiKey ? maskKey(apiKey) : `未设置 — 运行 ${chalk.cyan('hs setup')} 配置`)
+
+  // 环境变量
+  const envAnthropicKey = process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN
+  const envOpenAIKey    = process.env.OPENAI_API_KEY
+  const envAnthropicUrl = process.env.ANTHROPIC_BASE_URL
+  const envOpenAIUrl    = process.env.OPENAI_BASE_URL
+
+  console.log()
+  console.log(chalk.bold('环境变量:'))
+  printCheck(!!envAnthropicKey, 'ANTHROPIC_API_KEY / AUTH_TOKEN', envAnthropicKey ? maskKey(envAnthropicKey) : '未设置')
+  printCheck(!!envAnthropicUrl, 'ANTHROPIC_BASE_URL', envAnthropicUrl || '未设置')
+  printCheck(!!envOpenAIKey,    'OPENAI_API_KEY',     envOpenAIKey ? maskKey(envOpenAIKey) : '未设置')
+  printCheck(!!envOpenAIUrl,    'OPENAI_BASE_URL',    envOpenAIUrl || '未设置')
+
+  // 各工具检查
+  console.log()
+  console.log(chalk.bold('工具状态:'))
+
+  for (const tool of TOOLS) {
+    const installed  = tool.checkInstalled()
+    const configured = installed ? tool.isConfigured() : null
+    const version    = installed ? getVersion(tool.id) : null
+
+    if (!installed) {
+      console.log(`  ${chalk.gray('○')} ${chalk.gray(tool.name.padEnd(20))} ${chalk.gray('未安装')} ${chalk.gray(`— ${tool.installCmd}`)}`)
+    } else if (configured) {
+      console.log(`  ${chalk.green('✓')} ${chalk.green(tool.name.padEnd(20))} ${chalk.gray(version || '已安装')} ${chalk.green('已配置 HolySheep')}`)
+    } else {
+      console.log(`  ${chalk.yellow('!')} ${chalk.yellow(tool.name.padEnd(20))} ${chalk.gray(version || '已安装')} ${chalk.yellow('未配置')} ${chalk.gray(`— 运行 hs setup`)}`)
+    }
+  }
+
+  console.log()
+
+  // 连通性测试（可选）
+  if (apiKey) {
+    process.stdout.write(chalk.gray('测试 API 连通性... '))
+    try {
+      const fetch = require('node-fetch')
+      const res = await fetch(`${BASE_URL_ANTHROPIC}/v1/models`, {
+        headers: { 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' },
+        timeout: 8000,
+      })
+      if (res.ok) {
+        const data = await res.json()
+        const count = data.data?.length || '?'
+        console.log(chalk.green(`✓ 连通 (${count} 个模型可用)`))
+      } else {
+        console.log(chalk.red(`✗ 失败 (HTTP ${res.status})`))
+      }
+    } catch (e) {
+      console.log(chalk.red(`✗ 连接失败: ${e.message}`))
+    }
+  }
+
+  console.log()
+}
+
+function printCheck(ok, label, detail = '') {
+  const icon   = ok ? chalk.green('✓') : chalk.red('✗')
+  const lbl    = ok ? chalk.green(label.padEnd(35)) : chalk.red(label.padEnd(35))
+  const det    = detail ? chalk.gray(detail) : ''
+  console.log(`  ${icon} ${lbl} ${det}`)
+}
+
+function maskKey(key) {
+  if (!key || key.length < 8) return '****'
+  return key.slice(0, 6) + '...' + key.slice(-4)
+}
+
+function getVersion(toolId) {
+  const cmds = {
+    'claude-code': 'claude --version',
+    'codex':       'codex --version',
+    'gemini-cli':  'gemini --version',
+    'opencode':    'opencode --version',
+    'openclaw':    'openclaw --version',
+    'aider':       'aider --version',
+  }
+  const cmd = cmds[toolId]
+  if (!cmd) return null
+  try {
+    return execSync(cmd, { stdio: 'pipe' }).toString().trim().split('\n')[0].slice(0, 30)
+  } catch { return null }
+}
+
+module.exports = doctor

package/src/commands/reset.js

@@ -0,0 +1,53 @@
+/**
+ * hs reset — 清除所有工具的 HolySheep 配置，恢复默认
+ */
+const inquirer = require('inquirer')
+const chalk    = require('chalk')
+const ora      = require('ora')
+const { removeEnvFromShell } = require('../utils/shell')
+const { saveConfig } = require('../utils/config')
+const TOOLS = require('../tools')
+
+async function reset(options) {
+  console.log()
+  if (!options.yes) {
+    const { confirm } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'confirm',
+      message: chalk.yellow('将清除所有工具的 HolySheep 配置和环境变量，继续？'),
+      default: false,
+    }])
+    if (!confirm) { console.log('已取消\n'); return }
+  }
+
+  console.log()
+  for (const tool of TOOLS) {
+    if (!tool.checkInstalled() && !tool.isConfigured?.()) continue
+    const spinner = ora(`清除 ${tool.name}...`).start()
+    try {
+      tool.reset()
+      spinner.succeed(`${tool.name} 已清除`)
+    } catch (e) {
+      spinner.fail(`${tool.name}: ${e.message}`)
+    }
+  }
+
+  // 清除 shell 环境变量
+  const spinner = ora('清除 shell 环境变量...').start()
+  try {
+    const cleaned = removeEnvFromShell()
+    if (cleaned.length) spinner.succeed(`已清除: ${cleaned.join(', ')}`)
+    else spinner.info('无 shell 环境变量需要清除')
+  } catch (e) {
+    spinner.fail(e.message)
+  }
+
+  // 清除本地保存的 API Key
+  saveConfig({ apiKey: '' })
+
+  console.log()
+  console.log(chalk.green('✅ 清除完成，所有工具已恢复默认配置'))
+  console.log(chalk.gray('重新配置: hs setup\n'))
+}
+
+module.exports = reset

package/src/commands/setup.js

@@ -0,0 +1,155 @@
+/**
+ * hs setup — 一键配置所有 AI 工具接入 HolySheep API
+ */
+const inquirer  = require('inquirer')
+const chalk     = require('chalk')
+const ora       = require('ora')
+const { saveConfig, getApiKey, BASE_URL_ANTHROPIC, BASE_URL_OPENAI, SHOP_URL } = require('../utils/config')
+const { writeEnvToShell } = require('../utils/shell')
+const TOOLS = require('../tools')
+
+const TOOL_CHOICES = TOOLS.map(t => ({
+  name: `${t.checkInstalled() ? chalk.green('●') : chalk.gray('○')}  ${t.name.padEnd(18)} ${t.checkInstalled() ? chalk.gray('(已安装)') : chalk.gray('(未安装)')}`,
+  value: t.id,
+  short: t.name,
+}))
+
+async function setup(options) {
+  console.log()
+  console.log(chalk.bold('🐑  HolySheep CLI — 一键配置 AI 工具'))
+  console.log(chalk.gray('━'.repeat(50)))
+  console.log()
+
+  // Step 1: 获取 API Key
+  let apiKey = options.key || getApiKey()
+
+  if (!apiKey) {
+    console.log(chalk.yellow('需要 API Key 才能配置工具。'))
+    console.log(chalk.cyan(`还没有账号？前往注册：${SHOP_URL}\n`))
+
+    const { key } = await inquirer.prompt([{
+      type: 'password',
+      name: 'key',
+      message: 'API Key (cr_xxx):',
+      validate: v => v.startsWith('cr_') ? true : '请输入以 cr_ 开头的 API Key',
+    }])
+    apiKey = key
+  } else {
+    console.log(`${chalk.green('✓')} 使用已保存的 API Key: ${chalk.cyan(maskKey(apiKey))}`)
+  }
+
+  // Step 2: 选择工具
+  const { toolIds } = await inquirer.prompt([{
+    type: 'checkbox',
+    name: 'toolIds',
+    message: '选择要配置的工具（空格选中，回车确认）:',
+    choices: [
+      new inquirer.Separator('── 已安装 ──'),
+      ...TOOL_CHOICES.filter((_, i) => TOOLS[i].checkInstalled()),
+      new inquirer.Separator('── 未安装 ──'),
+      ...TOOL_CHOICES.filter((_, i) => !TOOLS[i].checkInstalled()),
+    ],
+    pageSize: 12,
+  }])
+
+  if (toolIds.length === 0) {
+    console.log(chalk.yellow('\n未选择任何工具，退出。'))
+    return
+  }
+
+  console.log()
+
+  // Step 3: 配置每个工具
+  const selectedTools = TOOLS.filter(t => toolIds.includes(t.id))
+  const envVarsToWrite = {}
+  const results = []
+
+  for (const tool of selectedTools) {
+    const spinner = ora(`配置 ${tool.name}...`).start()
+    try {
+      const result = tool.configure(apiKey, BASE_URL_ANTHROPIC, BASE_URL_OPENAI)
+
+      if (result.manual) {
+        spinner.info(`${chalk.yellow(tool.name)} 需要手动配置:`)
+        result.steps.forEach((s, i) => console.log(`  ${chalk.gray(i + 1 + '.')} ${s}`))
+        results.push({ tool, status: 'manual' })
+      } else {
+        // 收集需要写入 shell 的环境变量
+        if (result.envVars) Object.assign(envVarsToWrite, result.envVars)
+        spinner.succeed(`${chalk.green(tool.name)} ${chalk.gray(result.file ? `→ ${result.file}` : '')}`)
+        results.push({ tool, status: 'ok', result })
+      }
+    } catch (e) {
+      spinner.fail(`${chalk.red(tool.name)}: ${e.message}`)
+      results.push({ tool, status: 'error', error: e.message })
+    }
+  }
+
+  // Step 4: 写入通用环境变量（如果有工具需要）
+  const needsEnvVars = selectedTools.some(t => t.id === 'codex' || t.id === 'aider')
+  if (needsEnvVars || Object.keys(envVarsToWrite).length > 0) {
+    const defaultEnv = {
+      ANTHROPIC_API_KEY: apiKey,
+      ANTHROPIC_BASE_URL: BASE_URL_ANTHROPIC,
+      OPENAI_API_KEY: apiKey,
+      OPENAI_BASE_URL: BASE_URL_OPENAI,
+    }
+    Object.assign(envVarsToWrite, defaultEnv)
+  }
+
+  if (Object.keys(envVarsToWrite).length > 0) {
+    const spinner = ora('写入环境变量到 shell 配置文件...').start()
+    try {
+      const written = writeEnvToShell(envVarsToWrite)
+      spinner.succeed(`环境变量已写入: ${written.map(f => chalk.cyan(f)).join(', ')}`)
+    } catch (e) {
+      spinner.fail(`写入环境变量失败: ${e.message}`)
+    }
+  }
+
+  // Step 5: 保存 API Key 到本地
+  saveConfig({ apiKey })
+
+  // 摘要
+  console.log()
+  console.log(chalk.bold('━'.repeat(50)))
+  console.log(chalk.green.bold('✅ 配置完成！'))
+  console.log()
+
+  const ok = results.filter(r => r.status === 'ok')
+  const manual = results.filter(r => r.status === 'manual')
+  const errors = results.filter(r => r.status === 'error')
+
+  if (ok.length) {
+    console.log(chalk.green(`已配置 ${ok.length} 个工具:`))
+    ok.forEach(r => {
+      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)}`)
+    })
+    console.log()
+  }
+
+  if (manual.length) {
+    console.log(chalk.yellow(`${manual.length} 个工具需要手动配置（见上方步骤）`))
+    console.log()
+  }
+
+  if (errors.length) {
+    console.log(chalk.red(`${errors.length} 个工具配置失败:`))
+    errors.forEach(r => console.log(`  ✗ ${r.tool.name}: ${r.error}`))
+    console.log()
+  }
+
+  console.log(chalk.gray('如需切换其他工具，运行: hs setup'))
+  console.log(chalk.gray('查看余额: hs balance'))
+  console.log(chalk.gray('检查配置: hs doctor'))
+  console.log()
+}
+
+function maskKey(key) {
+  if (!key || key.length < 8) return '****'
+  return key.slice(0, 6) + '...' + key.slice(-4)
+}
+
+module.exports = setup

package/src/index.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+'use strict'
+
+const { program } = require('commander')
+const chalk = require('chalk')
+const pkg = require('../package.json')
+
+// Banner
+function printBanner() {
+  console.log()
+  console.log(chalk.bold('🐑  ' + chalk.hex('#e8a46a')('HolySheep CLI') + '  v' + pkg.version))
+  console.log(chalk.gray('官方 Claude/GPT/Gemini API · ¥1=$1 · shop.holysheep.ai'))
+}
+
+program
+  .name('hs')
+  .description('一键配置所有 AI 编程工具接入 HolySheep API')
+  .version(pkg.version, '-v, --version')
+  .addHelpText('before', `
+🐑  HolySheep CLI v${pkg.version}
+官方 Claude / GPT / Gemini API · ¥1=$1 · https://shop.holysheep.ai
+
+支持工具: Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw · Aider · Cursor · Continue
+`)
+
+// ── setup ────────────────────────────────────────────────────────────────────
+program
+  .command('setup')
+  .description('一键配置 AI 工具接入 HolySheep API')
+  .option('-k, --key <apiKey>', '直接指定 API Key（跳过交互）')
+  .option('-a, --all', '配置所有已安装的工具（跳过选择）')
+  .action(async (opts) => {
+    printBanner()
+    await require('./commands/setup')(opts)
+  })
+
+// ── doctor ───────────────────────────────────────────────────────────────────
+program
+  .command('doctor')
+  .alias('check')
+  .description('检查环境配置和各工具状态')
+  .action(async () => {
+    await require('./commands/doctor')()
+  })
+
+// ── balance ──────────────────────────────────────────────────────────────────
+program
+  .command('balance')
+  .alias('bal')
+  .description('查看账户余额和今日用量')
+  .action(async () => {
+    await require('./commands/balance')()
+  })
+
+// ── reset ────────────────────────────────────────────────────────────────────
+program
+  .command('reset')
+  .description('清除所有 HolySheep 配置，恢复默认')
+  .option('-y, --yes', '跳过确认直接执行')
+  .action(async (opts) => {
+    await require('./commands/reset')(opts)
+  })
+
+// ── tools ────────────────────────────────────────────────────────────────────
+program
+  .command('tools')
+  .description('列出所有支持的 AI 工具')
+  .action(() => {
+    const TOOLS = require('./tools')
+    console.log()
+    console.log(chalk.bold('支持的 AI 工具:'))
+    console.log()
+    TOOLS.forEach(t => {
+      const installed = t.checkInstalled()
+      const icon = installed ? chalk.green('●') : chalk.gray('○')
+      const status = installed ? chalk.green('已安装') : chalk.gray('未安装')
+      console.log(`  ${icon} ${t.name.padEnd(20)} ${status}`)
+      console.log(`    ${chalk.gray('安装: ' + t.installCmd)}`)
+      console.log()
+    })
+  })
+
+// 默认：无命令时显示帮助 + 提示 setup
+program
+  .action(() => {
+    printBanner()
+    console.log()
+    console.log(chalk.cyan('快速开始:'))
+    console.log(`  ${chalk.bold('hs setup')}    一键配置所有 AI 工具`)
+    console.log(`  ${chalk.bold('hs doctor')}   检查配置状态`)
+    console.log(`  ${chalk.bold('hs balance')}  查看账户余额`)
+    console.log(`  ${chalk.bold('hs tools')}    查看支持的工具列表`)
+    console.log()
+    console.log(chalk.gray(`注册账号: https://shop.holysheep.ai`))
+    console.log()
+  })
+
+program.parse(process.argv)
+
+// 无参数时显示默认信息
+if (process.argv.length === 2) {
+  program.help()
+}