@jhihjian/claude-daemon 1.1.0

package/install.sh

@@ -0,0 +1,257 @@
+#!/bin/bash
+# Claude Code 会话历史系统 - 一键安装脚本
+# 支持在任何电脑上快速部署
+
+set -e
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}======================================${NC}"
+echo -e "${GREEN}Claude Code 会话历史系统 - 安装程序${NC}"
+echo -e "${GREEN}======================================${NC}"
+echo ""
+
+# 检测系统
+OS=$(uname -s)
+echo -e "${YELLOW}检测到系统: $OS${NC}"
+
+# 获取脚本所在目录
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+echo -e "${YELLOW}安装源目录: $SCRIPT_DIR${NC}"
+echo ""
+
+# 1. 检查 Bun
+echo -e "${GREEN}[1/6] 检查 Bun 运行时...${NC}"
+if command -v bun &> /dev/null; then
+    BUN_PATH=$(which bun)
+    echo -e "${GREEN}✓ Bun 已安装: $BUN_PATH${NC}"
+else
+    echo -e "${YELLOW}⚠ Bun 未安装，正在安装...${NC}"
+    curl -fsSL https://bun.sh/install | bash
+
+    # 添加到当前 shell
+    export BUN_INSTALL="$HOME/.bun"
+    export PATH="$BUN_INSTALL/bin:$PATH"
+
+    BUN_PATH="$HOME/.bun/bin/bun"
+    echo -e "${GREEN}✓ Bun 安装完成: $BUN_PATH${NC}"
+fi
+echo ""
+
+# 2. 创建目录结构（设置安全权限）
+echo -e "${GREEN}[2/6] 创建目录结构...${NC}"
+mkdir -p ~/.claude/SESSIONS/raw
+mkdir -p ~/.claude/SESSIONS/analysis/summaries
+mkdir -p ~/.claude/SESSIONS/analysis/by-type
+mkdir -p ~/.claude/SESSIONS/analysis/by-directory
+mkdir -p ~/.claude/SESSIONS/index
+mkdir -p ~/.claude/hooks
+
+# 设置目录权限：700（仅所有者可访问）
+chmod 700 ~/.claude/SESSIONS
+chmod -R 700 ~/.claude/SESSIONS/*
+chmod 700 ~/.claude/hooks
+
+echo -e "${GREEN}✓ 目录创建完成（权限：700）${NC}"
+echo ""
+
+# 3. 配置 hooks（使用 #!/usr/bin/env bun）
+echo -e "${GREEN}[3/6] 配置 hooks...${NC}"
+for hook in "$SCRIPT_DIR/hooks"/*.ts; do
+    if [ -f "$hook" ]; then
+        hook_name=$(basename "$hook")
+        target_hook=~/.claude/hooks/"$hook_name"
+
+        # 直接复制文件（保留 #!/usr/bin/env bun）
+        cp "$hook" "$target_hook"
+
+        # 设置权限：700（仅所有者可读写执行）
+        chmod 700 "$target_hook"
+
+        echo -e "${GREEN}  ✓ $hook_name${NC}"
+    fi
+done
+echo ""
+
+# 4. 配置 Claude Code settings
+echo -e "${GREEN}[4/7] 配置 Claude Code...${NC}"
+SETTINGS_FILE=~/.claude/settings.json
+
+if [ -f "$SETTINGS_FILE" ]; then
+    echo -e "${YELLOW}⚠ settings.json 已存在，备份到 settings.json.backup${NC}"
+    cp "$SETTINGS_FILE" "$SETTINGS_FILE.backup"
+fi
+
+# 创建或更新 settings.json
+cat > "$SETTINGS_FILE" << EOF
+{
+  "model": "opus",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$HOME/.claude/hooks/SessionRecorder.hook.ts"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$HOME/.claude/hooks/SessionToolCapture-v2.hook.ts"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$HOME/.claude/hooks/SessionAnalyzer.hook.ts"
+          }
+        ]
+      }
+    ]
+  }
+}
+EOF
+
+echo -e "${GREEN}✓ settings.json 配置完成${NC}"
+echo ""
+
+# 5. 安装查询工具
+echo -e "${GREEN}[5/7] 安装查询工具...${NC}"
+mkdir -p ~/bin
+
+# 创建查询工具的包装脚本
+cat > ~/bin/claude-sessions << EOF
+#!/bin/bash
+# Claude 会话历史查询工具
+
+BUN_PATH="$BUN_PATH"
+TOOLS_DIR="$SCRIPT_DIR/tools"
+
+case "\$1" in
+  recent|type|dir)
+    \$BUN_PATH \$TOOLS_DIR/SessionQuery.ts "\$@"
+    ;;
+  stats)
+    shift
+    \$BUN_PATH \$TOOLS_DIR/SessionStats.ts "\$@"
+    ;;
+  show)
+    \$TOOLS_DIR/show-conversation.sh "\$2"
+    ;;
+  *)
+    echo "用法:"
+    echo "  claude-sessions recent [N]       - 查看最近 N 个会话"
+    echo "  claude-sessions type <类型>      - 查看指定类型的会话"
+    echo "  claude-sessions dir <目录>       - 查看指定目录的会话"
+    echo "  claude-sessions stats global     - 查看全局统计"
+    echo "  claude-sessions show <会话ID>    - 查看会话详情"
+    ;;
+esac
+EOF
+
+chmod +x ~/bin/claude-sessions
+echo -e "${GREEN}✓ 查询工具安装完成${NC}"
+echo ""
+
+# 6. 添加到 PATH
+echo -e "${GREEN}[6/7] 配置环境变量...${NC}"
+
+# 检测 shell
+if [ -n "$ZSH_VERSION" ]; then
+    SHELL_RC=~/.zshrc
+elif [ -n "$BASH_VERSION" ]; then
+    SHELL_RC=~/.bashrc
+else
+    SHELL_RC=~/.profile
+fi
+
+# 添加 PATH
+if ! grep -q "export PATH=\"\$HOME/bin:\$PATH\"" "$SHELL_RC"; then
+    echo "" >> "$SHELL_RC"
+    echo "# Claude 会话历史工具" >> "$SHELL_RC"
+    echo "export PATH=\"\$HOME/bin:\$PATH\"" >> "$SHELL_RC"
+    echo -e "${GREEN}✓ 已添加到 $SHELL_RC${NC}"
+else
+    echo -e "${GREEN}✓ PATH 已配置${NC}"
+fi
+
+echo ""
+
+# 7. 验证安装
+echo -e "${GREEN}[7/7] 验证安装...${NC}"
+
+# 检查 Bun 是否在 PATH 中
+if command -v bun &> /dev/null; then
+    echo -e "${GREEN}  ✓ Bun 在 PATH 中${NC}"
+else
+    echo -e "${YELLOW}  ⚠ Bun 不在 PATH 中，hooks 可能无法执行${NC}"
+    echo -e "${YELLOW}    请确保 ~/.bun/bin 在 PATH 中${NC}"
+fi
+
+# 检查 hooks 是否可执行
+hooks_ok=true
+for hook_name in SessionRecorder.hook.ts SessionToolCapture-v2.hook.ts SessionAnalyzer.hook.ts; do
+    hook_file=~/.claude/hooks/$hook_name
+    if [ -x "$hook_file" ]; then
+        echo -e "${GREEN}  ✓ $hook_name 可执行${NC}"
+    else
+        echo -e "${RED}  ✗ $hook_name 不可执行${NC}"
+        hooks_ok=false
+    fi
+done
+
+# 检查目录权限
+if [ -d ~/.claude/SESSIONS ] && [ "$(stat -c %a ~/.claude/SESSIONS 2>/dev/null || stat -f %A ~/.claude/SESSIONS 2>/dev/null)" = "700" ]; then
+    echo -e "${GREEN}  ✓ 目录权限正确（700）${NC}"
+else
+    echo -e "${YELLOW}  ⚠ 目录权限可能不正确${NC}"
+fi
+
+# 检查 lib 目录
+if [ -d "$SCRIPT_DIR/lib" ] && [ -f "$SCRIPT_DIR/lib/logger.ts" ]; then
+    echo -e "${GREEN}  ✓ lib 目录存在${NC}"
+else
+    echo -e "${RED}  ✗ lib 目录不存在或不完整${NC}"
+    hooks_ok=false
+fi
+
+echo ""
+
+if [ "$hooks_ok" = true ]; then
+    echo -e "${GREEN}======================================${NC}"
+    echo -e "${GREEN}✓ 安装完成！${NC}"
+    echo -e "${GREEN}======================================${NC}"
+else
+    echo -e "${YELLOW}======================================${NC}"
+    echo -e "${YELLOW}⚠ 安装完成，但有警告${NC}"
+    echo -e "${YELLOW}======================================${NC}"
+fi
+
+echo ""
+echo -e "${YELLOW}使用方法:${NC}"
+echo ""
+echo -e "  ${GREEN}claude-sessions recent 5${NC}      # 查看最近 5 个会话"
+echo -e "  ${GREEN}claude-sessions stats global${NC}  # 查看统计信息"
+echo -e "  ${GREEN}claude-sessions show <ID>${NC}     # 查看会话详情"
+echo ""
+echo -e "${YELLOW}重要提示:${NC}"
+echo -e "  1. 重新加载 shell 配置: ${GREEN}source $SHELL_RC${NC}"
+echo -e "  2. 或者重启终端"
+echo -e "  3. 设置日志级别: ${GREEN}export SESSION_LOG_LEVEL=DEBUG${NC}"
+echo ""
+echo -e "${YELLOW}数据同步:${NC}"
+echo -e "  查看同步指南: ${GREEN}cat $SCRIPT_DIR/SYNC-GUIDE.md${NC}"
+echo ""

package/lib/config.ts

@@ -0,0 +1,223 @@
+/**
+ * config.ts
+ * 统一的配置管理模块
+ *
+ * 功能：
+ * - 集中管理所有配置项
+ * - 支持环境变量覆盖
+ * - 提供默认值
+ */
+
+import { join } from 'path';
+import { homedir } from 'os';
+import { existsSync, readFileSync } from 'fs';
+import { safeJSONParse } from './errors.ts';
+
+export interface SessionConfig {
+  // 路径配置
+  paiDir: string;
+  sessionsDir: string;
+  rawDir: string;
+  analysisDir: string;
+  summariesDir: string;
+  indexDir: string;
+
+  // 行为配置
+  maxOutputLength: number;
+  hookTimeout: number;
+  gitTimeout: number;
+
+  // 分类阈值
+  classificationThresholds: {
+    coding: number;        // Edit/Write 占比
+    debugging: number;     // 测试命令 + Read > Edit
+    research: number;      // Search 占比
+    writing: number;       // Markdown 文件编辑占比
+    git: number;          // Git 命令占比
+  };
+
+  // 日志配置
+  logLevel: string;
+
+  // 性能配置
+  enableCache: boolean;
+  cacheTTL: number;
+}
+
+class ConfigManager {
+  private config: SessionConfig;
+  private configFilePath?: string;
+
+  constructor() {
+    this.config = this.loadConfig();
+  }
+
+  private loadConfig(): SessionConfig {
+    // 默认配置
+    const defaults: SessionConfig = {
+      // 路径配置
+      paiDir: process.env.PAI_DIR || join(homedir(), '.claude'),
+      sessionsDir: '',
+      rawDir: '',
+      analysisDir: '',
+      summariesDir: '',
+      indexDir: '',
+
+      // 行为配置
+      maxOutputLength: parseInt(process.env.MAX_OUTPUT_LENGTH || '5000', 10),
+      hookTimeout: parseInt(process.env.HOOK_TIMEOUT || '10000', 10),
+      gitTimeout: parseInt(process.env.GIT_TIMEOUT || '3000', 10),
+
+      // 分类阈值
+      classificationThresholds: {
+        coding: parseFloat(process.env.THRESHOLD_CODING || '0.4'),
+        debugging: parseFloat(process.env.THRESHOLD_DEBUGGING || '0.0'),
+        research: parseFloat(process.env.THRESHOLD_RESEARCH || '0.3'),
+        writing: parseFloat(process.env.THRESHOLD_WRITING || '0.5'),
+        git: parseFloat(process.env.THRESHOLD_GIT || '0.5'),
+      },
+
+      // 日志配置
+      logLevel: process.env.SESSION_LOG_LEVEL || 'INFO',
+
+      // 性能配置
+      enableCache: process.env.ENABLE_CACHE !== 'false',
+      cacheTTL: parseInt(process.env.CACHE_TTL || '300000', 10), // 5 分钟
+    };
+
+    // 计算派生路径
+    defaults.sessionsDir = join(defaults.paiDir, 'SESSIONS');
+    defaults.rawDir = join(defaults.sessionsDir, 'raw');
+    defaults.analysisDir = join(defaults.sessionsDir, 'analysis');
+    defaults.summariesDir = join(defaults.analysisDir, 'summaries');
+    defaults.indexDir = join(defaults.sessionsDir, 'index');
+
+    // 尝试从配置文件加载
+    this.configFilePath = join(defaults.paiDir, 'session-config.json');
+    if (existsSync(this.configFilePath)) {
+      try {
+        const fileContent = readFileSync(this.configFilePath, 'utf-8');
+        const fileConfig = safeJSONParse<Partial<SessionConfig>>(
+          fileContent,
+          {},
+          'session-config.json'
+        );
+
+        // 合并配置（文件配置优先，但环境变量最优先）
+        return this.mergeConfig(defaults, fileConfig);
+      } catch (error) {
+        // 配置文件加载失败，使用默认配置
+        console.error('[Config] Failed to load config file, using defaults');
+      }
+    }
+
+    return defaults;
+  }
+
+  private mergeConfig(defaults: SessionConfig, fileConfig: Partial<SessionConfig>): SessionConfig {
+    return {
+      ...defaults,
+      ...fileConfig,
+      // 确保环境变量优先
+      paiDir: process.env.PAI_DIR || fileConfig.paiDir || defaults.paiDir,
+      maxOutputLength: parseInt(
+        process.env.MAX_OUTPUT_LENGTH ||
+        String(fileConfig.maxOutputLength || defaults.maxOutputLength),
+        10
+      ),
+      hookTimeout: parseInt(
+        process.env.HOOK_TIMEOUT ||
+        String(fileConfig.hookTimeout || defaults.hookTimeout),
+        10
+      ),
+      gitTimeout: parseInt(
+        process.env.GIT_TIMEOUT ||
+        String(fileConfig.gitTimeout || defaults.gitTimeout),
+        10
+      ),
+      logLevel: process.env.SESSION_LOG_LEVEL || fileConfig.logLevel || defaults.logLevel,
+      enableCache: process.env.ENABLE_CACHE !== 'false' &&
+        (fileConfig.enableCache ?? defaults.enableCache),
+      cacheTTL: parseInt(
+        process.env.CACHE_TTL ||
+        String(fileConfig.cacheTTL || defaults.cacheTTL),
+        10
+      ),
+    };
+  }
+
+  /**
+   * 获取配置
+   */
+  get(): SessionConfig {
+    return { ...this.config };
+  }
+
+  /**
+   * 获取特定配置项
+   */
+  getPath(key: keyof Pick<SessionConfig, 'paiDir' | 'sessionsDir' | 'rawDir' | 'analysisDir' | 'summariesDir' | 'indexDir'>): string {
+    return this.config[key];
+  }
+
+  /**
+   * 获取会话文件路径
+   */
+  getSessionFilePath(sessionId: string, yearMonth: string): string {
+    return join(this.config.rawDir, yearMonth, `session-${sessionId}.jsonl`);
+  }
+
+  /**
+   * 获取摘要文件路径
+   */
+  getSummaryFilePath(sessionId: string, yearMonth: string): string {
+    return join(this.config.summariesDir, yearMonth, `summary-${sessionId}.json`);
+  }
+
+  /**
+   * 获取类型索引路径
+   */
+  getTypeIndexPath(sessionType: string): string {
+    return join(this.config.analysisDir, 'by-type', sessionType, 'sessions.json');
+  }
+
+  /**
+   * 获取目录索引路径
+   */
+  getDirectoryIndexPath(dirHash: string): string {
+    return join(this.config.analysisDir, 'by-directory', dirHash, 'sessions.json');
+  }
+
+  /**
+   * 获取全局元数据路径
+   */
+  getMetadataPath(): string {
+    return join(this.config.indexDir, 'metadata.json');
+  }
+
+  /**
+   * 获取年月字符串
+   */
+  getYearMonth(date: Date = new Date()): string {
+    return date.toISOString().slice(0, 7);
+  }
+
+  /**
+   * 重新加载配置
+   */
+  reload(): void {
+    this.config = this.loadConfig();
+  }
+}
+
+/**
+ * 全局配置实例
+ */
+export const config = new ConfigManager();
+
+/**
+ * 便捷函数
+ */
+export function getConfig(): SessionConfig {
+  return config.get();
+}

