@2api-store/activate 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @2api-store/activate
+
+TokenShop CLI 一键激活脚本：在任意有 node 环境的终端，一行命令把本地 codex / claude / gemini / grok / opencode 等 CLI 配置为指向 2api.store 中转。
+
+## 快速开始
+
+```bash
+npx @2api-store/activate
+```
+
+按提示输入 **API Key** 或 **兑换码**，脚本会自动：
+
+1. 检测你的操作系统与已安装的 CLI
+2. 拉取适配当前系统的配置模板（运行时从服务端获取，脚本不硬编码）
+3. 备份原配置到 `<path>.bak.<时间戳>`
+4. 渲染占位符（apiKey / baseUrl / defaultModel）后写入
+5. 验证 API Key 可访问 `/v1/models`
+
+## 两种模式
+
+| 模式 | 输入 | 说明 |
+|------|------|------|
+| **API Key 模式** | `sk-...` | 已有 2api.store 的 API Key，直接配置本地 CLI |
+| **兑换码模式** | 32 字符兑换码 + 邮箱 | 邮箱已有用户则绑定，无对应用户则自动创建账号 + 发激活邮件（含初始密码）→ 消费兑换码 → 创建 API Key 绑定到兑换码指定的分组 |
+
+凭据格式自动识别：`sk-` 前缀走 Key 模式；否则按兑换码处理。
+
+## 命令行选项
+
+```
+npx @2api-store/activate [options]
+
+  --dry-run, -n          不真写配置，只展示将写入什么
+  --platform <name>      只激活指定平台（openai/anthropic/gemini/grok/antigravity）
+  --api-base <url>       覆盖 API 端点
+  -h, --help             显示帮助
+  -v, --version          显示版本
+```
+
+### 环境变量
+
+- `ACTIVATE_API_BASE`：覆盖 API 端点（同 `--api-base`）。本地开发指向 `http://127.0.0.1:5566`。
+
+### --dry-run
+
+只展示将写入哪些文件、内容预览，不真实写入、不创建备份。适合先看一下会发生什么再决定是否正式激活。
+
+```bash
+npx @2api-store/activate --dry-run
+```
+
+## 权限提示
+
+CLI 配置文件位于用户家目录（如 `~/.codex/config.toml`、`~/.claude/`）。脚本先用普通用户权限尝试写入：
+
+- **写入成功**：直接完成。
+- **权限不足**（`EACCES` / `EPERM` / `EROFS`）：脚本**不会自动 sudo**，而是明确报出目标路径与错误类型，并提示重跑方式：
+
+| 系统 | 重跑命令 |
+|------|----------|
+| macOS / Linux | `sudo npx -y @2api-store/activate` |
+| Windows | 用「管理员 PowerShell」运行 `Start-Process powershell -Verb RunAs -ArgumentList "npx,-y,@2api-store/activate"` |
+
+## 备份策略
+
+- 写入前自动备份原文件到同目录 `<path>.bak.<ISO时间戳>`（非覆盖，保留多次备份）。
+- 目标文件不存在则跳过备份。
+- 备份失败但文件存在 → 跳过该文件写入，避免无备份覆盖。
+
+## 安全
+
+- 凭据输入掩码（`***`）显示。
+- 写入的配置文件权限 `0o600`（仅属主可读写，因含 API Key）。
+- 兑换码模式创建的新账号会发送高熵随机初始密码到邮箱，请登录后尽快修改。
+- 全程不落库明文密码，不自动 sudo。
+
+## 跨平台
+
+- **macOS / Linux**：使用 `~` 展开（`$HOME`），选 `os_type=unix` 的配置。
+- **Windows**：使用 `%userprofile%` 展开，选 `os_type=windows` 的配置。
+- `os_type=all` 的配置（如环境变量导出）在两端都可选。
+- 部分"环境变量类"配置（路径为 `Terminal` / `PowerShell`）只打印 shell 命令，让用户手动执行，不写文件。
+
+## 本地开发与测试
+
+```bash
+cd cli-activate
+node --check activate.mjs && for f in lib/*.mjs; do node --check "$f" || exit 1; done
+node test/smoke.mjs    # 起本地 mock server 跑全流程（用临时 HOME + --dry-run，不碰真实配置）
+```
+
+## 退出码
+
+| 码 | 含义 |
+|----|------|
+| 0  | 成功 |
+| 1  | 输入错误 / 网络失败 / 致命错误 |
+| 2  | 部分文件权限不足（请按提示用 sudo / 管理员 PowerShell 重跑） |
+| 3  | 其他写入失败 |
+
+## License
+
+MIT © TokenShop

package/activate.mjs

