cc-insight 0.1.0

package/src/api.js

@@ -0,0 +1,501 @@
+// src/api.js
+import fs from 'fs'
+import os from 'os'
+import path from 'path'
+import { Router } from 'express'
+import {
+  getSessionCount, getTotalDurationSec, getAvgDailyDurationSec,
+  getPeakPeriod, getSilentDays, getHeatmapData, get24hDistribution,
+  getInvocationsByTool, getAllTools, getToolUsageStats, deleteTool, getDustToolNames,
+  getToolDistribution, getPluginSubskillStats,
+  getTopicsOverview, getTopicKeywords,
+  getAvgRoundsByTopic, getDurationByTopic, getToolDensityByTopic,
+  getTimeTopicHeatmap, getOutlierSessions, getProjectDist,
+} from './db/queries.js'
+import { getDb } from './db/db.js'
+import { getConfigPath, getAppDir, getClaudeDir } from './config.js'
+import { runFullIndex, getScanPaths } from './indexer.js'
+import { extractNickname, generatePosterText } from './poster.js'
+
+// ── 工具路径校验（导出供测试） ──
+const TYPE_DIR = {
+  skill:  'skills',
+  agent:  'skills',
+  plugin: 'plugins',
+}
+
+export function validateToolPath(name, type, claudeDir = getClaudeDir()) {
+  if (!TYPE_DIR[type]) throw new Error(`未知工具类型: ${type}`)
+  if (!name || name.includes('..') || name.includes('/') || name.includes('\\')) {
+    throw new Error(`非法工具名称: ${name}`)
+  }
+  const base = path.join(claudeDir, TYPE_DIR[type])
+  const target = path.resolve(base, name)
+  if (!target.startsWith(base + path.sep) && target !== base) {
+    throw new Error(`路径越界: ${target}`)
+  }
+  return target
+}
+
+export function createRouter({ sendProgress = () => {}, sendRefresh = () => {} } = {}) {
+  const router = Router()
+
+  // 将时间范围字符串转换为 timestamp（毫秒）
+  function rangeToAfter(range) {
+    const now = Date.now()
+    if (range === '7d')  return now - 7  * 86400 * 1000
+    if (range === '30d') return now - 30 * 86400 * 1000
+    if (range === '90d') return now - 90 * 86400 * 1000
+    return 0 // 'all'
+  }
+
+  // --- 状态检测 & 重新索引 ---
+  router.get('/api/status', (req, res) => {
+    const scanPaths = getScanPaths()
+    const claudeDir = getClaudeDir()
+    const hasClaude = fs.existsSync(claudeDir)
+    const hasData   = getSessionCount({ after: 0 }) > 0
+    res.json({ hasClaude, hasData, scanPaths })
+  })
+
+  let _reindexing = false
+  router.post('/api/reindex', async (req, res) => {
+    if (_reindexing) return res.json({ ok: false, reason: 'already running' })
+    _reindexing = true
+    res.json({ ok: true })
+    try {
+      await runFullIndex(pct => sendProgress(pct))
+    } finally {
+      _reindexing = false
+      sendRefresh()
+    }
+  })
+
+  // --- 主题 1：使用概览 ---
+  router.get('/api/overview', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json({
+      sessions:            getSessionCount({ after }),
+      totalDurationSec:    getTotalDurationSec({ after }),
+      avgDailyDurationSec: getAvgDailyDurationSec({ after }),
+      peakPeriod:          getPeakPeriod({ after }),
+      silentDays:          getSilentDays(),
+    })
+  })
+
+  router.get('/api/heatmap', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json(getHeatmapData({ after }))
+  })
+
+  router.get('/api/distribution', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json(get24hDistribution({ after }))
+  })
+
+  router.get('/api/tool-distribution', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json(getToolDistribution({ after }))
+  })
+
+  router.get('/api/insights', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json(buildInsights({ after }))
+  })
+
+  router.get('/api/topics', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json({
+      categories: getTopicsOverview({ after }),
+      keywords:   getTopicKeywords({ after }),
+    })
+  })
+
+  router.get('/api/efficiency', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json({
+      roundsByTopic:   getAvgRoundsByTopic({ after }),
+      durationByTopic: getDurationByTopic({ after }),
+      densityByTopic:  getToolDensityByTopic({ after }),
+      heatmap:         getTimeTopicHeatmap({ after }),
+      outlierSessions: getOutlierSessions({ after }),
+      projectDist:     getProjectDist({ after }),
+    })
+  })
+
+  // --- 主题 2：Skill & Agent & Plugin ---
+  router.get('/api/tools', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    const tools = getAllTools()
+    const usageStats = getToolUsageStats({ after })
+    const allTimeStats = getToolUsageStats({ after: 0 })
+    const statsMap = Object.fromEntries(usageStats.map(s => [s.toolName, s]))
+    const allTimeMap = Object.fromEntries(allTimeStats.map(s => [s.toolName, s]))
+    const claudeDir = getClaudeDir()
+    const result = tools
+      .filter(t => after === 0 || (t.installed_at ?? 0) >= after)
+      .map(t => {
+        // 推算本地路径
+        let localPath = null
+        if (t.type === 'skill' || t.type === 'agent') {
+          localPath = path.join(claudeDir, 'skills', t.name)
+        } else if (t.type === 'plugin') {
+          // id 格式: plugin:{marketplace}:{pluginName}
+          const parts = t.id.split(':')
+          if (parts.length >= 3) {
+            localPath = path.join(claudeDir, 'plugins', 'cache', parts[1], parts[2])
+          }
+        }
+        return {
+          ...t,
+          // camelCase 别名（DB 返回 snake_case，前端统一用 camelCase）
+          sourceType:         t.source_type,
+          sourceUrl:          t.source_url,
+          installedAt:        t.installed_at,
+          updatedAt:          t.updated_at,
+          securityScanResult: t.security_scan_result,
+          localPath,
+          // 使用统计（来自 tool_invocations 聚合）
+          useCount:         statsMap[t.name]?.useCount   ?? 0,
+          lastUsedAt:       statsMap[t.name]?.lastUsedAt ?? null,
+          allTimeUseCount:  allTimeMap[t.name]?.useCount  ?? 0,
+        }
+      })
+    res.json(result)
+  })
+
+  // --- MCP Server 列表 ---
+  router.get('/api/mcp-servers', (req, res) => {
+    const claudeDir = getClaudeDir()
+    const configPaths = [
+      path.join(claudeDir, 'settings.json'),
+      path.join(claudeDir, 'settings.local.json'),
+      path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+    ]
+
+    // 1. 从配置文件读已声明的 MCP
+    const declared = {}
+    for (const p of configPaths) {
+      try {
+        const cfg = JSON.parse(fs.readFileSync(p, 'utf8'))
+        for (const [name, info] of Object.entries(cfg.mcpServers ?? {})) {
+          declared[name] = { name, source: 'config', command: info.command ?? null,
+            url: info.url ?? null, status: 'configured' }
+        }
+      } catch {}
+    }
+
+    // 2. 从 tool_invocations 推断历史使用过的 MCP（mcp__{server}__{tool} 格式）
+    const db = getDb()
+    const mcpRows = db.prepare(`
+      SELECT DISTINCT tool_name FROM tool_invocations WHERE tool_name GLOB 'mcp__*'
+    `).all()
+    const usedServers = {}
+    for (const { tool_name } of mcpRows) {
+      const parts = tool_name.split('__')
+      if (parts.length >= 3) {
+        const serverName = parts[1]
+        if (!usedServers[serverName]) usedServers[serverName] = []
+        usedServers[serverName].push(parts.slice(2).join('__'))
+      }
+    }
+
+    // 3. 从 auth cache 读 claude.ai 托管 MCP
+    const authCachePath = path.join(claudeDir, 'mcp-needs-auth-cache.json')
+    const authMcp = {}
+    try {
+      const cache = JSON.parse(fs.readFileSync(authCachePath, 'utf8'))
+      for (const name of Object.keys(cache)) {
+        authMcp[name] = { name, source: 'claude.ai', status: 'hosted' }
+      }
+    } catch {}
+
+    // 合并：配置 > 使用记录 > auth cache
+    const result = []
+    const seen = new Set()
+
+    for (const [name, info] of Object.entries(declared)) {
+      seen.add(name)
+      result.push({ ...info, tools: usedServers[name] ?? [], invocations: (usedServers[name] ?? []).length })
+    }
+    for (const [serverName, tools] of Object.entries(usedServers)) {
+      if (seen.has(serverName)) continue
+      seen.add(serverName)
+      result.push({ name: serverName, source: 'history', command: null, url: null,
+        status: 'used', tools, invocations: tools.length })
+    }
+    for (const [name, info] of Object.entries(authMcp)) {
+      if (seen.has(name)) continue
+      seen.add(name)
+      result.push({ ...info, tools: [], invocations: 0 })
+    }
+
+    res.json(result)
+  })
+
+  // --- 配置（主题持久化）---
+  // GET /api/config — 注意：必须在 DELETE /api/tools/:name 之前注册，避免路由冲突
+  router.get('/api/config', (req, res) => {
+    const configPath = getConfigPath()
+    if (!fs.existsSync(configPath)) return res.json({})
+    try {
+      res.json(JSON.parse(fs.readFileSync(configPath, 'utf8')))
+    } catch {
+      res.json({})
+    }
+  })
+
+  router.post('/api/config', (req, res) => {
+    const configPath = getConfigPath()
+    const appDir = getAppDir()
+    if (!fs.existsSync(appDir)) fs.mkdirSync(appDir, { recursive: true })
+    let current = {}
+    if (fs.existsSync(configPath)) {
+      try { current = JSON.parse(fs.readFileSync(configPath, 'utf8')) } catch {}
+    }
+    const updated = { ...current, ...req.body }
+    fs.writeFileSync(configPath, JSON.stringify(updated, null, 2))
+    res.json({ ok: true })
+  })
+
+  // --- P1：海报称呼提取 ---
+  router.get('/api/poster/nickname', (req, res) => {
+    res.json({ nickname: extractNickname() })
+  })
+
+  // --- P2：海报文案规则生成 ---
+  router.get('/api/poster/generate-text', (req, res) => {
+    const after    = rangeToAfter(req.query.range ?? '7d')
+    const nickname = extractNickname()
+
+    // 收集文案生成所需的基础数据
+    const overview = {
+      sessions:            getSessionCount({ after }),
+      totalDurationSec:    getTotalDurationSec({ after }),
+      avgDailyDurationSec: getAvgDailyDurationSec({ after }),
+      peakPeriod:          getPeakPeriod({ after }),
+      silentDays:          getSilentDays(),
+    }
+
+    // 提取 habit 类型（复用 buildInsights 同款逻辑）
+    const dist = get24hDistribution({ after })
+    let habit = null
+    if (dist.length > 0) {
+      const total       = dist.reduce((s, r) => s + r.count, 0)
+      const nightCount  = dist.filter(r => parseInt(r.hour) >= 20).reduce((s, r) => s + r.count, 0)
+      const morningCount= dist.filter(r => parseInt(r.hour) >= 6 && parseInt(r.hour) < 10).reduce((s, r) => s + r.count, 0)
+      const workCount   = dist.filter(r => parseInt(r.hour) >= 9 && parseInt(r.hour) < 18).reduce((s, r) => s + r.count, 0)
+      if (total > 0) {
+        if      (nightCount   / total > 0.5) habit = 'night'
+        else if (morningCount / total > 0.3) habit = 'morning'
+        else if (workCount    / total > 0.5) habit = 'work'
+      }
+    }
+
+    // 最常用 skill 名称
+    const usageStats = getToolUsageStats({ after })
+    const topSkill   = usageStats[0]?.toolName ?? null
+
+    // 与上期对比趋势
+    const periodMs  = Date.now() - after
+    const prevAfter = after > 0 ? after - periodMs : null
+    let trendChange = null
+    if (prevAfter !== null) {
+      const curr = getSessionCount({ after })
+      const prev = getSessionCount({ after: prevAfter })
+      if (prev > 0) trendChange = Math.round((curr - prev) / prev * 100)
+    }
+
+    const seed = parseInt(req.query.seed ?? '0', 10) || 0
+    res.json(generatePosterText({
+      ...overview,
+      habit,
+      topSkill,
+      trendChange,
+      nickname,
+      seed,
+    }))
+  })
+
+  // --- P3：海报数据聚合（一次请求返回海报所需全部数据）---
+  router.get('/api/poster/data', (req, res) => {
+    const range = req.query.range ?? '7d'
+    const after = rangeToAfter(range)
+
+    // 基础指标
+    const sessions            = getSessionCount({ after })
+    const totalDurationSec    = getTotalDurationSec({ after })
+    const avgDailyDurationSec = getAvgDailyDurationSec({ after })
+    const peakPeriod          = getPeakPeriod({ after })
+    const silentDays          = getSilentDays()
+
+    // 图表数据
+    const heatmap      = getHeatmapData({ after })
+    const distribution = get24hDistribution({ after })
+
+    // habit 类型
+    let habit = null
+    const total        = distribution.reduce((s, r) => s + r.count, 0)
+    const nightCount   = distribution.filter(r => parseInt(r.hour) >= 20).reduce((s, r) => s + r.count, 0)
+    const morningCount = distribution.filter(r => parseInt(r.hour) >= 6 && parseInt(r.hour) < 10).reduce((s, r) => s + r.count, 0)
+    const workCount    = distribution.filter(r => parseInt(r.hour) >= 9 && parseInt(r.hour) < 18).reduce((s, r) => s + r.count, 0)
+    if (total > 0) {
+      if      (nightCount   / total > 0.5) habit = 'night'
+      else if (morningCount / total > 0.3) habit = 'morning'
+      else if (workCount    / total > 0.5) habit = 'work'
+    }
+
+    // top skill 名称
+    const usageStats = getToolUsageStats({ after })
+    const topSkillName = usageStats[0]?.toolName ?? null
+
+    // 使用趋势
+    const periodMs  = Date.now() - after
+    const prevAfter = after > 0 ? after - periodMs : null
+    let trendChange = null
+    if (prevAfter !== null) {
+      const prev = getSessionCount({ after: prevAfter })
+      if (prev > 0) trendChange = Math.round((sessions - prev) / prev * 100)
+    }
+
+    // 称呼 & 生成文案
+    const nickname = extractNickname()
+    const seed = parseInt(req.query.seed ?? '0', 10) || 0
+    const { summary, tags, summaryCount } = generatePosterText({
+      sessions, totalDurationSec, avgDailyDurationSec,
+      peakPeriod, silentDays, habit,
+      topSkill: topSkillName, trendChange, nickname, seed,
+    })
+
+    res.json({
+      range,
+      nickname,
+      summary,
+      summaryCount,
+      tags,
+      metrics: {
+        sessions,
+        totalDurationSec,
+        avgDailyDurationSec,
+        peakPeriod,
+        silentDays,
+        topSkillName,
+      },
+      heatmap,
+      distribution,
+    })
+  })
+
+  // --- 批量清理吃灰工具（必须在 /:name 之前注册）---
+  router.delete('/api/tools/bulk-dust', async (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    const dustNames = getDustToolNames({ after })
+    const deleted = []
+    for (const name of dustNames) {
+      // 尝试物理删除（skill 和 agent 都在 skills/ 目录）
+      for (const subdir of ['skills', 'plugins']) {
+        const target = path.join(getClaudeDir(), subdir, name)
+        if (fs.existsSync(target)) {
+          try { fs.rmSync(target, { recursive: true, force: true }) } catch {}
+        }
+      }
+      deleteTool(name)
+      deleted.push(name)
+    }
+    res.json({ deleted: deleted.length, names: deleted })
+  })
+
+  // --- Plugin 子技能调用明细 ---
+  router.get('/api/tools/:name/subskills', (req, res) => {
+    const after = rangeToAfter(req.query.range ?? '7d')
+    res.json(getPluginSubskillStats({ name: req.params.name, after }))
+  })
+
+  // --- 单条删除（必须在 bulk-dust 之后注册）---
+  router.delete('/api/tools/:name', async (req, res) => {
+    const { name } = req.params
+    const { type } = req.query
+
+    let targetPath
+    try {
+      targetPath = validateToolPath(name, type)
+    } catch (err) {
+      return res.status(400).json({ error: err.message })
+    }
+
+    if (fs.existsSync(targetPath)) {
+      try {
+        fs.rmSync(targetPath, { recursive: true, force: true })
+      } catch (err) {
+        return res.status(500).json({ error: `删除文件失败: ${err.message}` })
+      }
+    }
+
+    deleteTool(name)
+    res.json({ ok: true, deleted: targetPath })
+  })
+
+  return router
+}
+
+// 动态生成 Insights，有数据才输出对应条目
+function buildInsights({ after }) {
+  const insights = []
+
+  // 最高产的一天
+  const heatmap = getHeatmapData({ after })
+  if (heatmap.length > 0) {
+    const best = heatmap.reduce((a, b) => b.count > a.count ? b : a)
+    if (best.count >= 2) {
+      insights.push({ type: 'best_day', day: best.day, count: best.count })
+    }
+  }
+
+  // 当前静默期
+  const silentDays = getSilentDays()
+  if (silentDays >= 2) {
+    insights.push({ type: 'silent_days', days: silentDays })
+  }
+
+  // 时间习惯：总是取占比最高的时段（无门槛保底）
+  const dist = get24hDistribution({ after })
+  if (dist.length > 0) {
+    const total = dist.reduce((s, r) => s + r.count, 0)
+    if (total > 0) {
+      const nightCount   = dist.filter(r => parseInt(r.hour) >= 20).reduce((s, r) => s + r.count, 0)
+      const morningCount = dist.filter(r => parseInt(r.hour) >= 6 && parseInt(r.hour) < 10).reduce((s, r) => s + r.count, 0)
+      const workCount    = dist.filter(r => parseInt(r.hour) >= 9 && parseInt(r.hour) < 18).reduce((s, r) => s + r.count, 0)
+      if (nightCount >= morningCount && nightCount >= workCount) {
+        insights.push({ type: 'habit', label: '夜猫子', pct: Math.round(nightCount / total * 100) })
+      } else if (morningCount >= workCount) {
+        insights.push({ type: 'habit', label: '早鸟', pct: Math.round(morningCount / total * 100) })
+      } else {
+        insights.push({ type: 'habit', label: '上班族', pct: Math.round(workCount / total * 100) })
+      }
+    }
+  }
+
+  // 使用趋势（本期 vs 上期），all 范围无法比较，跳过
+  if (after > 0) {
+    const periodMs = Date.now() - after
+    const prevAfter = after - periodMs
+    const currCount = getSessionCount({ after })
+    const prevCount = getSessionCount({ after: prevAfter })
+    if (prevCount > 0) {
+      const change = Math.round((currCount - prevCount) / prevCount * 100)
+      if (Math.abs(change) >= 10) {
+        insights.push({ type: 'trend', change })
+      }
+    }
+  }
+
+  // 兜底：不足 3 条时补充日均时长
+  if (insights.length < 3) {
+    const avgSec = getAvgDailyDurationSec({ after })
+    if (avgSec > 0) {
+      insights.push({ type: 'avg_daily', avgSec })
+    }
+  }
+
+  return insights
+}

