chore(i18n): refresh zh-CN translations

2026-05-02 05:36:07 +00:00 · 2026-05-02 05:36:07 +00:00 · 1bdfb73f01
commit 1bdfb73f01
parent d5281d8755
3 changed files with 172 additions and 194 deletions
--- a/docs/zh-CN/cli/sessions.md
+++ b/docs/zh-CN/cli/sessions.md
@ -1,13 +1,13 @@
 ---
 read_when:
-    - 你想列出已存储的会话并查看最近活动
-summary: CLI 参考：`openclaw sessions`（列出已存储会话 + 用法）
+    - 你想列出已存储的会话并查看近期活动
+summary: 用于 `openclaw sessions` 的 CLI 参考（列出已存储的会话 + 用法）
 title: 会话
 x-i18n:
-    generated_at: "2026-04-28T22:44:18Z"
+    generated_at: "2026-05-02T05:34:56Z"
    model: gpt-5.5
    provider: openai
-    source_hash: 9fea2014f538b00a27fa0078391a421843052333c5bcfc8100fced515eed0004
+    source_hash: 4e7e5017ba5a6194ac10d3a18ea9b711da57bc2ef1696776622cd3be2a2fbf43
    source_path: cli/sessions.md
    workflow: 16
 ---
@ -40,9 +40,9 @@ openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:12
 openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json
 ```

-这是所有者批准 exec 请求后，`/export-trajectory` 斜杠命令使用的命令路径。输出目录始终解析到所选工作区下的 `.openclaw/trajectory-exports/` 内。
+这是所有者批准 exec 请求后，`/export-trajectory` 斜杠命令使用的命令路径。输出目录始终会解析到所选工作区下的 `.openclaw/trajectory-exports/` 内。

-`openclaw sessions --all-agents` 会读取已配置的智能体存储。Gateway 网关和 ACP 会话发现范围更广：它们还会包括在默认 `agents/` 根目录或模板化 `session.store` 根目录下找到的仅磁盘存储。这些已发现的存储必须解析为智能体根目录内的常规 `sessions.json` 文件；符号链接和根目录外路径会被跳过。
+`openclaw sessions --all-agents` 会读取已配置的智能体存储。Gateway 网关和 ACP 会话发现的范围更广：它们还会包括在默认 `agents/` 根目录或模板化 `session.store` 根目录下找到的仅磁盘存储。这些发现的存储必须解析为智能体根目录内的常规 `sessions.json` 文件；符号链接和根目录外路径会被跳过。

 JSON 示例：

@ -67,7 +67,7 @@ JSON 示例：

 ## 清理维护

-立即运行维护（而不是等待下一个写入周期）：
+立即运行维护（而不是等待下一次写入周期）：

 ```bash
 openclaw sessions cleanup --dry-run
@ -80,15 +80,15 @@ openclaw sessions cleanup --json

 `openclaw sessions cleanup` 使用配置中的 `session.maintenance` 设置：

