Smart Tree

🚀 🌳 智能树 - 闪电般快速的目录可视化工具

智能树（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 倍）

📊 输出格式

查看 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 团队用心开发 ❤️