Claude Conversation Logger

笔记 JavaScript

🚀 🤖 Claude Conversation Logger v3.1.0

Claude Conversation Logger v3.1.0 是一个智能对话管理平台，配备 4 个与 Claude Code 兼容的代理，具备深度语义分析、自动文档生成等功能，可实现 70% 的令牌优化，有效提升技术对话的处理效率和质量。

🚀 快速开始

第 1 步：启动系统

# 克隆并启动
git clone https://github.com/LucianoRicardo737/claude-conversation-logger.git
cd claude-conversation-logger

# 使用 Docker 启动（包含代理）
docker compose up -d --build

# 验证系统是否正常运行
curl http://localhost:3003/health

第 2 步：配置 Claude Code

# 复制 MCP 配置
cp examples/claude-settings.json ~/.claude/settings.json

# 复制日志钩子
cp examples/api-logger.py ~/.claude/hooks/
chmod +x ~/.claude/hooks/api-logger.py

第 3 步：使用代理

# 在 Claude Code 中搜索相似对话
search_conversations({
query: "payment integration error",
days: 30,
includePatterns: true
})

# 对当前对话进行智能分析
analyze_conversation_intelligence({
session_id: "current_session",
includeRelationships: true
})

# 自动生成文档
auto_document_session({
session_id: "completed_troubleshooting"
})

🎉 系统已准备就绪！代理将自动分析您的所有对话。

✨ 主要特性

⭐ 4 个 Claude Code 代理系统

🧠 核心功能

Claude Conversation Logger 包含一个经过优化的 4 个与 Claude Code 兼容的代理系统，可在技术对话中提供智能分析、自动文档生成和模式发现功能。

🎭 4 个 Claude Code 代理

代理	主要功能	使用场景
🎭 conversation - orchestrator - agent	主要协调器，做出智能决策	多维复杂分析、代理委派
🧠 semantic - analyzer - agent	深度语义内容分析	主题、实体、技术模式提取
🔍 pattern - discovery - agent	历史模式发现	识别反复出现的问题和解决方案
📝 auto - documentation - agent	自动文档生成	创建结构化的问题 - 解决方案指南

🚀 智能能力

# 🔍 智能语义搜索
"authentication error" → 查找所有与身份验证相关的对话

# 📝 上下文自动文档生成
完成的会话 → 自动生成结构化文档

# 🔗 智能关系映射
当前问题 → 找到 5 个带有解决方案的相似对话

# 📊 预测模式分析
"API timeout" → 识别 15 个相似案例 + 最有效的解决方案

# 🌍 多语言支持
混合西班牙语/英语对话 → 检测两种语言中的模式

⚡ 关键优势

✅ 令牌优化：与手动分析相比，减少 70% 的令牌使用量
✅ 即时分析：多代理完整分析时间小于 3 秒
✅ 高精度：模式和状态检测准确率达 95% 以上
✅ 多语言支持：支持西班牙语/英语，框架可扩展
✅ 智能缓存：缓存命中率达 85% 以上，实现快速响应
✅ 自学习：随着使用不断改进

🔌 Claude Code 集成（MCP）

5 个原生代理工具

系统为 Claude Code 提供 5 个原生 MCP 工具：

MCP 工具	负责代理	功能
`search_conversations`	semantic - analyzer - agent	带有语义分析的智能搜索
`get_recent_conversations`	conversation - orchestrator - agent	带有智能上下文的近期活动
`analyze_conversation_patterns`	pattern - discovery - agent	历史模式分析
`export_conversation`	auto - documentation - agent	带有自动文档的导出
`analyze_conversation_intelligence`	conversation - orchestrator - agent	完整的多维分析

Claude Code 配置

~/.claude/settings.json

{
"mcp": {
"mcpServers": {
"conversation - logger": {
"command": "node",
"args": ["src/mcp - server.js"],
"cwd": "/path/to/claude - conversation - logger",
"env": {
"API_URL": "http://localhost:3003",
"API_KEY": "claude_api_secret_2024_change_me"
}
}
}
},
"hooks": {
"UserPromptSubmit": [{"hooks": [{"type": "command", "command": "python3 ~/.claude/hooks/api - logger.py"}]}],
"Stop": [{"hooks": [{"type": "command", "command": "python3 ~/.claude/hooks/api - logger.py"}]}]
}
}

