DOCUMENTATION / 4.1
命令说明
以下命令同时适用于完整版和最小 CLI。Windows 最小版使用 pages-drive.cmd。
首次使用
install.cmd
pages-drive.cmd setup
安装依赖、生成本地配置，登录 Cloudflare，并自动创建或检查主目录项目与数据项目。
常用命令
setup初始化 Cloudflare 登录、Pages 项目和根索引。
up上传文件或目录；支持 --workers 设置并发数。
dl下载最新或指定时间戳版本；可传入上一级、上两级目录索引以直达文件。
mkdir创建远程目录，可用 --view 设置目录视图。
rm从远程目录树移除文件或目录记录。
mv移动或重命名远程文件、目录。
cv清理旧版本；可限定文件或指定版本时间。
rv为历史版本添加名称，空名称表示移除名称。
完整语法
上传
pages-drive.cmd up <本地文件或目录> [远程路径] [--workers <数量>]
下载
pages-drive.cmd dl <文件路径> [时间戳] [--concurrency <数量>] [--no-proxy]
[--parent-dir <上一级目录>] [--grandparent-dir <上两级目录>]
[--parent-index-url <URL>] [--grandparent-index-url <URL>]
[--parent-dir <上一级目录>] [--grandparent-dir <上两级目录>]
[--parent-index-url <URL>] [--grandparent-index-url <URL>]
目录索引 URL 有效时，CLI 会跳过从根 JSON 逐级查找最新文件夹 URL；无效时自动回退实时解析。
新建目录
pages-drive.cmd mkdir <文件夹路径> [--view <类型>]
删除
pages-drive.cmd rm <文件或目录路径>
移动
pages-drive.cmd mv <源路径> <目标路径>
清理版本
pages-drive.cmd cv [--path <文件路径>] [--target <createdAt>]
版本命名
pages-drive.cmd rv <文件路径> <createdAt> [版本名称]
示例
pages-drive.cmd mkdir /photos/2026
pages-drive.cmd up D:\photo.jpg /photos/2026/photo.jpg --workers 8
pages-drive.cmd dl /photos/2026/photo.jpg --concurrency 4
pages-drive.cmd dl /photos/2026/photo.jpg --grandparent-dir /photos --grandparent-index-url https://example.pages.dev/main.json
pages-drive.cmd mv /photos/2026/photo.jpg /photos/cover.jpg
预加载建议
推荐本地存储文件对应索引，以加快文件预加载速度。4.1 会使用独立的本地注册表保存目录到索引 URL 的映射，目录内容仍从远程实时读取。