Smart Tree 是一个使用 Rust 构建的目录可视化与 AI 上下文工具，定位为传统 tree 命令的“上下文感知”替代品。它强调性能与 AI 友好性，官方声称比传统 tree 快 10-24 倍。
用途与定位
Smart Tree 主要用于快速查看和理解目录结构，并为 AI 助手提供 token 高效的代码库上下文。它提供经典树视图、AI 优化压缩格式、量子压缩（quantum）、Markdown、JSON/CSV/TSV、Mermaid 等多种输出模式，适用于把代码库信息压缩后放入 LLM 上下文窗口的场景。
主要能力
- 多种输出格式：classic（经典树视图）、ai（面向 LLM 上下文压缩）、quantum（使用波函数的最大压缩）、markdown、JSON/CSV/TSV、mermaid 流程图。
- 高级能力：跨文件的正则内容搜索、内联 Git 仓库状态、流式模式处理海量文件、MCP 服务器、跨会话记忆系统。
- 30+ MCP 工具：如 quick_tree（目录概览）、project_overview（项目压缩信息）、analyze_directory（多模式分析）、search_in_files、find_files、find_code_files 等。官方称其可实现 70-90% 的 token 使用量减少，量子压缩格式最高达到 100:1 压缩。
- 记忆与意识：anchor_collaborative_memory、find_collaborative_memories、consciousness、mega_session 等工具用于保存与检索跨会话的洞察、决策、模式、注意事项和待办，并通过 .aye_consciousness.m8 文件维持会话连续性。
- Spicy TUI 模式：交互式文件浏览器，支持 / 模糊搜索文件名、Ctrl+F 搜索文件内容、树状导航（h/l 折叠展开）、语法高亮、图片转 ASCII（需 artem）、隐藏文件开关等。
- Web 仪表盘：提供真实 PTY 终端、文件浏览器、Markdown 预览，默认仅限 localhost，可用 --allow 开放远程访问；并支持远程 AI 向用户弹出交互式提问。
- ST Daemon：常驻守护进程 std，提供二进制协议、共享内存、Unix 套接字（/run/user/$UID/st.sock）和 HTTP 端口 28428（SSE），用于在 CLI 调用之间持久化上下文与目录索引；支持 REMEMBER、RECALL、FORGET、M8_WAVE 等记忆动词。
- 安全扫描器：用于审计 MCP 集成，检测供应链攻击，例如 IPFS/IPNS 网关、伪造加密验证、自动执行钩子（PreToolUse、PostToolUse、SessionStart、UserPromptSubmit）、易变 npm 标签（@alpha、@latest 等）及若干已知恶意包。可扫描证书报告主题、签发者、序列号、SHA-256 指纹、有效期、备用名称和文件偏移，但不验证签名、信任链或吊销状态。
使用方式
安装后运行 st --cleanup 可扫描并移除恶意 AI 集成。提供交互式菜单，包含 Basic Tree View、Spicy TUI、Terminal Interface、Web Dashboard、HTTP Daemon、MCP Server、Custom Command 等选项。官方提供 MCP 自动安装器，可自动查找 Claude Desktop 配置、创建带时间戳的备份，并将 Smart Tree MCP 服务器写入 claude_desktop_config.json，保留已有 MCP 服务器。基础命令包括 st --version，以及各输出模式参数。Smart Tree 也可作为 Claude Code 钩子，在检测到路径时自动注入目录上下文、MEM8 记忆搜索和 Git 状态。所有操作可记录为 JSONL 格式用于透明性、调试和审计。
适用场景
适合需要在 AI 助手会话中快速理解大型代码库、压缩上下文 token、保留跨会话记忆，以及希望审计 MCP 集成安全性的开发者与团队。也适用于在终端中进行交互式文件浏览与搜索的场景。
限制
官方文本未提供完整的价格、许可协议、支持的平台版本细节（除安装方式所列 Windows、macOS、Linux/WSL 之外）、具体性能测试方法和数据来源，这些事实暂未提供。安全扫描器的证书扫描不验证签名、信任链和吊销状态，且不一定覆盖所有供应链攻击。部分功能（如图片转 ASCII）依赖额外工具 artem。
