screenpipe/screenpipe · 上手攻略

  • 仓库：screenpipe/screenpipe
  • 链接：https://github.com/screenpipe/screenpipe
  • 分类：AI 工具 · 效率工具 · MCP
  • 作者：Tom
  • 更新：2026-09-22

一、是什么

screenpipe 是一款本地优先的 24/7 屏幕与音频录制工具，核心理念是"给 AI 装上眼睛和耳朵"。它持续捕获你的屏幕内容（通过 macOS/Windows 辅助功能 API，OCR 兜底）和系统音频（Whisper 本地转录），全部存在本地 SQLite 数据库中，让 AI 助手可以随时查询你"过去 5 分钟看了什么""今天和谁开过会"。

技术栈：Tauri（Rust + TypeScript），本地 Whisper Large-V3-Turbo 语音识别，SQLite FTS5 全文搜索，REST API（localhost:3030），MCP 服务器协议。

二、解决什么问题

场景痛点： AI 助手没有记忆——每次对话都是从零开始。你想让 AI 知道你今天在哪个文件上卡住了、刚才的会议说了什么、上次处理某个 bug 改了什么。

竞品对比：

screenpipe Rewind/Limitless Microsoft Recall Granola
平台 macOS/Windows/Linux macOS/Windows 仅 Windows 仅 macOS
存储 100% 本地 云 本地（Win） 云
音频转录 ✅ 本地 Whisper ✅ ❌ ✅ 云
多显示器 ✅ 全支持 ❌ 仅活动窗口 ✅ ❌ 仅会议
开发者 API ✅ REST+SDK 有限 ❌ ❌
插件系统 ✅ Pipes（AI agent） ❌ ❌ ❌
开源 ✅ 可审计 ❌ ❌ ❌

三、快速安装

macOS（Apple Silicon & Intel）

下载原生 .dmg 安装包：https://screenpi.pe/onboarding

Windows 10/11

下载原生 .exe 安装包：https://screenpi.pe/onboarding

Linux

需要从源码构建（参考 CONTRIBUTING.md）。

通过 CLI 快速试用

# 安装最新 CLI（需要 Node.js）
npx -y screenpipe@latest --help

# 启动 screenpipe（带 MCP 服务器）
npx -y screenpipe-mcp@latest

⚠️ 注意：main branch 变动频繁、breaking changes 常见；正式环境建议用 GitHub Releases 页面找稳定版本 commit，再用对应 tag 的代码构建。生产桌面应用版本落后于 main（应用本身需要签名发布流程）。

四、核心用法

4.1 MCP 服务器连接 AI 助手

screenpipe 暴露为 MCP server，接入 Claude Desktop、Cursor、VS Code（Cline/Continue）等：

# 方法 1：npx 一键（推荐快速试用）
claude mcp add screenpipe -- npx -y screenpipe-mcp@latest

# 方法 2：手动配置 MCP（Claude Desktop 等）
# 在 MCP 配置文件添加：
# {
#   "mcpServers": {
#     "screenpipe": {
#       "command": "npx",
#       "args": ["-y", "screenpipe-mcp@latest"]
#     }
#   }
# }

连接后 AI 可以直接问："我刚才在哪个文件上改了什么？""今天开会讨论了哪些议题？"

4.2 REST API 搜索

screenpipe 默认在 localhost:3030 运行，无认证（可在 Settings 中开启 API 认证）。

# 搜索屏幕文本内容
curl "http://localhost:3030/search?q=meeting+notes&content_type=all&limit=10"

# 搜索音频转录
curl "http://localhost:3030/search?q=budget+discussion&content_type=audio&limit=10"

# 获取健康状态
curl "http://localhost:3030/health"

4.3 JavaScript/TypeScript SDK

npm install @screenpipe/js

import { pipe } from "@screenpipe/js";

const results = await pipe.queryScreenpipe({
  q: "project deadline",
  contentType: "all",
  limit: 20,
  startTime: new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString(),
});

// results 包含匹配的截图、时间戳、提取文字

4.4 Pipes（自动化 AI 工作流）

Pipes 是 screenpipe 的插件系统——用 Markdown 文件定义定时 AI agent：

# 内置 pipe 示例路径
~/.screenpipe/pipes/day-recap.md      # 今日总结
~/.screenpipe/pipes/standup-update.md # 站会汇报
~/.screenpipe/pipes/meeting-summary.md # 会议纪要
~/.screenpipe/pipes/time-breakdown.md  # 时间去向分析

