Cortex 是一款本地优先（local-first）的个人记忆 App：它把你的笔记、Obsidian 库和 ChatGPT / Claude 聊天历史，编译成一份带引用的"你如何工作"模型，并通过 MCP 协议喂给 Claude Desktop、Cursor 等 AI 工具。数据默认全部留在你自己的 Mac 上，无需账号、无需云——AI 工具从此不再从零开始，而是带着你的判断力开工。

为什么每次和AI对话都要"重新自我介绍"？

用过 Claude 或 ChatGPT 的人都有同感：

• 刚说过"我偏好简洁直接的写作风格"，换个会话又要重复一遍；
• AI 不知道你的项目代号、决策背景和"周二集中开会"这类个人习惯；
• 每次新任务都像在和实习生交接，从零解释你的标准。

问题的根源是：模型有"世界模型"，却没有"你的模型"。Cortex 要做的，就是为你编译一个模型——把你散落在笔记、聊天记录、邮件、日历里的偏好、决策与事实，提炼成结构化、可引用、可检索的记忆，按需提供给任意支持 MCP（Model Context Protocol）的 AI 工具。

它如何构建"你的模型"

Cortex 的核心不是简单存聊天记录，而是构建一个分层、带引用的个人操作模型：

这些内容由确定性抽取器和 LLM 提炼引擎共同构建，检索时融合关键词、向量（sqlite-vec）、时间衰减与意图信号，在本地完成重排序，并且坚持一个原则：能引用就引用，引用不了就明确说不知道，绝不凭空猜。整套机制的协议细节可阅读 docs/CMP_PROTOCOL.md，系统整体架构见 docs/ARCHITECTURE.md。

四步闭环：连接 → 审阅 → 提问 → 掌控

Cortex 的日常使用被刻意简化成一条循环，这也是它最容易被新手上手的部分：

1. ① Connect 连接：指向一个笔记文件夹，或导入 AI 聊天历史（ChatGPT / Claude 导出），或连接 Obsidian、Notion、Slack、Gmail 等数据源。支持的源非常多，完整清单见 docs/SOURCE_IMPORTS.md；
2. ② Review 审阅：新内容先进"待审收件箱"，你批准什么、归档什么，记忆库才保持可信；
3. ③ Ask 提问：在 App 内用自然语言提问，得到带出处引用的答案；或让已连接的 AI 工具自行检索你批准过的记忆；
4. ④ Control 掌控：读取、保存、导出、每一次工具访问都可见、可撤销。

💡 想看它"记住你"的样子？仓库里内置了样例笔记 macos/SampleNotes/01-how-i-work.md，展示了 Cortex 提炼出的偏好片段，比如"我偏好简洁、直接的写作""我把会议集中在周二"。

一键接入 Claude 和 ChatGPT

这是 Cortex 最"省心"的设计：macOS App 一键安装 MCP 配置。打开Connections & Privacy > AI tools，它会自动：

• 为 Claude Desktop、Cursor、Windsurf、Cline 等本地工具写入 MCP 配置（写入前自动备份原文件）；
• 生成带权限范围的本地令牌（cxm_前缀），默认只授予read / write / export / maintenance权限，不包含危险操作；
• 对暂不支持 MCP 的网页版 ChatGPT、Gemini 等，提供"上下文包"回退方案——把裁剪好的带引用上下文复制过去即可。

接入后，AI 工具在工作前会先调用get_context拉取你的校准简报（约束、决策、开放问题、近期上下文），再开始干活。工具清单与权限模型详见 docs/MCP_INTEGRATIONS.md。

本地优先意味着什么？数据归你

"本地优先"不是营销词，Cortex 在隐私上的承诺非常具体（详见 docs/TRUST_CONTROLS.md）：

• 默认无需账号和云：App 在本机127.0.0.1上跑一个 FastAPI 引擎，检索全部在设备端完成；
• 记忆以纯 Markdown 存储：你的记忆库是一个人类可读的本地文件夹（Vault），可随意检查、复制、备份、删除，SQLite 只是可重建的索引——格式说明见 docs/LOCAL_VAULT_FORMAT.md；
• 只读你授权连接的源：不记录屏幕、不碰麦克风，不采集环境数据；
• 最小权限 + 默认脱敏：每个 AI 工具的读取/写入/导出权限独立开关，默认关闭危险操作；
• 换工具，模型跟人走：上下文包是内容寻址（sha256）且可重放的，从 Claude 换到 Cursor，你的"模型"原样带走。

可选的端到端加密多设备同步是 opt-in 的，不打开数据就永远在本地，设计文档见 docs/ACCOUNTS_ENCRYPTION_DESIGN.md。

如何安装并开始使用

Cortex 目前为macOS 13+的原生 SwiftUI 应用，Developer ID 签名并经过 Apple 公证，打开无警告：

1. 从项目发布页下载 DMG，将 Cortex 拖入 Applications；
2. 启动 App，指向一个笔记文件夹或导入你的 AI 聊天导出；
3. 在 Review 页批准第一批记忆；
4. 在 Connections & Privacy 里一键连接 Claude Desktop / Cursor。

App 自带更新检查，安装一次后新版本会自动到达。完整开发搭建与构建说明见 SETUP.md 与 docs/INSTALLER_AND_UPDATES.md。

代码在哪里看

如果你想深入了解实现，建议按这个路径读：

小结

🧠 Cortex 把"你如何工作"变成了一份本地存储、带引用、可携带的记忆资产：它在你休息时整合记忆、在 AI 工具需要时按需供料、在你离开时随你迁移。对于每天和 Claude、ChatGPT、Cursor 打交道的知识工作者来说，这大概是让 AI 助手真正"懂你"的第一步。