@jhihjian/claude-daemon 1.1.0

package/lib/logger.ts

@@ -0,0 +1,140 @@
+/**
+ * logger.ts
+ * 统一的日志系统
+ *
+ * 功能：
+ * - 分级日志（DEBUG、INFO、WARN、ERROR）
+ * - 可配置日志级别
+ * - 结构化日志输出
+ * - 性能友好（不阻塞）
+ */
+
+export enum LogLevel {
+  DEBUG = 0,
+  INFO = 1,
+  WARN = 2,
+  ERROR = 3,
+  SILENT = 4,
+}
+
+interface LoggerOptions {
+  level?: LogLevel;
+  prefix?: string;
+  enableColors?: boolean;
+}
+
+class Logger {
+  private level: LogLevel;
+  private prefix: string;
+  private enableColors: boolean;
+
+  constructor(options: LoggerOptions = {}) {
+    // 从环境变量读取日志级别
+    const envLevel = process.env.SESSION_LOG_LEVEL?.toUpperCase();
+    this.level = envLevel ? LogLevel[envLevel as keyof typeof LogLevel] || LogLevel.INFO : (options.level ?? LogLevel.INFO);
+    this.prefix = options.prefix || '';
+    this.enableColors = options.enableColors ?? true;
+  }
+
+  private shouldLog(level: LogLevel): boolean {
+    return level >= this.level;
+  }
+
+  private formatMessage(level: string, message: string, data?: any): string {
+    const timestamp = new Date().toISOString();
+    const prefix = this.prefix ? `[${this.prefix}] ` : '';
+
+    let output = `${timestamp} ${prefix}${level}: ${message}`;
+
+    if (data !== undefined) {
+      if (typeof data === 'object' && data !== null) {
+        output += '\n' + JSON.stringify(data, null, 2);
+      } else {
+        output += ` ${data}`;
+      }
+    }
+
+    return output;
+  }
+
+  private colorize(text: string, colorCode: number): string {
+    if (!this.enableColors) return text;
+    return `\x1b[${colorCode}m${text}\x1b[0m`;
+  }
+
+  debug(message: string, data?: any): void {
+    if (!this.shouldLog(LogLevel.DEBUG)) return;
+
+    const formatted = this.formatMessage('DEBUG', message, data);
+    console.error(this.colorize(formatted, 90)); // Gray
+  }
+
+  info(message: string, data?: any): void {
+    if (!this.shouldLog(LogLevel.INFO)) return;
+
+    const formatted = this.formatMessage('INFO', message, data);
+    console.error(this.colorize(formatted, 36)); // Cyan
+  }
+
+  warn(message: string, data?: any): void {
+    if (!this.shouldLog(LogLevel.WARN)) return;
+
+    const formatted = this.formatMessage('WARN', message, data);
+    console.error(this.colorize(formatted, 33)); // Yellow
+  }
+
+  error(message: string, data?: any): void {
+    if (!this.shouldLog(LogLevel.ERROR)) return;
+
+    const formatted = this.formatMessage('ERROR', message, data);
+    console.error(this.colorize(formatted, 31)); // Red
+  }
+
+  /**
+   * 记录性能指标
+   */
+  perf(operation: string, startTime: number): void {
+    if (!this.shouldLog(LogLevel.DEBUG)) return;
+
+    const duration = Date.now() - startTime;
+    this.debug(`Performance: ${operation}`, { duration_ms: duration });
+  }
+
+  /**
+   * 创建子 Logger（带新前缀）
+   */
+  child(prefix: string): Logger {
+    const childPrefix = this.prefix ? `${this.prefix}:${prefix}` : prefix;
+    return new Logger({
+      level: this.level,
+      prefix: childPrefix,
+      enableColors: this.enableColors,
+    });
+  }
+
+  /**
+   * 设置日志级别
+   */
+  setLevel(level: LogLevel): void {
+    this.level = level;
+  }
+}
+
+/**
+ * 默认 logger 实例
+ */
+export const logger = new Logger();
+
+/**
+ * 创建带前缀的 logger
+ */
+export function createLogger(prefix: string, options?: Omit<LoggerOptions, 'prefix'>): Logger {
+  return new Logger({ ...options, prefix });
+}
+
+/**
+ * 用于 Hook 的快速 logger 创建函数
+ */
+export function createHookLogger(hookName: string): Logger {
+  return createLogger(hookName, { level: LogLevel.INFO });
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@jhihjian/claude-daemon",
+  "version": "1.1.0",
+  "description": "Claude Code 会话历史记录系统 - 自动记录、分类和分析 Claude Code 会话",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "session-history",
+    "hooks",
+    "ai",
+    "typescript",
+    "bun"
+  ],
+  "author": "JhihJian <JhihJian@users.noreply.github.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/JhihJian/claude-daemon#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JhihJian/claude-daemon.git"
+  },
+  "bugs": {
+    "url": "https://github.com/JhihJian/claude-daemon/issues"
+  },
+  "bin": {
+    "claude-daemon": "./bin/cli.js"
+  },
+  "files": [
+    "hooks/",
+    "lib/",
+    "tools/",
+    "bin/",
+    "install.sh",
+    "README.md",
+    "QUICKSTART.md"
+  ],
+  "scripts": {
+    "postinstall": "echo '\n🎉 @jhihjian/claude-daemon 安装成功！\n\n使用方法:\n  npx @jhihjian/claude-daemon install\n\n或查看文档:\n  https://github.com/JhihJian/claude-daemon\n'"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/tools/SessionQuery.ts

@@ -0,0 +1,262 @@
+#!/usr/bin/env bun
+/**
+ * SessionQuery.ts
+ * 会话查询工具
+ *
+ * 提供灵活的会话查询接口，支持按类型、目录、时间范围查询
+ */
+
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// ============================================================================
+// 类型定义
+// ============================================================================
+
+type SessionType =
+  | 'coding'
+  | 'debugging'
+  | 'research'
+  | 'writing'
+  | 'git'
+  | 'refactoring'
+  | 'mixed';
+
+interface SessionSummary {
+  session_id: string;
+  timestamp: string;
+  working_directory: string;
+  git_repo: string | null;
+  git_branch: string | null;
+  hostname: string;
+  user: string;
+  platform: string;
+  session_type: SessionType;
+  duration_seconds: number;
+  total_tools: number;
+  success_rate: number;
+  files_modified: string[];
+  tool_usage: Record<string, number>;
+  summary_text: string;
+  conversation?: {
+    user_messages: string[];
+    assistant_responses: string[];
+    message_count: number;
+  };
+}
+
+interface QueryOptions {
+  // 按类型过滤
+  type?: SessionType;
+
+  // 按目录过滤
+  directory?: string;
+
+  // 按时间范围过滤
+  start_date?: string;  // ISO 8601
+  end_date?: string;
+
+  // 限制结果数量
+  limit?: number;
+
+  // 排序
+  sort_by?: 'timestamp' | 'duration' | 'tools';
+  sort_order?: 'asc' | 'desc';
+}
+
+// ============================================================================
+// SessionQuery 类
+// ============================================================================
+
+export class SessionQuery {
+  private paiDir: string;
+
+  constructor(paiDir?: string) {
+    this.paiDir = paiDir || process.env.PAI_DIR || join(homedir(), '.claude');
+  }
+
+  /**
+   * 按类型查询会话
+   */
+  queryByType(type: SessionType, options?: QueryOptions): SessionSummary[] {
+    const typeDir = join(this.paiDir, 'SESSIONS/analysis/by-type', type);
+    const indexFile = join(typeDir, 'sessions.json');
+
+    if (!existsSync(indexFile)) {
+      return [];
+    }
+
+    const sessions = JSON.parse(readFileSync(indexFile, 'utf-8'));
+    return this.applyFilters(sessions, options);
+  }
+
+  /**
+   * 按目录查询会话
+   */
+  queryByDirectory(directory: string, options?: QueryOptions): SessionSummary[] {
+    const dirHash = this.encodePath(directory);
+    const dirIndexDir = join(this.paiDir, 'SESSIONS/analysis/by-directory', dirHash);
+    const indexFile = join(dirIndexDir, 'sessions.json');
+
+    if (!existsSync(indexFile)) {
+      return [];
+    }
+
+    const sessions = JSON.parse(readFileSync(indexFile, 'utf-8'));
+    return this.applyFilters(sessions, options);
+  }
+
+  /**
+   * 按主机名查询会话
+   */
+  queryByHostname(hostname: string, options?: QueryOptions): SessionSummary[] {
+    const allSessions = this.getRecentSessions(1000); // 获取所有会话
+    const filtered = allSessions.filter(s => s.hostname === hostname);
+    return this.applyFilters(filtered, options);
+  }
+
+  /**
+   * 按时间范围查询会话
+   */
+  queryByTimeRange(startDate: string, endDate: string, options?: QueryOptions): SessionSummary[] {
+    const allSessions: SessionSummary[] = [];
+
+    // 遍历所有月份目录
+    const summariesDir = join(this.paiDir, 'SESSIONS/analysis/summaries');
+
+    if (!existsSync(summariesDir)) {
+      return [];
+    }
+
+    const months = readdirSync(summariesDir);
+
+    for (const month of months) {
+      const monthDir = join(summariesDir, month);
+
+      if (!existsSync(monthDir)) continue;
+
+      const files = readdirSync(monthDir);
+
+      for (const file of files) {
+        if (file.startsWith('summary-') && file.endsWith('.json')) {
+          const summaryPath = join(monthDir, file);
+          const summary = JSON.parse(readFileSync(summaryPath, 'utf-8'));
+
+          // 时间范围过滤
+          if (summary.timestamp >= startDate && summary.timestamp <= endDate) {
+            allSessions.push(summary);
+          }
+        }
+      }
+    }
+
+    return this.applyFilters(allSessions, options);
+  }
+
+  /**
+   * 获取最近的会话
+   */
+  getRecentSessions(limit: number = 10): SessionSummary[] {
+    const now = new Date().toISOString();
+    const monthAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
+
+    return this.queryByTimeRange(monthAgo, now, {
+      limit,
+      sort_by: 'timestamp',
+      sort_order: 'desc',
+    });
+  }
+
+  /**
+   * 应用过滤和排序
+   */
+  private applyFilters(
+    sessions: SessionSummary[],
+    options?: QueryOptions
+  ): SessionSummary[] {
+    let filtered = [...sessions];
+
+    // 时间范围过滤
+    if (options?.start_date) {
+      filtered = filtered.filter(s => s.timestamp >= options.start_date!);
+    }
+    if (options?.end_date) {
+      filtered = filtered.filter(s => s.timestamp <= options.end_date!);
+    }
+
+    // 排序
+    if (options?.sort_by) {
+      filtered.sort((a, b) => {
+        const aVal = a[options.sort_by!] as any;
+        const bVal = b[options.sort_by!] as any;
+        const order = options.sort_order === 'asc' ? 1 : -1;
+        return (aVal > bVal ? 1 : -1) * order;
+      });
+    }
+
+    // 限制数量
+    if (options?.limit) {
+      filtered = filtered.slice(0, options.limit);
+    }
+
+    return filtered;
+  }
+
+  /**
+   * 编码路径为 Base64
+   */
+  private encodePath(path: string): string {
+    return Buffer.from(path)
+      .toString('base64')
+      .replace(/\//g, '_')
+      .replace(/\+/g, '-')
+      .replace(/=/g, '');
+  }
+}
+
+// ============================================================================
+// 导出单例
+// ============================================================================
+
+export const sessionQuery = new SessionQuery();
+
+// ============================================================================
+// CLI 入口（如果直接运行）
+// ============================================================================
+
+if (import.meta.main) {
+  const command = process.argv[2];
+  const arg = process.argv[3];
+
+  switch (command) {
+    case 'type':
+      const sessions = sessionQuery.queryByType(arg as SessionType, { limit: 20 });
+      console.log(JSON.stringify(sessions, null, 2));
+      break;
+
+    case 'dir':
+      const dirSessions = sessionQuery.queryByDirectory(arg);
+      console.log(JSON.stringify(dirSessions, null, 2));
+      break;
+
+    case 'host':
+    case 'hostname':
+      const hostSessions = sessionQuery.queryByHostname(arg, { limit: 20 });
+      console.log(JSON.stringify(hostSessions, null, 2));
+      break;
+
+    case 'recent':
+      const limit = arg ? parseInt(arg, 10) : 10;
+      const recentSessions = sessionQuery.getRecentSessions(limit);
+      console.log(JSON.stringify(recentSessions, null, 2));
+      break;
+
+    default:
+      console.log('Usage:');
+      console.log('  bun SessionQuery.ts type <type>');
+      console.log('  bun SessionQuery.ts dir <directory>');
+      console.log('  bun SessionQuery.ts host <hostname>');
+      console.log('  bun SessionQuery.ts recent [limit]');
+  }
+}

package/tools/SessionStats.ts

@@ -0,0 +1,139 @@
+#!/usr/bin/env bun
+/**
+ * SessionStats.ts
+ * 会话统计分析工具
+ *
+ * 提供统计分析和可视化数据
+ */
+
+import { readFileSync, readdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// ============================================================================
+// 类型定义
+// ============================================================================
+
+type SessionType = 'coding' | 'debugging' | 'research' | 'writing' | 'git' | 'refactoring' | 'mixed';
+
+interface Stats {
+  total_sessions: number;
+  total_duration_hours: number;
+  avg_session_duration_minutes: number;
+  by_type: Record<string, number>;
+  by_directory: Record<string, number>;
+}
+
+// ============================================================================
+// SessionStats 类
+// ============================================================================
+
+export class SessionStats {
+  private paiDir: string;
+
+  constructor(paiDir?: string) {
+    this.paiDir = paiDir || process.env.PAI_DIR || join(homedir(), '.claude');
+  }
+
+  /**
+   * 获取全局统计
+   */
+  getGlobalStats(): Stats {
+    const metadataFile = join(this.paiDir, 'SESSIONS/index/metadata.json');
+
+    if (!existsSync(metadataFile)) {
+      return this.emptyStats();
+    }
+
+    const metadata = JSON.parse(readFileSync(metadataFile, 'utf-8'));
+
+    return {
+      total_sessions: metadata.total_sessions || 0,
+      total_duration_hours: 0, // 需要遍历所有会话计算
+      avg_session_duration_minutes: 0,
+      by_type: metadata.sessions_by_type || {},
+      by_directory: metadata.sessions_by_directory || {},
+    };
+  }
+
+  /**
+   * 获取类型分布
+   */
+  getTypeDistribution(): Record<SessionType, number> {
+    const metadataFile = join(this.paiDir, 'SESSIONS/index/metadata.json');
+
+    if (!existsSync(metadataFile)) {
+      return {} as Record<SessionType, number>;
+    }
+
+    const metadata = JSON.parse(readFileSync(metadataFile, 'utf-8'));
+    return metadata.sessions_by_type || {};
+  }
+
+  /**
+   * 获取最活跃的目录
+   */
+  getTopDirectories(limit: number = 10): Array<{ directory: string; count: number }> {
+    const metadataFile = join(this.paiDir, 'SESSIONS/index/metadata.json');
+
+    if (!existsSync(metadataFile)) {
+      return [];
+    }
+
+    const metadata = JSON.parse(readFileSync(metadataFile, 'utf-8'));
+    const byDir = metadata.sessions_by_directory || {};
+
+    return Object.entries(byDir)
+      .map(([directory, count]) => ({ directory, count: count as number }))
+      .sort((a, b) => b.count - a.count)
+      .slice(0, limit);
+  }
+
+  private emptyStats(): Stats {
+    return {
+      total_sessions: 0,
+      total_duration_hours: 0,
+      avg_session_duration_minutes: 0,
+      by_type: {},
+      by_directory: {},
+    };
+  }
+}
+
+// ============================================================================
+// 导出单例
+// ============================================================================
+
+export const sessionStats = new SessionStats();
+
+// ============================================================================
+// CLI 入口
+// ============================================================================
+
+if (import.meta.main) {
+  const command = process.argv[2];
+
+  switch (command) {
+    case 'global':
+      const stats = sessionStats.getGlobalStats();
+      console.log(JSON.stringify(stats, null, 2));
+      break;
+
+    case 'types':
+      const types = sessionStats.getTypeDistribution();
+      console.log(JSON.stringify(types, null, 2));
+      break;
+
+    case 'dirs':
+      const limit = process.argv[3] ? parseInt(process.argv[3], 10) : 10;
+      const dirs = sessionStats.getTopDirectories(limit);
+      console.log(JSON.stringify(dirs, null, 2));
+      break;
+
+    default:
+      console.log('Usage:');
+      console.log('  bun SessionStats.ts global');
+      console.log('  bun SessionStats.ts types');
+      console.log('  bun SessionStats.ts dirs [limit]');
+  }
+}

package/tools/show-conversation.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+# 显示会话对话内容的友好脚本
+
+SESSION_ID=$1
+
+if [ -z "$SESSION_ID" ]; then
+  echo "用法: $0 <session_id>"
+  echo ""
+  echo "示例:"
+  echo "  $0 04291516-d83b-4436-86c2-138eb01a1bf4"
+  echo ""
+  echo "或者查看最近的会话:"
+  echo "  ~/.bun/bin/bun /data/app/claude-history/tools/SessionQuery.ts recent 1 | jq -r '.[0].session_id' | xargs $0"
+  exit 1
+fi
+
+# 查找summary文件
+SUMMARY_FILE=$(find ~/.claude/SESSIONS/analysis/summaries -name "summary-${SESSION_ID}.json" 2>/dev/null | head -1)
+
+if [ -z "$SUMMARY_FILE" ]; then
+  echo "错误: 找不到会话 $SESSION_ID"
+  exit 1
+fi
+
+# 提取并显示信息
+echo "========================================"
+echo "会话详情"
+echo "========================================"
+echo ""
+
+# 基本信息
+echo "📋 会话ID: $SESSION_ID"
+echo "🖥️  主机: $(jq -r '.hostname' "$SUMMARY_FILE") ($(jq -r '.user' "$SUMMARY_FILE")@$(jq -r '.platform' "$SUMMARY_FILE"))"
+echo "📁 工作目录: $(jq -r '.working_directory' "$SUMMARY_FILE")"
+echo "📅 时间: $(jq -r '.timestamp' "$SUMMARY_FILE")"
+echo "🏷️  类型: $(jq -r '.session_type' "$SUMMARY_FILE")"
+echo ""
+
+# 对话内容
+echo "========================================"
+echo "💬 对话内容"
+echo "========================================"
+echo ""
+
+# 提取用户消息和助手回复
+USER_MSGS=$(jq -r '.conversation.user_messages[]?' "$SUMMARY_FILE" 2>/dev/null)
+ASST_MSGS=$(jq -r '.conversation.assistant_responses[]?' "$SUMMARY_FILE" 2>/dev/null)
+
+if [ -z "$USER_MSGS" ]; then
+  echo "⚠️  没有记录对话内容"
+else
+  # 交替显示用户和助手消息
+  jq -r '.conversation |
+    .user_messages as $users |
+    .assistant_responses as $assts |
+    range(0; [$users, $assts] | map(length) | max) |
+    (
+      if $users[.] then "👤 用户: \($users[.])\n" else "" end,
+      if $assts[.] then "🤖 Claude: \($assts[.])\n" else "" end
+    )' "$SUMMARY_FILE"
+fi
+
+echo ""
+echo "========================================"
+echo "🔧 工具使用"
+echo "========================================"
+echo ""
+
+TOOL_COUNT=$(jq -r '.total_tools' "$SUMMARY_FILE")
+if [ "$TOOL_COUNT" -eq 0 ]; then
+  echo "没有使用工具"
+else
+  echo "总计: $TOOL_COUNT 次工具调用"
+  echo ""
+  jq -r '.tool_usage | to_entries[] | "  - \(.key): \(.value) 次"' "$SUMMARY_FILE"
+  echo ""
+  echo "成功率: $(jq -r '.success_rate' "$SUMMARY_FILE")%"
+fi
+
+echo ""