Lumina Note – 支持 Agent 自动化的 Markdown 笔记应用

Lumina Note 是一款面向个人知识管理的开源笔记应用，主打“本地优先、隐私安全、AI 辅助”三大核心理念。它以 Markdown 为内容载体，结合本地数据库与可选的 AI 能力（如本地大模型或 API 接入），帮助用户构建结构化、可检索、可联动的个人知识库——即所谓“第二大脑”。适用于写日记、记读书笔记、管理项目文档，或者是搭建个人维基系统。

需求分析

学术研究：整理文献、建立理论框架、追踪研究进展；个人成长：记录反思日记、制定目标、复盘习惯；创作写作：管理素材库、构思大纲、草稿迭代；项目管理：拆解任务、跟踪进度、沉淀经验；技术笔记：保存代码片段、配置说明、故障排查记录。

J.Cling 推荐拓展：

主要功能特点

1. 本地优先，数据完全掌控

所有笔记、附件、配置均默认存储在用户本地设备（支持 Windows、macOS、Linux），不强制联网、不上传云端、无需账号注册。即使离线，也能完整使用全部功能。这种“本地优先”架构确保用户对数据拥有绝对控制权，避免隐私泄露或服务停摆带来的风险。

2. 原生 Markdown 支持，兼顾效率与兼容性

采用标准 Markdown 语法编写内容，支持实时预览、代码高亮、数学公式（LaTeX）、任务列表等常用扩展。笔记以纯文本格式保存，可被任意编辑器打开，避免厂商锁定。同时，应用提供所见即所得的编辑体验，降低 Markdown 学习门槛。

3. AI 驱动，但由你掌控

Lumina Note 集成可选的 AI 功能，包括：

智能摘要：自动生成笔记要点；
问答式检索：用自然语言提问，快速定位相关内容；
写作辅助：续写、润色、扩写建议；
Agent 自动化：基于规则或触发条件，自动创建笔记、归类标签、提取网页内容等。

关键在于：AI 模块完全可选。用户可连接本地开源模型（如 Ollama）、私有 API，或完全关闭 AI 功能，确保自主权与安全性。

4. 双向链接与知识图谱

支持通过 [[笔记标题]] 创建双向链接，自动构建笔记间的关联网络。应用可生成可视化知识图谱，直观展示概念之间的联系，帮助用户发现隐藏的知识脉络，特别适合构建主题式知识体系或项目复盘。

5. 强大的全文搜索与过滤

内置高性能本地搜索引擎，支持关键词、标签、文件夹、创建/修改时间等多维度筛选。配合 AI 语义检索（启用时），即使表述不同，也能找到相关笔记，大幅提升信息召回率。

6. 模块化组织：笔记本 + 标签 + 属性

笔记本（Notebooks）：用于大类划分（如“工作”“学习”“生活”）；
标签（Tags）：跨笔记本打标，实现灵活分类；
自定义属性（Properties）：为笔记添加状态（如“进行中/已完成”）、优先级、截止日期等元数据，支持后续筛选与自动化。

7. 插件与自动化（Agent）系统

Lumina Note 内置轻量级 Agent 自动化引擎，用户可配置规则，例如：

当笔记包含“#待办”标签时，自动加入今日任务视图；
监听剪贴板中的网页链接，自动生成带摘要的笔记；
定期归档超过30天的临时笔记。

这些自动化流程减少重复操作，让知识管理更智能。

8. 跨平台与同步方案

基于 Flutter 构建，支持桌面全平台。虽然默认本地存储，但用户可通过第三方工具（如 Syncthing、Git、网盘）实现多设备同步，保持灵活性与开放性。

9. 开源透明，社区驱动

项目代码完全开源（GitHub 托管），采用 MIT 许可证，允许自由使用、审计与二次开发。开发者积极维护，文档齐全，鼓励用户参与共建。

官方使用说明

🕸️ 知识图谱

基于 Canvas 的高性能可视化引擎，直观展示笔记间的关联关系。

功能	描述
文件夹层级	文件夹作为节点显示（带刺圆球样式），父子关系带箭头连线
颜色分区	按文件夹自动分配颜色，子节点继承父文件夹颜色
双向链接	`[[WikiLinks]]` 自动解析为节点间的连线
右键孤立查看	右键点击任意节点，可在新标签页中查看该节点及其直接关联的节点
物理引擎	可调节的斥力、弹力、向心力参数，支持拖拽节点和画布缩放

🤖 AI Agent 系统

模块	功能描述
Agent 模式	能够理解意图，自动执行读取、编辑、搜索笔记等复杂任务链。
AI 悬浮球	随时唤起的助手，支持拖拽，不打断当前心流。
语音输入	基于 Web Speech API 的语音转文字，支持流式显示、自动停止、录音动画。
Diff 预览	AI 修改内容前提供 Diff 对比视图，由你决定是否 Apply。
RAG 语义搜索	内置 SQLite 向量库，基于语义理解检索你的本地知识库。

🎬 B 站视频笔记

边看视频边做笔记，通过弹幕同步实现精确时间戳记录。

功能	描述
内嵌播放	在应用内直接播放 B 站视频，支持登录和发弹幕
弹幕同步	发送带前缀的弹幕（如 `#笔记内容`），一键同步为带时间戳的笔记
时间跳转	点击笔记时间戳，视频自动跳转到对应位置（无需刷新）
自动保存	笔记自动保存为 Markdown 文件，下次打开同一视频自动加载

📄 PDF 智能阅读器

为学术工作流优化的 PDF 阅读和标注系统。

功能	描述
交互式元素识别	自动识别文本、图片、表格等元素，支持悬浮高亮和点击选中
PDF 批注系统	选中文本添加高亮/下划线，支持 5 种颜色和笔记
批注笔记同步	批注自动保存为 Markdown 文件，与 PDF 同目录
双向跳转	点击笔记中的链接跳转到 PDF 对应位置，Ctrl+Click 分栏打开
缩略图与目录	侧边栏显示页面缩略图和文档大纲，快速跳转
全文搜索	支持在 PDF 中搜索关键词，实时高亮匹配结果
与 AI 对话	将选中的 PDF 内容发送给 AI，进行摘要、翻译或解释

🎨 主题系统

功能	描述
15 套官方主题	默认/海洋/森林/薰衣草/玫瑰/落日/薄荷/靛青/拿铁/极光/极简等
明暗双模式	每套主题都有明亮和暗黑两种模式（共 30 种外观）
Markdown 颜色	主题影响标题/链接/代码块/引用等 17 种元素
设置面板	左下角齿轮图标，统一管理主题、AI、RAG 等设置