安裝
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 服務時,同樣會暴露本機目錄上下文。