package/lib/errors.ts

@@ -0,0 +1,213 @@
+/**
+ * errors.ts
+ * 统一的错误处理模块
+ *
+ * 功能：
+ * - 自定义错误类型
+ * - 错误恢复策略
+ * - 友好的错误消息
+ */
+
+import { logger } from './logger.ts';
+
+/**
+ * 基础错误类
+ */
+export class SessionError extends Error {
+  constructor(
+    message: string,
+    public readonly code: string,
+    public readonly recoverable: boolean = true,
+    public readonly context?: Record<string, any>
+  ) {
+    super(message);
+    this.name = 'SessionError';
+  }
+
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      recoverable: this.recoverable,
+      context: this.context,
+    };
+  }
+}
+
+/**
+ * 文件系统错误
+ */
+export class FileSystemError extends SessionError {
+  constructor(message: string, filePath: string, operation: string) {
+    super(message, 'FS_ERROR', true, { filePath, operation });
+    this.name = 'FileSystemError';
+  }
+}
+
+/**
+ * 解析错误
+ */
+export class ParseError extends SessionError {
+  constructor(message: string, data: string) {
+    super(message, 'PARSE_ERROR', true, { data: data.slice(0, 100) });
+    this.name = 'ParseError';
+  }
+}
+
+/**
+ * 配置错误
+ */
+export class ConfigError extends SessionError {
+  constructor(message: string, configKey?: string) {
+    super(message, 'CONFIG_ERROR', false, { configKey });
+    this.name = 'ConfigError';
+  }
+}
+
+/**
+ * 超时错误
+ */
+export class TimeoutError extends SessionError {
+  constructor(operation: string, timeout: number) {
+    super(`Operation timed out: ${operation}`, 'TIMEOUT_ERROR', true, {
+      operation,
+      timeout,
+    });
+    this.name = 'TimeoutError';
+  }
+}
+
+/**
+ * 执行带超时的异步操作
+ */
+export async function withTimeout<T>(
+  promise: Promise<T>,
+  timeout: number,
+  operation: string
+): Promise<T> {
+  return Promise.race([
+    promise,
+    new Promise<T>((_, reject) =>
+      setTimeout(() => reject(new TimeoutError(operation, timeout)), timeout)
+    ),
+  ]);
+}
+
+/**
+ * 安全执行函数（捕获并记录错误，但不抛出）
+ */
+export async function safeExecute<T>(
+  fn: () => Promise<T> | T,
+  fallback: T,
+  context: string
+): Promise<T> {
+  try {
+    return await fn();
+  } catch (error) {
+    logger.error(`Error in ${context}`, {
+      error: error instanceof Error ? error.message : String(error),
+      stack: error instanceof Error ? error.stack : undefined,
+    });
+    return fallback;
+  }
+}
+
+/**
+ * 重试执行函数
+ */
+export async function retry<T>(
+  fn: () => Promise<T>,
+  options: {
+    maxAttempts?: number;
+    delay?: number;
+    backoff?: number;
+    context?: string;
+  } = {}
+): Promise<T> {
+  const { maxAttempts = 3, delay = 1000, backoff = 2, context = 'operation' } = options;
+
+  let lastError: Error | undefined;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+
+      if (attempt < maxAttempts) {
+        const waitTime = delay * Math.pow(backoff, attempt - 1);
+        logger.warn(`Retry ${attempt}/${maxAttempts} for ${context}`, {
+          error: lastError.message,
+          nextRetryIn: waitTime,
+        });
+        await new Promise(resolve => setTimeout(resolve, waitTime));
+      }
+    }
+  }
+
+  throw lastError || new Error(`Failed after ${maxAttempts} attempts`);
+}
+
+/**
+ * Hook 错误处理包装器
+ * 确保 Hook 永远不会阻塞 Claude Code
+ */
+export function hookErrorHandler(hookName: string) {
+  return (error: unknown): void => {
+    // 记录错误但不抛出
+    logger.error(`Hook ${hookName} failed`, {
+      error: error instanceof Error ? error.message : String(error),
+      stack: error instanceof Error ? error.stack : undefined,
+      recoverable: error instanceof SessionError ? error.recoverable : true,
+    });
+
+    // Hook 失败不应阻塞 Claude Code
+    // 只记录到 stderr，让系统继续运行
+  };
+}
+
+/**
+ * 验证函数
+ */
+export function validateRequired<T>(
+  value: T | null | undefined,
+  fieldName: string
+): T {
+  if (value === null || value === undefined) {
+    throw new ConfigError(`Required field missing: ${fieldName}`, fieldName);
+  }
+  return value;
+}
+
+/**
+ * 验证文件路径
+ */
+export function validatePath(path: string, fieldName: string = 'path'): string {
+  if (!path || typeof path !== 'string') {
+    throw new ConfigError(`Invalid path: ${fieldName}`, fieldName);
+  }
+  if (path.includes('\0')) {
+    throw new ConfigError(`Path contains null bytes: ${fieldName}`, fieldName);
+  }
+  return path;
+}
+
+/**
+ * 安全的 JSON 解析
+ */
+export function safeJSONParse<T>(
+  data: string,
+  fallback: T,
+  context: string = 'JSON'
+): T {
+  try {
+    return JSON.parse(data) as T;
+  } catch (error) {
+    logger.warn(`Failed to parse ${context}`, {
+      error: error instanceof Error ? error.message : String(error),
+      dataPreview: data.slice(0, 100),
+    });
+    return fallback;
+  }
+}