UNPKG

pcs-cli

Version:

Baidu Personal Cloud Storage's Command Line Interface.

github.com/sobird/pcs-cli

sobird/pcs-cli

163 lines (134 loc) • 4.52 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
# pcs CLI 百度个人云存储命令行接口 [![npm][npm]][npm-url] [![Build Status][build-status]][build-status-url] [![Install Size][size]][size-url] ## 安装 ```sh npm i -g pcs-cli ``` ## 使用 在终端执行下面命令： ``` pcs-cli [command] [options] ``` ### 可用命令 ``` Commands: init [options] initialize baidu pcs refresh [options] refresh token quota [options] check your cloud storage status meta [options] [path] get path meta list|ll [options] [path] list directory contents upload [options] [pattern] [remote] upload local file download|dl [options] [remote] [local] download remote file delete|rm [options] <remote> delete remote file fetch [options] [source] [remote] fetch source to remote help [command] display help for command ``` ### init 在初始化之前，需要提供百度PCS应用的name，key，secret。如果没有请访问 [创建应用](https://pan.baidu.com/union/console/createapp) 进行创建，如果已有应用请访问 [应用列表](https://pan.baidu.com/union/console/applist) 查看应用信息。 ```sh pcs init -n name -k key -s secret # 或者 根据提示填写应用的name key secret pcs init # 如果本地已存在有效的access_token 再次运行该命令将会有如下提示 Your access token has not expired (expiration date: 2023-12-10 22:49:14). ? Do you want to continue initializing? › (y/N) # 选择yes将会重新生成token，否则取消操作 ``` 初始化完成后，将在本地生成一个有效期30天的token，存放路径为`~/.pcs-cli`。 ### refresh `access_token` 有效期30天，过期后支持刷新，刷新后的 `access_token` 有效期仍为 30 天，刷新 `access_token` 请按需刷新，不需要不停的刷新。 刷新请求，如果API返回失败，旧的 `refresh_token` 会失效，此时需要重新发起授权请求，获取新的 `access_token`、`refresh_token`，而不是使用旧的 `refresh_token` 循环再发起刷新请求。 `refresh_token` 只支持使用一次，`refresh_token` 使用后失效，下次刷新 `access_token` 时需要使用上一次刷新请求响应中的 `refresh_token`。 ```sh pcs refresh Successfully refreshed token ``` ### quota 该命令用来查看pcs配额状态 ```sh pcs quota ███████████████░░░░░░░░░░░░░░░ 1.6TB/3.1TB 51% ``` ### meta 用于获取用户指定文件的meta信息，meta信息包括文件名字、文件创建时间、文件的下载地址等。 ```sh # 不指定路径，默认使用应用的根路径 pcs meta { app_id: 123456, category: 6, ctime: 1699853947, extent_int3: 2919719500, extent_tinyint1: 0, extent_tinyint2: 0, extent_tinyint3: 0, extent_tinyint4: 0, from_type: 0, fs_id: 680163361072043, ifhassubdir: 0, isdelete: 0, isdir: 1, local_ctime: 1699853947, local_mtime: 1699853947, mtime: 1699873611, oper_id: 2919719500, owner_id: 0, owner_type: 0, parent_path: '/apps', path: '/apps/appName', privacy: 2, real_category: '', server_ctime: 1699853947, server_filename: 'appName', server_mtime: 1699873611, share: 0, size: 0, status: 0, tkbind_id: 0, user_id: 12345678, videotag: 0, wpfile: 0 } ``` ### list 获取指定目录下的文件列表。 ```sh # 不指定路径，默认使用应用的根路径 pcs list 2023/11/13 13:40:12 1MB split23.mp4 2023/11/13 13:40:14 1MB split22.mp4 2023/11/13 13:40:15 107B package.json 2023/11/13 13:40:17 527.7KB IMG_3224.jpeg 2023/11/13 13:40:23 2.21MB IMG_3222.jpeg ``` ### upload 上传文件 ```sh # 不指定本地文件路径，默认上传当前目录下的所有文件 pcs upload ``` ### download 下载文件 ```sh # 不指定远程文件路径，默认下载远程根目录下的所有文件 pcs download ``` ### delete 删除远程文件 ```sh pcs rm ``` ### fetch 离线下载(貌似不支持) ```sh pcs fetch [source] [remote] ``` [npm]: https://img.shields.io/npm/v/pcs-cli.svg [npm-url]: https://www.npmjs.com/package/pcs-cli [build-status]: https://img.shields.io/github/actions/workflow/status/sobird/pcs-cli/release-please.yml?label=CI&logo=github [build-status-url]: https://github.com/sobird/pcs-cli/actions [size]: https://packagephobia.com/badge?p=pcs-cli [size-url]: https://packagephobia.com/result?p=pcs-cli