@@ -0,0 +1,402 @@
+#!/usr/bin/env node
+/**
+ * @2api-store/activate — TokenShop CLI 一键激活
+ *
+ * 主流程（spec §5.2）：
+ *   1. 检测环境（OS / node / 已装 CLI）
+ *   2. 输入凭据（sk- 前缀 → API Key；否则兑换码）
+ *   3. 兑换码模式 → 补输入 email
+ *   4. POST /api/v1/cli/activate → 拿配置包
+ *   5. 按 os_type 过滤配置，展示可用 CLI 让用户多选
+ *   6. 展示可用模型让用户选 defaultModel
+ *   7. 备份 → 渲染（注入 apiKey/baseUrl/defaultModel）→ 写入（两阶段权限）
+ *   8. 验证：GET /v1/models（Bearer api_key）确认 200
+ *   9. 报告：激活清单 / 备份位置 / （新用户）查收邮件
+ */
+
+import { detectAll } from './lib/detect.mjs'
+import { cliActivate, verifyApiKey } from './lib/api.mjs'
+import { renderContent, expandPath, listModels } from './lib/render.mjs'
+import { backupFile } from './lib/backup.mjs'
+import { writeFileWithPermission, PermissionDeniedError } from './lib/write.mjs'
+import {
+  ask,
+  askSecret,
+  multiSelect,
+  select,
+  confirm,
+  closePrompt,
+} from './lib/prompt.mjs'
+
+const VERSION = '0.1.0'
+const DEFAULT_API_BASE = 'https://2api.store'
+
+const BANNER = String.raw`
+  _   _   _   _   ____    _    ____    _   _
+ | | | | | | | | / ___|  / \  | __ )  | \ | |
+ | |_| | | | | || |  _  / _ \ |  _ \  |  \| |
+ |  _  | | |_| || |_| |/ ___ \| |_) | | |\  |
+ |_| |_|  \___/ \____/_/   \_\____/  |_| \_|
+        TokenShop CLI 一键激活  v${VERSION}
+`
+
+function parseArgs(argv) {
+  const args = { dryRun: false, platform: null, _: [] }
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (a === '--dry-run' || a === '-n') {
+      args.dryRun = true
+    } else if (a === '--platform' || a === '-p') {
+      args.platform = argv[++i]
+    } else if (a === '--api-base') {
+      args.apiBase = argv[++i]
+    } else if (a === '--help' || a === '-h') {
+      args.help = true
+    } else if (a === '--version' || a === '-v') {
+      args.version = true
+    } else if (a.startsWith('--') && a.includes('=')) {
+      const [k, v] = a.slice(2).split(/=(.*)/, 2)
+      args[k] = v
+    } else if (a.startsWith('--')) {
+      args[a.replace(/^--/, '')] = argv[++i]
+    } else {
+      args._.push(a)
+    }
+  }
+  return args
+}
+
+function printHelp() {
+  console.log(`
+@2api-store/activate v${VERSION} — TokenShop CLI 一键激活
+
+用法:
+  npx @2api-store/activate [options]
+
+选项:
+  --dry-run, -n          不真写配置，只展示将写入什么
+  --platform <name>      只激活指定平台（openai/anthropic/gemini/grok/antigravity）
+  --api-base <url>       覆盖 API 端点（默认 $ACTIVATE_API_BASE 或 ${DEFAULT_API_BASE}）
+  -h, --help             显示帮助
+  -v, --version          显示版本
+
+环境变量:
+  ACTIVATE_API_BASE      覆盖 API 端点（同 --api-base）
+
+示例:
+  npx @2api-store/activate
+  npx @2api-store/activate --dry-run
+  npx @2api-store/activate --platform openai
+  ACTIVATE_API_BASE=http://127.0.0.1:5566 npx @2api-store/activate
+
+退出码:
+  0  成功
+  1  输入错误 / 网络失败 / 致命错误
+  2  部分文件权限不足（请按提示用 sudo / 管理员 PowerShell 重跑）
+  3  其他写入失败
+`.trim())
+}
+
+/**
+ * 凭据格式分流（spec §5.3）
+ *   sk- 前缀 → key
+ *   32 字符 [a-zA-Z0-9] → redeem
+ */
+function classifyCredential(cred) {
+  if (!cred) return 'empty'
+  if (cred.startsWith('sk-')) return 'key'
+  // 兑换码：16-64 字符 [a-zA-Z0-9]
+  if (/^[a-zA-Z0-9]{16,64}$/.test(cred)) return 'redeem'
+  return 'unknown'
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2))
+  if (args.help) {
+    printHelp()
+    return 0
+  }
+  if (args.version) {
+    console.log(VERSION)
+    return 0
+  }
+
+  console.log(BANNER)
+
+  // === 1. 检测环境 ===
+  const env = detectAll()
+  const osLabel = env.os.isMac
+    ? 'macOS'
+    : env.os.isLinux
+      ? 'Linux'
+      : env.os.isWindows
+        ? 'Windows'
+        : env.os.platform
+  console.log(`环境：${osLabel} · node v${env.node.version}`)
+  if (!env.node.supported) {
+    console.error(`✗ 需要 node >= 18，当前 ${env.node.version}`)
+    return 1
+  }
+  const installedNames = Object.keys(env.installed)
+  if (installedNames.length > 0) {
+    console.log(`已检测到 CLI：${installedNames.join(', ')}`)
+  } else {
+    console.log('未检测到 codex/claude/gemini/grok/opencode（不影响激活，仅参考）')
+  }
+
+  const apiBase = args.apiBase || process.env.ACTIVATE_API_BASE || DEFAULT_API_BASE
+  console.log(`API 端点：${apiBase}`)
+  if (args.dryRun) console.log('【试运行模式 --dry-run】不会真写任何文件')
+  if (args.platform) console.log(`平台过滤：${args.platform}`)
+  console.log()
+
+  // === 2. 输入凭据 ===
+  const credential = (await askSecret('请输入 API Key（sk-...）或兑换码')).trim()
+  if (!credential) {
+    console.error('✗ 未输入凭据')
+    return 1
+  }
+  const kind = classifyCredential(credential)
+  if (kind === 'unknown') {
+    console.error('✗ 凭据格式无法识别（应为 sk- 前缀的 API Key 或兑换码）')
+    return 1
+  }
+  console.log(`识别为：${kind === 'key' ? 'API Key' : '兑换码'}模式`)
+
+  // === 3. 兑换码 → 邮箱 ===
+  let email = ''
+  if (kind === 'redeem') {
+    email = (await ask('请输入邮箱（用于兑换码绑定 / 新账号创建')).trim()
+    if (!email || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
+      console.error('✗ 邮箱格式不正确')
+      return 1
+    }
+  }
+
+  // === 4. POST /cli/activate ===
+  console.log()
+  console.log('正在请求激活服务…')
+  let bundle
+  try {
+    bundle = await cliActivate({ credential, email, platform: args.platform, apiBase })
+  } catch (err) {
+    console.error(`✗ 激活失败：${err.message}`)
+    if (err.statusCode) console.error(`  HTTP ${err.statusCode}`)
+    return 1
+  }
+
+  console.log(`✓ 模式：${bundle.mode}${bundle.user?.is_new ? '（新用户已创建）' : ''}`)
+  if (bundle.user?.is_new && bundle.user?.email) {
+    console.log(`  新账号：${bundle.user.email}`)
+    if (bundle.user.message) console.log(`  ${bundle.user.message}`)
+  }
+  console.log()
+
+  // === 5. 按 os_type 过滤、展示可用 CLI ===
+  let osConfigs = (bundle.configs || []).filter((c) => {
+    if (!c) return false
+    // 客户端 --platform 二次过滤（防御性，后端已过滤）
+    if (args.platform && c.platform !== args.platform) return false
+    if (env.os.isWindows) {
+      return c.os_type === 'windows' || c.os_type === 'all'
+    }
+    return c.os_type === 'unix' || c.os_type === 'all'
+  })
+
+  if (osConfigs.length === 0) {
+    console.error('✗ 服务端未返回适配当前系统的配置模板')
+    return 1
+  }
+
+  // dedupe by platform + client_type
+  const seen = new Set()
+  const cliItems = []
+  for (const c of osConfigs) {
+    const key = `${c.platform}/${c.client_type}`
+    if (seen.has(key)) continue
+    seen.add(key)
+    const displayName = c.display_name || c.displayName || `${c.platform} ${c.client_type}`
+    cliItems.push({
+      label: `${displayName} [${c.platform}/${c.client_type}]`,
+      config: c,
+    })
+  }
+
+  console.log('可用 CLI：')
+  const selectedIdxes = await multiSelect('选择要激活的 CLI（默认全选）', cliItems, {
+    defaultSelected: cliItems.map((_, i) => i),
+  })
+  if (selectedIdxes.length === 0) {
+    console.log('未选择任何 CLI，退出。')
+    return 0
+  }
+  const selectedConfigs = selectedIdxes.map((i) => cliItems[i].config)
+  console.log()
+
+  // === 6. 选 defaultModel ===
+  const modelItems = listModels(bundle.models || [])
+  let defaultModelId = ''
+  if (modelItems.length > 0) {
+    console.log('可用模型：')
+    const selectItems = modelItems.map((m) => ({ label: `${m.label} (${m.id})` }))
+    const idx = await select('选择默认模型', selectItems, { defaultIndex: 0 })
+    defaultModelId = modelItems[idx].id
+    console.log(`已选默认模型：${defaultModelId}`)
+  } else {
+    console.warn('⚠ 服务端未返回模型列表，{{defaultModel}} 将留空')
+  }
+  console.log()
+
+  // 准备渲染值
+  const baseUrl = bundle.base_url || ''
+  const baseUrlBeta = bundle.base_url_beta || baseUrl
+  const renderValues = {
+    apiKey: bundle.api_key || '',
+    baseUrl,
+    apiBase: baseUrl, // alias
+    apiBaseBeta: baseUrlBeta,
+    antigravityApiBase: `${baseUrl}/antigravity`,
+    antigravityApiBaseBeta: `${baseUrlBeta}/antigravity`,
+    defaultModel: defaultModelId,
+  }
+
+  // === 7. 每个选中 CLI 的每个 file：备份 → 渲染 → 写入 ===
+  const report = []
+  let firstPermissionError = null
+
+  for (const cfg of selectedConfigs) {
+    const displayName =
+      cfg.display_name || cfg.displayName || `${cfg.platform} ${cfg.client_type}`
+    console.log(`── ${displayName} ──`)
+    const files = cfg.files || []
+    for (const f of files) {
+      const rawPath = f.path || ''
+      const isShellOnly = rawPath === 'Terminal' || rawPath === 'PowerShell'
+      const targetPath = isShellOnly ? rawPath : expandPath(rawPath, { isWindows: env.os.isWindows })
+      const rendered = renderContent(f.content || '', renderValues)
+
+      if (isShellOnly) {
+        console.log(`  [shell 命令，请手动执行]`)
+        console.log(rendered.split('\n').map((l) => '    ' + l).join('\n'))
+        report.push({ cli: displayName, path: rawPath, action: 'shell-only' })
+        continue
+      }
+
+      console.log(`  目标：${targetPath}`)
+
+      if (args.dryRun) {
+        console.log(`  [试运行] 不真实写入`)
+        const lines = rendered.split('\n')
+        const preview = lines.slice(0, 8).join('\n')
+        console.log('  内容预览：')
+        console.log(preview.split('\n').map((l) => '    ' + l).join('\n'))
+        if (lines.length > 8) console.log(`    ...（共 ${lines.length} 行）`)
+        report.push({ cli: displayName, path: targetPath, action: 'dry-run' })
+        console.log()
+        continue
+      }
+
+      // 备份
+      let backupPath = null
+      try {
+        backupPath = backupFile(targetPath)
+        if (backupPath) console.log(`  备份：${backupPath}`)
+      } catch (err) {
+        console.error(`  ✗ 备份失败：${err.message}（跳过此文件避免无备份覆盖）`)
+        report.push({ cli: displayName, path: targetPath, action: 'backup-failed', error: err.message })
+        continue
+      }
+
+      // 写入（两阶段权限）
+      try {
+        writeFileWithPermission(targetPath, rendered, { isWindows: env.os.isWindows })
+        console.log(`  ✓ 已写入`)
+        report.push({ cli: displayName, path: targetPath, action: 'written', backup: backupPath })
+      } catch (err) {
+        if (err instanceof PermissionDeniedError) {
+          if (!firstPermissionError) firstPermissionError = err
+          console.error(`  ✗ ${err.message}`)
+          report.push({
+            cli: displayName,
+            path: targetPath,
+            action: 'permission-denied',
+            error: err.message,
+          })
+        } else {
+          console.error(`  ✗ 写入失败：${err.message}`)
+          report.push({ cli: displayName, path: targetPath, action: 'failed', error: err.message })
+        }
+      }
+    }
+    console.log()
+  }
+
+  closePrompt()
+
+  // === 8. 验证 API Key（非 dry-run） ===
+  if (!args.dryRun && bundle.api_key && bundle.base_url) {
+    console.log('验证 API Key…')
+    const v = await verifyApiKey({ apiKey: bundle.api_key, baseUrl: bundle.base_url })
+    if (v.ok) {
+      console.log(`✓ API Key 验证通过（GET /v1/models → 200）`)
+    } else {
+      console.warn(
+        `⚠ 验证未通过：${v.error || `HTTP ${v.statusCode}`}（配置已写入，请手动检查）`,
+      )
+    }
+    console.log()
+  }
+
+  // === 9. 报告 ===
+  console.log('══════════ 激活报告 ══════════')
+  const written = report.filter((r) => r.action === 'written')
+  const failed = report.filter(
+    (r) => r.action === 'failed' || r.action === 'permission-denied' || r.action === 'backup-failed',
+  )
+  const shellOnly = report.filter((r) => r.action === 'shell-only')
+  const dryRunItems = report.filter((r) => r.action === 'dry-run')
+
+  if (args.dryRun) {
+    console.log(`[试运行] 将写入 ${dryRunItems.length} 个文件（未真实写入）`)
+  } else {
+    console.log(`已写入 ${written.length} 个文件`)
+  }
+  if (shellOnly.length > 0) {
+    console.log(`需手动执行的 shell 命令：${shellOnly.length} 项（见上方输出）`)
+  }
+  if (failed.length > 0) {
+    console.warn(`失败 ${failed.length} 项：`)
+    failed.forEach((f) => console.warn(`  - ${f.cli} ${f.path}`))
+  }
+
+  const backups = report.filter((r) => r.backup).map((r) => r.backup)
+  if (backups.length > 0) {
+    console.log(`备份位置：`)
+    backups.forEach((b) => console.log(`  - ${b}`))
+  }
+
+  if (bundle.user?.is_new) {
+    console.log()
+    console.log(`📧 新账号 ${bundle.user.email || ''} 已创建，请查收邮件获取初始密码，登录后尽快修改。`)
+  }
+
+  if (firstPermissionError) {
+    console.log()
+    console.error('部分文件权限不足，请按提示用 sudo / 管理员 PowerShell 重跑：')
+    console.error('  sudo npx -y @2api-store/activate')
+    return 2
+  }
+
+  return failed.length > 0 ? 3 : 0
+}
+
+main()
+  .then((code) => {
+    closePrompt()
+    process.exit(code || 0)
+  })
+  .catch((err) => {
+    console.error('✗ 未捕获错误：', err)
+    closePrompt()
+    process.exit(1)
+  })

