Familiar

开源、本地优先的 macOS 菜单栏应用，自动捕获屏幕上下文（截图 OCR、剪贴板镜像），让 AI 工具持续获得用户工作环境的完整记忆。

项目概述#

Familiar 是一款 macOS 桌面应用（菜单栏应用），通过定时截图和 Apple Vision OCR 自动捕获屏幕内容，同时镜像剪贴板内容，实现完全本地化的上下文记录。所有数据存储在用户指定文件夹，支持敏感信息过滤（使用 ripgrep 扫描密码/API密钥模式）。

核心能力#

屏幕上下文捕获#

定时截图：每隔几秒自动截取屏幕内容
Apple Vision OCR：使用 Apple 原生 OCR 将截图转换为可搜索文本
剪贴板镜像：自动保存所有经过剪贴板的内容（文本+图片）
语音转文本兼容：支持大多数第三方语音转文本工具

隐私与安全#

完全离线运行，无需网络连接，数据不上传云端
本地存储：所有数据存储在用户指定文件夹（默认 <contextFolderPath>/familiar/）
敏感信息过滤：使用 ripgrep (rg) 扫描并过滤密码/API密钥模式
菜单栏图标允许随时暂停或退出

AI 集成#

兼容多种 AI 工具：OpenClaw、Claude Cowork、Claude Code、Codex、Cursor、Antigravity 等。可自动为 AI 添加配置文件（Skill），指导其何时/如何使用捕获的上下文。通过本地文件系统暴露上下文，AI 工具读取 <contextFolderPath>/familiar/ 目录下的 Markdown 文件获取 OCR 文本。

数据管理#

截图保留控制：自动清理旧捕获数据（15分钟/1小时/1天/7天/全部时间）
手动删除：可直接访问文件删除任意上下文
存储位置：
- 设置：~/.familiar/settings.json
- 截图：<contextFolderPath>/familiar/stills/
- Markdown/OCR 输出：<contextFolderPath>/familiar/stills-markdown/

适用场景#

回忆与发现："我今天到底做了什么？时间花在哪了？"
决策支持："这周我们做了哪些没有记录在案的决策？"
关系管理："我和这个人的所有互动是什么？"
生产力分析："我的深度工作在哪发生？什么杀死了它？"
知识传递：休假/离职交接，基于屏幕历史整理接替者需要知道的内容

安装方式#

下载发布版本（推荐）#

访问 Releases 页面下载最新 .dmg 文件
arm64：Apple Silicon Macs (M1/M2/M3/M4)；x64：Intel Macs
打开安装程序，将 Familiar.app 移动到 Applications
启动并完成设置向导（需授予屏幕录制和辅助功能权限）

从源码构建#

git clone https://github.com/familiar-software/familiar.git
cd familiar/code/desktopapp
npm install
npm start  # 开发版本
npm run dist:mac  # 构建 macOS 安装包

架构概览#

基于 Electron 40.0.0 构建，使用 better-sqlite3 作为数据库，UI 采用 Tailwind CSS 4.x。OCR 依赖 Apple Vision Framework（原生 Swift/Objective-C），文本搜索/过滤使用 ripgrep (rg)。

├── src/           # 主源码（main.js 入口）
├── build/         # 构建配置（entitlements, icon）
├── scripts/       # 构建脚本（bin/rg, bin/familiar-ocr-helper）
├── test/          # 测试（unit, modelProviderTests, e2e）
└── docs/readme/   # 文档

版本信息#

当前版本：0.0.44
最低系统要求：macOS 14.0+
开发者：Tal Raviv, Maxim Vovshin（familiar-software）
项目阶段：Alpha，正在招募测试用户