每个 pipe 是带 YAML frontmatter 的 markdown 文件，支持细粒度权限控制：

---
allow-apps: ["Slack", "Notion"]      # 只允许访问这些 App
deny-apps: ["Spot*"]                  # 禁止访问 Spotify
restrict-to: ["ocr", "audio"]         # 只允许 OCR 和音频，不允许截图
time-range: "09:00-18:00"             # 只在工作时间运行
days: Mon,Tue,Wed,Thu,Fri
---

# Pipe 的系统提示词
你是一个会议纪要助手...

⚠️ 权限在三层强制执行：skill gating（AI 根本不感知被拒数据）→ agent interception（执行前拦截）→ server middleware（每 pipe 独立 token）。不是 prompt-based，是确定性 OS 级控制。

4.5 音频排除配置（macOS）

# 排除特定 App 不录制系统音频（macOS 14.4+）
# 编辑 ~/.screenpipe/audio-exclusions.json
{
  "excluded_apps": [
    { "bundle_id": "com.spotify.client", "name": "Spotify" }
  ]
}
# 文件热加载，无需重启 screenpipe

五、典型适用场景

  1. AI 编程助手记忆：Cursor/Claude Code 接入后，可以问"上次我改的那个 bug 在哪个文件？""我昨天看了什么文档？"
  2. 会议自动转录：系统音频实时转文字，随时搜索"上周谁提了 XX 方案？"
  3. 工作回顾/日报：pipe 自动生成 standup、day recap，存 Obsidian 或 Notion
  4. 时间追踪：time-breakdown pipe 分析各 App/项目使用时长，接 Toggl
  5. 跨 Session 记忆：AI 能回答"我上次处理这个需求是什么时候？改了什么？"

六、坑与注意

⚠️ 隐私与遥测

  • 默认开启 PostHog 产品分析（含安装 ID；登录后关联邮箱/主机名）
  • Sentry 接收崩溃日志（遥测开启时）
  • 纯本地模式：Settings → Privacy → Analytics 关闭；选本地 Whisper + Ollama 不走云
  • ⚠️ 即使关闭遥测，PostHog 初始化 ID 仍会生成，彻底需要 block hosts 或走防火墙

⚠️ 存储占用

  • 约 5–10 GB/月（事件驱动捕获，非连续录制；~300 MB/8h vs 连续录制的 ~2 GB）
  • 多显示器 + 高活动量 → 上限接近 10 GB
  • 建议配合 pipe 定期归档或清理旧数据

⚠️ macOS 权限要求

  • 需要"屏幕录制"和"系统音频录制"TCC 权限（System Settings → Privacy & Security）
  • 无障碍功能（Accessibility）用于提取 UI 元素树；无此权限时降级到 OCR

⚠️ 商业许可

  • 源码个人/非商业使用免费；商业使用需购买许可证
  • 签名桌面应用订阅制：Standard $25/月，Pro $50/月，Enterprise $150/月
  • 已有终身授权的用户不受影响（不再新增销售）

⚠️ OCR 精度

  • 辅助功能 API 优先（提取精确文本），无辅助功能场景（远程桌面、游戏）降级 OCR
  • OCR 精度依赖分辨率和字体，低质量截图可能检索不到

⚠️ Linux 支持

  • 仅为"Supported"级别，官方只提供源码，需要自行编译，配置比 macOS/Windows 复杂

七、与同类对比

工具 存储 开源 MCP AI 集成 团队功能
screenpipe 本地 ✅ ✅ 任意模型 ✅ 企业版
Rewind/Limitless 云 ❌ ❌ 专有 ❌
Microsoft Recall 本地（Win） ❌ ❌ 专有 ❌
Granola 云 ❌ ❌ 专有 ❌

screenpipe 的核心差异化：唯一同时做到"本地存储 + 完全可审计 + 任意 AI 模型 + MCP 协议 + Pipes 插件系统 + 团队部署"的方案。

八、一句话推荐结论

如果你希望 AI 助手真正理解"你过去在做什么"，screenpipe 是目前最完整的本地、开源、可扩展的屏幕记忆方案——尤其适合开发者用 MCP 接入 Cursor/Claude Code，或团队用 Pipes 自动化日常汇报。