@jhihjian/claude-daemon 1.1.0

package/QUICKSTART.md

@@ -0,0 +1,214 @@
+# Claude Code 会话历史系统 - 快速开始
+
+## 🚀 在当前电脑上使用
+
+系统已经安装并运行！
+
+### 查询会话
+
+```bash
+# 查看最近的会话
+~/.bun/bin/bun /data/app/claude-history/tools/SessionQuery.ts recent 5
+
+# 查看会话详情（包含完整对话）
+/data/app/claude-history/tools/show-conversation.sh <session_id>
+
+# 查看统计信息
+~/.bun/bin/bun /data/app/claude-history/tools/SessionStats.ts global
+```
+
+---
+
+## 📦 部署到其他电脑
+
+### 方法 1: 打包传输（最简单）
+
+**在当前电脑上：**
+```bash
+cd /data/app
+./claude-history/package.sh
+# 生成: claude-history-system-YYYYMMDD.tar.gz
+```
+
+**传输到目标电脑：**
+```bash
+scp claude-history-system-*.tar.gz user@target:/tmp/
+```
+
+**在目标电脑上：**
+```bash
+cd /tmp
+tar -xzf claude-history-system-*.tar.gz
+cd claude-history
+./install.sh
+```
+
+### 方法 2: Git 克隆
+
+**在目标电脑上：**
+```bash
+git clone <你的仓库地址> /data/app/claude-history
+cd /data/app/claude-history
+./install.sh
+```
+
+---
+
+## 🔄 数据同步设置
+
+### 选项 A: Git 同步（推荐）
+
+**1. 初始化 Git 仓库（在第一台电脑上）：**
+```bash
+cd /data/app/claude-history
+./setup-git.sh
+```
+
+按提示操作：
+- 选择 GitHub/GitLab
+- 输入用户名
+- 创建私有仓库
+
+**2. 设置自动同步：**
+```bash
+./setup-auto-sync.sh
+```
+
+选择同步频率（推荐：每小时）
+
+**3. 在其他电脑上克隆数据：**
+```bash
+# 先安装系统
+cd /tmp && tar -xzf claude-history-system-*.tar.gz
+cd claude-history && ./install.sh
+
+# 克隆会话数据
+git clone git@github.com:你的用户名/claude-sessions.git ~/.claude/SESSIONS
+
+# 设置自动同步
+cd /data/app/claude-history
+./setup-auto-sync.sh
+```
+
+### 选项 B: 云存储同步
+
+**使用 Dropbox/Google Drive：**
+```bash
+# 移动数据到云存储
+mv ~/.claude/SESSIONS ~/Dropbox/claude-sessions
+
+# 创建符号链接
+ln -s ~/Dropbox/claude-sessions ~/.claude/SESSIONS
+```
+
+在其他电脑上重复相同操作。
+
+---
+
+## 🔍 验证安装
+
+```bash
+# 1. 测试会话记录
+echo "测试会话记录" | claude -p
+
+# 2. 等待几秒
+sleep 3
+
+# 3. 查询最新会话
+~/.bun/bin/bun /data/app/claude-history/tools/SessionQuery.ts recent 1
+
+# 4. 查看对话内容
+~/.bun/bin/bun /data/app/claude-history/tools/SessionQuery.ts recent 1 | \
+  jq -r '.[0].session_id' | \
+  xargs /data/app/claude-history/tools/show-conversation.sh
+```
+
+---
+
+## 📊 常用命令
+
+```bash
+# 查询
+claude-sessions recent 10              # 最近10个会话
+claude-sessions type coding            # 编码类会话
+claude-sessions stats global           # 全局统计
+claude-sessions show <session_id>      # 会话详情
+
+# 同步（如果使用 Git）
+cd ~/.claude/SESSIONS && git pull      # 拉取更新
+cd ~/.claude/SESSIONS && git push      # 推送更新
+/data/app/claude-history/sync-git.sh   # 自动同步
+
+# 日志
+tail -f ~/.claude/sync.log             # 查看同步日志
+```
+
+---
+
+## ⚠️ 重要提示
+
+### 数据隐私
+- ✅ 使用**私有仓库**存储会话数据
+- ✅ 不要提交包含敏感信息的会话
+- ✅ 定期清理旧数据
+
+### 冲突处理
+如果多台电脑同时工作导致冲突：
+```bash
+cd ~/.claude/SESSIONS
+git pull --rebase
+# 如果有冲突，sync-git.sh 会自动合并 JSONL 文件
+```
+
+### 性能优化
+```bash
+# 归档旧数据（3个月前）
+find ~/.claude/SESSIONS/raw -type f -mtime +90 -exec gzip {} \;
+```
+
+---
+
+## 🆘 故障排除
+
+### Hooks 不工作
+```bash
+# 检查 hooks 权限
+ls -la ~/.claude/hooks/
+
+# 手动测试 hook
+echo '{"session_id":"test"}' | ~/.claude/hooks/SessionRecorder.hook.ts
+```
+
+### 同步失败
+```bash
+# 查看同步日志
+tail -50 ~/.claude/sync.log
+
+# 手动同步
+cd ~/.claude/SESSIONS
+git status
+git pull
+git push
+```
+
+### 查询工具找不到
+```bash
+# 重新加载 shell 配置
+source ~/.zshrc  # 或 ~/.bashrc
+
+# 检查 PATH
+echo $PATH | grep "$HOME/bin"
+```
+
+---
+
+## 📚 更多信息
+
+- 完整文档: `/data/app/claude-history/README.md`
+- 同步指南: `/data/app/claude-history/SYNC-GUIDE.md`
+- 故障排除: `/data/app/claude-history/README.md#故障排除`
+
+---
+
+**系统版本**: v1.0
+**最后更新**: 2026-01-24

