AI导哈

Claude工具套件

一套用于处理Claude、Claude Code和MCP服务器的综合工具套件，提供高级搜索、时间线分析、终端UI等功能。

  • by heffrey78
  • Rust
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 heffrey78/claude-tools

使用说明

克劳德工具

一套全面的工具，用于使用Claude、Claude Code和MCP服务器。

当前状态：第二阶段已完成！ 🎉

✅ 已交付高级功能 -时间线分析、导出系统、性能优化

特性

🖥️ 交互式终端用户界面

  • Vim风格导航：j/k，g/g，/？，q键盘快捷键
  • 对话浏览器：带有摘要和元数据的可滚动列表
  • 详情视图：完整的对话显示，带有标记渲染和语法突出显示
  • 高级搜索：TF-IDF排名、正则表达式支持、视觉突出显示、导航（n/n）
  • 时间线仪表板：带有项目分析的活动时间表（按“t”）
  • 分析仪表板：综合统计数据和见解（按“a”）
  • 导出功能：直接从UI导出对话（在详细视图中按“e”）
  • 帮助系统：内置帮助覆盖所有键盘快捷键

🔍 高级搜索功能

  • 布尔查询：具有AND、OR、NOT运算符和括号分组的复杂逻辑
  • 自然语言日期：自动解析“7天前”、“上周”、“昨天”
  • 多标准筛选：按型号、工具、角色、日期范围、消息计数、持续时间筛选
  • 正则表达式：带有验证和优化的完整正则表达式模式匹配
  • 视觉突出显示：匹配对话片段中的突出显示
  • 相关性评分：TF-IDF排名，新近度和对话质量提升
  • 演出：并行处理和智能缓存的搜索时间<50ms

📊 时间线和分析仪表板

  • 活动时间表：显示项目级活动模式的视觉时间线
  • 时间周期分析：24小时、48小时、1周、1个月的时间窗口
  • 项目排名：使用活动指标和趋势进行智能排名
  • 工具使用跟踪：跨项目和时间段的顶级工具分析
  • 智能高速缓存：基于哈希的即时周期切换验证
  • 导出功能：将时间线和分析导出为JSON或CSV
  • 交互式导航：从时间线导航到项目对话
  • 性能优化：使用智能过滤生成<200ms的时间线

📊 高级分析

  • 综合指标：6个分析类别，涵盖所有对话方面
  • 时间分析：高峰使用时间、工作日模式、活动趋势
  • 模型和工具使用：跟踪您最常用的模型和工具
  • 项目分析：了解项目之间的对话分布
  • 质量指标：平均持续时间、完成率、消息长度统计数据
  • 交互式仪表板：具有滚动和导航功能的终端UI分析视图

💻 命令行接口

  • 列出对话：使用可选的详细视图查看所有对话
  • 显示对话：以多种格式显示完整的对话内容
  • 时间线命令：生成具有不同时间段的活动时间表
  • 导出对话：导出为Markdown、HTML、JSON格式，并包含完整的元数据
  • 搜索内容：通过匹配突出显示按内容查找对话
  • 统计：具有导出功能的全面分析（JSON/CSV）
  • MCP管理：发现和管理MCP服务器

🚀 快速开始

# Clone and build
git clone <repository-url>
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 <conversation-id> --format markdown
claude-tools show <id> --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 关于创建和管理任务的指南。

许可证

[许可证待定]

该项目尚处于早期开发阶段。明星和关注更新！

相关 MCP