Skip to content

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

docs(zh): rename 多写存储 to 主备存储 and 队列状态与完成语义 to 任务状态 (#5529)

Zayn Jarvis7e47957da87a
diff --git a/docs/.vitepress/docs-navigation.ts b/docs/.vitepress/docs-navigation.ts
index ebcc8768b..088cd0931 100644
--- a/docs/.vitepress/docs-navigation.ts
+++ b/docs/.vitepress/docs-navigation.ts
@@ -339,8 +339,8 @@ const conceptsSidebar = {
['11-multi-tenant.md', '多租户'],
['12-metrics.md', '监控指标'],
['13-privacy.md', '隐私配置'],
- ['14-multi-write-storage.md', '多写存储'],
- ['16-queue-lifecycle.md', '队列状态与完成语义']
+ ['14-multi-write-storage.md', '主备存储'],
+ ['16-queue-lifecycle.md', '任务状态']
]
},
{
@@ -432,7 +432,7 @@ const guidesSidebar = {
{
text: '存储与性能',
items: [
- ['13-multi-write-storage.md', '多写存储'],
+ ['13-multi-write-storage.md', '主备存储'],
['14-ragfs-cache.md', 'RAGFS 缓存'],
['15-snapshot.md', '快照管理'],
['16-cuvs.md', 'cuVS 向量检索']
diff --git a/docs/zh/api/07-system.md b/docs/zh/api/07-system.md
index b5ce70c24..614559f62 100644
--- a/docs/zh/api/07-system.md
+++ b/docs/zh/api/07-system.md
@@ -1,6 +1,6 @@
# 系统状态
-OpenViking 系统 API 提供健康检查、就绪检查、一致性检查和多写后端同步状态。组件级观测和 Prometheus 指标分别提供独立文档。
+OpenViking 系统 API 提供健康检查、就绪检查、一致性检查和主备后端同步状态。组件级观测和 Prometheus 指标分别提供独立文档。
## API 参考
@@ -145,7 +145,7 @@ ov --profile health
无参数。
**检查项说明**:
-- `agfs`: 包含文件系统访问和多写同步状态的嵌套检查结果
+- `agfs`: 包含文件系统访问和主备同步状态的嵌套检查结果
- `vectordb`: 向量数据库是否健康
- `api_key_manager`: API 密钥管理器是否已加载
- `embedding`: 启动时 Embedding provider 是否已初始化;不发起模型请求
@@ -412,7 +412,7 @@ ov system wait --timeout 60
### backend_sync_status()
-查询指定 Viking URI 子树在多写存储后端之间的同步状态。该接口要求 ROOT 或 ADMIN 权限。
+查询指定 Viking URI 子树在主备存储后端之间的同步状态。该接口要求 ROOT 或 ADMIN 权限。
**HTTP API**
@@ -456,7 +456,7 @@ ov system backend sync-status viking://resources
### backend_sync_retry()
-重试指定 URI 子树中尚未完成的多写后端同步工作。该接口要求 ROOT 或 ADMIN 权限。
+重试指定 URI 子树中尚未完成的主备后端同步工作。该接口要求 ROOT 或 ADMIN 权限。
**HTTP API**
@@ -499,7 +499,7 @@ ov system backend sync-retry viking://resources
`retried` 是本次重新调度的记录数,`failed` 是重试调度失败的记录数;具体后端可能附加额外诊断字段。
-公共 Python、TypeScript 和 Go SDK 当前没有多写后端同步方法,因此以上小节只展示 HTTP 和 CLI Tab。
+公共 Python、TypeScript 和 Go SDK 当前没有主备后端同步方法,因此以上小节只展示 HTTP 和 CLI Tab。
---
diff --git a/docs/zh/api/20-webdav.md b/docs/zh/api/20-webdav.md
index 5cddc92ae..215d1b65c 100644
--- a/docs/zh/api/20-webdav.md
+++ b/docs/zh/api/20-webdav.md
@@ -25,7 +25,7 @@ OpenViking Server 也提供了一个面向资源文件的精简 WebDAV 适配层
- 通过 WebDAV 覆盖已有文件时,会像 `write()` 一样刷新相关语义和向量。
- `PUT` 不会自动创建父目录。缺失的目录需要先用 `MKCOL` 创建。
- 用户自己创建的点目录或点文件仍然可见,只有上面列出的保留内部文件名会被隐藏。
-- 启用多写存储时,被 redirect 到 backup 的文件仍会通过文件系统 API 呈现为普通文件;内部 redirect 和同步元数据不会暴露给调用方。
+- 启用主备存储时,被 redirect 到 backup 的文件仍会通过文件系统 API 呈现为普通文件;内部 redirect 和同步元数据不会暴露给调用方。
## API 参考
diff --git a/docs/zh/concepts/05-storage.md b/docs/zh/concepts/05-storage.md
index f9a47f564..710c964e1 100644
--- a/docs/zh/concepts/05-storage.md
+++ b/docs/zh/concepts/05-storage.md
@@ -50,16 +50,16 @@ viking://~/skills → /local/{account_id}/user/{user_id}/skills
AGFS 提供 POSIX 风格的文件操作,支持多种后端。
-### 单后端与多写模式
+### 单后端与主备模式
-默认情况下,AGFS 使用一个后端作为内容存储。配置 `storage.agfs.backups` 后,OpenViking 会启用多写模式:
+默认情况下,AGFS 使用一个后端作为内容存储。配置 `storage.agfs.backups` 后,OpenViking 会启用主备模式:
- 顶层 `storage.agfs.backend` 是 primary,作为权威写入目标。
- `storage.agfs.backups.items[]` 是 backup,用于副本、迁移或读加速。
- Python SDK、HTTP API 和 CLI 的文件系统接口保持不变。
-- 多写内部使用 `.redirect.json` 和 `.sync_log.json` 维护 redirect 映射与同步进度,这些文件对用户不可见。
+- 主备存储内部使用 `.redirect.json` 和 `.sync_log.json` 维护 redirect 映射与同步进度,这些文件对用户不可见。
-更多概念说明见 [多写存储](./14-multi-write-storage.md),配置示例见 [多写存储指南](../guides/13-multi-write-storage.md)。
+更多概念说明见 [主备存储](./14-multi-write-storage.md),配置示例见 [主备存储指南](../guides/13-multi-write-storage.md)。
### 后端类型
@@ -158,5 +158,5 @@ client.mv(
- [架构概述](./01-architecture.md) - 系统整体架构
- [上下文层级](./03-context-layers.md) - L0/L1/L2 模型
- [Viking URI](./04-viking-uri.md) - URI 规范
-- [多写存储](./14-multi-write-storage.md) - primary/backup、多写路由与一致性
+- [主备存储](./14-multi-write-storage.md) - primary/backup、主备路由与一致性
- [检索机制](./07-retrieval.md) - 检索流程详解
diff --git a/docs/zh/concepts/10-encryption.md b/docs/zh/concepts/10-encryption.md
index 506ef1edd..276e3faaf 100644
--- a/docs/zh/concepts/10-encryption.md
+++ b/docs/zh/concepts/10-encryption.md
@@ -156,7 +156,7 @@ ov system crypto init-key --output-file ~/.openviking/master.key
## 加密范围
-这里保护的是启用了加密的文件后端。它不自动加密独立向量库、日志或导出的 OVPack;向量记录可能包含摘要和记忆正文。多写 backup 可单独关闭加密,部署时需要逐个检查后端配置。
+这里保护的是启用了加密的文件后端。它不自动加密独立向量库、日志或导出的 OVPack;向量记录可能包含摘要和记忆正文。主备存储的 backup 可单独关闭加密,部署时需要逐个检查后端配置。
## 配置示例
diff --git a/docs/zh/concepts/14-multi-write-storage.md b/docs/zh/concepts/14-multi-write-storage.md
index 29f2cd709..5464b5bb1 100644
--- a/docs/zh/concepts/14-multi-write-storage.md
+++ b/docs/zh/concepts/14-multi-write-storage.md
@@ -1,12 +1,12 @@
-# 多写存储
+# 主备存储
-多写存储让 OpenViking 在一个统一的文件系统抽象下,同时使用一个主存储和多个备份存储。它可用于保存副本(包括跨地域副本)、配置读路由和迁移存储;不会自动把 backup 提升为 primary。
+主备存储(multi-write)让 OpenViking 在一个统一的文件系统抽象下,同时使用一个主存储和多个备份存储。它可用于保存副本(包括跨地域副本)、配置读路由和迁移存储;不会自动把 backup 提升为 primary。
-从 API 使用者视角看,`read()`、`write()`、`ls()`、`stat()` 等接口不变。多写逻辑位于 RAGFS 内部,调用方不需要关心文件最终落在哪个底层后端。
+从 API 使用者视角看,`read()`、`write()`、`ls()`、`stat()` 等接口不变。主备存储逻辑位于 RAGFS 内部,调用方不需要关心文件最终落在哪个底层后端。
## 核心模型
-多写存储由一个 primary 和多个 backup 组成:
+主备存储由一个 primary 和多个 backup 组成:
| 角色 | 配置位置 | 说明 |
| --- | --- | --- |
@@ -31,16 +31,16 @@ backup 未配置 `operations` 时默认参与写入。这样可以用最少配
## 同步模式
-多写支持两种一致性模式。
+主备存储支持两种一致性模式。
| 模式 | 配置值 | 行为 | 适用场景 |
| --- | --- | --- | --- |
-| 异步多写 | `async` | primary 写成功后立即返回,backup 后台同步 | 低延迟写入、最终一致 |
-| 同步多写 | `sync` | primary 写成功后等待 backup 确认 | 更强写入确认、可接受额外延迟 |
+| 异步复制 | `async` | primary 写成功后立即返回,backup 后台同步 | 低延迟写入、最终一致 |
+| 同步复制 | `sync` | primary 写成功后等待 backup 确认 | 更强写入确认、可接受额外延迟 |
异步模式下,backup 可能落后于 primary,恢复时间取决于后端可用性和重试结果。同步模式下,可以通过 `write_ack_count` 和 `write_ack_timeout_ms` 控制需要等待多少 backup 确认,以及等待多久。
-同步模式未达到所需确认数时会返回错误,但 primary 可能已经写入成功,不会因此自动回滚。未确认的 backup 仍会在后台重试;同步状态的检查方法见[多写存储指南](../guides/13-multi-write-storage.md)。
+同步模式未达到所需确认数时会返回错误,但 primary 可能已经写入成功,不会因此自动回滚。未确认的 backup 仍会在后台重试;同步状态的检查方法见[主备存储指南](../guides/13-multi-write-storage.md)。
## 读取路径
@@ -83,7 +83,7 @@ Exclude 策略配置在 backup 上,只影响该 backup 是否接收写入。
## 内部元数据
-多写使用两个内部元数据文件:
+主备存储使用两个内部元数据文件:
| 文件 | 作用 |
| --- | --- |
@@ -96,7 +96,7 @@ Exclude 策略配置在 backup 上,只影响该 backup 是否接收写入。
## 加密关系
-多写不会改变 OpenViking 的透明加密模型。
+主备存储不会改变 OpenViking 的透明加密模型。
规则如下:
@@ -105,23 +105,23 @@ Exclude 策略配置在 backup 上,只影响该 backup 是否接收写入。
- backup 可以独立决定是否加密。
- 内部元数据必须走 primary 的加密入口。
-这意味着启用多写后,调用方式仍然不变;只需要通过配置决定每个 backend 的加密策略。
+这意味着启用主备存储后,调用方式仍然不变;只需要通过配置决定每个 backend 的加密策略。
## 与 OVPack 的关系
-多写只负责“启用之后的新写入”。它不会自动同步启用之前已经存在于 primary 中的历史文件。
+主备存储只负责“启用之后的新写入”。它不会自动同步启用之前已经存在于 primary 中的历史文件。
如果要迁移存量数据,推荐流程是:
1. 暂停写入或安排可核对的增量补齐窗口,再使用 OVPack 或其他受控方式迁移存量。
2. 校验目标 backend 数据。
-3. 启用多写配置。
-4. 补齐迁移期间的变更并验证同步状态后恢复写入;后续新增和修改由多写复制。
+3. 启用主备存储配置。
+4. 补齐迁移期间的变更并验证同步状态后恢复写入;后续新增和修改由主备存储复制。
## 限制
- 异步模式下 backup 可能落后;读取 backup 时不能假设已经看到最新写入。
-- 启用多写前的历史文件需要单独迁移或回填。
+- 启用主备存储前的历史文件需要单独迁移或回填。
- redirect 文件依赖内部元数据恢复目录视图。
- 多进程同时写同一 primary 时,需要未来的分布式元数据锁能力。
- 热点目录会频繁更新内部元数据,可能带来额外写放大。
@@ -130,5 +130,5 @@ Exclude 策略配置在 backup 上,只影响该 backup 是否接收写入。
- [存储架构](./05-storage.md)
- [配置指南](../guides/01-configuration.md)
-- [多写存储指南](../guides/13-multi-write-storage.md)
+- [主备存储指南](../guides/13-multi-write-storage.md)
- [OVPack 导入导出](../guides/09-ovpack.md)
diff --git a/docs/zh/concepts/16-queue-lifecycle.md b/docs/zh/concepts/16-queue-lifecycle.md
index ec7549a5a..638dfbb3f 100644
--- a/docs/zh/concepts/16-queue-lifecycle.md
+++ b/docs/zh/concepts/16-queue-lifecycle.md
@@ -1,4 +1,4 @@
-# 队列状态与完成语义
+# 任务状态
QueueFS 通过同一份后端状态快照判断队列是否完成:只有 `pending` 和 `processing` 都为零,队列才为空。仅检查待出队消息数不能证明处理已结束。
diff --git a/docs/zh/guides/01-configuration.md b/docs/zh/guides/01-configuration.md
index 345c0763b..5443a0069 100644
--- a/docs/zh/guides/01-configuration.md
+++ b/docs/zh/guides/01-configuration.md
@@ -1232,8 +1232,8 @@ Glob 引擎配置,用于路径模式匹配。这些设置为服务端配置,
|------|------|------|--------|
| `backend` | str | `"local"`、`"s3"` 或 `"memory"` | `"local"` |
| `timeout` | float | 请求超时时间(秒) | `10.0` |
-| `backups` | object | 多写存储配置。配置后顶层 `backend` 作为 primary,`backups.items[]` 作为 backup | `null` |
-| `redirects` | array | 多写存储的文件重定向策略。命中后文件写入指定 backup,而不是 primary | `[]` |
+| `backups` | object | 主备存储配置。配置后顶层 `backend` 作为 primary,`backups.items[]` 作为 backup | `null` |
+| `redirects` | array | 主备存储的文件重定向策略。命中后文件写入指定 backup,而不是 primary | `[]` |
| `queuefs` | object | QueueFS 配置。控制 `/queue` 的命名空间模式、后端和运行时参数 | `{ "mode": "shared", "backend": "sqlite", "recover_stale_sec": 0, "busy_timeout_ms": 5000 }` |
| `queue_db_path` | str(可选)| 旧版兼容字段,用于覆盖 QueueFS 的 sqlite 数据库文件路径。已被 `storage.agfs.queuefs.db_path` 取代。未设置时默认为 `{storage.workspace}/_system/queue/queue.db`。适用于 workspace 卷不支持 sqlite 的场景(例如某些网络文件系统) | `null` |
| `s3` | object | S3 后端配置(`backend=s3` 时使用) | - |
@@ -1246,9 +1246,9 @@ RAGFS 默认使用 Rust binding 模式,通过 Rust 实现直接访问文件系
> [!WARNING]
> `storage.agfs` 已不再支持 AGFS HTTP client 模式,也无需再配置旧的 HTTP client 入口。当前 AGFS / RAGFS 文件系统访问仅通过 Rust binding(`RAGFSBindingClient`)在进程内完成。这不影响 OpenViking server 的 HTTP API、`ov` CLI,或 `AsyncHTTPClient` / `SyncHTTPClient` 访问 OpenViking 服务端的能力。
-##### 多写存储配置
+##### 主备存储配置
-`storage.agfs.backups` 用于启用多写存储。未配置时,OpenViking 保持单 backend 模式。
+`storage.agfs.backups` 用于启用主备存储。未配置时,OpenViking 保持单 backend 模式。
```json
{
@@ -1289,7 +1289,7 @@ RAGFS 默认使用 Rust binding 模式,通过 Rust 实现直接访问文件系
| 参数 | 类型 | 说明 | 默认值 |
|------|------|------|--------|
-| `sync_type` | str | 多写同步模式,支持 `"async"` 或 `"sync"` | `"async"` |
+| `sync_type` | str | 主备同步模式,支持 `"async"` 或 `"sync"` | `"async"` |
| `write_ack_count` | int | `sync` 模式下返回前需要的 backup 确认数 | 全部 backup |
| `write_ack_timeout_ms` | int | `sync` 模式下等待 backup 确认的超时时间,单位毫秒 | `null` |
| `write_concurrency` | int | 异步 backup 写入并发上限 | `null` |
@@ -1320,7 +1320,7 @@ RAGFS 默认使用 Rust binding 模式,通过 Rust 实现直接访问文件系
- `target` 必须引用 `backups.items[]` 中已经定义的 backup `name`。
- 命中 redirect 的文件仍会通过普通文件系统 API 呈现为可读、可列举的文件。
-更多配置示例见 [多写存储指南](./13-multi-write-storage.md)。
+更多配置示例见 [主备存储指南](./13-multi-write-storage.md)。
##### 全局 Cache Provider、CacheFS 与 PathLock 配置
diff --git a/docs/zh/guides/08-encryption.md b/docs/zh/guides/08-encryption.md
index 582aa4157..44de897d9 100644
--- a/docs/zh/guides/08-encryption.md
+++ b/docs/zh/guides/08-encryption.md
@@ -13,18 +13,18 @@ OpenViking 可以按账户加密存储中新写入的文件。加解密由存储
加密功能的概念说明见 [数据加密](../concepts/10-encryption.md)。
-## 多写存储中的加密
+## 主备存储中的加密
-多写存储复用同一套透明加密机制。加密仍在 RAGFS 内部完成,Python SDK、HTTP API 和 CLI 不需要处理加解密。
+主备存储复用同一套透明加密机制。加密仍在 RAGFS 内部完成,Python SDK、HTTP API 和 CLI 不需要处理加解密。
规则:
- 全局 `encryption.enabled=true` 时,primary backend 必须加密。
- backup backend 可以通过自己的 `encryption.enabled` 控制是否加密。
-- `.redirect.json` 和 `.sync_log.json` 等多写内部元数据跟随 primary 加密策略。
+- `.redirect.json` 和 `.sync_log.json` 等主备存储内部元数据跟随 primary 加密策略。
- OpenViking 不提供也不需要公开的加解密 API 来操作这些内部文件。
-更多多写配置见 [多写存储指南](./13-multi-write-storage.md)。
+更多主备存储配置见 [主备存储指南](./13-multi-write-storage.md)。
## 快速开始
diff --git a/docs/zh/guides/09-ovpack.md b/docs/zh/guides/09-ovpack.md
index 55230c314..a611267db 100644
--- a/docs/zh/guides/09-ovpack.md
+++ b/docs/zh/guides/09-ovpack.md
@@ -31,13 +31,13 @@ Session 通过 user 命名空间一起迁移,路径为
`temp`、`queue`、`upload`、锁文件、watch control 文件、`.relations.json` 等内部或运行态数据
不属于 OVPack 迁移范围。
-## 与多写存储配合
+## 与主备存储配合
-多写存储只复制启用之后的新写入,不会自动同步启用之前已经存在的历史文件。如需同时为 primary 和副本写入存量,应在**空目标环境恢复之前**启用多写:
+主备存储只复制启用之后的新写入,不会自动同步启用之前已经存在的历史文件。如需同时为 primary 和副本写入存量,应在**空目标环境恢复之前**启用主备存储:
1. 暂停业务写入,按源 account 分别导出或备份。
2. 配置目标 primary、backup backend 及其写策略,启动目标服务并创建恢复身份。
-3. 通过该服务恢复或导入,使存量内容经过已配置的多写分发。
+3. 通过该服务恢复或导入,使存量内容经过已配置的主备复制分发。
4. 对每个恢复的 scope 检查同步状态,并在切流前验证各副本中的文件。恢复返回时,异步复制仍可能未完成。
5. 验证内容和索引完整性后再恢复业务写入;验证完成前保留源数据和备份。
@@ -50,7 +50,7 @@ ov system backend sync-status viking://user
先恢复再启用 backups 只会复制后续写入,不能把历史内容补到副本。
-更多说明见 [多写存储指南](./13-multi-write-storage.md)。
+更多说明见 [主备存储指南](./13-multi-write-storage.md)。
## 快速开始
diff --git a/docs/zh/guides/13-multi-write-storage.md b/docs/zh/guides/13-multi-write-storage.md
index 5f95c0de3..14d5e2dc1 100644
--- a/docs/zh/guides/13-multi-write-storage.md
+++ b/docs/zh/guides/13-multi-write-storage.md
@@ -1,15 +1,15 @@
-# 多写存储指南
+# 主备存储指南
-本指南介绍如何配置 OpenViking 的多写存储能力。多写存储允许一个 primary 后端同时复制写入多个 backup 后端,用于保存副本(包括跨地域副本)、配置读路由和存储迁移。primary 故障时不会自动提升 backup。
+本指南介绍如何配置 OpenViking 的主备存储能力。主备存储允许一个 primary 后端同时复制写入多个 backup 后端,用于保存副本(包括跨地域副本)、配置读路由和存储迁移。primary 故障时不会自动提升 backup。
-多写能力位于 RAGFS 内部。OpenViking 的 Python SDK、HTTP API 和 CLI 使用方式保持不变。
+主备存储能力位于 RAGFS 内部。OpenViking 的 Python SDK、HTTP API 和 CLI 使用方式保持不变。
## 前置条件
- 已有可用的 `ov.conf`。
- 已确认 primary backend 可以正常读写。
- 如果要接入 S3 兼容存储,已准备好 bucket、endpoint 和访问凭据。
-- 如需迁移已有数据,请遵循 [OVPack 多写迁移流程](./09-ovpack.md#与多写存储配合);仅启用 backups 不会复制历史文件。
+- 如需迁移已有数据,请遵循 [OVPack 主备存储迁移流程](./09-ovpack.md#与主备存储配合);仅启用 backups 不会复制历史文件。
## 最小配置
@@ -220,7 +220,7 @@ backup 默认不参与读取。要让 backup 服务读取,需要显式配置 `
- primary 始终作为最终兜底。
- 冷备 backup 不建议配置读能力。
-如果一个 backup 只配置了 `read`,没有配置 `write`,它不会接收普通多写复制。只有在你明确知道该 backend 的数据来源时,才应使用这种配置。
+如果一个 backup 只配置了 `read`,没有配置 `write`,它不会接收普通复制写入。只有在你明确知道该 backend 的数据来源时,才应使用这种配置。
## Redirect 配置
@@ -304,7 +304,7 @@ Exclude 用于让某个 backup 跳过匹配文件。
## 加密配置
-多写存储复用 OpenViking 的透明静态加密能力。
+主备存储复用 OpenViking 的透明静态加密能力。
全局加密开启示例:
@@ -356,9 +356,9 @@ Exclude 用于让某个 backup 跳过匹配文件。
## 存量数据迁移
-多写只复制启用之后的新写入,不会自动复制历史文件。
+主备存储只复制启用之后的新写入,不会自动复制历史文件。
-使用 OVPack 迁移时,请遵循 [与多写存储配合](./09-ovpack.md#与多写存储配合):先在干净目标配置多写,再通过该服务恢复,验证各副本后恢复业务写入。目标 account 初始化和恢复冲突处理也在该流程中说明。
+使用 OVPack 迁移时,请遵循 [与主备存储配合](./09-ovpack.md#与主备存储配合):先在干净目标配置主备存储,再通过该服务恢复,验证各副本后恢复业务写入。目标 account 初始化和恢复冲突处理也在该流程中说明。
## 验证配置
@@ -397,9 +397,9 @@ backup 默认只参与写入,不参与读取。需要在 backup 上显式配
}
```
-### 为什么启用多写后历史文件没有出现在 backup?
+### 为什么启用主备存储后历史文件没有出现在 backup?
-多写只处理启用后的新写入。历史文件请按 [OVPack 迁移流程](./09-ovpack.md#与多写存储配合) 处理;启用 backups 不会自动补齐。
+主备存储只处理启用后的新写入。历史文件请按 [OVPack 迁移流程](./09-ovpack.md#与主备存储配合) 处理;启用 backups 不会自动补齐。
### 异步模式下能否保证立即读到 backup 的最新数据?
@@ -415,7 +415,7 @@ backup 默认只参与写入,不参与读取。需要在 backup 上显式配
## 相关文档
-- [多写存储](../concepts/14-multi-write-storage.md)
+- [主备存储](../concepts/14-multi-write-storage.md)
- [存储架构](../concepts/05-storage.md)
- [配置指南](./01-configuration.md)
- [加密指南](./08-encryption.md)
diff --git a/docs/zh/guides/15-snapshot.md b/docs/zh/guides/15-snapshot.md
index d08456fd1..a96e2b28f 100644
--- a/docs/zh/guides/15-snapshot.md
+++ b/docs/zh/guides/15-snapshot.md
@@ -359,4 +359,4 @@ curl -X DELETE "http://localhost:1933/api/v1/snapshot/ignore" \
- [多版本管理 API](../api/11-snapshot.md):命令参数与响应的完整参考
- [配置说明](01-configuration.md):`ov.conf` 完整配置项
-- [多写存储指南](13-multi-write-storage.md):资源数据的多后端复制
+- [主备存储指南](13-multi-write-storage.md):资源数据的多后端复制