一款專為開發者、創作者與數位游牧民打造的極致霓虹科技風 —— 本機磁碟資產導覽、Wiki 知識庫與履歷中控台。
DiskMap Portfolio 是一款低複雜度、零外部資料庫依賴的本機磁碟資產導覽系統。它能將你散落在本機多個硬碟(或遠端 NAS 網路磁碟槽)中的冷存影片、照片、開發專案、Obsidian 知識庫以及 Office/PDF 重要個人文件,以極具未來科技感的霓虹磨砂玻璃 UI 進行美觀的網頁可視化呈現。
更強大的是,它整合了 OS-Aware (系統感知) 本機開啟與定位技術,讓你在網頁中點選檔案時,能直接喚醒系統預設的檔案總管(並完美相容第三方檔案總管如 Files App),實現一鍵點選、原生開啟的順暢體驗!
- 採用現代 HSL 微發光色彩系統與暗色背景,搭配精緻的磨砂玻璃 (Glassmorphism) 卡片設計。
- 備置了智慧流光進度條 (Progress Shimmer Bar),在發起深度搜尋時提供彈射起步、隨機減速逼近、秒速滿格淡出的流暢微交互反饋。
- 無需繁瑣的全域地圖文檔維護!
- 當瀏覽目錄時,後端會自動探測子目錄內部是否含有
README.md。若有,會智慧過濾噪音並自動抓取第一行大標題(例如# 🎨 ComfyUI 圖像生成工作流),以📖 說明書標題形式呈現在卡片下方。 - 引導你在日常開發中保持撰寫簡短 README 的優良工程習慣。
- 支援對 Word (
.docx/.odt/.rtf)、Excel (.xlsx/.ods)、PPT (.pptx/.odp)、PDF 以及代碼/純文字檔案的深層非同步全文內文檢索。 - 整合了 1500 slots LRU Memory Cache,將二進位文件解析結果存於記憶體,二次搜尋耗時由數秒直接縮短至 30-50ms(效能提升百倍)。
- 支援 EventSource (SSE) 增量即時推送,大目錄全面穿透檢索時隨搜隨現。
- Windows:調用
start(開啟) 或是explorer.exe /select(定位高亮)。 - macOS:完美適配 macOS 對等命令
open -R(Reveal in Finder)!這會在 Finder 中開啟父目錄並高亮選取檔案;一般開啟則調用open。 - Linux:使用標準的
xdg-open連接。 - 第三方檔案總管相容:當使用者將 Files App (Files.stable.app) 設為預設時,系統能自動以
open-parent智慧代理開啟父目錄,100% 避免拉起微軟舊版 Explorer 的割裂感。
- 配置了 Vercel
pkg打包指令,將後端 Node.js 環境、服務代碼與前端網頁全數編譯為一個單一的.exe可執行檔(約 93MB)。 - 使用者完全不用安裝 Node.js! 雙擊即可在背景啟動服務,無比輕量且便於發布。
- 前往 GitHub Releases 頁面。
- 下載編譯好的
diskmap-portfolio.exe檔案。 - 將其移入你想要管理的 Workspace 目錄中,雙擊執行。
- 打開瀏覽器訪問
http://localhost:3000即可!
- 克隆此專案:
git clone https://github.com/your-username/diskmap-portfolio.git cd diskmap-portfolio - 安裝依賴:
npm install
- 啟動伺服器:
npm start
- 造訪
http://localhost:3000。
- Core: Node.js + Express (後端), Vanilla HTML5 + JavaScript ES6 (前端).
- Styling: Vanilla CSS (CSS Variables, Neon Border Glows, RWD 響應式佈局).
- SSE Streaming: Server-Sent Events (用於全文搜尋結果增量動態推送).
- Caching: Least Recently Used (LRU) In-Memory Cache (用於 Office/PDF 純文字提取結果快取).
- Compression: GZIP Middleware (用於 API 回傳壓縮,體積減省 60-80%).
- Packaging: Vercel
pkg(單一可執行檔編譯).
本專案採用 ISC 協議開源。歡迎隨時 Fork、提交 Pull Request 或開 Issue 討論!
Made with 🌌 and 🚀 by Jun.
