Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions

View File

@@ -1,11 +1,11 @@
---
read_when:
-要 TUI 的新手友好指南
-要 TUI 的新手友好演练
- 你需要 TUI 功能、命令和快捷键的完整列表
summary: 终端 UITUI从任何机器连接到 Gateway网关
summary: 终端 UITUI从任何机器连接到 Gateway 网关
title: TUI
x-i18n:
generated_at: "2026-02-01T21:43:58Z"
generated_at: "2026-02-03T10:13:10Z"
model: claude-opus-4-5
provider: pi
source_hash: 4bf5b0037bbb3a166289f2f0a9399489637d4cf26335ae3577af9ea83eee747e
@@ -17,7 +17,7 @@ x-i18n:
## 快速开始
1. 启动 Gateway网关。
1. 启动 Gateway 网关。
```bash
openclaw gateway
@@ -31,43 +31,43 @@ openclaw tui
3. 输入消息并按 Enter。
远程 Gateway网关
远程 Gateway 网关:
```bash
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```
如果你的 Gateway网关使用密码认证请使用 `--password`
如果你的 Gateway 网关使用密码认证,请使用 `--password`
## 界面概览
## 你看到的内容
- 头部:连接 URL、当前智能体、当前会话。
- 聊天记录:用户消息、助手回复、系统通知、工具卡片。
- 标题栏:连接 URL、当前智能体、当前会话。
- 聊天日志:用户消息、助手回复、系统通知、工具卡片。
- 状态行:连接/运行状态(连接中、运行中、流式传输中、空闲、错误)。
- 底栏:连接状态 + 智能体 + 会话 + 模型 + 思考/详细/推理 + token 计数 + 投递状态。
- 输入:带自动补全的文本编辑器。
- 页脚:连接状态 + 智能体 + 会话 + 模型 + think/verbose/reasoning + token 计数 + 投递状态。
- 输入:带自动完成的文本编辑器。
## 概念模型:智能体 + 会话
## 心智模型:智能体 + 会话
- 智能体是唯一的标识符(例如 `main``research`。Gateway网关提供可用列表。
- 智能体是唯一的标识符(例如 `main``research`。Gateway 网关公开列表。
- 会话属于当前智能体。
- 会话键存储为 `agent:<agentId>:<sessionKey>`
- 如果你输入 `/session main`TUI 会将其展`agent:<currentAgent>:main`
- 如果你输入 `/session agent:other:main`显式切换到该智能体会话。
- 如果你输入 `/session main`TUI 会将其展为 `agent:<currentAgent>:main`
- 如果你输入 `/session agent:other:main`你会显式切换到该智能体会话。
- 会话范围:
- `per-sender`(默认):每个智能体有多个会话。
- `global`TUI 始终使用 `global` 会话(选择器可能为空)。
- 当前智能体 + 会话始终显示在底栏
- 当前智能体 + 会话始终在页脚中可见
## 发送投递
## 发送 + 投递
- 消息发送到 Gateway网关默认不投递提供商。
- 消息发送到 Gateway 网关;默认情况下不投递提供商。
- 开启投递:
- `/deliver on`
-通过设置面板
-启动时使用 `openclaw tui --deliver`
- 或设置面板
- 或使用 `openclaw tui --deliver` 启动
## 选择器覆盖层
## 选择器 + 覆盖层
- 模型选择器:列出可用模型并设置会话覆盖。
- 智能体选择器:选择不同的智能体。
@@ -77,14 +77,14 @@ openclaw tui --url ws://<host>:<port> --token <gateway-token>
## 键盘快捷键
- Enter发送消息
- Esc中止活运行
- Esc中止活运行
- Ctrl+C清除输入按两次退出
- Ctrl+D退出
- Ctrl+L模型选择器
- Ctrl+G智能体选择器
- Ctrl+P会话选择器
- Ctrl+O切换工具输出展开
- Ctrl+T切换思考可见性重新加载历史记录
- Ctrl+T切换思考可见性重新加载历史
## 斜杠命令
@@ -109,58 +109,58 @@ openclaw tui --url ws://<host>:<port> --token <gateway-token>
会话生命周期:
- `/new``/reset`(重置会话)
- `/abort`(中止活运行)
- `/abort`(中止活运行)
- `/settings`
- `/exit`
其他 Gateway网关斜杠命令例如 `/context`)会转发到 Gateway网关并显示为系统输出。请参阅[斜杠命令](/tools/slash-commands)。
其他 Gateway 网关斜杠命令(例如 `/context`)会转发到 Gateway 网关并显示为系统输出。参见[斜杠命令](/tools/slash-commands)。
## 本地 shell 命令
- 在行首加 `!` 在 TUI 主机上运行本地 shell 命令。
- TUI 每个会话会提示一次以允许本地执行;拒绝`!` 在该会话中保持禁用
- 命令在 TUI 工作目录中全新非交互式 shell 运行(无持久化 `cd`/env)。
- 单独的 `!` 作为普通消息发送;前导空格不会触发本地执行。
- `!` 为前缀的行会在 TUI 主机上运行本地 shell 命令。
- TUI 每个会话会提示一次以允许本地执行;拒绝会在该会话中禁用 `!`
- 命令在 TUI 工作目录中全新非交互式 shell 运行(无持久化 `cd`/环境变量)。
- 单独的 `!` 作为普通消息发送;前导空格不会触发本地执行。
## 工具输出
- 工具调用以卡片形式显示,包含参数和结果
- 工具调用显示为带有参数 + 结果的卡片
- Ctrl+O 在折叠/展开视图之间切换。
- 工具运行时,部分更新会流式输到同一卡片。
- 工具运行时,部分更新会流式输到同一卡片。
## 历史记录与流式传输
## 历史 + 流式传输
- 连接时TUI 加载最新历史记录(默认 200 条消息)。
- 流式响应实时更新直到最终确认
- TUI 还监听智能体工具事件以提供更丰富的工具卡片。
- 连接时TUI 加载最新历史(默认 200 条消息)。
- 流式响应原地更新直到完成
- TUI 还监听智能体工具事件以获得更丰富的工具卡片。
## 连接详情
- TUI 以 `mode: "tui"` 注册到 Gateway网关。
- 重新连接显示系统消息;事件间隙会在日志中显示。
- TUI 以 `mode: "tui"` Gateway 网关注册
- 重新连接显示系统消息;事件间隙会在日志中显示。
## 选项
- `--url <url>`Gateway网关 WebSocket URL默认使用配置或 `ws://127.0.0.1:<port>`
- `--token <token>`Gateway网关令牌如需要
- `--password <password>`Gateway网关密码如需要
- `--session <key>`:会话键(默认:`main`,全局范围时为 `global`
- `--deliver`:将助手回复投递提供商(默认关闭)
- `--thinking <level>`:覆盖发送的思考级别
- `--timeout-ms <ms>`:智能体超时时间(毫秒默认为 `agents.defaults.timeoutSeconds`
- `--url <url>`Gateway 网关 WebSocket URL默认配置或 `ws://127.0.0.1:<port>`
- `--token <token>`Gateway 网关令牌(如需要)
- `--password <password>`Gateway 网关密码(如需要)
- `--session <key>`:会话键(默认:`main`或范围为全局时为 `global`
- `--deliver`:将助手回复投递提供商(默认关闭)
- `--thinking <level>`:覆盖发送的思考级别
- `--timeout-ms <ms>`:智能体超时(毫秒默认为 `agents.defaults.timeoutSeconds`
## 故障排除
发送消息后没有输出:
- 在 TUI 中运行 `/status` 确认 Gateway网关已连接且处于空闲/忙碌状态。
- 检查 Gateway网关日志`openclaw logs --follow`
- 在 TUI 中运行 `/status` 确认 Gateway 网关已连接且处于空闲/忙碌状态。
- 检查 Gateway 网关日志:`openclaw logs --follow`
- 确认智能体可以运行:`openclaw status``openclaw models status`
- 如果你期望消息出现在聊天渠道中,请启用投递(`/deliver on``--deliver`)。
- `--history-limit <n>`:要加载的历史记录条目数(默认 200
- `--history-limit <n>`:要加载的历史条目数(默认 200
## 故障排除
- `disconnected`:确保 Gateway网关正在运行且你的 `--url/--token/--password` 正确。
- `disconnected`:确保 Gateway 网关正在运行且你的 `--url/--token/--password` 正确。
- 选择器中没有智能体:检查 `openclaw agents list` 和你的路由配置。
- 会话选择器为空:你可能处于全局范围或尚无会话。
- 会话选择器为空:你可能处于全局范围或还没有会话。