From 479fc99612b5a9da8429435ce43f95c26f3797a0 Mon Sep 17 00:00:00 2001
From: sorubedo <zhanrenhangg@gmail.com>
Date: Fri, 19 Jun 2026 14:08:34 +0800
Subject: [PATCH] docs(ftp): document cwd_list option

Add bilingual documentation for the new cwd_list option that
changes directory before listing files on FTP servers that
don't support path-argument LIST commands
---
 pages/guide/drivers/ftp.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/pages/guide/drivers/ftp.md b/pages/guide/drivers/ftp.md
index 1e913fbc2..3a12fb35f 100644
--- a/pages/guide/drivers/ftp.md
+++ b/pages/guide/drivers/ftp.md
@@ -64,6 +64,18 @@ root folder , default `/`, same as local storage.
 根文件夹，默认 `/`，同本地存储。
 :::
 
+## Enter directory before listing { lang="en" }
+
+## 列出前先进入目录 { lang="zh-CN" }
+
+::: en
+Whether to change into the target directory before listing files. Some FTP servers do not support listing files with a path argument directly. Enable this option to first `cd` into the directory and then `ls`, which can resolve such compatibility issues. Default: `false`.
+:::
+
+::: zh-CN
+是否在列出文件前先进入目标目录。部分 FTP 服务器不支持直接带路径参数列出文件，开启此选项后会先 `cd` 进入目录再 `ls`，可以解决此类兼容性问题。默认: `false`。
+:::
+
 ### The default download method used { lang="en" }
 
 ### 默认使用的下载方式 { lang="zh-CN" }