📖 工具介紹

專案檔案樹產生器是一款完全免費、即開即用的線上目錄視覺化工具。撰寫技術文件、提交開源專案 README、向團隊講解專案結構時，一張清晰的檔案樹能讓讀者瞬間建立整體認識。本工具把手動整理目錄結構的過程徹底自動化：您可以直接在瀏覽器中選擇整個專案資料夾，工具會遞迴讀取其中所有檔案的相對路徑；也可以在文字框中每列貼上一條路徑（支援斜線或反斜線分隔）。兩種輸入可以混合使用。工具會在瀏覽器本機把路徑清單建構成巢狀樹，目錄節點自動前置並依字母排序，再以標準的 ├── 與 └── 樹符號逐層縮排渲染，目錄節點以青色高亮，檔案節點保持普通顏色，右側預覽窗同步顯示檔案數與目錄數統計。確認無誤後，您可以一鍵複製樹文字貼入 Markdown 文件，或下載為 .txt 儲存。由於工具只讀取路徑中繼資料，完全不讀取檔案內容，即便專案中含有敏感原始碼也可放心使用。所有處理皆在本機完成，資料夾不會上傳任何伺服器。介面支援簡體中文、繁體中文與英文三語，自動跟隨網站主題色，電腦與手機皆可順暢使用。

✨ 功能特點

• 兩種輸入：直接選擇整個資料夾遞迴讀取，或手動貼上路徑清單
• 標準樹符號：使用 ├── └── 逐層縮排，目錄節點青色高亮
• 智慧排序：目錄自動排在檔案之前，同層依字母順序排列
• 混合輸入：資料夾選擇與文字框路徑可同時使用、自動合併
• 即時統計：預覽窗頂部顯示檔案數與目錄數
• 本機隱私：只讀取路徑中繼資料，不開啟檔案內容，零上傳

📝 使用方式

1. 點擊虛線框選擇整個專案資料夾，或在文字框每列貼上一條路徑
2. 工具自動產生樹狀文字，目錄前置、字母排序
3. 查看右側預覽窗，確認檔案數與目錄數統計
4. 點擊「複製樹文字」貼入 README 或文件，或下載 .txt 儲存
5. 點擊「清空」可開始下一次目錄整理

⚠️ 注意事項

• 路徑來源：資料夾模式讀取 webkitRelativePath，文字模式需自行保證路徑規範
• 分隔符相容：貼上路徑同時相容正斜線與反斜線
• 空路徑跳過：空列與純空白列自動忽略，不影響樹結構
• 節點著色：青色列表示包含子節點的目錄，普通列表示葉子檔案
• 大目錄限制：數萬個檔案的超大目錄建議分批貼上，避免瀏覽器卡頓