ScreenPipe 本地AI桌面监控速成教程:10分钟给电脑装上可检索的记忆
【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe
ScreenPipe 是一款 100% 本地运行的免费 AI 桌面监控工具,持续记录屏幕、语音与键鼠操作并自动索引成可搜索的 API。适合知识工作者、远程会议多、以及想给 AI 助手喂上下文的人。按本文操作,10 分钟即可搭好并查回自己的第一条历史记录。
先说痛点:你的电脑正在"失忆"
上周开会讨论的决定,现在想不起来落在哪个方案上;三天前看过的配置参数,翻遍浏览器历史也找不回来;写代码写到一半被会议打断,恢复现场要重新梳理半小时。
这些丢掉的上下文,其实都曾经出现在你的屏幕上。ScreenPipe 的思路是:与其靠记忆,不如让电脑 24 小时替你记着。
它在你本机持续录制屏幕、麦克风和键盘鼠标操作,并同步做文字识别与索引。关键的一点是:100% 数据留在你自己的机器上,不上传任何云服务。对"屏幕录制转 API"这件事,它把隐私和数据可用性同时解决了。
一行命令安装 ScreenPipe:权限与确认运行
macOS 和 Linux 用户打开终端,执行:
curl -fsSL get.screenpi.pe/cli | shWindows 用户在 PowerShell 中执行:
iwr get.screenpi.pe/cli.ps1 | iex安装完成后直接启动:
screenpipe首次运行会请求两个系统权限:屏幕录制(macOS 在"系统设置 → 隐私与安全性 → 屏幕录制")和麦克风。都点允许后,录制才真正开始。
确认它在工作:在终端里输入screenpipe status。看到recording normally,并且有 screen、audio 两行实时状态,说明录屏和录音链路都是通的。
首次运行体验:三类数据与真实资源开销
ScreenPipe 记录三类数据:
- 🖥️ 屏幕:持续截帧 + 文字识别(OCR),能认出画面里的文字而不只是图片
- 🎙️ 语音:麦克风转录,还能区分不同说话人
- ⌨️ 键鼠与切换:键盘输入、应用切换事件,构成时间线骨架
资源占用方面,官方给出的数据是:CPU 5%~10%,内存 0.5~3GB,存储约 20GB/月。建议机器有 8GB 内存,能完全跑在后台无感。
记录去哪看?桌面应用的 Timeline 里能按时间轴回看截图和语音;搜索框直接输关键词,或用自然语言问"我最近 5 分钟看了什么?",它会在本地 SQLite 数据库里检索作答。开会时更实用:会议页面会实时生成逐字稿,点"停止并总结"就产出本地纪要。
把活动数据变成 API:面向开发者的玩法
对你有用的地方在于:这些记录不是死文件,而是一个跑在本机 3030 端口的查询 API。把screenpipe接入 Claude 或 Codex 后,一句what did i see in the last 5 mins?就能拿到答案——屏幕历史从此可编程访问。
🔌pipes 插件系统(可理解成一段运行在本机的自动化脚本)只需一行命令即可脚手架:
bunx --bun @screenpipe/dev@latest pipe create三个落地场景:
- 📝 自动会议纪要:结合语音转录生成摘要,全程不离开本机
- 🤖 代码助手:让 AI 基于"你今天改过哪些代码"来回答,免去重复粘贴上下文
- 🔍 内容回溯:用一句话找回几天前看过的文档、配置或网页
想给团队共享知识的话,它的 Brain 页面可以把活动数据沉淀成 Live Views、Memories 和 Artifacts,相当于给整个团队建一块本地共享白板。
ScreenPipe 避坑指南:5 个容易踩的点
- 📊性能:5%~10% CPU 是常态,但建议至少 8GB 内存的机器;老旧笔记本先试跑一天再决定
- 💾存储:按约 20GB/月规划,磁盘建议预留 50GB 以上;用久了定期清理旧记录
- 🔒隐私:全部数据存放在本机
~/.screenpipe目录(核心是 db.sqlite),不上传云端;密码框等敏感内容默认有过滤 - 📦导出:支持 PNG、JPEG、MP4、TXT 等格式,方便离线归档
- 🛠️插件开发:pipes 用 JavaScript/TypeScript 编写,无需碰 Rust
快速上手清单
- 装:跑一遍上面的一行安装命令,授予屏幕和麦克风权限
- 启动:
screenpipe拉起录制,用screenpipe status确认 recording normally - 查:打开 Timeline 或直接问一句"我今天看过什么",第一次从自己记录里捞回答案
更多细节可查阅 README.md 和 ONBOARDING.md。
【免费下载链接】screenpipeYC (S26) | Open Computer History | Record your screen continuously locally and provide context to your agents (Claude, Codex, Openclaw, Hermes, Runner...)项目地址: https://gitcode.com/GitHub_Trending/sc/screenpipe
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考