Personal Note App 📝

這是一個結合 React + Electron + Vite 的現代化個人筆記應用程式，旨在提供流暢的文件閱讀與編輯體驗，並深度整合本地 AI 模型 (Ollama) 以實現智能輔助功能。

✨ 主要功能

1. 多格式文件支援

• 文字編輯：支援 Markdown 與純文字檔案，具備即時預覽與語法高亮。
• Office 文件檢視：
  • PDF: 內嵌完整閱讀器。
  • Word (.docx): 透過 docx-preview 進行渲染。
  • PowerPoint (.pptx): 透過 pptx-preview 進行幻燈片檢視。
  • Excel (.xlsx): 支援試算表預覽。
  • 圖片: 支援常見格式 (png/jpg/gif/webp)。

2. 本地 AI 智能助手 (RAG) 🤖

深度整合 Ollama 本地模型，實現檢索增強生成 (RAG)：

• 上下文感知：AI 能自動讀取您當前開啟的文件內容。
• 跨格式支援：支援解析純文字、Markdown、PDF、Word、Excel 及 PowerPoint 內容作為對話背景。
• 智能問答：可針對當前文件進行摘要、抓重點或回答特定問題。
• 效能優化：內建快取機制，避免重複解析大型文件。

3. 高度客製化介面 🎨

• 多樣化主題：內建 5 種精心設計的主題：
  • Default (深色預設)
  • Light (明亮模式)
  • Cyberpunk (賽博龐克風格)
  • Acrylic (毛玻璃特效)
  • Retro (復古終端機風格)
• 圖標自訂：
  • 支援全域資料夾/檔案圖標更換。
  • 支援個別資料夾的專屬圖標設定（透過右鍵選單）。

🚀 快速開始

前置需求

• Node.js (建議 v16+)
• Ollama (用於 AI 功能)

安裝與啟動

# 1. 進入專案目錄
cd "path/to/project"

# 2. 安裝依賴
npm install

# 3. 啟動開發模式 (同時啟動 React 前端與 Electron 主程序)
npm run dev

AI 設定指南

本應用程式預設連接本地 Ollama 服務。

1. 安裝並啟動 Ollama：ollama serve
2. 下載推薦模型：ollama run llama3.1 (或其他模型)
3. 確保服務運行於 http://localhost:11434

若需自訂設定，可修改環境變數：

變數	預設值	用途
OLLAMA_URL	http://localhost:11434	Ollama API 位置
OLLAMA_MODEL	llama3.1	使用的模型名稱

🛠️ 開發架構

• Frontend: React 18, Vite
• Backend (Main Process): Electron, Node.js IPC
• Parsers: pdf-parse, mammoth (Word), officeparser (PPTX), xlsx
• UI Styling: CSS Variables 實現即時主題切換

📦 打包 (Build)

# 產生 Windows 執行檔
npm run pack

打包完成後，可執行程式將位於 release/personal-note-app-win32-x64/personal-note-app.exe。 您可以將整個資料夾複製到任何地方執行。

---

Created with ❤️ by Z0965 & Copilot