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你在屏幕前开会、敲代码、翻文档这些上下文散落在整天里想请 AI 帮忙只能重新解释。ScreenPipe 是开源的本地 AI 桌面监控工具它 24 小时完成本地屏幕记录并把结果索引成可搜索的本地 API让 AI 直接调取你的桌面上下文。项目定位与边界ScreenPipe 解决的是桌面记忆问题替你持续记录、帮你随时检索数据不离开本机。它不是网盘不是专用会议录音笔也不接管你的操作。维度ScreenPipeRewind / 微软 Recall部署方式本地进程一条 CLI 命令绑定系统 / 需云账号数据归属100% 本地 SQLite无需注册云存储或锁定在单一系统接入成本REST API MCP 双入口仅限该系统自带助手跑通最小闭环一条命令启动并验证macOS装好桌面应用后首次启动授予屏幕录制和辅助功能两项权限只想要记录加 API 的话终端一条命令即可npx -y screenpipelatest record curl http://localhost:3030/health/health返回 OK说明本地屏幕记录已经在跑。权限弹窗是这个平台最大的卡点系统设置 → 隐私与安全性里屏幕录制和辅助功能都要勾选且部分项需要重启应用才生效提示应用已损坏时右键打开以绕过 Gatekeeper。Linux可直接装 CLInpx -y screenpipelatest record与 macOS 一致想从源码构建先git clone https://gitcode.com/GitHub_Trending/sc/screenpipe构建步骤详见 CONTRIBUTING.md。Linux 两个常见坑OCR 依赖sudo apt install tesseract-ocr libxcb1X11 与 Wayland 需要分别授予屏幕捕获权限。Windows装 .exe 桌面安装包或直接用上面的 CLI 命令。首次以管理员身份启动内嵌页面空白时补装 WebView2 Runtime 再重启。终端执行screenpipe status看到 recording normally、帧数与存储持续增长闭环就跑通了。核心工作流演示从屏幕历史到 AI 摘要检索某一天的屏幕记录你看到什么桌面应用时间线里当天的活动按时间轴分布。 你敲什么带时间范围的/search请求。 你得到什么截图、无障碍文本和语音转录片段按命中排序返回。curl http://localhost:3030/search?qstandupstart_time2026-09-04T09:00:00Zend_time2026-09-04T18:00:00Z把录制上下文喂给 LLM 做摘要你看到什么AI 助手回答不了我刚才 5 分钟看了什么。 你敲什么一条 MCP模型上下文协议接入命令以 Claude 为例。 你得到什么助手直接查询你的本地屏幕历史回答总结今天的对话这类问题。claude mcp add screenpipe -- npx -y screenpipe-mcp一键生成当天活动摘要你看到什么时间线上的 daily summary 卡片还是空的。 你敲什么在应用里点生成每日摘要它是内置 pipe无需手写。 你得到什么当天的完成事项、关键时间点、未收尾工作全部保存在本机。扩展与二次开发扩展机制是管道pipes每个 pipe 是~/.screenpipe/pipes/{name}/pipe.md里的一个 markdown 文件prompt 加调度时间screenpipe 定时跑一个 AI 代理去查你的本地屏幕记录、写文件、调 API。内置 pipe 已覆盖会议总结、站会报告、时间统计完整格式见 管道开发指南。Pipe 商店里几十个现成社区插件可一键安装主仓库提交非常活跃跟着 issues 区就能看到新 pipe 的节奏。实战避坑现象原因处理磁盘持续增长录制数据累积在本地 SQLite正常消耗约每月 5–10GB在存储设置页配置保留期macOS 反复弹权限屏幕录制/辅助功能未授予或被重置到隐私与安全性重新勾选并重启应用启动后搜索为空帧还没完成处理和索引等 1–2 分钟再跑/health确认录制正常多显示器只录到一块显示器不在录制列表在设置 → 显示器里勾选全部MCP 查不到数据本地 API 没跑或 3030 端口被占先确认 health 返回 OK再查 MCP 客户端配置未覆盖的问题去 issues 区搜 permission、3030、pipe 等关键词仓库自带的故障排查文档按症状归档。以上都是 ScreenPipe 本地屏幕记录的高频卡点先对号入座再动应用。延伸方向官方文档入口docs 目录里有 quickstart、API 配方和 pipe 调试教程从那里开始最省时间。相关生态项目screenpipe-mcp 是独立的 MCP 服务器不装桌面应用也能把任意 MCP 客户端接上。你可以动手的小改造在~/.screenpipe/pipes/写一个自己的pipe.md让每周五生成一份本周时间分布的 markdown只在自己目录加文件不碰仓库。现在打开终端让 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
