# Pages Drive 4.1 命令说明

## 首次使用

```text
install.cmd
pages-drive.cmd setup
```

## 命令

```text
pages-drive.cmd up <本地文件或目录> [远程路径] [--workers <数量>]
pages-drive.cmd dl <文件路径> [时间戳] [--concurrency <数量>] [--no-proxy]
  [--parent-dir <上一级目录>] [--grandparent-dir <上两级目录>]
  [--parent-index-url <URL>] [--grandparent-index-url <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> [版本名称]
```

## 示例

```text
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
```

## 下载加速建议

`dl` 会优先使用传入的目录 URL 或本地已注册索引，跳过从根 JSON 逐级寻找最新文件夹 URL。目录 URL 无效时会自动回退到实时解析。

推荐本地存储文件对应索引，以加快文件预加载速度。