一款本地优先的 Chrome 专注与休息伴侣。
感知浏览节奏，估计当前负荷，在需要的时候陪你停一下。

产品介绍 · 开发指南 · 反馈问题

Note

BrainRest 目前是面向桌面版 Chrome 的公开预览项目，暂未提供 Chrome 应用商店下载。普通用户请从 GitHub Releases 下载安装包；开发者也可以从源码构建体验。

为什么是脑栖

长时间盯着屏幕时，人往往最难察觉自己的状态变化。脑栖会结合标签页切换、键鼠与滚动节奏、页面结构等信号，在扩展本地估计认知负荷与身体疲劳，并以低、中、高三个等级呈现当下状态。

当持续工作开始变得吃力，脑栖不会再塞给你一份复杂报告。它会让桌面宠物靠近，用一条简短建议提醒你休息；你也可以随时发起一次快速休息，让注意力从屏幕中真正抽离。

你会获得什么

体验	脑栖如何帮助你
状态感知	用清晰等级展示当前估计负荷与连续浏览时长，数据不足时不会强行下结论
桌宠陪伴	桌宠会随精力状态变化，可拖动、贴边，并承载休息提醒与反馈
快速休息	根据当前负荷来源给出简短、可执行的恢复动作，也支持随时主动开始
可选 AI 分类	使用你自己的 API Key，将页面归入不同负荷类型，让建议更贴近正在做的事
数据控制	在设置页查看关键边界、移除 API Key，或一键清除扩展保存的本地数据

开始体验

从 GitHub Releases 安装（推荐给普通用户）

1. 打开项目的 GitHub Releases 页面。
2. 下载最新版本中的 brainrest-1.0.0.zip。
3. 在 Chrome 打开 chrome://extensions。
4. 开启右上角的“开发者模式”。
5. 将 brainrest-1.0.0.zip 拖入到浏览器。
6. 打开脑栖，按引导设置作息时间、AI 设置（可选）。

从源码安装（开发者）

环境要求

• 桌面版 Google Chrome
• Node.js 22 与 npm

开发构建

git clone https://github.com/MingxuanGame/BrainRest.git
cd BrainRest
npm ci
npm run build

1. 在 Chrome 打开 chrome://extensions。
2. 开启右上角的“开发者模式”。
3. 选择“加载已解压的扩展程序”。
4. 选择项目构建生成的 dist 文件夹。
5. 打开脑栖，按引导设置作息时间；AI 页面分类可以跳过，稍后再配置。

代码更新后重新运行 npm run build，再到扩展管理页点击脑栖的“重新加载”。

生产构建与发版

npm run build-prod

该命令会生成：

• dist-prod/：可直接通过 Chrome 扩展管理页安装的生产版扩展目录。
• release/brainrest-x.y.z.zip：可上传到 GitHub Releases 的分发压缩包。

生产构建使用 src/manifest.prod.ts，包含 update_url 且不包含 key，因此会隐藏调试页面、调试模式与示例模式。

隐私与数据

脑栖坚持本地优先，但“本地优先”不等于完全离线：

• 核心负荷估算在扩展本地完成，不依赖脑栖自建云端服务。
• 为计算负荷，当前预览版会在本机处理并短期保存浏览行为事件，滚动保留约 24 小时。
• AI 页面分类默认是可选能力。启用后，完整页面 URL 和由页面 HTML 转换出的 Markdown 会发送到你配置的兼容 OpenAI 接口。
• API Key 与分类缓存保存在扩展本地，可在设置页移除或一键清除。

完整的数据字段、AI 流程和当前限制请阅读产品介绍中的隐私说明。

重要边界

脑栖根据浏览行为和页面结构估计负荷，不是医学、生理或真实认知状态测量。它提供的是自我觉察与休息建议，不能替代专业诊断或治疗。

公开预览阶段的产品行为、数据结构和界面仍可能调整。建议先在可控环境中体验，并通过 GitHub Issues 告诉我们哪些提醒真正有帮助。

进一步了解

• 产品介绍：品牌主张、核心体验、适用场景、隐私披露与产品边界
• 开发指南：架构、权限、构建安装、调试方法与质量检查

许可

Copyright (c) 2026 QuinnCai, MingxuanGame, Qziky, chenjintang

MIT License，详情请见 LICENSE 文件。