SuperAPI AI 工具集

facthouse

Facthouse 是一个本地 AI 记忆引擎,把 AI 工具的会话活动存入你自有的 SQLite 文件,并用受神经科学启发的 Data→Information→Knowledge 流程做整合。

访问官网

工具介绍

Facthouse 是面向 AI 工具的本地记忆引擎。多数“记忆”产品只会索引聊天记录,而 Facthouse 会接收智能体活动(消息、工具调用及其他 MCP 流量),按 Data(会话中发生了什么)→ Information(提取出的事实)→ Knowledge(实体图上整合后的信念)逐层整合,期间链接实体、去除重复、调和冲突并淘汰过时内容。矢量嵌入可在图之上提供可选的语义搜索。存储是磁盘上的一个 SQLite 文件。

需要 Node 22.5 或 24+。可用 facthouse init --web 以浏览器表单方式初始化,它会打印 127.0.0.1 URL 且不自动打开浏览器;也可在终端交互初始化(默认 copy,即复制 Claude Code、Cursor 或 Grok Build 的会话日志;type record 则由助手保存事实)。init 写入存储后立即打印 MCP 片段,可在复制/提取运行期间加入客户端 MCP 配置,初始化结束后重启客户端。

在客户端中,用普通对话陈述一件持久事实即可,没有 remember 命令;下个会话可直接提问,或用 facthouse search 检索。数据来源有两种:从 Claude Code、Cursor 或 Grok Build 日志复制(copy),或从任意 MCP 客户端记录(record),每个存储二选一。

主要能力:一个 SQLite 数据库内含三张表——D(session_events)、I(session_facts)、K(facts);FTS5 词索引与可选嵌入为 K 的索引而非第二存储,语义搜索默认关闭。实体图会提取并链接人物、组织、项目、地点、产品;混合搜索用 BM25 + 结构化域 + 实体图路径,经 Reciprocal Rank Fusion 合并(嵌入默认关闭)。提供 memory://briefing 与 memory://profile 只读资源;仅支持工具的客户端应在会话开始调用 get_session_context。工具包括 log_event、get_events、get_session_context、get_entity、get_context、search_knowledge、capture_fact、consolidate、get_schemas、get_stats 等;推断类工具默认关闭(inferences.enabled)。历史不可变,事实从不删除只被取代。

使用方式:MCP JSON 通过 npx 启动服务器,无需全局安装;npm install -g 可把 facthouse 加入 PATH 以使用 init、settings、stats、inspect。CLI 命令在 bash、zsh、PowerShell 中可用,PowerShell 需给 @facthouse/mcp 加引号。默认存储为 ~/.facthouse,可用 MCP 片段中的 "env": { "FACTHOUSE_DATA": "/absolute/path" } 指定其他路径。consolidate 是流水线动词(复制、提取、整合),每次提取上限 50 行,consolidate --all 解除该上限。hook 无法调用 MCP 工具,因此用 facthouse notify … 通知已运行的服务器并立即返回;推荐 PreCompact 用 notify compaction。

限制:无语言模型时,整合回退为内置启发式,不会从转录中提取事实;capture_fact 仍可存事实,但无实体与域路由。Cursor 会使用工具但不消费资源,需手动调用 get_session_context。存储需要 Node,智能需要语言模型;默认是已有订阅上的 Claude Code CLI。Postgres 为可选,配置后若 URL 缺失或无法连接会直接停止而不创建 SQLite 文件。资料未提供收费或价格信息。