iivo-sub 0.1.1 → 0.1.3

package/README.md

@@ -26,11 +26,17 @@ 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.
+
+For Codex, chat backup includes sessions, the recent-task index, history, attachments, shell snapshots, and local state files. Restoring a new backup keeps the original recent-task index; restoring an older Codex chat backup that only contains sessions will rebuild the recent-task index automatically.
+
 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,7 +5,7 @@ import os from 'node:os'
 import path from 'node:path'
 import readline from 'node:readline'
 
-const VERSION = '0.1.1'
+const VERSION = '0.1.3'
 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
@@ -40,6 +40,8 @@ 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' }
 ]
@@ -52,6 +54,14 @@ 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' }
@@ -260,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: [
@@ -301,6 +315,50 @@ function filesForBackupTarget(target) {
   return targets[target] ?? []
 }
 
+function chatTargets() {
+  return {
+    codex: [
+      path.join(os.homedir(), '.codex', 'sessions'),
+      path.join(os.homedir(), '.codex', 'session_index.jsonl'),
+      path.join(os.homedir(), '.codex', 'history.jsonl'),
+      path.join(os.homedir(), '.codex', 'attachments'),
+      path.join(os.homedir(), '.codex', 'shell_snapshots'),
+      ...matchingHomeFiles('.codex', /^(?:state|goals|logs|memories)_\d+\.sqlite(?:-(?:shm|wal))?$/)
+    ],
+    '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 matchingHomeFiles(relativeDir, pattern) {
+  const dir = path.join(os.homedir(), relativeDir)
+  if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) return []
+  return fs.readdirSync(dir)
+    .filter((name) => pattern.test(name))
+    .map((name) => path.join(dir, name))
+}
+
+function pathsForChatBackupTarget(target) {
+  const targets = chatTargets()
+  if (target === 'all') {
+    return Object.values(targets).flat()
+  }
+  return targets[target] ?? []
+}
+
 function uniqueFiles(files) {
   return [...new Set(files)]
 }
@@ -309,6 +367,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')
@@ -349,6 +411,134 @@ 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 codexSessionIDFromPath(filePath) {
+  const base = path.basename(filePath, '.jsonl')
+  const match = base.match(/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i)
+  return match ? match[1] : ''
+}
+
+function truncateTitle(text) {
+  let value = String(text || '')
+  const requestMatch = value.match(/(?:##\s*)?My request for Codex:\s*([\s\S]+)/i)
+  if (requestMatch) {
+    value = requestMatch[1]
+  }
+  value = value
+    .replace(/<environment_context>[\s\S]*?<\/environment_context>/g, ' ')
+    .replace(/# Context from my IDE setup:/gi, ' ')
+    .replace(/## Open tabs:[\s\S]*?(?=##|$)/gi, ' ')
+    .replace(/## Active file:[\s\S]*?(?=##|$)/gi, ' ')
+  return value
+    .replace(/\s+/g, ' ')
+    .trim()
+    .slice(0, 80)
+}
+
+function titleFromCodexSession(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf8')
+    for (const line of content.split(/\r?\n/)) {
+      if (!line.trim()) continue
+      let item
+      try {
+        item = JSON.parse(line)
+      } catch {
+        continue
+      }
+      const payload = item?.payload
+      if (payload?.type === 'user_message' && payload.message) {
+        return truncateTitle(payload.message)
+      }
+      if (payload?.type === 'message' && payload.role === 'user' && Array.isArray(payload.content)) {
+        const text = payload.content
+          .map((part) => part?.text || part?.input_text || '')
+          .filter(Boolean)
+          .join(' ')
+        if (text) return truncateTitle(text)
+      }
+    }
+  } catch {
+    return ''
+  }
+  return ''
+}
+
+function latestTimestampFromCodexSession(filePath) {
+  let latest = ''
+  try {
+    const content = fs.readFileSync(filePath, 'utf8')
+    for (const line of content.split(/\r?\n/)) {
+      if (!line.trim()) continue
+      try {
+        const item = JSON.parse(line)
+        if (typeof item.timestamp === 'string' && item.timestamp > latest) {
+          latest = item.timestamp
+        }
+      } catch {
+        // Ignore malformed lines.
+      }
+    }
+  } catch {
+    return ''
+  }
+  return latest
+}
+
+function listCodexSessionFiles(dir) {
+  if (!fs.existsSync(dir)) return []
+  const out = []
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const fullPath = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      out.push(...listCodexSessionFiles(fullPath))
+    } else if (entry.isFile() && entry.name.endsWith('.jsonl')) {
+      out.push(fullPath)
+    }
+  }
+  return out
+}
+
+function rebuildCodexSessionIndex() {
+  const sessionsDir = path.join(os.homedir(), '.codex', 'sessions')
+  const indexPath = path.join(os.homedir(), '.codex', 'session_index.jsonl')
+  const files = listCodexSessionFiles(sessionsDir)
+  if (files.length === 0) return 0
+
+  const rows = files.map((filePath) => {
+    const id = codexSessionIDFromPath(filePath)
+    if (!id) return null
+    const title = titleFromCodexSession(filePath) || id
+    const stat = fs.statSync(filePath)
+    return {
+      id,
+      thread_name: title,
+      updated_at: latestTimestampFromCodexSession(filePath) || stat.mtime.toISOString()
+    }
+  }).filter(Boolean)
+    .sort((a, b) => b.updated_at.localeCompare(a.updated_at))
+
+  if (rows.length === 0) return 0
+  ensureDir(path.dirname(indexPath))
+  if (fileExists(indexPath)) {
+    fs.copyFileSync(indexPath, `${indexPath}.${timestampForName()}.bak`)
+  }
+  fs.writeFileSync(indexPath, rows.map((row) => JSON.stringify(row)).join('\n') + '\n', 'utf8')
+  return rows.length
+}
+
 function loadBackupManifest(dir) {
   const manifestPath = path.join(dir, 'manifest.json')
   if (!fileExists(manifestPath)) return null
@@ -746,6 +936,7 @@ async function backupConfig() {
   ensureDir(backupRoot)
   const files = existing.map((filePath) => copyConfigToBackup(filePath, backupRoot))
   const manifest = {
+    kind: 'config',
     name,
     target,
     target_label: backupTargetLabel(target),
@@ -769,27 +960,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 }
   ])
@@ -816,38 +1085,64 @@ 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
 
   const safetyBackup = path.join(APP_DIR, 'backups', `${timestampForName()}_pre-restore_${safeBackupName(manifest.name || selected)}`)
   ensureDir(safetyBackup)
   const restored = []
+  let restoredCodexSessions = false
+  let restoredCodexIndex = false
+  const codexSessionsPath = path.join(os.homedir(), '.codex', 'sessions')
+  const codexIndexPath = path.join(os.homedir(), '.codex', 'session_index.jsonl')
   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)
+    if (kind === 'chat' && source === codexSessionsPath) {
+      restoredCodexSessions = true
+    }
+    if (kind === 'chat' && source === codexIndexPath) {
+      restoredCodexIndex = true
+    }
+  }
+
+  let rebuiltCodexIndexCount = 0
+  if (restoredCodexSessions && !restoredCodexIndex) {
+    rebuiltCodexIndexCount = rebuildCodexSessionIndex()
   }
 
   clear()
   banner()
-  console.log(c('green', '恢复完成。'))
+  console.log(c('green', kind === 'chat' ? '聊天记录还原完成。' : '恢复完成。'))
   console.log()
   for (const file of restored) {
     console.log(`- ${file}`)
   }
+  if (rebuiltCodexIndexCount > 0) {
+    console.log(c('cyan', `已重建 Codex 任务索引: ${rebuiltCodexIndexCount} 条`))
+  } else if (restoredCodexIndex) {
+    console.log(c('cyan', '已恢复 Codex 任务索引。'))
+  }
   console.log()
   console.log(c('yellow', `恢复前安全备份目录: ${safetyBackup}`))
   await pause()
@@ -858,7 +1153,7 @@ async function clearCacheAndBackups() {
   banner()
   console.log(c('yellow', '将删除以下 iivo-sub 数据:'))
   console.log(`- API Key 缓存: ${CACHE_FILE}`)
-  console.log(`- 备份目录: ${path.join(APP_DIR, 'backups')}`)
+  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()
@@ -925,6 +1220,14 @@ 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

package/package.json

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