Skip to content

Retrieval

Advanced Retrieval Status

Understand Wenlan's shipped retrieval path and the opt-in main-branch experiments behind newer retrieval work.

Qi-Xuan LuUpdated 6 min read

At a glance

01

The stable public path is hybrid retrieval over embeddings, FTS5, pages, and graph context.

02

Recent main-branch PRs add many opt-in retrieval experiments; treat them as evaluation work until a release promotes them.

01

Stable retrieval path

Wenlan's released retrieval combines vector embeddings, FTS5 full-text search, graph context, pages, and Reciprocal Rank Fusion. The goal is not a single magic ranking signal; it is a compact context bundle that helps the next AI session continue work.

The public README snapshot reports retrieval metrics, not end-to-end answer quality. Read the evaluation page before using the numbers in comparisons.

02

Pages are part of retrieval

Wenlan treats distilled pages as retrieval surfaces, not only as human-readable notes. That matters because repeated project context often becomes clearer as a page than as isolated captures.

A useful recall can include atomic memories, source-backed pages, graph neighbors, and decisions. The best result set is the one that gives the agent enough context without replaying a full chat history.

03

Opt-in main-branch work

Recent retrieval work includes a large opt-in batch. Examples include graph gates, temporal filters, query-adaptive routing, FTS hardening, session diversity, salience priors, episode and fact channels, PRF rounds, k-hop graph traversal, global preludes, CoT retrieval, LLM routing, and context compression.

These flags are useful for development and evaluation, but they should not be described as default product behavior until the release notes say so.

Example opt-in flags

WENLAN_ENABLE_GRAPH_GATE
WENLAN_ENABLE_GRAPH_SEED
WENLAN_ENABLE_TEMPORAL_FILTER
WENLAN_ENABLE_QUERY_INTENT
WENLAN_MAGNITUDE_FUSION
WENLAN_ENABLE_FTS_HARDENING
WENLAN_ENABLE_SESSION_DIVERSITY
WENLAN_ENABLE_SALIENCE_PRIOR
WENLAN_ENABLE_EPISODE_CHANNEL
WENLAN_ENABLE_FACT_CHANNEL
WENLAN_PRF_ROUNDS
WENLAN_ENABLE_GRAPH_KHOP
WENLAN_ENABLE_GLOBAL_PRELUDE
WENLAN_ENABLE_COT_RETRIEVAL
WENLAN_LLM_ROUTE
WENLAN_ENABLE_CONTEXT_COMPRESS

04

How to read experiments

A retrieval experiment can improve one benchmark slice and hurt another. Wenlan's eval discipline is deliberately conservative: compare under the same schema, fixture revision, embedder, and run protocol.

When a feature is opt-in, the docs should say which problem it targets and which release status it has instead of implying it is the normal user path.

05

When to care

Most users should care about whether /brief, context, and recall bring the right project facts forward. Maintainers should care about benchmark slices, regression guards, and whether new retrieval work reduces real cold starts.

If recall feels weak, first improve the query and capture quality. Then distill repeated topics into pages before reaching for experimental retrieval flags.

Next

Experimental Flags

How to read Wenlan's opt-in main-branch flags without mistaking them for released defaults.

Read next