sumulige-claude 1.0.5 → 1.0.7

package/.claude/hooks/export.cjs

@@ -0,0 +1,329 @@
+#!/usr/bin/env node
+/**
+ * Export Tool - 导出对话和决策数据
+ *
+ * 功能：
+ * - 导出为 JSON 格式
+ * - 导出为 Markdown（可转换为 PDF）
+ * - 支持按日期范围导出
+ * - 支持按主题导出
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const TRANSCRIPTS_DIR = path.join(PROJECT_DIR, '.claude', 'transcripts');
+const DECISIONS_DIR = path.join(PROJECT_DIR, '.claude', 'decisions');
+const CODE_TRACE_DIR = path.join(PROJECT_DIR, '.claude', 'code-trace');
+const EXPORT_DIR = path.join(PROJECT_DIR, '.claude', 'export');
+
+// 确保导出目录存在
+try { fs.mkdirSync(EXPORT_DIR, { recursive: true }); } catch (e) {}
+
+/**
+ * 获取今日日期字符串
+ */
+function getDateStamp() {
+  const now = new Date();
+  return now.toISOString().split('T')[0];
+}
+
+/**
+ * 读取所有 transcripts
+ */
+function readAllTranscripts() {
+  const transcripts = [];
+
+  function readDir(dir, prefix = '') {
+    if (!fs.existsSync(dir)) return;
+
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    entries.forEach(entry => {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        readDir(fullPath, prefix + entry.name + '/');
+      } else if (entry.name.endsWith('.md')) {
+        const content = fs.readFileSync(fullPath, 'utf-8');
+        transcripts.push({
+          path: prefix + entry.name,
+          fullPath,
+          content,
+          size: content.length,
+          modified: fs.statSync(fullPath).mtime
+        });
+      }
+    });
+  }
+
+  readDir(TRANSCRIPTS_DIR);
+  return transcripts.sort((a, b) => a.path.localeCompare(b.path));
+}
+
+/**
+ * 读取所有决策
+ */
+function readAllDecisions() {
+  const decisionsPath = path.join(DECISIONS_DIR, 'DECISIONS.md');
+  if (!fs.existsSync(decisionsPath)) {
+    return { content: '', count: 0 };
+  }
+
+  const content = fs.readFileSync(decisionsPath, 'utf-8');
+  const blocks = content.split(/^## /m).filter(s => s.trim());
+
+  return {
+    content,
+    count: blocks.length,
+    blocks
+  };
+}
+
+/**
+ * 读取代码追踪数据
+ */
+function readCodeTrace() {
+  const filesMapPath = path.join(CODE_TRACE_DIR, 'files-map.json');
+  const decisionsMapPath = path.join(CODE_TRACE_DIR, 'decisions-map.json');
+
+  let filesMap = { files: {}, lastUpdated: null };
+  let decisionsMap = { decisions: {}, lastUpdated: null };
+
+  if (fs.existsSync(filesMapPath)) {
+    filesMap = JSON.parse(fs.readFileSync(filesMapPath, 'utf-8'));
+  }
+  if (fs.existsSync(decisionsMapPath)) {
+    decisionsMap = JSON.parse(fs.readFileSync(decisionsMapPath, 'utf-8'));
+  }
+
+  return { filesMap, decisionsMap };
+}
+
+/**
+ * 导出为 JSON
+ */
+function exportJSON(options = {}) {
+  const { includeTranscripts = true, includeDecisions = true, includeTrace = true } = options;
+
+  const data = {
+    exportedAt: new Date().toISOString(),
+    project: path.basename(PROJECT_DIR),
+    version: '1.0'
+  };
+
+  if (includeTranscripts) {
+    data.transcripts = readAllTranscripts();
+    data.transcriptCount = data.transcripts.length;
+  }
+
+  if (includeDecisions) {
+    const decisions = readAllDecisions();
+    data.decisions = decisions;
+    data.decisionCount = decisions.count;
+  }
+
+  if (includeTrace) {
+    const trace = readCodeTrace();
+    data.codeTrace = trace;
+  }
+
+  return data;
+}
+
+/**
+ * 导出为 Markdown
+ */
+function exportMarkdown(options = {}) {
+  const { includeTranscripts = true, includeDecisions = true, includeTrace = true } = options;
+
+  let md = `# Thinking Chain Export\n\n`;
+  md += `**项目**: ${path.basename(PROJECT_DIR)}\n`;
+  md += `**导出时间**: ${new Date().toLocaleString('zh-CN')}\n\n`;
+  md += `---\n\n`;
+
+  if (includeTranscripts) {
+    md += `## 📝 对话记录\n\n`;
+    const transcripts = readAllTranscripts();
+    transcripts.forEach(t => {
+      md += `### ${t.path}\n\n`;
+      md += t.content + '\n\n---\n\n';
+    });
+  }
+
+  if (includeDecisions) {
+    md += `## 🔗 决策记录\n\n`;
+    const decisions = readAllDecisions();
+    md += decisions.content + '\n\n---\n\n';
+  }
+
+  if (includeTrace) {
+    md += `## 🔍 代码追踪\n\n`;
+    const trace = readCodeTrace();
+    md += `### 文件关联\n\n`;
+    Object.entries(trace.filesMap.files || {}).forEach(([file, data]) => {
+      md += `- **${file}**: ${data.decisions.join(', ') || '无关联'}\n`;
+    });
+    md += `\n### 决策关联\n\n`;
+    Object.entries(trace.decisionsMap.decisions || {}).forEach(([id, data]) => {
+      md += `- **${id}**: ${data.files.join(', ') || '无文件'}\n`;
+    });
+  }
+
+  return md;
+}
+
+/**
+ * 保存导出文件
+ */
+function saveExport(content, format, filename) {
+  const dateStamp = getDateStamp();
+  const defaultName = `thinking-chain-${dateStamp}.${format}`;
+  const outputName = filename || defaultName;
+  const outputPath = path.join(EXPORT_DIR, outputName);
+
+  if (format === 'json') {
+    fs.writeFileSync(outputPath, JSON.stringify(content, null, 2), 'utf-8');
+  } else {
+    fs.writeFileSync(outputPath, content, 'utf-8');
+  }
+
+  return outputPath;
+}
+
+/**
+ * 获取导出文件大小
+ */
+function getFileSize(filePath) {
+  const stats = fs.statSync(filePath);
+  const size = stats.size;
+  if (size < 1024) return `${size}B`;
+  if (size < 1024 * 1024) return `${(size / 1024).toFixed(1)}KB`;
+  return `${(size / 1024 / 1024).toFixed(1)}MB`;
+}
+
+// CLI
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'json': {
+      const data = exportJSON();
+      const outputPath = saveExport(data, 'json', args[1]);
+      console.log(`✅ 导出 JSON → ${outputPath} (${getFileSize(outputPath)})`);
+      console.log(`   包含 ${data.transcriptCount || 0} 个对话, ${data.decisionCount || 0} 个决策`);
+      break;
+    }
+
+    case 'md': {
+      const content = exportMarkdown();
+      const outputPath = saveExport(content, 'md', args[1]);
+      console.log(`✅ 导出 Markdown → ${outputPath} (${getFileSize(outputPath)})`);
+      break;
+    }
+
+    case 'pdf': {
+      // Markdown 转 PDF 需要额外工具
+      console.log(`
+PDF 导出需要安装额外工具。请选择一种方式：
+
+方式 1 - 使用 pandoc:
+  brew install pandoc
+  pandoc .claude/export/thinking-chain.md -o .claude/export/thinking-chain.pdf
+
+方式 2 - 使用 markdown-pdf:
+  npm install -g markdown-pdf
+  markdown-pdf .claude/export/thinking-chain.md
+
+方式 3 - 在 VSCode 中:
+  1. 安装 Markdown PDF 扩展
+  2. 打开 .claude/export/thinking-chain.md
+  3. 右键 → Markdown PDF: Export (pdf)
+      `);
+
+      // 先导出 Markdown
+      const content = exportMarkdown();
+      const mdPath = saveExport(content, 'md', null);
+      console.log(`\n✅ 已准备 Markdown 文件: ${mdPath}`);
+      break;
+    }
+
+    case 'decisions': {
+      // 只导出决策
+      const content = exportMarkdown({ includeTranscripts: false, includeTrace: false });
+      const outputPath = saveExport(content, 'md', `decisions-${getDateStamp()}.md`);
+      console.log(`✅ 导出决策 → ${outputPath}`);
+      break;
+    }
+
+    case 'transcripts': {
+      // 只导出对话
+      const content = exportMarkdown({ includeDecisions: false, includeTrace: false });
+      const outputPath = saveExport(content, 'md', `transcripts-${getDateStamp()}.md`);
+      console.log(`✅ 导出对话 → ${outputPath}`);
+      break;
+    }
+
+    case 'list': {
+      // 列出导出文件
+      if (fs.existsSync(EXPORT_DIR)) {
+        const files = fs.readdirSync(EXPORT_DIR);
+        console.log('\n📂 导出文件:\n');
+        files.forEach(f => {
+          const filePath = path.join(EXPORT_DIR, f);
+          const stats = fs.statSync(filePath);
+          console.log(`  ${f} (${getFileSize(filePath)}) ${stats.mtime.toLocaleDateString()}`);
+        });
+      } else {
+        console.log('📭 暂无导出文件');
+      }
+      break;
+    }
+
+    case 'clean': {
+      // 清理旧导出
+      if (fs.existsSync(EXPORT_DIR)) {
+        const files = fs.readdirSync(EXPORT_DIR);
+        let cleaned = 0;
+        files.forEach(f => {
+          const filePath = path.join(EXPORT_DIR, f);
+          if (f !== '.gitkeep') {
+            fs.unlinkSync(filePath);
+            cleaned++;
+          }
+        });
+        console.log(`✅ 清理了 ${cleaned} 个导出文件`);
+      }
+      break;
+    }
+
+    default:
+      console.log(`
+Export Tool - 数据导出工具
+
+用法:
+  node export.cjs json [文件名]     导出为 JSON
+  node export.cjs md [文件名]       导出为 Markdown
+  node export.cjs pdf               导出为 PDF（需要额外工具）
+  node export.cjs decisions         只导出决策
+  node export.cjs transcripts       只导出对话
+  node export.cjs list              列出导出文件
+  node export.cjs clean             清理导出文件
+
+快捷命令:
+  alias export='node .claude/hooks/export.cjs'
+      `);
+  }
+}
+
+module.exports = {
+  exportJSON,
+  exportMarkdown,
+  readAllTranscripts,
+  readAllDecisions,
+  readCodeTrace
+};
+
+if (require.main === module) {
+  main();
+}