Claude Code 使用示例

🔍 智能搜索

// 使用语义分析搜索相似问题
search_conversations({
query: "React hydration mismatch SSR",
days: 60,
includePatterns: true,
minConfidence: 0.75
})

// 结果：相关对话 + 模式 + 已验证的解决方案

📊 模式分析

// 识别项目中反复出现的问题
analyze_conversation_patterns({
days: 30,
project: "my - api - service",
minFrequency: 3
})

// 结果：主要问题 + 成功率 + 建议

📝 自动文档生成

// 从完成的会话生成文档
export_conversation({
session_id: "current_session",
format: "markdown",
includeCodeExamples: true
})

// 结果：带有问题 + 解决方案 + 代码的结构化 Markdown

🧠 完整的多代理分析

// 使用所有代理进行深度分析
analyze_conversation_intelligence({
session_id: "complex_debugging_session",
includeSemanticAnalysis: true,
includeRelationships: true,
generateInsights: true
})

// 结果：完整分析 + 见解 + 建议

🛠️ 代理 REST API

5 个 Claude Code 端点

分析与协调

# 完整的多代理分析
POST /api/agents/orchestrator
Content - Type: application/json
X - API - Key: claude_api_secret_2024_change_me

{
"type": "deep_analysis",
"data": {"session_id": "sess_123"},
"options": {
"includeSemanticAnalysis": true,
"generateInsights": true,
"maxTokenBudget": 150
}
}

模式发现

# 查找反复出现的模式
GET /api/agents/patterns?days = 30&minFrequency = 3&project = api - service

# 响应：已识别的模式 + 频率 + 解决方案

关系映射

# 搜索相关对话
GET /api/agents/relationships/sess_123?minConfidence = 0.7&maxResults = 10

# 响应：相似对话 + 关系类型 + 置信度

自动文档生成

# 生成智能文档
POST /api/agents/document
{
"session_id": "sess_123",
"options": {
"autoDetectPatterns": true,
"includeCodeExamples": true
}
}

主要 API 端点

对话管理

# 记录对话（由钩子使用）
POST /api/conversations

# 使用语义分析进行搜索
GET /api/conversations/search?q = authentication&days = 30&semantic = true

# 导出带有自动文档的对话
GET /api/conversations/{session_id}/export?format = markdown&enhanced = true

分析与指标

# 项目统计
GET /api/projects/stats

# 代理指标
GET /api/agents/metrics

# 系统健康状态
GET /health

🏗️ 技术架构

代理架构

graph TB
subgraph "🔌 Claude Code 集成"
CC[Claude Code] -->|MCP 工具| MCP[MCP 服务器]
CC -->|钩子| HOOK[Python 钩子]
end

subgraph "🤖 Claude Code 代理系统"
MCP --> CO[conversation - orchestrator - agent]
CO --> SA[semantic - analyzer - agent]
CO --> PD[pattern - discovery - agent]
CO --> AD[auto - documentation - agent]
end

subgraph "💾 数据层"
SA --> MONGO[(MongoDB
8 个集合)]
CO --> REDIS[(Redis
智能缓存)]
end

subgraph "🌐 API 层"
HOOK --> API[REST API 服务器]
API --> CO
end

style CO fill:#9c27b0,color:#fff
style SA fill:#2196f3,color:#fff
style MONGO fill:#4caf50,color:#fff

系统组件

组件	技术	端口	功能
🤖 代理系统	Node.js 18+	-	智能对话分析
🔌 MCP 服务器	MCP SDK	stdio	原生 Claude Code 集成
🌐 REST API	Express.js	3003	代理和管理端点
💾 MongoDB	7.0	27017	8 个专用集合
⚡ Redis	7.0	6379	智能代理缓存
🐳 Docker	Compose	-	整体编排

数据流

sequenceDiagram
participant CC as Claude Code
participant MCP as MCP 服务器
participant CO as conversation - orchestrator - agent
participant AG as 代理 (SA/PD/AD)
participant DB as MongoDB/Redis

