本地优先的个人工作进展日志工具。
A local-first personal work progress journal.
流梭 Flow Shuttle 是一款本地优先的桌面端个人工作进展日志工具。它用项目、工作项、每日记录、报告和热力图，把分散的工作过程整理成可回顾、可导出的连续记录。
很多知识工作并不是简单的待办完成。进展常常散落在聊天、文档、脑海和临时笔记里；等到写日报、周报或复盘时，才发现上下文已经断开。
流梭希望解决的是这个问题：每天轻量记录一点，把项目推进过程接成线。
- 项目与工作项管理。
- Today 每日工作页，集中记录当天推进。
- 今日记录编辑页，支持上一工作日参考和 Markdown 写作。
- 日报、周报、月报生成与 Markdown 导出。
- 项目进展时间线。
- 工作活跃度热力图。
- 内置使用指南，帮助理解项目、工作项、当前内容和今日变更摘要。
- 可选 AI 报告提炼。
- 本地 SQLite 存储，不强制登录，不主动上传工作内容。
普通用户请从 GitHub Releases 下载 Windows 安装包：
当前版本为 v0.1.4。流梭仍处于早期公开阶段，欢迎下载体验并反馈问题。
Flow Shuttle 未进行代码签名，Windows 可能出现安全提示。如果只是日常使用流梭，不需要从源码运行项目。
Flow Shuttle 使用 Electron、React、TypeScript 和 SQLite。
推荐环境：
- Node.js 20 或更新版本。
- npm 10 或更新版本。
常用命令：
npm install
npm run dev
npm run typecheck
npm run build
npm run dist:win开发辅助命令：
# 仅用于本地开发和调试，会生成测试数据。
npm run create:test-dataFlow Shuttle 默认把数据保存在本地数据目录中。应用不强制登录，也不会主动上传你的工作内容。
你可以在 Settings / 设置页面中查看当前数据目录、数据库文件和配置文件，也可以手动迁移数据目录。手动搬运不是云同步，不会自动合并两台电脑的数据。
如果启用 AI 报告提炼，报告内容会发送给你自己配置的 AI 服务。未配置 AI 时，该能力不会自动调用外部服务。
近期计划请查看 ROADMAP.md。
Flow Shuttle 使用 AGPL-3.0-only 许可证。
普通用户本地安装和使用 Flow Shuttle，不需要公开个人数据。若你修改、分发或基于修改版本提供网络服务，需要遵守 AGPL-3.0 的源代码开放要求。
Flow Shuttle is a local-first desktop journal for personal work progress. It organizes projects, work items, daily notes, reports, and heatmaps into a continuous record that can be reviewed and exported.
Knowledge work is not always a simple todo list. Progress is often scattered across chats, documents, memory, and temporary notes. When it is time to write a daily report, weekly report, or project review, the context is easy to lose.
Flow Shuttle is built to help connect each day’s work into a continuous thread.
- Project and work item management.
- Today view for daily progress recording.
- Focused daily record editor with previous-workday reference and Markdown writing.
- Daily, weekly, and monthly report generation.
- Markdown export.
- Project progress timeline.
- Work activity heatmap.
- Built-in user guide for understanding projects, work items, current content, and today’s change summary.
- Optional AI report refinement.
- Local SQLite storage with no required login or forced upload of work content.
Regular users can download the Windows installer from GitHub Releases:
The current version is v0.1.4. Flow Shuttle is still an early public release. It is local-first by default, does not require login, and does not upload your work content by itself.
Flow Shuttle is not code-signed yet, so Windows may show a security warning. If you only use Flow Shuttle day to day, you do not need to run the project from source.
Flow Shuttle uses Electron, React, TypeScript, and SQLite.
Recommended environment:
- Node.js 20 or newer.
- npm 10 or newer.
Common commands:
npm install
npm run dev
npm run typecheck
npm run build
npm run dist:winDevelopment helper:
# Development/debugging only. Generates local test data.
npm run create:test-dataFlow Shuttle stores data in a local data directory by default. The app does not require login and does not upload your work content by itself.
The current data directory, database file, and config file can be viewed from Settings. Manual data transfer is not cloud sync and does not automatically merge data from multiple computers.
If AI report refinement is enabled, report content is sent to the AI service configured by you. When AI is not configured, the feature does not call external services automatically.
See ROADMAP.md.
Flow Shuttle is licensed under AGPL-3.0-only.
End users can install and use Flow Shuttle locally without publishing personal data. If you modify, distribute, or provide a network service based on a modified version, you must follow the source availability requirements of AGPL-3.0.