文档
从零开始，做出一份助手能读、能搜索的记忆。
早期访问。这些步骤描述的是 Windows 桌面版和托管副本。两者每周都在变；如果这里的内容和你看到的不一致，以应用为准，这个页面已经过期——请告诉我们：hello@varven.net。
1. 安装
下载 Windows 安装程序并运行。首次启动时，Varven 会要两样东西：
- 一个笔记库文件夹。任何文件夹都行。如果你已经有 Markdown 笔记，直接指向那里——Varven 会读取已有的内容。
- 允许运行本地模型。整理在你自己的硬件上完成，完全不需要云端。
有 GPU 时 Varven 会自动使用；没有则回退到 CPU：更慢，但能用，而且不会悄悄失败。
2. 检查你的笔记库
首次同步之前，Varven 会检查你的笔记库，报告无法顺利迁移的内容 — 重复项、无法归类的笔记、太长而无法完整索引的条目。检查在本地运行，不发送任何数据。
3. 连接一个 AI 客户端
Varven 通过 Streamable HTTP 使用 Model Context Protocol，因此任何 MCP 客户端都能用。在 Claude 里：设置 → 连接器 → 添加自定义连接器，然后粘贴：
https://api.varven.net/mcpClaude 会把你带到登录页面。批准之后，连接器就会出现在你的工具列表里。同一个 URL 在任何支持远程 MCP 连接器的客户端里都能用——ChatGPT、Gemini、Cursor 和 VS Code 都在其中，前提是它们自己的连接器支持允许。具体请看各客户端的连接器设置。
4. 你的助手能做什么
| 工具 | 功能 |
|---|---|
memory_search | 在你的笔记库里做关键词与语义的混合搜索 |
memory_get | 按 id 获取一条完整的记忆 |
memory_briefing | 常驻上下文：置顶条目、偏好、纠正 |
memory_timeline | 最近有什么变化，按顺序列出 |
当前版本中四个工具均为只读。云端写入在路线图上。
读懂一条结果
结果会带上一些值得留意的标记：
- stale — 这条信息最近没有被重新核实过。不同类型的记忆以不同速度过期，此标记会跟踪这一点。偏好和纠正永不过期，因为它们说出来即为真。
- weak_match——即便是最好的命中，得分也很低。多半不是你要的答案，你的助手应该直说，而不是围着它写出一段自信的文字。
- superseded——这条已被更新的内容取代。旧版本仍然可查，正是这一点让你能问出某件事是什么时候变的，而不是让历史被悄悄改写。
当有什么看起来不对
搜索什么都没返回，但笔记库里有笔记
通常是第一次同步还没完成。看一下同步面板。如果显示已完成，就运行 --inspect——一个没有可识别 frontmatter 的笔记库能同步成功，但搜索会很糟。
停用一段时间后的第一个问题很慢
本地模型闲置时会卸载，重新载入 VRAM 大约需要 30 秒。那不是卡死。它只影响本地操作；云端副本会立刻回答。
连接器无法授权
几乎总是 URL 不匹配。地址必须正好是 https://api.varven.net/mcp——末尾不要有斜杠，也不要用 http://。OAuth 的资源标识符是逐字比较的，不匹配时只会给出一条毫无帮助的报错。
答案变差了，却没有任何报错
多半是本地模型连不上，搜索已经悄悄降级成只用关键词。状态面板会显示模型的健康状况。这类故障天生是无声的，指示灯就是为此存在的。