🚀 🌳 智能树 - 闪电般快速的目录可视化工具
智能树（Smart Tree）是一款极快的、对人工智能友好的目录可视化工具，比传统的 tree 命令快 10 - 24 倍。它采用 Rust 语言构建，以实现最高性能和最小环境影响。
🚀 快速开始
# 安装智能树
curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash
# 基本用法
st # 当前目录的经典树状视图
st --mode ai --compress # 针对 AI 优化的压缩输出
st --search "TODO" # 在所有文件中搜索 TODO
st --mode quantum src/ # 对大型代码库进行量子压缩
✨ 主要特性
- ⚡ 闪电般快速：比传统的树命令快 10 - 24 倍。
- 🤖 针对 AI 优化：多种输出格式专为大语言模型（LLM）设计。
- 🗜️ 量子压缩：输出大小最多可减少 10 倍。
- 🔍 智能搜索：可按行号和上下文进行内容搜索。
- 📡 MCP 服务器：通过模型上下文协议（Model Context Protocol）为 AI 助手提供 30 多种工具。
- 🌍 环保：每次扫描都能通过高效性能节省二氧化碳排放。
📦 安装指南
Homebrew（macOS/Linux）
brew install --HEAD 8b-is/smart-tree/smart-tree
从源代码安装
git clone https://github.com/8b-is/smart-tree.git
cd smart-tree
cargo build --release
sudo cp target/release/st /usr/local/bin/
为 AI 助手（Claude Desktop）安装
st --mcp-config >> ~/Library/Application\ Support/Claude/claude_desktop_config.json
🎯 常见使用场景
开发者使用场景
st --mode classic --depth 3 # 快速概览项目
st --search "function" src/ # 查找所有函数
st --mode stats # 项目统计信息
st --mode git-status # 在树状视图中查看 git 更改
AI/大语言模型使用场景
st --mode ai --compress # 针对令牌效率进行优化
st --mode quantum-semantic # 语义代码理解
st --mode summary-ai # 超压缩摘要
大型代码库使用场景
st --stream /huge/project # 对大型目录进行流式输出
st --mode quantum --compress # 最大程度压缩（减少 100 倍）
📊 输出格式
| 格式 | 描述 | 适用场景 |
|---|---|---|
classic |
带有表情符号的传统树状视图 | 人工查看 |
ai |
经过压缩的十六进制格式 | AI 助手 |
quantum |
二进制波压缩格式 | 大型目录 |
quantum-semantic |
语义分组格式 | 代码分析 |
summary-ai |
压缩摘要格式 | 快速概览 |
json |
标准 JSON 格式 | 数据处理 |
stats |
目录统计信息格式 | 项目指标 |
查看 TERMINAL_EXAMPLES.md 可获取漂亮的输出示例！
🛠️ MCP 服务器（AI 工具）
智能树包含 30 多种为 AI 助手提供的 MCP 工具：
# 启动 MCP 服务器
st --mcp
# 列出可用工具
st --mcp-tools
# 常用工具：
- quick_tree: 三级概览，压缩率达 10 倍
- project_overview: 全面的项目分析
- search_in_files: 带行号的内容搜索
- smart_edit: 支持抽象语法树（AST）的代码编辑（减少 90% 令牌）
- semantic_analysis: 基于波的代码理解
🌍 环境影响
每次使用智能树进行扫描都能节省能源并减少二氧化碳排放：
- 快 10 - 24 倍 = 减少 CPU 运行时间
- 减少 CPU 运行时间 = 降低能源消耗
- 降低能源消耗 = 减少碳足迹
- 您的贡献：每扫描 1000 次大约可节省 12 克二氧化碳
📚 详细文档
- TERMINAL_EXAMPLES.md - 精美的终端输出示例
- CLAUDE.md - AI 助手开发指南
- docs/ - 其他文档
- scripts/manage.sh - 多彩的项目管理脚本
🤝 贡献
我们欢迎大家的贡献！智能树由一个独特的团队开发：
- Hue（人类） - 愿景与方向
- Aye（AI） - 实现与优化
- Trish（来自会计部门） - 以独特风格保持项目有序
📈 版本历史
当前版本：v4.8.8
近期改进：
- v4.8.8: 由 Claude 进行代码格式化、代码检查和维护更新
- v4.8.7: 将 Marqant 迁移到 Crate
- v4.8.4: 自动版本管理系统
- v4.8.3: 修复 MCP 模式验证问题
- v4.8.2: API 离线时的本地反馈回退机制
- v4.8.1: 简化工具请求 API
查看 CHANGELOG.md 可获取完整历史记录。
🎉 有趣事实
- 智能树每秒可处理 670,000+ 个文件。
- 完全使用 Rust 编写，确保安全和速度。
- 包含 40+ 种文件类型的表情符号映射。
- 全球范围内大约节省了 1.2 吨 二氧化碳。
- 代码中包含 “The Cheet”（我们的音乐代码解说员）的注释。
📄 许可证
本项目采用 MIT 许可证，详情请查看 LICENSE。
智能树 - 让目录变得美观，一次扫描，拯救地球！🌳
由 8b.is 团队用心开发 ❤️