trace-cortex/cortex-app

它解决的问题

每个 AI 聊天机器人都从零开始。Cortex 维护一个关于你是谁以及你如何工作的持续模型——基于你自己的笔记和过去的 AI 对话构建——并将该模型加载到你的工具中，使它们以你的方式回答。一切默认在你的 Mac 上运行，无需云账户。

核心循环（4 步）

步骤	说明
连接	导入本地笔记（如 Obsidian）、AI 聊天导出，或登录并导入你的历史记录
审查	你批准有用的内容，归档噪音——你的记忆保持可信
询问	自己获取带引用的答案，或让连接的 AI 工具仅检索你已批准的内容
控制	每次读取、保存、导出和工具连接都可见且可撤销

五个使其运作的系统

• 它会做梦 — 当你离开时，后台进程运行：它仅解决通过确定性安全规则的矛盾（你的原始来源保持权威，每个决策都被记录），并预热经过验证的“热上下文”包，使下一个请求来自检查过的缓存。
• 它联想回忆 — 检索遍历信任感知的知识图谱，进行预算化的多跳回忆，包括个性化 PageRank 模式，该模式显示与你的查询相关的内容，而不仅仅是词汇相似。每一跳都带有来源。
• 它将上下文打包为协议 — 上下文记忆协议（CMP）使用令牌感知的背包打包模型校准的信封，然后运行每会话增量通道，绝不重新发送代理已持有的内容。检索融合 BM25 全文、sqlite-vec 向量相似性、时间和意图信号，在设备上重新排序，并引用来源或弃权，而不是猜测。
• 它建模判断 — 确定性提取器和 LLM 压缩器构建七种类型层（声音、偏好、决策、事实、情节、实体、主题）形成全人地图。代理在开始工作前调用 GET /v1/agent-adaptation 加载你的校准简报。
• 它作为你拥有的资产复合 — 包使用 SHA256 寻址且可重放。模型以纯 Markdown 和可重建索引的形式存在于你的 Mac 上，可移植、可检查、一键可擦除。切换助手——你的模型随你而行。

构建方式

层	选择
应用	适用于 macOS 13+ 的原生 SwiftUI 应用（Developer ID 签名，Apple 公证）
引擎	本地 FastAPI 服务器，位于 127.0.0.1:8766
存储	SQLite（全文 + sqlite-vec 向量），镜像到你可读的、Obsidian 风格的保险库
协议	MCP（模型上下文协议）用于连接 AI 工具；CMP（上下文记忆协议）用于打包上下文

然后：来源 → 审查收件箱 → 分层记忆 → 个人档案 + 知识图谱 → 上下文组装引擎 → 你的 AI 工具（Claude Desktop、Cursor、Windsurf、Zed、任何 MCP 客户端）。

信任、隐私和同步

• 默认本地优先 — 无账户、无云、无环境录音（无屏幕、无麦克风）。Cortex 仅在你明确连接后才读取来源。
• 信任控制 — 范围化、可撤销的每工具权限，默认启用编辑。
• 可选云同步 — 用于多设备同步的端到端加密设计；可选且基于账户，除非你开启，否则数据保持本地。

安装与构建

• 安装：下载最新 DMG（macOS 13+），将 Cortex 拖入应用程序，启动（无警告打开——Apple 公证），然后指向笔记文件夹、导入 AI 聊天、审查并连接工具。它会自动更新。
• 从源码构建：./macos/build.sh 用于 SwiftUI 应用；对于后端引擎，使用 Python 3.11+、venv、pip install -r backend/runtime-requirements.txt，然后运行 pytest backend/tests；离线检索质量门通过 python3 scripts/retrieval_eval.py 运行。

背后团队

在滑铁卢大学（工程学院）作为本地优先个人操作模型的应用研究项目构建，由 Composio 赞助。在 MIT 许可证下发布，© 2026 Doppl。