CC->>MCP: search_conversations()
MCP->>CO: 处理请求
CO->>AG: 协调分析
AG->>DB: 查询数据 + 缓存
AG->>CO: 专业结果
CO->>MCP: 集成响应
MCP->>CC: 对话 + 见解

⚙️ 代理配置

42 个配置参数

代理系统可通过 Docker Compose 进行完全配置：

🌍 语言配置

# docker - compose.yml
environment:
# 主要语言
AGENT_PRIMARY_LANGUAGE: "es"
AGENT_SECONDARY_LANGUAGE: "en"
AGENT_MIXED_LANGUAGE_MODE: "true"

# 西班牙语 + 英语关键词（JSON 数组）
AGENT_WRITE_KEYWORDS: '["documentar","guardar","document","save","create doc"]'
AGENT_READ_KEYWORDS: '["buscar","encontrar","similar","search","find","lookup"]'
AGENT_RESOLUTION_KEYWORDS: '["resuelto","funcionando","resolved","fixed","working"]'
AGENT_PROBLEM_KEYWORDS: '["error","problema","falla","bug","issue","crash"]'

🎯 性能参数

environment:
# 检测阈值
AGENT_SIMILARITY_THRESHOLD: "0.75"
AGENT_CONFIDENCE_THRESHOLD: "0.80"
AGENT_MIN_PATTERN_FREQUENCY: "3"

# 令牌优化
AGENT_MAX_TOKEN_BUDGET: "100"
AGENT_CACHE_TTL_SECONDS: "300"

# 功能标志
AGENT_ENABLE_SEMANTIC_ANALYSIS: "true"
AGENT_ENABLE_AUTO_DOCUMENTATION: "true"
AGENT_ENABLE_RELATIONSHIP_MAPPING: "true"
AGENT_ENABLE_PATTERN_PREDICTION: "true"

8 个代理 MongoDB 集合

主要集合

// conversations - 基础对话
{
_id: ObjectId("..."),
session_id: "sess_123",
project: "api - service",
user_message: "Payment integration failing",
ai_response: "Let me help debug the payment flow...",
timestamp: ISODate("2025 - 08 - 25T10:00:00Z"),
metadata: {
resolved: true,
complexity: "intermediate",
topics: ["payment", "integration", "debugging"]
}
}

// conversation_patterns - 代理检测到的模式
{
pattern_id: "api_timeout_pattern",
title: "API Timeout Issues",
frequency: 23,
confidence: 0.87,
common_solution: "Increase timeout + add retry logic",
affected_projects: ["api - service", "payment - gateway"]
}

// conversation_relationships - 会话连接
{
source_session: "sess_123",
target_session: "sess_456",
relationship_type: "similar_problem",
confidence_score: 0.89,
detected_by: "semantic - analyzer - agent"
}

// conversation_insights - 生成的见解
{
insight_type: "recommendation",
priority: "high",
title: "Frequent Database Connection Issues",
recommendations: ["Add connection pooling", "Implement retry logic"]
}

📦 安装指南

要求

Docker 20.0+ 及 Docker Compose
Python 3.8+（用于钩子）
已安装并配置 Claude Code
可用内存 4GB 以上

完整安装

1. 克隆并设置

# 克隆仓库
git clone https://github.com/LucianoRicardo737/claude-conversation-logger.git
cd claude-conversation-logger

# 验证结构
ls -la  # 应显示：src/, config/, examples/, docker - compose.yml

2. Docker 部署

# 构建并启动完整系统
docker compose up -d --build

# 验证服务（应显示 1 个运行中的容器）
docker compose ps

# 验证系统健康状态
curl http://localhost:3003/health
# 预期结果：{"status":"healthy","services":{"api":"ok","mongodb":"ok","redis":"ok"}}

3. Claude Code 配置

# 如果钩子目录不存在，则创建
mkdir -p ~/.claude/hooks

# 复制日志钩子
cp examples/api - logger.py ~/.claude/hooks/
chmod +x ~/.claude/hooks/api - logger.py