package/lib/api.mjs

@@ -0,0 +1,119 @@
+import https from 'node:https'
+import http from 'node:http'
+
+const USER_AGENT = '@2api-store/activate/0.1.0'
+const DEFAULT_TIMEOUT_MS = 30000
+
+/**
+ * 发送 POST /api/v1/cli/activate 请求
+ * @param {{credential: string, email?: string, platform?: string, apiBase: string}} opts
+ * @returns {Promise<object>} 解析后的 JSON 响应
+ */
+export function cliActivate({ credential, email, platform, apiBase }) {
+  return new Promise((resolve, reject) => {
+    let url
+    try {
+      url = new URL('/api/v1/cli/activate', apiBase)
+    } catch (err) {
+      reject(new Error(`无效的 apiBase：${apiBase}（${err.message}）`))
+      return
+    }
+
+    const lib = url.protocol === 'https:' ? https : http
+    const payload = {
+      credential,
+      ...(email ? { email } : {}),
+      ...(platform ? { platform } : {}),
+    }
+    const body = JSON.stringify(payload)
+
+    const req = lib.request(
+      url,
+      {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Content-Length': Buffer.byteLength(body),
+          'User-Agent': USER_AGENT,
+        },
+        timeout: DEFAULT_TIMEOUT_MS,
+      },
+      (res) => {
+        const chunks = []
+        res.on('data', (c) => chunks.push(c))
+        res.on('end', () => {
+          const text = Buffer.concat(chunks).toString('utf8')
+          let json
+          try {
+            json = text ? JSON.parse(text) : {}
+          } catch {
+            const err = new Error(`响应非 JSON（HTTP ${res.statusCode}）：${text.slice(0, 200)}`)
+            err.statusCode = res.statusCode
+            err.raw = text
+            reject(err)
+            return
+          }
+          if (res.statusCode >= 200 && res.statusCode < 300) {
+            resolve(json)
+          } else {
+            const msg = json?.error || json?.message || `HTTP ${res.statusCode}`
+            const err = new Error(msg)
+            err.statusCode = res.statusCode
+            err.body = json
+            reject(err)
+          }
+        })
+      },
+    )
+
+    req.on('timeout', () => {
+      req.destroy(new Error(`请求超时（${DEFAULT_TIMEOUT_MS / 1000}s）— ${url.href}`))
+    })
+    req.on('error', reject)
+    req.write(body)
+    req.end()
+  })
+}
+
+/**
+ * 验证 API Key：GET {baseUrl}/v1/models（Bearer api_key），期望 200
+ * @param {{apiKey: string, baseUrl: string}} opts
+ * @returns {Promise<{ok: boolean, statusCode?: number, error?: string}>}
+ */
+export function verifyApiKey({ apiKey, baseUrl }) {
+  return new Promise((resolve) => {
+    let url
+    try {
+      url = new URL('/v1/models', baseUrl)
+    } catch {
+      resolve({ ok: false, error: `无效的 baseUrl：${baseUrl}` })
+      return
+    }
+    const lib = url.protocol === 'https:' ? https : http
+    const req = lib.request(
+      url,
+      {
+        method: 'GET',
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          'User-Agent': USER_AGENT,
+        },
+        timeout: 15000,
+      },
+      (res) => {
+        const chunks = []
+        res.on('data', (c) => chunks.push(c))
+        res.on('end', () => {
+          const ok = res.statusCode >= 200 && res.statusCode < 300
+          resolve({ ok, statusCode: res.statusCode })
+        })
+      },
+    )
+    req.on('timeout', () => {
+      req.destroy()
+      resolve({ ok: false, error: '验证请求超时（15s）' })
+    })
+    req.on('error', (err) => resolve({ ok: false, error: err.message }))
+    req.end()
+  })
+}

