sumulige-claude 1.0.5 → 1.0.7

package/.claude/hooks/code-tracer.cjs

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+/**
+ * Code Tracer - 代码变更追踪
+ *
+ * 功能：
+ * - 监听文件修改事件
+ * - 自动关联到最近的决策
+ * - 维护双向映射表 (文件 ↔ 决策)
+ * - 支持查询文件的历史决策
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const CODE_TRACE_DIR = path.join(PROJECT_DIR, '.claude', 'code-trace');
+const FILES_MAP = path.join(CODE_TRACE_DIR, 'files-map.json');
+const DECISIONS_MAP = path.join(CODE_TRACE_DIR, 'decisions-map.json');
+const DECISIONS_FILE = path.join(PROJECT_DIR, '.claude', 'decisions', 'DECISIONS.md');
+
+// 确保目录存在
+try { fs.mkdirSync(CODE_TRACE_DIR, { recursive: true }); } catch (e) {}
+
+/**
+ * 初始化映射文件
+ */
+function initMaps() {
+  if (!fs.existsSync(FILES_MAP)) {
+    fs.writeFileSync(FILES_MAP, JSON.stringify({ files: {}, lastUpdated: null }, null, 2), 'utf-8');
+  }
+  if (!fs.existsSync(DECISIONS_MAP)) {
+    fs.writeFileSync(DECISIONS_MAP, JSON.stringify({ decisions: {}, lastUpdated: null }, null, 2), 'utf-8');
+  }
+}
+
+/**
+ * 读取映射文件
+ */
+function readMaps() {
+  initMaps();
+  return {
+    filesMap: JSON.parse(fs.readFileSync(FILES_MAP, 'utf-8')),
+    decisionsMap: JSON.parse(fs.readFileSync(DECISIONS_MAP, 'utf-8'))
+  };
+}
+
+/**
+ * 写入映射文件
+ */
+function writeMaps(filesMap, decisionsMap) {
+  const now = new Date().toISOString();
+  filesMap.lastUpdated = now;
+  decisionsMap.lastUpdated = now;
+  fs.writeFileSync(FILES_MAP, JSON.stringify(filesMap, null, 2), 'utf-8');
+  fs.writeFileSync(DECISIONS_MAP, JSON.stringify(decisionsMap, null, 2), 'utf-8');
+}
+
+/**
+ * 关联文件到决策
+ */
+function linkFileToDecision(filePath, decisionId, metadata = {}) {
+  const { filesMap, decisionsMap } = readMaps();
+
+  // 规范化路径
+  const normalizedPath = path.relative(PROJECT_DIR, filePath);
+
+  // 更新文件映射
+  if (!filesMap.files[normalizedPath]) {
+    filesMap.files[normalizedPath] = {
+      decisions: [],
+      firstSeen: new Date().toISOString(),
+      lastModified: new Date().toISOString()
+    };
+  }
+
+  if (!filesMap.files[normalizedPath].decisions.includes(decisionId)) {
+    filesMap.files[normalizedPath].decisions.push(decisionId);
+  }
+  filesMap.files[normalizedPath].lastModified = new Date().toISOString();
+
+  // 更新决策映射
+  if (!decisionsMap.decisions[decisionId]) {
+    decisionsMap.decisions[decisionId] = {
+      description: '',
+      files: [],
+      firstLinked: new Date().toISOString()
+    };
+  }
+
+  if (!decisionsMap.decisions[decisionId].files.includes(normalizedPath)) {
+    decisionsMap.decisions[decisionId].files.push(normalizedPath);
+  }
+
+  // 添加元数据
+  if (metadata.description) {
+    decisionsMap.decisions[decisionId].description = metadata.description;
+  }
+
+  writeMaps(filesMap, decisionsMap);
+
+  return { normalizedPath, decisionId };
+}
+
+/**
+ * 批量关联文件到决策
+ */
+function linkFilesToDecision(filePaths, decisionId, metadata = {}) {
+  const results = [];
+  filePaths.forEach(filePath => {
+    results.push(linkFileToDecision(filePath, decisionId, metadata));
+  });
+  return results;
+}
+
+/**
+ * 查询文件的决策历史
+ */
+function traceFile(filePath) {
+  const { filesMap } = readMaps();
+  const normalizedPath = path.relative(PROJECT_DIR, filePath);
+
+  if (!filesMap.files[normalizedPath]) {
+    return null;
+  }
+
+  return filesMap.files[normalizedPath];
+}
+
+/**
+ * 查询决策关联的文件
+ */
+function traceDecision(decisionId) {
+  const { decisionsMap } = readMaps();
+
+  if (!decisionsMap.decisions[decisionId]) {
+    return null;
+  }
+
+  return decisionsMap.decisions[decisionId];
+}
+
+/**
+ * 获取所有文件-决策关系
+ */
+function getAllLinks() {
+  const { filesMap, decisionsMap } = readMaps();
+  return { filesMap, decisionsMap };
+}
+
+/**
+ * 格式化显示文件追踪信息
+ */
+function displayFileTrace(filePath) {
+  const trace = traceFile(filePath);
+
+  if (!trace) {
+    console.log(`\n📭 文件 "${filePath}" 暂无决策记录\n`);
+    return;
+  }
+
+  console.log(`\n📄 文件追踪: ${filePath}\n`);
+  console.log(`⏰ 首次记录: ${trace.firstSeen}`);
+  console.log(`🔄 最后修改: ${trace.lastModified}`);
+  console.log(`\n🔗 关联的决策 (${trace.decisions.length}):\n`);
+
+  if (trace.decisions.length > 0) {
+    const { decisionsMap } = readMaps();
+    trace.decisions.forEach(decisionId => {
+      const decision = decisionsMap.decisions[decisionId];
+      if (decision) {
+        console.log(`  - [${decisionId}] ${decision.description || '无描述'}`);
+      } else {
+        console.log(`  - [${decisionId}] (决策详情未找到)`);
+      }
+    });
+  }
+}
+
+/**
+ * 格式化显示决策关联文件
+ */
+function displayDecisionTrace(decisionId) {
+  const trace = traceDecision(decisionId);
+
+  if (!trace) {
+    console.log(`\n📭 决策 "${decisionId}" 暂无文件记录\n`);
+    return;
+  }
+
+  console.log(`\n🔗 决策追踪: ${decisionId}\n`);
+  console.log(`📝 ${trace.description || '无描述'}`);
+  console.log(`⏰ 首次关联: ${trace.firstLinked}`);
+  console.log(`\n📄 关联的文件 (${trace.files.length}):\n`);
+
+  trace.files.forEach(file => {
+    const fullPath = path.join(PROJECT_DIR, file);
+    const exists = fs.existsSync(fullPath) ? '✅' : '❌';
+    console.log(`  ${exists} ${file}`);
+  });
+}
+
+/**
+ * 显示所有关联
+ */
+function displayAllLinks() {
+  const { filesMap, decisionsMap } = readMaps();
+
+  console.log('\n📊 代码-决策关联图谱\n');
+  console.log(`📄 文件数量: ${Object.keys(filesMap.files).length}`);
+  console.log(`🔗 决策数量: ${Object.keys(decisionsMap.decisions).length}\n`);
+
+  if (Object.keys(filesMap.files).length > 0) {
+    console.log('📄 文件列表:\n');
+    Object.entries(filesMap.files).forEach(([file, data]) => {
+      const decisionCount = data.decisions.length;
+      const status = decisionCount > 0 ? `🔗 ${decisionCount} 决策` : '⚪ 无关联';
+      console.log(`  ${status} - ${file}`);
+    });
+  }
+}
+
+/**
+ * 从 DECISIONS.md 同步决策描述
+ */
+function syncDecisionDescriptions() {
+  if (!fs.existsSync(DECISIONS_FILE)) {
+    return;
+  }
+
+  const content = fs.readFileSync(DECISIONS_FILE, 'utf-8');
+  const { decisionsMap } = readMaps();
+
+  // 提取决策标题
+  const decisionRegex = /^## \[([A-Z]\d+)\]\s+\d{4}-\d{2}-\d{2}.*?-\s*(.+?)$/gm;
+  let match;
+
+  while ((match = decisionRegex.exec(content)) !== null) {
+    const [, decisionId, title] = match;
+    if (decisionsMap.decisions[decisionId]) {
+      if (!decisionsMap.decisions[decisionId].description) {
+        decisionsMap.decisions[decisionId].description = title;
+      }
+    }
+  }
+
+  const { filesMap } = readMaps();
+  writeMaps(filesMap, decisionsMap);
+}
+
+// CLI
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'trace': {
+      // 追踪文件
+      const filePath = args[1];
+      if (!filePath) {
+        console.error('用法: node code-tracer.cjs trace <文件路径>');
+        process.exit(1);
+      }
+      displayFileTrace(filePath);
+      break;
+    }
+
+    case 'decision': {
+      // 查看决策的文件
+      const decisionId = args[1];
+      if (!decisionId) {
+        console.error('用法: node code-tracer.cjs decision <决策ID>');
+        process.exit(1);
+      }
+      displayDecisionTrace(decisionId);
+      break;
+    }
+
+    case 'link': {
+      // 手动关联
+      const filePath = args[1];
+      const decisionId = args[2];
+      if (!filePath || !decisionId) {
+        console.error('用法: node code-tracer.cjs link <文件路径> <决策ID>');
+        process.exit(1);
+      }
+      linkFileToDecision(filePath, decisionId);
+      console.log(`✅ 已关联 ${filePath} → ${decisionId}`);
+      break;
+    }
+
+    case 'all': {
+      displayAllLinks();
+      break;
+    }
+
+    case 'sync': {
+      syncDecisionDescriptions();
+      console.log('✅ 已同步决策描述');
+      break;
+    }
+
+    default:
+      console.log(`
+Code Tracer - 代码变更追踪工具
+
+用法:
+  node code-tracer.cjs trace <文件>        查看文件的决策历史
+  node code-tracer.cjs decision <ID>      查看决策关联的文件
+  node code-tracer.cjs link <文件> <ID>   手动关联文件到决策
+  node code-tracer.cjs all                显示所有关联
+  node code-tracer.cjs sync               同步决策描述
+
+快捷命令:
+  alias trace='node .claude/hooks/code-tracer.cjs trace'
+  alias dtrace='node .claude/hooks/code-tracer.cjs decision'
+      `);
+  }
+}
+
+module.exports = {
+  linkFileToDecision,
+  linkFilesToDecision,
+  traceFile,
+  traceDecision,
+  getAllLinks,
+  syncDecisionDescriptions
+};
+
+if (require.main === module) {
+  main();
+}

