iivo-sub 0.1.0

package/README.md

@@ -0,0 +1,33 @@
+# iivo-sub
+
+Interactive quick configuration tool for IIVO internal AI gateway clients.
+
+```bash
+npx iivo-sub
+```
+
+Local development:
+
+```bash
+node cli/iivo-sub/bin/iivo-sub.js
+```
+
+The CLI asks for:
+
+- API Key
+- API Host, defaulting to `https://sub.iivo.net`
+- Model
+- Quick configuration scenario: OpenClaw, Hermes, Codex, or Claude Code
+
+In an interactive terminal, press `Esc` to return to the previous step.
+
+The main menu includes:
+
+- Quick configuration
+- Backup configuration
+- Restore backup
+- Exit
+
+Backup configuration lets you choose Codex, Claude Code, Hermes, OpenClaw, or all targets. You can name the backup yourself; the default name is `<date-time>_<target>`.
+
+Existing config files are backed up under `~/.iivo-sub/backups/` before being replaced.

package/bin/iivo-sub.js

@@ -0,0 +1,854 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import readline from 'node:readline'
+
+const VERSION = '0.1.0'
+const APP_DIR = path.join(os.homedir(), '.iivo-sub')
+const SCRIPTED_INPUT = !process.stdin.isTTY ? fs.readFileSync(0, 'utf8').split(/\r?\n/) : null
+let scriptedInputIndex = 0
+const DEFAULT_HOST = 'https://sub.iivo.net'
+const HOST_OPTIONS = [
+  { label: 'sub.iivo.net', value: 'https://sub.iivo.net' },
+  { label: 'ai.iivo.net', value: 'https://ai.iivo.net' },
+  { label: '手动输入 / Custom', value: '__custom__' }
+]
+
+const MODEL_OPTIONS = [
+  'gpt-5.3-codex',
+  'gpt-5.3-codex-spark',
+  'gpt-5.2',
+  'gpt-5.5',
+  'claude-sonnet-4-6',
+  'claude-opus-4-6',
+  'gemini-2.5-pro',
+  'gemini-2.5-flash',
+  '手动输入 / Custom'
+]
+
+const SCENARIOS = [
+  { label: 'OpenClaw', value: 'openclaw' },
+  { label: 'Hermes', value: 'hermes' },
+  { label: 'Codex', value: 'codex' },
+  { label: 'Claude Code', value: 'claude-code' }
+]
+
+const MAIN_MENU = [
+  { label: '快速配置', value: 'quick' },
+  { label: '备份配置', value: 'backup' },
+  { label: '恢复备份', value: 'restore' },
+  { label: '退出', value: 'exit' }
+]
+
+const BACKUP_TARGETS = [
+  { label: 'Codex', value: 'codex' },
+  { label: 'Claude Code', value: 'claude-code' },
+  { label: 'Hermes', value: 'hermes' },
+  { label: 'OpenClaw', value: 'openclaw' },
+  { label: '全部备份', value: 'all' }
+]
+
+const RESTORE_CONFIRM_OPTIONS = [
+  { label: '确认恢复', value: 'yes' },
+  { label: '取消', value: 'no' }
+]
+
+const colors = {
+  reset: '\x1b[0m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+  bold: '\x1b[1m'
+}
+
+function c(color, text) {
+  return `${colors[color] || ''}${text}${colors.reset}`
+}
+
+function clear() {
+  if (process.stdout.isTTY) {
+    process.stdout.write('\x1b[2J\x1b[0f')
+  }
+}
+
+function banner() {
+  const lines = [
+    `IIVO SUB 助手 v${VERSION}`,
+    'AI 基站快速配置工具'
+  ]
+  const width = 42
+  const border = '─'.repeat(width)
+  console.log(c('magenta', `┌${border}┐`))
+  for (const line of lines) {
+    const visual = stringWidth(line)
+    const left = Math.floor((width - visual) / 2)
+    const right = width - visual - left
+    console.log(c('magenta', '│') + ' '.repeat(left) + c('bold', line) + ' '.repeat(right) + c('magenta', '│'))
+  }
+  console.log(c('magenta', `└${border}┘`))
+  console.log()
+  console.log(`中转站地址: ${c('green', DEFAULT_HOST)}`)
+  console.log()
+}
+
+function stringWidth(value) {
+  let width = 0
+  for (const char of [...value]) {
+    width += /[\u4e00-\u9fff\uff00-\uffef]/.test(char) ? 2 : 1
+  }
+  return width
+}
+
+function question(prompt, { mask = false, defaultValue = '' } = {}) {
+  if (SCRIPTED_INPUT) {
+    const answer = SCRIPTED_INPUT[scriptedInputIndex++] ?? ''
+    const fullPrompt = defaultValue ? `${prompt} (${defaultValue}): ` : `${prompt}: `
+    process.stdout.write(fullPrompt)
+    process.stdout.write(mask ? '********\n' : `${answer}\n`)
+    return Promise.resolve(answer.trim() || defaultValue)
+  }
+
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+    const fullPrompt = defaultValue ? `${prompt} ${c('dim', `(${defaultValue})`)}: ` : `${prompt}: `
+    return new Promise((resolve) => {
+      rl.question(fullPrompt, (answer) => {
+        rl.close()
+        resolve(answer.trim() || defaultValue)
+      })
+    })
+  }
+
+  return interactiveQuestion(prompt, { mask, defaultValue })
+}
+
+function interactiveQuestion(prompt, { mask = false, defaultValue = '' } = {}) {
+  return new Promise((resolve) => {
+    let buffer = ''
+    const promptText = defaultValue ? `${prompt} ${c('dim', `(${defaultValue})`)}: ` : `${prompt}: `
+    const wasRaw = process.stdin.isRaw
+
+    readline.emitKeypressEvents(process.stdin)
+    process.stdin.setRawMode(true)
+    process.stdout.write(promptText)
+
+    const cleanup = (value) => {
+      process.stdin.off('keypress', onKey)
+      process.stdin.setRawMode(wasRaw)
+      process.stdout.write('\n')
+      resolve(value)
+    }
+
+    const onKey = (str, key) => {
+      if (key?.ctrl && key.name === 'c') {
+        cleanup('__exit__')
+        return
+      }
+      if (key?.name === 'escape') {
+        cleanup(null)
+        return
+      }
+      if (key?.name === 'return') {
+        cleanup(buffer.trim() || defaultValue)
+        return
+      }
+      if (key?.name === 'backspace') {
+        if (buffer.length > 0) {
+          buffer = [...buffer].slice(0, -1).join('')
+          process.stdout.write('\b \b')
+        }
+        return
+      }
+      if (!str || key?.name === 'tab') return
+
+      buffer += str
+      process.stdout.write(mask ? '*'.repeat([...str].length) : str)
+    }
+
+    process.stdin.on('keypress', onKey)
+  })
+}
+
+async function select(title, options, { allowEsc = true } = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    console.log(title)
+    options.forEach((item, index) => console.log(`${index + 1}. ${item.label ?? item}`))
+    const answer = await question('请输入序号')
+    const index = Number(answer) - 1
+    const item = options[index]
+    return item && Object.prototype.hasOwnProperty.call(item, 'value') ? item.value : (item ?? null)
+  }
+
+  let index = 0
+  readline.emitKeypressEvents(process.stdin)
+  const wasRaw = process.stdin.isRaw
+  process.stdin.setRawMode(true)
+
+  return new Promise((resolve) => {
+    const render = () => {
+      clear()
+      banner()
+      console.log(`${title} ${c('cyan', '[使用上下方向键移动，回车确认，Esc 返回上一层]')}`)
+      options.forEach((item, itemIndex) => {
+        const label = item.label ?? item
+        const prefix = itemIndex === index ? c('cyan', '>') : ' '
+        const text = itemIndex === index ? c('cyan', label) : label
+        console.log(`${prefix} ${text}`)
+      })
+    }
+
+    const cleanup = (value) => {
+      process.stdin.off('keypress', onKey)
+      process.stdin.setRawMode(wasRaw)
+      resolve(value)
+    }
+
+    const onKey = (_str, key) => {
+      if (key.name === 'up') {
+        index = (index - 1 + options.length) % options.length
+        render()
+        return
+      }
+      if (key.name === 'down') {
+        index = (index + 1) % options.length
+        render()
+        return
+      }
+      if (key.name === 'return') {
+        const item = options[index]
+        cleanup(item && Object.prototype.hasOwnProperty.call(item, 'value') ? item.value : item)
+        return
+      }
+      if (allowEsc && key.name === 'escape') {
+        cleanup(null)
+        return
+      }
+      if (key.ctrl && key.name === 'c') {
+        cleanup('__exit__')
+      }
+    }
+
+    render()
+    process.stdin.on('keypress', onKey)
+  })
+}
+
+function normalizeHost(input) {
+  const trimmed = String(input || '').trim()
+  if (!trimmed) return DEFAULT_HOST
+  const withProtocol = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`
+  return withProtocol.replace(/\/+$/, '')
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true })
+}
+
+function fileExists(filePath) {
+  return fs.existsSync(filePath) && fs.statSync(filePath).isFile()
+}
+
+function configTargets() {
+  return {
+    codex: [
+      path.join(os.homedir(), '.codex', 'config.toml'),
+      path.join(os.homedir(), '.codex', 'auth.json'),
+      path.join(APP_DIR, 'codex.env'),
+      path.join(APP_DIR, 'codex.ps1'),
+      path.join(APP_DIR, 'codex.cmd')
+    ],
+    'claude-code': [
+      path.join(os.homedir(), '.claude', 'settings.json'),
+      detectShellProfile(),
+      path.join(APP_DIR, 'claude-code.env'),
+      path.join(APP_DIR, 'claude-code.ps1'),
+      path.join(APP_DIR, 'claude-code.cmd')
+    ],
+    hermes: [
+      path.join(os.homedir(), '.hermes', 'iivo-sub.json'),
+      path.join(os.homedir(), '.hermes', '.env'),
+      path.join(APP_DIR, 'hermes.env'),
+      path.join(APP_DIR, 'hermes.ps1'),
+      path.join(APP_DIR, 'hermes.cmd')
+    ],
+    openclaw: [
+      path.join(os.homedir(), '.openclaw', 'iivo-sub.json'),
+      path.join(os.homedir(), '.openclaw', 'iivo-sub.env'),
+      path.join(APP_DIR, 'openclaw.env'),
+      path.join(APP_DIR, 'openclaw.ps1'),
+      path.join(APP_DIR, 'openclaw.cmd')
+    ]
+  }
+}
+
+function filesForBackupTarget(target) {
+  const targets = configTargets()
+  if (target === 'all') {
+    return Object.values(targets).flat()
+  }
+  return targets[target] ?? []
+}
+
+function uniqueFiles(files) {
+  return [...new Set(files)]
+}
+
+function backupTargetLabel(value) {
+  return BACKUP_TARGETS.find((item) => item.value === value)?.label ?? value
+}
+
+function timestampForName() {
+  const now = new Date()
+  const pad = (value) => String(value).padStart(2, '0')
+  return [
+    now.getFullYear(),
+    pad(now.getMonth() + 1),
+    pad(now.getDate())
+  ].join('-') + '_' + [
+    pad(now.getHours()),
+    pad(now.getMinutes()),
+    pad(now.getSeconds())
+  ].join('-')
+}
+
+function safeBackupName(value) {
+  return String(value || '')
+    .trim()
+    .replace(/[\\/]/g, '-')
+    .replace(/[\x00-\x1f<>:"|?*]/g, '-')
+    .replace(/\s+/g, '_')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 120)
+}
+
+function toBackupFileName(filePath) {
+  return path.relative(os.homedir(), filePath).replaceAll(path.sep, '__')
+    || path.basename(filePath)
+}
+
+function copyConfigToBackup(filePath, backupRoot) {
+  const backupFile = toBackupFileName(filePath)
+  const backupPath = path.join(backupRoot, 'files', backupFile)
+  ensureDir(path.dirname(backupPath))
+  fs.copyFileSync(filePath, backupPath)
+  return {
+    source: filePath,
+    backup: path.relative(backupRoot, backupPath)
+  }
+}
+
+function loadBackupManifest(dir) {
+  const manifestPath = path.join(dir, 'manifest.json')
+  if (!fileExists(manifestPath)) return null
+  try {
+    return JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+function writeFileWithBackup(filePath, content, backupRoot) {
+  ensureDir(path.dirname(filePath))
+  if (fs.existsSync(filePath)) {
+    const relative = path.relative(os.homedir(), filePath).replaceAll(path.sep, '__')
+    const backupPath = path.join(backupRoot, relative || path.basename(filePath))
+    ensureDir(path.dirname(backupPath))
+    fs.copyFileSync(filePath, backupPath)
+  }
+  fs.writeFileSync(filePath, content, 'utf8')
+}
+
+function appendManagedBlock(filePath, block, marker, backupRoot) {
+  ensureDir(path.dirname(filePath))
+  let content = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : ''
+  if (fs.existsSync(filePath)) {
+    const relative = path.relative(os.homedir(), filePath).replaceAll(path.sep, '__')
+    fs.copyFileSync(filePath, path.join(backupRoot, relative || path.basename(filePath)))
+  }
+
+  const start = `# >>> ${marker} >>>`
+  const end = `# <<< ${marker} <<<`
+  const managed = `${start}\n${block.trim()}\n${end}`
+  const pattern = new RegExp(`${escapeRegExp(start)}[\\s\\S]*?${escapeRegExp(end)}`)
+  content = pattern.test(content)
+    ? content.replace(pattern, managed)
+    : `${content.replace(/\s*$/, '')}\n\n${managed}\n`
+  fs.writeFileSync(filePath, content, 'utf8')
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+function json(value) {
+  return `${JSON.stringify(value, null, 2)}\n`
+}
+
+function shellExports(config) {
+  return Object.entries(config)
+    .map(([key, value]) => `export ${key}=${JSON.stringify(String(value))}`)
+    .join('\n')
+}
+
+function powershellExports(config) {
+  return Object.entries(config)
+    .map(([key, value]) => `$env:${key}=${JSON.stringify(String(value))}`)
+    .join('\n')
+}
+
+function cmdExports(config) {
+  return Object.entries(config)
+    .map(([key, value]) => `set ${key}=${String(value)}`)
+    .join('\r\n')
+}
+
+function codexToml({ host, model }) {
+  return `model_provider = "OpenAI"
+model = "${model}"
+review_model = "${model}"
+model_reasoning_effort = "xhigh"
+disable_response_storage = true
+network_access = "enabled"
+windows_wsl_setup_acknowledged = true
+
+[model_providers.OpenAI]
+name = "OpenAI"
+base_url = "${host}"
+wire_api = "responses"
+requires_openai_auth = true
+
+[features]
+goals = true
+`
+}
+
+function claudeSettings({ host, apiKey }) {
+  return json({
+    env: {
+      ANTHROPIC_BASE_URL: host,
+      ANTHROPIC_AUTH_TOKEN: apiKey,
+      CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
+      CLAUDE_CODE_ATTRIBUTION_HEADER: '0'
+    }
+  })
+}
+
+function commonEnv({ host, apiKey, model }) {
+  const baseRoot = host.replace(/\/v1\/?$/, '').replace(/\/+$/, '')
+  return {
+    IIVO_SUB_API_HOST: baseRoot,
+    IIVO_SUB_MODEL: model,
+    OPENAI_BASE_URL: `${baseRoot}/v1`,
+    OPENAI_API_KEY: apiKey,
+    ANTHROPIC_BASE_URL: baseRoot,
+    ANTHROPIC_AUTH_TOKEN: apiKey,
+    GOOGLE_GEMINI_BASE_URL: `${baseRoot}/v1beta`,
+    GEMINI_API_KEY: apiKey,
+    GEMINI_MODEL: model
+  }
+}
+
+function createPlan({ scenario, host, apiKey, model }) {
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-')
+  const backupRoot = path.join(APP_DIR, 'backups', timestamp)
+  const files = []
+  const baseConfig = { scenario, host, model, configured_at: new Date().toISOString() }
+
+  files.push({
+    path: path.join(APP_DIR, 'config.json'),
+    content: json({ ...baseConfig, api_key_hint: maskKey(apiKey) }),
+    mode: 'write'
+  })
+
+  if (scenario === 'codex') {
+    files.push({
+      path: path.join(os.homedir(), '.codex', 'config.toml'),
+      content: codexToml({ host, model }),
+      mode: 'write'
+    })
+    files.push({
+      path: path.join(os.homedir(), '.codex', 'auth.json'),
+      content: json({ OPENAI_API_KEY: apiKey }),
+      mode: 'write'
+    })
+  } else if (scenario === 'claude-code') {
+    files.push({
+      path: path.join(os.homedir(), '.claude', 'settings.json'),
+      content: claudeSettings({ host, apiKey }),
+      mode: 'write'
+    })
+    const marker = 'iivo-sub claude-code'
+    files.push({
+      path: detectShellProfile(),
+      content: shellExports({
+        ANTHROPIC_BASE_URL: host,
+        ANTHROPIC_AUTH_TOKEN: apiKey,
+        CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
+        CLAUDE_CODE_ATTRIBUTION_HEADER: '0'
+      }),
+      mode: 'managed',
+      marker
+    })
+  } else if (scenario === 'openclaw') {
+    const env = commonEnv({ host, apiKey, model })
+    files.push({
+      path: path.join(os.homedir(), '.openclaw', 'iivo-sub.json'),
+      content: json({ ...baseConfig, env }),
+      mode: 'write'
+    })
+    files.push({
+      path: path.join(os.homedir(), '.openclaw', 'iivo-sub.env'),
+      content: `${shellExports(env)}\n`,
+      mode: 'write'
+    })
+  } else if (scenario === 'hermes') {
+    const env = commonEnv({ host, apiKey, model })
+    files.push({
+      path: path.join(os.homedir(), '.hermes', 'iivo-sub.json'),
+      content: json({ ...baseConfig, env }),
+      mode: 'write'
+    })
+    files.push({
+      path: path.join(os.homedir(), '.hermes', '.env'),
+      content: `${Object.entries(env).map(([key, value]) => `${key}=${String(value)}`).join('\n')}\n`,
+      mode: 'write'
+    })
+  }
+
+  files.push({
+    path: path.join(APP_DIR, `${scenario}.env`),
+    content: `${shellExports(commonEnv({ host, apiKey, model }))}\n`,
+    mode: 'write'
+  })
+  files.push({
+    path: path.join(APP_DIR, `${scenario}.ps1`),
+    content: `${powershellExports(commonEnv({ host, apiKey, model }))}\n`,
+    mode: 'write'
+  })
+  files.push({
+    path: path.join(APP_DIR, `${scenario}.cmd`),
+    content: `${cmdExports(commonEnv({ host, apiKey, model }))}\r\n`,
+    mode: 'write'
+  })
+
+  return { backupRoot, files }
+}
+
+function detectShellProfile() {
+  const shell = process.env.SHELL || ''
+  if (shell.includes('zsh')) return path.join(os.homedir(), '.zshrc')
+  if (shell.includes('bash')) return path.join(os.homedir(), '.bashrc')
+  return path.join(os.homedir(), '.profile')
+}
+
+function maskKey(key) {
+  if (key.length <= 8) return '********'
+  return `${key.slice(0, 4)}...${key.slice(-4)}`
+}
+
+async function quickConfig() {
+  const state = {
+    apiKey: '',
+    host: DEFAULT_HOST,
+    model: 'gpt-5.3-codex',
+    scenario: ''
+  }
+
+  let step = 0
+  while (step < 4) {
+    if (step === 0) {
+      clear()
+      banner()
+      const apiKey = await question('请输入 API Key [Esc 返回主菜单]', { mask: true })
+      if (apiKey === '__exit__') return '__exit__'
+      if (apiKey === null) return
+      if (!apiKey) {
+        console.log(c('red', 'API Key 不能为空'))
+        await pause()
+        continue
+      }
+      state.apiKey = apiKey
+      step = 1
+      continue
+    }
+
+    if (step === 1) {
+      const hostChoice = await select('请选择 API Host:', HOST_OPTIONS)
+      if (hostChoice === '__exit__') return '__exit__'
+      if (hostChoice === null) {
+        step = 0
+        continue
+      }
+      if (hostChoice === '__custom__') {
+        clear()
+        banner()
+        const customHost = await question('请输入 API Host [Esc 返回上一步]', { defaultValue: state.host || DEFAULT_HOST })
+        if (customHost === '__exit__') return '__exit__'
+        if (customHost === null) continue
+        state.host = normalizeHost(customHost)
+      } else {
+        state.host = normalizeHost(hostChoice)
+      }
+      step = 2
+      continue
+    }
+
+    if (step === 2) {
+      const modelChoice = await select('请选择模型:', MODEL_OPTIONS)
+      if (modelChoice === '__exit__') return '__exit__'
+      if (modelChoice === null) {
+        step = 1
+        continue
+      }
+      if (modelChoice === '手动输入 / Custom') {
+        clear()
+        banner()
+        const customModel = await question('请输入模型名 [Esc 返回上一步]', { defaultValue: state.model || 'gpt-5.3-codex' })
+        if (customModel === '__exit__') return '__exit__'
+        if (customModel === null) continue
+        state.model = String(customModel).trim()
+      } else {
+        state.model = modelChoice
+      }
+      step = 3
+      continue
+    }
+
+    const scenario = await select('请选择要快速配置的场景:', SCENARIOS)
+    if (scenario === '__exit__') return '__exit__'
+    if (scenario === null) {
+      step = 2
+      continue
+    }
+    state.scenario = scenario
+    step = 4
+  }
+
+  const { apiKey, host, model, scenario } = state
+  const plan = createPlan({ scenario, host, apiKey, model })
+  ensureDir(plan.backupRoot)
+  for (const file of plan.files) {
+    if (file.mode === 'managed') {
+      appendManagedBlock(file.path, file.content, file.marker, plan.backupRoot)
+    } else {
+      writeFileWithBackup(file.path, file.content, plan.backupRoot)
+    }
+  }
+
+  clear()
+  banner()
+  console.log(c('green', '配置完成。'))
+  console.log()
+  console.log(`场景: ${scenarioLabel(scenario)}`)
+  console.log(`API Host: ${host}`)
+  console.log(`模型: ${model}`)
+  console.log(`API Key: ${maskKey(apiKey)}`)
+  console.log()
+  console.log(c('cyan', '写入文件:'))
+  for (const file of plan.files) {
+    console.log(`- ${file.path}`)
+  }
+  console.log()
+  console.log(c('yellow', `备份目录: ${plan.backupRoot}`))
+  console.log()
+  console.log('临时环境变量也已生成，可按需 source:')
+  console.log(c('cyan', `source ${path.join(APP_DIR, `${scenario}.env`)}`))
+  await pause()
+}
+
+function scenarioLabel(value) {
+  return SCENARIOS.find((item) => item.value === value)?.label ?? value
+}
+
+async function backupConfig() {
+  clear()
+  banner()
+  const target = await select('请选择备份目标:', BACKUP_TARGETS)
+  if (target === '__exit__') return '__exit__'
+  if (!target) return
+
+  const defaultName = `${timestampForName()}_${target}`
+  clear()
+  banner()
+  const rawName = await question('请输入备份名称 [Esc 返回上一步]', { defaultValue: defaultName })
+  if (rawName === '__exit__') return '__exit__'
+  if (rawName === null) return backupConfig()
+
+  const name = safeBackupName(rawName) || defaultName
+  const backupRoot = path.join(APP_DIR, 'backups', name)
+  if (fs.existsSync(backupRoot)) {
+    console.log(c('red', `备份名称已存在: ${name}`))
+    await pause()
+    return backupConfig()
+  }
+
+  const candidates = uniqueFiles(filesForBackupTarget(target))
+  const existing = candidates.filter(fileExists)
+  if (existing.length === 0) {
+    console.log(c('yellow', `没有找到可备份的 ${backupTargetLabel(target)} 配置。`))
+    await pause()
+    return
+  }
+
+  ensureDir(backupRoot)
+  const files = existing.map((filePath) => copyConfigToBackup(filePath, backupRoot))
+  const manifest = {
+    name,
+    target,
+    target_label: backupTargetLabel(target),
+    created_at: new Date().toISOString(),
+    files
+  }
+  fs.writeFileSync(path.join(backupRoot, 'manifest.json'), json(manifest), 'utf8')
+
+  clear()
+  banner()
+  console.log(c('green', '备份完成。'))
+  console.log()
+  console.log(`备份名称: ${name}`)
+  console.log(`备份目标: ${backupTargetLabel(target)}`)
+  console.log(`备份目录: ${backupRoot}`)
+  console.log()
+  console.log(c('cyan', '已备份文件:'))
+  for (const file of files) {
+    console.log(`- ${file.source}`)
+  }
+  await pause()
+}
+
+async function restoreBackup() {
+  clear()
+  banner()
+  const backupDir = path.join(APP_DIR, 'backups')
+  if (!fs.existsSync(backupDir)) {
+    console.log(c('yellow', '暂无备份。'))
+    return pause()
+  }
+
+  const entries = fs.readdirSync(backupDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort()
+    .reverse()
+
+  if (entries.length === 0) {
+    console.log(c('yellow', '暂无备份。'))
+    return pause()
+  }
+
+  const selected = await select('请选择要查看的备份:', [
+    ...entries.map((name) => ({ label: name, value: name })),
+    { label: '返回', value: null }
+  ])
+  if (!selected) return
+
+  clear()
+  banner()
+  const selectedDir = path.join(backupDir, selected)
+  const manifest = loadBackupManifest(selectedDir)
+  if (!manifest) {
+    console.log(c('cyan', `备份目录: ${selectedDir}`))
+    console.log()
+    for (const file of fs.readdirSync(selectedDir)) {
+      console.log(`- ${path.join(selectedDir, file)}`)
+    }
+    console.log()
+    console.log('这是旧格式自动备份，仅支持查看文件。需要恢复时，请手动复制对应文件覆盖目标配置。')
+    await pause()
+    return
+  }
+
+  console.log(c('cyan', `备份目录: ${selectedDir}`))
+  console.log(`备份名称: ${manifest.name || selected}`)
+  console.log(`备份目标: ${manifest.target_label || manifest.target || '未知'}`)
+  console.log(`创建时间: ${manifest.created_at || '未知'}`)
+  console.log()
+  console.log(c('cyan', '将恢复以下文件:'))
+  for (const file of manifest.files || []) {
+    console.log(`- ${file.source}`)
+  }
+  console.log()
+
+  const confirm = await select('确认恢复这个备份吗？当前同名配置会先自动备份。', RESTORE_CONFIRM_OPTIONS)
+  if (confirm === '__exit__') return '__exit__'
+  if (confirm !== 'yes') return
+
+  const safetyBackup = path.join(APP_DIR, 'backups', `${timestampForName()}_pre-restore_${safeBackupName(manifest.name || selected)}`)
+  ensureDir(safetyBackup)
+  const restored = []
+  for (const file of manifest.files || []) {
+    const source = file.source
+    const backupPath = path.join(selectedDir, file.backup)
+    if (!source || !fileExists(backupPath)) continue
+    if (fileExists(source)) {
+      copyConfigToBackup(source, safetyBackup)
+    }
+    ensureDir(path.dirname(source))
+    fs.copyFileSync(backupPath, source)
+    restored.push(source)
+  }
+
+  clear()
+  banner()
+  console.log(c('green', '恢复完成。'))
+  console.log()
+  for (const file of restored) {
+    console.log(`- ${file}`)
+  }
+  console.log()
+  console.log(c('yellow', `恢复前安全备份目录: ${safetyBackup}`))
+  await pause()
+}
+
+async function pause() {
+  await question('按回车继续')
+}
+
+async function main() {
+  ensureDir(APP_DIR)
+  while (true) {
+    const action = await select('请选择操作:', MAIN_MENU, { allowEsc: false })
+    if (action === '__exit__' || action === 'exit') break
+    if (action === 'quick') {
+      const result = await quickConfig()
+      if (result === '__exit__') break
+    }
+    if (action === 'backup') {
+      const result = await backupConfig()
+      if (result === '__exit__') break
+    }
+    if (action === 'restore') {
+      const result = await restoreBackup()
+      if (result === '__exit__') break
+    }
+  }
+  clear()
+  console.log('已退出 iivo-sub。')
+}
+
+function releaseStdin() {
+  if (process.stdin.isTTY) {
+    try {
+      process.stdin.setRawMode(false)
+    } catch {
+      // stdin may already be detached in non-interactive shells.
+    }
+  }
+  process.stdin.removeAllListeners('keypress')
+  process.stdin.pause()
+}
+
+main()
+  .then(() => {
+    releaseStdin()
+  })
+  .catch((error) => {
+    releaseStdin()
+    console.error(c('red', error?.stack || String(error)))
+    process.exitCode = 1
+  })

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "iivo-sub",
+  "version": "0.1.0",
+  "description": "IIVO AI gateway quick configuration CLI",
+  "type": "module",
+  "bin": {
+    "iivo-sub": "bin/iivo-sub.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}