package/src/classifiers/topic-rules.js

@@ -0,0 +1,100 @@
+// src/classifiers/topic-rules.js
+
+export const TOPIC_RULES = [
+  {
+    topic: '调试修复',
+    keywords: ['bug', 'error', 'fix', 'fixed', '报错', '修复', 'failed', 'fail', 'crash',
+      'undefined', 'cannot', 'wrong', '问题', '不对', '失败', '异常', 'exception',
+      'traceback', 'stacktrace', '调试', 'debug', 'broken', 'not working'],
+  },
+  {
+    topic: '新功能开发',
+    keywords: ['新增', 'implement', 'feature', '功能', ' add ', 'build', '做一个', '开发',
+      '实现', '支持', '创建', 'create', '添加', '增加', 'develop', 'new feature'],
+  },
+  {
+    topic: '架构设计',
+    keywords: ['设计', 'architecture', '方案', 'schema', '结构', '怎么设计', '如何设计',
+      '规划', 'design', '系统', '模块', '接口', 'interface', '数据模型'],
+  },
+  {
+    topic: '代码重构',
+    keywords: ['refactor', '重构', '优化', 'cleanup', '整理', '改造', '简化', 'simplify',
+      'reorganize', '清理', 'restructure', '改进'],
+  },
+  {
+    topic: '学习探索',
+    keywords: ['学习', '了解', 'how ', 'what is', '原理', '为什么', '怎么', '是什么',
+      '解释', 'explain', '介绍', 'introduce', '概念', 'concept', '区别', 'difference'],
+  },
+  {
+    topic: '配置运维',
+    keywords: ['安装', '配置', 'setup', 'install', 'deploy', '环境', '启动', '运行',
+      'nvm', 'npm', 'node', 'config', '部署', '服务器', 'server', 'docker', '权限'],
+  },
+  {
+    topic: '数据分析',
+    keywords: ['数据', 'query', 'sql', '分析', '统计', '报表', 'select', 'database',
+      'db', '查询', '聚合', 'aggregate', '图表', 'chart', '指标', 'metric'],
+  },
+]
+
+/** 停用词：不作为关键词提取 */
+const STOP_WORDS = new Set([
+  'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+  'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+  'should', 'may', 'might', 'can', 'to', 'of', 'in', 'for', 'on', 'with',
+  'at', 'by', 'from', 'up', 'about', 'into', 'through', 'during',
+  'and', 'or', 'but', 'if', 'then', 'that', 'this', 'it', 'its',
+  'i', 'you', 'we', 'he', 'she', 'they', 'my', 'your', 'our',
+  '的', '了', '是', '在', '我', '你', '他', '她', '它', '们',
+  '这', '那', '有', '和', '与', '或', '不', '也', '都', '就',
+  '一', '个', '来', '去', '说', '要', '会', '能', '把', '给',
+  '帮', '我', '请', '看', '下', '吗', '呢', '啊', '吧',
+])
+
+/**
+ * 根据第一条用户消息分类话题
+ * @param {string} text
+ * @returns {string} 话题大类
+ */
+export function classifyTopic(text) {
+  if (!text || typeof text !== 'string') return '其他'
+  // 剥离 XML 标签（如 <local-command-caveat>...</local-command-caveat>）
+  const cleaned = text.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim()
+  const lower = cleaned.toLowerCase()
+  for (const { topic, keywords } of TOPIC_RULES) {
+    if (keywords.some(kw => lower.includes(kw.toLowerCase()))) {
+      return topic
+    }
+  }
+  return '其他'
+}
+
+/**
+ * 从全量用户文本中提取高频关键词
+ * @param {string} text 所有用户消息拼接文本
+ * @param {number} limit 最多返回词数，默认 20
+ * @returns {string[]} 按频率降序的词列表
+ */
+export function extractKeywords(text, limit = 20) {
+  if (!text || typeof text !== 'string') return []
+
+  // 分词：取长度 ≥ 2 的英文单词（含 kebab-case）和中文词（连续汉字）
+  const tokens = [
+    ...text.matchAll(/[a-zA-Z][a-zA-Z0-9_\-\.]{1,}/g),
+    ...text.matchAll(/[\u4e00-\u9fa5]{2,}/g),
+  ].map(m => m[0].toLowerCase())
+
+  // 过滤停用词，统计频率
+  const freq = {}
+  for (const token of tokens) {
+    if (STOP_WORDS.has(token)) continue
+    freq[token] = (freq[token] ?? 0) + 1
+  }
+
+  return Object.entries(freq)
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, limit)
+    .map(([word]) => word)
+}