package/lib/backup.mjs

@@ -0,0 +1,32 @@
+import fs from 'node:fs'
+
+/**
+ * 备份目标文件到同目录 .bak.<ISO时间戳>（非覆盖，保留多次）。
+ *
+ * 行为（spec §5.4）：
+ *   - 文件不存在 → 返回 null（跳过备份）
+ *   - 文件存在且备份成功 → 返回备份路径
+ *   - 文件存在但备份失败 → 抛错（调用方应中止写入，避免无备份覆盖）
+ *
+ * @param {string} path 目标文件绝对路径
+ * @returns {string|null} 备份路径，或 null（文件不存在）
+ * @throws {Error} 文件存在但 copyFileSync 失败
+ */
+export function backupFile(path) {
+  let exists = false
+  try {
+    exists = fs.existsSync(path)
+  } catch {
+    // 无法检查存在性（权限等）— 视为不存在，best effort
+    return null
+  }
+  if (!exists) return null
+
+  // ISO 时间戳，文件名安全化（: 和 . 替换为 -）
+  const ts = new Date().toISOString().replace(/[:.]/g, '-')
+  const backupPath = `${path}.bak.${ts}`
+
+  // copyFileSync 失败会抛出 — 调用方知道文件存在且备份失败
+  fs.copyFileSync(path, backupPath)
+  return backupPath
+}

