Android 适配版包含 Portable 同源的 QQ / 网易云登录音乐服务、全面屏布局和本地保存，安装与构建见 Android 说明。手机版本仍待真实账号和真机验收；支持范围也在其中列出。
- 原版继续保留，Beta 主动体验 —— 默认仍是熟悉的唱片架，顶部直接打开专辑墙。点击 Beta 并重启可进入新小屋，也能随时切回。Beta 的听歌、工作与生活角各有全屏近景，手机可滑动换区。
- 唱片库与唱机 —— 搜专辑、贴 QQ 音乐链接或手填；封面上的播放按钮直接继续音乐。曲库、队列、歌词和笔记在小屋内打开，切角落不打断播放。
- 智能唱片机 —— 说一句「学习 50 分钟，帮我搭配音乐」，AI 排一整张歌单；可以只收进唱片架，也可以收下并直接开始这一轮。
- 专注与学习 —— 四档番茄节奏、待办、连续天数、7 天趋势、一年热力图；15 本词书用 FSRS 复习，还能加自己的考试倒计时。
- 八个房间 —— 像素、琥珀、月夜、林间、海边、星光、雨夜列车和温室；各有听歌、工作、休息预设，可吸附布置、撤销、另存与恢复。天气可请求系统大致位置，也可搜索城市。
- 五位伙伴 —— 24 类实际绘制动作；选择和配饰同步到首页、独立桌宠和支持的系统表面。macOS 有彩色菜单栏小宠物，点击可控制音乐和专注。
- 自己的设备与场景 —— 配对后遥控音乐、查看歌词、接力专注；保存场景、睡前淡出、导出小屋明信片。备份 v5 包含布局与导入宠物素材。
- 奶糖 —— 桌面版在别的窗口打字或点鼠标时，它会落爪回应；只统计次数，不读按键内容。
- 小屋日记 —— 随手记、手记和小屋来信都存在本机；近 7 天、时段分布、一年热力图和周报都能导出成图片。
 专注 · 待办 · 统计 · 学习 · 声音 · 随手记 |
 小屋日记 · 近 7 天 · 一年热力图 · 时段分布 |
 智能唱片机 · 按计划编排一张完整歌单 |
 Beta 全屏工作角 · 专注 · 任务 · 随手记 |
从顶部「Beta」或「设置 → 小屋 Beta」主动开启，重启后生效。新小屋顶部同样保留专辑墙。
像素小屋 · 琥珀小屋 · 月夜书桌 · 林间书屋 · 海边慢屋 · 星夜阁楼
桌面版在「设置 › 键鼠陪伴」打开跨应用陪伴后，即使心流小屋在后台，你打字时它也会轮流落爪，点击鼠标时它会伸手回应。完成专注赚到的小鱼干可以换配饰。
只处理事件类型与时间戳，不保存按键、鼠标按钮、坐标、应用名或窗口标题。几天不开门，奶糖不会生病也不会离开，等级更不会掉；只是心情会慢慢降到「无精打采」停在那里，等你回来。
macOS 首次使用只需授予「输入监控」。普通字母和数字已在真实 Mac 上验证过；中文输入法组合还没有在真机上验收。版本更新后引导会复核一次，已授权时不会重复弹窗。
当前版本 v3.0.0，逐版本改动见发布说明。
| 平台 | 安装包 |
|---|---|
| macOS | Apple Silicon · Intel（DMG 或 ZIP） |
| Windows | x64 安装版 · x64 便携版 |
没有你的系统，或暂时不想安装？先用网页版。完整的文件名与大小见下载指南。
不确定挑哪个文件，照安装说明里的文件名对一下就行。目前没有 Windows ARM64 原生包，也没有 Linux 安装包。
这四条会直接影响你能不能顺畅用下去，所以放在下载后面。
- 安装包没有完成商业签名与公证。 macOS 用的是稳定的自签名发布身份，不是 Apple Developer ID；Windows 没有可信发布者签名。第一次打开被系统拦下时，先核对下载来源，别为了装上它去关掉系统安全保护。
- QQ 音乐 / 网易云走的是非官方接口。 基于 Simple Music 模块，不宣称官方合作授权；能不能播、能不能听全，取决于你的账号、版权、会员和地区。
- macOS 的系统集成需要一次授权。 用「系统 Apple Music」或「系统正在播放」会弹一次「自动化」授权；跨应用键鼠陪伴只需要「输入监控」。没有这些授权，收藏、普通专注和屋里的键鼠回应照常可用。
- 网页版功能少于桌面版。 网页版的收藏使用浏览器本地存储，支持手动填写和备份导入；曲库搜索、QQ / 网易云登录需要桌面版，没有 Music Assistant、桌宠、动态桌面、自动更新和本机 Codex CLI；它只在小屋窗口内响应键鼠。
更完整也更严格的功能与验证状态见使用边界——那份文档区分「已实现」「自动化已验证」和「真实设备已验证」，里面写着的未验收项就是未验收项。
下载入口的 latest 指向最近公开的正式 Release；每个 Release 只展示该版本的变化，全部历史见发布说明。桌面版的更新检查和手动安装路径见第一次使用。更新前建议导出一份本机备份。
- 被系统拦住了怎么办？ 核对官方来源，按下载指南处理系统提示；不需要关闭系统安全保护。
- 网页版和桌面版差在哪里？ 网页版适合先体验房间、收藏、专注与手记；平台登录、桌宠和系统集成请使用桌面版，详见使用边界。
- 唱片转了，为什么没有声音？ 默认的「仅展示」不播放音频。到「设置 › 音源」选择实际音源；平台版权、账号与地区也会影响可播范围。
只想用软件，下载安装包就够了，不用装 Node。想改代码或自己跑起来，需要 Node.js 24.x。
git clone https://github.com/ooooooomygosh/Flow-Cabin.git
cd Flow-Cabin
npm ci # 根项目依赖
npm --prefix desktop ci # 桌面端依赖
npm run desktop:dev # 启动完整 Electron 客户端
npm run dev # 只启动浏览器渲染层（Vite）提交前跑 npm run check（= npm test + npm run build）。更多命令见 desktop/README.md。
React 19 · Vite 8 · Electron 44 · Tone.js · Web Audio · FSRS · node:test · Playwright
第一次使用 · 使用边界 · 架构说明 · 播放器与音源 · 美术规范 · 入口与模式 · 桌面开发
欢迎提交 Issue、修复 Bug 或补充真实设备验证。开始前请读贡献指南。
Copyright © 2026 心流小屋 · Flow Cabin contributors。
本项目以 GPL-3.0-only 提供，许可证全文见 LICENSE。桌面发行包组合了 GPL-3.0-only 的 Simple Music 模块，来源与许可见 SOURCE.txt 与 其许可证。完整的许可与依赖边界见许可与依赖。
专辑封面版权归各唱片公司 / 艺术家所有，仅用于界面展示，不包含在项目许可范围内。
灵感来自 Bongo Cat 的跨应用键鼠陪伴思路，以及 Chill Pulse、lofi-engine 等作品；角色与场景美术均为本项目原创。感谢 Tone.js、Simple Music、Music Assistant 与像素字体 Fusion Pixel。