package/.claude/hooks/conversation-recorder.cjs

@@ -0,0 +1,340 @@
+#!/usr/bin/env node
+/**
+ * Conversation Recorder - 完整对话记录器
+ *
+ * 功能：
+ * - 捕获完整对话（用户输入 + AI 输出）
+ * - 按日期组织存储
+ * - 自动过滤敏感信息
+ * - 记录使用的工具
+ * - 支持 Session 管理
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { filterSensitive } = require('./privacy-filter.js');
+
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const TRANSCRIPTS_DIR = path.join(PROJECT_DIR, '.claude', 'transcripts');
+const CURRENT_SESSION_FILE = path.join(PROJECT_DIR, '.claude', 'thinking-routes', '.current-session');
+
+// 确保目录存在
+try { fs.mkdirSync(TRANSCRIPTS_DIR, { recursive: true }); } catch (e) {}
+
+/**
+ * 获取当前会话 ID
+ */
+function getSessionId() {
+  try {
+    const data = fs.readFileSync(CURRENT_SESSION_FILE, 'utf-8').trim();
+    if (data) return data;
+  } catch (e) {}
+  return 'session-' + Date.now();
+}
+
+/**
+ * 获取今日 transcript 文件路径
+ */
+function getTodayTranscriptPath() {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+
+  const dir = path.join(TRANSCRIPTS_DIR, String(year), month);
+  try { fs.mkdirSync(dir, { recursive: true }); } catch (e) {}
+
+  return path.join(dir, `${day}.md`);
+}
+
+/**
+ * 获取当前 Session 编号
+ */
+function getSessionNumber() {
+  const transcriptPath = getTodayTranscriptPath();
+  try {
+    const content = fs.readFileSync(transcriptPath, 'utf-8');
+    const matches = content.match(/^## Session \d+/gm);
+    if (matches) {
+      const lastNum = parseInt(matches[matches.length - 1].match(/\d+/)[0]);
+      return String(lastNum + 1).padStart(3, '0');
+    }
+  } catch (e) {}
+  return '001';
+}
+
+/**
+ * 获取当前时间戳
+ */
+function getTimestamp() {
+  return new Date().toISOString().replace('T', ' ').substring(0, 19);
+}
+
+/**
+ * 格式化消息内容
+ */
+function formatMessage(role, content, metadata = {}) {
+  const timestamp = getTimestamp();
+  const roleEmoji = role === 'user' ? '👤' : role === 'assistant' ? '🤖' : '🔧';
+
+  let section = `\n### ${roleEmoji} ${role.charAt(0).toUpperCase() + role.slice(1)} - ${timestamp}\n\n`;
+
+  // 过滤敏感信息
+  const filtered = filterSensitive(content || '');
+  section += filtered.filteredText;
+
+  // 添加元数据
+  if (Object.keys(metadata).length > 0) {
+    section += '\n\n**Metadata**:\n';
+    for (const [key, value] of Object.entries(metadata)) {
+      section += `- ${key}: ${value}\n`;
+    }
+  }
+
+  return section + '\n';
+}
+
+/**
+ * 追加到 transcript
+ */
+function appendToTranscript(content) {
+  const transcriptPath = getTodayTranscriptPath();
+
+  // 如果文件不存在，创建头部
+  if (!fs.existsSync(transcriptPath)) {
+    const now = new Date();
+    const header = `# ${now.toISOString().split('T')[0]} - Conversation Transcript\n\n`;
+    fs.writeFileSync(transcriptPath, header, 'utf-8');
+  }
+
+  fs.appendFileSync(transcriptPath, content, 'utf-8');
+}
+
+/**
+ * 记录用户消息
+ */
+function recordUserMessage(content) {
+  const sessionId = getSessionId();
+  const sessionNum = getSessionNumber();
+
+  const section = `\n${'='.repeat(60)}\n`;
+  const header = `## Session ${sessionNum} - ${getTimestamp()} | ID: ${sessionId}\n`;
+
+  appendToTranscript(section + header + formatMessage('user', content));
+
+  return { sessionId, sessionNum };
+}
+
+/**
+ * 记录 AI 回复
+ */
+function recordAssistantMessage(content, toolsUsed = []) {
+  let section = formatMessage('assistant', content);
+
+  if (toolsUsed.length > 0) {
+    section += `\n**Tools Used**:\n`;
+    toolsUsed.forEach(tool => {
+      section += `- \`${tool.name}\`${tool.args ? `: ${tool.args}` : ''}\n`;
+    });
+    section += '\n';
+  }
+
+  appendToTranscript(section);
+}
+
+/**
+ * 记录工具使用
+ */
+function recordToolUse(toolName, args, result) {
+  const timestamp = getTimestamp();
+  let section = `\n### 🔧 Tool: ${toolName} - ${timestamp}\n\n`;
+
+  if (args) {
+    section += `**Args**:\n\`\`\`\n${JSON.stringify(args, null, 2)}\n\`\`\`\n\n`;
+  }
+
+  if (result) {
+    const filtered = filterSensitive(String(result));
+    section += `**Result**:\n\`\`\`\n${filtered.filteredText.substring(0, 500)}${filtered.filteredText.length > 500 ? '...' : ''}\n\`\`\`\n\n`;
+  }
+
+  appendToTranscript(section);
+}
+
+/**
+ * 记录决策
+ */
+function recordDecision(title, details, links = {}) {
+  const timestamp = getTimestamp();
+  const decisionsPath = path.join(PROJECT_DIR, '.claude', 'decisions', 'DECISIONS.md');
+
+  // 确保文件存在
+  if (!fs.existsSync(decisionsPath)) {
+    fs.writeFileSync(decisionsPath, `# Decisions Log\n\n> 所有项目决策的完整记录\n\n`, 'utf-8');
+  }
+
+  // 生成决策 ID
+  const content = fs.readFileSync(decisionsPath, 'utf-8');
+  const match = content.match(/\[D(\d+)\]/g);
+  const nextId = match ? Math.max(...match.map(m => parseInt(m.slice(2, -1)))) + 1 : 1;
+  const decisionId = `D${String(nextId).padStart(3, '0')}`;
+
+  let section = `\n## [${decisionId}] ${timestamp} - ${title}\n\n`;
+
+  if (details.reason) {
+    section += `### 💡 理由\n${details.reason}\n\n`;
+  }
+
+  if (details.content) {
+    section += `### 📌 决策内容\n${details.content}\n\n`;
+  }
+
+  if (Object.keys(links).length > 0) {
+    section += `### 🔗 关联\n`;
+    if (links.conversation) section += `- 对话: \`${links.conversation}\`\n`;
+    if (links.files && links.files.length > 0) {
+      section += `- 代码: ${links.files.map(f => `\`${f}\``).join(', ')}\n`;
+    }
+    if (links.commit) section += `- Commit: \`${links.commit}\`\n`;
+    section += '\n';
+  }
+
+  if (details.tags && details.tags.length > 0) {
+    section += `### 🏷️ 主题\n${details.tags.map(t => `- ${t}`).join('\n')}\n\n`;
+  }
+
+  // 追加到文件
+  fs.appendFileSync(decisionsPath, section, 'utf-8');
+
+  // 如果有主题，也添加到主题文件
+  if (details.tags && details.tags.length > 0) {
+    const topicDir = path.join(PROJECT_DIR, '.claude', 'decisions', 'by-topic');
+    try { fs.mkdirSync(topicDir, { recursive: true }); } catch (e) {}
+
+    details.tags.forEach(tag => {
+      const topicPath = path.join(topicDir, `${tag}.md`);
+      const topicEntry = `\n- [${decisionId}](${getRelativePath(decisionsPath, topicPath)}#${timestamp}) - ${title}\n`;
+      fs.appendFileSync(topicPath, topicEntry, 'utf-8');
+    });
+  }
+
+  return decisionId;
+}
+
+/**
+ * 获取相对路径
+ */
+function getRelativePath(from, to) {
+  return path.relative(path.dirname(from), to);
+}
+
+/**
+ * 从环境变量读取并记录
+ */
+function recordFromEnv() {
+  const eventType = process.env.CLAUDE_EVENT_TYPE || '';
+  const toolInput = process.env.CLAUDE_TOOL_INPUT || '';
+
+  if (eventType === 'UserPromptSubmit' && toolInput) {
+    recordUserMessage(toolInput);
+  }
+}
+
+// 主函数
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'user':
+      // 记录用户消息
+      const userContent = args.slice(1).join(' ') || '';
+      if (userContent) {
+        const { sessionId, sessionNum } = recordUserMessage(userContent);
+        console.log(`✅ 记录用户消息 - Session ${sessionNum} (${sessionId})`);
+      }
+      break;
+
+    case 'assistant':
+      // 记录 AI 回复
+      const assistantContent = args.slice(1).join(' ') || '';
+      if (assistantContent) {
+        recordAssistantMessage(assistantContent);
+        console.log('✅ 记录 AI 回复');
+      }
+      break;
+
+    case 'decision':
+      // 记录决策
+      // 用法: node conversation-recorder.cjs decision "标题" "理由" "内容"
+      const title = args[1] || '';
+      const reason = args[2] || '';
+      const content = args[3] || '';
+      if (title) {
+        const id = recordDecision(title, { reason, content });
+        console.log(`✅ 记录决策 - ${id}: ${title}`);
+      }
+      break;
+
+    case 'today':
+      // 查看今日对话
+      const todayPath = getTodayTranscriptPath();
+      if (fs.existsSync(todayPath)) {
+        console.log(fs.readFileSync(todayPath, 'utf-8'));
+      } else {
+        console.log('📭 今日暂无对话记录');
+      }
+      break;
+
+    case 'list':
+      // 列出所有 transcript
+      listTranscripts();
+      break;
+
+    default:
+      // 从环境变量读取并记录
+      recordFromEnv();
+  }
+}
+
+/**
+ * 列出所有 transcript
+ */
+function listTranscripts() {
+  function listDir(dir, prefix = '') {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    entries.forEach(entry => {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        console.log(`${prefix}📁 ${entry.name}/`);
+        listDir(fullPath, prefix + '  ');
+      } else if (entry.name.endsWith('.md')) {
+        const stat = fs.statSync(fullPath);
+        const size = (stat.size / 1024).toFixed(1);
+        console.log(`${prefix}📄 ${entry.name} (${size}KB)`);
+      }
+    });
+  }
+
+  if (fs.existsSync(TRANSCRIPTS_DIR)) {
+    console.log('\n📂 Conversation Transcripts:\n');
+    listDir(TRANSCRIPTS_DIR);
+  } else {
+    console.log('📭 暂无对话记录');
+  }
+}
+
+// 导出
+module.exports = {
+  recordUserMessage,
+  recordAssistantMessage,
+  recordToolUse,
+  recordDecision,
+  getTodayTranscriptPath,
+  getSessionId
+};
+
+// 直接运行
+if (require.main === module) {
+  main();
+}