ContextPulse 是一款面向 AI 智能体的本地优先环境上下文工具，以桌面守护进程形式运行，让 AI 编码助手等智能体能够“看到”屏幕、“听到”语音并了解用户刚刚的操作。当前版本为 v0.1-alpha 开发者预览版，项目仍在积极开发中，API 与配置可能在不同版本间发生变化。
一、主要用途 ContextPulse 旨在填补 AI 助手缺乏环境感知能力的问题。它实时捕获屏幕、语音、键盘鼠标活动和剪贴板内容，再通过 Model Context Protocol（MCP）交付给 AI 智能体。一个托盘图标守护进程负责捕获，一个配套 MCP 进程负责向智能体提供数据。它从第一天起就是 MCP 原生的，以可流式 HTTP 暴露所有上下文作为 MCP 工具，任何符合标准的 MCP 客户端无需定制集成即可读取。
二、主要能力
- 多模态捕获：屏幕捕获（含 OCR）、语音听写、键盘/鼠标输入，全部在同一个后台进程中运行，无需拼接多个工具。
- 工具集：共 37 个 MCP 工具，其中免费 33 个（Sight 11 个、Voice 7 个、Touch 3 个、Project 5 个、Memory 5 个、Recall 2 个），Pro 版额外提供 4 个搜索工具（语义记忆搜索加跨模态事件查询）。Recall 的两个工具读取夜间蒸馏的事实存储，因此在整合器至少运行一次之前不会返回任何内容。
- 记忆架构：采用热/温/冷三层架构——内存 LRU 缓存 → SQLite WAL + FTS5 → 压缩归档。可选的 pip install contextpulse-memory 包提供这些工具。
- 后台学习工具：包含词汇巩固、纠正检测等，自动运行以逐步提升转写质量。
- 本地存储与搜索：所有模块向共享 EventBus 发出事件，写入本地 SQLite 数据库（带 FTS5 全文检索）。MCP 服务器从不写入 activity.db，该管道仅用于捕获；记忆服务器是例外，按设计通过 memory_store 和 memory_forget 写入自己的 memory.db。
三、使用方式
- 配置与安装：运行 contextpulse --setup 将带认证的 contextpulse 条目写入 Claude Code、Cursor 和 Gemini CLI，首次运行时会创建访问令牌；重新生成令牌后需再次运行。随后启动 ContextPulse。
- MCP 接入：可添加到 ~/.claude.json。端点需要访问令牌，首次使用时为每次安装生成一个，并以仅用户权限存储：Windows 为 %APPDATA%\ContextPulse\mcp_token，macOS 为 ~/Library/Application Support/ContextPulse/mcp_token，Linux 为 $XDG_CONFIG_HOME/ContextPulse/mcp_token。可用 contextpulse-mcp --print-config claude-code 打印，或在托盘 Settings -> MCP Access 中查看。Cursor、Gemini CLI、Claude Desktop 的配置片段及故障排查见 docs/mcp-configs。
- 安全说明：令牌可防御其他本地调用者，如机器上的其他账户、具有回环访问权限的沙箱应用，以及其他 MCP 客户端和智能体；但无法防御已以当前用户身份运行的进程，因为该进程可以直接读取令牌文件和数据库。捕获文本在存储前和任何 MCP 工具返回前都会脱敏。0.1.1 之前写入的行会在升级后首次启动守护进程或 MCP 服务器时通过一次性扫描就地脱敏；也可手动运行 scripts/purge_clipboard_secrets.py。过滤器覆盖范围见 SECURITY.md。
- 网络功能（默认全部关闭）：语义记忆搜索首次使用时从 huggingface.co 下载嵌入模型，仅一次，之后离线运行；语音 LLM 清理将听写文本发送至 Anthropic API 以修正语法和去除填充词，需在 voice_anthropic_api_key（或 ANTHROPIC_API_KEY）中提供密钥并开启 voice_always_use_llm，同一密钥还允许词汇学习器将近期转写对发送至 Anthropic 以识别语音识别持续误听的词；事实整合器 scripts/probe_consolidator.py 将近期捕获事件通过 Claude CLI 蒸馏为事实，该提示包含应用名、窗口标题和捕获文本本身，仅在你运行或调度该脚本时执行。
四、适用场景 适用于希望让 AI 编码助手获得屏幕、语音和操作上下文的使用者，以及需要在本地保留数据、避免云端依赖的开发者。免费功能永久可用，无需许可证；Pro 为可选付费层级，通过离线验证的许可证密钥解锁，并提供首次使用即开始的 30 天试用，无需信用卡。商业许可可用于嵌入专有产品。
五、限制与注意事项 项目为开发者预览版，API 与配置可能变化。核心功能无需账户，但在开启上述可选网络功能之前不会联系任何第三方服务器，其中两项会把捕获文本发送至 Anthropic 且默认关闭。一旦智能体读取了工具结果，后续如何处理取决于客户端：本地模型保留在机器上，云端客户端会像其他提示一样发送给其提供商，ContextPulse 无法看到或控制这一跳。许可证为 GNU Affero 通用公共许可证 v3.0（AGPL-3.0）：可自由使用、修改和分发，若修改并作为服务部署则须开源更改。该项目由 Jerard Ventures LLC 构建，其统一多模态上下文交付系统正在申请专利。