FoldMind — 個人知識作業系統

把散落各處的資訊，匯聚成可搜、可問、可自動化的知識庫

🏗️ 三專案架構

FoldLM（Chrome 擴充，採集端）
   │
   ├──(REST API)──▶ FoldMindHub（知識中樞，大腦）
   │                     ▲
   │                     │
   └─────────────── FoldSwarm（AI 開發團隊，獨立專案，規劃中）

專案	定位	技術	狀態
FoldLM	Chrome 擴充（採集端）	Manifest V3、Content Script	✅ v1.3.0
FoldMindHub	知識中樞 Web App	Next.js 16、PostgreSQL、pgvector	✅ Phase 1-4
FoldSwarm	AI 多 Agent 自動化開發	待定（LangGraph / CrewAI）	📋 Phase 5 規劃

📁 專案結構

foldLM-main NoteBookLm/
├── extension/              Chrome 擴充（NotebookLM / ChatGPT / Gemini 整合）
│   ├── manifest.json       擴充設定檔 (MV3)
│   ├── content.js          主要進入點
│   ├── background.js       Service Worker（跨域下載等）
│   ├── slide-download.js   簡報圖片一鍵下載
│   ├── ui-core.js          核心 UI 邏輯
│   ├── ui-modal.js         資料夾內容視窗
│   ├── ui-dialogs.js       對話框（設定/統計/時間軸/關聯圖）
│   ├── ui-batch.js         批次操作與智慧歸檔
│   ├── ui-mindmap.js       關聯圖視覺化
│   ├── ai-service.js       AI 服務（Gemini Nano）
│   ├── hub-sync.js         FoldMindHub 同步
│   ├── drive-sync.js       Google Drive 同步
│   ├── storage.js          chrome.storage 持久化
│   ├── keyboard.js         鍵盤快捷鍵
│   ├── drag-drop.js        拖放互動
│   ├── emoji-picker.js     Emoji 選擇器
│   ├── styles.css          樣式表
│   └── icons/              擴充圖標
│
├── foldmindhub/            知識中樞 Web App（Next.js 16）
│   ├── src/
│   │   ├── app/            App Router 頁面與 API
│   │   │   └── api/
│   │   │       ├── mcp/            MCP Server HTTP 端點
│   │   │       ├── telegram/       Telegram Bot Webhook
│   │   │       └── v1/
│   │   │           ├── notes/      筆記 CRUD
│   │   │           ├── folders/    資料夾 CRUD
│   │   │           ├── agents/     Agent 管理與觸發
│   │   │           ├── daily-digest/ 每日摘要
│   │   │           ├── usage/      用量查詢
│   │   │           └── export/     匯出（Markdown/JSON/NotebookLM）
│   │   ├── lib/            核心邏輯
│   │   │   ├── agents/     Agent 框架（crawler/github/daily-report）
│   │   │   ├── auth.ts     認證邏輯
│   │   │   ├── db.ts       Prisma Client
│   │   │   ├── api-auth.ts API Key 驗證
│   │   │   ├── events.ts   事件匯流排
│   │   │   ├── rag.ts      RAG 語義搜尋
│   │   │   ├── auto-classify.ts  AI 自動分類
│   │   │   ├── rate-limit.ts     Rate Limit
│   │   │   ├── i18n.ts     國際化（繁中/簡中/英文）
│   │   │   ├── plugins.ts  Plugin 機制
│   │   │   ├── oauth2.ts   OAuth2 Provider
│   │   │   └── org.ts      組織管理
│   │   └── config/
│   │       └── ai-models.ts AI 模型設定
│   ├── mcp-server/         MCP Server（stdio 模式）
│   │   └── index.ts        5 個工具：search/get/list/tags/create
│   ├── prisma/
│   │   └── schema.prisma   資料庫 Schema
│   └── package.json
│
├── packages/
│   └── shared/             共用型別 & API Contract
│       └── types.ts        User / Note / Folder / Plan 型別
│
└── docs/                   全域文件
    ├── RoadMap.md           產品規劃與 Phase 計畫
    ├── Architecture.md      架構文件
    ├── API.md               API 文件
    ├── CHANGELOG.md         版本異動紀錄
    ├── Env.md               環境變數說明
    ├── iOS-Shortcut.md      iOS 捷徑整合指南
    └── n8n-integration.md   n8n 自動化整合

🔗 元件互動

                    FoldMindHub API（中心節點）
                          │
      ┌─────────┬─────────┼─────────┬──────────┐
      │         │         │         │          │
  Chrome    Telegram   Crawler    MCP      iOS
  擴充       Bot       Agent    Server   Shortcut
 (FoldLM)    ✅         ✅        ✅       ✅

🚀 快速開始

Hub（FoldMindHub）

cd foldmindhub
npm install
cp .env.example .env    # 填入真實 credentials
npx prisma migrate dev
npm run dev

Chrome 擴充

1. 開啟 chrome://extensions
2. 啟用「開發人員模式」
3. 「載入未封裝項目」→ 選擇 extension/ 資料夾

📋 RoadMap

詳見 docs/RoadMap.md

Phase	內容	狀態
1	基礎建設（Auth + DB + CRUD + Chrome 整合）	✅ 完成
2	整理 + RAG + 收費機制	✅ 完成
3	MCP + Telegram + Plugin 機制	✅ 完成
4	Agent 框架（Crawler / GitHub / 每日彙報）	✅ 完成
5	多 Agent 開發系統（FoldSwarm）	📋 規劃中

💰 方案分級

方案	筆記數	RAG 問答/日	AI 模型	爬蟲
Free	100	10	GLM-Flash / Qwen-Flash	❌
Pro	10,000	200	DeepSeek / Gemini / Kimi	✅
Team	∞	∞	全部含 GPT-5.3 / Opus 4.6	✅