package/.claude/hooks/multi-session.cjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * Multi-Session Manager - 并行多会话管理
+ *
+ * 根据 Boris Cherny 的实践，并行运行 5 个 Claude 可以极大提升效率。
+ * 这个 hook 帮助跟踪和管理多个并行会话。
+ *
+ * 功能：
+ * - 跟踪活跃的会话
+ * - 为每个会话分配编号
+ * - 记录会话状态和任务
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const SESSIONS_DIR = path.join(PROJECT_DIR, '.claude', 'sessions');
+const ACTIVE_SESSIONS_FILE = path.join(SESSIONS_DIR, 'active-sessions.json');
+const SESSION_LOCK_FILE = path.join(SESSIONS_DIR, '.session-lock');
+
+// 确保目录存在
+try { fs.mkdirSync(SESSIONS_DIR, { recursive: true }); } catch (e) {}
+
+// 获取主机名和用户信息用于标识会话来源
+function getSessionIdentifier() {
+  const hostname = os.hostname();
+  const platform = os.platform();
+  const username = process.env.USER || process.env.USERNAME || 'unknown';
+  return `${username}@${hostname} (${platform})`;
+}
+
+// 获取当前会话 ID
+function getCurrentSessionId() {
+  // 从环境变量或进程信息生成唯一 ID
+  const pid = process.pid;
+  const ppid = process.ppid;
+  const timestamp = Date.now();
+  return `session-${pid}-${ppid}`;
+}
+
+// 获取活跃会话列表
+function getActiveSessions() {
+  if (!fs.existsSync(ACTIVE_SESSIONS_FILE)) {
+    return [];
+  }
+  try {
+    const data = fs.readFileSync(ACTIVE_SESSIONS_FILE, 'utf-8');
+    const sessions = JSON.parse(data);
+    // 清理超过 1 小时的旧会话
+    const oneHourAgo = Date.now() - 60 * 60 * 1000;
+    return sessions.filter(s => s.lastHeartbeat > oneHourAgo);
+  } catch (e) {
+    return [];
+  }
+}
+
+// 保存活跃会话列表
+function saveActiveSessions(sessions) {
+  fs.writeFileSync(ACTIVE_SESSIONS_FILE, JSON.stringify(sessions, null, 2));
+}
+
+// 更新当前会话的心跳
+function updateHeartbeat() {
+  const sessions = getActiveSessions();
+  const currentId = getCurrentSessionId();
+  const now = Date.now();
+
+  const existingSession = sessions.find(s => s.id === currentId);
+  if (existingSession) {
+    existingSession.lastHeartbeat = now;
+    existingSession.heartbeatCount = (existingSession.heartbeatCount || 0) + 1;
+  } else {
+    sessions.push({
+      id: currentId,
+      identifier: getSessionIdentifier(),
+      startedAt: now,
+      lastHeartbeat: now,
+      heartbeatCount: 1,
+      status: 'active'
+    });
+  }
+
+  saveActiveSessions(sessions);
+  return sessions;
+}
+
+// 获取会话编号（1-5，类似 Boris 的标签页编号）
+function getSessionNumber(sessions) {
+  const currentId = getCurrentSessionId();
+  const session = sessions.find(s => s.id === currentId);
+  if (session && session.number) {
+    return session.number;
+  }
+
+  // 分配一个可用的编号
+  const usedNumbers = new Set(sessions.filter(s => s.number).map(s => s.number));
+  for (let i = 1; i <= 10; i++) {
+    if (!usedNumbers.has(i)) {
+      // 更新会话的编号
+      const updatedSessions = getActiveSessions();
+      const targetSession = updatedSessions.find(s => s.id === currentId);
+      if (targetSession) {
+        targetSession.number = i;
+        saveActiveSessions(updatedSessions);
+        return i;
+      }
+      return i;
+    }
+  }
+
+  return sessions.length + 1;
+}
+
+// 显示会话状态
+function displaySessionStatus() {
+  const sessions = getActiveSessions();
+  const currentId = getCurrentSessionId();
+  const currentNumber = getSessionNumber(sessions);
+
+  console.log(`\n🔄 [多会话] 当前会话: #${currentNumber} | 活跃会话: ${sessions.length}`);
+  console.log(`   主机: ${getSessionIdentifier()}`);
+
+  if (sessions.length > 1) {
+    console.log(`\n   其他活跃会话:`);
+    sessions
+      .filter(s => s.id !== currentId)
+      .forEach(s => {
+        const number = s.number || '?';
+        const duration = Math.round((Date.now() - s.startedAt) / 1000 / 60);
+        console.log(`   - 会话 #${number}: ${s.identifier} (${duration}分钟前启动)`);
+      });
+  }
+
+  console.log('');
+}
+
+// 主函数
+function main() {
+  try {
+    const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+    const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+
+    // 在每次交互时更新心跳
+    const sessions = updateHeartbeat();
+    const sessionNumber = getSessionNumber(sessions);
+
+    // 在会话开始或重要操作时显示状态
+    if (eventType === 'UserPromptSubmit' && toolInput.length > 20) {
+      // 只在较长的用户输入时显示，避免噪音
+      if (sessions.length > 1 || process.env.SHOW_SESSION_STATUS) {
+        console.log(`\n🔄 [会话 #${sessionNumber}] 活跃会话: ${sessions.length}\n`);
+      }
+    }
+
+    // 在会话结束时清理
+    if (eventType === 'AgentStop') {
+      const currentId = getCurrentSessionId();
+      const updatedSessions = getActiveSessions();
+      const index = updatedSessions.findIndex(s => s.id === currentId);
+      if (index !== -1) {
+        updatedSessions[index].status = 'ended';
+        updatedSessions[index].endedAt = Date.now();
+        saveActiveSessions(updatedSessions);
+      }
+    }
+
+  } catch (e) {
+    // 静默处理错误
+  }
+
+  process.exit(0);
+}
+
+// 如果直接运行此脚本，显示会话状态
+if (require.main === module && process.argv[2] === '--status') {
+  displaySessionStatus();
+} else {
+  main();
+}