克劳德工具
一套全面的工具，用于使用Claude、Claude Code和MCP服务器。
当前状态：第二阶段已完成！ 🎉
✅ 已交付高级功能 -时间线分析、导出系统、性能优化
特性
🖥️ 交互式终端用户界面
- Vim风格导航：j/k，g/g，/？，q键盘快捷键
- 对话浏览器：带有摘要和元数据的可滚动列表
- 详情视图：完整的对话显示，带有标记渲染和语法突出显示
- 高级搜索：TF-IDF排名、正则表达式支持、视觉突出显示、导航（n/n）
- 时间线仪表板：带有项目分析的活动时间表（按“t”）
- 分析仪表板：综合统计数据和见解（按“a”）
- 导出功能：直接从UI导出对话（在详细视图中按“e”）
- 帮助系统：内置帮助覆盖所有键盘快捷键
🔍 高级搜索功能
- 布尔查询：具有AND、OR、NOT运算符和括号分组的复杂逻辑
- 自然语言日期：自动解析“7天前”、“上周”、“昨天”
- 多标准筛选：按型号、工具、角色、日期范围、消息计数、持续时间筛选
- 正则表达式：带有验证和优化的完整正则表达式模式匹配
- 视觉突出显示：匹配对话片段中的突出显示
- 相关性评分：TF-IDF排名，新近度和对话质量提升
- 演出：并行处理和智能缓存的搜索时间\
cd claude_code cargo build --release
Install globally for easier usage
cargo install --path .
Interactive terminal UI (recommended)
claude-tools interactive # or: cargo run -- interactive
Timeline analysis
claude-tools timeline --period day claude-tools timeline --period week --detailed claude-tools timeline --export json --output timeline.json
Command line interface
claude-tools list --detailed claude-tools search "(rust OR python) AND error" # Boolean queries claude-tools search "async.*function" --regex # Regular expressions claude-tools search "debug" --tool bash --after "7 days ago" # Multi-criteria claude-tools show --format markdown claude-tools show --export html --output conversation.html claude-tools stats --global --export csv
### 📈 演出
- **127+个对话** 从real~/.claude/data中高效解析
- **17976+条消息** 采用内存高效流式处理
- **\<200ms时间线生成** 具有智能缓存和过滤功能
- **\<50ms搜索时间** 具有并行处理和TF-IDF排名
- **瞬时周期切换** 通过智能过滤而不是再生
- **跨平台** 支持（Linux、macOS、Windows）
## 发展路线图
### 第一阶段：MVP-历史浏览器✅ 完成
- ✅ CLI基础和参数解析
- ✅ ~/.claude/目录分析与解析
- ✅ 用于大文件的流式JSON阅读器
- ✅ 带有键盘导航的终端用户界面
- ✅ 人类可读的对话显示
- ✅ 搜索和过滤功能
- ✅ 帮助系统和文档
### 第二阶段：增强浏览✅ 完成
- ✅ 使用布尔查询、正则表达式和多条件过滤进行高级搜索
- ✅ 视觉搜索突出显示和导航
- ✅ 带语法高亮显示的Markdown渲染
- ✅ 对话统计和分析
- ✅ 使用CLI和交互式UI导出为多种格式（markdown、HTML、JSON）
- ✅ 带有智能缓存的活动时间线仪表板
- ✅ Timeline CLI与导出功能的集成
- ✅ 智能过滤的性能优化
### 第3阶段：MCP服务器管理（进行中）
- ✅ 服务器发现框架
- ✅ 配置管理结构
- ✅ 服务器列表的基本CLI集成
- 🔲 健康监测和诊断
- 🔲 高级服务器管理功能
- 🔲 日志聚合和查看
### 第四阶段：克劳德代码SDK集成（愿景）
- 多实例协调
- 工作流编排
- 会话模板和预设
- 跨会话上下文共享
### 第五阶段：代理任务管理（愿景）
- 正式任务管道系统
- 人工监督下的自动化执行
- 依赖管理
- 进度跟踪和报告
## 技术栈
- **语言**：Rust（用于性能和内存安全）
- **命令行界面**：clap用于参数解析，并提供全面的帮助
- **文本用户界面**：ratatui用于具有交叉项的终端接口
- **搜索**：定制TF-IDF引擎，支持人造丝并行处理
- **分析**：使用时间索引和缓存进行时间线分析
- **渲染**：pulldown cmark用于标记，syntect用于语法高亮显示
- **出口**：多格式导出系统（Markdown、HTML、JSON、CSV）
- **对象符号**：serde_json，支持大文件流式传输
- **缓存**：基于哈希的智能缓存，具有LRU驱逐功能
- **演出**：智能过滤和分层缓存查找
## 项目结构
claude_code/ ├── src/ # Source code │ ├── cli/ # Command-line interface │ │ ├── args.rs # CLI argument definitions │ │ └── commands.rs # Command implementations │ ├── claude/ # Claude-specific functionality │ │ ├── analytics.rs # Conversation analytics │ │ ├── cache.rs # Timeline caching system │ │ ├── conversation.rs # Data structures and parsing │ │ ├── directory.rs # Directory detection │ │ ├── export.rs # Export functionality │ │ ├── search.rs # Search engine │ │ └── timeline.rs # Activity timeline │ ├── mcp/ # MCP server management │ │ ├── discovery.rs # Server discovery │ │ └── server.rs # Server management │ ├── ui/ # Terminal user interface │ │ ├── app.rs # Main application state │ │ └── conversation_display.rs # Rendering │ ├── errors.rs # Error handling │ ├── lib.rs # Library exports │ └── main.rs # Application entry point ├── tasks/ # Task management │ ├── active/ # Current work items │ ├── completed/ # Finished tasks │ └── backlog/ # Future tasks ├── tests/ # Integration tests ├── CLAUDE.md # Development guidance └── README.md # Project documentation
## 贡献
该项目采用结构化的任务管理方法。看 [tasks/tasks-directive.md](tasks/tasks-directive.md) 关于创建和管理任务的指南。
## 许可证
\[许可证待定\]
______________________________________________________________________
*该项目尚处于早期开发阶段。明星和关注更新！*