Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

docs(concepts): clarify L0/L1 character budgets (#5690)

Zayn Jarvisddfd8b9b79b0
diff --git a/docs/en/concepts/03-context-layers.md b/docs/en/concepts/03-context-layers.md
index 50585e053..2048e723c 100644
--- a/docs/en/concepts/03-context-layers.md
+++ b/docs/en/concepts/03-context-layers.md
@@ -4,7 +4,7 @@ OpenViking uses abstracts and overviews to locate content, then loads the body w
## Overview
-| Layer | Name | Storage | Default body limit | Purpose |
+| Layer | Name | Storage | Default generated-body budget | Purpose |
| --- | --- | --- | --- | --- |
| **L0** | Abstract | `.abstract.md` in a directory | 256 characters | Vector retrieval, quick filtering |
| **L1** | Overview | `.overview.md` in a directory | 4000 characters | Rerank, content navigation |
@@ -14,7 +14,9 @@ L0 and L1 are **directory-level semantic sidecars**. They describe a directory;
L0 and L1 are normally generated together, but either one may exist independently. For example, `mkdir()` initially creates only L0: it uses the directory name as the default body when `description` is omitted, or the provided description otherwise. A directory with `.abstract.md` but no `.overview.md` is therefore valid. Reads and vector rebuilds process only the levels that actually exist.
-The body limits are configured by `semantic.abstract_max_chars` and `semantic.overview_max_chars`; the table shows their defaults. These limits apply to the Markdown body only and do not truncate sidecar metadata.
+For resource-directory summary generation, `semantic.abstract_max_chars` and `semantic.overview_max_chars` set character budgets; the table shows their defaults. The budgets apply to the generated Markdown body. Sidecar metadata is excluded.
+
+Truncation prefers complete sentences. If no sentence ends within the budget, it can retain the first complete sentence even when that sentence is longer. These settings therefore do not impose hard size limits on stored sidecars.
## L0: Abstract
diff --git a/docs/zh/concepts/03-context-layers.md b/docs/zh/concepts/03-context-layers.md
index fc7495821..678ba4d56 100644
--- a/docs/zh/concepts/03-context-layers.md
+++ b/docs/zh/concepts/03-context-layers.md
@@ -4,7 +4,7 @@ OpenViking 用摘要和概览定位内容,需要细节时再读取正文。这
## 概览
-| 层级 | 名称 | 存储形式 | 默认正文上限 | 用途 |
+| 层级 | 名称 | 存储形式 | 默认生成正文预算 | 用途 |
| --- | --- | --- | --- | --- |
| **L0** | 摘要 | 目录内的 `.abstract.md` | 256 字符 | 向量检索、快速过滤 |
| **L1** | 概览 | 目录内的 `.overview.md` | 4000 字符 | Rerank、内容导航 |
@@ -14,7 +14,9 @@ L0/L1 是**目录级语义 sidecar**。它们描述一个目录,不是为每
L0 和 L1 通常成对生成,但系统允许只存在其中一个。例如,`mkdir()` 会先创建 L0:未传入 `description` 时使用目录名作为默认正文,传入后使用该说明。因此只有 `.abstract.md` 的目录也是合法状态。读取和向量重建只处理实际存在的层级。
-正文上限由 `semantic.abstract_max_chars` 和 `semantic.overview_max_chars` 配置;上表是默认值。限制只作用于 Markdown 正文,不会截断 sidecar 元数据。
+资源目录摘要的生成预算按字符计算,由 `semantic.abstract_max_chars` 和 `semantic.overview_max_chars` 配置;上表是默认值。预算作用于生成的 Markdown 正文,不包含 sidecar 元数据。
+
+截断优先保留完整句子。如果预算内没有完整句子,可能保留首个完整句子,即使它超过预算。因此,这些配置不是已存储 sidecar 文件的大小硬上限。
## L0:摘要