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/screenpipeScreenPipe 是一个 100% 本地运行的开源项目它在你电脑上持续记录屏幕、音频与操作行为把数据存进本地 SQLite再通过 MCP、CLI 等接口把这些记忆喂给 Claude、Codex 等 AI Agent。整个仓库是典型的 Rust 工作区 Tauri 桌面应用 JS/TS 包组合代码量不小但目录划分相当规整。下面按先认识项目、再看地图、再跑起来、最后看配置的顺序带你逛一遍仓库。ScreenPipe 是什么给电脑装一块 24 小时记忆它干的事可以浓缩成一句话屏幕 音频 → 本地存储 → 供 AI 查询。持续采集录屏、录音并抓取无障碍树界面控件信息、OCR 兜底、说话人分离、键盘输入与应用切换本地存储数据只落在你自己的机器上约每月 20GB 存储支持静态加密喂给 Agent通过 MCP 服务 或 CLI你可以问我最近 5 分钟看了什么、总结今天的对话甚至创建自动化的管道Pipe。资源占用方面官方口径是 5–10% CPU、0.5–3GB 内存可以离线工作。项目是 source-available 授权见 LICENSE.md。先看地图ScreenPipe 目录结构解析仓库根目录不算杂乱四大板块是crates/Rust 核心、apps/桌面应用、packages/JS 生态包、docs/文档。带注释的目录树如下screenpipe/ ├── apps/ │ └── screenpipe-app-tauri/ # Tauri 桌面应用Rust 壳src-tauri/ Next.js 前端app/、components/、lib/ ├── crates/ # 27 个 Rust crate各自独立、组合成完整采集引擎 │ ├── screenpipe-core/ # 主入口与核心逻辑可执行二进制 screenpipe 在这里 │ ├── screenpipe-screen/ # 屏幕捕获 │ ├── screenpipe-audio/ # 音频捕获、转写、说话人识别 │ ├── screenpipe-a11y/ # 无障碍树捕获macOS/Windows/Linux 平台实现 │ ├── screenpipe-db/ # SQLite 数据库层含大量 .sql 迁移脚本 │ ├── screenpipe-engine/ # Pipe 自动化引擎及其 JSON Schema │ ├── screenpipe-semantic/ # 语义理解与检索 │ ├── screenpipe-redact/ # 敏感信息打码/擦除 │ ├── screenpipe-sync/ # 数据同步 │ └── ... # 其余事件、密钥保险库、团队记忆、遥测等 ├── packages/ │ ├── screenpipe-mcp/ # MCP 服务器把 ScreenPipe 接进各家 Agent │ ├── sdk/ # 多语言 SDKSwift、JS/TS、Electron、Tauri │ ├── cli/ # npm 上的 screenpipe CLI 包npx screenpipe │ ├── browser-extension/ # 浏览器扩展 │ └── ai-gateway/ # AI 网关Cloudflare Worker ├── docs/ # 设计规范、规格文档、多语言 README 翻译 ├── infra/ # 各平台发布 Runner、Windows 开发镜像等 CI 基建 ├── scripts/ # 开发辅助脚本基准测试、开发 VM、权限授予 ├── evals/ # 编码 Agent 的评测用例与评分器 ├── Cargo.toml # Rust 工作区根配置声明成员与公共依赖 ├── Cargo.lock # 依赖锁文件下单收据保证构建可复现 ├── rust-toolchain.toml # 固定 Rust 1.94.0 及四个目标平台 ├── CONTRIBUTING.md # 三大平台的安装与构建指南最重要的文档 └── ONBOARDING.md / TESTING.md # 新人上手路线图 / 测试指南记住一条主线就够了crates/是引擎apps/screenpipe-app-tauri/是引擎的 GUI 外壳packages/是引擎对外输出的各种插座。怎么把它跑起来三种入口与最快路径 按你的目标选一条路三条入口互不冲突。入口一直接当用户用推荐第一次接触时桌面应用官网下载即可自动更新纯命令行执行npx screenpipe record启动后台录制再npx screenpipe setup一键把技能与 MCP 配置注入到本机的各编程 Agent。之后直接在 Claude 等工具里用自然语言查自己的屏幕历史。入口二编译出独立 CLImacOS / Linux在仓库根目录执行cargo build --releasemacOS 建议加--features metal启用 GPU 加速然后运行./target/release/screenpipe。前置依赖见 CONTRIBUTING.mdmacOS 需要完整 Xcode 与 FFmpeg 等Linux 需要 tesseract、libpipewire 等系统库另外都要装 Bun。入口三构建桌面应用Windows 特别注意桌面应用是独立的 Cargo 工作区有自己的src-tauri/target不要先在根目录跑cargo build --release那不会给它热身只会拖慢首次构建。正确流程是进入apps/screenpipe-app-tauri/bun install后执行bun tauri build开发态用bun run dev:tauri前端起在 1420 端口。首次构建会自动下载 FFmpeg、OpenBLAS 等原生依赖并缓存到~/.cache/screenpipe/native-depsWindows 上请预留至少 10GB 磁盘。跑起来之后用npx screenpipe status之类的命令确认录制健康就完成从克隆到跑通的全过程了。什么时候才需要动配置文件四处关键点配置文件平时不用碰但改到对应模块前先看清下面这份谁管什么清单Cargo.toml工作区根配置。声明crates/*为成员、统一版本号当前 0.4.46与公共依赖tokio、reqwest、serde 等。只有新增 crate 或统一升级依赖时才动它Cargo.lock 是锁定收据不要手改。rust-toolchain.toml钉死 Rust 1.94.0并预装四个目标平台macOS 双架构、Windows MSVC、Linux。装好 rustup 后首次进目录就会自动对齐版本无需操心。tauri.conf.json桌面外壳的身份证——产品名、打包目标dmg/nsis/appimage/deb、图标、screenpipe://深链 scheme、自动更新密钥都在这。要改窗口行为、分发渠道或深链协议才需要编辑旁边还有一组tauri.macos.conf.json等按平台的覆盖配置。biome.json 与 lefthook.yml前者管 JS/TS 的 lint 与格式化后者定义 git 钩子提交前检查。它们保证你提交的代码风格不跑偏改完前端跑一次bun run test即可验证。另外两个值得知道但不必动的位置crates/screenpipe-config/ 负责运行时配置读写apps/screenpipe-app-tauri/package.json里几十个test:e2e:*脚本则是回归测试的开关。更多细节与贡献规范见 CONTRIBUTING.md、ONBOARDING.md 和 docs/ 下的设计文档。【免费下载链接】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），仅供参考
