这个项目能做什么

Vault Cortex 是一个独立的 MCP（Model Context Protocol）服务器，为 AI 代理提供混合搜索、任务管理、结构化记忆，以及对 Obsidian 仓库的读写访问。它直接处理磁盘上的 .md 文件，不需要 Obsidian 插件，也不需要运行 Obsidian 实例。该服务器运行在单个 Docker 容器中，可本地部署、在 VPS 上自托管，或通过 Railway 或 Render 一键部署以供远程访问。 主要功能： - 混合搜索：通过 Reciprocal Rank Fusion（RRF）将 FTS5 关键词匹配与向量语义相似度相结合，并针对意图密集的查询使用 cross-encoder 重排序加以优化。所有模型均在本地运行（总计约 45MB，无外部 API）。 - 结构化记忆：仅追加、带日期的条目系统，存储为纯 Markdown 文件（默认位于 About Me/ 文件夹）。主题回忆可跨所有记忆文件检索相关条目，显示当前状态和历史演变。支持 entry-policy: living，用于可修剪的当前状态条目。 - 任务管理：支持感知看板的任务查询和更新。可按状态、日期、优先级、文件夹或看板列筛选。同时处理 Tasks 插件表情符号标记和 Dataview 行内字段格式。完成重复任务时会生成下一次任务；支持“完成时”操作。 - 文件访问：读取非 Markdown 文件，包括图像（服务器端缩小）、PDF（文本提取或渲染页面）、canvas（可读大纲）和数据文件（TXT、SVG、JSON、XML、CSV、YAML、日志、Bases）。 - 链接图：跨仓库提供反向链接、外向链接和孤立文件检测。 - Obsidian 原生：理解 frontmatter、wikilink、标签、标题和日记。 - 引导式工作流：内置用于仓库健康检查、记忆回顾和每日核对的提示，并根据实时仓库数据组装。 身份验证：远程访问支持 OAuth 2.1 并提供同意页面；对不支持 OAuth 的客户端提供 Bearer token。OAuth 客户端的令牌续期会自动处理。 部署选项： - 本地：Docker 加仓库文件夹，通过 npx vault-cortex@latest init 进行设置 - 远程：在 Railway 或 Render 上一键部署，或在任何带 Docker 的 Linux VPS 上自托管 - 远程部署使用 Obsidian Sync 在设备间保持仓库最新 设置：CLI 管理服务器生命周期（configure、upgrade、start、restart、logs、down）。也提供手动 Docker Compose 设置。/setup 设置页面用于处理远程部署的 Obsidian Sync 登录。 安全性：CI 包含 Gitleaks 和 Trivy 扫描，以及 OpenSSF Scorecard 和最佳实践徽章。仓库始终是纯 Markdown 的事实来源；容器仅保存一份副本。 使用案例：在一次为期 15 天的欧洲旅行中经过测试，通过手机进行 30 多次会话、216 次工具调用，全程未使用笔记本电脑。一个会话中的写入内容在跨城市、跨日期的下一个会话中立即可用。