Waypath 是一个面向编程智能体与独立开发者的本地优先知识引擎。它把项目决策、实体关系和会话产物保存在单个 SQLite 文件中，再通过轻量 CLI 向任意智能体宿主（Claude Code、Codex 或 MCP 客户端）提供图感知、以事实为先的上下文。与云端记忆服务不同，Waypath 完全在用户机器上运行，拥有规范的事实模式而非向量块，把每条记忆视为一等公民并配有显式的晋升与审核门控，且以 77 kB 的 npm 包发布，无需必需运行时服务。
主要能力：
- 本地优先存储：所有数据保存在单个 SQLite 文件中，零云依赖。
- 图感知召回：通过 FTS5 全文索引与 RRF 融合实现上下文检索，支持实体/决策上下文扩展。
- 受治理的记忆：每条记忆经过候选审核、矛盾检测与取代流程，具备显式晋升与审核门控。
- 多宿主适配：可作为 MCP 服务器运行，供 Claude Code、Cursor 及任意 MCP 客户端使用。
- 四个独立内核：事实内核（规范决策、实体、偏好、时间有效性，schema v3 支持取代与历史）、归档内核（原始证据存储，内容哈希去重与 FTS5 全文索引）、本体层（图遍历，模式包括 project_context、person_context、system_reasoning、contradiction_lookup）、晋升引擎（候选审核、矛盾检测、取代流程）。
- 单一 createFacade() 暴露 14 个动词，宿主 shim 将其适配到各智能体的引导协议。
使用方式： 安装：npm i -g waypath 要求 Node.js ≥ 22，推荐 22.5+ 以启用原生 node:sqlite 驱动；22.0–22.4 会自动回退到 better-sqlite3。 典型流程：
- 引导会话（以 Codex 为例）。
- 召回相关上下文。
- 捕获提炼后的洞见并通过审核晋升。
- 作为 MCP 服务器运行（供 Claude Code、Cursor、任意 MCP 客户端使用）。 完整帮助：waypath --help。 MCP 服务器可通过独立二进制或主 CLI 启动，暴露的工具包括：recall、page、promote、review、graph-query、source-status。 配置：默认零配置。可在工作目录放置 config.toml（或用 WAYPATH_CONFIG_PATH 指向配置文件）来调整检索权重、适配器开关或审核阈值；也可通过环境变量覆盖。优先级：环境变量覆盖 > config.toml > 内置默认值。
适用场景：
- 为 Claude Code、Codex 等编程智能体提供跨会话的持久化项目上下文。
- 需要本地存储、不希望依赖云服务的个人开发者或小团队。
- 需要图结构关系召回与记忆治理（审核、矛盾检测、取代）的智能体工作流。
限制与状态：
- 版本 0.1.0，为首次公开发布。
- 测试：131 项通过（单元 + 集成 + 基准）。
- 稳定接口：CLI（26 个命令）、MCP 服务器、facade API。
- 暂缓功能：托管部署、多用户同步、自适应排序反馈。
- 需要 Node.js ≥ 22.0。
- 采用 MIT 许可证。
