Brosis

项目简介

Brosis 是一款 macOS 本地活动记录工具，可以记录你在哪个应用、哪个窗口、看的是什么内容，整理成可查询的时间线和台账，加密存储在本地，通过 MCP 协议供 AI 助手检索。其核心理念是：数据永远不出本机，理解层不依赖大模型。时间线、时长统计、活动模式全部由确定性规则生成，无需调用任何模型；向量语义检索是可选的第二层，且模型也在本地运行。

核心功能

全场景活动记录：通过 macOS 无障碍接口（AX）读取窗口标题和可见文字，Electron 或自绘界面退回到视口 OCR。只记录当前视口内实际显示的内容，不追溯未浏览的历史。

隐私优先设计：数据默认不离开本机，无云端、无账号、无遥测。密码、验证码、令牌在写入数据库前即完成脱敏。存储上限 10 GiB（默认），超限后先提示导出，确认后才删除最旧数据。

确定性台账：把零散的观察合并成会话，生成日/周台账、时长统计、活动模式。这一层是纯规则，可复现、可解释、零模型调用。

三通道检索融合：精确字段（应用、URL、路径）+ 全文检索（SQLite FTS5，中文二元组切分）+ 可选向量语义检索，结果通过加权 RRF 融合。

本地 MCP 服务：内置 MCP 服务器，提供 search、get_evidence、get_context、get_timeline、get_day_ledger、get_week_ledger、get_patterns 等 10 个只读工具，AI 助手可通过 MCP 协议访问个人活动上下文。

向量语义检索（可选）：支持 Qwen3-Embedding 0.6B/4B/8B 三种规格，本地 mlx-swift 运行，建索引受 GPU 预算门控。

技术实现

Brosis 采用双仓库结构：core/ 是加密存储核心（SQLCipher + FTS5 + sqlite-vec 向量检索、MCP 服务、brosis-store CLI）；app/ 是菜单栏应用（AX 适配规则、OCR、模型管理、MCP 集成）。数据库用 SQLCipher 加密，密钥存在数据保护钥匙串里，屏幕锁定期间钥匙串不可读。

安装需要 macOS 26 或更新版本、Apple Silicon 芯片，从 Releases 下载 DMG 拖入应用程序即可。

快速上手

从 GitHub Releases 下载 DMG，拖入应用程序文件夹完成安装。

首次启动时按提示授予辅助功能和屏幕录制权限。

在菜单栏图标下选择要采集的应用（不采集/只记事件/事件+内容三档），确认后即开始记录。

若使用向量检索，在模型面板下载 Qwen3-Embedding 模型。

在 AI 助手中添加 MCP 连接：claude mcp add brosis /Applications/brosis.app/Contents/MacOS/brosis-mCP。

适用人群

需要在 AI 助手中调用个人工作上下文（当前项目、近期活动记录）的 macOS 用户，以及关注隐私安全、希望 AI 工具只能访问脱敏后本地数据而非上传云端的开发者。

官方链接

GitHub：https://github.com/AllenBall/brosis 中文文档：https://github.com/AllenBall/brosis/blob/main/README.zh-CN.md