项目介绍
Claude Tools
一套全面的工具，用于处理Claude、Claude Code和MCP服务器。
当前状态：第二阶段完成！ 🎉
✅ 高级功能交付 - 时间线分析、导出系统、性能优化
功能
🖥️ 交互式终端UI
- Vim风格导航：j/k, g/G, /, ?, q快捷键
- 对话浏览器：带有摘要和元数据的可滚动列表
- 详细视图：带有Markdown渲染和语法高亮的完整对话显示
- 高级搜索：TF-IDF排名、正则表达式支持、视觉高亮、导航(n/N)
- 时间线仪表板：带有项目分析的活动时间线（按't'键）
- 分析仪表板：综合统计和洞察（按'a'键）
- 导出功能：从UI直接导出对话（在详细视图中按'e'键）
- 帮助系统：内置帮助覆盖，包含所有快捷键
🔍 高级搜索功能
- 布尔查询：使用AND、OR、NOT运算符和括号分组的复杂逻辑
- 自然语言日期：自动解析“7天前”、“上周”、“昨天”
- 多条件过滤：按模型、工具、角色、日期范围、消息数量、持续时间过滤
- 正则表达式：完整的正则表达式模式匹配，带验证和优化
- 视觉高亮：对话片段中的匹配高亮
- 相关性评分：TF-IDF排名，带最近性和对话质量提升
- 性能：并行处理和智能缓存下的<50毫秒搜索时间
📊 时间线与分析仪表板
- 活动时间线：显示项目级别活动模式的可视化时间线
- 时间段分析：24小时、48小时、1周、1个月的时间窗口
- 项目排名：带有活动指标和趋势的智能排名
- 工具使用跟踪：跨项目和时间段的顶级工具分析
- 智能缓存：基于哈希的验证，即时切换时间段
- 导出能力：将时间线和分析导出为JSON或CSV
- 交互式导航：从时间线导航到项目对话
- 性能优化：智能过滤下的<200毫秒时间线生成
📊 高级分析
- 综合指标：涵盖所有对话方面的6个分析类别
- 时间分析：高峰使用时段、工作日模式、活动趋势
- 模型和工具使用：跟踪您最常用的模型和工具
- 项目分析：了解对话在项目间的分布情况
- 质量指标：平均时长、完成率、消息长度统计
- 交互式仪表板：带有滚动和导航的终端UI分析视图
💻 命令行界面
- 列出对话：查看所有对话，可选详细视图
- 显示对话：以多种格式显示完整对话内容
- 时间线命令：生成具有各种时间段的活动时间线
- 导出对话：导出为Markdown、HTML、JSON格式，带完整元数据
- 内容搜索：通过内容查找对话，并突出显示匹配项
- 统计数据：带有导出功能的综合分析（JSON/CSV）
- MCP管理：发现和管理MCP服务器
🚀 快速开始
# 克隆并构建
git clone <repository-url>
cd claude_code
cargo build --release
# 安装全局以便于使用
cargo install --path .
# 交互式终端UI（推荐）
claude-tools interactive # 或：cargo run -- interactive
# 时间线分析
claude-tools timeline --period day
claude-tools timeline --period week --detailed
claude-tools timeline --export json --output timeline.json
# 命令行界面
claude-tools list --detailed
claude-tools search "(rust OR python) AND error" # 布尔查询
claude-tools search "async.*function" --regex # 正则表达式
claude-tools search "debug" --tool bash --after "7 days ago" # 多条件
claude-tools show <conversation-id> --format markdown
claude-tools show <id> --export html --output conversation.html
claude-tools stats --global --export csv
📈 性能
- 127+对话高效解析来自真实的~/.claude/数据
- 17,976+消息使用内存高效的流式处理
- <200毫秒时间线生成，带智能缓存和过滤
- <50毫秒搜索时间，带并行处理和TF-IDF排名
- 即时时间段切换，通过智能过滤而非重新生成
- 跨平台支持（Linux、macOS、Windows）
开发路线图
第一阶段：MVP - 历史浏览器 ✅ 完成
- ✅ 命令行基础和参数解析
- ✅ 分析和解析~/.claude/目录
- ✅ 大文件的流式JSON读取器
- ✅ 带键盘导航的终端UI
- ✅ 易于阅读的对话显示
- ✅ 搜索和过滤功能
- ✅ 帮助系统和文档
第二阶段：增强浏览 ✅ 完成
- ✅ 带布尔查询、正则表达式和多条件过滤的高级搜索
- ✅ 视觉搜索高亮和导航
- ✅ 带语法高亮的Markdown渲染
- ✅ 对话统计和分析
- ✅ 带有CLI和交互式UI的多种格式导出（Markdown、HTML、JSON）
- ✅ 带智能缓存的活动时间线仪表板
- ✅ 带导出功能的时间线CLI集成
- ✅ 带智能过滤的性能优化
第三阶段：MCP服务器管理（进行中）
- ✅ 服务器发现框架
- ✅ 配置管理结构
- ✅ 基本CLI集成，用于服务器列表
- 🔲 健康监控和诊断
- 🔲 高级服务器管理功能
- 🔲 日志聚合和查看
第四阶段：Claude Code SDK集成（愿景）
- 多实例协调
- 工作流编排
- 会话模板和预设
- 跨会话上下文共享
第五阶段：代理任务管理（愿景）
- 正式的任务流水线系统
- 带有人类监督的自动化执行
- 依赖管理
- 进度跟踪和报告
技术栈
- 语言：Rust（为了性能和内存安全）
- CLI：clap用于参数解析，附带全面的帮助
- TUI：ratatui用于终端接口，配合crossterm
- 搜索：自定义TF-IDF引擎，带rayon并行处理
- 分析：时间线分析，带时间索引和缓存
- 渲染：pulldown-cmark用于Markdown，syntect用于语法高亮
- 导出：多种格式导出系统（Markdown、HTML、JSON、CSV）
- JSON：serde_json，带大文件的流式支持
- 缓存：基于哈希的智能缓存，带LRU淘汰
- 性能：智能过滤和层次化缓存查找
项目结构
claude_code/
├── src/ # 源代码
│ ├── cli/ # 命令行界面
│ │ ├── args.rs # CLI参数定义
│ │ └── commands.rs # 命令实现
│ ├── claude/ # Claude特定功能
│ │ ├── analytics.rs # 对话分析
│ │ ├── cache.rs # 时间线缓存系统
│ │ ├── conversation.rs # 数据结构和解析
│ │ ├── directory.rs # 目录检测
│ │ ├── export.rs # 导出功能
│ │ ├── search.rs # 搜索引擎
│ │ └── timeline.rs # 活动时间线
│ ├── mcp/ # MCP服务器管理
│ │ ├── discovery.rs # 服务器发现
│ │ └── server.rs # 服务器管理
│ ├── ui/ # 终端用户界面
│ │ ├── app.rs # 主应用程序状态
│ │ └── conversation_display.rs # 渲染
│ ├── errors.rs # 错误处理
│ ├── lib.rs # 库导出
│ └── main.rs # 应用程序入口点
├── tasks/ # 任务管理
│ ├── active/ # 当前工作项
│ ├── completed/ # 完成的任务
│ └── backlog/ # 未来任务
├── tests/ # 集成测试
├── CLAUDE.md # 开发指南
└── README.md # 项目文档
贡献
此项目遵循结构化的任务管理方法。参见tasks/tasks-directive.md以获取创建和管理任务的指南。
许可证
[许可证待定]
此项目处于早期开发阶段。关注并收藏以获取更新！