Skip to content

weikunfan/LearnFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LearnFlow 🌊

你的“稍后读”,不该是知识的坟墓。

📸 应用预览

主界面

菜单栏

📖 故事与初衷:为什么我们需要 LearnFlow?

我们都曾有过这样的经历:在少数派、知乎、Medium、微信公众号或是 Twitter 上看到一篇极具价值的文章、一个硬核的技术教程,或者是深度的行业分析。 我们怀着“这太有用了,我晚点一定要仔细看”的心情,按下了收藏添加到书签,或者丢进了某个**“稍后读(Read It Later)”**应用里。

然后呢?

然后,就没有然后了。那篇文章静静地躺在列表的深处,积满了灰尘。我们的收藏夹变成了一个个“数字仓鼠”的囤积仓库,而不是知识的炼金炉。我们总是高估了自己的自律,低估了信息的洪流。“稍后读”最终变成了“永远不读”。

LearnFlow 诞生的初衷,就是为了打破这个僵局。

它不是一个简单的书签管理器,也不是一个庞大臃肿的个人知识库(PKM)。LearnFlow 的核心理念只有一个:把“被动收藏”转化为“主动执行的学习任务”。

我们将每一条你认为有价值的 URL 视为一个任务(Task)。既然是任务,它就应该有优先级,有截止时间,并且需要在你快要忘记的时候,给予你恰到好处的提醒。LearnFlow 通过建立一个从“快速捕获 -> 任务排程 -> 准时提醒 -> 沉浸阅读 -> 标记完成”的无缝闭环,逼迫你去消化那些你真正认为有价值的内容。

不为收藏而焦虑,只为完成而专注。

✨ 核心特性

  • ⚡️ 极速捕获,拒绝繁琐:通过菜单栏常驻入口,几秒内即可将网页链接转化为一条待办学习任务。
  • 📅 任务化驱动:为每篇文章设置「优先级」与「截止时间」。它不再是静止的链接,而是倒计时的待办事项。
  • 🔔 智能本地提醒:基于你设置的时间表,通过 macOS 本地通知准时将你拉回阅读状态,治愈你的拖延症。
  • 📖 纯粹的沉浸式阅读:自动抓取并提取网页正文,剥离广告与冗杂元素,在本地提供干净、专注的阅读体验,并自动记录你的阅读进度。
  • 🔒 绝对的数据主权(Local First):没有强制的云端同步,没有账号登录,更没有隐私追踪。你的所有数据均保存在本地 SQLite 数据库中。
  • 📦 随时带走你的知识:支持将你的学习记录一键导出为 Markdown、JSON 或 CSV 格式。你的数据,永远属于你。

🛠️ 技术栈

本项目基于跨平台桌面应用开发框架构建,兼顾高性能与现代化的 UI 体验:

  • 核心框架Tauri v2 (打造轻量级、安全的本地桌面应用)
  • 后端引擎Rust (负责高性能的本地 SQLite 存储、网络页面抓取、本地通知与系统调度)
  • 前端界面React + TypeScript + Vite (构建现代、流畅且拟物化微质感的 macOS 原生级体验)
  • 状态管理:Zustand

🚀 核心工作流 (The Flow)

  1. Unread (未读):添加链接,设定优先级与截止日期,系统自动抓取正文并在后台排期。
  2. Reading (阅读中):收到本地提醒通知,点击进入沉浸阅读模式,随手记录进度。
  3. Done (已完成):阅读完毕,点击完成(✅),取消所有后续提醒,获得完成任务的成就感。
  4. Archived (归档):定期导出数据并归档,将转化为自身知识库的一部分。

⬇️ 下载安装 (Download & Install)

如果你只是想使用 LearnFlow,而不想配置开发环境,可以直接前往 Releases 页面下载最新的安装包。

💡 本地开发指南

前置依赖

确保你的系统已安装:

启动项目

  1. 克隆仓库:

    git clone https://github.com/yourusername/LearnFlow.git
    cd LearnFlow
  2. 安装前端依赖:

    cd frontend
    pnpm install
  3. 启动开发环境: 在项目根目录下,使用 Tauri CLI 启动前端与 Rust 后端:

    pnpm tauri dev

⚠️ 关于本项目 (About This Project)

LearnFlow 目前主要是为了方便个人日常使用而开发的自用小工具。 注意:本项目的核心抓取与解析能力高度依赖于一些第三方付费 API(目前使用了我个人已有的 API Key)。因此,如果你想在本地完全运行它,可能需要自行配置相关的 API 服务。

📜 许可协议

本项目尚未确定最终开源协议,目前仅供学习与本地 MVP 开发使用。

🐛 现有问题与特性 (Known Issues & Status)

  • 微信公众号文章抓取不稳定:抓取微信公众号文章内容时,时而成功时而失败(受限于微信公众号的反爬机制与动态加载)。
  • 已支持 X (Twitter):目前已成功支持读取并解析 X (Twitter) 推文的内容。

“Stop collecting, start learning.”

About

LearnFlow 是一款注重隐私的 macOS本地学习任务管理工具。它致力于解决“稍后读等于不读”的痛点,将你随手收藏的文章和网页转化为可执行的学习任务。通过自动抓取正文、完全本地的 SQLite存储、优先级调度和原生通知提醒,LearnFlow 帮助你建立“从收藏到读完”的真实闭环,无需云端同步,也没有账号负担。

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors