From 692ca590d30456d8beefc215e5d1886414c64a42 Mon Sep 17 00:00:00 2001 From: j-xiang Date: Fri, 14 Aug 2026 12:47:37 +0800 Subject: [PATCH 1/5] docs(i18n): polish the Web UI guide --- docs/user/guide/index.i18n.yaml | 4 ++-- docs/user/guide/index.md | 2 +- docs/user/guide/index.zh.md | 8 ++++---- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/user/guide/index.i18n.yaml b/docs/user/guide/index.i18n.yaml index f6727b6bc4..c4fba5f0b3 100644 --- a/docs/user/guide/index.i18n.yaml +++ b/docs/user/guide/index.i18n.yaml @@ -2,5 +2,5 @@ # side as of the last confirmed-consistent state. Both languages carry equal authority; # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write docs/user/guide/index.md -index.md: 282a5c11b317a8fb8706bb03f41cf03fb2aca49d -index.zh.md: 4ec53b16fc8987b5eb40ef4854cb41d1436a9015 +index.md: 2ae8847e3e04e131517e505bbc3c5f2c1047a45c +index.zh.md: d73344c529e7c7dd11afd1a0b02a9e0c8a2586c3 diff --git a/docs/user/guide/index.md b/docs/user/guide/index.md index 282a5c11b3..2ae8847e3e 100644 --- a/docs/user/guide/index.md +++ b/docs/user/guide/index.md @@ -6,7 +6,7 @@ Start the Web UI through the [root README](../../../README.md#run); the command ## Configure a model -Open **Settings → Models**, enter a DeepSeek API key, and save it. The model route becomes usable immediately without restarting the server. +Open **Settings → Models**, enter a [DeepSeek API key](https://platform.deepseek.com/), and save it. The model route becomes usable immediately without restarting the server. The [model configuration guide](./providers.md) covers other providers and custom OpenAI-compatible endpoints. diff --git a/docs/user/guide/index.zh.md b/docs/user/guide/index.zh.md index 4ec53b16fc..d73344c529 100644 --- a/docs/user/guide/index.zh.md +++ b/docs/user/guide/index.zh.md @@ -2,17 +2,17 @@ [English](index.md) | 中文 -先按照[根 README](../../../README.md#run)启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把调用目录作为默认文件系统位置，但新的 Web UI 在添加工作区前不会选中任何工作区。 +请先按照 [根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置，但新的 Web UI 在添加工作区前不会选中任何工作区。 ## 配置模型 -打开**设置 → 模型**，输入 DeepSeek API 密钥并保存。模型路由会立即可用，不需要重启服务器。 +打开**设置 → 模型**，输入 [DeepSeek API 密钥](https://platform.deepseek.com/)并保存。模型路由会立即可用，不需要重启服务器。 [模型配置指南](./providers.md)介绍其他提供方和自定义 OpenAI 兼容端点。 ## 选择工作区 -点击**选择工作区**，添加启动 `dsh` 时所在的项目目录，然后选中它。选中工作区前，会话输入框不可用。 +点击**选择工作区**，添加启动 `dsh` 时所在的项目目录，然后选中它。选中工作区前，会话输入区不可用。 ## 运行任务 @@ -20,7 +20,7 @@ > Summarize this repository and identify its main packages. -agent 可以读取和编辑工作区文件、运行命令、委派工作并维护计划。当操作在当前权限策略下需要审批时，Web UI 会先询问你。 +Agent（智能体）可以读取和编辑工作区文件、运行命令、委派工作并维护计划。如果根据当前权限策略，某项操作需要审批，Web UI 会先询问你。 ## 继续使用 From e437afecce78404e931040943b6f1f84d480e12b Mon Sep 17 00:00:00 2001 From: j-xiang Date: Fri, 14 Aug 2026 13:26:02 +0800 Subject: [PATCH 2/5] docs(i18n): clarify initial workspace state --- docs/user/guide/index.i18n.yaml | 2 +- docs/user/guide/index.zh.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user/guide/index.i18n.yaml b/docs/user/guide/index.i18n.yaml index c4fba5f0b3..2ee8bc7b7b 100644 --- a/docs/user/guide/index.i18n.yaml +++ b/docs/user/guide/index.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write docs/user/guide/index.md index.md: 2ae8847e3e04e131517e505bbc3c5f2c1047a45c -index.zh.md: d73344c529e7c7dd11afd1a0b02a9e0c8a2586c3 +index.zh.md: 259189fab8f252b77411e5900d39cc1b03a4be1b diff --git a/docs/user/guide/index.zh.md b/docs/user/guide/index.zh.md index d73344c529..259189fab8 100644 --- a/docs/user/guide/index.zh.md +++ b/docs/user/guide/index.zh.md @@ -2,7 +2,7 @@ [English](index.md) | 中文 -请先按照 [根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置，但新的 Web UI 在添加工作区前不会选中任何工作区。 +请先按照 [根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置，但全新的 Web UI 不会选中任何工作区，你需要添加一个工作区。 ## 配置模型 From e87c8d094ba5d0ae2ea75103e044365077977b48 Mon Sep 17 00:00:00 2001 From: j-xiang Date: Fri, 14 Aug 2026 13:37:53 +0800 Subject: [PATCH 3/5] docs(i18n): align Web UI guide wording --- docs/user/guide/index.i18n.yaml | 2 +- docs/user/guide/index.zh.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/user/guide/index.i18n.yaml b/docs/user/guide/index.i18n.yaml index 2ee8bc7b7b..7627ad57fc 100644 --- a/docs/user/guide/index.i18n.yaml +++ b/docs/user/guide/index.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write docs/user/guide/index.md index.md: 2ae8847e3e04e131517e505bbc3c5f2c1047a45c -index.zh.md: 259189fab8f252b77411e5900d39cc1b03a4be1b +index.zh.md: dbb33f4860e6170be0e134c5968df91c6b0ac5da diff --git a/docs/user/guide/index.zh.md b/docs/user/guide/index.zh.md index 259189fab8..dbb33f4860 100644 --- a/docs/user/guide/index.zh.md +++ b/docs/user/guide/index.zh.md @@ -2,7 +2,7 @@ [English](index.md) | 中文 -请先按照 [根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置，但全新的 Web UI 不会选中任何工作区，你需要添加一个工作区。 +请先按照[根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置，但全新的 Web UI 不会选中任何工作区，你需要添加一个工作区。 ## 配置模型 @@ -12,7 +12,7 @@ ## 选择工作区 -点击**选择工作区**，添加启动 `dsh` 时所在的项目目录，然后选中它。选中工作区前，会话输入区不可用。 +点击**选择工作区**，添加启动 `dsh` 时所在的项目目录，然后选中它。选中工作区前，会话输入框不可用。 ## 运行任务 From 09432d644b1ccdf76b8a2524d982cbe73da946a1 Mon Sep 17 00:00:00 2001 From: j-xiang Date: Fri, 14 Aug 2026 13:43:38 +0800 Subject: [PATCH 4/5] docs(i18n): sharpen workspace contrast --- docs/user/guide/index.i18n.yaml | 2 +- docs/user/guide/index.zh.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user/guide/index.i18n.yaml b/docs/user/guide/index.i18n.yaml index 7627ad57fc..bff88e1dff 100644 --- a/docs/user/guide/index.i18n.yaml +++ b/docs/user/guide/index.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write docs/user/guide/index.md index.md: 2ae8847e3e04e131517e505bbc3c5f2c1047a45c -index.zh.md: dbb33f4860e6170be0e134c5968df91c6b0ac5da +index.zh.md: 1f7b9862d9785281dad25891c4c86934eac0cd06 diff --git a/docs/user/guide/index.zh.md b/docs/user/guide/index.zh.md index dbb33f4860..1f7b9862d9 100644 --- a/docs/user/guide/index.zh.md +++ b/docs/user/guide/index.zh.md @@ -2,7 +2,7 @@ [English](index.md) | 中文 -请先按照[根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置，但全新的 Web UI 不会选中任何工作区，你需要添加一个工作区。 +请先按照[根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置；全新的 Web UI 则不会选中任何工作区，你需要添加一个工作区。 ## 配置模型 From 631d68713f3532af64745240cfc5c4a0030684e6 Mon Sep 17 00:00:00 2001 From: j-xiang Date: Fri, 14 Aug 2026 14:43:05 +0800 Subject: [PATCH 5/5] docs(i18n): clarify root README reference --- docs/user/guide/index.i18n.yaml | 2 +- docs/user/guide/index.zh.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user/guide/index.i18n.yaml b/docs/user/guide/index.i18n.yaml index bff88e1dff..ba745feed8 100644 --- a/docs/user/guide/index.i18n.yaml +++ b/docs/user/guide/index.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write docs/user/guide/index.md index.md: 2ae8847e3e04e131517e505bbc3c5f2c1047a45c -index.zh.md: 1f7b9862d9785281dad25891c4c86934eac0cd06 +index.zh.md: 7e4a140e11ca409755d63ade41a31d9b3cc4d4b6 diff --git a/docs/user/guide/index.zh.md b/docs/user/guide/index.zh.md index 1f7b9862d9..7e4a140e11 100644 --- a/docs/user/guide/index.zh.md +++ b/docs/user/guide/index.zh.md @@ -2,7 +2,7 @@ [English](index.md) | 中文 -请先按照[根 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置；全新的 Web UI 则不会选中任何工作区，你需要添加一个工作区。 +请先按照[根目录 README](../../../README.md#run) 中的说明启动 Web UI；命令会打印其访问地址。本指南从服务器已经运行的状态开始。`dsh` 进程会把启动时所在的目录作为默认文件系统位置；全新的 Web UI 则不会选中任何工作区，你需要添加一个工作区。 ## 配置模型