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 團隊用心開發 ❤️