package/src/config.js

@@ -0,0 +1,28 @@
+// src/config.js
+import path from 'path'
+import os from 'os'
+import fs from 'fs'
+
+export function getClaudeDir() {
+  return process.env.CLAUDE_DIR ?? path.join(os.homedir(), '.claude')
+}
+
+export function getAppDir() {
+  return process.env.CC_INSIGHT_APP_DIR ?? path.join(os.homedir(), '.cc-insight')
+}
+
+export function getDbPath() {
+  return path.join(getAppDir(), 'data.db')
+}
+
+export function getConfigPath() {
+  return path.join(getAppDir(), 'config.json')
+}
+
+// 额外的 session 目录（如 macOS 桌面 App），自动检测，不存在则返回空数组
+export function getExtraSessionDirs() {
+  const candidates = [
+    path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude-code-sessions'),
+  ]
+  return candidates.filter(p => fs.existsSync(p))
+}

package/src/db/db.js

@@ -0,0 +1,39 @@
+import Database from 'better-sqlite3'
+import fs from 'fs'
+import { getDbPath, getAppDir } from '../config.js'
+import { CREATE_TABLES } from './schema.js'
+
+let _db = null
+
+export function getDb() {
+  if (_db) return _db
+  const appDir = getAppDir()
+  if (!fs.existsSync(appDir)) fs.mkdirSync(appDir, { recursive: true })
+  _db = new Database(getDbPath())
+  _db.pragma('journal_mode = WAL')
+  _db.exec(CREATE_TABLES)
+  // 迁移：兼容旧 DB，按需新增列
+  const existingCols = _db.prepare('PRAGMA table_info(sessions)').all().map(c => c.name)
+  if (!existingCols.includes('topic')) {
+    _db.exec('ALTER TABLE sessions ADD COLUMN topic TEXT')
+  }
+  if (!existingCols.includes('topic_keywords')) {
+    _db.exec('ALTER TABLE sessions ADD COLUMN topic_keywords TEXT')
+  }
+  if (!existingCols.includes('first_user_msg')) {
+    _db.exec('ALTER TABLE sessions ADD COLUMN first_user_msg TEXT')
+  }
+  return _db
+}
+
+export function closeDb() {
+  if (_db) { _db.close(); _db = null }
+}
+
+export function getMeta(key) {
+  return getDb().prepare('SELECT value FROM meta WHERE key = ?').get(key)?.value
+}
+
+export function setMeta(key, value) {
+  getDb().prepare('INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)').run(key, value)
+}