📘 folder-tree-html 使用說明

把整個 folder-tree-html 資料夾（含裡面的 SKILL.md 與這份 README.html）複製到您自己電腦的以下路徑：

%USERPROFILE%\.claude\skills

備註：如果大家已經順利安裝好Claude code的話，立論上電腦就會有%USERPROFILE%\.claude的路徑，如果先前大家尚未請claude生成任何skill檔的話，我們需要在這個路徑新增一個skills的資料夾

放好之後，開一個新的 Claude Code 對話即可使用（Skill 清單通常在對話開始時載入，複製完若舊對話沒抓到，開新對話再試一次）。

在 Claude Code 對話中，直接用自然語言請求即可，例如：

• 「幫我做這個資料夾的結構圖」
• 「產生資料夾樹狀圖 html」
• 「/folder-tree-html」（若已明確以指令形式呼叫）

也可以指定其他資料夾，例如：「幫我對 C:\Projects\某案子 產生資料夾結構圖」。若未指定路徑，預設會以目前工作目錄為對象。

一個檔名為 資料夾結構圖_YYYYMMDD.html 的檔案，存放在被掃描的資料夾根目錄下（跟資料一起放，方便日後對照）。用瀏覽器打開即可看到：

• 完整樹狀結構，資料夾可點擊展開/收合（根目錄與第一層預設展開，其餘收合）
• 右上角「全部展開／全部收合」按鈕
• 每個資料夾旁邊顯示「N 檔案 / M 子資料夾」（僅計算直屬層級，非遞迴總數）
• 頁面上方統計總覽：總資料夾數、總檔案數、Thumbs.db 數量、.bak 備份檔數量
• Thumbs.db 與 *.bak 檔案會用紅色標籤標示為 可刪除 / 備份檔， 純供參考，不會自動刪除任何東西

• 開始整理一個雜亂資料夾前，先產生一份「整理前」快照，方便對照
• 整理完後可以再產生一份「整理後」版本，兩份 HTML 並列比較差異
• 純粹想快速瀏覽/記錄某個大型資料夾的內容分布

需要 GNU find（支援 -printf）與 GNU awk（支援 \x 十六進位跳脫）。在 Windows 上這代表要透過 Git Bash 執行；純 PowerShell 或 macOS 內建的 BSD find 需要調整指令才能相容（SKILL.md 裡有註記這點）。

如果想調整規則（例如想額外標示 .tmp、desktop.ini，或想改變預設展開層級、輸出檔名格式），可以直接請 Claude「照 folder-tree-html 這個 skill 的做法，但改成標示 xxx」，不需要自己改 SKILL.md，Claude 會依需求微調步驟。

• 目前只能在支援 GNU coreutils 的環境執行（Git Bash / WSL / Linux / macOS 需先裝 GNU find & gawk）
• 統計數字為「直屬」子項目數，不是遞迴總數
• 純靜態 HTML，沒有搜尋/篩選功能，資料夾層級非常深或檔案量極大時（例如數萬筆）開啟可能會稍慢