README.zh-CN.md

Lumina Note

本地优先的 AI 笔记应用

你的笔记默认保留在设备本地。Lumina Note 用 AI 帮你写作、连接、检索和整理知识，同时把数据控制权留在你手里。

语言： English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Italiano · Português (Brasil) · Русский

---

为什么选择 Lumina Note

• 本地优先：你的笔记库保留在本地，是否发送给模型服务商由你决定。
• 围绕知识工作流设计：Markdown 编辑、双链、图谱和 AI agent 是一个整体。
• AI 不只是聊天：Agent 支持真实编辑、规划与自动化任务。

---

下载

前往 Releases 获取最新版：

平台	安装包
Windows	.msi / .exe
macOS (Intel)	x64.dmg
macOS (Apple Silicon)	aarch64.dmg

---

界面预览

---

功能概览

AI 工作区

• Agent 模式：支持编辑、规划与任务自动化
• 支持多模型服务商：OpenAI / Anthropic (Claude) / DeepSeek / Gemini / Moonshot / Groq / OpenRouter / Ollama
• 主模型可自由配置
• 复杂任务会进入编排式 Agent 运行时，简单任务保持轻量快速路径

编辑器与知识图谱

• Markdown 源码 / 实时预览 / 阅读模式
• [[WikiLinks]] 双向链接
• LaTeX、Mermaid、代码高亮
• 图谱可视化笔记之间的关系

阅读与采集

• 内置 PDF 阅读器，支持高亮、下划线和批注
• 批注结果可保存为 Markdown
• 选中内容可直接发送到 AI 上下文

扩展能力

• 实时语音输入
• WebDAV 同步
• 闪卡复习
• 15 套主题

插件生态（开发者预览）

• 从 workspace / user / built-in 目录加载插件
• 插件能力的运行时权限模型
• Slash Command 扩展 API
• 开发文档：docs/plugin-ecosystem.md

可选：Lumina Cloud（付费）

如果你不想自己配置 API key，Lumina Cloud 是基于许可证的可选服务。一次性买断或月度订阅可解锁 AI 设置中的 "Lumina Cloud" provider，模型一致，推理由 Lumina 承担。Lumina Note 默认仍然是 local-first，只有持有许可证时云端功能才会启用。详情见 lumina-note.com。

---

快速开始

1. 从 Releases 安装 Lumina Note。
2. 首次启动时选择一个本地文件夹作为笔记库。
3. 在 AI 面板中配置模型服务商和 API Key，并可在设置中选择偏好模型。
4. 创建第一条笔记，并通过 [[WikiLinks]] 建立连接。

---

使用指南

推荐先读

• English: docs/user-flow.md
• 简体中文：docs/user-flow.zh-CN.md
• 日本語: docs/user-flow.ja.md

自部署中继（跨网络手机访问）

• English: docs/self-host.md
• 简体中文：docs/self-host.zh-CN.md

---

从源码构建

环境要求：

• Node.js 20+（推荐 20.11.1）

git clone https://github.com/blueberrycongee/Lumina-Note.git
cd Lumina-Note
npm install
npm run dev

---

技术栈

• 框架：Electron 41（Chromium + Node.js）
• 前端：React 18、TypeScript、Tailwind CSS
• 编辑器：CodeMirror 6
• 状态管理：Zustand

---

开源组件

• 编辑器核心：codemirror-live-markdown

---

贡献者

---

许可证

Apache License 2.0

---

Star History