claudecode-history-viewer 1.0.0

package/server/parser-cursor.js

@@ -0,0 +1,125 @@
+import fs from 'fs'
+import { searchMessages, dedupeHitsByMessage } from './search-utils.js'
+
+/** 从 Cursor 用户消息中提取可读文本 */
+function extractCursorUserText(content) {
+  let text = ''
+  if (typeof content === 'string') text = content
+  else if (Array.isArray(content)) {
+    text = content
+      .filter((c) => c?.type === 'text')
+      .map((c) => c.text || '')
+      .join('\n')
+  }
+  text = text.replace(/<timestamp>[\s\S]*?<\/timestamp>\s*/gi, '')
+  const m = text.match(/<user_query>\s*([\s\S]*?)\s*<\/user_query>/i)
+  if (m) text = m[1].trim()
+  return text.trim()
+}
+
+/**
+ * 解析 Cursor agent-transcripts JSONL
+ * 格式：每行 { role: 'user'|'assistant', message: { content: [...] } }
+ */
+export function parseCursorTranscript(filePath) {
+  const raw = fs.readFileSync(filePath, 'utf8')
+  const lines = raw.split('\n').filter((l) => l.trim())
+
+  const messages = []
+  let title = ''
+  let lineIdx = 0
+  let assistantRun = null
+
+  const flushAssistantRun = () => {
+    if (!assistantRun) return
+    if (assistantRun.text || assistantRun.toolUses.length > 0 || assistantRun.thinking) {
+      messages.push(assistantRun)
+    }
+    assistantRun = null
+  }
+
+  for (const line of lines) {
+    lineIdx++
+    let row
+    try {
+      row = JSON.parse(line)
+    } catch {
+      continue
+    }
+
+    const role = row.role || row.type
+    if (!role) continue
+
+    if (role === 'user') {
+      flushAssistantRun()
+      const text = extractCursorUserText(row.message?.content)
+      if (text) {
+        if (!title) title = text.slice(0, 60)
+        messages.push({
+          id: `cursor-user-${lineIdx}`,
+          role: 'user',
+          text,
+        })
+      }
+      continue
+    }
+
+    if (role === 'assistant') {
+      const content = row.message?.content
+      if (!Array.isArray(content)) continue
+
+      if (!assistantRun) {
+        assistantRun = {
+          id: `cursor-asst-${lineIdx}`,
+          role: 'assistant',
+          model: 'Cursor',
+          thinking: '',
+          text: '',
+          toolUses: [],
+        }
+      }
+
+      for (const block of content) {
+        if (!block || typeof block !== 'object') continue
+        if (block.type === 'thinking' && block.thinking) {
+          assistantRun.thinking += block.thinking
+        }
+        if (block.type === 'text' && block.text) {
+          assistantRun.text += block.text
+        }
+        if (block.type === 'tool_use' || block.name) {
+          assistantRun.toolUses.push({
+            id: block.id || `tool-${lineIdx}-${assistantRun.toolUses.length}`,
+            name: block.name || block.type,
+            input: block.input || {},
+          })
+        }
+      }
+    }
+  }
+
+  flushAssistantRun()
+
+  return {
+    meta: { title, cwd: '', sessionId: '', source: 'cursor' },
+    messages: messages.filter((m) => {
+      if (m.role === 'assistant') {
+        return m.text || m.thinking || m.toolUses?.length > 0
+      }
+      return true
+    }),
+  }
+}
+
+export function searchInCursorTranscript(filePath, query) {
+  if (!query?.trim()) {
+    return { matches: [], hits: [], total: 0 }
+  }
+  const { messages } = parseCursorTranscript(filePath)
+  const matches = searchMessages(messages, query)
+  return {
+    matches,
+    hits: dedupeHitsByMessage(matches),
+    total: matches.length,
+  }
+}

package/server/parser.js

@@ -0,0 +1,208 @@
+import fs from 'fs'
+import { searchMessages, dedupeHitsByMessage } from './search-utils.js'
+
+const SKIP_TYPES = new Set([
+  'file-history-snapshot',
+  'permission-mode',
+  'last-prompt',
+  'queue-operation',
+])
+
+/**
+ * 解析 JSONL 为前端可渲染的消息列表
+ * @returns {{ messages: object[], meta: object }}
+ */
+export function parseTranscript(filePath) {
+  const raw = fs.readFileSync(filePath, 'utf8')
+  const lines = raw.split('\n').filter((l) => l.trim())
+
+  const messages = []
+  const assistantBuffer = new Map() // messageId -> merged assistant
+  let title = ''
+  let cwd = ''
+  let sessionId = ''
+
+  const flushAssistant = (msgId) => {
+    const buf = assistantBuffer.get(msgId)
+    if (!buf) return
+    messages.push(buf)
+    assistantBuffer.delete(msgId)
+  }
+
+  for (const line of lines) {
+    let row
+    try {
+      row = JSON.parse(line)
+    } catch {
+      continue
+    }
+
+    if (row.sessionId) sessionId = row.sessionId
+    if (row.cwd) cwd = row.cwd
+    if (row.type === 'ai-title' && row.aiTitle) title = row.aiTitle
+
+    if (SKIP_TYPES.has(row.type)) continue
+
+    if (row.type === 'attachment') {
+      const att = row.attachment
+      if (att?.type === 'skill_listing') continue // 技能列表太长，默认折叠为摘要
+      messages.push({
+        id: row.uuid,
+        role: 'system',
+        subtype: 'attachment',
+        timestamp: row.timestamp,
+        attachmentType: att?.type,
+        text: typeof att?.content === 'string' ? att.content : JSON.stringify(att, null, 2),
+      })
+      continue
+    }
+
+    if (row.type === 'system') {
+      if (row.subtype === 'turn_duration') {
+        messages.push({
+          id: row.uuid,
+          role: 'system',
+          subtype: 'turn_duration',
+          timestamp: row.timestamp,
+          durationMs: row.durationMs,
+          messageCount: row.messageCount,
+        })
+      }
+      continue
+    }
+
+    if (row.type === 'user') {
+      // flush any pending assistants before user turn
+      for (const msgId of [...assistantBuffer.keys()]) {
+        flushAssistant(msgId)
+      }
+
+      const content = row.message?.content
+      const toolResults = []
+      let text = ''
+
+      if (typeof content === 'string') {
+        text = content
+      } else if (Array.isArray(content)) {
+        for (const block of content) {
+          if (block?.type === 'text') text += (block.text || '') + '\n'
+          if (block?.type === 'tool_result') {
+            toolResults.push({
+              toolUseId: block.tool_use_id,
+              content: normalizeToolResultContent(block.content),
+              isError: !!block.is_error,
+            })
+          }
+        }
+        text = text.trim()
+      }
+
+      if (toolResults.length > 0) {
+        for (const tr of toolResults) {
+          messages.push({
+            id: `${row.uuid}-${tr.toolUseId}`,
+            role: 'tool_result',
+            timestamp: row.timestamp,
+            toolUseId: tr.toolUseId,
+            content: tr.content,
+            isError: tr.isError,
+          })
+        }
+      }
+
+      if (text) {
+        messages.push({
+          id: row.uuid,
+          role: 'user',
+          timestamp: row.timestamp,
+          text,
+        })
+      }
+      continue
+    }
+
+    if (row.type === 'assistant') {
+      const msg = row.message
+      if (!msg) continue
+
+      const msgId = msg.id || row.uuid
+      let buf = assistantBuffer.get(msgId)
+      if (!buf) {
+        buf = {
+          id: row.uuid,
+          messageId: msgId,
+          role: 'assistant',
+          timestamp: row.timestamp,
+          model: msg.model,
+          thinking: '',
+          text: '',
+          toolUses: [],
+        }
+        assistantBuffer.set(msgId, buf)
+      }
+
+      if (row.timestamp) buf.timestamp = row.timestamp
+      if (msg.model) buf.model = msg.model
+
+      for (const block of msg.content || []) {
+        if (!block || typeof block !== 'object') continue
+        if (block.type === 'thinking' && block.thinking) {
+          buf.thinking += block.thinking
+        }
+        if (block.type === 'text' && block.text) {
+          buf.text += block.text
+        }
+        if (block.type === 'tool_use') {
+          buf.toolUses.push({
+            id: block.id,
+            name: block.name,
+            input: block.input,
+          })
+        }
+      }
+    }
+  }
+
+  // flush remaining assistants
+  for (const msgId of [...assistantBuffer.keys()]) {
+    flushAssistant(msgId)
+  }
+
+  return {
+    meta: { sessionId, title, cwd },
+    messages: messages.filter((m) => {
+      if (m.role === 'assistant') {
+        return m.text || m.thinking || (m.toolUses && m.toolUses.length > 0)
+      }
+      return true
+    }),
+  }
+}
+
+function normalizeToolResultContent(content) {
+  if (typeof content === 'string') return content
+  if (Array.isArray(content)) {
+    return content
+      .map((c) => {
+        if (typeof c === 'string') return c
+        if (c?.type === 'text') return c.text
+        return JSON.stringify(c)
+      })
+      .join('\n')
+  }
+  return JSON.stringify(content, null, 2)
+}
+
+/** 在会话 transcript 中全文搜索 */
+export function searchInTranscript(filePath, query) {
+  if (!query?.trim()) {
+    return { matches: [], hits: [], total: 0 }
+  }
+  const { messages } = parseTranscript(filePath)
+  const matches = searchMessages(messages, query)
+  return {
+    matches,
+    hits: dedupeHitsByMessage(matches),
+    total: matches.length,
+  }
+}