package/README.md

@@ -0,0 +1,173 @@
+# Claude Code 会话历史记录系统
+
+> 自动记录、分类和分析 Claude Code 会话历史
+
+## 功能特性
+
+- ✅ **自动记录**：捕获每个会话的启动目录、Git 信息、工具调用
+- ✅ **智能分类**：自动识别会话类型（编码、调试、研究、写作、Git 操作等）
+- ✅ **多维索引**：按类型、按目录、按时间快速查询
+- ✅ **统计分析**：会话统计、类型分布、活跃目录分析
+- ✅ **JSONL 存储**：流式写入，易于解析和处理
+
+## 目录结构
+
+```
+/data/app/claude-history/
+├── hooks/                          # Claude Code Hooks
+│   ├── SessionRecorder.hook.ts     # 会话启动时记录
+│   ├── SessionToolCapture.hook.ts  # 工具调用时记录
+│   └── SessionAnalyzer.hook.ts     # 会话结束时分析
+├── tools/                          # 查询工具
+│   ├── SessionQuery.ts             # 会话查询
+│   └── SessionStats.ts             # 统计分析
+├── lib/                            # 共享库（预留）
+└── test/                           # 测试脚本（预留）
+```
+
+## 数据存储结构
+
+```
+~/.claude/SESSIONS/
+├── raw/                            # 原始事件流（JSONL）
+│   └── 2026-01/
+│       └── session-{id}.jsonl
+├── analysis/
+│   ├── by-type/                    # 按类型索引
+│   │   ├── coding/sessions.json
+│   │   ├── debugging/sessions.json
+│   │   └── ...
+│   ├── by-directory/               # 按目录索引
+│   │   └── {base64-path}/
+│   │       ├── path.txt
+│   │       └── sessions.json
+│   └── summaries/                  # 会话摘要
+│       └── 2026-01/
+│           └── summary-{id}.json
+└── index/
+    └── metadata.json               # 全局元数据
+```
+
+## 快速开始
+
+### 1. 安装 Hooks
+
+将 hooks 注册到 Claude Code：
+
+```bash
+# 假设 PAI_DIR=~/.claude
+cp hooks/*.hook.ts ~/.claude/hooks/
+
+# 或者创建符号链接
+ln -s /data/app/claude-history/hooks/*.hook.ts ~/.claude/hooks/
+```
+
+### 2. 配置 Hook 触发器
+
+在 `~/.claude/settings.json` 中添加：
+
+```json
+{
+  "hooks": {
+    "SessionStart": ["SessionRecorder.hook.ts"],
+    "PostToolUse": ["SessionToolCapture.hook.ts"],
+    "Stop": ["SessionAnalyzer.hook.ts"]
+  }
+}
+```
+
+### 3. 使用查询工具
+
+```bash
+# 查询最近的会话
+bun /data/app/claude-history/tools/SessionQuery.ts recent 10
+
+# 查询编码类会话
+bun /data/app/claude-history/tools/SessionQuery.ts type coding
+
+# 查询特定目录的会话
+bun /data/app/claude-history/tools/SessionQuery.ts dir /path/to/project
+
+# 查看统计信息
+bun /data/app/claude-history/tools/SessionStats.ts global
+bun /data/app/claude-history/tools/SessionStats.ts types
+bun /data/app/claude-history/tools/SessionStats.ts dirs 10
+```
+
+## 会话类型
+
+系统自动识别以下会话类型：
+
+| 类型 | 描述 | 判断依据 |
+|------|------|---------|
+| `coding` | 编码 | Edit/Write 操作 > 40% |
+| `debugging` | 调试 | 有测试命令 + Read > Edit |
+| `research` | 研究 | Grep/Glob > 30% + Read > Edit |
+| `writing` | 写作 | Markdown 文件编辑 > 50% |
+| `git` | Git 操作 | Git 命令 > 50% |
+| `mixed` | 混合 | 无明显模式 |
+
+## 技术细节
+
+- **运行时**：Bun
+- **存储格式**：JSONL（每行一个 JSON 对象）
+- **索引策略**：增量更新，按时间倒序
+- **路径编码**：Base64（避免文件系统特殊字符）
+- **性能**：Hook 执行时间 < 50ms，不阻塞 Claude Code
+
+## 开发
+
+```bash
+# 测试 Hook
+echo '{"session_id":"test123","timestamp":"2026-01-23T10:00:00Z"}' | \
+  bun hooks/SessionRecorder.hook.ts
+
+# 测试查询
+bun tools/SessionQuery.ts recent 5
+
+# 测试统计
+bun tools/SessionStats.ts global
+```
+
+## 故障排除
+
+### Hooks 不执行
+
+**问题**: Hooks 配置正确但不记录数据
+
+**原因**: Hook 脚本的 shebang 使用 `#!/usr/bin/env bun`，但 Claude Code 执行 hooks 时 `~/.bun/bin` 不在 PATH 中
+
+**解决方案**: 使用 Bun 的完整路径
+```bash
+# 修改所有 hook 文件的第一行
+#!/home/jhihjian/.bun/bin/bun
+```
+
+### 工具输出为空或 success_rate 为 0
+
+**问题**: 会话记录显示 `tool_output: ""` 和 `success: false`
+
+**原因**: 早期版本的 SessionToolCapture hook 没有正确读取 PostToolUse 事件中的 `tool_response` 字段
+
+**解决方案**: 使用最新版本的 SessionToolCapture-v2.hook.ts，它会：
+1. 优先从 `event.tool_response.stdout/stderr` 读取输出
+2. 从 `!event.tool_response.interrupted` 判断成功状态
+3. 备用方案：从 transcript 文件读取
+
+### 验证 Hooks 是否工作
+
+```bash
+# 1. 手动测试 hook
+echo '{"session_id":"test","tool_name":"Bash"}' | ~/.bun/bin/bun ~/.claude/hooks/SessionRecorder.hook.ts
+
+# 2. 运行测试会话
+echo "请运行 date 命令" | claude -p --dangerously-skip-permissions
+
+# 3. 检查会话文件
+ls -lt ~/.claude/SESSIONS/raw/2026-01/ | head -3
+cat ~/.claude/SESSIONS/raw/2026-01/session-*.jsonl | tail -1 | jq '.'
+```
+
+## 许可证
+
+MIT