# 配置 Claude Code 设置
cp examples/claude - settings.json ~/.claude/settings.json
# 或与现有设置合并

4. 系统验证

# API 测试
curl -H "X - API - Key: claude_api_secret_2024_change_me" \
http://localhost:3003/api/conversations | jq .

# 代理测试
curl -H "X - API - Key: claude_api_secret_2024_change_me" \
http://localhost:3003/api/agents/health

# 钩子测试（模拟）
python3 ~/.claude/hooks/api - logger.py

环境变量

基础配置

# 必需
MONGODB_URI=mongodb://localhost:27017/conversations
REDIS_URL=redis://localhost:6379
API_KEY=your_secure_api_key_here
NODE_ENV=production

# 可选性能参数
API_MAX_CONNECTIONS=100
MONGODB_POOL_SIZE=20
REDIS_MESSAGE_LIMIT=10000

代理配置（42 个变量）

# 语言和关键词
AGENT_PRIMARY_LANGUAGE=es
AGENT_MIXED_LANGUAGE_MODE=true
AGENT_WRITE_KEYWORDS='["documentar","document","save"]'

# 性能和阈值
AGENT_MAX_TOKEN_BUDGET=100
AGENT_SIMILARITY_THRESHOLD=0.75
AGENT_CACHE_TTL_SECONDS=300

# 功能标志
AGENT_ENABLE_SEMANTIC_ANALYSIS=true
AGENT_ENABLE_AUTO_DOCUMENTATION=true

💻 使用示例

🔍 场景 1：反复调试

// 问题："Payments fail sporadically"
// 在 Claude Code 中，使用 MCP 工具：
search_conversations({
query: "payment failed timeout integration",
days: 90,
includePatterns: true
})

// semantic - analyzer - agent + pattern - discovery - agent 返回：
// - 找到 8 个相似对话
// - 识别的模式："Gateway timeout after 30s"（频率：23 次）
// - 已验证的解决方案："Increase timeout to 60s + add retry"（成功率：94%）
// - 相关对话：sess_456, sess_789, sess_012

📝 场景 2：自动文档生成

// 解决复杂错误后
// auto - documentation - agent 生成上下文相关的文档：
export_conversation({
session_id: "debugging_session_456",
format: "markdown",
includeCodeExamples: true,
autoDetectPatterns: true
})

