安装
curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash适合谁
面向要在本机快速看目录结构、并愿意用同一套二进制做安全扫描与 MCP 服务的人。官方写明 Smart Tree 是 blazingly fast, AI-friendly directory visualization tool，比传统 tree 快 10-24x，用 Rust 构建，并带 Security Scanner 与 30+ MCP tools。
适合你能在 Linux、macOS 或 WSL 执行官方安装脚本，并且第一次只想确认安装成功、最多做一次只读扫描。不要把第一次尝试设成清理删除。
若你不能接受该程序读取当前工作区文件，就不要跑扫描。官方页面： https://github.com/8b-is/smart-tree
3 分钟完成第一次尝试
只走一条安装：curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash 。这是 Linux/macOS/WSL 的 one line install。不要把其他安装器写成主路径。
前置：能执行 curl 与 bash，并接受该脚本改动本机 PATH 与二进制。装完先跑 st --version 做 Verify installation。能看到版本输出，再继续。
一次低风险调用：st --security-scan . 。官方说明是 Scan codebase for attack patterns，并点名 IPFS injection、fake verification。这会读当前目录，但页面没有说它会删除文件。不要加未写出的参数。
成功信号：命令结束并给出扫描结果文本。官方说明没有列出结果字段；看不到某类告警时，只记为页面未写到。
只读扫描不是零风险。它会读本地代码。官方说明没有声明无网络、无本地读取或无私隐边界。
使用案例
案例一：扫描当前目录的攻击模式。安装并 st --version 通过后，在目标仓库根目录执行 st --security-scan . 。只根据页面已写的攻击模式理解输出，不要编造规则名。
案例二：从交互菜单启动 MCP Server。官方菜单第 6 项是 MCP Server，说明为 Model Context Protocol (stdio)。同表还有 HTTP Daemon 与 Custom Command。页面没有写出打开该菜单的命令，因此不要编造启动参数；只能确认存在 stdio 这一项。30+ MCP tools 也没有给出单工具名，不要虚构调用。
使用边界
装完后的 st --cleanup 会 Scan and remove malicious MCP servers, hooks, and hidden directories，属于删除动作。还有 st --cleanup -y 会 Non-interactive cleanup (auto-confirm)。第一次不要用这两条。若你之后要用，须先确认将要被移除的对象，并知道页面没有给出撤销路径。
官方还提到 Security Scanner、Aye Consciousness、Spicy TUI，但没有写出对应命令或开关，缺了就不要编造。目录可视化本身会读文件系统；把它当 MCP 服务时，同样会暴露本机目录上下文。