ScreenPipe 完全指南：屏幕录制变 AI 记忆-迪斯科星球

ScreenPipe 完全指南：屏幕录制变 AI 记忆

【免费下载链接】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（YC S26，口号 "Open Computer History"）在本地持续录屏加录音，但它存的不是单纯的视频流，而是屏幕帧、OCR 文本、可访问性树、语音转写和按键事件，全部落在你机器上的 SQLite 里。你可以用自然语言搜索"上周那个报错长什么样"，也可以把这段历史直接喂给 Claude、Codex 等 AI 智能体当上下文。想要一台 7×24 小时开着、数据不离开本机的"电脑记忆"，它是目前少见的开源选择。

三步跑通本地环境

克隆仓库：

git clone https://gitcode.com/GitHub_Trending/sc/screenpipe cd screenpipe

这一步拿到的是整个 workspace：crates/下的 Rust 引擎、Tauri 桌面端、MCP 服务和文档，一次拉全。

装好工具链，编译并启动录制引擎。macOS 需要 Rust（rustup）、Homebrew 依赖（brew install pkg-config ffmpeg jq cmake wget git-lfs）和完整 Xcode，然后：

cargo build --release --features metal ./target/release/screenpipe

--features metal打开 Apple GPU 加速（Linux 上直接cargo build --release即可）。这一步产出并启动原生引擎，它监听 3030 端口，后面所有的搜索和智能体查询都打到这里。

构建桌面应用。在apps/screenpipe-app-tauri/下执行：

cd apps/screenpipe-app-tauri bun install bun run build:tauri:dev

前端用 Bun 而非 npm。这一步把 Next.js 界面打成 Tauri 壳，跑起来就是上面截图里那个带时间线和聊天面板的窗口。

五个模块各司其职

crates/screenpipe-screen/：屏幕帧捕获与 OCR 文本提取。改采集频率、多屏策略、或发现"屏幕上看到的字搜不到"时，先来看这里。
crates/screenpipe-audio/：麦克风与系统音频录制、语音转写和说话人分离。转写不准、会议里两个人串了声，都找它。
crates/screenpipe-db/：所有帧、转写和语义索引最终落地的本地 SQLite。要加字段、写历史查询、或担心存储膨胀时碰它。
apps/screenpipe-app-tauri/：你每天看见的桌面界面——时间线、会议笔记、聊天，Next.js + Tauri 实现。修页面交互和快捷键在这里。
packages/screenpipe-mcp/：MCP 服务，Claude、Codex 等智能体读取本地历史的桥梁。智能体"不记得"你上周干了什么，第一个该查的就是它。

关键配置速览

根目录Cargo.toml：管 Rust workspace——哪些 crate 是成员、共享依赖统一什么版本。最常改workspace.dependencies，想升级 tokio、reqwest 这类底层库，在这里改一处全局生效。
apps/screenpipe-app-tauri/package.json：管前端脚本和 JS 依赖。最常看scripts字段：dev:web是纯浏览器 UI 开发循环，dev:tauri是完整原生循环，各管各的。
apps/screenpipe-app-tauri/src-tauri/tauri.conf.json及各平台变体（tauri.macos.conf.json等）：管窗口、打包和分平台差异。最常改窗口尺寸和更新渠道相关项。
rust-toolchain.toml：管仓库钉住的 Rust 版本。基本不用动，照指定版本装编译器就行，版本不一致省下的排查时间比省下的下载时间值钱。

新手高频踩坑

现象：macOS 构建失败，或跑起来后录屏、权限全乱。原因：只装了 Xcode Command Line Tools。解法：从 App Store 装完整 Xcode，再执行sudo xcodebuild -license和xcodebuild -runFirstLaunch。
现象：开发版和已安装的正式版抢 3030 端口和~/.screenpipe数据目录，一不小心动了真机上的录制历史。原因：两者默认端口和数据目录相同。解法：用bun run dev:tauri跑开发构建，它会自动改道到~/.screenpipe-dev和 3130 端口；或手动加--port 3035 --data-dir，macOS 上优先用$TMPDIR，因为系统会定期清/tmp。
现象：Windows 上libclang.dll、bindgen 报错，或提示 CRT 找不到。原因：当前终端没设LIBCLANG_PATH，或没装 Visual Studio 的 C++ 工作负载。解法：winget 装 "Desktop development with C++"，再把LIBCLANG_PATH指到 LLVM 的 bin 目录。

企业官网建设流程全解析