Screenpipe 安装指南:三步让电脑记住看过的每一块屏幕
2026/9/6 18:22:32 网站建设 项目流程

Screenpipe 安装指南:三步让电脑记住看过的每一块屏幕

【免费下载链接】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 在本地持续录制你的屏幕与音频,把它们变成一份可以搜索、能被 AI 助手随时提问的历史。数据不出你的机器,三步就能跑起来。

它解决了什么问题:三个屏幕历史救场的时刻

会议失忆。开完两小时会,细节全散。Screenpipe 全程转写系统音频并识别说话人,会后可直接生成摘要,谁说了什么都有据可查。

"我当时是怎么做的"。用自然语言搜"上周四那个报错页面",它从截图的无障碍文本、OCR 和转写结果里把对应时刻找出来,连当时的画面一起给你。

AI 助手没有上下文。通过内置的 MCP 服务,Claude、Cursor 这类编码助手可以直接问你屏幕上的内容:"我刚才在哪个仓库改东西?"——不用你手动复制粘贴背景。

三步装好:系统要求与安装命令

先对照一下硬件门槛,不达标就别硬跑:

  • 系统:macOS(Apple Silicon / Intel)或 Windows 10/11 装桌面应用;Linux 需从源码构建
  • 内存:8 GB 起步
  • 磁盘:预留每月 5-10 GB(事件驱动采集,只在画面变化时存帧)
  • CPU:日常占用约 5-10%,无需独享机器

macOS 和 Windows 用户可以直接从官网下载桌面安装包。想先用命令行验证环境,跑这两条即可:

npx screenpipe record npx screenpipe setup

第一条启动本地录制服务,第二条把 Screenpipe 作为 MCP 接入到你机器上检测到的 AI 助手。装完用状态命令确认录制、存储、端口三行都正常:

npx screenpipe status

首次运行要配什么:三个决定录制质量的开关

首次启动只需处理两件事:给系统权限(macOS 在 系统设置 → 隐私与安全性 里放行屏幕录制与麦克风;Windows 放行屏幕捕获),然后进应用内的Settings → Recording调三个开关。

  • Capture audio:录音范围。Always全天候录,During meetings only只在检测到会议时录——省盘又省电,新手建议先选后者
  • Transcription engine:转写引擎,默认 Whisper Turbo 在本地跑,速度快、数据不出机器
  • Languages:默认自动检测语种,中英混说多的环境可以手动指定

日常怎么用:问会议、倒带历史、跑自动回顾

用自然语言问昨天的会议。打开 Chat 页面,直接输入"昨天下午和客户的会,对方提了几个问题?"。Screenpipe 先检索相关转写段落,再由 AI 汇总回答,不用自己翻记录。

在时间线里倒带任意时刻。打开 Timeline 页,一天像 DVR 一样横向铺开,每个色块是一段活动(哪个 App、什么窗口)。点击"daily summary"色块,右侧就是当天要点:完成了什么、关键节点、还有什么没做完,全部存在本机。

想更进一步:用一个 Markdown 文件搭建自己的 Pipe。Pipe 是定时运行的 AI 代理,写一个带调度与提示词的pipe.md放进~/.screenpipe/pipes/就能自动跑,比如"每天下班生成 standup 更新"或"每次我打开某项目就更新任务状态"。内置的 meeting-summary、day-recap、standup-update 都是现成模板,写法细节可以看 docs/PIPE_EXECUTION_SPEC.md。

常见坑与修复:权限、存储、转写

现象:装好了,但搜索结果是空的。原因:系统的屏幕录制权限没给,采集服务拿到的是空白帧。解决:到系统隐私设置里勾选 Screenpipe 的屏幕录制权限,改完权限后必须重启应用再观察 Timeline 是否出现新内容。

现象:几周后存储涨得很快。原因:全天候录屏加转写,月增量在 5-10 GB 属正常,但把录音范围开在Always会放大占用。解决:把 Capture audio 改为仅在会议时录,或在过滤里排除浏览器扩展、密码输入等不想采的窗口;在 Settings → Storage 里查看当前占用并清理旧记录。

现象:转写串语种或断句错乱。原因:多语种环境自动检测失效,或连续短句被切碎。解决:在 Recording 里手动指定语言,并打开Batch Transcription把零散音频合并成更长的段再转写。转写引擎本身的实现在 crates/screenpipe-audio/,想深挖可以看源码。

数据与隐私说明:你的屏幕和音频存在哪

所有画面、音频和转写默认存在本机的 SQLite 数据库里(CLI 的 status 输出会直接打印路径,通常是~/.screenpipe/db.sqlite),默认不上传任何云端服务。两个容易忽略的点:

  • 应用默认开启遥测(崩溃诊断与使用统计)。介意的话到Settings → Privacy → Analytics里关闭;想完全本地化,转写保持 Whisper、AI 选 Ollama 等本地模型、不开云同步即可
  • MCP 接入的 AI 助手拿到的也是本机数据,packages/screenpipe-mcp/ 里可以看到它只通过本地端口 3030 查询,不产生额外外发

备份很简单:定期把~/.screenpipe目录整体拷走即可,截图、数据库、你的 Pipe 配置都在里面。清理则建议在 Settings → Storage 里定期查看,按时间段删除过期记录。

写在最后

先把录制跑满一天,明天用一句话搜搜昨天干了什么,感受最直接。确认数据质量没问题后,再执行npx screenpipe setup把它接进你的编码助手,让它以后替你回忆上下文。

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询