package/lib/detect.mjs

@@ -0,0 +1,77 @@
+import { spawnSync } from 'node:child_process'
+
+/**
+ * 检测操作系统
+ */
+export function detectOS() {
+  const platform = process.platform
+  const isWindows = platform === 'win32'
+  const isMac = platform === 'darwin'
+  const isLinux = platform === 'linux'
+  return {
+    platform,
+    isWindows,
+    isMac,
+    isLinux,
+    osType: isWindows ? 'windows' : 'unix',
+  }
+}
+
+/**
+ * 检测 node 版本
+ */
+export function detectNode() {
+  const version = process.versions.node
+  const major = parseInt(version.split('.')[0], 10)
+  return { version, major, supported: major >= 18 }
+}
+
+/**
+ * 已知 CLI 列表（按 spec §5.2 step 1）
+ */
+const KNOWN_CLIS = ['codex', 'claude', 'gemini', 'grok', 'opencode']
+
+/**
+ * 用 which/where 查找二进制路径
+ */
+function findBinary(name, isWindows) {
+  const cmd = isWindows ? 'where' : 'which'
+  try {
+    const result = spawnSync(cmd, [name], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: 3000,
+    })
+    if (result.status === 0 && result.stdout) {
+      const first = result.stdout.trim().split(/\r?\n/)[0]
+      return first || null
+    }
+  } catch {
+    // spawn 失败（如命令不存在），忽略
+  }
+  return null
+}
+
+/**
+ * 检测已安装的 CLI
+ * @param {boolean} isWindows
+ * @returns {Record<string, string>} name → path
+ */
+export function detectInstalledCLIs(isWindows) {
+  const installed = {}
+  for (const name of KNOWN_CLIS) {
+    const path = findBinary(name, isWindows)
+    if (path) installed[name] = path
+  }
+  return installed
+}
+
+/**
+ * 一次性检测全部环境
+ */
+export function detectAll() {
+  const os = detectOS()
+  const node = detectNode()
+  const installed = detectInstalledCLIs(os.isWindows)
+  return { os, node, installed }
+}

