Minma | 念记

AI-powered bookmark navigator. Let your messy stars make sense again. AI 驱动的书签导航工具，让繁杂的收藏回归秩序。

🌐 立即访问 (Live Demo)

---

💡 关于 Minma (About)

Minma 是一款极简的书签管理工具，通过 AI 技术将原本杂乱无章的网址自动转化为结构化的知识库。

• 智能分类：基于 GPT-4o 自动识别网址内容并归纳至对应领域。
• 自动摘要：AI 为你提取网页核心价值，30字内看清网页干货。
• 多维标签：自动提取 3 个核心标签，支持跨维度搜索。
• 双模驱动：本地开发极速响应，云端部署安全无忧。

---

🚀 快速开始 (Getting Started)

1. 本地开发 (Local Development)

项目采用了 双环境兼容模式。在本地开发时，前端直接请求 API 以获得最快的调试速度。

1. 克隆项目：

   git clone https://github.com/Kev1nvip/Minma.git
   cd Minma

2. 安装依赖：

   npm install

3. 配置本地密钥： 在根目录下创建 .env.local 文件，填入你的 GitHub Model Token：

   VITE_GITHUB_MODEL_TOKEN=your_github_pat_here

4. 启动项目：

   npm run dev

2. 线上部署 (Production Deployment)

线上环境会自动切换到 Netlify Functions 代理模式，确保 API Key 永远不会暴露在浏览器端。

1. 推送代码：将代码推送到 GitHub。
2. 关联 Netlify：在 Netlify 后台关联你的仓库。
3. 设置环境变量： 在 Netlify 后台的 Site configuration -> Environment variables 中添加：
   • Key: GITHUB_MODEL_TOKEN
   • Value: 你的 GitHub PAT (令牌) 注意：线上环境变量不需要 VITE_ 前缀。

---

🛠️ 技术栈 (Tech Stack)

• 前端框架: React 19 + Vite 6
• 类型安全: TypeScript
• AI 引擎: GitHub Models (GPT-4o-mini)
• 样式处理: Tailwind CSS 4.0
• 后端支持: Netlify Functions (Serverless)

---

⚙️ 架构说明 (Architecture)

本项目采用 双模式 AI 调用机制：

• 开发模式 (Development)：当检测到运行在 localhost 时，前端通过 OpenAI SDK 直接与 API 通讯。
• 生产模式 (Production)：当部署在 Netlify 后，前端会请求 /.netlify/functions/analyze。由部署在云端的 Serverless 函数携带 Token 完成 API 请求，彻底杜绝 Token 泄露风险。

---

Made with ❤️ by seekers of efficiency.