diff --git a/docs/en/reference/tools.md b/docs/en/reference/tools.md
index d7874abd..2b05a932 100644
--- a/docs/en/reference/tools.md
+++ b/docs/en/reference/tools.md
@@ -39,8 +39,8 @@ File tools handle reading, writing, and searching the local filesystem — the f
 
 - `command` (required): the shell command to execute
 - `cwd`: working directory
-- `timeout`: timeout in milliseconds; foreground default is 60 seconds, maximum is 5 minutes
-- `run_in_background`: whether to run as a background task; background tasks default to a 10-minute timeout
+- `timeout`: timeout in seconds; foreground default is 60 seconds, maximum is 5 minutes
+- `run_in_background`: whether to run as a background task; background tasks default to a 10-minute timeout, maximum is 24 hours
 - `description`: background task description; required when `run_in_background=true`
 - `disable_timeout`: whether to remove the timeout limit for background tasks
 
diff --git a/docs/zh/reference/tools.md b/docs/zh/reference/tools.md
index 2a3118d6..4c24906f 100644
--- a/docs/zh/reference/tools.md
+++ b/docs/zh/reference/tools.md
@@ -39,8 +39,8 @@
 
 - `command`（必填）：要执行的 Shell 命令
 - `cwd`：工作目录
-- `timeout`：超时时间（毫秒）；前台默认 60 秒、最长 5 分钟
-- `run_in_background`：是否以后台任务运行；后台默认 10 分钟超时
+- `timeout`：超时时间（秒）；前台默认 60 秒、最长 5 分钟
+- `run_in_background`：是否以后台任务运行；后台默认 10 分钟超时、最长 24 小时
 - `description`：后台任务描述，`run_in_background=true` 时必填
 - `disable_timeout`：后台任务是否取消超时限制