package/lib/prompt.mjs

@@ -0,0 +1,242 @@
+/**
+ * 提示输入模块。
+ *
+ * 两种模式：
+ *   - TTY（交互式）：readline.question，支持 askSecret 掩码。
+ *   - 非 TTY（管道/测试）：一次性把 stdin 读入按行缓冲，从队列消费。
+ *     避免 HTTP/异步操作期间 readline 把数据"吸走"导致后续 question 拿不到输入。
+ */
+
+import readline from 'node:readline'
+
+let _rl = null
+let _lineQueue = null // string[] | null（仅非 TTY 时使用）
+let _lineQueuePromise = null
+
+function isInteractive() {
+  return process.stdin.isTTY === true
+}
+
+/**
+ * 非交互模式：把 stdin 全量读入，按 \n 切成行队列。
+ * 后续 ask 从队列取；队列空时返回 undefined（视作空字符串）。
+ */
+function ensureLineQueue() {
+  if (_lineQueue) return _lineQueuePromise
+  _lineQueue = []
+  _lineQueuePromise = new Promise((resolve) => {
+    let data = ''
+    process.stdin.setEncoding('utf8')
+    process.stdin.on('data', (c) => {
+      data += c
+    })
+    process.stdin.on('end', () => {
+      // 按 \n 切，去掉末尾空行
+      const lines = data.split(/\r?\n/)
+      // 如果末尾有 \n，split 会产生一个空字符串元素；保留中间空行（用户回车默认）
+      // 去掉最后一个空元素（来自末尾 \n）
+      if (lines.length > 0 && lines[lines.length - 1] === '') lines.pop()
+      _lineQueue.push(...lines)
+      resolve()
+    })
+    // 如果 stdin 已结束（极端情况），也 resolve
+    if (process.stdin.destroyed) resolve()
+  })
+  return _lineQueuePromise
+}
+
+function getRl() {
+  if (!_rl || _rl.closed) {
+    _rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    })
+  }
+  return _rl
+}
+
+/**
+ * 关闭提示接口（退出前调用）
+ */
+export function closePrompt() {
+  if (_rl && !_rl.closed) {
+    _rl.close()
+  }
+  _rl = null
+}
+
+/**
+ * 普通文本输入
+ * @param {string} question
+ * @param {{defaultValue?: string}} [opts]
+ * @returns {Promise<string>}
+ */
+export async function ask(question, { defaultValue } = {}) {
+  const suffix = defaultValue ? ` [${defaultValue}]` : ''
+  // 非 TTY：从行队列取
+  if (!isInteractive()) {
+    await ensureLineQueue()
+    const line = _lineQueue.shift() ?? ''
+    // 模拟 prompt 输出（可读性）
+    process.stdout.write(`${question}${suffix}: ${line}\n`)
+    const v = line.trim()
+    return v || (defaultValue ?? '')
+  }
+  // TTY：readline
+  const rl = getRl()
+  return new Promise((resolve) => {
+    rl.question(`${question}${suffix}: `, (answer) => {
+      const v = (answer || '').trim()
+      resolve(v || (defaultValue ?? ''))
+    })
+  })
+}
+
+/**
+ * 隐藏输入（API Key / 敏感凭据）
+ * 非 TTY 退化为 ask（可见输入），便于测试。
+ * @param {string} question
+ * @returns {Promise<string>}
+ */
+export async function askSecret(question) {
+  // 非 TTY（含管道）→ ask
+  if (!isInteractive()) {
+    return ask(question)
+  }
+  // TTY：先关 rl（它独占 stdin），切原始模式逐字符读取
+  if (_rl && !_rl.closed) _rl.close()
+  _rl = null
+
+  return new Promise((resolve) => {
+    process.stdout.write(`${question}: `)
+    let result = ''
+    let resolved = false
+
+    const cleanup = () => {
+      if (resolved) return
+      resolved = true
+      process.stdin.removeListener('data', onData)
+      try {
+        process.stdin.setRawMode(false)
+      } catch {
+        // ignore
+      }
+      process.stdin.pause()
+      process.stdout.write('\n')
+      resolve(result)
+    }
+
+    const onData = (buf) => {
+      for (let i = 0; i < buf.length; i++) {
+        const byte = buf[i]
+        if (byte === 13 || byte === 10) {
+          // Enter
+          cleanup()
+          return
+        } else if (byte === 3 || byte === 4) {
+          // Ctrl+C / Ctrl+D
+          cleanup()
+          return
+        } else if (byte === 127 || byte === 8) {
+          // Backspace / Ctrl+H
+          if (result.length > 0) {
+            result = result.slice(0, -1)
+            process.stdout.write('\b \b')
+          }
+        } else if (byte >= 32 && byte < 127) {
+          result += String.fromCharCode(byte)
+          process.stdout.write('*')
+        }
+      }
+    }
+
+    try {
+      process.stdin.setRawMode(true)
+    } catch {
+      // 无法 raw mode — 退化为可见输入
+      process.stdout.write('\n')
+      resolve('')
+      return
+    }
+    process.stdin.resume()
+    process.stdin.on('data', onData)
+  })
+}
+
+/**
+ * 多选（空格/逗号分隔序号）。
+ *   - 输入空 → defaultSelected
+ *   - 输入 a/all → 全选
+ *   - 输入 n/none → 全不选
+ *   - 输入 1,3 5 → 选 [0, 2, 4]
+ *
+ * @param {string} question
+ * @param {Array<{label: string}>} items
+ * @param {{defaultSelected?: number[]}} [opts]
+ * @returns {Promise<number[]>} 选中的索引数组
+ */
+export async function multiSelect(question, items, { defaultSelected = [] } = {}) {
+  if (items.length === 0) return []
+  console.log(question)
+  items.forEach((item, i) => {
+    const selected = defaultSelected.includes(i)
+    console.log(`  [${selected ? 'x' : ' '}] ${i + 1}. ${item.label}`)
+  })
+  console.log('  （输入序号，逗号/空格分隔；回车=默认；a=全选；n=全不选）')
+
+  const defaultStr = defaultSelected.map((i) => i + 1).join(',')
+  const answer = await ask('选择', { defaultValue: defaultStr })
+  const trimmed = answer.trim().toLowerCase()
+
+  if (trimmed === 'a' || trimmed === 'all') {
+    return items.map((_, i) => i)
+  }
+  if (trimmed === 'n' || trimmed === 'none') {
+    return []
+  }
+
+  const nums = answer
+    .split(/[,\s]+/)
+    .map((s) => parseInt(s, 10))
+    .filter((n) => !isNaN(n) && n >= 1 && n <= items.length)
+    .map((n) => n - 1)
+  // 去重
+  return [...new Set(nums)]
+}
+
+/**
+ * 单选
+ * @param {string} question
+ * @param {Array<{label: string}>} items
+ * @param {{defaultIndex?: number}} [opts]
+ * @returns {Promise<number>} 选中的索引（items.length===1 时直接返回 0）
+ */
+export async function select(question, items, { defaultIndex = 0 } = {}) {
+  if (items.length === 0) return -1
+  if (items.length === 1) return 0
+  console.log(question)
+  items.forEach((item, i) => {
+    const marker = i === defaultIndex ? ' (默认)' : ''
+    console.log(`  ${i + 1}. ${item.label}${marker}`)
+  })
+  const answer = await ask('选择序号', { defaultValue: String(defaultIndex + 1) })
+  const n = parseInt(answer, 10)
+  if (isNaN(n) || n < 1 || n > items.length) return defaultIndex
+  return n - 1
+}
+
+/**
+ * 是非确认
+ * @param {string} question
+ * @param {{defaultValue?: boolean}} [opts]
+ * @returns {Promise<boolean>}
+ */
+export async function confirm(question, { defaultValue = true } = {}) {
+  const hint = defaultValue ? 'Y/n' : 'y/N'
+  const answer = await ask(`${question} (${hint})`, {
+    defaultValue: defaultValue ? 'y' : 'n',
+  })
+  const v = answer.trim().toLowerCase()
+  if (!v) return defaultValue
+  return v === 'y' || v === 'yes'
+}

package/lib/render.mjs

@@ -0,0 +1,81 @@
+/**
+ * 占位符替换工具
+ *
+ * 对照 frontend/src/utils/clientConfigDefaults.ts，已知占位符：
+ *   {{apiKey}}                    — API Key
+ *   {{baseUrl}}                   — 主基址（如 https://2api.store）
+ *   {{apiBase}}                   — 等价于 baseUrl（OpenCode 用此名）
+ *   {{apiBaseBeta}}               — beta 基址（OpenCode Gemini 用）
+ *   {{antigravityApiBase}}        — antigravity 基址（= baseUrl + /antigravity）
+ *   {{antigravityApiBaseBeta}}    — antigravity beta 基址
+ *   {{defaultModel}}              — 用户选择的默认模型 id（由脚本注入，后端保留占位符）
+ *
+ * 后端预注入 apiKey/baseUrl（spec §4.3 step 4），脚本主要注入 defaultModel。
+ * 为防御性处理（后端漏注入或返回原始模板），本函数替换全部已知占位符。
+ */
+
+export const PLACEHOLDERS = [
+  'apiKey',
+  'baseUrl',
+  'apiBase',
+  'apiBaseBeta',
+  'antigravityApiBase',
+  'antigravityApiBaseBeta',
+  'defaultModel',
+]
+
+/**
+ * 渲染内容：替换所有已知占位符
+ * @param {string} content
+ * @param {Record<string, string>} values
+ * @returns {string}
+ */
+export function renderContent(content, values) {
+  if (!content) return ''
+  let out = content
+  for (const key of PLACEHOLDERS) {
+    const v = values[key]
+    if (v !== undefined && v !== null) {
+      // 字面替换，避免 RegExp 特殊字符问题
+      out = out.split(`{{${key}}}`).join(String(v))
+    }
+  }
+  return out
+}
+
+/**
+ * 展开路径占位符
+ *   unix:  ~/foo → $HOME/foo
+ *   windows: %userprofile%\foo → %USERPROFILE%\foo
+ * @param {string} p 原始路径
+ * @param {{isWindows: boolean}} opts
+ * @returns {string}
+ */
+export function expandPath(p, { isWindows } = {}) {
+  if (!p) return p
+  if (isWindows) {
+    const userProfile = process.env.USERPROFILE || ''
+    return p.replace(/^%userprofile%/i, userProfile).replace(/^~/, userProfile)
+  }
+  const home = process.env.HOME || ''
+  if (p === '~') return home
+  if (p.startsWith('~/')) return home + p.slice(1)
+  return p
+}
+
+/**
+ * 将 models 数组规整为 {id, label} 列表，供选择展示用
+ * @param {Array<{id?: string, name?: string}|string>} models
+ * @returns {Array<{index: number, id: string, label: string, raw: any}>}
+ */
+export function listModels(models) {
+  if (!Array.isArray(models) || models.length === 0) return []
+  return models.map((m, i) => {
+    if (typeof m === 'string') {
+      return { index: i, id: m, label: m, raw: m }
+    }
+    const id = m.id || m.name || String(m)
+    const label = m.name || m.id || id
+    return { index: i, id, label, raw: m }
+  })
+}

package/lib/write.mjs

@@ -0,0 +1,57 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+/**
+ * 权限相关错误码（EACCES/EPERM/EROFS）
+ */
+const PERM_CODES = new Set(['EACCES', 'EPERM', 'EROFS'])
+
+/**
+ * 权限不足错误（含明确的重跑提示，绝不自动 sudo）
+ */
+export class PermissionDeniedError extends Error {
+  constructor(targetPath, cause, isWindows) {
+    const tip = isWindows
+      ? '请用「管理员 PowerShell」重跑：\n    Start-Process powershell -Verb RunAs -ArgumentList "npx,-y,@2api-store/activate"'
+      : '请用 sudo 重跑：\n    sudo npx -y @2api-store/activate'
+    super(`写入失败：${targetPath}（${cause.code || cause.message}）\n  ${tip}`)
+    this.name = 'PermissionDeniedError'
+    this.code = cause.code
+    this.path = targetPath
+    this.cause = cause
+  }
+}
+
+/**
+ * 两阶段写入（spec §5.5）：
+ *   1. 先 fs.mkdirSync(recursive) 确保父目录
+ *   2. fs.writeFile 试用户权限
+ *   3. 失败（EACCES/EPERM/EROFS）→ 抛 PermissionDeniedError（含提示，绝不自动 sudo）
+ *
+ * 文件权限 0o600（仅属主读写，因含 API Key）
+ *
+ * @param {string} targetPath 目标绝对路径
+ * @param {string} content 写入内容
+ * @param {{isWindows?: boolean}} opts
+ */
+export function writeFileWithPermission(targetPath, content, { isWindows = false } = {}) {
+  const dir = path.dirname(targetPath)
+  try {
+    fs.mkdirSync(dir, { recursive: true })
+  } catch (err) {
+    if (PERM_CODES.has(err.code)) {
+      throw new PermissionDeniedError(targetPath, err, isWindows)
+    }
+    throw err
+  }
+
+  try {
+    fs.writeFileSync(targetPath, content, { encoding: 'utf8', mode: 0o600 })
+  } catch (err) {
+    if (PERM_CODES.has(err.code)) {
+      throw new PermissionDeniedError(targetPath, err, isWindows)
+    }
+    throw err
+  }
+  return targetPath
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@2api-store/activate",
+  "version": "0.1.0",
+  "description": "TokenShop CLI 一键激活：配置本地 codex/claude/gemini/grok/opencode 指向 2api.store 中转",
+  "type": "module",
+  "bin": {
+    "activate": "activate.mjs"
+  },
+  "main": "./activate.mjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "check": "node --check activate.mjs && for f in lib/*.mjs; do node --check \"$f\" || exit 1; done",
+    "smoke": "node test/smoke.mjs"
+  },
+  "files": [
+    "activate.mjs",
+    "lib/",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "activate",
+    "2api",
+    "tokenshop",
+    "codex",
+    "claude",
+    "gemini",
+    "grok",
+    "opencode"
+  ],
+  "author": "TokenShop",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}