package/server/scanner-cursor.js

@@ -0,0 +1,177 @@
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+import { decodeProjectSlug } from './scanner.js'
+
+const CURSOR_DIR = path.join(os.homedir(), '.cursor')
+const PROJECTS_DIR = path.join(CURSOR_DIR, 'projects')
+const SOURCE = 'cursor'
+const ID_PREFIX = 'cursor::'
+
+export function cursorSessionId(uuid) {
+  return `${ID_PREFIX}${uuid}`
+}
+
+export function parseCursorSessionId(id) {
+  if (!id.startsWith(ID_PREFIX)) return null
+  const rest = id.slice(ID_PREFIX.length)
+  if (rest.includes('::sub::')) {
+    const [parent, agent] = rest.split('::sub::')
+    return { uuid: parent, parentSessionId: cursorSessionId(parent), agentId: agent, kind: 'subagent' }
+  }
+  return { uuid: rest, kind: 'main' }
+}
+
+function statSafe(filePath) {
+  try {
+    return fs.statSync(filePath)
+  } catch {
+    return null
+  }
+}
+
+function extractPreview(filePath) {
+  let title = ''
+  let text = ''
+  let messageCount = 0
+
+  try {
+    const content = fs.readFileSync(filePath, 'utf8')
+    for (const line of content.split('\n').slice(0, 100)) {
+      if (!line.trim()) continue
+      try {
+        const row = JSON.parse(line)
+        const role = row.role || row.type
+        if (role === 'user' && row.message?.content) {
+          messageCount++
+          const c = row.message.content
+          let t = ''
+          if (typeof c === 'string') t = c
+          else if (Array.isArray(c)) {
+            t = c.filter((x) => x?.type === 'text').map((x) => x.text).join('')
+          }
+          const m = t.match(/<user_query>\s*([\s\S]*?)\s*<\/user_query>/i)
+          if (m) t = m[1]
+          t = t.replace(/<timestamp>[\s\S]*?<\/timestamp>/gi, '').trim()
+          if (t && !text) text = t.slice(0, 120)
+          if (t && !title) title = t.slice(0, 60)
+        }
+        if (role === 'assistant') messageCount++
+      } catch {
+        /* skip */
+      }
+    }
+    for (const line of content.split('\n')) {
+      if (!line.trim()) continue
+      try {
+        const row = JSON.parse(line)
+        if (row.role === 'user' || row.role === 'assistant') messageCount++
+      } catch {
+        /* skip */
+      }
+    }
+  } catch {
+    /* ignore */
+  }
+
+  return { title, text, messageCount }
+}
+
+function decodeCursorProjectSlug(slug) {
+  if (/^\d+$/.test(slug)) return `Cursor 工作区 #${slug}`
+  return decodeProjectSlug(slug)
+}
+
+function buildRecord({
+  id,
+  projectSlug,
+  filePath,
+  kind,
+  parentSessionId,
+  stat,
+}) {
+  const preview = extractPreview(filePath)
+  return {
+    id,
+    source: SOURCE,
+    kind,
+    parentSessionId,
+    projectSlug,
+    projectPath: decodeCursorProjectSlug(projectSlug),
+    filePath,
+    title: preview.title || (kind === 'subagent' ? 'Sub-agent' : '未命名会话'),
+    preview: preview.text,
+    cwd: decodeCursorProjectSlug(projectSlug),
+    startedAt: stat?.birthtimeMs,
+    updatedAt: stat?.mtimeMs,
+    messageCount: preview.messageCount,
+    agentType: kind === 'subagent' ? 'cursor-subagent' : null,
+    agentDescription: null,
+  }
+}
+
+function scanCursorSubagents(projectSlug, parentUuid, transcriptsDir) {
+  const subDir = path.join(transcriptsDir, parentUuid, 'subagents')
+  if (!fs.existsSync(subDir)) return []
+
+  const list = []
+  for (const entry of fs.readdirSync(subDir)) {
+    if (!entry.endsWith('.jsonl')) continue
+    const filePath = path.join(subDir, entry)
+    const stat = statSafe(filePath)
+    if (!stat) continue
+
+    const agentId = entry.replace(/\.jsonl$/, '')
+    const parentId = cursorSessionId(parentUuid)
+    list.push(
+      buildRecord({
+        id: `${parentId}::sub::${agentId}`,
+        projectSlug,
+        filePath,
+        kind: 'subagent',
+        parentSessionId: parentId,
+        stat,
+      })
+    )
+  }
+  list.sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0))
+  return list
+}
+
+/** 扫描 ~/.cursor/projects 下 agent-transcripts 目录中的 jsonl */
+export function scanCursorSessions() {
+  const sessions = []
+  if (!fs.existsSync(PROJECTS_DIR)) return sessions
+
+  for (const projectSlug of fs.readdirSync(PROJECTS_DIR)) {
+    const transcriptsDir = path.join(PROJECTS_DIR, projectSlug, 'agent-transcripts')
+    if (!fs.existsSync(transcriptsDir)) continue
+
+    for (const sessionUuid of fs.readdirSync(transcriptsDir)) {
+      const sessionDir = path.join(transcriptsDir, sessionUuid)
+      if (!fs.statSync(sessionDir).isDirectory()) continue
+
+      const mainFile = path.join(sessionDir, `${sessionUuid}.jsonl`)
+      if (fs.existsSync(mainFile) && fs.statSync(mainFile).isFile()) {
+        const stat = statSafe(mainFile)
+        sessions.push(
+          buildRecord({
+            id: cursorSessionId(sessionUuid),
+            projectSlug,
+            filePath: mainFile,
+            kind: 'main',
+            parentSessionId: null,
+            stat,
+          })
+        )
+        sessions.push(...scanCursorSubagents(projectSlug, sessionUuid, transcriptsDir))
+      }
+    }
+  }
+
+  return sessions
+}
+
+export function getCursorDir() {
+  return CURSOR_DIR
+}