// 系统自动生成：
/*
# 解决方案：支付网关超时问题

## 问题识别
- 30 秒后网关超时
- 高峰时段影响支付
- 日志中的错误："ETIMEDOUT"

## 调查过程
1. Nginx 日志分析
2. 超时配置审查
3. 网络延迟监控

## 实施的解决方案
```javascript
const paymentConfig = {
timeout: 60000, // 从 30 秒增加到 60 秒
retries: 3,     // 添加重试逻辑
backoff: 'exponential'
};

验证

✅ 测试通过：payment - integration.test.js
✅ 超时错误从每天 23 次减少到 0 次
✅ 成功率：99.2%


### 📊 场景 3：项目分析
```javascript
// 使用 pattern - discovery - agent 分析项目健康状况
analyze_conversation_patterns({
project: "e - commerce - api",
days: 30,
minFrequency: 3,
includeSuccessRates: true
})

// 系统自动识别：
{
"top_issues": [
{
"pattern": "Database connection timeouts",
"frequency": 18,
"success_rate": 0.89,
"avg_resolution_time": "2.3 小时",
"recommended_action": "Implement connection pooling"
},
{
"pattern": "Redis cache misses",
"frequency": 12,
"success_rate": 0.92,
"avg_resolution_time": "45 分钟",
"recommended_action": "Review cache invalidation strategy"
}
],
"trending_topics": ["authentication", "api - rate - limiting", "database - performance"],
"recommendation": "Focus on database optimization - 60% of issues stem from DB layer"
}

🔗 场景 4：智能上下文搜索

// 处理新问题时，搜索相似上下文
// semantic - analyzer - agent 找到智能连接：
search_conversations({
query: "React component not rendering after state update",
days: 60,
includeRelationships: true,
minConfidence: 0.7
})

// 带有关系分析的结果：
{
"direct_matches": [
{
"session_id": "sess_789",
"similarity": 0.94,
"relationship_type": "identical_problem",
"solution_confidence": 0.96,
"quick_solution": "Add useEffect dependency array"
}
],
"related_conversations": [
{
"session_id": "sess_234",
"similarity": 0.78,
"relationship_type": "similar_context",
"topic_overlap": ["React", "state management", "useEffect"]
}
],
"patterns_detected": {
"common_cause": "Missing useEffect dependencies",
"frequency": 15,
"success_rate": 0.93
}
}

🧠 场景 5：完整的多代理分析

// 对于复杂对话，激活所有代理：
analyze_conversation_intelligence({
session_id: "complex_debugging_session",
includeSemanticAnalysis: true,
includeRelationships: true,
generateInsights: true,
maxTokenBudget: 200
})

// conversation - orchestrator - agent 协调所有代理：
{
"semantic_analysis": {
"topics": ["microservices", "docker", "kubernetes", "monitoring"],
"entities": ["Prometheus", "Grafana", "Helm charts"],
"complexity": "advanced",
"resolution_confidence": 0.91
},
"session_state": {
"status": "completed",
"quality_score": 0.87,
"documentation_ready": true
},
"relationships": [
{
"session_id": "sess_345",
"similarity": 0.82,
"type": "follow_up"
}
],
"patterns": {
"recurring_issue": "Kubernetes resource limits",
"frequency": 8,
"trend": "increasing"
},
"insights": [
{
"type": "recommendation",
"priority": "high",
"description": "Consider implementing HPA for dynamic scaling",
"confidence": 0.85
}
]
}

📖 完整的代理文档

如需高级使用和详细配置，请参考代理文档：

🤖 Claude Code 代理文件 - 以 Markdown 格式提供的完整代理配置
[🎭 conversation - orchestrator - agent](./.claude/agents/conversation - orchestrator - agent.md) - 主要协调器配置
[🧠 semantic - analyzer - agent](./.claude/agents/semantic - analyzer - agent.md) - 语义分析代理
[🔍 pattern - discovery - agent](./.claude/agents/pattern - discovery - agent.md) - 模式发现配置
[📝 auto - documentation - agent](./.claude/agents/auto - documentation - agent.md) - 文档生成代理
📋 上下文系统 - 知识库和故障排除指南

📚 详细文档

📚 项目结构

claude - conversation - logger/
├── 📄 README.md                     # 主文档
├── 🚀 QUICK_START.md                # 快速设置指南
├── 🐳 docker - compose.yml            # 完整编排
├── 📦 package.json                  # 依赖项和脚本

├── 🔧 config/                       # 服务配置
│   ├── supervisord.conf             # 进程管理
│   ├── mongodb.conf                 # MongoDB 配置
│   └── redis.conf                   # Redis 配置

├── 🔌 src/                          # 源代码
│   ├── server.js                    # 主 API 服务器
│   ├── mcp - server.js               # 用于 Claude Code 的 MCP 服务器
│   │
│   ├── 💾 database/                 # 数据层
│   │   ├── mongodb - agent - extension.js  # MongoDB + 代理集合
│   │   ├── redis.js                 # 智能缓存
│   │   └── agent - schemas.js         # 代理模式
│   │
│   ├── 🔧 services/                 # 业务服务
│   │   ├── conversationService.js   # 对话管理
│   │   ├── searchService.js         # 语义搜索
│   │   └── exportService.js         # 带代理的导出
│   │
│   └── 🛠️ utils/                    # 实用工具
│       └── recovery - manager.js      # 数据恢复

├── 🤖 .claude/                      # Claude Code 集成
│   ├── agents/                      # 代理定义（Markdown 格式）
│   │   ├── conversation - orchestrator - agent.md  # 主要协调器
│   │   ├── semantic - analyzer - agent.md          # 语义分析
│   │   ├── pattern - discovery - agent.md          # 模式检测
│   │   └── auto - documentation - agent.md         # 文档生成
│   └── context/                     # 知识库和故障排除

├── 💡 examples/                     # 示例和配置
│   ├── claude - settings.json         # 完整的 Claude Code 配置
│   ├── api - logger.py               # 日志钩子
│   └── mcp - usage - examples.md       # MCP 使用示例

└── 🧪 tests/                       # 测试套件
├── agents.test.js              # 代理测试
├── api.test.js                 # API 测试
└── integration.test.js         # 集成测试

📈 指标与性能

🎯 代理指标

语义分析：主题检测准确率达 95% 以上
状态检测：完成/活跃状态检测准确率达 90% 以上
关系映射：相似度准确率达 85% 以上
令牌优化：与手动分析相比，减少 70% 的令牌使用量
响应时间：完整分析时间小于 3 秒

⚡ 系统性能

启动时间：完整容器启动时间小于 30 秒
API 响应时间：平均小于 100 毫秒
缓存命中率：频繁查询的缓存命中率达 85% 以上
内存使用：典型情况下约 768MB
并发用户数：支持 100 个以上并发用户

📊 代码库统计

代码行数：3800 行以上（优化的代理系统）
JavaScript 文件：15 个以上核心文件
代理文件：4 个与 Claude Code 兼容的文件
API 端点：28 个以上端点（23 个核心 + 5 个代理工具）
MCP 工具：5 个原生工具
MongoDB 集合：8 个专用集合

🛡️ 安全与维护

🔐 安全

API 密钥认证：所有端点都需要 API 密钥认证
Helmet.js 安全：提供安全头和保护
速率限制：生产环境中 15 分钟内限制 200 个请求
可配置 CORS：跨域策略可配置
数据加密：数据在静止和传输时均加密

🔧 故障排除

系统无法启动

# 查看日志
docker compose logs -f

# 检查资源
docker stats

代理无响应

# 代理健康检查
curl http://localhost:3003/api/agents/health

# 检查配置
curl http://localhost:3003/api/agents/config

钩子不工作

# 手动测试钩子
python3 ~/.claude/hooks/api - logger.py

# 检查权限
chmod +x ~/.claude/hooks/api - logger.py

# 测试 API 连接性
curl -X POST http://localhost:3003/api/conversations \
-H "X - API - Key: claude_api_secret_2024_change_me" \
-H "Content - Type: application/json" \
-d '{"test": true}'

📞 支持与贡献

🆘 获取帮助

📖 技术文档：请参阅 Claude Code 代理
🐛 报告错误：通过 GitHub Issues 报告
💡 功能请求：通过 GitHub Discussions 提出

🤝 贡献

# 分叉并克隆
git clone https://github.com/your - username/claude - conversation - logger.git

# 创建功能分支
git checkout -b feature/agent - improvements

# 开发和测试
npm test
npm run test:agents

# 提交拉取请求
git push origin feature/agent - improvements

🧪 本地开发

# 安装依赖项
npm install

# 配置开发环境
cp examples/claude - settings.json ~/.claude/settings.json

# 以开发模式启动
npm run dev

# 运行代理测试
npm run test:agents

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE。

作者：Luciano Emanuel Ricardo
版本：3.1.0 - 与 Claude Code 兼容的代理系统
仓库：https://github.com/LucianoRicardo737/claude - conversation - logger

🎉 总结

✅ 4 个与 Claude Code 兼容的代理 - 优化的多维智能分析
✅ 原生 Claude Code 集成 - 5 个即用型 MCP 工具
✅ 70% 令牌优化 - 分析效率最大化
✅ 多语言支持 - 支持西班牙语/英语，框架可扩展
✅ 深度语义分析 - 真正理解技术内容
✅ 自动文档生成 - 上下文相关的指南生成
✅ 模式发现 - 主动识别反复出现的问题
✅ 关系映射 - 智能对话连接
✅ 智能缓存 - 缓存命中率达 85% 以上，实现即时响应
✅ 完整的 REST API - 28 个以上端点，包括 Claude Code 代理工具
✅ Docker 部署 - 生产就绪的整体系统
✅ 42 个可配置参数 - 通过 Docker Compose 实现完全定制

🚀 拥有智能代理系统，可立即部署！

0 条评论
分类：笔记

Claude Conversation Logger