文档

开始使用 Wenlan。

安装本地 memory layer，学习每日 handoff loop，并让 AI 工作 context 可读、可搜索、可由你掌控。

从这里开始

新用户应该先安装，为自己的 client 运行 setup，接着阅读 daily workflow 和 core concepts。Project docs 涵盖 architecture、reference paths、evals、releases、scope、source builds、roadmap、development conventions 和 contribution paths。

从这里开始

安装 Wenlan，并验证第一次 memory round trip。

设置

开始使用 Wenlan

安装 Claude Code plugin，或为另一个 MCP client 运行 Wenlan setup，然后确认本地 memory loop 可以工作。

Wenlan 团队 · 更新于 2026 年 5 月 15 日 · 4 分钟设置

安装之后

把安装变成工作习惯：带着 context 开始、捕捉有用内容、检查哪些内容应该被信任，并在 context 变冷前 hand off。

工作流

每日 Workflow

带着 context 开始，捕捉重要内容，需要时 recall，并在 context 变冷前 hand off。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

捕捉

捕捉质量

判断什么该进 Wenlan：durable facts、decisions、lessons、gotchas、corrections 和 project context。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

信任

检查与信任

了解 Wenlan 如何让不确定的 memory 可见：pending captures、revisions、contradictions、rejections、confirm 和 forget。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

概念

核心概念

了解 Wenlan 背后的组件：memories、sessions、handoffs、pages、daemon、MCP、Markdown 和 local index。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 6 分钟阅读

参考资料

Memory types、glossary、architecture、commands、Claude Code plugin、CLI/service management、updates、upgrade notes、package names、platform support、HTTP API、API examples、typed clients、spaces、graph context、pages、import paths、git history、retrieval status、experimental flags、local data、backup paths、configuration、environment variables、MCP clients、agent profiles、diagnostics、FAQ 和 repair paths。

记忆

Memory 类型

了解 Wenlan 的六种 canonical memory types、agent 如何选择，以及哪些 legacy aliases 仍会出现在 API 边界。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

术语表

快速对照 Wenlan 术语：memory、handoff、page、space、daemon、MCP、local index、provenance 和 eval language。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

架构

Wenlan 的组成方式：一个本地 daemon、薄 client、shared wire types、本地 artifacts，以及由 wenlan-core 负责的 retrieval。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 7 分钟阅读

命令参考

Commands 与 Tools

日常使用 Wenlan 时最重要的 Claude Code commands 和 MCP tools。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

插件

Claude Code 插件

在 Claude Code 中使用 Wenlan 最完整的 workflow：setup、session brief、capture、recall、review、distill、read 和 handoff。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 6 分钟阅读

CLI 管理

CLI 与 Service 管理

使用 Wenlan CLI 安装 runtime、管理 daemon、检查 status、搜索 memory，并连接 MCP clients。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

生命周期

更新与卸载

刷新 Wenlan 本地 runtime、验证版本健康、重启 MCP clients，并在不意外丢失数据的前提下移除 service。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 4 分钟阅读

升级

升级笔记

阅读 Wenlan releases 的实用升级路径：要重跑什么、验证什么，以及当前 public runtime shape 改了什么。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

Packages 包

Packages 与 Registries

了解 Wenlan package name 如何对应到 plugin、runtime setup、MCP connector、Rust crates 和 release binaries。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 4 分钟阅读

平台

平台支持

了解 Wenlan 如何在 macOS、Linux 和 Windows 上运行：service managers、local data paths、model backends，以及 Docker/VM caveats。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

API 参考

HTTP API 参考

了解 CLI、MCP connector、plugin 和 local tools 背后调用的本地 daemon surfaces。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

API 示例

当 CLI 或 MCP tools 不是合适选择时，从 scripts 使用本地 daemon HTTP API。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 6 分钟阅读

Types 参考

Typed Clients 类型客户端

当 Rust tool 需要调用本地 daemon、又不想依赖 untyped JSON shapes 时，使用 wenlan-types。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 4 分钟阅读

Spaces 管理

Spaces 空间

分开 work、personal、client 和 project memory，并了解 Wenlan 如何解析 active space。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 6 分钟阅读

Graph 图谱

Knowledge Graph 知识图谱

了解 Wenlan 如何连接 people、projects、tools、observations 和 relations，让 recall 不只靠文本相似度也能找回 context。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

Pages 页面

有来源支撑的 Pages

了解 Wenlan 如何把 atomic captures 变成含 source memory IDs、revision state 和 refresh paths 的可读 pages。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

可移植性

Import 与 Portability

把选定的 durable context 移入 Wenlan，并让 Wenlan 的可读 artifacts 在 daemon 之外也保持 portable。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

版本

本地 Git History

检查 Wenlan 为可读 page、session、handoff 和 status artifacts 保留的真实 git history。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

模型

Models 与 Keys

在 local memory mode、可选 on-device models 和可选 Anthropic API keys 之间选择，用于更丰富的 extraction、page synthesis、recaps 和 graph work。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

Retrieval 检索

进阶 Retrieval 状态

了解 Wenlan 已发布的 retrieval path，以及新版 retrieval work 背后那些 opt-in main-branch experiments。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 6 分钟阅读

Experiments 实验

Experimental Flags 实验标志

了解如何阅读 Wenlan 的 opt-in main-branch flags，而不把它们误认为 released defaults。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 6 分钟阅读

本地控制

数据与隐私

Wenlan 把数据放在哪里、哪些内容保持本地，以及可读 artifacts 如何搭配 daemon-owned retrieval store。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

备份

备份与迁移

一起备份 Wenlan 的可读 artifacts 和 daemon data，并在信任 recall 前验证还原后的 runtime。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

配置

Wenlan 配置

配置 Wenlan spaces、MCP clients、daemon bind address、local paths、models 和 keys，不需要手动编辑 database。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

Config 变量

Environment Variables 环境变量

了解哪些 Wenlan environment variables 是一般 configuration、哪些只用于 development，以及哪些属于 eval 或 Windows repair paths。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

MCP 连接

连接 MCP Clients

从 Claude Code、Codex、Cursor、Claude Desktop、Gemini CLI 和其他 MCP clients 使用同一个本地 Wenlan memory layer。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 4 分钟阅读

Agents 管理

Agent Profiles 配置

检查写入 Wenlan 的 AI clients 和 local tools，并从 CLI 管理 source attribution、enabled state 和 trust。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 4 分钟阅读

修复

故障排查

修正常见 setup issues：daemon 未运行、MCP 未连上、Claude commands 缺失、stale context，以及 support escalation。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

诊断

诊断与 Issue 报告

求助前先跑正确 checks，分开 daemon problems 与 client problems，并只分享 redacted output。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 5 分钟阅读

常见问题

FAQ 常见问题

安装 Wenlan 前后常见 adoption questions 的短答案。

Qi-Xuan Lu · 更新于 2026 年 6 月 24 日 · 4 分钟阅读

项目

Security reporting、evaluation、desktop status、changelog、release/versioning、roadmap、project scope、source builds、testing、CI、development conventions，以及帮助判断 Wenlan 是否可信到值得采用或贡献的 contribution paths。

安全