@simonyea/holysheep-cli 1.0.8 → 1.1.0

package/README.md

@@ -34,16 +34,20 @@ Instead of manually editing config files and environment variables for each tool
 
 ### Supported Tools
 
-| Tool | Install | Config Method | Hot Reload |
-|------|---------|---------------|-----------|
-| [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) | Download from website | `~/.openclaw/settings.json` | ✅ |
-| [Aider](https://aider.chat) | `pip install aider-chat` | `~/.aider.conf.yml` | — |
-| [Cursor](https://cursor.sh) | Download from website | GUI guided setup | — |
-| [Continue.dev](https://continue.dev) | VS Code marketplace | `~/.continue/config.json` | ✅ |
+| 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://github.com/sst/opencode) | `npm i -g opencode-ai` | `~/.config/opencode/config.json` | ✅ Auto |
+| [OpenClaw](https://github.com/iOfficeAI/AionUi) | Download from website | `~/.openclaw/settings.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.
+>
+> **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).
 
 ### Installation
 
@@ -124,16 +128,20 @@ HolySheep 是面向中国开发者的 Claude/GPT/Gemini 官方 API 中转服务
 
 ### 支持的工具
 
-| 工具 | 安装方式 | 配置方式 | 热切换 |
-|------|---------|---------|-------|
-| [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` | ✅ |
+| 工具 | 安装方式 | 配置方式 | 状态 |
+|------|---------|---------|------|
+| [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://github.com/sst/opencode) | `npm i -g opencode-ai` | `~/.config/opencode/config.json` | ✅ 自动 |
+| [OpenClaw](https://github.com/iOfficeAI/AionUi) | 官网下载 | `~/.openclaw/settings.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` 手动填入。
+>
+> **关于 Gemini CLI**：Gemini CLI 使用 Google 专有协议，不支持自定义中转地址。需使用从 [aistudio.google.com](https://aistudio.google.com/apikey) 获取的 Google Gemini API Key。
 
 ### 安装
 

package/package.json

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

package/src/commands/setup.js

@@ -174,6 +174,11 @@ async function setup(options) {
         spinner.info(`${chalk.yellow(tool.name)} 需要手动配置:`)
         result.steps.forEach((s, i) => console.log(`  ${chalk.gray(i + 1 + '.')} ${s}`))
         results.push({ tool, status: 'manual' })
+      } else if (result.warning) {
+        if (result.envVars) Object.assign(envVarsToWrite, result.envVars)
+        spinner.warn(`${chalk.yellow(tool.name)} ${chalk.gray(result.file ? `→ ${result.file}` : '')}`)
+        console.log(chalk.yellow(`  ⚠️  ${result.warning}`))
+        results.push({ tool, status: 'warning', result })
       } else {
         if (result.envVars) Object.assign(envVarsToWrite, result.envVars)
         spinner.succeed(`${chalk.green(tool.name)} ${chalk.gray(result.file ? `→ ${result.file}` : '')}`)

package/src/tools/cursor.js

@@ -1,18 +1,18 @@
 /**
  * Cursor 适配器
- * Cursor 是基于 VSCode 的 AI 编辑器
  *
- * Cursor 自定义 API 配置路径:
- *   Settings > Cursor > Models > Custom API Key
- *   实际存储在: ~/Library/Application Support/Cursor/User/globalStorage/cursor.secretStorage/...
+ * ⚠️ 重要：Cursor 新版本（2025+）必须登录官方账号才能使用，
+ * 即使是「自带 API Key」模式也需要先登录 Cursor 账号。
+ * Cursor 的 API Key 和 Base URL 存储在加密的 secret storage 中，
+ * CLI 无法直接写入，且官方越来越绑定自己的账号体系。
  *
- * 由于 Cursor 的 API 配置在加密的 secret storage 中，CLI 无法直接写入，
- * 因此本适配器采用以下方式:
- *   1. 打印详细的手动配置引导
- *   2. 写入环境变量（部分 Cursor 功能如 API playground 会读取）
- *   3. 生成 .cursor/mcp.json 供 Cursor MCP 功能使用
+ * 推荐替代方案：
+ * - Continue（VS Code/JetBrains 插件，完全支持自定义 API）
+ * - Claude Code（命令行，官方支持自定义 base_url）
+ * - Aider（命令行，完全支持自定义 API）
  *
- * Cursor OpenAI 兼容格式: 在 Settings > Models 中填入 base URL 和 API Key
+ * 如果仍要手动配置 Cursor：
+ * Settings → Models → Override OpenAI Base URL + OpenAI API Key
  */
 const fs = require('fs')
 const path = require('path')
@@ -39,31 +39,33 @@ module.exports = {
   id: 'cursor',
   checkInstalled() { return checkCursorInstalled() },
   isConfigured() {
-    // Cursor 配置在加密存储中，无法直接读取，只检查环境变量
-    return !!(process.env.OPENAI_API_KEY && process.env.OPENAI_BASE_URL?.includes('holysheep'))
+    return false // 无法检测（加密存储）
   },
-  configure(apiKey, baseUrlOpenAI) {
-    // Cursor 无法通过文件直接写入 API Key（加密存储），
-    // 返回 manual 标志，setup 命令会打印引导信息
+  configure(apiKey, _baseUrlAnthropicNoV1, baseUrlOpenAI) {
+    // Cursor 需要登录官方账号，且 API Key 存储在加密区域，CLI 无法写入
+    // 返回 manual + warning
     return {
       manual: true,
       steps: [
-        '打开 Cursor → Settings（⌘+,）→ 搜索 "Models"',
-        '找到 "OpenAI API Key" 或 "Custom API" 区域',
+        '⚠️  Cursor 新版本需要先登录官方账号（免费账号即可）',
+        '打开 Cursor → Settings（⌘+, / Ctrl+,）→ 左侧 Models',
+        '找到 "OpenAI API Key" 区域，勾选 "Enable OpenAI API Key"',
         `填入 API Key: ${apiKey}`,
-        `填入 Base URL（Override OpenAI Base URL）: ${baseUrlOpenAI}`,
-        '点击 "Verify" 验证连接',
-        '在模型列表中选择 claude-sonnet-4-5 或 claude-opus-4-5',
+        `填入 Override OpenAI Base URL: ${baseUrlOpenAI}`,
+        '点击 "Verify" 验证连接，然后在模型列表中选择 claude-* 模型',
+        '💡 推荐使用 Continue（VS Code 插件）替代，配置更简单',
       ],
-      imageHint: '💡 Cursor Settings → Models → Override OpenAI Base URL',
     }
   },
   reset() {
-    // 提示手动清除
-    return { manual: true, steps: ['打开 Cursor Settings → Models → 清除 API Key 和 Base URL'] }
+    return {
+      manual: true,
+      steps: ['打开 Cursor Settings → Models → 清除 API Key 和 Override Base URL'],
+    }
   },
   getConfigPath() { return getCursorUserDir() },
-  hint: '需要在 Cursor GUI 中手动配置（API Key 存储在加密区域）',
+  hint: '需要登录 Cursor 账号 + 在 GUI 中手动配置（推荐用 Continue 替代）',
   installCmd: '访问 https://cursor.sh 下载安装',
   docsUrl: 'https://cursor.sh',
+  unsupported: true,
 }

package/src/tools/gemini-cli.js

@@ -1,23 +1,22 @@
 /**
  * Gemini CLI 适配器 (@google/gemini-cli)
  *
- * Gemini CLI 目前不原生支持自定义 base_url，
- * 但可通过以下方式接入 OpenAI 兼容端点:
+ * ⚠️ 重要：Gemini CLI 不支持自定义 base_url/中继
+ * 它只能连接 Google 官方 Gemini API。
  *
- * 方式 A（推荐）: 写入 ~/.gemini/settings.json 中的 otherAIProvider
- *   支持 openaiCompatible 类型，需要 Gemini CLI >= 0.20
+ * 配置方式：
+ * 1. settings.json 写入 selectedAuthType = "gemini-api-key"（跳过登录向导）
+ * 2. 设置环境变量 GEMINI_API_KEY（需要 Google Gemini API Key，从 aistudio.google.com 获取）
  *
- * 方式 B: 通过 GEMINI_API_KEY 环境变量 + GOOGLE_API_KEY 覆盖
- *   （仅适用于少数版本）
- *
- * 实际测试: Gemini CLI 0.30.0 支持 otherAIProvider 配置
- * 参考: https://github.com/google-gemini/gemini-cli/blob/main/docs/configuration.md
+ * HolySheep 暂不支持 Gemini CLI 中继（Gemini CLI 使用 Google 专有协议，非 OpenAI 兼容格式）
+ * 建议用户使用 Claude Code / Codex / Aider 等支持中继的工具。
  */
-const fs = require('fs')
+const fs   = require('fs')
 const path = require('path')
-const os = require('os')
+const os   = require('os')
 
-const SETTINGS_FILE = path.join(os.homedir(), '.gemini', 'settings.json')
+const GEMINI_DIR     = path.join(os.homedir(), '.gemini')
+const SETTINGS_FILE  = path.join(GEMINI_DIR, 'settings.json')
 
 function readSettings() {
   try {
@@ -29,42 +28,55 @@ function readSettings() {
 }
 
 function writeSettings(data) {
-  const dir = path.dirname(SETTINGS_FILE)
-  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+  if (!fs.existsSync(GEMINI_DIR)) fs.mkdirSync(GEMINI_DIR, { recursive: true })
   fs.writeFileSync(SETTINGS_FILE, JSON.stringify(data, null, 2), 'utf8')
 }
 
 module.exports = {
   name: 'Gemini CLI',
   id: 'gemini-cli',
+
   checkInstalled() {
     return require('../utils/which').commandExists('gemini')
   },
+
   isConfigured() {
+    // 检查是否设置了 GEMINI_API_KEY 环境变量
+    if (process.env.GEMINI_API_KEY) return true
+    // 检查 settings.json 是否已跳过向导
     const s = readSettings()
-    return !!(s.otherAIProvider?.url?.includes('holysheep'))
+    return s.selectedAuthType === 'gemini-api-key'
   },
-  configure(apiKey, baseUrlOpenAI) {
+
+  configure(apiKey, _baseUrlAnthropicNoV1, _baseUrlOpenAI) {
+    // Gemini CLI 不支持 HolySheep 中继，只能配置为使用官方 Gemini API Key 模式
+    // 写入 settings.json 跳过认证向导
     const settings = readSettings()
+    settings.selectedAuthType = 'gemini-api-key'
+    writeSettings(settings)
 
-    // Gemini CLI 的 otherAIProvider 支持 OpenAI 兼容格式
-    settings.otherAIProvider = {
-      url: baseUrlOpenAI,   // 带 /v1
-      apiKey: apiKey,
-      model: 'claude-sonnet-4-5',  // 默认推荐模型
+    // 环境变量：GEMINI_API_KEY 需要用户自己的 Google Gemini API Key
+    // HolySheep API Key (cr_xxx) 无法用于 Gemini CLI
+    return {
+      file: SETTINGS_FILE,
+      hot: false,
+      // 不注入 GEMINI_API_KEY，因为 HolySheep key 对 Gemini CLI 无效
+      // 用户需要手动设置真正的 Gemini API Key
+      envVars: {},
+      warning: 'Gemini CLI 需要 Google 官方 Gemini API Key，无法使用 HolySheep 中继。\n请从 https://aistudio.google.com/apikey 获取 API Key 后设置环境变量：\n  export GEMINI_API_KEY="your-google-api-key"',
     }
-
-    // 同时保留原有 general 配置
-    writeSettings(settings)
-    return { file: SETTINGS_FILE, hot: false }
   },
+
   reset() {
     const settings = readSettings()
-    delete settings.otherAIProvider
+    delete settings.selectedAuthType
     writeSettings(settings)
   },
+
   getConfigPath() { return SETTINGS_FILE },
-  hint: '使用 gemini -m claude-sonnet-4-5 指定模型',
+  hint: 'Gemini CLI 不支持 HolySheep 中继，需使用 Google 官方 Gemini API Key',
   installCmd: 'npm install -g @google/gemini-cli',
   docsUrl: 'https://github.com/google-gemini/gemini-cli',
+  envVarFormat: 'gemini',
+  unsupported: true, // 标记为不支持中继
 }