- 范围说明：`openclaw sessions cleanup` 维护会话存储、转录记录和轨迹 sidecar。它不会清理 cron 运行日志（`cron/runs/<jobId>.jsonl`），这些日志由 [Cron 配置](/zh-CN/automation/cron-jobs#configuration)中的 `cron.runLog.maxBytes` 和 `cron.runLog.keepLines` 管理，并在 [Cron 维护](/zh-CN/automation/cron-jobs#maintenance)中说明。
+- 范围说明：`openclaw sessions cleanup` 维护会话存储、转录和轨迹旁车文件。它不会修剪 cron 运行日志（`cron/runs/<jobId>.jsonl`），这些日志由 [Cron 配置](/zh-CN/automation/cron-jobs#configuration)中的 `cron.runLog.maxBytes` 和 `cron.runLog.keepLines` 管理，并在 [Cron 维护](/zh-CN/automation/cron-jobs#maintenance)中说明。

- `--dry-run`：预览会被清理/限制的条目数量，不写入。
-  - 在文本模式下，dry-run 会打印每个会话的操作表（`Action`、`Key`、`Age`、`Model`、`Flags`），这样你可以看到哪些会被保留、哪些会被移除。
+- `--dry-run`：预览在不写入的情况下会修剪/封顶多少条目。
+  - 在文本模式中，dry-run 会打印按会话列出的操作表（`Action`、`Key`、`Age`、`Model`、`Flags`），以便你查看哪些会保留、哪些会移除。
 - `--enforce`：即使 `session.maintenance.mode` 为 `warn`，也应用维护。
- `--fix-missing`：移除转录文件缺失的条目，即使它们通常尚未达到按时间/数量清理的条件。
- `--active-key <key>`：保护指定活跃键，避免因磁盘预算驱逐。
- `--agent <id>`：对一个已配置的智能体存储运行清理。
- `--all-agents`：对所有已配置的智能体存储运行清理。
+- `--fix-missing`：移除转录文件缺失的条目，即使它们通常还不会因年龄/数量被清理。
+- `--active-key <key>`：保护特定活动键不因磁盘预算驱逐而被移除。持久的外部对话指针（例如群组会话和按线程限定的聊天会话）也会在按年龄/数量/磁盘预算维护时保留。
+- `--agent <id>`：为一个已配置的智能体存储运行清理。
+- `--all-agents`：为所有已配置的智能体存储运行清理。
 - `--store <path>`：针对特定 `sessions.json` 文件运行。
 - `--json`：打印 JSON 摘要。使用 `--all-agents` 时，输出会包含每个存储的一份摘要。

--- a/docs/zh-CN/concepts/session.md
+++ b/docs/zh-CN/concepts/session.md
@ -2,19 +2,19 @@
 read_when:
    - 你想了解会话路由和隔离
    - 你想为多用户设置配置私信范围
-    - 你正在调试每日或空闲会话重置
+    - 你正在调试每日或空闲会话重置问题
 summary: OpenClaw 如何管理对话会话
 title: 会话管理
 x-i18n:
-    generated_at: "2026-05-01T12:19:23Z"
+    generated_at: "2026-05-02T05:35:02Z"
    model: gpt-5.5
    provider: openai
-    source_hash: f1bde2ab8f1589ed477df959aecf59c282bb086bfe93159397252021a1d6393b
+    source_hash: b2fd0c9e880242a8d0070c24bd1f7971e4082344240e28632e2e3ca032404807
    source_path: concepts/session.md
    workflow: 16
 ---

-OpenClaw 将对话组织为**会话**。每条消息都会根据来源路由到一个会话 -- 私信、群聊、cron 作业等。
+OpenClaw 将对话组织为**会话**。每条消息都会根据来源路由到一个会话 -- 私信、群聊、cron 任务等。

 ## 消息如何路由

@ -23,18 +23,18 @@ OpenClaw 将对话组织为**会话**。每条消息都会根据来源路由到
 | 直接消息 | 默认共享会话 |
 | 群聊     | 按群组隔离        |
 | 房间/渠道  | 按房间隔离         |
-| Cron 作业       | 每次运行使用新会话     |
-| Webhook        | 按 hook 隔离         |
+| Cron 任务       | 每次运行使用新会话     |
+| 网络钩子        | 按钩子隔离         |

 ## 私信隔离

 默认情况下，所有私信共享一个会话以保持连续性。这适合单用户设置。

 <Warning>
-如果多个人可以给你的智能体发消息，请启用私信隔离。否则，所有用户会共享同一个对话上下文 -- Alice 的私信会对 Bob 可见。
+如果多个人可以向你的智能体发消息，请启用私信隔离。否则，所有用户都会共享同一个对话上下文 -- Alice 的私密消息会对 Bob 可见。
 </Warning>

-**修复方法：**
+**修复方式：**

 ```json5
 {
@ -52,12 +52,12 @@ OpenClaw 将对话组织为**会话**。每条消息都会根据来源路由到
 - `per-account-channel-peer` -- 按账号 + 渠道 + 发送者隔离。

 <Tip>
-如果同一个人通过多个渠道联系你，请使用 `session.identityLinks` 关联他们的身份，让他们共享同一个会话。
+如果同一个人通过多个渠道联系你，请使用 `session.identityLinks` 链接他们的身份，让他们共享一个会话。
 </Tip>

-### 停靠已关联渠道
+### 停靠已链接渠道

-停靠命令允许用户将当前直接聊天会话的回复路由移动到另一个已关联渠道，而无需启动新会话。示例、配置和故障排除请参阅[渠道停靠](/zh-CN/concepts/channel-docking)。
+停靠命令允许用户将当前直接聊天会话的回复路由移动到另一个已链接渠道，而无需启动新会话。示例、配置和故障排除见[渠道停靠](/zh-CN/concepts/channel-docking)。

 使用 `openclaw security audit` 验证你的设置。

@ -65,32 +65,32 @@ OpenClaw 将对话组织为**会话**。每条消息都会根据来源路由到

 会话会被复用，直到过期：

- **每日重置**（默认）-- 在 Gateway 网关主机本地时间凌晨 4:00 创建新会话。每日新鲜度基于当前 `sessionId` 的开始时间，而不是之后的元数据写入时间。
- **空闲重置**（可选）-- 在一段时间无活动后创建新会话。设置 `session.reset.idleMinutes`。空闲新鲜度基于上一次真实用户/渠道交互，因此 heartbeat、cron 和 exec 系统事件不会让会话保持活跃。
+- **每日重置**（默认）-- 在 Gateway 网关主机本地时间凌晨 4:00 创建新会话。每日新鲜度基于当前 `sessionId` 的开始时间，而不是后续元数据写入时间。
+- **空闲重置**（可选）-- 在一段时间无活动后创建新会话。设置 `session.reset.idleMinutes`。空闲新鲜度基于最后一次真实的用户/渠道交互，因此 Heartbeat、cron 和 exec 系统事件不会让会话保持存活。
 - **手动重置** -- 在聊天中输入 `/new` 或 `/reset`。`/new <model>` 还会切换模型。

-如果同时配置了每日重置和空闲重置，先过期的规则生效。Heartbeat、cron、exec 和其他系统事件轮次可能会写入会话元数据，但这些写入不会延长每日或空闲重置的新鲜度。当重置滚动到新会话时，旧会话中排队的系统事件通知会被丢弃，避免过期的后台更新被前置到新会话的第一个提示词中。
+同时配置每日重置和空闲重置时，先过期的规则生效。Heartbeat、cron、exec 和其他系统事件轮次可能会写入会话元数据，但这些写入不会延长每日或空闲重置的新鲜度。重置滚动到新会话时，旧会话中排队的系统事件通知会被丢弃，避免过期的后台更新被前置到新会话的第一个提示中。

-具有活跃的提供商拥有的 CLI 会话的会话，不会被隐式的每日默认规则截断。当这些会话应按计时器过期时，请使用 `/reset` 或显式配置 `session.reset`。
+带有活跃提供商自有 CLI 会话的会话不会被隐式每日默认值切断。当这些会话应按定时器过期时，请使用 `/reset` 或显式配置 `session.reset`。

 ## 状态存储位置

 所有会话状态都由 **Gateway 网关**拥有。UI 客户端会向 Gateway 网关查询会话数据。

 - **存储：** `~/.openclaw/agents/<agentId>/sessions/sessions.json`
- **转录记录：** `~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`
+- **转录：** `~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`

-`sessions.json` 会保存独立的生命周期时间戳：
+`sessions.json` 保留独立的生命周期时间戳：

- `sessionStartedAt`：当前 `sessionId` 开始的时间；每日重置使用此值。
- `lastInteractionAt`：上一次延长空闲生命周期的用户/渠道交互时间。
- `updatedAt`：上一次存储行变更时间；可用于列表展示和清理，但不是每日/空闲重置新鲜度的权威依据。
+- `sessionStartedAt`：当前 `sessionId` 开始的时间；每日重置使用它。
+- `lastInteractionAt`：最后一次延长空闲生命周期的用户/渠道交互。
+- `updatedAt`：最后一次存储行变更；对列表展示和修剪很有用，但不是每日/空闲重置新鲜度的权威依据。

-没有 `sessionStartedAt` 的旧行会在可用时从转录记录 JSONL 会话头中解析。如果旧行也缺少 `lastInteractionAt`，空闲新鲜度会回退到该会话开始时间，而不是之后的记账写入时间。
+没有 `sessionStartedAt` 的旧行会在可用时从转录 JSONL 会话头解析。如果旧行也缺少 `lastInteractionAt`，空闲新鲜度会回退到该会话开始时间，而不是后续簿记写入时间。

 ## 会话维护

-OpenClaw 会随时间自动限制会话存储。默认情况下，它以 `warn` 模式运行（报告将会清理的内容）。将 `session.maintenance.mode` 设置为 `"enforce"` 可启用自动清理：
+OpenClaw 会随时间自动限制会话存储。默认情况下，它以 `warn` 模式运行（报告本会清理的内容）。将 `session.maintenance.mode` 设为 `"enforce"` 可启用自动清理：

 ```json5
 {
@ -104,29 +104,31 @@ OpenClaw 会随时间自动限制会话存储。默认情况下，它以 `warn`
 }
 ```

-对于生产规模的 `maxEntries` 限制，Gateway 网关运行时写入会使用一个较小的高水位缓冲区，并分批清理回配置的上限。会话存储读取不会在 Gateway 网关启动期间修剪或限制条目。这避免了每次启动或隔离的 cron 会话都运行完整存储清理。`openclaw sessions cleanup --enforce` 会立即应用该上限。
+对于生产规模的 `maxEntries` 限制，Gateway 网关运行时写入会使用一个小型高水位缓冲区，并分批清理回配置的上限。会话存储读取不会在 Gateway 网关启动期间修剪或限制条目。这样可以避免每次启动或隔离的 cron 会话都运行完整存储清理。`openclaw sessions cleanup --enforce` 会立即应用上限。
+
+维护会保留持久的外部对话指针，包括群组会话和线程范围聊天会话，同时仍允许合成的 cron、钩子、Heartbeat、ACP 和子智能体条目老化淘汰。

 使用 `openclaw sessions cleanup --dry-run` 预览。

 ## 检查会话

- `openclaw status` -- 会话存储路径和最近活动。
- `openclaw sessions --json` -- 所有会话（用 `--active <minutes>` 过滤）。
- 聊天中的 `/status` -- 上下文使用情况、模型和开关。
- `/context list` -- 系统提示词中的内容。
+- `openclaw status` -- 会话存储路径和近期活动。
+- `openclaw sessions --json` -- 所有会话（使用 `--active <minutes>` 过滤）。
+- 聊天中的 `/status` -- 上下文使用量、模型和开关。
+- `/context list` -- 系统提示中的内容。

 ## 延伸阅读

- [会话修剪](/zh-CN/concepts/session-pruning) -- 修剪工具结果
+- [会话修剪](/zh-CN/concepts/session-pruning) -- 裁剪工具结果
 - [压缩](/zh-CN/concepts/compaction) -- 总结长对话
 - [会话工具](/zh-CN/concepts/session-tool) -- 用于跨会话工作的智能体工具
- [会话管理深入解析](/zh-CN/reference/session-management-compaction) --
-  存储架构、转录记录、发送策略、来源元数据和高级配置
+- [会话管理深度解析](/zh-CN/reference/session-management-compaction) --
+  存储架构、转录、发送策略、来源元数据和高级配置
 - [多智能体](/zh-CN/concepts/multi-agent) — 跨智能体的路由和会话隔离
 - [后台任务](/zh-CN/automation/tasks) — 分离式工作如何创建带有会话引用的任务记录
 - [渠道路由](/zh-CN/channels/channel-routing) — 入站消息如何路由到会话

-## 相关内容
+## 相关

 - [会话修剪](/zh-CN/concepts/session-pruning)
 - [会话工具](/zh-CN/concepts/session-tool)
--- a/docs/zh-CN/reference/session-management-compaction.md
+++ b/docs/zh-CN/reference/session-management-compaction.md
@ -1,45 +1,45 @@
 ---
 read_when:
-    - 你需要调试会话 ID、对话记录 JSONL 或 sessions.json 字段
-    - 你正在更改自动压缩行为或添加“预压缩”清理维护
+    - 你需要调试会话 ID、转录 JSONL 或 sessions.json 字段
+    - 你正在更改自动压缩行为，或添加“预压缩”清理工作
    - 你想实现记忆刷新或静默系统轮次
 summary: 深入解析：会话存储 + 对话记录、生命周期和（自动）压缩内部机制
 title: 会话管理深入解析
 x-i18n:
-    generated_at: "2026-05-01T12:19:32Z"
+    generated_at: "2026-05-02T05:35:09Z"
    model: gpt-5.5
    provider: openai
-    source_hash: efd2fb5157a98cb406c5210d813fa600259dfc559350010a9c070075ac6b28ed
+    source_hash: 6f5d8b072feb389d7161fb2fa0fcd0941edb79b8b0f7ddd841877158795c2895
    source_path: reference/session-management-compaction.md
    workflow: 16
 ---

-OpenClaw 跨以下领域端到端管理会话：
+OpenClaw 端到端管理以下领域的会话：

 - **会话路由**（入站消息如何映射到 `sessionKey`）
- **会话存储**（`sessions.json`）及其跟踪内容
- **对话记录持久化**（`*.jsonl`）及其结构
- **对话记录卫生处理**（运行前进行提供商特定的修正）
- **上下文限制**（上下文窗口与已跟踪 token）
- **压缩**（手动和自动压缩）以及在何处挂接预压缩工作
- **静默内务处理**（不应产生用户可见输出的记忆写入）
+- **会话存储**（`sessions.json`）及其跟踪的内容
+- **会话记录持久化**（`*.jsonl`）及其结构
+- **会话记录整理**（运行前的提供商特定修正）
+- **上下文限制**（上下文窗口与跟踪的 token）
+- **压缩**（手动压缩和自动压缩）以及在何处挂接压缩前工作
+- **静默维护**（不应产生用户可见输出的记忆写入）

-如果你想先了解更高层概览，请从这里开始：
+如果你想先了解更高层次的概览，请从这里开始：

 - [会话管理](/zh-CN/concepts/session)
 - [压缩](/zh-CN/concepts/compaction)
 - [记忆概览](/zh-CN/concepts/memory)
 - [记忆搜索](/zh-CN/concepts/memory-search)
- [会话修剪](/zh-CN/concepts/session-pruning)
- [对话记录卫生处理](/zh-CN/reference/transcript-hygiene)
+- [会话清理](/zh-CN/concepts/session-pruning)
+- [会话记录整理](/zh-CN/reference/transcript-hygiene)

 ---

 ## 权威来源：Gateway 网关

-OpenClaw 围绕拥有会话状态的单个 **Gateway 网关进程**设计。
+OpenClaw 的设计围绕一个拥有会话状态的单一 **Gateway 网关进程**。

- UI（macOS 应用、Web Control UI、TUI）应向 Gateway 网关查询会话列表和 token 计数。
+- UI（macOS 应用、Web 控制 UI、TUI）应向 Gateway 网关查询会话列表和 token 计数。
 - 在远程模式下，会话文件位于远程主机上；“检查你的本地 Mac 文件”不会反映 Gateway 网关正在使用的内容。

 ---
@ -51,50 +51,52 @@ OpenClaw 在两个层中持久化会话：
 1. **会话存储（`sessions.json`）**
   - 键/值映射：`sessionKey -> SessionEntry`
   - 小型、可变、可安全编辑（或删除条目）
-   - 跟踪会话元数据（当前会话 ID、最近活动、开关、token 计数器等）
+   - 跟踪会话元数据（当前会话 id、最后活动时间、开关、token 计数器等）

-2. **对话记录（`<sessionId>.jsonl`）**
-   - 带树结构的追加式对话记录（条目包含 `id` + `parentId`）
+2. **会话记录（`<sessionId>.jsonl`）**
+   - 仅追加的树结构会话记录（条目包含 `id` + `parentId`）
   - 存储实际对话 + 工具调用 + 压缩摘要
-   - 用于为后续轮次重建模型上下文
-   - 一旦活动对话记录超过检查点大小上限，就会跳过大型预压缩调试检查点，避免生成第二份巨大的 `.checkpoint.*.jsonl` 副本。
+   - 用于为未来轮次重建模型上下文
+   - 一旦活跃会话记录超过检查点大小上限，就会跳过大型压缩前调试检查点，避免再生成一份巨大的 `.checkpoint.*.jsonl` 副本。

 ---

 ## 磁盘位置

-每个智能体在 Gateway 网关主机上：
+每个智能体，在 Gateway 网关主机上：

 - 存储：`~/.openclaw/agents/<agentId>/sessions/sessions.json`
- 对话记录：`~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`
+- 会话记录：`~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl`
  - Telegram 话题会话：`.../<sessionId>-topic-<threadId>.jsonl`

-OpenClaw 通过 `src/config/sessions.ts` 解析这些路径。
+OpenClaw 通过 `src/config/sessions.ts` 解析这些位置。

 ---

 ## 存储维护和磁盘控制

-会话持久化对 `sessions.json`、对话记录产物和轨迹附属文件提供自动维护控制（`session.maintenance`）：
+会话持久化为 `sessions.json`、会话记录产物和轨迹旁车文件提供自动维护控制（`session.maintenance`）：

 - `mode`：`warn`（默认）或 `enforce`
- `pruneAfter`：过期条目年龄截止值（默认 `30d`）
+- `pruneAfter`：过时条目的年龄截止值（默认 `30d`）
 - `maxEntries`：`sessions.json` 中的条目上限（默认 `500`）
- `resetArchiveRetention`：`*.reset.<timestamp>` 对话记录归档的保留期（默认：与 `pruneAfter` 相同；`false` 禁用清理）
+- `resetArchiveRetention`：`*.reset.<timestamp>` 会话记录归档的保留时间（默认：与 `pruneAfter` 相同；`false` 禁用清理）
 - `maxDiskBytes`：可选的会话目录预算
 - `highWaterBytes`：清理后的可选目标值（默认是 `maxDiskBytes` 的 `80%`）

-正常 Gateway 网关写入会对生产规模上限批量执行 `maxEntries` 清理，因此在下一次高水位清理将存储重写回上限以内之前，存储可能会短暂超过配置的上限。Gateway 网关启动期间，会话存储读取不会修剪或限制条目；请使用写入或 `openclaw sessions cleanup --enforce` 进行清理。`openclaw sessions cleanup --enforce` 仍会立即应用配置的上限。
+正常的 Gateway 网关写入会按生产规模上限批量执行 `maxEntries` 清理，因此在下一次高水位清理把存储重写回上限以下之前，存储可能会短暂超过配置的上限。会话存储读取不会在 Gateway 网关启动期间清理或限制条目数量；使用写入或 `openclaw sessions cleanup --enforce` 进行清理。`openclaw sessions cleanup --enforce` 仍会立即应用配置的上限。

-OpenClaw 不再在 Gateway 网关写入期间创建自动 `sessions.json.bak.*` 轮转备份。旧版 `session.maintenance.rotateBytes` 键会被忽略，`openclaw doctor --fix` 会将其从旧配置中移除。
+维护会保留持久的外部对话指针，例如群组会话和按线程限定的聊天会话，但 cron、钩子、Heartbeat、ACP 和子智能体的合成运行时条目在超过配置的年龄、数量或磁盘预算时仍可被移除。

-磁盘预算清理（`mode: "enforce"`）的执行顺序：
+OpenClaw 不再在 Gateway 网关写入期间自动创建 `sessions.json.bak.*` 轮转备份。旧版 `session.maintenance.rotateBytes` 键会被忽略，`openclaw doctor --fix` 会从旧配置中移除它。

-1. 先删除最旧的已归档、孤立对话记录或孤立轨迹产物。
-2. 如果仍高于目标值，则驱逐最旧的会话条目及其对话记录/轨迹文件。
-3. 持续执行，直到使用量小于或等于 `highWaterBytes`。
+磁盘预算清理的执行顺序（`mode: "enforce"`）：

-在 `mode: "warn"` 中，OpenClaw 会报告潜在驱逐项，但不会变更存储/文件。
+1. 首先移除最旧的归档产物、孤立会话记录或孤立轨迹产物。
+2. 如果仍高于目标值，则逐出最旧的会话条目及其会话记录/轨迹文件。
+3. 持续执行，直到用量处于或低于 `highWaterBytes`。
+
+在 `mode: "warn"` 中，OpenClaw 会报告潜在逐出项，但不会修改存储/文件。

 按需运行维护：

@ -107,12 +109,12 @@ openclaw sessions cleanup --enforce

 ## Cron 会话和运行日志

-隔离的 cron 运行也会创建会话条目/对话记录，并且有专用的保留控制：
+隔离的 cron 运行也会创建会话条目/会话记录，并且有专用的保留控制：

- `cron.sessionRetention`（默认 `24h`）会从会话存储中修剪旧的隔离 cron 运行会话（`false` 禁用）。
- `cron.runLog.maxBytes` + `cron.runLog.keepLines` 会修剪 `~/.openclaw/cron/runs/<jobId>.jsonl` 文件（默认值：`2_000_000` 字节和 `2000` 行）。
+- `cron.sessionRetention`（默认 `24h`）会从会话存储中清理旧的隔离 cron 运行会话（`false` 禁用）。
+- `cron.runLog.maxBytes` + `cron.runLog.keepLines` 会清理 `~/.openclaw/cron/runs/<jobId>.jsonl` 文件（默认值：`2_000_000` 字节和 `2000` 行）。

-当 cron 强制创建新的隔离运行会话时，它会在写入新行之前净化先前的 `cron:<jobId>` 会话条目。它会携带安全偏好，例如思考/快速/详细设置、标签，以及用户显式选择的模型/凭证覆盖。它会丢弃环境对话上下文，例如渠道/群组路由、发送或队列策略、提权、来源和 ACP 运行时绑定，因此新的隔离运行不能从较旧运行继承陈旧的投递或运行时权限。
+当 cron 强制创建新的隔离运行会话时，它会在写入新行之前清理之前的 `cron:<jobId>` 会话条目。它会携带安全偏好，例如思考/快速/详细设置、标签，以及显式的用户所选模型/身份验证覆盖项。它会丢弃环境对话上下文，例如渠道/群组路由、发送或队列策略、提权、来源，以及 ACP 运行时绑定，因此新的隔离运行不会从旧运行继承过期的交付或运行时权限。

 ---

@ -132,17 +134,17 @@ openclaw sessions cleanup --enforce

 ---

-## 会话 ID（`sessionId`）
+## 会话 id（`sessionId`）

-每个 `sessionKey` 指向一个当前 `sessionId`（继续对话的对话记录文件）。
+每个 `sessionKey` 都指向一个当前 `sessionId`（继续对话的会话记录文件）。

 经验规则：

 - **重置**（`/new`、`/reset`）会为该 `sessionKey` 创建新的 `sessionId`。
- **每日重置**（默认是 Gateway 网关主机本地时间凌晨 4:00）会在重置边界后的下一条消息创建新的 `sessionId`。
- **空闲过期**（`session.reset.idleMinutes` 或旧版 `session.idleMinutes`）会在空闲窗口之后有消息到达时创建新的 `sessionId`。当每日重置和空闲过期都已配置时，先过期者生效。
- **系统事件**（Heartbeat、cron 唤醒、exec 通知、Gateway 网关内务处理）可能会变更会话行，但不会延长每日/空闲重置的新鲜度。重置滚动会在构建新提示前丢弃上一会话的排队系统事件通知。
- **线程父级分叉保护**（`session.parentForkMaxTokens`，默认 `100000`）会在父会话已过大时跳过父对话记录分叉；新线程会从头开始。设为 `0` 可禁用。
+- **每日重置**（默认是 Gateway 网关主机本地时间凌晨 4:00）会在重置边界后的下一条消息到达时创建新的 `sessionId`。
+- **空闲过期**（`session.reset.idleMinutes` 或旧版 `session.idleMinutes`）会在空闲窗口之后收到消息时创建新的 `sessionId`。当每日重置和空闲过期都已配置时，先过期者生效。
+- **系统事件**（Heartbeat、cron 唤醒、exec 通知、Gateway 网关簿记）可能会修改会话行，但不会延长每日/空闲重置的新鲜度。重置滚动会在构建新提示前丢弃上一会话排队的系统事件通知。
+- **线程父级分叉保护**（`session.parentForkMaxTokens`，默认 `100000`）会在父会话已经过大时跳过父会话记录分叉；新线程会从空白状态开始。设置为 `0` 可禁用。

 实现细节：该决策发生在 `src/auto-reply/reply/session.ts` 中的 `initSessionState()`。

@ -154,83 +156,83 @@ openclaw sessions cleanup --enforce

 关键字段（并非详尽）：

- `sessionId`：当前对话记录 ID（除非设置了 `sessionFile`，否则文件名由此派生）
- `sessionStartedAt`：当前 `sessionId` 的开始时间戳；每日重置新鲜度使用它。旧版行可能会从 JSONL 会话头派生它。
- `lastInteractionAt`：最近真实用户/渠道交互时间戳；空闲重置新鲜度使用它，因此 Heartbeat、cron 和 exec 事件不会让会话保持存活。没有此字段的旧版行会回退到已恢复的会话开始时间，用于空闲新鲜度。
- `updatedAt`：最近一次存储行变更时间戳，用于列表、修剪和内务处理。它不是每日/空闲重置新鲜度的权威来源。
- `sessionFile`：可选的显式对话记录路径覆盖
+- `sessionId`：当前会话记录 id（除非设置了 `sessionFile`，否则文件名由此派生）
+- `sessionStartedAt`：当前 `sessionId` 的开始时间戳；每日重置新鲜度使用此值。旧版行可从 JSONL 会话头派生该值。
+- `lastInteractionAt`：最后一次真实用户/渠道交互时间戳；空闲重置新鲜度使用此值，因此 Heartbeat、cron 和 exec 事件不会让会话保持存活。没有该字段的旧版行会回退到恢复出的会话开始时间来计算空闲新鲜度。
+- `updatedAt`：最后一次存储行修改时间戳，用于列表、清理和簿记。它不是每日/空闲重置新鲜度的权威依据。
+- `sessionFile`：可选的显式会话记录路径覆盖
 - `chatType`：`direct | group | room`（帮助 UI 和发送策略）
- `provider`、`subject`、`room`、`space`、`displayName`：用于群组/渠道标注的元数据
+- `provider`、`subject`、`room`、`space`、`displayName`：用于群组/渠道标签的元数据
 - 开关：
  - `thinkingLevel`、`verboseLevel`、`reasoningLevel`、`elevatedLevel`
  - `sendPolicy`（按会话覆盖）
 - 模型选择：
  - `providerOverride`、`modelOverride`、`authProfileOverride`
- Token 计数器（尽力而为/取决于提供商）：
+- Token 计数器（尽力而为/依赖提供商）：
  - `inputTokens`、`outputTokens`、`totalTokens`、`contextTokens`
- `compactionCount`：该会话键完成自动压缩的次数
- `memoryFlushAt`：上一次预压缩记忆刷新的时间戳
- `memoryFlushCompactionCount`：上一次刷新运行时的压缩计数
+- `compactionCount`：此会话键自动压缩完成的次数
+- `memoryFlushAt`：最后一次压缩前记忆刷新的时间戳
+- `memoryFlushCompactionCount`：上次刷新运行时的压缩计数

-该存储可安全编辑，但 Gateway 网关是权威来源：随着会话运行，它可能会重写或重新水合条目。
+存储可以安全编辑，但 Gateway 网关是权威来源：随着会话运行，它可能会重写或重新水化条目。

 ---

-## 对话记录结构（`*.jsonl`）
+## 会话记录结构（`*.jsonl`）

-对话记录由 `@mariozechner/pi-coding-agent` 的 `SessionManager` 管理。
+会话记录由 `@mariozechner/pi-coding-agent` 的 `SessionManager` 管理。

-该文件是 JSONL：
+文件为 JSONL：

- 第一行：会话头（`type: "session"`，包含 `id`、`cwd`、`timestamp`、可选的 `parentSession`）
- 然后：带 `id` + `parentId` 的会话条目（树）
+- 第一行：会话头（`type: "session"`，包含 `id`、`cwd`、`timestamp`，可选 `parentSession`）
+- 随后：带有 `id` + `parentId` 的会话条目（树）

 值得注意的条目类型：

 - `message`：用户/助手/toolResult 消息
- `custom_message`：扩展注入的消息，_会_进入模型上下文（可从 UI 隐藏）
- `custom`：扩展状态，_不会_进入模型上下文
- `compaction`：持久化的压缩摘要，包含 `firstKeptEntryId` 和 `tokensBefore`
- `branch_summary`：导航树分支时持久化的摘要
+- `custom_message`：扩展注入的消息，_会_进入模型上下文（可对 UI 隐藏）
+- `custom`：_不会_进入模型上下文的扩展状态
+- `compaction`：带有 `firstKeptEntryId` 和 `tokensBefore` 的持久化压缩摘要
+- `branch_summary`：导航树分支时的持久化摘要

-OpenClaw 有意**不**“修正”对话记录；Gateway 网关使用 `SessionManager` 读写它们。
+OpenClaw 有意**不会**“修正”会话记录；Gateway 网关使用 `SessionManager` 读写它们。

 ---

-## 上下文窗口与已跟踪 token
+## 上下文窗口与跟踪 token

 有两个不同概念很重要：

-1. **模型上下文窗口**：每个模型的硬性上限（模型可见的 token）
+1. **模型上下文窗口**：每个模型的硬上限（模型可见的 token）
 2. **会话存储计数器**：写入 `sessions.json` 的滚动统计（用于 /status 和仪表板）

-如果你正在调优限制：
+如果你在调整限制：

- 上下文窗口来自模型目录（并且可通过配置覆盖）。
- 存储中的 `contextTokens` 是运行时估算/报告值；不要把它当成严格保证。
+- 上下文窗口来自模型目录（也可以通过配置覆盖）。
+- 存储中的 `contextTokens` 是运行时估算/报告值；不要把它当作严格保证。

-更多信息，请参阅 [/token-use](/zh-CN/reference/token-use)。
+更多信息请参阅 [/token-use](/zh-CN/reference/token-use)。

 ---

 ## 压缩：它是什么

-压缩会将较旧对话汇总为对话记录中持久化的 `compaction` 条目，并保留最近消息不变。
+压缩会把较早的对话摘要为会话记录中的持久化 `compaction` 条目，并保留最近消息不变。

-压缩后，后续轮次会看到：
+压缩后，未来轮次会看到：

 - 压缩摘要
 - `firstKeptEntryId` 之后的消息

-压缩是**持久化**的（不同于会话修剪）。请参阅 [/concepts/session-pruning](/zh-CN/concepts/session-pruning)。
+压缩是**持久的**（不同于会话清理）。请参阅 [/concepts/session-pruning](/zh-CN/concepts/session-pruning)。

 ## 压缩分块边界和工具配对

-当 OpenClaw 将长对话记录拆分为压缩分块时，它会让助手工具调用与其匹配的 `toolResult` 条目保持配对。
+当 OpenClaw 将长会话记录拆分为压缩分块时，它会保持助手工具调用与对应的 `toolResult` 条目配对。

- 如果按 token 占比划分的位置落在工具调用和其结果之间，OpenClaw 会将边界移动到助手工具调用消息，而不是拆开这对条目。
- 如果尾随工具结果块本来会让分块超过目标，OpenClaw 会保留该待处理工具块，并保持未摘要的尾部不变。
- 已中止/错误的工具调用块不会让待处理拆分保持打开。
+- 如果按 token 占比拆分的位置落在工具调用和其结果之间，OpenClaw 会把边界移动到助手工具调用消息，而不是分离这对条目。
+- 如果尾随的工具结果块本来会让分块超过目标大小，OpenClaw 会保留该待处理工具块，并保持未摘要的尾部不变。
+- 已中止/错误的工具调用块不会让待处理拆分保持打开状态。

 ---

@ -241,8 +243,8 @@ OpenClaw 有意**不**“修正”对话记录；Gateway 网关使用 `SessionMa
 1. **溢出恢复**：模型返回上下文溢出错误（`request_too_large`、`context length exceeded`、`input exceeds the maximum
 number of tokens`、`input token count exceeds the maximum number of input
 tokens`、`input is too long for the model`、`ollama error: context length
-exceeded` 以及类似的提供商形式变体）→ 压缩 → 重试。
-2. **阈值维护**：在成功轮次之后，当：
+exceeded`，以及类似的提供商形态变体）→ 压缩 → 重试。
+2. **阈值维护**：成功轮次之后，当：

 `contextTokens > contextWindow - reserveTokens`

@ -253,17 +255,10 @@ exceeded` 以及类似的提供商形式变体）→ 压缩 → 重试。

 这些是 Pi 运行时语义（OpenClaw 会消费事件，但由 Pi 决定何时压缩）。

-当设置了 `agents.defaults.compaction.maxActiveTranscriptBytes` 且活动对话记录文件达到该大小时，OpenClaw 也可以在打开下一次运行前触发一次预检本地压缩。这是针对本地重新打开成本的文件大小保护，而不是原始归档：OpenClaw 仍会运行正常的语义压缩，并且它要求 `truncateAfterCompaction`，以便压缩摘要可以成为新的后继对话记录。
+OpenClaw 还可以在打开下一次运行前触发一次预检本地压缩，前提是设置了 `agents.defaults.compaction.maxActiveTranscriptBytes`，且活跃会话记录文件达到该大小。这是针对本地重新打开成本的文件大小保护，并非原始归档：OpenClaw 仍会运行常规语义压缩，并且它要求启用 `truncateAfterCompaction`，这样压缩后的摘要才能成为新的后继会话记录。

-对于嵌入式 Pi 运行，`agents.defaults.compaction.midTurnPrecheck.enabled: true`
-会添加一个可选启用的工具循环保护。在追加工具结果之后、下一次
-模型调用之前，OpenClaw 会使用与轮次开始时相同的预检预算逻辑来估算提示压力。
-如果上下文已经无法容纳，保护不会在 Pi 的 `transformContext` 钩子内执行压缩。
-它会抛出结构化的轮次中预检信号，停止当前提示提交，并让外层运行循环使用现有恢复路径：
-在足够时截断过大的工具结果，或触发已配置的压缩模式并重试。该选项默认禁用，
-并且同时适用于 `default` 和 `safeguard` 压缩模式，包括由提供商支持的 safeguard 压缩。
-这独立于 `maxActiveTranscriptBytes`：字节大小保护会在轮次开始前运行，
-而轮次中预检会在追加新的工具结果之后，于嵌入式 Pi 工具循环中稍后运行。
+对于嵌入式 Pi 运行，`agents.defaults.compaction.midTurnPrecheck.enabled: true` 会添加一个可选启用的工具循环保护。在追加工具结果之后、下一次模型调用之前，OpenClaw 会使用与回合开始时相同的预检预算逻辑来估算提示压力。如果上下文不再适配，该保护不会在 Pi 的 `transformContext` 钩子内执行压缩。它会抛出一个结构化的回合中预检信号，停止当前提示提交，并让外层运行循环使用现有恢复路径：在足够时截断过大的工具结果，或触发已配置的压缩模式并重试。该选项默认禁用，并且可与 `default` 和 `safeguard` 两种压缩模式配合使用，包括由提供商支持的 safeguard 压缩。
+这独立于 `maxActiveTranscriptBytes`：字节大小保护会在打开回合之前运行，而回合中预检则稍后在嵌入式 Pi 工具循环中、追加新的工具结果之后运行。

 ---

@ -281,53 +276,42 @@ Pi 的压缩设置位于 Pi 设置中：
 }
 ```

-OpenClaw 还会为嵌入式运行强制执行一个安全下限：
+OpenClaw 还会为嵌入式运行强制实施安全下限：

 - 如果 `compaction.reserveTokens < reserveTokensFloor`，OpenClaw 会将其提高。
- 默认下限是 `20000` 个 token。
- 设置 `agents.defaults.compaction.reserveTokensFloor: 0` 可禁用该下限。
+- 默认下限为 `20000` 个 token。
+- 将 `agents.defaults.compaction.reserveTokensFloor: 0` 设置为禁用下限。
 - 如果它已经更高，OpenClaw 会保持不变。
- 手动 `/compact` 会遵循显式的 `agents.defaults.compaction.keepRecentTokens`
-  并保留 Pi 的近期尾部截断点。没有显式保留预算时，
-  手动压缩仍是硬检查点，重建后的上下文会从新的摘要开始。
- 设置 `agents.defaults.compaction.midTurnPrecheck.enabled: true` 可在新的工具结果之后、
-  下一次模型调用之前运行可选的工具循环预检。这只是触发器；摘要生成仍使用已配置的
-  压缩路径。它独立于 `maxActiveTranscriptBytes`，后者是轮次开始时的活动转录字节大小保护。
- 将 `agents.defaults.compaction.maxActiveTranscriptBytes` 设置为字节值或
-  `"20mb"` 这类字符串，可在活动转录变大时于轮次开始前运行本地压缩。
-  只有同时启用 `truncateAfterCompaction` 时，此保护才会生效。保持未设置或设为 `0`
-  可禁用。
- 启用 `agents.defaults.compaction.truncateAfterCompaction` 后，
-  OpenClaw 会在压缩后将活动转录轮转到一个已压缩的后继 JSONL。
-  旧的完整转录会保持归档，并从压缩检查点链接，而不是就地重写。
+- 手动 `/compact` 会遵循显式的 `agents.defaults.compaction.keepRecentTokens`，并保留 Pi 的最近尾部切点。如果没有显式保留预算，手动压缩仍是硬检查点，重建后的上下文会从新的摘要开始。
+- 将 `agents.defaults.compaction.midTurnPrecheck.enabled: true` 设置为在新的工具结果之后、下一次模型调用之前运行可选的工具循环预检。这只是触发器；摘要生成仍使用已配置的压缩路径。它独立于 `maxActiveTranscriptBytes`，后者是回合开始时的活跃会话记录字节大小保护。
+- 将 `agents.defaults.compaction.maxActiveTranscriptBytes` 设置为字节值或 `"20mb"` 这样的字符串，以便在活跃会话记录变大时，在回合开始前运行本地压缩。此保护仅在同时启用 `truncateAfterCompaction` 时生效。保持未设置或设置为 `0` 可禁用。
+- 启用 `agents.defaults.compaction.truncateAfterCompaction` 时，OpenClaw 会在压缩后将活跃会话记录轮转为压缩后的后继 JSONL。旧的完整会话记录会保持归档状态，并从压缩检查点链接，而不是原地重写。

-原因：在压缩变得不可避免之前，为多轮“后台整理”（如记忆写入）留出足够余量。
+原因：在压缩变得不可避免之前，为多回合“内务处理”（如记忆写入）留出足够的余量。

 实现：`src/agents/pi-settings.ts` 中的 `ensurePiCompactionReserveTokens()`
-（由 `src/agents/pi-embedded-runner.ts` 调用）。
+（从 `src/agents/pi-embedded-runner.ts` 调用）。

 ---

 ## 可插拔压缩提供商

-插件可以通过插件 API 上的 `registerCompactionProvider()` 注册压缩提供商。当 `agents.defaults.compaction.provider` 设置为已注册的提供商 ID 时，safeguard 扩展会将摘要委托给该提供商，而不是使用内置的 `summarizeInStages` 流程。
+插件可以通过插件 API 上的 `registerCompactionProvider()` 注册压缩提供商。当 `agents.defaults.compaction.provider` 设置为已注册的提供商 ID 时，safeguard 扩展会将摘要生成委托给该提供商，而不是使用内置的 `summarizeInStages` 流水线。

- `provider`：已注册压缩提供商插件的 ID。保持未设置则使用默认 LLM 摘要。
+- `provider`：已注册压缩提供商插件的 ID。保持未设置则使用默认 LLM 摘要生成。
 - 设置 `provider` 会强制 `mode: "safeguard"`。
 - 提供商会收到与内置路径相同的压缩指令和标识符保留策略。
- safeguard 仍会在提供商输出之后保留近期轮次和拆分轮次后缀上下文。
- 内置 safeguard 摘要会用新消息重新提炼先前摘要，
-  而不是逐字保留完整的上一份摘要。
- safeguard 模式默认启用摘要质量审计；设置
-  `qualityGuard.enabled: false` 可跳过格式异常输出时的重试行为。
- 如果提供商失败或返回空结果，OpenClaw 会自动回退到内置 LLM 摘要。
- 中止/超时信号会被重新抛出（而不是吞掉），以尊重调用方取消。
+- safeguard 仍会在提供商输出后保留最近回合和拆分回合的后缀上下文。
+- 内置 safeguard 摘要生成会使用新消息重新提炼既有摘要，而不是逐字保留完整的先前摘要。
+- safeguard 模式默认启用摘要质量审计；设置 `qualityGuard.enabled: false` 可跳过格式异常输出的重试行为。
+- 如果提供商失败或返回空结果，OpenClaw 会自动回退到内置 LLM 摘要生成。
+- 中止/超时信号会重新抛出（不会被吞掉），以尊重调用方取消。

 来源：`src/plugins/compaction-provider.ts`、`src/agents/pi-hooks/compaction-safeguard.ts`。

 ---

-## 用户可见界面
+## 用户可见表面

 你可以通过以下方式观察压缩和会话状态：

@ -338,72 +322,64 @@ OpenClaw 还会为嵌入式运行强制执行一个安全下限：

 ---

-## 静默后台整理（`NO_REPLY`）
+## 静默内务处理（`NO_REPLY`）

-OpenClaw 支持用于后台任务的“静默”轮次，此时用户不应看到中间输出。
+OpenClaw 支持用于后台任务的“静默”回合，在这些任务中用户不应看到中间输出。

 约定：

- 助手用精确的静默 token `NO_REPLY` /
-  `no_reply` 开始输出，表示“不要向用户发送回复”。
- OpenClaw 会在投递层剥离/抑制它。
- 精确静默 token 抑制不区分大小写，因此当整个载荷只有静默 token 时，`NO_REPLY` 和
-  `no_reply` 都算作匹配。
- 这只用于真正的后台/不投递轮次；它不是处理普通可执行用户请求的捷径。
+- 助手以精确静默 token `NO_REPLY` / `no_reply` 开始输出，表示“不要向用户投递回复”。
+- OpenClaw 会在投递层剥离/抑制此内容。
+- 精确静默 token 抑制不区分大小写，因此当整个载荷仅为静默 token 时，`NO_REPLY` 和 `no_reply` 都会生效。
+- 这仅用于真正的后台/不投递回合；它不是普通可执行用户请求的快捷方式。

-自 `2026.1.10` 起，当部分分块以 `NO_REPLY` 开头时，OpenClaw 还会抑制**草稿/正在输入流式传输**，因此静默操作不会在轮次中泄露部分输出。
+从 `2026.1.10` 起，当部分分块以 `NO_REPLY` 开头时，OpenClaw 也会抑制**草稿/输入中流式传输**，因此静默操作不会在回合中泄漏部分输出。

 ---

 ## 压缩前“记忆刷新”（已实现）

-目标：在自动压缩发生之前，运行一个静默的智能体式轮次，将持久状态写入磁盘
-（例如智能体工作区中的 `memory/YYYY-MM-DD.md`），这样压缩就不会抹除关键上下文。
+目标：在自动压缩发生前，运行一个静默的智能体回合，将持久状态写入磁盘（例如 Agent 工作区中的 `memory/YYYY-MM-DD.md`），这样压缩就不会抹除关键上下文。

 OpenClaw 使用**阈值前刷新**方法：

 1. 监控会话上下文使用量。
-2. 当它越过“软阈值”（低于 Pi 的压缩阈值）时，向智能体运行一个静默的
-   “立即写入记忆”指令。
-3. 使用精确的静默 token `NO_REPLY` / `no_reply`，使用户看不到
-   任何内容。
+2. 当它跨过“软阈值”（低于 Pi 的压缩阈值）时，向智能体运行一条静默的“立即写入记忆”指令。
+3. 使用精确静默 token `NO_REPLY` / `no_reply`，这样用户不会看到任何内容。

 配置（`agents.defaults.compaction.memoryFlush`）：

 - `enabled`（默认：`true`）
- `model`（可选的精确提供商/模型覆盖，用于刷新轮次，例如 `ollama/qwen3:8b`）
+- `model`（刷新回合的可选精确提供商/模型覆盖，例如 `ollama/qwen3:8b`）
 - `softThresholdTokens`（默认：`4000`）
- `prompt`（用于刷新轮次的用户消息）
- `systemPrompt`（为刷新轮次追加的额外系统提示）
+- `prompt`（刷新回合的用户消息）
+- `systemPrompt`（为刷新回合追加的额外系统提示）

 说明：

- 默认提示/系统提示包含 `NO_REPLY` 提示，用于抑制
-  投递。
- 设置 `model` 后，刷新轮次会使用该模型，而不继承
-  活动会话的回退链，因此仅本地的后台整理不会静默回退到付费对话模型。
- 刷新在每个压缩周期运行一次（记录在 `sessions.json` 中）。
- 刷新仅为嵌入式 Pi 会话运行（CLI 后端会跳过）。
+- 默认提示/系统提示包含 `NO_REPLY` 提示，用于抑制投递。
+- 设置 `model` 时，刷新回合会使用该模型，而不会继承活跃会话的回退链，因此仅本地的内务处理不会静默回退到付费对话模型。
+- 刷新每个压缩周期运行一次（在 `sessions.json` 中跟踪）。
+- 刷新仅针对嵌入式 Pi 会话运行（CLI 后端会跳过）。
 - 当会话工作区为只读（`workspaceAccess: "ro"` 或 `"none"`）时，会跳过刷新。
 - 请参阅 [Memory](/zh-CN/concepts/memory) 了解工作区文件布局和写入模式。

-Pi 还在扩展 API 中公开了一个 `session_before_compact` 钩子，但 OpenClaw 的
-刷新逻辑目前位于 Gateway 网关侧。
+Pi 还在扩展 API 中公开了 `session_before_compact` 钩子，但 OpenClaw 的刷新逻辑目前位于 Gateway 网关侧。

 ---

 ## 故障排除清单

 - 会话键错误？从 [/concepts/session](/zh-CN/concepts/session) 开始，并确认 `/status` 中的 `sessionKey`。
- 存储与转录不匹配？从 `openclaw status` 确认 Gateway 网关主机和存储路径。
+- 存储与会话记录不匹配？从 `openclaw status` 确认 Gateway 网关主机和存储路径。
 - 压缩刷屏？检查：
  - 模型上下文窗口（太小）
-  - 压缩设置（`reserveTokens` 对模型窗口而言过高可能导致更早压缩）
-  - 工具结果膨胀：启用/调整会话裁剪
- 静默轮次泄露？确认回复以 `NO_REPLY` 开头（不区分大小写的精确 token），并且你使用的构建包含流式传输抑制修复。
+  - 压缩设置（`reserveTokens` 对模型窗口来说过高可能导致更早压缩）
+  - 工具结果膨胀：启用/调优会话剪枝
+- 静默回合泄漏？确认回复以 `NO_REPLY` 开头（不区分大小写的精确 token），并且你使用的是包含流式传输抑制修复的构建版本。

 ## 相关

 - [会话管理](/zh-CN/concepts/session)
- [会话裁剪](/zh-CN/concepts/session-pruning)
+- [会话剪枝](/zh-CN/concepts/session-pruning)
 - [上下文引擎](/zh-CN/concepts/context-engine)