# AliPCS-Py
**2023-04-24 支持 阿里云盘开放平台 api。**
**2023-02-15 使用临时 API 接口，让下载可用。**
**2023-02-14 阿里网盘 API 下载接口不再提供第三方应用使用。需要申请使用官方 API 接口。目前官方 API 接口在内测中。本项目已提交内测申请，等待回复中。在此期间下载功能不能使用。**
[](https://badge.fury.io/py/alipcs-py)
An AliPCS API and An App
AliPCS-Py 是阿里云盘的非官方 api 和一个命令行运用程序。
变更日志在 [CHANGELOG.md](./CHANGELOG.md)。
---
## 百度云盘 api 和 命令行客户端在 https://github.com/PeterDing/BaiduPCS-Py
---
- [安装](#安装)
- [更新](#更新)
- [API](#API)
- [用法](#用法)
- [命令别名](#命令别名)
- [对多个帐号进行相同操作](#对多个帐号进行相同操作)
#### 用户相关命令
- [添加用户](#添加用户)
- [显示当前用户的信息](#显示当前用户的信息)
- [更新用户信息](#更新用户信息)
- [显示所有用户](#显示所有用户)
- [切换当前用户](#切换当前用户)
- [删除一个用户](#删除一个用户)
- [显示当前工作目录](#显示当前工作目录)
- [切换当前工作目录](#切换当前工作目录)
#### 无感加密解密文件
- [设置文件加密密码](#设置文件加密密码)
#### 文件操作相关命令
- [文件操作](#文件操作)
- [列出网盘路径下的文件](#列出网盘路径下的文件)
- [搜索文件](#搜索文件)
- [显示文件内容](#显示文件内容)
- [创建目录](#创建目录)
- [移动文件](#移动文件)
- [文件重命名](#文件重命名)
- [拷贝文件](#拷贝文件)
- [删除文件](#删除文件)
- [下载文件或目录](#下载文件或目录)
- [播放媒体文件](#播放媒体文件)
- [上传文件](#上传文件)
- [同步本地目录到远端](#同步本地目录到远端)
#### 秒传
- [关于秒传连接](#关于秒传连接)
#### 分享相关命令
- [分享文件](#分享文件)
- [列出分享链接](#列出分享链接)
- [取消分享链接](#取消分享链接)
- [列出其他用户分享链接中的文件](#列出其他用户分享链接中的文件)
- [下载他人分享的文件](#下载他人分享的文件)
- [播放他人分享的文件](#播放他人分享的文件)
- [保存其他用户分享的链接](#保存其他用户分享的链接)
#### 本地保存分享连接
- [保存分享连接至本地](#保存分享连接至本地)
- [显示本地保存的分享连接](#显示本地保存的分享连接)
- [显示本地保存的分享文件](#显示本地保存的分享文件)
- [查找本地保存的分享连接](#查找本地保存的分享连接)
- [查找本地保存的分享文件](#查找本地保存的分享文件)
- [查找本地保存的分享连接和文件](#查找本地保存的分享连接和文件)
- [删除本地保存的分享连接或文件](#删除本地保存的分享连接或文件)
- [清理本地保存的无效分享连接](#清理本地保存的无效分享连接)
#### HTTP 服务
- [开启 HTTP 服务](#开启-HTTP-服务)
## 安装
需要 Python 版本大于或等于 3.8
```
pip3 install Cython
pip3 install AliPCS-Py
```
### Windows 依赖
在 Windows 上，AliPCS-Py 依赖 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)。
在安装 AliPCS-Py 前，请先安装 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)，再在其中勾选 `C++ 生成工具` 并安装。完成后即可安装 AliPCS-Py。
## 更新
```
pip3 install AliPCS-Py --upgrade
```
## API
AliPCS-Py 的阿里云盘 API 只依赖 requests，方便用户开发自己的运用。
```python
from alipcs_py.alipcs import AliPCSApi
api = AliPCSApi(refresh_token)
```
## 用法
```
AliPCS-Py --help
```
## 命令别名
可以用下面的命令别名代替原来的命令名。
| 别名 | 原名 |
| ---- | ------------ |
| w | who |
| uu | updateuser |
| su | su |
| ul | userlist |
| ua | useradd |
| ep | encryptpwd |
| ud | userdel |
| l | ls |
| f | search |
| md | mkdir |
| mv | move |
| rn | rename |
| cp | copy |
| rm | remove |
| d | download |
| p | play |
| u | upload |
| sn | sync |
| S | share |
| sl | shared |
| cs | cancelshared |
| s | save |
| sv | server |
## 对多个帐号进行相同操作
AliPCS-Py 支持对多个帐号进行相同操作。比如，用相同关键字搜索多个帐号，上传相同的文件/目录到多个帐号，等等。
使用者只需用 `--users` 选项来指定要操作的帐号名即可。
`--users` 接受一个参数，这个参数是用“,”连接的要进行操作帐号名的部分字符。假设我们现在有 3 个帐号，帐号名分别是 `Tom`，`Peter`，`Joy`。
现在我要同时对`Tom`和`Joy`进行关键字搜索。我们可以用下面的命令进行：
```
AliPCS-Py --users 'Tom,Joy' search 'keyword' / -R
```
或者给出帐号名的部分片段：
```
AliPCS-Py --users 'om,oy' search 'keyword' / -R
```
更简单可以用：
```
# Tom, Joy 都包含字符 "o"
AliPCS-Py --users 'o' search 'keyword' / -R
```
如果要对所有帐号进行操作用 `--users ''`。
如果不使用 `--users` 选项，默认只对当前帐号进行操作。
以下命令支持对多个帐号进行操作：
- pwd
- ls
- search
- cat
- mkdir
- move
- rename
- copy
- remove
- download
- play
- upload
- sync
- share
- shared
- cancelshared
- save
- server
**注意**: `--users` 一定要跟在 `AliPCS-Py` 后，命令前。
## 添加用户
**从 2023-02-14 开始，阿里云盘官方限制了 web 端 api 的调用。从 web 端 api 获取到的下载连接是限速的。但如果调用[阿里云盘开放平台](https://survey.alibaba.com/apps/zhiliao/I9Dd1Nl89)的 api 获取到的下载连接是不限速的。**
AliPCS-Py (>= v0.6.0) 支持调用阿里云盘开放平台 api。但是由于一直没有拿到内测，没法提供默认登录操作。需要用户自己找其他应用提供的登录方式登录。
### 使用 web `refresh_token` 和 第三方认证地址 登录
第三方认证地址提供阿里云盘开放平台的认证服务。由于一直没有拿到内测，本项目目前没法提供。需要使用者自行寻找。
交互添加：
```
AliPCS-Py useradd
```
或者直接添加：
```
AliPCS-Py useradd --web-refresh-token "..." --client-server "..."
# 其他选项留空
```
之后用阿里云盘 APP 扫码登录。
### 使用 web `refresh_token` 和 阿里云盘开放平台认证凭证 登录
如果使用者拿到了阿里云盘开放平台认证，会获得 `client-id` 和 `client-secret`。使用这两个值可以直接登录。
交互添加：
```
AliPCS-Py useradd
```
或者直接添加：
```
AliPCS-Py useradd --web-refresh-token "..." --client-id "..." --client-secret "..."
# 其他选项留空
```
之后用阿里云盘 APP 扫码登录。
### 使用 web `refresh_token` 登录
使用者需要在 https://www.aliyundrive.com/drive/ 登录后获取 `refresh_token` 值，并用命令 `useradd` 为 AliPCS-Py 添加一个用户。`useradd` 其他参数留空就好。
使用者可以用下面的方式获取用户的 `refresh_token` 值。
1. 登录 https://www.aliyundrive.com/drive/
2. 打开浏览器的开发者工具(如 Chrome DevTools)。
3. 然后选择开发者工具的 Console 面板。输入 `JSON.parse(localStorage.token).refresh_token`，再回车，获取 `refresh_token`。
现在找到了 `refresh_token` 值，我们可以用下面的命令添加一个用户。
交互添加：
```
AliPCS-Py useradd
```
或者直接添加：
```
AliPCS-Py useradd --web-refresh-token "..."
```
AliPCS-Py 支持多用户，你只需一直用 `useradd` 来添加用户即可。
**注意：如果只用 `--web-refresh-token` 登录，下载文件时，服务器端会限速。**
## 显示当前用户的信息
```
AliPCS-Py who
```
或者：
```
AliPCS-Py who user_id
```
指明显示用户 id 为 `user_id` 的用户信息。
### 选项
| Option | Description |
| ---------------------------- | -------------------------- |
| -K, --show-encrypt-password | 显示加密密码 |
| --account-name TEXT | 账号名 [默认为 user id] |
| --web-refresh-token TEXT | 用户 web_refresh_token |
| --openapi-refresh-token TEXT | 用户 openapi_refresh_token |
| --client-id TEXT | openapi client id |
| --client-secret TEXT | openapi client secret |
| --client-server TEXT | openapi client server |
## 更新用户信息
默认更新当前用户信息。
```
AliPCS-Py updateuser
```
也可指定多个 `user_id`
```
AliPCS-Py updateuser user_id
```
## 显示所有用户
```
AliPCS-Py userlist
```
## 切换当前用户
```
AliPCS-Py su
```
或者指定用户列表中用户所在的位置：
```
AliPCS-Py su 2
```
## 删除一个用户
```
AliPCS-Py userdel
```
## 设置文件加密密码
AliPCS-Py 支持“无感的”文件加密。
AliPCS-Py 可以加密上传文件，在下载的时候自动解密，让使用者感觉不到加密解密的过程。
如果使用者需要将保密文件上传至阿里云盘保存，可以使用这个方法。即使帐号被盗，攻击者也无法还原文件内容。
AliPCS-Py 支持以下加密方法：
- **Simple** 一种简单的加密算法。根据密钥生成一个字节对照表来加密解密文件。
速度快，但**不安全**，不建议加密重要文件。
因为这种算法加解密不需要知道上下文信息，所以，下载时支持分段下载，如果是媒体文件则支持拖动播放。
推荐用于加密不重要的媒体文件。
- **ChaCha20** 工业级加密算法，速度快，推荐用于加密重要文件。不支持分段下载。
- **AES256CBC** 工业级加密算法，推荐用于加密重要文件。不支持分段下载。
**注意**：用命令 `encryptpwd` 设置的密码**只是为当前用户**的。
为当前用户设置加密密码:
交互添加：
```
AliPCS-Py encryptpwd
```
或者直接添加：
```
AliPCS-Py encryptpwd --encrypt-password 'my-encrypt-password'
```
上传并加密文件：
上传和同步文件时只需要指定加密算法就可。如果不指定就不加密。
```
# 默认使用上面设置的 `encrypt-password`
AliPCS-Py upload some-file.mp4 some-dir/ /to/here --encrypt-type AES256CBC
```
下载并用上面设置的 `encrypt-password` 自动解密文件：
```
AliPCS-Py download /to/here/some-file.mp4 /to/here/some-dir/
```
也可以使用临时的 `encrypt-password`：
```
AliPCS-Py upload some-file.mp4 some-dir/ /to/here --encrypt-type Simple --encrypt-password 'onlyyou'
```
但在使用临时的 `encrypt-password` 后，`cat`、下载和播放这些文件时需要指定 `encrypt-password`，但不需要指定加密算法，程序会自动检查加密算法：
```
# 下载
AliPCS-Py download /to/here/some-file.mp4 /to/here/some-dir/ --encrypt-password 'onlyyou'
# 开启本地服务并播放
AliPCS-Py play /to/here/some-file.mp4 --encrypt-password 'onlyyou' --use-local-server
```
显示当前用户的密钥：
```
AliPCS-Py who --show-encrypt-password
```
AliPCS-Py 下载时默认会解密文件，如果想要下载但不解密文件，需要加 `--no-decrypt`
```
AliPCS-Py download some-file --no-decrypt
```
## 文件操作
AliPCS-Py 操作网盘中的文件可以使用文件的绝对路径或相对路径（相对与当前目录 pwd）。
每一个用户都有自己的当前工作目录（pwd），默认为 `/` 根目录。
使用者可以用 `cd` 命令来切换当前的工作目录（pwd）。
下面所有涉及网盘路径的命令，其中如果网盘路径用的是相对路径，那么是相对于当前工作目录（pwd）的。
如果是网盘路径用的是绝对路径，那么就是这个绝对路径。
## 显示当前工作目录
```
AliPCS-Py pwd
```
## 切换当前工作目录
切换到绝对路径：
```
AliPCS-Py cd /to/some/path
```
切换到相对路径：
```
# 切换到 (pwd)/../path
AliPCS-Py cd ../path
```
## 列出网盘路径下的文件
使用文件路径：
```
AliPCS-Py ls [OPTIONS] [REMOTEPATHS]...
AliPCS-Py ls /absolute/path
# or
AliPCS-Py ls relative/path
```
使用文件 ID：
```
AliPCS-Py ls -i file_id1 -i file_id2 -i ...
```
### 选项
| Option | Description |
| -------------------------- | ----------------------------------------------------- |
| -i, --file-id TEXT | 文件 ID |
| --share-id, --si TEXT | 列出这个分享 ID 下的文件 |
| --share-url, --su TEXT | 列出这个分享 url 下的文件 |
| -p, --password TEXT | 分享链接密码，如果没有不用设置 |
| -r, --desc | 逆序排列文件 |
| -n, --name | 依名字排序 |
| -t, --time | 依时间排序 |
| -s, --size | 依文件大小排序 |
| -R, --recursive | 递归列出文件 |
| -I, --include TEXT | 筛选包含这个字符串的文件 |
| --include-regex, --IR TEXT | 筛选包含这个正则表达式的文件 |
| -E, --exclude TEXT | 筛选 **不** 包含这个字符串的文件 |
| --exclude-regex, --ER TEXT | 筛选 **不** 包含这个正则表达式的文件 |
| -f, --is-file | 筛选 **非** 目录文件 |
| -d, --is-dir | 筛选目录文件 |
| --no-highlight, --NH | 取消匹配高亮 |
| -S, --show-size | 显示文件大小 |
| -D, --show-date | 显示文件创建时间 |
| --show-file-id, --ID | 显示文件 ID |
| -M, --show-hash | 显示文件 sha1 |
| -A, --show-absolute-path | 显示文件绝对路径 |
| --show-dl-link, --DL | 显示文件下载连接 |
| --csv | 用 csv 格式显示，单行显示，推荐和 --DL 或 --HL 一起用 |
| --only-dl-link, --ODL | 只显示文件下载连接 |
## 搜索文件
搜索包含 `keyword` 的文件
```
AliPCS-Py search [OPTIONS] KEYWORD [REMOTEDIR]
# 在当前工作目录中搜索
AliPCS-Py search keyword
# or
AliPCS-Py search keyword /absolute/path
# or
AliPCS-Py search keyword relative/path
```
### 选项
| Option | Description |
| -------------------------- | ------------------------------------ |
| -R, --recursive | 递归搜索文件 |
| -I, --include TEXT | 筛选包含这个字符串的文件 |
| --include-regex, --IR TEXT | 筛选包含这个正则表达式的文件 |
| -E, --exclude TEXT | 筛选 **不** 包含这个字符串的文件 |
| --exclude-regex, --ER TEXT | 筛选 **不** 包含这个正则表达式的文件 |
| -f, --is-file | 筛选 **非** 目录文件 |
| -d, --is-dir | 筛选目录文件 |
| --no-highlight, --NH | 取消匹配高亮 |
| -S, --show-size | 显示文件大小 |
| -D, --show-date | 显示文件创建时间 |
| -M, --show-hash | 显示文件 sha1 |
| --csv | 用 csv 格式显示 |
## 显示文件内容
```
AliPCS-Py cat [OPTIONS] REMOTEPATH
```
### 选项
| Option | Description |
| ----------------------------- | ---------------------------- |
| -e, --encoding TEXT | 文件编码，默认自动解码 |
| --no-decrypt, --ND | 不解密 |
| --encrypt-password, --ep TEXT | 加密密码，默认使用用户设置的 |
## 创建目录
```
AliPCS-Py mkdir [OPTIONS] [REMOTEDIRS]...
```
### 选项
| Option | Description |
| ---------- | ----------- |
| -S, --show | 显示目录 |
## 移动文件
移动一些文件到一个目录中。
```
AliPCS-Py move [OPTIONS] [REMOTEPATHS]... REMOTEDIR
```
### 选项
| Option | Description |
| ---------- | ----------- |
| -S, --show | 显示结果 |
## 文件重命名
```
AliPCS-Py rename [OPTIONS] REMOTEPATH NEW_NAME
```
e.g.
重命名 `/path/to/far` to `/path/to/foo`
```
AliPCS-Py rename /path/to/far foo
```
### 选项
| Option | Description |
| ---------- | ----------- |
| -S, --show | 显示结果 |
## 拷贝文件
拷贝一些文件到一个目录中。
```
AliPCS-Py move [OPTIONS] [REMOTEPATHS]... REMOTEDIR
```
### 选项
| Option | Description |
| ---------- | ----------- |
| -S, --show | 显示结果 |
## 删除文件
```
AliPCS-Py remove [OPTIONS] [REMOTEPATHS]...
# 指定 路径
AliPCS-Py remove /some/path
# 指定 file-id
AliPCS-Py remove --file-id ...
```
### 选项
| Option | Description |
| ------------- | ------------ |
| -i, --file-id | TEXT 文件 ID |
## 下载文件或目录
> 在使用了阿里云盘开放平台 api 时，如果下载他人分享的文件，文件会先保存到 `/__alipcs_py_temp__`，在从其中下载。
> 下载结束后，会删除 `__alipcs_py_temp__` 中下载的文件。
使用文件路径：
```
AliPCS-Py download [OPTIONS] [REMOTEPATHS]...
```
使用文件 ID：
```
AliPCS-Py download -i file_id1 -i file_id2 -i ...
```
### 选项
| Option | Description |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| -i, --file-id TEXT | 文件 ID |
| --share-id, --si TEXT | 下载这个分享 ID 下的文件 |
| --share-url, --su TEXT | 下载这个分享 url 下的文件 |
| -p, --password TEXT | 分享链接密码，如果没有不用设置 |
| -o, --outdir TEXT | 指定下载本地目录，默认为当前目录 |
| -R, --recursive | 递归下载 |
| -f, --from-index INTEGER | 从所有目录中的第几个文件开始下载，默认为 0（第一个） |
| -I, --include TEXT | 筛选包含这个字符串的文件 |
| --include-regex, --IR TEXT | 筛选包含这个正则表达式的文件 |
| -E, --exclude TEXT | 筛选 不 包含这个字符串的文件 |
| --exclude-regex, --ER TEXT | 筛选 不 包含这个正则表达式的文件 |
| -s, --concurrency INTEGER | 下载同步链接数，默认为 5。建议小于 10。 |
| -k, --chunk-size TEXT | 同步链接分块大小，默认为 50MB |
| -q, --quiet | 取消第三方下载应用输出 |
| --out-cmd, --OC | 输出第三方下载应用命令 |
| -d, --downloader [ me \| aget_py \| aget_rs \| aria2 ] | 指定下载应用<br> <br> 默认为 me (AliPCS-Py 自己的下载器，支持断续下载)<br> me 使用多文件并发下载。<br> <br> 除 me 外，其他下载器，不使用多文件并发下载，使用一个文件多链接下载。<br> 如果需要下载多个小文件推荐使用 me，如果需要下载少量大文件推荐使用其他下载器。<br> <br> aget_py (https://github.com/PeterDing/aget) 默认安装<br> aget_rs (下载 https://github.com/PeterDing/aget-rs/releases)<br> aria2 (下载 https://github.com/aria2/aria2/releases)<br> |
| --encrypt-password, --ep TEXT | 加密密码，默认使用用户设置的 |
## 播放媒体文件
> 在使用了阿里云盘开放平台 api 时，如果播放他人分享的文件，文件会先保存到 `/__alipcs_py_temp__`，在从其中播放。
> 播放结束后，会删除 `__alipcs_py_temp__` 中播放的文件。
使用文件路径：
```
AliPCS-Py play [OPTIONS] [REMOTEPATHS]...
```
使用文件 ID：
**注意：目前，使用 `--share-id` 或 `--file-id` 时，无法使用 `--use-local-server`**
```
AliPCS-Py play -i file_id1 -i file_id2 -i ...
```
`play` 命令默认播放带有媒体后缀的文件，如 `abc.mp4`, `abc.mp3`。如果需要播放的媒体文件没有用常规的媒体文件后缀，则需要加选项 `--ignore-ext`。
### 选项
| Option | Description |
| ----------------------------- | ---------------------------------------------------- |
| -i, --file-id TEXT | 文件 ID |
| --share-id, --si TEXT | 播放这个分享 ID 下的文件 |
| --share-url, --su TEXT | 播放这个分享 url 下的文件 |
| -p, --password TEXT | 链接密码，如果没有不用设置 |
| -R, --recursive | 递归播放 |
| -f, --from-index INTEGER | 从所有目录中的第几个文件开始播放，默认为 0（第一个） |
| -I, --include TEXT | 筛选包含这个字符串的文件 |
| --include-regex, --IR TEXT | 筛选包含这个正则表达式的文件 |
| -E, --exclude TEXT | 筛选 不 包含这个字符串的文件 |
| --exclude-regex, --ER TEXT | 筛选 不 包含这个正则表达式的文件 |
| --player-params, --PP TEXT | 第三方播放器参数 |
| -q, --quiet | 取消第三方播放器输出 |
| --shuffle, --sf | 随机播放 |
| --ignore-ext, --IE | 不用文件名后缀名来判断媒体文件 |
| --out-cmd, --OC | 输出第三方播放器命令 |
| --pl, --player [mpv] | 指定第三方播放器<br><br>默认为 mpv (https://mpv.io) |
| -s, --use-local-server | 使用本地服务器播放。 |
| --encrypt-password, --ep TEXT | 加密密码，默认使用用户设置的 |
## 上传文件
上传一些本地文件或目录到网盘目录。
AliPCS-Py 首先会尝试秒传。如果秒传失败，会使用分片上传上传文件。
上传过程中，按 “p” 可以暂停或继续上传。
```
AliPCS-Py upload [OPTIONS] [LOCALPATHS]... REMOTEDIR
```
指定同时上传连接数量:
`--max-workers` 默认为 CPU 核数。
```
AliPCS-Py upload --max-workers 4 [OPTIONS] [LOCALPATHS]... REMOTEDIR
```
如果上传本地目录 `localdir` 到远端目录 `remotedir`，AliPCS-Py 是将 `localdir` 这个目录上传到远端目录 `remotedir` 下。
比如，`localdir` 下有 2 个文件 `a`，`b` 和一个下级目录 `sub/`，如果运行 `AliPCS-Py upload localdir remotedir`，结果是远端目录 `remotedir` 下增加了 1 个下级目录和它的所有文件 `localdir/a`，`localdir/b` 和一个下级目录 `localdir/sub/`。
如果要将 `localdir` 下的所有文件（包括下级目录）上传到远端目录 `remotedir`，用 `AliPCS-Py upload localdir/* remotedir`
### 选项
| Option | Description |
| ---------------------------------------------------------- | ------------------------------------- |
| --encrypt-password, --ep TEXT | 加密密码，默认使用用户设置的 |
| -e, --encrypt-type [No \| Simple \| ChaCha20 \| AES256CBC] | 文件加密方法，默认为 No 不加密 |
| -w, --max-workers INTEGER | 同时上传文件连接数量，默认为 CPU 核数 |
| --no-ignore-existing, --NI | 上传已经存在的文件 |
| --no-show-progress, --NP | 不显示上传进度 |
## 同步本地目录到远端
同步本地目录到远端。
如果本地文件最后修改时间或大小和远端不同则上传文件。对于本地不存在的文件但远端存在则删除远端文件。
```
AliPCS-Py sync [OPTIONS] LOCALDIR REMOTEDIR
```
### 选项
| Option | Description |
| ---------------------------------------------------------- | ------------------------------ |
| --encrypt-password, --ep TEXT | 加密密码，默认使用用户设置的 |
| -e, --encrypt-type [No \| Simple \| ChaCha20 \| AES256CBC] | 文件加密方法，默认为 No 不加密 |
| -w, --max-workers INTEGER | 同时上传文件数 |
| --no-show-progress, --NP | 不显示上传进度 |
## 关于秒传连接
**阿里云盘已经不能实现用秒传连接上传。**
## 分享文件
```
AliPCS-Py share [OPTIONS] [REMOTEPATHS]...
```
### 选项
| Option | Description |
| --------------------------- | -------------------------------- |
| -p, --password TEXT | 设置秘密，4 个字符。默认没有秘密 |
| --period-time, --pt INTEGER | 设置分享有效期，单位为天 |
## 列出分享链接
```
AliPCS-Py shared
```
### 选项
| Option | Description |
| -------------- | -------------------------------------------- |
| -A, --show-all | 显示所有分享的链接，默认只显示有效的分享链接 |
## 取消分享链接
```
AliPCS-Py cancelshared [OPTIONS] [SHARE_IDS]...
```
## 列出其他用户分享链接中的文件
给 `ls` 命令加参数，我们可以列出其他用户分享链接中的文件。
**注意: 这里 `remotepaths` 只能是绝对路径。**
如果有分享密码，加上 `--password PASSWORD`。
- 使用分享连接
```
AliPCS-Py ls --share-url SHARE_URL
# e.g.
# 列出这个分享url的根目录
AliPCS-Py ls --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi
# 递归列出这个分享url的文件
AliPCS-Py ls --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi -R
# 列出这个分享url的指定目录
AliPCS-Py ls --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi/folder/613397974b634251e0554d7cb56df3e46d473239
```
- 使用分享 ID
分享 ID 是 https://www.aliyundrive.com/s/DaNNsdvi9bi 中的 `DaNNsdvi9bi`
```
AliPCS-Py ls /path --share-id SHARE_ID
# e.g.
# 列出这个分享ID的根目录
AliPCS-Py ls / --share-id DaNNsdvi9bi
# 列出这个分享ID下，文件名为 "613397974b634251e0554d7cb56df3e46d473239" 的文件
AliPCS-Py ls --file-id 613397974b634251e0554d7cb56df3e46d473239 --share-id DaNNsdvi9bi
```
### 选项
见 `ls` 命令。
## 下载他人分享的文件
使用 `--share-id` 或 `--share-url` 选项，`download` 命令可以直接下载他人分享的文件。
**注意: 这里必须指定下载绝对路径或 file id**
```
AliPCS-Py download /path --share-url SHARED_URL
# or
AliPCS-Py download /path --share-id SHARED_URL
# or
AliPCS-Py download --file-id FILE_ID --share-id SHARED_URL
```
- 使用分享连接
```
# 下载这个分享url下的根目录中的文件
AliPCS-Py download / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi
# 递归下载这个分享url下的所有的文件
AliPCS-Py download / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi -R
# 下载这个分享url的指定目录
AliPCS-Py download --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi/folder/613397974b634251e0554d7cb56df3e46d473239
```
- 使用分享 ID
```
# 下载这个分享url下的根目录中的文件
AliPCS-Py download / --share-id DaNNsdvi9bi
# 递归下载这个分享url下的所有的文件
AliPCS-Py download / --share-id DaNNsdvi9bi -R
# 下载这个分享ID下，文件名为 "613397974b634251e0554d7cb56df3e46d473239" 的文件
AliPCS-Py download --file-id 613397974b634251e0554d7cb56df3e46d473239 --share-id DaNNsdvi9bi
```
### 选项
见 `download` 命令。
## 播放他人分享的文件
使用 `--share-id` 或 `--share-url` 选项，`play` 命令可以直接播放他人分享的媒体文件。
**注意: 这里必须指定下载绝对路径或 file id**
```
AliPCS-Py play /path --share-url SHARED_URL
# or
AliPCS-Py play /path --share-id SHARED_URL
# or
AliPCS-Py play --file-id FILE_ID --share-id SHARED_URL
```
- 使用分享连接
```
# 播放这个分享url下的根目录中的文件
AliPCS-Py play / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi
# 递归播放这个分享url下的所有的文件
AliPCS-Py play / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi -R
# 播放这个分享url的指定目录
AliPCS-Py play --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi/folder/613397974b634251e0554d7cb56df3e46d473239
```
- 使用分享 ID
```
# 播放这个分享url下的根目录中的文件
AliPCS-Py play --share-id DaNNsdvi9bi
# 递归播放这个分享url下的所有的文件
AliPCS-Py play --share-id DaNNsdvi9bi -R
# 播放这个分享ID下，文件名为 "613397974b634251e0554d7cb56df3e46d473239" 的文件
AliPCS-Py play --file-id 613397974b634251e0554d7cb56df3e46d473239 --share-id DaNNsdvi9bi
```
### 选项
见 `play` 命令。
## 保存其他用户分享的链接
保存其他用户分享的链接到远端目录。
```
AliPCS-Py save [OPTIONS] SHARE_URL_OR_ID REMOTEDIR
```
指定 `--file-id` 可以保存指定的文件。
### 选项
| Option | Description |
| ------------------- | ------------------------------ |
| -i, --file-id TEXT | 文件 ID |
| -p, --password TEXT | 分享链接密码，如果没有不用设置 |
## 本地保存分享连接
可以将他人分享了连接保存至本地，而不需要保存在网盘。这只作为一个记录。在需要是提供查看搜索功能。
使用这个功能，需要使用者在本地配置文件(`~/.alipcs-py/config.toml`)中配置:
```toml
[share]
store = true
```
这个功能开启后，所有与他人分享连接的操作，都会将连接和其中访问过的文件信息保存在本地文件 `~/.alipcs-py/shared-store.sqlite3` 中。
使用者可以用下面的命令来查看或搜索保存的分享连接。
## 保存分享连接至本地
```
AliPCS-Py storesharedlinks [OPTIONS] [SHARE_URLS_OR_IDS]...
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
| Option | Description |
| ------------------- | ------------------------------ |
| -p, --password TEXT | 分享链接密码，如果没有不用设置 |
## 显示本地保存的分享连接
```
AliPCS-Py listsharedlinks
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
## 显示本地保存的分享文件
```
AliPCS-Py listsharedfiles [OPTIONS]
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
| Option | Description |
| --------------------- | -------------------------- |
| --share-id, --si TEXT | 指定显示 share id 下的文件 |
## 查找本地保存的分享连接
```
AliPCS-Py findsharedlinks [KEYWORDS]...
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
## 查找本地保存的分享文件
```
AliPCS-Py findsharedfiles [KEYWORDS]...
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
| Option | Description |
| --------------------- | ----------------- |
| --share-id, --si TEXT | 要搜索的 share id |
| -v, --verbose | 显示细节 |
## 查找本地保存的分享连接和文件
```
AliPCS-Py findshared [OPTIONS] [KEYWORDS]...
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
| Option | Description |
| ------------- | ----------- |
| -v, --verbose | 显示细节 |
## 删除本地保存的分享连接或文件
```
AliPCS-Py deletestoredshared [OPTIONS] [SHARE_IDS]...
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
| Option | Description |
| ------------------ | ---------------------------------------------------------- |
| -k, --keyword TEXT | 要删除文件名的关键字，如果为空则删除 share_id 下的所有文件 |
## 清理本地保存的无效分享连接
```
AliPCS-Py cleanstore
```
**注意**: 使用这个命令必须将配置文件 ~/.alipcs-py/config.toml 中的 [share] store 设为 true
## 开启 HTTP 服务
在远端 `ROOT_DIR` 目录下开启 HTTP 服务。
`ROOT_DIR` 默认为 `/`
```
AliPCS-Py AliPCS-Py server [OPTIONS] [ROOT_DIR]
```
如果需要设置认证，使用下面的选项设置用户名和密钥：
```
AliPCS-Py AliPCS-Py server [ROOT_DIR] --username 'foo' --password 'bar'
```
也可以指定服务路径：
```
AliPCS-Py AliPCS-Py server [ROOT_DIR] --path '/my/pan'
# 访问 http://localhost:8000/my/pan/
```
### 选项
| Option | Description |
| ----------------------------- | ---------------------------- |
| --path TEXT | 服务路径，默认为 “/” |
| -h, --host TEXT | 监听 host |
| -p, --port INTEGER | 监听 port |
| -w, --workers INTEGER | 进程数 |
| --encrypt-password, --ep TEXT | 加密密码，默认使用用户设置的 |
| --username TEXT | HTTP Basic Auth 用户名 |
| --password TEXT | HTTP Basic Auth 密钥 |
Raw data
{
"_id": null,
"home_page": "https://github.com/PeterDing/AliPCS-Py",
"name": "AliPCS-Py",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "PeterDing",
"author_email": "dfhayst@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/11/83/b29af2d9256017e0362d623466e2b06efe24c6204cb8b511ebc8c36383ef/alipcs_py-0.8.0.tar.gz",
"platform": null,
"description": "# AliPCS-Py\n\n**2023-04-24 \u652f\u6301 \u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0 api\u3002**\n\n**2023-02-15 \u4f7f\u7528\u4e34\u65f6 API \u63a5\u53e3\uff0c\u8ba9\u4e0b\u8f7d\u53ef\u7528\u3002**\n\n**2023-02-14 \u963f\u91cc\u7f51\u76d8 API \u4e0b\u8f7d\u63a5\u53e3\u4e0d\u518d\u63d0\u4f9b\u7b2c\u4e09\u65b9\u5e94\u7528\u4f7f\u7528\u3002\u9700\u8981\u7533\u8bf7\u4f7f\u7528\u5b98\u65b9 API \u63a5\u53e3\u3002\u76ee\u524d\u5b98\u65b9 API \u63a5\u53e3\u5728\u5185\u6d4b\u4e2d\u3002\u672c\u9879\u76ee\u5df2\u63d0\u4ea4\u5185\u6d4b\u7533\u8bf7\uff0c\u7b49\u5f85\u56de\u590d\u4e2d\u3002\u5728\u6b64\u671f\u95f4\u4e0b\u8f7d\u529f\u80fd\u4e0d\u80fd\u4f7f\u7528\u3002**\n\n[](https://badge.fury.io/py/alipcs-py)\n\n\nAn AliPCS API and An App\n\nAliPCS-Py \u662f\u963f\u91cc\u4e91\u76d8\u7684\u975e\u5b98\u65b9 api \u548c\u4e00\u4e2a\u547d\u4ee4\u884c\u8fd0\u7528\u7a0b\u5e8f\u3002\n\n\u53d8\u66f4\u65e5\u5fd7\u5728 [CHANGELOG.md](./CHANGELOG.md)\u3002\n\n---\n\n## \u767e\u5ea6\u4e91\u76d8 api \u548c \u547d\u4ee4\u884c\u5ba2\u6237\u7aef\u5728 https://github.com/PeterDing/BaiduPCS-Py\n\n---\n\n- [\u5b89\u88c5](#\u5b89\u88c5)\n- [\u66f4\u65b0](#\u66f4\u65b0)\n- [API](#API)\n- [\u7528\u6cd5](#\u7528\u6cd5)\n- [\u547d\u4ee4\u522b\u540d](#\u547d\u4ee4\u522b\u540d)\n- [\u5bf9\u591a\u4e2a\u5e10\u53f7\u8fdb\u884c\u76f8\u540c\u64cd\u4f5c](#\u5bf9\u591a\u4e2a\u5e10\u53f7\u8fdb\u884c\u76f8\u540c\u64cd\u4f5c)\n\n#### \u7528\u6237\u76f8\u5173\u547d\u4ee4\n\n- [\u6dfb\u52a0\u7528\u6237](#\u6dfb\u52a0\u7528\u6237)\n- [\u663e\u793a\u5f53\u524d\u7528\u6237\u7684\u4fe1\u606f](#\u663e\u793a\u5f53\u524d\u7528\u6237\u7684\u4fe1\u606f)\n- [\u66f4\u65b0\u7528\u6237\u4fe1\u606f](#\u66f4\u65b0\u7528\u6237\u4fe1\u606f)\n- [\u663e\u793a\u6240\u6709\u7528\u6237](#\u663e\u793a\u6240\u6709\u7528\u6237)\n- [\u5207\u6362\u5f53\u524d\u7528\u6237](#\u5207\u6362\u5f53\u524d\u7528\u6237)\n- [\u5220\u9664\u4e00\u4e2a\u7528\u6237](#\u5220\u9664\u4e00\u4e2a\u7528\u6237)\n- [\u663e\u793a\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55](#\u663e\u793a\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55)\n- [\u5207\u6362\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55](#\u5207\u6362\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55)\n\n#### \u65e0\u611f\u52a0\u5bc6\u89e3\u5bc6\u6587\u4ef6\n\n- [\u8bbe\u7f6e\u6587\u4ef6\u52a0\u5bc6\u5bc6\u7801](#\u8bbe\u7f6e\u6587\u4ef6\u52a0\u5bc6\u5bc6\u7801)\n\n#### \u6587\u4ef6\u64cd\u4f5c\u76f8\u5173\u547d\u4ee4\n\n- [\u6587\u4ef6\u64cd\u4f5c](#\u6587\u4ef6\u64cd\u4f5c)\n- [\u5217\u51fa\u7f51\u76d8\u8def\u5f84\u4e0b\u7684\u6587\u4ef6](#\u5217\u51fa\u7f51\u76d8\u8def\u5f84\u4e0b\u7684\u6587\u4ef6)\n- [\u641c\u7d22\u6587\u4ef6](#\u641c\u7d22\u6587\u4ef6)\n- [\u663e\u793a\u6587\u4ef6\u5185\u5bb9](#\u663e\u793a\u6587\u4ef6\u5185\u5bb9)\n- [\u521b\u5efa\u76ee\u5f55](#\u521b\u5efa\u76ee\u5f55)\n- [\u79fb\u52a8\u6587\u4ef6](#\u79fb\u52a8\u6587\u4ef6)\n- [\u6587\u4ef6\u91cd\u547d\u540d](#\u6587\u4ef6\u91cd\u547d\u540d)\n- [\u62f7\u8d1d\u6587\u4ef6](#\u62f7\u8d1d\u6587\u4ef6)\n- [\u5220\u9664\u6587\u4ef6](#\u5220\u9664\u6587\u4ef6)\n- [\u4e0b\u8f7d\u6587\u4ef6\u6216\u76ee\u5f55](#\u4e0b\u8f7d\u6587\u4ef6\u6216\u76ee\u5f55)\n- [\u64ad\u653e\u5a92\u4f53\u6587\u4ef6](#\u64ad\u653e\u5a92\u4f53\u6587\u4ef6)\n- [\u4e0a\u4f20\u6587\u4ef6](#\u4e0a\u4f20\u6587\u4ef6)\n- [\u540c\u6b65\u672c\u5730\u76ee\u5f55\u5230\u8fdc\u7aef](#\u540c\u6b65\u672c\u5730\u76ee\u5f55\u5230\u8fdc\u7aef)\n\n#### \u79d2\u4f20\n\n- [\u5173\u4e8e\u79d2\u4f20\u8fde\u63a5](#\u5173\u4e8e\u79d2\u4f20\u8fde\u63a5)\n\n#### \u5206\u4eab\u76f8\u5173\u547d\u4ee4\n\n- [\u5206\u4eab\u6587\u4ef6](#\u5206\u4eab\u6587\u4ef6)\n- [\u5217\u51fa\u5206\u4eab\u94fe\u63a5](#\u5217\u51fa\u5206\u4eab\u94fe\u63a5)\n- [\u53d6\u6d88\u5206\u4eab\u94fe\u63a5](#\u53d6\u6d88\u5206\u4eab\u94fe\u63a5)\n- [\u5217\u51fa\u5176\u4ed6\u7528\u6237\u5206\u4eab\u94fe\u63a5\u4e2d\u7684\u6587\u4ef6](#\u5217\u51fa\u5176\u4ed6\u7528\u6237\u5206\u4eab\u94fe\u63a5\u4e2d\u7684\u6587\u4ef6)\n- [\u4e0b\u8f7d\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6](#\u4e0b\u8f7d\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6)\n- [\u64ad\u653e\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6](#\u64ad\u653e\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6)\n- [\u4fdd\u5b58\u5176\u4ed6\u7528\u6237\u5206\u4eab\u7684\u94fe\u63a5](#\u4fdd\u5b58\u5176\u4ed6\u7528\u6237\u5206\u4eab\u7684\u94fe\u63a5)\n\n#### \u672c\u5730\u4fdd\u5b58\u5206\u4eab\u8fde\u63a5\n\n- [\u4fdd\u5b58\u5206\u4eab\u8fde\u63a5\u81f3\u672c\u5730](#\u4fdd\u5b58\u5206\u4eab\u8fde\u63a5\u81f3\u672c\u5730)\n- [\u663e\u793a\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5](#\u663e\u793a\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5)\n- [\u663e\u793a\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u6587\u4ef6](#\u663e\u793a\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u6587\u4ef6)\n- [\u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5](#\u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5)\n- [\u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u6587\u4ef6](#\u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u6587\u4ef6)\n- [\u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u548c\u6587\u4ef6](#\u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u548c\u6587\u4ef6)\n- [\u5220\u9664\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u6216\u6587\u4ef6](#\u5220\u9664\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u6216\u6587\u4ef6)\n- [\u6e05\u7406\u672c\u5730\u4fdd\u5b58\u7684\u65e0\u6548\u5206\u4eab\u8fde\u63a5](#\u6e05\u7406\u672c\u5730\u4fdd\u5b58\u7684\u65e0\u6548\u5206\u4eab\u8fde\u63a5)\n\n#### HTTP \u670d\u52a1\n\n- [\u5f00\u542f HTTP \u670d\u52a1](#\u5f00\u542f-HTTP-\u670d\u52a1)\n\n## \u5b89\u88c5\n\n\u9700\u8981 Python \u7248\u672c\u5927\u4e8e\u6216\u7b49\u4e8e 3.8\n\n```\npip3 install Cython\npip3 install AliPCS-Py\n```\n\n### Windows \u4f9d\u8d56\n\n\u5728 Windows \u4e0a\uff0cAliPCS-Py \u4f9d\u8d56 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)\u3002\n\n\u5728\u5b89\u88c5 AliPCS-Py \u524d\uff0c\u8bf7\u5148\u5b89\u88c5 [Microsoft C++ Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)\uff0c\u518d\u5728\u5176\u4e2d\u52fe\u9009 `C++ \u751f\u6210\u5de5\u5177` \u5e76\u5b89\u88c5\u3002\u5b8c\u6210\u540e\u5373\u53ef\u5b89\u88c5 AliPCS-Py\u3002\n\n## \u66f4\u65b0\n\n```\npip3 install AliPCS-Py --upgrade\n```\n\n## API\n\nAliPCS-Py \u7684\u963f\u91cc\u4e91\u76d8 API \u53ea\u4f9d\u8d56 requests\uff0c\u65b9\u4fbf\u7528\u6237\u5f00\u53d1\u81ea\u5df1\u7684\u8fd0\u7528\u3002\n\n```python\nfrom alipcs_py.alipcs import AliPCSApi\n\napi = AliPCSApi(refresh_token)\n```\n\n## \u7528\u6cd5\n\n```\nAliPCS-Py --help\n```\n\n## \u547d\u4ee4\u522b\u540d\n\n\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u547d\u4ee4\u522b\u540d\u4ee3\u66ff\u539f\u6765\u7684\u547d\u4ee4\u540d\u3002\n\n| \u522b\u540d | \u539f\u540d |\n| ---- | ------------ |\n| w | who |\n| uu | updateuser |\n| su | su |\n| ul | userlist |\n| ua | useradd |\n| ep | encryptpwd |\n| ud | userdel |\n| l | ls |\n| f | search |\n| md | mkdir |\n| mv | move |\n| rn | rename |\n| cp | copy |\n| rm | remove |\n| d | download |\n| p | play |\n| u | upload |\n| sn | sync |\n| S | share |\n| sl | shared |\n| cs | cancelshared |\n| s | save |\n| sv | server |\n\n## \u5bf9\u591a\u4e2a\u5e10\u53f7\u8fdb\u884c\u76f8\u540c\u64cd\u4f5c\n\nAliPCS-Py \u652f\u6301\u5bf9\u591a\u4e2a\u5e10\u53f7\u8fdb\u884c\u76f8\u540c\u64cd\u4f5c\u3002\u6bd4\u5982\uff0c\u7528\u76f8\u540c\u5173\u952e\u5b57\u641c\u7d22\u591a\u4e2a\u5e10\u53f7\uff0c\u4e0a\u4f20\u76f8\u540c\u7684\u6587\u4ef6/\u76ee\u5f55\u5230\u591a\u4e2a\u5e10\u53f7\uff0c\u7b49\u7b49\u3002\n\n\u4f7f\u7528\u8005\u53ea\u9700\u7528 `--users` \u9009\u9879\u6765\u6307\u5b9a\u8981\u64cd\u4f5c\u7684\u5e10\u53f7\u540d\u5373\u53ef\u3002\n\n`--users` \u63a5\u53d7\u4e00\u4e2a\u53c2\u6570\uff0c\u8fd9\u4e2a\u53c2\u6570\u662f\u7528\u201c,\u201d\u8fde\u63a5\u7684\u8981\u8fdb\u884c\u64cd\u4f5c\u5e10\u53f7\u540d\u7684\u90e8\u5206\u5b57\u7b26\u3002\u5047\u8bbe\u6211\u4eec\u73b0\u5728\u6709 3 \u4e2a\u5e10\u53f7\uff0c\u5e10\u53f7\u540d\u5206\u522b\u662f `Tom`\uff0c`Peter`\uff0c`Joy`\u3002\n\u73b0\u5728\u6211\u8981\u540c\u65f6\u5bf9`Tom`\u548c`Joy`\u8fdb\u884c\u5173\u952e\u5b57\u641c\u7d22\u3002\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u547d\u4ee4\u8fdb\u884c\uff1a\n\n```\nAliPCS-Py --users 'Tom,Joy' search 'keyword' / -R\n```\n\n\u6216\u8005\u7ed9\u51fa\u5e10\u53f7\u540d\u7684\u90e8\u5206\u7247\u6bb5\uff1a\n\n```\nAliPCS-Py --users 'om,oy' search 'keyword' / -R\n```\n\n\u66f4\u7b80\u5355\u53ef\u4ee5\u7528\uff1a\n\n```\n# Tom, Joy \u90fd\u5305\u542b\u5b57\u7b26 \"o\"\nAliPCS-Py --users 'o' search 'keyword' / -R\n```\n\n\u5982\u679c\u8981\u5bf9\u6240\u6709\u5e10\u53f7\u8fdb\u884c\u64cd\u4f5c\u7528 `--users ''`\u3002\n\n\u5982\u679c\u4e0d\u4f7f\u7528 `--users` \u9009\u9879\uff0c\u9ed8\u8ba4\u53ea\u5bf9\u5f53\u524d\u5e10\u53f7\u8fdb\u884c\u64cd\u4f5c\u3002\n\n\u4ee5\u4e0b\u547d\u4ee4\u652f\u6301\u5bf9\u591a\u4e2a\u5e10\u53f7\u8fdb\u884c\u64cd\u4f5c\uff1a\n\n- pwd\n- ls\n- search\n- cat\n- mkdir\n- move\n- rename\n- copy\n- remove\n- download\n- play\n- upload\n- sync\n- share\n- shared\n- cancelshared\n- save\n- server\n\n**\u6ce8\u610f**: `--users` \u4e00\u5b9a\u8981\u8ddf\u5728 `AliPCS-Py` \u540e\uff0c\u547d\u4ee4\u524d\u3002\n\n## \u6dfb\u52a0\u7528\u6237\n\n**\u4ece 2023-02-14 \u5f00\u59cb\uff0c\u963f\u91cc\u4e91\u76d8\u5b98\u65b9\u9650\u5236\u4e86 web \u7aef api \u7684\u8c03\u7528\u3002\u4ece web \u7aef api \u83b7\u53d6\u5230\u7684\u4e0b\u8f7d\u8fde\u63a5\u662f\u9650\u901f\u7684\u3002\u4f46\u5982\u679c\u8c03\u7528[\u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0](https://survey.alibaba.com/apps/zhiliao/I9Dd1Nl89)\u7684 api \u83b7\u53d6\u5230\u7684\u4e0b\u8f7d\u8fde\u63a5\u662f\u4e0d\u9650\u901f\u7684\u3002**\n\nAliPCS-Py (>= v0.6.0) \u652f\u6301\u8c03\u7528\u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0 api\u3002\u4f46\u662f\u7531\u4e8e\u4e00\u76f4\u6ca1\u6709\u62ff\u5230\u5185\u6d4b\uff0c\u6ca1\u6cd5\u63d0\u4f9b\u9ed8\u8ba4\u767b\u5f55\u64cd\u4f5c\u3002\u9700\u8981\u7528\u6237\u81ea\u5df1\u627e\u5176\u4ed6\u5e94\u7528\u63d0\u4f9b\u7684\u767b\u5f55\u65b9\u5f0f\u767b\u5f55\u3002\n\n### \u4f7f\u7528 web `refresh_token` \u548c \u7b2c\u4e09\u65b9\u8ba4\u8bc1\u5730\u5740 \u767b\u5f55\n\n\u7b2c\u4e09\u65b9\u8ba4\u8bc1\u5730\u5740\u63d0\u4f9b\u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0\u7684\u8ba4\u8bc1\u670d\u52a1\u3002\u7531\u4e8e\u4e00\u76f4\u6ca1\u6709\u62ff\u5230\u5185\u6d4b\uff0c\u672c\u9879\u76ee\u76ee\u524d\u6ca1\u6cd5\u63d0\u4f9b\u3002\u9700\u8981\u4f7f\u7528\u8005\u81ea\u884c\u5bfb\u627e\u3002\n\n\u4ea4\u4e92\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py useradd\n```\n\n\u6216\u8005\u76f4\u63a5\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py useradd --web-refresh-token \"...\" --client-server \"...\"\n# \u5176\u4ed6\u9009\u9879\u7559\u7a7a\n```\n\n\u4e4b\u540e\u7528\u963f\u91cc\u4e91\u76d8 APP \u626b\u7801\u767b\u5f55\u3002\n\n### \u4f7f\u7528 web `refresh_token` \u548c \u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0\u8ba4\u8bc1\u51ed\u8bc1 \u767b\u5f55\n\n\u5982\u679c\u4f7f\u7528\u8005\u62ff\u5230\u4e86\u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0\u8ba4\u8bc1\uff0c\u4f1a\u83b7\u5f97 `client-id` \u548c `client-secret`\u3002\u4f7f\u7528\u8fd9\u4e24\u4e2a\u503c\u53ef\u4ee5\u76f4\u63a5\u767b\u5f55\u3002\n\n\u4ea4\u4e92\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py useradd\n```\n\n\u6216\u8005\u76f4\u63a5\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py useradd --web-refresh-token \"...\" --client-id \"...\" --client-secret \"...\"\n# \u5176\u4ed6\u9009\u9879\u7559\u7a7a\n```\n\n\u4e4b\u540e\u7528\u963f\u91cc\u4e91\u76d8 APP \u626b\u7801\u767b\u5f55\u3002\n\n### \u4f7f\u7528 web `refresh_token` \u767b\u5f55\n\n\u4f7f\u7528\u8005\u9700\u8981\u5728 https://www.aliyundrive.com/drive/ \u767b\u5f55\u540e\u83b7\u53d6 `refresh_token` \u503c\uff0c\u5e76\u7528\u547d\u4ee4 `useradd` \u4e3a AliPCS-Py \u6dfb\u52a0\u4e00\u4e2a\u7528\u6237\u3002`useradd` \u5176\u4ed6\u53c2\u6570\u7559\u7a7a\u5c31\u597d\u3002\n\n\u4f7f\u7528\u8005\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u65b9\u5f0f\u83b7\u53d6\u7528\u6237\u7684 `refresh_token` \u503c\u3002\n\n1. \u767b\u5f55 https://www.aliyundrive.com/drive/\n2. \u6253\u5f00\u6d4f\u89c8\u5668\u7684\u5f00\u53d1\u8005\u5de5\u5177(\u5982 Chrome DevTools)\u3002\n3. \u7136\u540e\u9009\u62e9\u5f00\u53d1\u8005\u5de5\u5177\u7684 Console \u9762\u677f\u3002\u8f93\u5165 `JSON.parse(localStorage.token).refresh_token`\uff0c\u518d\u56de\u8f66\uff0c\u83b7\u53d6 `refresh_token`\u3002\n\n\n\n\u73b0\u5728\u627e\u5230\u4e86 `refresh_token` \u503c\uff0c\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u547d\u4ee4\u6dfb\u52a0\u4e00\u4e2a\u7528\u6237\u3002\n\n\u4ea4\u4e92\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py useradd\n```\n\n\u6216\u8005\u76f4\u63a5\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py useradd --web-refresh-token \"...\"\n```\n\nAliPCS-Py \u652f\u6301\u591a\u7528\u6237\uff0c\u4f60\u53ea\u9700\u4e00\u76f4\u7528 `useradd` \u6765\u6dfb\u52a0\u7528\u6237\u5373\u53ef\u3002\n\n**\u6ce8\u610f\uff1a\u5982\u679c\u53ea\u7528 `--web-refresh-token` \u767b\u5f55\uff0c\u4e0b\u8f7d\u6587\u4ef6\u65f6\uff0c\u670d\u52a1\u5668\u7aef\u4f1a\u9650\u901f\u3002**\n\n## \u663e\u793a\u5f53\u524d\u7528\u6237\u7684\u4fe1\u606f\n\n```\nAliPCS-Py who\n```\n\n\u6216\u8005\uff1a\n\n```\nAliPCS-Py who user_id\n```\n\n\u6307\u660e\u663e\u793a\u7528\u6237 id \u4e3a `user_id` \u7684\u7528\u6237\u4fe1\u606f\u3002\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------------------------- | -------------------------- |\n| -K, --show-encrypt-password | \u663e\u793a\u52a0\u5bc6\u5bc6\u7801 |\n| --account-name TEXT | \u8d26\u53f7\u540d [\u9ed8\u8ba4\u4e3a user id] |\n| --web-refresh-token TEXT | \u7528\u6237 web_refresh_token |\n| --openapi-refresh-token TEXT | \u7528\u6237 openapi_refresh_token |\n| --client-id TEXT | openapi client id |\n| --client-secret TEXT | openapi client secret |\n| --client-server TEXT | openapi client server |\n\n## \u66f4\u65b0\u7528\u6237\u4fe1\u606f\n\n\u9ed8\u8ba4\u66f4\u65b0\u5f53\u524d\u7528\u6237\u4fe1\u606f\u3002\n\n```\nAliPCS-Py updateuser\n```\n\n\u4e5f\u53ef\u6307\u5b9a\u591a\u4e2a `user_id`\n\n```\nAliPCS-Py updateuser user_id\n```\n\n## \u663e\u793a\u6240\u6709\u7528\u6237\n\n```\nAliPCS-Py userlist\n```\n\n## \u5207\u6362\u5f53\u524d\u7528\u6237\n\n```\nAliPCS-Py su\n```\n\n\u6216\u8005\u6307\u5b9a\u7528\u6237\u5217\u8868\u4e2d\u7528\u6237\u6240\u5728\u7684\u4f4d\u7f6e\uff1a\n\n```\nAliPCS-Py su 2\n```\n\n## \u5220\u9664\u4e00\u4e2a\u7528\u6237\n\n```\nAliPCS-Py userdel\n```\n\n## \u8bbe\u7f6e\u6587\u4ef6\u52a0\u5bc6\u5bc6\u7801\n\nAliPCS-Py \u652f\u6301\u201c\u65e0\u611f\u7684\u201d\u6587\u4ef6\u52a0\u5bc6\u3002\n\nAliPCS-Py \u53ef\u4ee5\u52a0\u5bc6\u4e0a\u4f20\u6587\u4ef6\uff0c\u5728\u4e0b\u8f7d\u7684\u65f6\u5019\u81ea\u52a8\u89e3\u5bc6\uff0c\u8ba9\u4f7f\u7528\u8005\u611f\u89c9\u4e0d\u5230\u52a0\u5bc6\u89e3\u5bc6\u7684\u8fc7\u7a0b\u3002\n\n\u5982\u679c\u4f7f\u7528\u8005\u9700\u8981\u5c06\u4fdd\u5bc6\u6587\u4ef6\u4e0a\u4f20\u81f3\u963f\u91cc\u4e91\u76d8\u4fdd\u5b58\uff0c\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e2a\u65b9\u6cd5\u3002\u5373\u4f7f\u5e10\u53f7\u88ab\u76d7\uff0c\u653b\u51fb\u8005\u4e5f\u65e0\u6cd5\u8fd8\u539f\u6587\u4ef6\u5185\u5bb9\u3002\n\nAliPCS-Py \u652f\u6301\u4ee5\u4e0b\u52a0\u5bc6\u65b9\u6cd5\uff1a\n\n- **Simple** \u4e00\u79cd\u7b80\u5355\u7684\u52a0\u5bc6\u7b97\u6cd5\u3002\u6839\u636e\u5bc6\u94a5\u751f\u6210\u4e00\u4e2a\u5b57\u8282\u5bf9\u7167\u8868\u6765\u52a0\u5bc6\u89e3\u5bc6\u6587\u4ef6\u3002\n \u901f\u5ea6\u5feb\uff0c\u4f46**\u4e0d\u5b89\u5168**\uff0c\u4e0d\u5efa\u8bae\u52a0\u5bc6\u91cd\u8981\u6587\u4ef6\u3002\n \u56e0\u4e3a\u8fd9\u79cd\u7b97\u6cd5\u52a0\u89e3\u5bc6\u4e0d\u9700\u8981\u77e5\u9053\u4e0a\u4e0b\u6587\u4fe1\u606f\uff0c\u6240\u4ee5\uff0c\u4e0b\u8f7d\u65f6\u652f\u6301\u5206\u6bb5\u4e0b\u8f7d\uff0c\u5982\u679c\u662f\u5a92\u4f53\u6587\u4ef6\u5219\u652f\u6301\u62d6\u52a8\u64ad\u653e\u3002\n \u63a8\u8350\u7528\u4e8e\u52a0\u5bc6\u4e0d\u91cd\u8981\u7684\u5a92\u4f53\u6587\u4ef6\u3002\n- **ChaCha20** \u5de5\u4e1a\u7ea7\u52a0\u5bc6\u7b97\u6cd5\uff0c\u901f\u5ea6\u5feb\uff0c\u63a8\u8350\u7528\u4e8e\u52a0\u5bc6\u91cd\u8981\u6587\u4ef6\u3002\u4e0d\u652f\u6301\u5206\u6bb5\u4e0b\u8f7d\u3002\n- **AES256CBC** \u5de5\u4e1a\u7ea7\u52a0\u5bc6\u7b97\u6cd5\uff0c\u63a8\u8350\u7528\u4e8e\u52a0\u5bc6\u91cd\u8981\u6587\u4ef6\u3002\u4e0d\u652f\u6301\u5206\u6bb5\u4e0b\u8f7d\u3002\n\n**\u6ce8\u610f**\uff1a\u7528\u547d\u4ee4 `encryptpwd` \u8bbe\u7f6e\u7684\u5bc6\u7801**\u53ea\u662f\u4e3a\u5f53\u524d\u7528\u6237**\u7684\u3002\n\n\u4e3a\u5f53\u524d\u7528\u6237\u8bbe\u7f6e\u52a0\u5bc6\u5bc6\u7801:\n\n\u4ea4\u4e92\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py encryptpwd\n```\n\n\u6216\u8005\u76f4\u63a5\u6dfb\u52a0\uff1a\n\n```\nAliPCS-Py encryptpwd --encrypt-password 'my-encrypt-password'\n```\n\n\u4e0a\u4f20\u5e76\u52a0\u5bc6\u6587\u4ef6\uff1a\n\n\u4e0a\u4f20\u548c\u540c\u6b65\u6587\u4ef6\u65f6\u53ea\u9700\u8981\u6307\u5b9a\u52a0\u5bc6\u7b97\u6cd5\u5c31\u53ef\u3002\u5982\u679c\u4e0d\u6307\u5b9a\u5c31\u4e0d\u52a0\u5bc6\u3002\n\n```\n# \u9ed8\u8ba4\u4f7f\u7528\u4e0a\u9762\u8bbe\u7f6e\u7684 `encrypt-password`\nAliPCS-Py upload some-file.mp4 some-dir/ /to/here --encrypt-type AES256CBC\n```\n\n\u4e0b\u8f7d\u5e76\u7528\u4e0a\u9762\u8bbe\u7f6e\u7684 `encrypt-password` \u81ea\u52a8\u89e3\u5bc6\u6587\u4ef6\uff1a\n\n```\nAliPCS-Py download /to/here/some-file.mp4 /to/here/some-dir/\n```\n\n\u4e5f\u53ef\u4ee5\u4f7f\u7528\u4e34\u65f6\u7684 `encrypt-password`\uff1a\n\n```\nAliPCS-Py upload some-file.mp4 some-dir/ /to/here --encrypt-type Simple --encrypt-password 'onlyyou'\n```\n\n\u4f46\u5728\u4f7f\u7528\u4e34\u65f6\u7684 `encrypt-password` \u540e\uff0c`cat`\u3001\u4e0b\u8f7d\u548c\u64ad\u653e\u8fd9\u4e9b\u6587\u4ef6\u65f6\u9700\u8981\u6307\u5b9a `encrypt-password`\uff0c\u4f46\u4e0d\u9700\u8981\u6307\u5b9a\u52a0\u5bc6\u7b97\u6cd5\uff0c\u7a0b\u5e8f\u4f1a\u81ea\u52a8\u68c0\u67e5\u52a0\u5bc6\u7b97\u6cd5\uff1a\n\n```\n# \u4e0b\u8f7d\nAliPCS-Py download /to/here/some-file.mp4 /to/here/some-dir/ --encrypt-password 'onlyyou'\n\n# \u5f00\u542f\u672c\u5730\u670d\u52a1\u5e76\u64ad\u653e\nAliPCS-Py play /to/here/some-file.mp4 --encrypt-password 'onlyyou' --use-local-server\n```\n\n\u663e\u793a\u5f53\u524d\u7528\u6237\u7684\u5bc6\u94a5\uff1a\n\n```\nAliPCS-Py who --show-encrypt-password\n```\n\nAliPCS-Py \u4e0b\u8f7d\u65f6\u9ed8\u8ba4\u4f1a\u89e3\u5bc6\u6587\u4ef6\uff0c\u5982\u679c\u60f3\u8981\u4e0b\u8f7d\u4f46\u4e0d\u89e3\u5bc6\u6587\u4ef6\uff0c\u9700\u8981\u52a0 `--no-decrypt`\n\n```\nAliPCS-Py download some-file --no-decrypt\n```\n\n## \u6587\u4ef6\u64cd\u4f5c\n\nAliPCS-Py \u64cd\u4f5c\u7f51\u76d8\u4e2d\u7684\u6587\u4ef6\u53ef\u4ee5\u4f7f\u7528\u6587\u4ef6\u7684\u7edd\u5bf9\u8def\u5f84\u6216\u76f8\u5bf9\u8def\u5f84\uff08\u76f8\u5bf9\u4e0e\u5f53\u524d\u76ee\u5f55 pwd\uff09\u3002\n\n\u6bcf\u4e00\u4e2a\u7528\u6237\u90fd\u6709\u81ea\u5df1\u7684\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55\uff08pwd\uff09\uff0c\u9ed8\u8ba4\u4e3a `/` \u6839\u76ee\u5f55\u3002\n\n\u4f7f\u7528\u8005\u53ef\u4ee5\u7528 `cd` \u547d\u4ee4\u6765\u5207\u6362\u5f53\u524d\u7684\u5de5\u4f5c\u76ee\u5f55\uff08pwd\uff09\u3002\n\n\u4e0b\u9762\u6240\u6709\u6d89\u53ca\u7f51\u76d8\u8def\u5f84\u7684\u547d\u4ee4\uff0c\u5176\u4e2d\u5982\u679c\u7f51\u76d8\u8def\u5f84\u7528\u7684\u662f\u76f8\u5bf9\u8def\u5f84\uff0c\u90a3\u4e48\u662f\u76f8\u5bf9\u4e8e\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55\uff08pwd\uff09\u7684\u3002\n\u5982\u679c\u662f\u7f51\u76d8\u8def\u5f84\u7528\u7684\u662f\u7edd\u5bf9\u8def\u5f84\uff0c\u90a3\u4e48\u5c31\u662f\u8fd9\u4e2a\u7edd\u5bf9\u8def\u5f84\u3002\n\n## \u663e\u793a\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55\n\n```\nAliPCS-Py pwd\n```\n\n## \u5207\u6362\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55\n\n\u5207\u6362\u5230\u7edd\u5bf9\u8def\u5f84\uff1a\n\n```\nAliPCS-Py cd /to/some/path\n```\n\n\u5207\u6362\u5230\u76f8\u5bf9\u8def\u5f84\uff1a\n\n```\n# \u5207\u6362\u5230 (pwd)/../path\nAliPCS-Py cd ../path\n```\n\n## \u5217\u51fa\u7f51\u76d8\u8def\u5f84\u4e0b\u7684\u6587\u4ef6\n\n\u4f7f\u7528\u6587\u4ef6\u8def\u5f84\uff1a\n\n```\nAliPCS-Py ls [OPTIONS] [REMOTEPATHS]...\n\nAliPCS-Py ls /absolute/path\n\n# or\nAliPCS-Py ls relative/path\n```\n\n\u4f7f\u7528\u6587\u4ef6 ID\uff1a\n\n```\nAliPCS-Py ls -i file_id1 -i file_id2 -i ...\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| -------------------------- | ----------------------------------------------------- |\n| -i, --file-id TEXT | \u6587\u4ef6 ID |\n| --share-id, --si TEXT | \u5217\u51fa\u8fd9\u4e2a\u5206\u4eab ID \u4e0b\u7684\u6587\u4ef6 |\n| --share-url, --su TEXT | \u5217\u51fa\u8fd9\u4e2a\u5206\u4eab url \u4e0b\u7684\u6587\u4ef6 |\n| -p, --password TEXT | \u5206\u4eab\u94fe\u63a5\u5bc6\u7801\uff0c\u5982\u679c\u6ca1\u6709\u4e0d\u7528\u8bbe\u7f6e |\n| -r, --desc | \u9006\u5e8f\u6392\u5217\u6587\u4ef6 |\n| -n, --name | \u4f9d\u540d\u5b57\u6392\u5e8f |\n| -t, --time | \u4f9d\u65f6\u95f4\u6392\u5e8f |\n| -s, --size | \u4f9d\u6587\u4ef6\u5927\u5c0f\u6392\u5e8f |\n| -R, --recursive | \u9012\u5f52\u5217\u51fa\u6587\u4ef6 |\n| -I, --include TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --include-regex, --IR TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -E, --exclude TEXT | \u7b5b\u9009 **\u4e0d** \u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --exclude-regex, --ER TEXT | \u7b5b\u9009 **\u4e0d** \u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -f, --is-file | \u7b5b\u9009 **\u975e** \u76ee\u5f55\u6587\u4ef6 |\n| -d, --is-dir | \u7b5b\u9009\u76ee\u5f55\u6587\u4ef6 |\n| --no-highlight, --NH | \u53d6\u6d88\u5339\u914d\u9ad8\u4eae |\n| -S, --show-size | \u663e\u793a\u6587\u4ef6\u5927\u5c0f |\n| -D, --show-date | \u663e\u793a\u6587\u4ef6\u521b\u5efa\u65f6\u95f4 |\n| --show-file-id, --ID | \u663e\u793a\u6587\u4ef6 ID |\n| -M, --show-hash | \u663e\u793a\u6587\u4ef6 sha1 |\n| -A, --show-absolute-path | \u663e\u793a\u6587\u4ef6\u7edd\u5bf9\u8def\u5f84 |\n| --show-dl-link, --DL | \u663e\u793a\u6587\u4ef6\u4e0b\u8f7d\u8fde\u63a5 |\n| --csv | \u7528 csv \u683c\u5f0f\u663e\u793a\uff0c\u5355\u884c\u663e\u793a\uff0c\u63a8\u8350\u548c --DL \u6216 --HL \u4e00\u8d77\u7528 |\n| --only-dl-link, --ODL | \u53ea\u663e\u793a\u6587\u4ef6\u4e0b\u8f7d\u8fde\u63a5 |\n\n## \u641c\u7d22\u6587\u4ef6\n\n\u641c\u7d22\u5305\u542b `keyword` \u7684\u6587\u4ef6\n\n```\nAliPCS-Py search [OPTIONS] KEYWORD [REMOTEDIR]\n\n# \u5728\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55\u4e2d\u641c\u7d22\nAliPCS-Py search keyword\n\n# or\nAliPCS-Py search keyword /absolute/path\n\n# or\nAliPCS-Py search keyword relative/path\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| -------------------------- | ------------------------------------ |\n| -R, --recursive | \u9012\u5f52\u641c\u7d22\u6587\u4ef6 |\n| -I, --include TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --include-regex, --IR TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -E, --exclude TEXT | \u7b5b\u9009 **\u4e0d** \u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --exclude-regex, --ER TEXT | \u7b5b\u9009 **\u4e0d** \u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -f, --is-file | \u7b5b\u9009 **\u975e** \u76ee\u5f55\u6587\u4ef6 |\n| -d, --is-dir | \u7b5b\u9009\u76ee\u5f55\u6587\u4ef6 |\n| --no-highlight, --NH | \u53d6\u6d88\u5339\u914d\u9ad8\u4eae |\n| -S, --show-size | \u663e\u793a\u6587\u4ef6\u5927\u5c0f |\n| -D, --show-date | \u663e\u793a\u6587\u4ef6\u521b\u5efa\u65f6\u95f4 |\n| -M, --show-hash | \u663e\u793a\u6587\u4ef6 sha1 |\n| --csv | \u7528 csv \u683c\u5f0f\u663e\u793a |\n\n## \u663e\u793a\u6587\u4ef6\u5185\u5bb9\n\n```\nAliPCS-Py cat [OPTIONS] REMOTEPATH\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ----------------------------- | ---------------------------- |\n| -e, --encoding TEXT | \u6587\u4ef6\u7f16\u7801\uff0c\u9ed8\u8ba4\u81ea\u52a8\u89e3\u7801 |\n| --no-decrypt, --ND | \u4e0d\u89e3\u5bc6 |\n| --encrypt-password, --ep TEXT | \u52a0\u5bc6\u5bc6\u7801\uff0c\u9ed8\u8ba4\u4f7f\u7528\u7528\u6237\u8bbe\u7f6e\u7684 |\n\n## \u521b\u5efa\u76ee\u5f55\n\n```\nAliPCS-Py mkdir [OPTIONS] [REMOTEDIRS]...\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------- | ----------- |\n| -S, --show | \u663e\u793a\u76ee\u5f55 |\n\n## \u79fb\u52a8\u6587\u4ef6\n\n\u79fb\u52a8\u4e00\u4e9b\u6587\u4ef6\u5230\u4e00\u4e2a\u76ee\u5f55\u4e2d\u3002\n\n```\nAliPCS-Py move [OPTIONS] [REMOTEPATHS]... REMOTEDIR\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------- | ----------- |\n| -S, --show | \u663e\u793a\u7ed3\u679c |\n\n## \u6587\u4ef6\u91cd\u547d\u540d\n\n```\nAliPCS-Py rename [OPTIONS] REMOTEPATH NEW_NAME\n```\n\ne.g.\n\n\u91cd\u547d\u540d `/path/to/far` to `/path/to/foo`\n\n```\nAliPCS-Py rename /path/to/far foo\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------- | ----------- |\n| -S, --show | \u663e\u793a\u7ed3\u679c |\n\n## \u62f7\u8d1d\u6587\u4ef6\n\n\u62f7\u8d1d\u4e00\u4e9b\u6587\u4ef6\u5230\u4e00\u4e2a\u76ee\u5f55\u4e2d\u3002\n\n```\nAliPCS-Py move [OPTIONS] [REMOTEPATHS]... REMOTEDIR\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------- | ----------- |\n| -S, --show | \u663e\u793a\u7ed3\u679c |\n\n## \u5220\u9664\u6587\u4ef6\n\n```\nAliPCS-Py remove [OPTIONS] [REMOTEPATHS]...\n\n# \u6307\u5b9a \u8def\u5f84\nAliPCS-Py remove /some/path\n# \u6307\u5b9a file-id\nAliPCS-Py remove --file-id ...\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ------------- | ------------ |\n| -i, --file-id | TEXT \u6587\u4ef6 ID |\n\n## \u4e0b\u8f7d\u6587\u4ef6\u6216\u76ee\u5f55\n\n> \u5728\u4f7f\u7528\u4e86\u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0 api \u65f6\uff0c\u5982\u679c\u4e0b\u8f7d\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6\uff0c\u6587\u4ef6\u4f1a\u5148\u4fdd\u5b58\u5230 `/__alipcs_py_temp__`\uff0c\u5728\u4ece\u5176\u4e2d\u4e0b\u8f7d\u3002\n> \u4e0b\u8f7d\u7ed3\u675f\u540e\uff0c\u4f1a\u5220\u9664 `__alipcs_py_temp__` \u4e2d\u4e0b\u8f7d\u7684\u6587\u4ef6\u3002\n\n\u4f7f\u7528\u6587\u4ef6\u8def\u5f84\uff1a\n\n```\nAliPCS-Py download [OPTIONS] [REMOTEPATHS]...\n```\n\n\u4f7f\u7528\u6587\u4ef6 ID\uff1a\n\n```\nAliPCS-Py download -i file_id1 -i file_id2 -i ...\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| -i, --file-id TEXT | \u6587\u4ef6 ID |\n| --share-id, --si TEXT | \u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eab ID \u4e0b\u7684\u6587\u4ef6 |\n| --share-url, --su TEXT | \u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eab url \u4e0b\u7684\u6587\u4ef6 |\n| -p, --password TEXT | \u5206\u4eab\u94fe\u63a5\u5bc6\u7801\uff0c\u5982\u679c\u6ca1\u6709\u4e0d\u7528\u8bbe\u7f6e |\n| -o, --outdir TEXT | \u6307\u5b9a\u4e0b\u8f7d\u672c\u5730\u76ee\u5f55\uff0c\u9ed8\u8ba4\u4e3a\u5f53\u524d\u76ee\u5f55 |\n| -R, --recursive | \u9012\u5f52\u4e0b\u8f7d |\n| -f, --from-index INTEGER | \u4ece\u6240\u6709\u76ee\u5f55\u4e2d\u7684\u7b2c\u51e0\u4e2a\u6587\u4ef6\u5f00\u59cb\u4e0b\u8f7d\uff0c\u9ed8\u8ba4\u4e3a 0\uff08\u7b2c\u4e00\u4e2a\uff09 |\n| -I, --include TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --include-regex, --IR TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -E, --exclude TEXT | \u7b5b\u9009 \u4e0d \u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --exclude-regex, --ER TEXT | \u7b5b\u9009 \u4e0d \u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -s, --concurrency INTEGER | \u4e0b\u8f7d\u540c\u6b65\u94fe\u63a5\u6570\uff0c\u9ed8\u8ba4\u4e3a 5\u3002\u5efa\u8bae\u5c0f\u4e8e 10\u3002 |\n| -k, --chunk-size TEXT | \u540c\u6b65\u94fe\u63a5\u5206\u5757\u5927\u5c0f\uff0c\u9ed8\u8ba4\u4e3a 50MB |\n| -q, --quiet | \u53d6\u6d88\u7b2c\u4e09\u65b9\u4e0b\u8f7d\u5e94\u7528\u8f93\u51fa |\n| --out-cmd, --OC | \u8f93\u51fa\u7b2c\u4e09\u65b9\u4e0b\u8f7d\u5e94\u7528\u547d\u4ee4 |\n| -d, --downloader [ me \\| aget_py \\| aget_rs \\| aria2 ] | \u6307\u5b9a\u4e0b\u8f7d\u5e94\u7528<br> <br> \u9ed8\u8ba4\u4e3a me (AliPCS-Py \u81ea\u5df1\u7684\u4e0b\u8f7d\u5668\uff0c\u652f\u6301\u65ad\u7eed\u4e0b\u8f7d)<br> me \u4f7f\u7528\u591a\u6587\u4ef6\u5e76\u53d1\u4e0b\u8f7d\u3002<br> <br> \u9664 me \u5916\uff0c\u5176\u4ed6\u4e0b\u8f7d\u5668\uff0c\u4e0d\u4f7f\u7528\u591a\u6587\u4ef6\u5e76\u53d1\u4e0b\u8f7d\uff0c\u4f7f\u7528\u4e00\u4e2a\u6587\u4ef6\u591a\u94fe\u63a5\u4e0b\u8f7d\u3002<br> \u5982\u679c\u9700\u8981\u4e0b\u8f7d\u591a\u4e2a\u5c0f\u6587\u4ef6\u63a8\u8350\u4f7f\u7528 me\uff0c\u5982\u679c\u9700\u8981\u4e0b\u8f7d\u5c11\u91cf\u5927\u6587\u4ef6\u63a8\u8350\u4f7f\u7528\u5176\u4ed6\u4e0b\u8f7d\u5668\u3002<br> <br> aget_py (https://github.com/PeterDing/aget) \u9ed8\u8ba4\u5b89\u88c5<br> aget_rs (\u4e0b\u8f7d https://github.com/PeterDing/aget-rs/releases)<br> aria2 (\u4e0b\u8f7d https://github.com/aria2/aria2/releases)<br> |\n| --encrypt-password, --ep TEXT | \u52a0\u5bc6\u5bc6\u7801\uff0c\u9ed8\u8ba4\u4f7f\u7528\u7528\u6237\u8bbe\u7f6e\u7684 |\n\n## \u64ad\u653e\u5a92\u4f53\u6587\u4ef6\n\n> \u5728\u4f7f\u7528\u4e86\u963f\u91cc\u4e91\u76d8\u5f00\u653e\u5e73\u53f0 api \u65f6\uff0c\u5982\u679c\u64ad\u653e\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6\uff0c\u6587\u4ef6\u4f1a\u5148\u4fdd\u5b58\u5230 `/__alipcs_py_temp__`\uff0c\u5728\u4ece\u5176\u4e2d\u64ad\u653e\u3002\n> \u64ad\u653e\u7ed3\u675f\u540e\uff0c\u4f1a\u5220\u9664 `__alipcs_py_temp__` \u4e2d\u64ad\u653e\u7684\u6587\u4ef6\u3002\n\n\u4f7f\u7528\u6587\u4ef6\u8def\u5f84\uff1a\n\n```\nAliPCS-Py play [OPTIONS] [REMOTEPATHS]...\n```\n\n\u4f7f\u7528\u6587\u4ef6 ID\uff1a\n\n**\u6ce8\u610f\uff1a\u76ee\u524d\uff0c\u4f7f\u7528 `--share-id` \u6216 `--file-id` \u65f6\uff0c\u65e0\u6cd5\u4f7f\u7528 `--use-local-server`**\n\n```\nAliPCS-Py play -i file_id1 -i file_id2 -i ...\n```\n\n`play` \u547d\u4ee4\u9ed8\u8ba4\u64ad\u653e\u5e26\u6709\u5a92\u4f53\u540e\u7f00\u7684\u6587\u4ef6\uff0c\u5982 `abc.mp4`, `abc.mp3`\u3002\u5982\u679c\u9700\u8981\u64ad\u653e\u7684\u5a92\u4f53\u6587\u4ef6\u6ca1\u6709\u7528\u5e38\u89c4\u7684\u5a92\u4f53\u6587\u4ef6\u540e\u7f00\uff0c\u5219\u9700\u8981\u52a0\u9009\u9879 `--ignore-ext`\u3002\n\n### \u9009\u9879\n\n| Option | Description |\n| ----------------------------- | ---------------------------------------------------- |\n| -i, --file-id TEXT | \u6587\u4ef6 ID |\n| --share-id, --si TEXT | \u64ad\u653e\u8fd9\u4e2a\u5206\u4eab ID \u4e0b\u7684\u6587\u4ef6 |\n| --share-url, --su TEXT | \u64ad\u653e\u8fd9\u4e2a\u5206\u4eab url \u4e0b\u7684\u6587\u4ef6 |\n| -p, --password TEXT | \u94fe\u63a5\u5bc6\u7801\uff0c\u5982\u679c\u6ca1\u6709\u4e0d\u7528\u8bbe\u7f6e |\n| -R, --recursive | \u9012\u5f52\u64ad\u653e |\n| -f, --from-index INTEGER | \u4ece\u6240\u6709\u76ee\u5f55\u4e2d\u7684\u7b2c\u51e0\u4e2a\u6587\u4ef6\u5f00\u59cb\u64ad\u653e\uff0c\u9ed8\u8ba4\u4e3a 0\uff08\u7b2c\u4e00\u4e2a\uff09 |\n| -I, --include TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --include-regex, --IR TEXT | \u7b5b\u9009\u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| -E, --exclude TEXT | \u7b5b\u9009 \u4e0d \u5305\u542b\u8fd9\u4e2a\u5b57\u7b26\u4e32\u7684\u6587\u4ef6 |\n| --exclude-regex, --ER TEXT | \u7b5b\u9009 \u4e0d \u5305\u542b\u8fd9\u4e2a\u6b63\u5219\u8868\u8fbe\u5f0f\u7684\u6587\u4ef6 |\n| --player-params, --PP TEXT | \u7b2c\u4e09\u65b9\u64ad\u653e\u5668\u53c2\u6570 |\n| -q, --quiet | \u53d6\u6d88\u7b2c\u4e09\u65b9\u64ad\u653e\u5668\u8f93\u51fa |\n| --shuffle, --sf | \u968f\u673a\u64ad\u653e |\n| --ignore-ext, --IE | \u4e0d\u7528\u6587\u4ef6\u540d\u540e\u7f00\u540d\u6765\u5224\u65ad\u5a92\u4f53\u6587\u4ef6 |\n| --out-cmd, --OC | \u8f93\u51fa\u7b2c\u4e09\u65b9\u64ad\u653e\u5668\u547d\u4ee4 |\n| --pl, --player [mpv] | \u6307\u5b9a\u7b2c\u4e09\u65b9\u64ad\u653e\u5668<br><br>\u9ed8\u8ba4\u4e3a mpv (https://mpv.io) |\n| -s, --use-local-server | \u4f7f\u7528\u672c\u5730\u670d\u52a1\u5668\u64ad\u653e\u3002 |\n| --encrypt-password, --ep TEXT | \u52a0\u5bc6\u5bc6\u7801\uff0c\u9ed8\u8ba4\u4f7f\u7528\u7528\u6237\u8bbe\u7f6e\u7684 |\n\n## \u4e0a\u4f20\u6587\u4ef6\n\n\u4e0a\u4f20\u4e00\u4e9b\u672c\u5730\u6587\u4ef6\u6216\u76ee\u5f55\u5230\u7f51\u76d8\u76ee\u5f55\u3002\n\nAliPCS-Py \u9996\u5148\u4f1a\u5c1d\u8bd5\u79d2\u4f20\u3002\u5982\u679c\u79d2\u4f20\u5931\u8d25\uff0c\u4f1a\u4f7f\u7528\u5206\u7247\u4e0a\u4f20\u4e0a\u4f20\u6587\u4ef6\u3002\n\n\u4e0a\u4f20\u8fc7\u7a0b\u4e2d\uff0c\u6309 \u201cp\u201d \u53ef\u4ee5\u6682\u505c\u6216\u7ee7\u7eed\u4e0a\u4f20\u3002\n\n```\nAliPCS-Py upload [OPTIONS] [LOCALPATHS]... REMOTEDIR\n```\n\n\u6307\u5b9a\u540c\u65f6\u4e0a\u4f20\u8fde\u63a5\u6570\u91cf:\n\n`--max-workers` \u9ed8\u8ba4\u4e3a CPU \u6838\u6570\u3002\n\n```\nAliPCS-Py upload --max-workers 4 [OPTIONS] [LOCALPATHS]... REMOTEDIR\n```\n\n\u5982\u679c\u4e0a\u4f20\u672c\u5730\u76ee\u5f55 `localdir` \u5230\u8fdc\u7aef\u76ee\u5f55 `remotedir`\uff0cAliPCS-Py \u662f\u5c06 `localdir` \u8fd9\u4e2a\u76ee\u5f55\u4e0a\u4f20\u5230\u8fdc\u7aef\u76ee\u5f55 `remotedir` \u4e0b\u3002\n\n\u6bd4\u5982\uff0c`localdir` \u4e0b\u6709 2 \u4e2a\u6587\u4ef6 `a`\uff0c`b` \u548c\u4e00\u4e2a\u4e0b\u7ea7\u76ee\u5f55 `sub/`\uff0c\u5982\u679c\u8fd0\u884c `AliPCS-Py upload localdir remotedir`\uff0c\u7ed3\u679c\u662f\u8fdc\u7aef\u76ee\u5f55 `remotedir` \u4e0b\u589e\u52a0\u4e86 1 \u4e2a\u4e0b\u7ea7\u76ee\u5f55\u548c\u5b83\u7684\u6240\u6709\u6587\u4ef6 `localdir/a`\uff0c`localdir/b` \u548c\u4e00\u4e2a\u4e0b\u7ea7\u76ee\u5f55 `localdir/sub/`\u3002\n\n\u5982\u679c\u8981\u5c06 `localdir` \u4e0b\u7684\u6240\u6709\u6587\u4ef6\uff08\u5305\u62ec\u4e0b\u7ea7\u76ee\u5f55\uff09\u4e0a\u4f20\u5230\u8fdc\u7aef\u76ee\u5f55 `remotedir`\uff0c\u7528 `AliPCS-Py upload localdir/* remotedir`\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------------------------------------------------------- | ------------------------------------- |\n| --encrypt-password, --ep TEXT | \u52a0\u5bc6\u5bc6\u7801\uff0c\u9ed8\u8ba4\u4f7f\u7528\u7528\u6237\u8bbe\u7f6e\u7684 |\n| -e, --encrypt-type [No \\| Simple \\| ChaCha20 \\| AES256CBC] | \u6587\u4ef6\u52a0\u5bc6\u65b9\u6cd5\uff0c\u9ed8\u8ba4\u4e3a No \u4e0d\u52a0\u5bc6 |\n| -w, --max-workers INTEGER | \u540c\u65f6\u4e0a\u4f20\u6587\u4ef6\u8fde\u63a5\u6570\u91cf\uff0c\u9ed8\u8ba4\u4e3a CPU \u6838\u6570 |\n| --no-ignore-existing, --NI | \u4e0a\u4f20\u5df2\u7ecf\u5b58\u5728\u7684\u6587\u4ef6 |\n| --no-show-progress, --NP | \u4e0d\u663e\u793a\u4e0a\u4f20\u8fdb\u5ea6 |\n\n## \u540c\u6b65\u672c\u5730\u76ee\u5f55\u5230\u8fdc\u7aef\n\n\u540c\u6b65\u672c\u5730\u76ee\u5f55\u5230\u8fdc\u7aef\u3002\n\n\u5982\u679c\u672c\u5730\u6587\u4ef6\u6700\u540e\u4fee\u6539\u65f6\u95f4\u6216\u5927\u5c0f\u548c\u8fdc\u7aef\u4e0d\u540c\u5219\u4e0a\u4f20\u6587\u4ef6\u3002\u5bf9\u4e8e\u672c\u5730\u4e0d\u5b58\u5728\u7684\u6587\u4ef6\u4f46\u8fdc\u7aef\u5b58\u5728\u5219\u5220\u9664\u8fdc\u7aef\u6587\u4ef6\u3002\n\n```\nAliPCS-Py sync [OPTIONS] LOCALDIR REMOTEDIR\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ---------------------------------------------------------- | ------------------------------ |\n| --encrypt-password, --ep TEXT | \u52a0\u5bc6\u5bc6\u7801\uff0c\u9ed8\u8ba4\u4f7f\u7528\u7528\u6237\u8bbe\u7f6e\u7684 |\n| -e, --encrypt-type [No \\| Simple \\| ChaCha20 \\| AES256CBC] | \u6587\u4ef6\u52a0\u5bc6\u65b9\u6cd5\uff0c\u9ed8\u8ba4\u4e3a No \u4e0d\u52a0\u5bc6 |\n| -w, --max-workers INTEGER | \u540c\u65f6\u4e0a\u4f20\u6587\u4ef6\u6570 |\n| --no-show-progress, --NP | \u4e0d\u663e\u793a\u4e0a\u4f20\u8fdb\u5ea6 |\n\n## \u5173\u4e8e\u79d2\u4f20\u8fde\u63a5\n\n**\u963f\u91cc\u4e91\u76d8\u5df2\u7ecf\u4e0d\u80fd\u5b9e\u73b0\u7528\u79d2\u4f20\u8fde\u63a5\u4e0a\u4f20\u3002**\n\n## \u5206\u4eab\u6587\u4ef6\n\n```\nAliPCS-Py share [OPTIONS] [REMOTEPATHS]...\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| --------------------------- | -------------------------------- |\n| -p, --password TEXT | \u8bbe\u7f6e\u79d8\u5bc6\uff0c4 \u4e2a\u5b57\u7b26\u3002\u9ed8\u8ba4\u6ca1\u6709\u79d8\u5bc6 |\n| --period-time, --pt INTEGER | \u8bbe\u7f6e\u5206\u4eab\u6709\u6548\u671f\uff0c\u5355\u4f4d\u4e3a\u5929 |\n\n## \u5217\u51fa\u5206\u4eab\u94fe\u63a5\n\n```\nAliPCS-Py shared\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| -------------- | -------------------------------------------- |\n| -A, --show-all | \u663e\u793a\u6240\u6709\u5206\u4eab\u7684\u94fe\u63a5\uff0c\u9ed8\u8ba4\u53ea\u663e\u793a\u6709\u6548\u7684\u5206\u4eab\u94fe\u63a5 |\n\n## \u53d6\u6d88\u5206\u4eab\u94fe\u63a5\n\n```\nAliPCS-Py cancelshared [OPTIONS] [SHARE_IDS]...\n```\n\n## \u5217\u51fa\u5176\u4ed6\u7528\u6237\u5206\u4eab\u94fe\u63a5\u4e2d\u7684\u6587\u4ef6\n\n\u7ed9 `ls` \u547d\u4ee4\u52a0\u53c2\u6570\uff0c\u6211\u4eec\u53ef\u4ee5\u5217\u51fa\u5176\u4ed6\u7528\u6237\u5206\u4eab\u94fe\u63a5\u4e2d\u7684\u6587\u4ef6\u3002\n\n**\u6ce8\u610f: \u8fd9\u91cc `remotepaths` \u53ea\u80fd\u662f\u7edd\u5bf9\u8def\u5f84\u3002**\n\n\u5982\u679c\u6709\u5206\u4eab\u5bc6\u7801\uff0c\u52a0\u4e0a `--password PASSWORD`\u3002\n\n- \u4f7f\u7528\u5206\u4eab\u8fde\u63a5\n\n ```\n AliPCS-Py ls --share-url SHARE_URL\n\n # e.g.\n\n # \u5217\u51fa\u8fd9\u4e2a\u5206\u4eaburl\u7684\u6839\u76ee\u5f55\n AliPCS-Py ls --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi\n\n # \u9012\u5f52\u5217\u51fa\u8fd9\u4e2a\u5206\u4eaburl\u7684\u6587\u4ef6\n AliPCS-Py ls --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi -R\n\n # \u5217\u51fa\u8fd9\u4e2a\u5206\u4eaburl\u7684\u6307\u5b9a\u76ee\u5f55\n AliPCS-Py ls --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi/folder/613397974b634251e0554d7cb56df3e46d473239\n ```\n\n- \u4f7f\u7528\u5206\u4eab ID\n\n \u5206\u4eab ID \u662f https://www.aliyundrive.com/s/DaNNsdvi9bi \u4e2d\u7684 `DaNNsdvi9bi`\n\n ```\n AliPCS-Py ls /path --share-id SHARE_ID\n\n # e.g.\n\n # \u5217\u51fa\u8fd9\u4e2a\u5206\u4eabID\u7684\u6839\u76ee\u5f55\n AliPCS-Py ls / --share-id DaNNsdvi9bi\n\n # \u5217\u51fa\u8fd9\u4e2a\u5206\u4eabID\u4e0b\uff0c\u6587\u4ef6\u540d\u4e3a \"613397974b634251e0554d7cb56df3e46d473239\" \u7684\u6587\u4ef6\n AliPCS-Py ls --file-id 613397974b634251e0554d7cb56df3e46d473239 --share-id DaNNsdvi9bi\n ```\n\n### \u9009\u9879\n\n\u89c1 `ls` \u547d\u4ee4\u3002\n\n## \u4e0b\u8f7d\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6\n\n\u4f7f\u7528 `--share-id` \u6216 `--share-url` \u9009\u9879\uff0c`download` \u547d\u4ee4\u53ef\u4ee5\u76f4\u63a5\u4e0b\u8f7d\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6\u3002\n\n**\u6ce8\u610f: \u8fd9\u91cc\u5fc5\u987b\u6307\u5b9a\u4e0b\u8f7d\u7edd\u5bf9\u8def\u5f84\u6216 file id**\n\n```\nAliPCS-Py download /path --share-url SHARED_URL\n\n# or\n\nAliPCS-Py download /path --share-id SHARED_URL\n\n# or\n\nAliPCS-Py download --file-id FILE_ID --share-id SHARED_URL\n```\n\n- \u4f7f\u7528\u5206\u4eab\u8fde\u63a5\n\n ```\n # \u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6839\u76ee\u5f55\u4e2d\u7684\u6587\u4ef6\n AliPCS-Py download / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi\n\n # \u9012\u5f52\u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6240\u6709\u7684\u6587\u4ef6\n AliPCS-Py download / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi -R\n\n # \u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eaburl\u7684\u6307\u5b9a\u76ee\u5f55\n AliPCS-Py download --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi/folder/613397974b634251e0554d7cb56df3e46d473239\n ```\n\n- \u4f7f\u7528\u5206\u4eab ID\n\n ```\n # \u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6839\u76ee\u5f55\u4e2d\u7684\u6587\u4ef6\n AliPCS-Py download / --share-id DaNNsdvi9bi\n\n # \u9012\u5f52\u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6240\u6709\u7684\u6587\u4ef6\n AliPCS-Py download / --share-id DaNNsdvi9bi -R\n\n # \u4e0b\u8f7d\u8fd9\u4e2a\u5206\u4eabID\u4e0b\uff0c\u6587\u4ef6\u540d\u4e3a \"613397974b634251e0554d7cb56df3e46d473239\" \u7684\u6587\u4ef6\n AliPCS-Py download --file-id 613397974b634251e0554d7cb56df3e46d473239 --share-id DaNNsdvi9bi\n ```\n\n### \u9009\u9879\n\n\u89c1 `download` \u547d\u4ee4\u3002\n\n## \u64ad\u653e\u4ed6\u4eba\u5206\u4eab\u7684\u6587\u4ef6\n\n\u4f7f\u7528 `--share-id` \u6216 `--share-url` \u9009\u9879\uff0c`play` \u547d\u4ee4\u53ef\u4ee5\u76f4\u63a5\u64ad\u653e\u4ed6\u4eba\u5206\u4eab\u7684\u5a92\u4f53\u6587\u4ef6\u3002\n\n**\u6ce8\u610f: \u8fd9\u91cc\u5fc5\u987b\u6307\u5b9a\u4e0b\u8f7d\u7edd\u5bf9\u8def\u5f84\u6216 file id**\n\n```\nAliPCS-Py play /path --share-url SHARED_URL\n\n# or\n\nAliPCS-Py play /path --share-id SHARED_URL\n\n# or\n\nAliPCS-Py play --file-id FILE_ID --share-id SHARED_URL\n```\n\n- \u4f7f\u7528\u5206\u4eab\u8fde\u63a5\n\n ```\n # \u64ad\u653e\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6839\u76ee\u5f55\u4e2d\u7684\u6587\u4ef6\n AliPCS-Py play / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi\n\n # \u9012\u5f52\u64ad\u653e\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6240\u6709\u7684\u6587\u4ef6\n AliPCS-Py play / --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi -R\n\n # \u64ad\u653e\u8fd9\u4e2a\u5206\u4eaburl\u7684\u6307\u5b9a\u76ee\u5f55\n AliPCS-Py play --share-url https://www.aliyundrive.com/s/DaNNsdvi9bi/folder/613397974b634251e0554d7cb56df3e46d473239\n ```\n\n- \u4f7f\u7528\u5206\u4eab ID\n\n ```\n # \u64ad\u653e\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6839\u76ee\u5f55\u4e2d\u7684\u6587\u4ef6\n AliPCS-Py play --share-id DaNNsdvi9bi\n\n # \u9012\u5f52\u64ad\u653e\u8fd9\u4e2a\u5206\u4eaburl\u4e0b\u7684\u6240\u6709\u7684\u6587\u4ef6\n AliPCS-Py play --share-id DaNNsdvi9bi -R\n\n # \u64ad\u653e\u8fd9\u4e2a\u5206\u4eabID\u4e0b\uff0c\u6587\u4ef6\u540d\u4e3a \"613397974b634251e0554d7cb56df3e46d473239\" \u7684\u6587\u4ef6\n AliPCS-Py play --file-id 613397974b634251e0554d7cb56df3e46d473239 --share-id DaNNsdvi9bi\n ```\n\n### \u9009\u9879\n\n\u89c1 `play` \u547d\u4ee4\u3002\n\n## \u4fdd\u5b58\u5176\u4ed6\u7528\u6237\u5206\u4eab\u7684\u94fe\u63a5\n\n\u4fdd\u5b58\u5176\u4ed6\u7528\u6237\u5206\u4eab\u7684\u94fe\u63a5\u5230\u8fdc\u7aef\u76ee\u5f55\u3002\n\n```\nAliPCS-Py save [OPTIONS] SHARE_URL_OR_ID REMOTEDIR\n```\n\n\u6307\u5b9a `--file-id` \u53ef\u4ee5\u4fdd\u5b58\u6307\u5b9a\u7684\u6587\u4ef6\u3002\n\n### \u9009\u9879\n\n| Option | Description |\n| ------------------- | ------------------------------ |\n| -i, --file-id TEXT | \u6587\u4ef6 ID |\n| -p, --password TEXT | \u5206\u4eab\u94fe\u63a5\u5bc6\u7801\uff0c\u5982\u679c\u6ca1\u6709\u4e0d\u7528\u8bbe\u7f6e |\n\n## \u672c\u5730\u4fdd\u5b58\u5206\u4eab\u8fde\u63a5\n\n\u53ef\u4ee5\u5c06\u4ed6\u4eba\u5206\u4eab\u4e86\u8fde\u63a5\u4fdd\u5b58\u81f3\u672c\u5730\uff0c\u800c\u4e0d\u9700\u8981\u4fdd\u5b58\u5728\u7f51\u76d8\u3002\u8fd9\u53ea\u4f5c\u4e3a\u4e00\u4e2a\u8bb0\u5f55\u3002\u5728\u9700\u8981\u662f\u63d0\u4f9b\u67e5\u770b\u641c\u7d22\u529f\u80fd\u3002\n\n\u4f7f\u7528\u8fd9\u4e2a\u529f\u80fd\uff0c\u9700\u8981\u4f7f\u7528\u8005\u5728\u672c\u5730\u914d\u7f6e\u6587\u4ef6(`~/.alipcs-py/config.toml`)\u4e2d\u914d\u7f6e:\n\n```toml\n[share]\nstore = true\n```\n\n\u8fd9\u4e2a\u529f\u80fd\u5f00\u542f\u540e\uff0c\u6240\u6709\u4e0e\u4ed6\u4eba\u5206\u4eab\u8fde\u63a5\u7684\u64cd\u4f5c\uff0c\u90fd\u4f1a\u5c06\u8fde\u63a5\u548c\u5176\u4e2d\u8bbf\u95ee\u8fc7\u7684\u6587\u4ef6\u4fe1\u606f\u4fdd\u5b58\u5728\u672c\u5730\u6587\u4ef6 `~/.alipcs-py/shared-store.sqlite3` \u4e2d\u3002\n\n\u4f7f\u7528\u8005\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u547d\u4ee4\u6765\u67e5\u770b\u6216\u641c\u7d22\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u3002\n\n## \u4fdd\u5b58\u5206\u4eab\u8fde\u63a5\u81f3\u672c\u5730\n\n```\nAliPCS-Py storesharedlinks [OPTIONS] [SHARE_URLS_OR_IDS]...\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n| Option | Description |\n| ------------------- | ------------------------------ |\n| -p, --password TEXT | \u5206\u4eab\u94fe\u63a5\u5bc6\u7801\uff0c\u5982\u679c\u6ca1\u6709\u4e0d\u7528\u8bbe\u7f6e |\n\n## \u663e\u793a\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\n\n```\nAliPCS-Py listsharedlinks\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n## \u663e\u793a\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u6587\u4ef6\n\n```\nAliPCS-Py listsharedfiles [OPTIONS]\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n| Option | Description |\n| --------------------- | -------------------------- |\n| --share-id, --si TEXT | \u6307\u5b9a\u663e\u793a share id \u4e0b\u7684\u6587\u4ef6 |\n\n## \u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\n\n```\nAliPCS-Py findsharedlinks [KEYWORDS]...\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n## \u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u6587\u4ef6\n\n```\nAliPCS-Py findsharedfiles [KEYWORDS]...\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n| Option | Description |\n| --------------------- | ----------------- |\n| --share-id, --si TEXT | \u8981\u641c\u7d22\u7684 share id |\n| -v, --verbose | \u663e\u793a\u7ec6\u8282 |\n\n## \u67e5\u627e\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u548c\u6587\u4ef6\n\n```\nAliPCS-Py findshared [OPTIONS] [KEYWORDS]...\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n| Option | Description |\n| ------------- | ----------- |\n| -v, --verbose | \u663e\u793a\u7ec6\u8282 |\n\n## \u5220\u9664\u672c\u5730\u4fdd\u5b58\u7684\u5206\u4eab\u8fde\u63a5\u6216\u6587\u4ef6\n\n```\nAliPCS-Py deletestoredshared [OPTIONS] [SHARE_IDS]...\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n| Option | Description |\n| ------------------ | ---------------------------------------------------------- |\n| -k, --keyword TEXT | \u8981\u5220\u9664\u6587\u4ef6\u540d\u7684\u5173\u952e\u5b57\uff0c\u5982\u679c\u4e3a\u7a7a\u5219\u5220\u9664 share_id \u4e0b\u7684\u6240\u6709\u6587\u4ef6 |\n\n## \u6e05\u7406\u672c\u5730\u4fdd\u5b58\u7684\u65e0\u6548\u5206\u4eab\u8fde\u63a5\n\n```\nAliPCS-Py cleanstore\n```\n\n**\u6ce8\u610f**: \u4f7f\u7528\u8fd9\u4e2a\u547d\u4ee4\u5fc5\u987b\u5c06\u914d\u7f6e\u6587\u4ef6 ~/.alipcs-py/config.toml \u4e2d\u7684 [share] store \u8bbe\u4e3a true\n\n## \u5f00\u542f HTTP \u670d\u52a1\n\n\u5728\u8fdc\u7aef `ROOT_DIR` \u76ee\u5f55\u4e0b\u5f00\u542f HTTP \u670d\u52a1\u3002\n\n`ROOT_DIR` \u9ed8\u8ba4\u4e3a `/`\n\n```\nAliPCS-Py AliPCS-Py server [OPTIONS] [ROOT_DIR]\n```\n\n\u5982\u679c\u9700\u8981\u8bbe\u7f6e\u8ba4\u8bc1\uff0c\u4f7f\u7528\u4e0b\u9762\u7684\u9009\u9879\u8bbe\u7f6e\u7528\u6237\u540d\u548c\u5bc6\u94a5\uff1a\n\n```\nAliPCS-Py AliPCS-Py server [ROOT_DIR] --username 'foo' --password 'bar'\n```\n\n\u4e5f\u53ef\u4ee5\u6307\u5b9a\u670d\u52a1\u8def\u5f84\uff1a\n\n```\nAliPCS-Py AliPCS-Py server [ROOT_DIR] --path '/my/pan'\n\n# \u8bbf\u95ee http://localhost:8000/my/pan/\n```\n\n### \u9009\u9879\n\n| Option | Description |\n| ----------------------------- | ---------------------------- |\n| --path TEXT | \u670d\u52a1\u8def\u5f84\uff0c\u9ed8\u8ba4\u4e3a \u201c/\u201d |\n| -h, --host TEXT | \u76d1\u542c host |\n| -p, --port INTEGER | \u76d1\u542c port |\n| -w, --workers INTEGER | \u8fdb\u7a0b\u6570 |\n| --encrypt-password, --ep TEXT | \u52a0\u5bc6\u5bc6\u7801\uff0c\u9ed8\u8ba4\u4f7f\u7528\u7528\u6237\u8bbe\u7f6e\u7684 |\n| --username TEXT | HTTP Basic Auth \u7528\u6237\u540d |\n| --password TEXT | HTTP Basic Auth \u5bc6\u94a5 |\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Ali Pcs Api and App",
"version": "0.8.0",
"project_urls": {
"Homepage": "https://github.com/PeterDing/AliPCS-Py"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1183b29af2d9256017e0362d623466e2b06efe24c6204cb8b511ebc8c36383ef",
"md5": "c45f35fd1b6e87142362b597de502734",
"sha256": "67aacf7c1f5d30189ef5c4a22587a63b2cf181fce521eedd028451f85b655c2a"
},
"downloads": -1,
"filename": "alipcs_py-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "c45f35fd1b6e87142362b597de502734",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 114947,
"upload_time": "2024-04-09T14:43:31",
"upload_time_iso_8601": "2024-04-09T14:43:31.234381Z",
"url": "https://files.pythonhosted.org/packages/11/83/b29af2d9256017e0362d623466e2b06efe24c6204cb8b511ebc8c36383ef/alipcs_py-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-09 14:43:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PeterDing",
"github_project": "AliPCS-Py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "alipcs-py"
}
JSON
