Skip to content

Jnocode/diskmap-portfolio

Repository files navigation

🌌 DiskMap Portfolio — Neon-Themed Local Asset Navigator & Resume Hub

DiskMap Logo

DiskMap Portfolio UI Screenshot

一款專為開發者、創作者與數位游牧民打造的極致霓虹科技風 —— 本機磁碟資產導覽、Wiki 知識庫與履歷中控台。

Files App Compatible Platform Support pkg Packaged ISC License


🌟 專案概述

DiskMap Portfolio 是一款低複雜度、零外部資料庫依賴的本機磁碟資產導覽系統。它能將你散落在本機多個硬碟(或遠端 NAS 網路磁碟槽)中的冷存影片、照片、開發專案、Obsidian 知識庫以及 Office/PDF 重要個人文件,以極具未來科技感的霓虹磨砂玻璃 UI 進行美觀的網頁可視化呈現。

更強大的是,它整合了 OS-Aware (系統感知) 本機開啟與定位技術,讓你在網頁中點選檔案時,能直接喚醒系統預設的檔案總管(並完美相容第三方檔案總管如 Files App),實現一鍵點選、原生開啟的順暢體驗!


💎 核心特色 (Core Features)

1. 🔮 Premium Neon Aesthetics (未來霓虹美學)

  • 採用現代 HSL 微發光色彩系統與暗色背景,搭配精緻的磨砂玻璃 (Glassmorphism) 卡片設計。
  • 備置了智慧流光進度條 (Progress Shimmer Bar),在發起深度搜尋時提供彈射起步、隨機減速逼近、秒速滿格淡出的流暢微交互反饋。

2. 📖 Smart Self-Documenting (自適應 README 智慧提取)

  • 無需繁瑣的全域地圖文檔維護
  • 當瀏覽目錄時,後端會自動探測子目錄內部是否含有 README.md。若有,會智慧過濾噪音並自動抓取第一行大標題(例如 # 🎨 ComfyUI 圖像生成工作流),以 📖 說明書標題 形式呈現在卡片下方。
  • 引導你在日常開發中保持撰寫簡短 README 的優良工程習慣。

3. 🔍 High-Performance Deep Search (Office & PDF 全文穿透檢索)

  • 支援對 Word (.docx/.odt/.rtf)、Excel (.xlsx/.ods)、PPT (.pptx/.odp)、PDF 以及代碼/純文字檔案的深層非同步全文內文檢索
  • 整合了 1500 slots LRU Memory Cache,將二進位文件解析結果存於記憶體,二次搜尋耗時由數秒直接縮短至 30-50ms(效能提升百倍)。
  • 支援 EventSource (SSE) 增量即時推送,大目錄全面穿透檢索時隨搜隨現。

4. 🔀 OS-Aware Native Shell (跨平台原生開啟與定位)

  • 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 的割裂感。

5. 📦 One-Click Standalone Binary (單一可執行檔發行)

  • 配置了 Vercel pkg 打包指令,將後端 Node.js 環境、服務代碼與前端網頁全數編譯為一個單一的 .exe 可執行檔(約 93MB)。
  • 使用者完全不用安裝 Node.js! 雙擊即可在背景啟動服務,無比輕量且便於發布。

🚀 快速開始 (Quick Start)

方式 A:下載發行版運行(最簡單,推薦一般使用者)

  1. 前往 GitHub Releases 頁面。
  2. 下載編譯好的 diskmap-portfolio.exe 檔案。
  3. 將其移入你想要管理的 Workspace 目錄中,雙擊執行。
  4. 打開瀏覽器訪問 http://localhost:3000 即可!

方式 B:開發者運行

  1. 克隆此專案:
    git clone https://github.com/your-username/diskmap-portfolio.git
    cd diskmap-portfolio
  2. 安裝依賴:
    npm install
  3. 啟動伺服器:
    npm start
  4. 造訪 http://localhost:3000

🛠️ 技術架構 (Technology Stack)

  • 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 (單一可執行檔編譯).

📜 開源協議 (License)

本專案採用 ISC 協議開源。歡迎隨時 Fork、提交 Pull Request 或開 Issue 討論!


Made with 🌌 and 🚀 by Jun.

About

Local Disk Asset Navigator & Resume Console

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages