iivo-sub 0.1.0 → 0.1.2

package/README.md

@@ -26,8 +26,15 @@ The main menu includes:
 - Quick configuration
 - Backup configuration
 - Restore backup
+- Backup chat records
+- Restore chat records
+- Clear cache and backups
 - 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>`.
 
+Chat record backup lets you back up common local conversation paths for Codex, Claude Code, Hermes, and OpenClaw. Restore creates a safety backup before replacing existing chat record paths.
+
+After you enter an API key once, it is cached in `~/.iivo-sub/cache.json`. Next time the prompt shows a masked key such as `sk-x...abcd`; press Enter to reuse it or type a new key to replace it.
+
 Existing config files are backed up under `~/.iivo-sub/backups/` before being replaced.

package/bin/iivo-sub.js

@@ -5,8 +5,9 @@ import os from 'node:os'
 import path from 'node:path'
 import readline from 'node:readline'
 
-const VERSION = '0.1.0'
+const VERSION = '0.1.2'
 const APP_DIR = path.join(os.homedir(), '.iivo-sub')
+const CACHE_FILE = path.join(APP_DIR, 'cache.json')
 const SCRIPTED_INPUT = !process.stdin.isTTY ? fs.readFileSync(0, 'utf8').split(/\r?\n/) : null
 let scriptedInputIndex = 0
 const DEFAULT_HOST = 'https://sub.iivo.net'
@@ -39,6 +40,9 @@ const MAIN_MENU = [
   { label: '快速配置', value: 'quick' },
   { label: '备份配置', value: 'backup' },
   { label: '恢复备份', value: 'restore' },
+  { label: '备份聊天记录', value: 'backup-chats' },
+  { label: '还原聊天记录', value: 'restore-chats' },
+  { label: '清空缓存及备份', value: 'clear-cache' },
   { label: '退出', value: 'exit' }
 ]
 
@@ -50,11 +54,24 @@ const BACKUP_TARGETS = [
   { label: '全部备份', value: 'all' }
 ]
 
+const CHAT_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 CLEAR_CONFIRM_OPTIONS = [
+  { label: '确认清空', value: 'yes' },
+  { label: '取消', value: 'no' }
+]
+
 const colors = {
   reset: '\x1b[0m',
   dim: '\x1b[2m',
@@ -253,6 +270,10 @@ function fileExists(filePath) {
   return fs.existsSync(filePath) && fs.statSync(filePath).isFile()
 }
 
+function pathExists(targetPath) {
+  return fs.existsSync(targetPath)
+}
+
 function configTargets() {
   return {
     codex: [
@@ -294,6 +315,38 @@ function filesForBackupTarget(target) {
   return targets[target] ?? []
 }
 
+function chatTargets() {
+  return {
+    codex: [
+      path.join(os.homedir(), '.codex', 'sessions'),
+      path.join(os.homedir(), '.codex', 'history.json')
+    ],
+    'claude-code': [
+      path.join(os.homedir(), '.claude', 'projects'),
+      path.join(os.homedir(), '.claude', 'todos'),
+      path.join(os.homedir(), '.claude', 'shell-snapshots')
+    ],
+    hermes: [
+      path.join(os.homedir(), '.hermes', 'sessions'),
+      path.join(os.homedir(), '.hermes', 'chats'),
+      path.join(os.homedir(), '.hermes', 'history.json')
+    ],
+    openclaw: [
+      path.join(os.homedir(), '.openclaw', 'sessions'),
+      path.join(os.homedir(), '.openclaw', 'chats'),
+      path.join(os.homedir(), '.openclaw', 'history.json')
+    ]
+  }
+}
+
+function pathsForChatBackupTarget(target) {
+  const targets = chatTargets()
+  if (target === 'all') {
+    return Object.values(targets).flat()
+  }
+  return targets[target] ?? []
+}
+
 function uniqueFiles(files) {
   return [...new Set(files)]
 }
@@ -302,6 +355,10 @@ function backupTargetLabel(value) {
   return BACKUP_TARGETS.find((item) => item.value === value)?.label ?? value
 }
 
+function chatBackupTargetLabel(value) {
+  return CHAT_BACKUP_TARGETS.find((item) => item.value === value)?.label ?? value
+}
+
 function timestampForName() {
   const now = new Date()
   const pad = (value) => String(value).padStart(2, '0')
@@ -342,6 +399,19 @@ function copyConfigToBackup(filePath, backupRoot) {
   }
 }
 
+function copyPathToBackup(sourcePath, backupRoot) {
+  const stat = fs.statSync(sourcePath)
+  const backupFile = toBackupFileName(sourcePath)
+  const backupPath = path.join(backupRoot, 'files', backupFile)
+  ensureDir(path.dirname(backupPath))
+  fs.cpSync(sourcePath, backupPath, { recursive: true, force: true })
+  return {
+    source: sourcePath,
+    backup: path.relative(backupRoot, backupPath),
+    type: stat.isDirectory() ? 'directory' : 'file'
+  }
+}
+
 function loadBackupManifest(dir) {
   const manifestPath = path.join(dir, 'manifest.json')
   if (!fileExists(manifestPath)) return null
@@ -352,6 +422,43 @@ function loadBackupManifest(dir) {
   }
 }
 
+function readCache() {
+  if (!fileExists(CACHE_FILE)) return {}
+  try {
+    return JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'))
+  } catch {
+    return {}
+  }
+}
+
+function writeCache(cache) {
+  ensureDir(APP_DIR)
+  fs.writeFileSync(CACHE_FILE, json({
+    ...cache,
+    updated_at: new Date().toISOString()
+  }), { encoding: 'utf8', mode: 0o600 })
+}
+
+function getCachedApiKey() {
+  const cache = readCache()
+  return typeof cache.api_key === 'string' ? cache.api_key : ''
+}
+
+function setCachedApiKey(apiKey) {
+  if (!apiKey) return
+  writeCache({
+    ...readCache(),
+    api_key: apiKey,
+    api_key_hint: maskKey(apiKey)
+  })
+}
+
+function deletePath(target) {
+  if (!fs.existsSync(target)) return false
+  fs.rmSync(target, { recursive: true, force: true })
+  return true
+}
+
 function writeFileWithBackup(filePath, content, backupRoot) {
   ensureDir(path.dirname(filePath))
   if (fs.existsSync(filePath)) {
@@ -564,7 +671,10 @@ async function quickConfig() {
     if (step === 0) {
       clear()
       banner()
-      const apiKey = await question('请输入 API Key [Esc 返回主菜单]', { mask: true })
+      const cachedApiKey = getCachedApiKey()
+      const defaultHint = cachedApiKey ? maskKey(cachedApiKey) : ''
+      const apiKeyInput = await question('请输入 API Key [Esc 返回主菜单]', { mask: true, defaultValue: defaultHint })
+      const apiKey = apiKeyInput === defaultHint && cachedApiKey ? cachedApiKey : apiKeyInput
       if (apiKey === '__exit__') return '__exit__'
       if (apiKey === null) return
       if (!apiKey) {
@@ -573,6 +683,7 @@ async function quickConfig() {
         continue
       }
       state.apiKey = apiKey
+      setCachedApiKey(apiKey)
       step = 1
       continue
     }
@@ -698,6 +809,7 @@ async function backupConfig() {
   ensureDir(backupRoot)
   const files = existing.map((filePath) => copyConfigToBackup(filePath, backupRoot))
   const manifest = {
+    kind: 'config',
     name,
     target,
     target_label: backupTargetLabel(target),
@@ -721,27 +833,105 @@ async function backupConfig() {
   await pause()
 }
 
+async function backupChatRecords() {
+  clear()
+  banner()
+  const target = await select('请选择聊天记录备份目标:', CHAT_BACKUP_TARGETS)
+  if (target === '__exit__') return '__exit__'
+  if (!target) return
+
+  const defaultName = `${timestampForName()}_chats_${target}`
+  clear()
+  banner()
+  const rawName = await question('请输入聊天记录备份名称 [Esc 返回上一步]', { defaultValue: defaultName })
+  if (rawName === '__exit__') return '__exit__'
+  if (rawName === null) return backupChatRecords()
+
+  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 backupChatRecords()
+  }
+
+  const candidates = uniqueFiles(pathsForChatBackupTarget(target))
+  const existing = candidates.filter(pathExists)
+  if (existing.length === 0) {
+    console.log(c('yellow', `没有找到可备份的 ${chatBackupTargetLabel(target)}。`))
+    console.log()
+    console.log(c('dim', '已检查常见目录:'))
+    for (const item of candidates) {
+      console.log(c('dim', `- ${item}`))
+    }
+    await pause()
+    return
+  }
+
+  ensureDir(backupRoot)
+  const files = existing.map((sourcePath) => copyPathToBackup(sourcePath, backupRoot))
+  const manifest = {
+    kind: 'chat',
+    name,
+    target,
+    target_label: chatBackupTargetLabel(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(`备份目标: ${chatBackupTargetLabel(target)}`)
+  console.log(`备份目录: ${backupRoot}`)
+  console.log()
+  console.log(c('cyan', '已备份路径:'))
+  for (const file of files) {
+    console.log(`- ${file.source}`)
+  }
+  await pause()
+}
+
+function backupEntryMatchesKind(entryName, backupDir, kind) {
+  const manifest = loadBackupManifest(path.join(backupDir, entryName))
+  if (!manifest) return kind === 'config'
+  if (kind === 'config') return !manifest.kind || manifest.kind === 'config'
+  return manifest.kind === kind
+}
+
 async function restoreBackup() {
+  return restoreBackupByKind('config', '请选择要查看的配置备份:', '暂无配置备份。')
+}
+
+async function restoreChatRecords() {
+  return restoreBackupByKind('chat', '请选择要还原的聊天记录备份:', '暂无聊天记录备份。')
+}
+
+async function restoreBackupByKind(kind, title, emptyMessage) {
   clear()
   banner()
   const backupDir = path.join(APP_DIR, 'backups')
   if (!fs.existsSync(backupDir)) {
-    console.log(c('yellow', '暂无备份。'))
+    console.log(c('yellow', emptyMessage))
     return pause()
   }
 
   const entries = fs.readdirSync(backupDir, { withFileTypes: true })
     .filter((entry) => entry.isDirectory())
     .map((entry) => entry.name)
+    .filter((name) => backupEntryMatchesKind(name, backupDir, kind))
     .sort()
     .reverse()
 
   if (entries.length === 0) {
-    console.log(c('yellow', '暂无备份。'))
+    console.log(c('yellow', emptyMessage))
     return pause()
   }
 
-  const selected = await select('请选择要查看的备份:', [
+  const selected = await select(title, [
     ...entries.map((name) => ({ label: name, value: name })),
     { label: '返回', value: null }
   ])
@@ -768,13 +958,16 @@ async function restoreBackup() {
   console.log(`备份目标: ${manifest.target_label || manifest.target || '未知'}`)
   console.log(`创建时间: ${manifest.created_at || '未知'}`)
   console.log()
-  console.log(c('cyan', '将恢复以下文件:'))
+  console.log(c('cyan', kind === 'chat' ? '将还原以下聊天记录路径:' : '将恢复以下文件:'))
   for (const file of manifest.files || []) {
     console.log(`- ${file.source}`)
   }
   console.log()
 
-  const confirm = await select('确认恢复这个备份吗？当前同名配置会先自动备份。', RESTORE_CONFIRM_OPTIONS)
+  const confirmText = kind === 'chat'
+    ? '确认还原这个聊天记录备份吗？当前同名聊天记录会先自动备份。'
+    : '确认恢复这个备份吗？当前同名配置会先自动备份。'
+  const confirm = await select(confirmText, RESTORE_CONFIRM_OPTIONS)
   if (confirm === '__exit__') return '__exit__'
   if (confirm !== 'yes') return
 
@@ -784,18 +977,21 @@ async function restoreBackup() {
   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)
+    if (!source || !pathExists(backupPath)) continue
+    if (pathExists(source)) {
+      copyPathToBackup(source, safetyBackup)
     }
     ensureDir(path.dirname(source))
-    fs.copyFileSync(backupPath, source)
+    if (pathExists(source)) {
+      deletePath(source)
+    }
+    fs.cpSync(backupPath, source, { recursive: true, force: true })
     restored.push(source)
   }
 
   clear()
   banner()
-  console.log(c('green', '恢复完成。'))
+  console.log(c('green', kind === 'chat' ? '聊天记录还原完成。' : '恢复完成。'))
   console.log()
   for (const file of restored) {
     console.log(`- ${file}`)
@@ -805,6 +1001,57 @@ async function restoreBackup() {
   await pause()
 }
 
+async function clearCacheAndBackups() {
+  clear()
+  banner()
+  console.log(c('yellow', '将删除以下 iivo-sub 数据:'))
+  console.log(`- API Key 缓存: ${CACHE_FILE}`)
+  console.log(`- 备份目录: ${path.join(APP_DIR, 'backups')} ${c('dim', '(包含配置备份和聊天记录备份)')}`)
+  console.log(`- 临时配置脚本: ${path.join(APP_DIR, '*.env / *.ps1 / *.cmd')}`)
+  console.log(`- 最近配置摘要: ${path.join(APP_DIR, 'config.json')}`)
+  console.log()
+  console.log('不会删除 Codex、Claude Code、Hermes、OpenClaw 的实际配置文件。')
+  console.log()
+
+  const confirm = await select('确认清空缓存及备份吗？', CLEAR_CONFIRM_OPTIONS)
+  if (confirm === '__exit__') return '__exit__'
+  if (confirm !== 'yes') return
+
+  const removed = []
+  for (const target of [
+    CACHE_FILE,
+    path.join(APP_DIR, 'backups'),
+    path.join(APP_DIR, 'config.json'),
+    path.join(APP_DIR, 'codex.env'),
+    path.join(APP_DIR, 'codex.ps1'),
+    path.join(APP_DIR, 'codex.cmd'),
+    path.join(APP_DIR, 'claude-code.env'),
+    path.join(APP_DIR, 'claude-code.ps1'),
+    path.join(APP_DIR, 'claude-code.cmd'),
+    path.join(APP_DIR, 'hermes.env'),
+    path.join(APP_DIR, 'hermes.ps1'),
+    path.join(APP_DIR, 'hermes.cmd'),
+    path.join(APP_DIR, 'openclaw.env'),
+    path.join(APP_DIR, 'openclaw.ps1'),
+    path.join(APP_DIR, 'openclaw.cmd')
+  ]) {
+    if (deletePath(target)) removed.push(target)
+  }
+
+  clear()
+  banner()
+  if (removed.length === 0) {
+    console.log(c('yellow', '没有找到需要清空的数据。'))
+  } else {
+    console.log(c('green', '缓存及备份已清空。'))
+    console.log()
+    for (const target of removed) {
+      console.log(`- ${target}`)
+    }
+  }
+  await pause()
+}
+
 async function pause() {
   await question('按回车继续')
 }
@@ -826,6 +1073,18 @@ async function main() {
       const result = await restoreBackup()
       if (result === '__exit__') break
     }
+    if (action === 'backup-chats') {
+      const result = await backupChatRecords()
+      if (result === '__exit__') break
+    }
+    if (action === 'restore-chats') {
+      const result = await restoreChatRecords()
+      if (result === '__exit__') break
+    }
+    if (action === 'clear-cache') {
+      const result = await clearCacheAndBackups()
+      if (result === '__exit__') break
+    }
   }
   clear()
   console.log('已退出 iivo-sub。')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iivo-sub",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "IIVO AI gateway quick configuration CLI",
   "type": "module",
   "bin": {