package/bin/cli.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+/**
+ * claude-daemon CLI
+ * npm 包的命令行入口
+ */
+
+const { execSync } = require('child_process');
+const { join } = require('path');
+const { existsSync } = require('fs');
+
+const COLORS = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+};
+
+function log(color, message) {
+  console.log(`${COLORS[color]}${message}${COLORS.reset}`);
+}
+
+function printBanner() {
+  log('blue', '╔════════════════════════════════════════╗');
+  log('blue', '║  Claude Code 会话历史系统             ║');
+  log('blue', '║  @jhihjian/claude-daemon               ║');
+  log('blue', '╚════════════════════════════════════════╝');
+  console.log('');
+}
+
+function printUsage() {
+  console.log('使用方法:');
+  console.log('');
+  log('green', '  claude-daemon install');
+  console.log('    安装 Claude Code 会话历史系统');
+  console.log('');
+  log('green', '  claude-daemon --help');
+  console.log('    显示帮助信息');
+  console.log('');
+  log('green', '  claude-daemon --version');
+  console.log('    显示版本信息');
+  console.log('');
+}
+
+function install() {
+  printBanner();
+  log('green', '[1/3] 定位安装脚本...');
+
+  // 获取包的安装路径
+  const packageDir = join(__dirname, '..');
+  const installScript = join(packageDir, 'install.sh');
+
+  if (!existsSync(installScript)) {
+    log('red', '✗ 找不到 install.sh');
+    log('yellow', '请确保包安装正确');
+    process.exit(1);
+  }
+
+  log('green', '  ✓ 找到安装脚本');
+  console.log('');
+
+  log('green', '[2/3] 执行安装...');
+  console.log('');
+
+  try {
+    // 执行安装脚本
+    execSync(`bash "${installScript}"`, {
+      stdio: 'inherit',
+      cwd: packageDir,
+    });
+  } catch (error) {
+    log('red', '\n✗ 安装失败');
+    log('yellow', '请查看错误信息并重试');
+    process.exit(1);
+  }
+
+  console.log('');
+  log('green', '[3/3] 安装完成！');
+  console.log('');
+  log('yellow', '下一步:');
+  console.log('  1. 重新加载 shell: source ~/.bashrc');
+  console.log('  2. 测试: claude-sessions recent 5');
+  console.log('');
+}
+
+// 主函数
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'install':
+      install();
+      break;
+
+    case '--version':
+    case '-v':
+      const pkg = require('../package.json');
+      console.log(`v${pkg.version}`);
+      break;
+
+    case '--help':
+    case '-h':
+    case undefined:
+      printBanner();
+      printUsage();
+      break;
+
+    default:
+      log('red', `未知命令: ${command}`);
+      console.log('');
+      printUsage();
+      process.exit(1);
+  }
+}
+
+main();