Skip to content

CY1211NET/InsightFlow

Repository files navigation

InsightFlow 使用手册 📚

English Version | 中文版

欢迎使用 InsightFlow!这是一款专注于桌面端时间追踪、应用行为监控与效率提升的现代化工具。它通过全自动的隐式记录,搭配精美的悬浮窗和强大的仪表盘,帮助你掌握时间的流向,保持深度专注。


🌟 核心功能一览

功能展示1 功能展示2

1. 桌面悬浮窗 (Desktop Overlay)

悬浮窗是 InsightFlow 的视觉核心,常驻在你的桌面上,为你提供实时的时间流逝反馈:

  • 实时活动监控:自动识别并显示当前处于前台的应用程序及所分配的分类(如:编程、娱乐、生产力等)。
  • 极简番茄钟 (Pomodoro):点击悬浮窗底部的 🍅(番茄)图标,即可展开番茄钟面板。内置 25分钟专注 / 5分钟休息 的循环节奏,帮助你劳逸结合。
  • 自定义外观:提供日间/夜间模式切换,点击“设置”图标还可以自由调节悬浮窗透明度 (Opacity)。
  • 鼠标点击穿透:如果悬浮窗遮挡了你的代码或设计稿,可以随时一键开启“点击穿透”模式,让它化作无形。

2. 智能分类自学习 (Smart Classifier)

系统内建了一套智能规则,自动将你使用的应用(如 VS Code, Chrome)分类为对应模块。

  • 手动纠正与学习:如果系统将某个罕见应用归类错误(比如分为了 Other),你只需在 Dashboard(仪表盘)的“活动记录”列表中找到该条记录,点击右侧的下拉菜单,选择正确的分类。
  • 自动进化:一旦纠正,InsightFlow 会自动“记住”你的选择,把该程序的关键词加入规则库中。下次你再打开它时,系统就会进行完美的自动分类。

3. 分心提醒 (Distraction Alerts)

你的“贴身效率管家”。系统底层拥有智能心跳算法:

  • 当系统检测到你连续停留在**“娱乐” (Entertainment)“社交” (Social)**分类应用超过 15 分钟 时,悬浮窗底部会优雅地弹出毛玻璃样式的提醒 Toast。
  • 提醒你:“⚠️ 已经很久没有专注了,要不要休息一下?”帮助你从信息流的无底洞中跳出。

4. 数据仪表盘 (Dashboard)

点击悬浮窗最左侧的“四宫格”图标,即可唤出强大的本地数据仪表盘:

  • 拖拽排序布局:仪表盘各个区块(活动记录、每周趋势、模块管理)的标题均可拖拽。你可以根据喜好自由排列它们的显示顺序,系统会自动保存你的布局习惯。
  • 扁平化活动记录:按照时间倒序,直观呈现你一天的应用程序切换轨迹。
  • 模块管理器:可以自定义新增分类(如“学习”、“设计”)、更换类别代表颜色,并手工管理匹配该类别的进程名关键词和网址后缀。

5. 浏览器网页追踪插件 (Browser Extension)

为了能够更精确地记录你在使用浏览器时的浏览网页时间(区分是在看文档还是刷推特),我们提供了一个 Chrome 浏览器扩展:

  • 无感记录:自动提取你当前活跃标签页的域名与网页标题,并通过本地 HTTP 通道(127.0.0.1:5678)上报给 InsightFlow 后台守护进程。
  • 配置与安装
    1. 打开 Chrome / Edge 等 Chromium 浏览器。
    2. 在地址栏输入 chrome://extensions/ 并回车。
    3. 开启页面右上角的 开发者模式 (Developer mode)
    4. 点击 加载已解压的扩展程序 (Load unpacked)
    5. 选择本项目下的 bridge/ 文件夹即可完成安装!

⌨️ 快捷键与操作技巧

操作 触发方式 说明
拖拽悬浮窗 鼠标左键按住顶部栏 点击应用名称及计时区域,可将悬浮窗拖动至屏幕任意角落。
切换点击穿透 Ctrl + Shift + I 全局快捷键。开启后,鼠标点击将直接穿过悬浮窗,不影响底层操作。(再次按下可解除)
隐藏/展开面板 点击各区域 点击各个模块、图标均可展开动画隐藏面板,保持悬浮窗最小化状态。

🛠️ 安装与运行指南 (面向开发者)

InsightFlow 基于 Rust (Tauri)Vue 3 + TypeScript 打造。所有数据通过 SQLite 完全保存在本地(%APPDATA%/InsightFlow),保护你的绝对隐私。

环境依赖

  1. 安装 Node.js (建议版本 v18+)
  2. 安装 Rust (建议最新稳定版)
  3. 确保你的 Windows 安装了对应的 C++ 生成工具 (Visual Studio Build Tools)

编译与运行

# 进入项目前端目录
cd InsightFlow/insight-app

# 安装依赖
npm install

# 以开发模式运行 (带有热更新)
npm run tauri dev

# 编译打包生产版本 (.msi / .exe)
npm run tauri build

(注意:在多线程开发或首次运行时,底层 SQLite 文件采用 WAL 并发模式。如果由于异常中断导致进程锁死,请任务管理器结束进程后重启即可。)


About

Welcome to **InsightFlow**! This is a modern, desktop-based time tracking and efficiency monitoring tool designed to help you understand your workflow and maintain deep focus. Through automatic background tracking, an elegant desktop overlay, and a powerful dashboard, InsightFlow puts you in control of your time.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors