@2api-store/activate 0.3.7 → 0.4.1

package/README.md

@@ -25,12 +25,76 @@ npx @2api-store/activate
 
 凭据格式自动识别：`sk-` 前缀走 Key 模式；否则按兑换码处理。
 
+## 子命令
+
+除了默认激活流程，还提供 4 个子命令用于后续维护：
+
+```bash
+npx @2api-store/activate <subcommand> [options]
+```
+
+| 子命令 | 作用 |
+|--------|------|
+| `restore` | 从备份恢复：扫描 `~/.codex/`、`~/.claude/`、`~/.gemini/` 下的 `.bak.*` 文件，选择一个恢复（覆盖当前） |
+| `reset` | 恢复官方默认：删除 2api.store 写入的配置文件（`~/.codex/config.toml`、`~/.codex/auth.json`、`~/.claude/settings.json`、`~/.gemini/settings.json`），并尝试从最新备份恢复。**破坏性操作，需确认** |
+| `reconfig` | 重新配置：输入已有 `sk-` API Key → 重拉最新模板/模型 → 覆盖写入配置（写前备份）。同激活流程但不创建账号 |
+| `refresh-groups` | 查看可用分组：`GET /cli/groups` → 彩色表格展示。只读，不改 key/配置 |
+
+所有子命令支持 `--api-base <url>` 覆盖端点；`restore` / `reset` / `reconfig` 支持 `--dry-run` 预演。
+
+### restore — 从备份恢复
+
+```bash
+npx @2api-store/activate restore
+npx @2api-store/activate restore --dry-run      # 预演
+```
+
+- 扫描三个 CLI 目录下的 `.bak.<时间戳>` 文件，按修改时间倒序列出
+- 选择要恢复的备份，复制回原文件（覆盖当前）
+- 恢复前会自动再产生一份安全备份（防止恢复后想撤销）
+- 原 `.bak.*` 文件保留，可多次恢复
+
+### reset — 恢复官方默认
+
+```bash
+npx @2api-store/activate reset
+```
+
+- 列出 2api.store 写入的配置文件（仅现存的）
+- **删除前再备份一次**（`.bak.reset.<时间戳>`，方便撤销）
+- 删除后尝试从最新常规备份恢复（回到激活前的官方状态）
+- 需要显式确认（默认 `N`，输入 `y` 才执行）
+
+### reconfig — 重新配置
+
+```bash
+npx @2api-store/activate reconfig
+npx @2api-store/activate reconfig --api-base http://127.0.0.1:5566
+```
+
+- 输入现有 `sk-` API Key（不接受兑换码）
+- POST `/cli/activate`（key 模式，不创建账号）→ 重拉最新模板/模型
+- 多选 CLI（默认选主 CLI）→ 选默认模型 → 备份并写入
+- 适合：换了机器、配置丢失、想刷新到最新模板
+
+### refresh-groups — 查看可用分组
+
+```bash
+npx @2api-store/activate refresh-groups
+```
+
+- 彩色表格列出所有可用分组（ID + 名称）
+- 只读，不改 key/配置
+- 如需切组：已有 API Key 走管理后台，或重新激活（兑换码可重选分组）
+
 ## 命令行选项
 
 ```
-npx @2api-store/activate [options]
+npx @2api-store/activate [options]                默认激活流程
+npx @2api-store/activate <subcommand> [options]   运行子命令
 
-  --dry-run, -n          不真写配置，只展示将写入什么
+选项（默认激活流程 + 所有子命令通用）:
+  --dry-run, -n          不真写配置，只展示将写入什么（不适用 refresh-groups）
   --platform <name>      只激活指定平台（openai/anthropic/gemini/grok/antigravity）
   --api-base <url>       覆盖 API 端点
   -h, --help             显示帮助

package/activate.mjs

@@ -3,9 +3,14 @@
 process.removeAllListeners('warning')
 process.env.NODE_NO_WARNINGS = '1'
 /**
- * @2api-store/activate — TokenShop CLI 一键激活（v0.3.0）
+ * @2api-store/activate — TokenShop CLI 一键激活（v0.3.0+）
  *
- * 主流程（薄编排，逻辑在各 lib 模块）：
+ * 入口（argv[2] 分发）：
+ *   - 子命令（restore / reset / reconfigure / refresh-groups）→ 分发到 lib/cmds.mjs
+ *   - 无子命令 / 选项（--help / --version / --dry-run / --platform / --api-base）
+ *     → 走默认激活流程 main()
+ *
+ * 默认激活主流程（薄编排，逻辑在各 lib 模块）：
  *   1. banner + 检测环境 + 列已装/未装 CLI
  *   2. 输入凭据（sk- → API Key；否则兑换码 + email）
  *   3. POST /api/v1/cli/activate → 配置包
@@ -33,6 +38,7 @@ import {
 import { banner, ok, fail, warn, info, step, guide, plain, chalk } from './lib/ui.mjs'
 import { getCliMeta, isDefaultSelected } from './lib/platforms.mjs'
 import { ensureInstalled } from './lib/install.mjs'
+import { SUBCOMMANDS, SUBCOMMAND_NAMES, SUB_HELP } from './lib/cmds.mjs'
 
 import { createRequire } from 'node:module'
 const VERSION = createRequire(import.meta.url)('./package.json').version
@@ -73,22 +79,29 @@ function printHelp() {
 @2api-store/activate v${VERSION} — TokenShop CLI 一键激活
 
 用法:
-  npx @2api-store/activate [options]
+  npx @2api-store/activate [options]                默认激活流程
+  npx @2api-store/activate <subcommand> [options]   运行子命令
 
-选项:
+选项（默认激活流程）:
   --dry-run, -n          不真写配置/不真装 CLI，只展示将做什么
   --platform <name>      只激活指定平台（openai/anthropic/gemini/grok/antigravity）
   --api-base <url>       覆盖 API 端点（默认 $ACTIVATE_API_BASE 或 ${DEFAULT_API_BASE}）
   -h, --help             显示帮助
   -v, --version          显示版本
 
+${SUB_HELP}
+
 环境变量:
   ACTIVATE_API_BASE      覆盖 API 端点（同 --api-base）
 
 示例:
-  npx @2api-store/activate
-  npx @2api-store/activate --dry-run
-  npx @2api-store/activate --platform openai
+  npx @2api-store/activate                              # 默认激活
+  npx @2api-store/activate --dry-run                    # 试运行
+  npx @2api-store/activate --platform openai            # 只激活 openai
+  npx @2api-store/activate restore                      # 从备份恢复
+  npx @2api-store/activate reset                        # 恢复官方默认
+  npx @2api-store/activate reconfigure                  # 用已有 API Key 重新配置
+  npx @2api-store/activate refresh-groups               # 查看可用分组
   ACTIVATE_API_BASE=http://127.0.0.1:5566 npx @2api-store/activate
 
 退出码:
@@ -129,6 +142,22 @@ function inferModelPlatforms(models) {
 // ============================================================
 
 async function main() {
+  // === 子命令分发：argv[2] 是子命令（restore/reset/reconfigure/refresh-groups）===
+  // 注意：必须在 parseArgs 之前判断，因为子命令有自己的 argv 解析（--api-base / --dry-run）
+  const firstArg = process.argv[2]
+  if (firstArg && !firstArg.startsWith('-') && SUBCOMMAND_NAMES.has(firstArg)) {
+    const subRest = process.argv.slice(3)
+    const entry = SUBCOMMANDS[firstArg]
+    try {
+      const code = await entry.handler(subRest)
+      return code || 0
+    } catch (err) {
+      fail(`子命令 ${firstArg} 异常：${err?.message || err}`)
+      if (err?.stack) console.error(err.stack)
+      return 1
+    }
+  }
+
   const args = parseArgs(process.argv.slice(2))
   if (args.help) {
     printHelp()

package/lib/backup.mjs

@@ -1,4 +1,5 @@
 import fs from 'node:fs'
+import path from 'node:path'
 
 /**
  * 备份目标文件到同目录 .bak.<ISO时间戳>（非覆盖，保留多次）。
@@ -8,14 +9,14 @@ import fs from 'node:fs'
  *   - 文件存在且备份成功 → 返回备份路径
  *   - 文件存在但备份失败 → 抛错（调用方应中止写入，避免无备份覆盖）
  *
- * @param {string} path 目标文件绝对路径
+ * @param {string} targetPath 目标文件绝对路径
  * @returns {string|null} 备份路径，或 null（文件不存在）
  * @throws {Error} 文件存在但 copyFileSync 失败
  */
-export function backupFile(path) {
+export function backupFile(targetPath) {
   let exists = false
   try {
-    exists = fs.existsSync(path)
+    exists = fs.existsSync(targetPath)
   } catch {
     // 无法检查存在性（权限等）— 视为不存在，best effort
     return null
@@ -24,9 +25,85 @@ export function backupFile(path) {
 
   // ISO 时间戳，文件名安全化（: 和 . 替换为 -）
   const ts = new Date().toISOString().replace(/[:.]/g, '-')
-  const backupPath = `${path}.bak.${ts}`
+  const backupPath = `${targetPath}.bak.${ts}`
 
   // copyFileSync 失败会抛出 — 调用方知道文件存在且备份失败
-  fs.copyFileSync(path, backupPath)
+  fs.copyFileSync(targetPath, backupPath)
   return backupPath
 }
+
+/**
+ * 扫描多个目录下所有 .bak.<timestamp> 备份文件，按修改时间倒序排列。
+ *
+ * 文件名格式约定：<original>.bak.<ISO时间戳>（backupFile 写入）。
+ *
+ * @param {string[]} dirs 要扫描的目录绝对路径列表
+ * @returns {Array<{bakPath: string, origPath: string, mtime: number, dir: string, file: string, origName: string, size: number}>}
+ *   按修改时间倒序（最新在前）
+ */
+export function listBackups(dirs) {
+  const backups = []
+  for (const dir of dirs) {
+    if (!dir) continue
+    let entries
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true })
+    } catch {
+      // 目录不存在或权限不足 — 跳过
+      continue
+    }
+    for (const entry of entries) {
+      if (!entry.isFile()) continue
+      // 匹配 <filename>.bak.<timestamp>（timestamp 含 T Z - 数字）
+      const match = entry.name.match(/^(.+)\.bak\.[\dTZ:-]+$/)
+      if (!match) continue
+      const origName = match[1]
+      const bakPath = path.join(dir, entry.name)
+      const origPath = path.join(dir, origName)
+      try {
+        const stat = fs.statSync(bakPath)
+        backups.push({
+          bakPath,
+          origPath,
+          mtime: stat.mtimeMs,
+          dir,
+          file: entry.name,
+          origName,
+          size: stat.size,
+        })
+      } catch {
+        // stat 失败 — 跳过
+      }
+    }
+  }
+  // 修改时间倒序（最新在前）
+  backups.sort((a, b) => b.mtime - a.mtime)
+  return backups
+}
+
+/**
+ * 从备份恢复（复制回原文件，覆盖当前）。
+ *
+ * 行为：
+ *   - 备份文件不存在 → 抛错（调用方应预先校验）
+ *   - 目标父目录不存在 → 自动 mkdir
+ *   - 恢复后保留备份文件（不删，多次恢复可用）
+ *
+ * @param {string} bakPath 备份文件绝对路径
+ * @param {string} origPath 原文件目标绝对路径
+ * @returns {string} origPath（恢复后的路径）
+ * @throws {Error} 备份文件不存在或复制失败
+ */
+export function restoreBackup(bakPath, origPath) {
+  if (!fs.existsSync(bakPath)) {
+    throw new Error(`备份文件不存在：${bakPath}`)
+  }
+  const dir = path.dirname(origPath)
+  try {
+    fs.mkdirSync(dir, { recursive: true })
+  } catch {
+    // 父目录已存在或创建失败忽略（copyFileSync 会再报）
+  }
+  fs.copyFileSync(bakPath, origPath)
+  return origPath
+}

package/lib/cmds.mjs

@@ -0,0 +1,764 @@
+/**
+ * 子命令实现：restore / reset / reconfig / refresh-groups
+ *
+ * 设计原则：
+ *   - 每个子命令是独立 async 函数，接收 argv 数组（不含子命令名本身）
+ *   - 返回退出码（0 成功 / 1 输入错误 / 2 权限 / 3 写入失败）
+ *   - 自包含：解析自己的 argv + 走完整流程
+ *   - 操作配置文件前都备份（reset 删前备份；reconfig 写前备份）
+ *   - 不复用 activate.mjs 的 main()（避免耦合，main 包含 redeem/CLI 多选/安装等复杂流程）
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+
+import { backupFile, listBackups, restoreBackup } from './backup.mjs'
+import { cliActivate, listGroups } from './api.mjs'
+import { writeFileWithPermission, PermissionDeniedError } from './write.mjs'
+import { renderContent, expandPath, listModels } from './render.mjs'
+import { getCliMeta, isDefaultSelected } from './platforms.mjs'
+import { detectAll } from './detect.mjs'
+import {
+  ask,
+  askSecret,
+  multiSelect,
+  select,
+  confirm,
+  closePrompt,
+} from './prompt.mjs'
+import { banner, ok, fail, warn, info, step, plain, guide, chalk } from './ui.mjs'
+
+// ============================================================
+// 常量
+// ============================================================
+
+const DEFAULT_API_BASE = 'https://2api.store'
+
+/**
+ * 2api.store 写入的配置文件清单（reset 用）
+ * 注意：~/.claude/settings.json 整文件删除（如用户有自定义设置，先备份后删，
+ *       若存在 .bak.* 则恢复到删除前的官方状态）
+ */
+const MANAGED_CONFIG_FILES_UNIX = [
+  '~/.codex/config.toml',
+  '~/.codex/auth.json',
+  '~/.claude/settings.json',
+  '~/.gemini/settings.json',
+]
+
+const MANAGED_CONFIG_FILES_WIN = [
+  '%userprofile%\\.codex\\config.toml',
+  '%userprofile%\\.codex\\auth.json',
+  '%userprofile%\\.claude\\settings.json',
+  '%userprofile%\\.gemini\\settings.json',
+]
+
+/** 扫描备份文件的目录 */
+const BACKUP_SCAN_DIRS_UNIX = ['~/.codex', '~/.claude', '~/.gemini']
+const BACKUP_SCAN_DIRS_WIN = [
+  '%userprofile%\\.codex',
+  '%userprofile%\\.claude',
+  '%userprofile%\\.gemini',
+]
+
+// ============================================================
+// 工具：解析子命令自己的 argv（--api-base / --dry-run / --help）
+// ============================================================
+
+function parseSubArgs(argv) {
+  const args = { dryRun: false, _: [] }
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (a === '--dry-run' || a === '-n') {
+      args.dryRun = true
+    } else if (a === '--api-base') {
+      args.apiBase = argv[++i]
+    } else if (a === '--help' || a === '-h') {
+      args.help = 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 resolveHome(p, isWindows) {
+  return expandPath(p, { isWindows })
+}
+
+function getManagedFiles(isWindows) {
+  return (isWindows ? MANAGED_CONFIG_FILES_WIN : MANAGED_CONFIG_FILES_UNIX).map((p) =>
+    resolveHome(p, isWindows),
+  )
+}
+
+function getBackupScanDirs(isWindows) {
+  return (isWindows ? BACKUP_SCAN_DIRS_WIN : BACKUP_SCAN_DIRS_UNIX).map((p) =>
+    resolveHome(p, isWindows),
+  )
+}
+
+/** 格式化时间为本地可读格式 */
+function fmtTime(ms) {
+  try {
+    const d = new Date(ms)
+    const pad = (n) => String(n).padStart(2, '0')
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
+  } catch {
+    return new Date(ms).toISOString()
+  }
+}
+
+/** 格式化文件大小 */
+function fmtSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`
+  return `${(bytes / 1024 / 1024).toFixed(2)}MB`
+}
+
+const SUB_HELP = `
+子命令:
+  restore          从备份恢复（扫描 ~/.codex / ~/.claude / ~/.gemini 下的 .bak.* 文件）
+  reset            恢复官方默认（删 2api.store 写入的配置，并从最新备份恢复）
+  reconfig      重新配置（输入已有 sk- API Key → 重拉模板/模型 → 覆盖写入）
+  refresh-groups   刷新分组列表（只展示，不改 key/配置）
+
+所有子命令都支持 --api-base <url> 覆盖端点，restore/reset/reconfig 支持 --dry-run。
+`.trim()
+
+// ============================================================
+// restore：从备份恢复
+// ============================================================
+
+async function cmdRestore(argv) {
+  const args = parseSubArgs(argv)
+  if (args.help) {
+    console.log(`npx @2api-store/activate restore [options]\n\n${SUB_HELP}`)
+    return 0
+  }
+
+  banner()
+  const env = detectAll()
+  if (!env.node.supported) {
+    fail(`需要 node >= 18，当前 ${env.node.version}`)
+    return 1
+  }
+
+  step('扫描备份文件')
+  const dirs = getBackupScanDirs(env.os.isWindows)
+  if (args.dryRun) warn('【试运行模式 --dry-run】不会真实恢复文件')
+  info(`扫描目录：${dirs.join(', ')}`)
+
+  const backups = listBackups(dirs)
+  if (backups.length === 0) {
+    info('未找到任何备份文件（.bak.*）')
+    info('提示：只有运行过 npx @2api-store/activate 后才会产生备份文件')
+    return 0
+  }
+
+  ok(`找到 ${backups.length} 个备份文件`)
+
+  // 按应用分组（根据 origPath 的父目录）
+  const APP_LABELS = {
+    '.codex': 'Codex CLI',
+    '.claude': 'Claude Code',
+    '.gemini': 'Gemini CLI',
+  }
+  function appLabel(origPath) {
+    const home = process.env.HOME || process.env.USERPROFILE || ''
+    const rel = path.relative(home, origPath).replace(/\\/g, '/')
+    const firstSeg = rel.split('/')[0]
+    return APP_LABELS[firstSeg] || firstSeg
+  }
+  function appDir(origPath) {
+    const home = process.env.HOME || process.env.USERPROFILE || ''
+    return path.dirname(origPath)
+  }
+
+  // 按应用（目录）分组
+  const byApp = {}
+  for (const b of backups) {
+    const dir = appDir(b.origPath)
+    if (!byApp[dir]) byApp[dir] = []
+    byApp[dir].push(b)
+  }
+
+  const appDirs = Object.keys(byApp)
+  if (appDirs.length === 0) {
+    info('无可恢复的备份')
+    return 0
+  }
+
+  console.log()
+  step('选择要恢复的应用')
+  const appItems = appDirs.map((dir) => {
+    const label = appLabel(path.join(dir, 'dummy'))
+    const count = byApp[dir].length
+    return { label: `${chalk.cyan(label)}（${count} 个备份）`, dir }
+  })
+  const appIdx = await select('选择应用（回车=第一个）', appItems, { defaultIndex: 0 })
+  if (appIdx < 0 || appIdx >= appItems.length) {
+    fail('未选择应用')
+    return 1
+  }
+  const chosenDir = appItems[appIdx].dir
+  const chosenAppLabel = appLabel(path.join(chosenDir, 'dummy'))
+
+  // 该应用的备份按时间戳分组（截取到秒：T08-23-03）
+  const appBackups = byApp[chosenDir].sort((a, b) => b.mtime - a.mtime)
+  const byTime = {}
+  const timeOrder = []
+  for (const b of appBackups) {
+    // 从 bakPath 提取时间戳前缀（到秒）
+    const m = path.basename(b.bakPath).match(/\.bak\.(.+)$/)
+    const fullTs = m ? m[1] : ''
+    // 截取到秒：去毫秒后缀（最后 4 字符：-XXXZ）
+    const tsKey = fullTs.replace(/-\d{3}Z$/, 'Z')
+    if (!byTime[tsKey]) {
+      byTime[tsKey] = []
+      timeOrder.push(tsKey)
+    }
+    byTime[tsKey].push(b)
+  }
+
+  console.log()
+  step(`选择恢复时间点（${chosenAppLabel}）`)
+  const timeItems = timeOrder.map((ts) => {
+    const group = byTime[ts]
+    const files = group.map((b) => path.basename(b.origPath)).join(', ')
+    const tsDisplay = fmtTime(group[0].mtime)
+    return { label: `${chalk.dim(tsDisplay)}（${group.length} 文件：${files}）`, ts, group }
+  })
+  const timeIdx = await select('选择时间点（回车=最新）', timeItems, { defaultIndex: 0 })
+  if (timeIdx < 0 || timeIdx >= timeItems.length) {
+    fail('未选择时间点')
+    return 1
+  }
+  const chosenGroup = timeItems[timeIdx].group
+
+  console.log()
+  info(`将恢复 ${chosenAppLabel}（${chosenGroup.length} 个文件）：`)
+  for (const b of chosenGroup) {
+    info(`  ${path.basename(b.origPath)} ← ${path.basename(b.bakPath)}`)
+  }
+
+  if (args.dryRun) {
+    warn('[试运行] 不真实恢复')
+    return 0
+  }
+
+  // 恢复前安全备份当前文件（方便撤销）
+  let restored = 0
+  for (const b of chosenGroup) {
+    if (fs.existsSync(b.origPath)) {
+      try {
+        const safetyBak = backupFile(b.origPath)
+        if (safetyBak) info(`安全备份：${path.basename(b.origPath)} → ${path.basename(safetyBak)}`)
+      } catch {
+        // 安全备份失败不阻塞
+      }
+    }
+    try {
+      restoreBackup(b.bakPath, b.origPath)
+      ok(`已恢复：${b.origPath}`)
+      restored++
+    } catch (err) {
+      fail(`恢复失败：${b.origPath}（${err.message}）`)
+    }
+  }
+  info(`共恢复 ${restored} 个文件`)
+  return restored > 0 ? 0 : 3
+}
+
+// ============================================================
+// reset：恢复官方默认
+// ============================================================
+
+async function cmdReset(argv) {
+  const args = parseSubArgs(argv)
+  if (args.help) {
+    console.log(`npx @2api-store/activate reset [options]\n\n${SUB_HELP}`)
+    return 0
+  }
+
+  banner()
+  const env = detectAll()
+  if (!env.node.supported) {
+    fail(`需要 node >= 18，当前 ${env.node.version}`)
+    return 1
+  }
+
+  step('定位 2api.store 写入的配置')
+  const managedFiles = getManagedFiles(env.os.isWindows)
+  const existing = managedFiles.filter((p) => {
+    try {
+      return fs.existsSync(p)
+    } catch {
+      return false
+    }
+  })
+
+  if (existing.length === 0) {
+    warn('未发现 2api.store 写入的配置文件（可能已 reset 或从未激活过）')
+    info('如需从备份恢复，请运行：npx @2api-store/activate restore')
+    return 0
+  }
+
+  info('将处理以下文件：')
+  existing.forEach((p) => plain(`  - ${chalk.yellow(p)}`))
+  console.log()
+
+  // 扫描最新备份
+  const dirs = getBackupScanDirs(env.os.isWindows)
+  const allBackups = listBackups(dirs)
+  const hasBackups = allBackups.length > 0
+  if (hasBackups) {
+    ok(`发现 ${allBackups.length} 个备份文件（reset 后将尝试恢复每个配置的最新备份）`)
+  } else {
+    warn('未找到任何备份文件（reset 后这些文件将直接删除，无备份可恢复）')
+  }
+
+  console.log()
+  step('确认操作')
+  warn('⚠️ 这是破坏性操作：将删除上述配置文件并尝试从备份恢复。')
+  warn('   删除前会再备份一次（.bak.reset.<时间戳>），可手动恢复。')
+  const sure = await confirm('确认 reset 吗？', { defaultValue: false })
+  if (!sure) {
+    plain('已取消')
+    return 0
+  }
+  console.log()
+
+  if (args.dryRun) {
+    warn('【试运行模式 --dry-run】不会真实删除/恢复文件')
+    info('将执行：')
+    existing.forEach((p) => plain(`  - 删除 ${p}`))
+    if (hasBackups) {
+      info('并从最新备份恢复：')
+      allBackups.slice(0, 5).forEach((b) => plain(`  - ${b.bakPath} → ${b.origPath}`))
+      if (allBackups.length > 5) plain(`  ...（共 ${allBackups.length} 个备份）`)
+    }
+    return 0
+  }
+
+  // 1) 删除前再备份一次（.bak.reset.<ts>），保险可撤销
+  step('安全备份当前文件')
+  const safetyBackups = []
+  for (const p of existing) {
+    try {
+      // 用自定义后缀，避免与 listBackups 的常规 .bak.<ts> 混淆
+      const ts = new Date().toISOString().replace(/[:.]/g, '-')
+      const safetyPath = `${p}.bak.reset.${ts}`
+      fs.copyFileSync(p, safetyPath)
+      safetyBackups.push(safetyPath)
+      plain(`  ✓ ${p} → ${safetyPath}`)
+    } catch (err) {
+      fail(`安全备份失败 ${p}：${err.message}（跳过删除此文件避免误伤）`)
+    }
+  }
+  if (safetyBackups.length > 0) {
+    ok(`已安全备份 ${safetyBackups.length} 个文件`)
+  }
+  console.log()
+
+  // 2) 删除 managed 文件
+  step('删除 2api.store 配置')
+  const deleted = []
+  for (const p of existing) {
+    try {
+      fs.unlinkSync(p)
+      ok(`已删除：${p}`)
+      deleted.push(p)
+    } catch (err) {
+      if (err.code === 'EACCES' || err.code === 'EPERM' || err.code === 'EROFS') {
+        fail(`权限不足，无法删除 ${p}（请用 sudo / 管理员 PowerShell 重跑）`)
+      } else {
+        fail(`删除失败 ${p}：${err.message}`)
+      }
+    }
+  }
+  console.log()
+
+  // 3) 从最新备份恢复（按 origPath 分组，取每个 origPath 的最新备份）
+  if (hasBackups) {
+    step('从最新备份恢复')
+    // 按 origPath 分组，取每组最新的
+    const byOrig = new Map()
+    for (const b of allBackups) {
+      const cur = byOrig.get(b.origPath)
+      if (!cur || b.mtime > cur.mtime) byOrig.set(b.origPath, b)
+    }
+    let restoredCount = 0
+    for (const [origPath, b] of byOrig) {
+      try {
+        restoreBackup(b.bakPath, origPath)
+        ok(`已恢复：${b.bakPath} → ${origPath}`)
+        restoredCount++
+      } catch (err) {
+        warn(`恢复失败 ${origPath}：${err.message}（文件已删除，未恢复）`)
+      }
+    }
+    if (restoredCount > 0) info(`从备份恢复 ${restoredCount} 个文件`)
+    console.log()
+  }
+
+  // 报告
+  step('reset 报告')
+  ok(`已删除 ${deleted.length} 个 2api.store 配置文件`)
+  if (safetyBackups.length > 0) {
+    info('安全备份位置（如需撤销 reset，手动恢复这些文件）：')
+    safetyBackups.forEach((b) => plain(`  - ${b}`))
+  }
+  info('下一步：如需重新激活，运行 npx @2api-store/activate')
+
+  return deleted.length > 0 ? 0 : 1
+}
+
+// ============================================================
+// reconfig：重新配置
+// ============================================================
+
+async function cmdReconfig(argv) {
+  const args = parseSubArgs(argv)
+  if (args.help) {
+    console.log(`npx @2api-store/activate reconfig [options]\n\n${SUB_HELP}`)
+    return 0
+  }
+
+  banner()
+  const env = detectAll()
+  const osLabel = env.os.isMac
+    ? 'macOS'
+    : env.os.isLinux
+      ? 'Linux'
+      : env.os.isWindows
+        ? 'Windows'
+        : env.os.platform
+  info(`环境：${osLabel} · node v${env.node.version}`)
+  if (!env.node.supported) {
+    fail(`需要 node >= 18，当前 ${env.node.version}`)
+    return 1
+  }
+
+  const apiBase = args.apiBase || process.env.ACTIVATE_API_BASE || DEFAULT_API_BASE
+  info(`API 端点：${apiBase}`)
+  if (args.dryRun) warn('【试运行模式 --dry-run】不会真写配置')
+  console.log()
+
+  // 输入 API Key
+  const apiKey = (await askSecret('请输入现有的 API Key (sk-...)')).trim()
+  if (!apiKey) {
+    fail('未输入 API Key')
+    return 1
+  }
+  if (!apiKey.startsWith('sk-')) {
+    fail('reconfig 仅支持 API Key 模式（sk- 前缀）。如需使用兑换码，请运行默认激活流程：npx @2api-store/activate')
+    return 1
+  }
+  info('识别为：API Key 模式（不创建账号，仅重拉模板写入配置）')
+  console.log()
+
+  // 询问是否限制平台（可选）
+  const platformAnswer = (await ask('限制平台？（留空=全部，或输入 openai/anthropic/gemini/grok/antigravity）')).trim()
+  const platform = platformAnswer || null
+  if (platform) info(`平台过滤：${platform}`)
+  console.log()
+
+  // POST /cli/activate
+  step('请求激活服务（key 模式重拉模板）')
+  let bundle
+  try {
+    bundle = await cliActivate({ credential: apiKey, platform, apiBase })
+  } catch (err) {
+    fail(`请求失败：${err.message}`)
+    if (err.statusCode) fail(`  HTTP ${err.statusCode}`)
+    return 1
+  }
+  if (bundle.mode && bundle.mode !== 'key') {
+    warn(`服务端返回模式：${bundle.mode}（预期 key 模式，但继续）`)
+  }
+  ok('已获取最新配置模板')
+  if (bundle.base_url) info(`base_url：${bundle.base_url}`)
+  console.log()
+
+  // 过滤配置
+  const allowedPlatforms = new Set()
+  for (const m of bundle.models || []) {
+    const id = (typeof m === 'string' ? m : m?.id || '').toLowerCase()
+    if (/^(gpt|o1|o3|codex|glm|minimax|deepseek)/.test(id)) allowedPlatforms.add('openai')
+    else if (id.startsWith('claude')) allowedPlatforms.add('anthropic')
+    else if (id.startsWith('gemini')) allowedPlatforms.add('gemini')
+    else if (id.startsWith('grok')) allowedPlatforms.add('grok')
+  }
+  if (platform) allowedPlatforms.add(platform)
+
+  const osConfigs = (bundle.configs || []).filter((c) => {
+    if (!c) return false
+    if (allowedPlatforms.size > 0 && !allowedPlatforms.has(c.platform)) return false
+    if (platform && c.platform !== 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) {
+    fail('服务端未返回适配当前系统的配置模板')
+    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 meta = getCliMeta(c.client_type)
+    const displayName = c.display_name || c.displayName || meta?.name || `${c.platform} ${c.client_type}`
+    const installed = env.installed[c.client_type]?.path || (meta && env.installed[meta.detectBin]?.path)
+    const primaryMark = isDefaultSelected(c.client_type) ? '' : '（独立 CLI）'
+    const nameColored = installed ? chalk.green(displayName) : chalk.gray(`${displayName} (未装)`)
+    cliItems.push({
+      label: `${nameColored} ${chalk.dim(`[${c.platform}/${c.client_type}]`)}${primaryMark}`,
+      config: c,
+      clientType: c.client_type,
+      meta,
+      alreadyInstalled: !!installed,
+    })
+  }
+
+  const defaultSelected = cliItems
+    .map((item, i) => ({ item, i }))
+    .filter(({ item }) => isDefaultSelected(item.clientType))
+    .map(({ i }) => i)
+
+  step('选择要重配的 CLI')
+  const selectedIdxes = await multiSelect(
+    '选择 CLI（绿色=已装，灰色=未装；默认选主 CLI）',
+    cliItems,
+    { defaultSelected },
+  )
+  if (selectedIdxes.length === 0) {
+    plain('未选择任何 CLI，退出。')
+    return 0
+  }
+  const selectedItems = selectedIdxes.map((i) => cliItems[i])
+  console.log()
+
+  // 选默认模型
+  const modelItems = listModels(bundle.models || [])
+  let defaultModelId = ''
+  if (modelItems.length > 0) {
+    step('选择默认模型')
+    const TOP_N = 10
+    const topItems = modelItems.slice(0, TOP_N)
+    const hasMore = modelItems.length > TOP_N
+    const selectItems = [
+      ...topItems.map((m) => ({ label: `${m.label} (${m.id})` })),
+      ...(hasMore ? [{ label: chalk.dim('其他（手动输入）') }] : []),
+    ]
+    const idx = await select('选择默认模型', selectItems, { defaultIndex: 0 })
+    if (hasMore && idx === topItems.length) {
+      defaultModelId = (await ask('输入模型 ID')).trim() || topItems[0].id
+    } else {
+      defaultModelId = topItems[idx].id
+    }
+    ok(`已选默认模型：${defaultModelId}`)
+  } else {
+    warn('服务端未返回模型列表，{{defaultModel}} 将留空')
+  }
+  console.log()
+
+  // 渲染
+  const baseUrl = bundle.base_url || ''
+  const baseUrlBeta = bundle.base_url_beta || baseUrl
+  const renderValues = {
+    apiKey: bundle.api_key || apiKey,
+    baseUrl,
+    apiBase: baseUrl,
+    apiBaseBeta: baseUrlBeta,
+    antigravityApiBase: `${baseUrl}/antigravity`,
+    antigravityApiBaseBeta: `${baseUrlBeta}/antigravity`,
+    defaultModel: defaultModelId,
+  }
+
+  // 备份 + 写入
+  step('备份并写入配置')
+  const report = []
+  let firstPermissionError = null
+
+  for (const item of selectedItems) {
+    const displayName =
+      item.config.display_name || item.config.displayName || item.meta?.name || item.clientType
+    plain(`── ${displayName} ──`)
+    const files = item.config.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) {
+        plain('  [shell 命令，请手动执行]')
+        plain(rendered.split('\n').map((l) => '    ' + l).join('\n'))
+        report.push({ cli: displayName, path: rawPath, action: 'shell-only' })
+        continue
+      }
+
+      plain(`  目标：${targetPath}`)
+
+      if (args.dryRun) {
+        warn('  [试运行] 不真实写入')
+        report.push({ cli: displayName, path: targetPath, action: 'dry-run' })
+        console.log()
+        continue
+      }
+
+      let backupPath = null
+      try {
+        backupPath = backupFile(targetPath)
+        if (backupPath) plain(`  备份：${backupPath}`)
+      } catch (err) {
+        fail(`备份失败：${err.message}（跳过此文件避免无备份覆盖）`)
+        report.push({ cli: displayName, path: targetPath, action: 'backup-failed', error: err.message })
+        continue
+      }
+
+      try {
+        writeFileWithPermission(targetPath, rendered, { isWindows: env.os.isWindows })
+        ok('已写入')
+        report.push({ cli: displayName, path: targetPath, action: 'written', backup: backupPath })
+      } catch (err) {
+        if (err instanceof PermissionDeniedError) {
+          if (!firstPermissionError) firstPermissionError = err
+          fail(err.message)
+          report.push({ cli: displayName, path: targetPath, action: 'permission-denied', error: err.message })
+        } else {
+          fail(`写入失败：${err.message}`)
+          report.push({ cli: displayName, path: targetPath, action: 'failed', error: err.message })
+        }
+      }
+    }
+    console.log()
+  }
+
+  // 报告
+  step('重配报告')
+  const written = report.filter((r) => r.action === 'written')
+  const failed = report.filter(
+    (r) => r.action === 'failed' || r.action === 'permission-denied' || r.action === 'backup-failed',
+  )
+  if (args.dryRun) {
+    plain(`[试运行] 将写入 ${report.filter((r) => r.action === 'dry-run').length} 个文件`)
+  } else {
+    ok(`已写入 ${written.length} 个文件`)
+  }
+  if (failed.length > 0) {
+    warn(`失败 ${failed.length} 项：`)
+    failed.forEach((f) => warn(`  - ${f.cli} ${f.path}`))
+  }
+  const backups = report.filter((r) => r.backup).map((r) => r.backup)
+  if (backups.length > 0) {
+    info('备份位置：')
+    backups.forEach((b) => plain(`  - ${b}`))
+  }
+
+  if (firstPermissionError) {
+    console.log()
+    fail('部分文件权限不足，请按提示用 sudo / 管理员 PowerShell 重跑：')
+    fail('  sudo npx -y @2api-store/activate reconfig')
+    return 2
+  }
+
+  return failed.length > 0 ? 3 : 0
+}
+
+// ============================================================
+// refresh-groups：刷新分组列表（只展示）
+// ============================================================
+
+async function cmdRefreshGroups(argv) {
+  const args = parseSubArgs(argv)
+  if (args.help) {
+    console.log(`npx @2api-store/activate refresh-groups [options]\n\n${SUB_HELP}`)
+    return 0
+  }
+
+  banner()
+  const env = detectAll()
+  if (!env.node.supported) {
+    fail(`需要 node >= 18，当前 ${env.node.version}`)
+    return 1
+  }
+
+  const apiBase = args.apiBase || process.env.ACTIVATE_API_BASE || DEFAULT_API_BASE
+  info(`API 端点：${apiBase}`)
+  console.log()
+
+  step('获取可用分组')
+  let groups = []
+  try {
+    groups = await listGroups({ apiBase })
+  } catch (err) {
+    fail(`获取分组失败：${err.message}`)
+    return 1
+  }
+
+  if (groups.length === 0) {
+    warn('未查询到可用分组')
+    info('可能原因：服务端未配置分组 / 网络错误 / 端点错误')
+    info(`当前端点：${apiBase}（可通过 --api-base 或 ACTIVATE_API_BASE 覆盖）`)
+    return 0
+  }
+
+  ok(`查询到 ${groups.length} 个可用分组`)
+  console.log()
+
+  // 彩色表格输出
+  step('分组列表')
+  const idWidth = Math.max(4, ...groups.map((g) => String(g.id ?? '').length))
+  const nameWidth = Math.max(6, ...groups.map((g) => String(g.name ?? '').length))
+  const header = `  ${'ID'.padEnd(idWidth)}  ${'名称'.padEnd(nameWidth)}  说明`
+  plain(chalk.bold.cyan(header))
+  plain(chalk.dim('  ' + '─'.repeat(idWidth + nameWidth + 15)))
+  groups.forEach((g, i) => {
+    const id = String(g.id ?? '').padEnd(idWidth)
+    const name = String(g.name ?? '').padEnd(nameWidth)
+    const row = `  ${chalk.yellow(id)}  ${chalk.green(name)}`
+    plain(row)
+  })
+  console.log()
+
+  info('💡 如需切换分组：')
+  plain('  • 已有 API Key 绑组：登录管理后台修改，或重新激活（npx @2api-store/activate）')
+  plain('  • 使用兑换码：重新激活时选目标分组即可')
+  info('（本命令仅展示分组，不修改 API Key 或配置文件）')
+
+  return 0
+}
+
+// ============================================================
+// 子命令注册表
+// ============================================================
+
+export const SUBCOMMANDS = {
+  restore: { handler: cmdRestore, description: '从备份恢复配置' },
+  reset: { handler: cmdReset, description: '恢复官方默认（删 2api.store 配置并从备份恢复）' },
+  reconfig: { handler: cmdReconfig, description: '用已有 API Key 重新拉取并写入配置' },
+  'refresh-groups': { handler: cmdRefreshGroups, description: '查看可用分组（不改配置）' },
+}
+
+/** 子命令名集合（用于 argv[2] 分发判断） */
+export const SUBCOMMAND_NAMES = new Set(Object.keys(SUBCOMMANDS))
+
+/** 帮助文本中的子命令清单 */
+export { SUB_HELP }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2api-store/activate",
-  "version": "0.3.7",
+  "version": "0.4.1",
   "description": "TokenShop CLI 一键激活：配置本地 codex/claude/gemini/grok/opencode 指向 2api.store 中转（彩色输出 + 自动安装 CLI）",
   "type": "module",
   "bin": {