Skip to content
rachpt edited this page Jul 4, 2020 · 5 revisions

基于版本 v1.0.0

安装

  1. 确保 $PATH 中的 Python 版本 >= 3.8
  2. 下载源代码,推荐使用git clone git clone --depth=1 https://github.com/Aruelius/cloud189.git
  3. 依据操作系统选择安装 requirements.txt
  4. 如果有必要,添加 alias,比如 bash 用户,echo 'alias cloud189="/path/to/cloud189.git/main.py"' >> $HOME/.bashrc

登录 (login、clogin)

对于使用 git clone 的代码,main.py 已经添加了可执行权限,zip 源代码可能需要 chmod u+x ./main.py.

在终端中直接运行(输入) /path/to/cloud189/main.py 按提示依次输入 用户名(11数字位手机号)、密码,其中密码输入没有回显,若是输入错误请按退格删除重新输入。对于_没有办法设置登录密码_的特殊用户,请两次回车进入软件,输入 clogin 命令按提示输入 网页 cookie,至于如何获取 cookie 请使用搜索引擎查询,注意 cookie 仅需要 COOKIE_LOGIN_USER 的值。

登录成功后,看到 如 全部文件 > 所示的提示信息就表示登录成功,用户名、密码、cookie 等信息会加密存储在软件目录下的 .config 文件(隐藏文件,shell 使用 ls -a 可以看到)。

查看帮助文档 (help)

软件内置了一份简短的帮助文档,详细使用说明见本页

交互模式:登录状态 键入 help
单任务模式:(需要事先登录) ./main.py help

得到的文档大致如下:

 cloud189-cli | 天翼云盘客户端 for Linux | v1.0.0
    • 支持文件秒传,文件夹保持相对路径上传
    • 获取文件分享链接,批量上传下载,断点续传等功能

    命令帮助 :
    help        显示本信息
    update      检查更新
...

切换目录 (cd)

和 linux 系统操作类似,不同不同之处在于 所接参数 仅能是当前目录的子文件夹或者 根目录(/)、父目录(..)

本命令仅支持 交互模式 使用,文件夹名支持 tab 自动补全(需要键入首字符)。

示例: cd my-foldercd my\ foldercd 'my folder'cd "I'm a folder name"

注意: 对于有空格等特殊符号的文件(夹)名,需要使用 英文引号('")包裹或者使用转义符 \,后面一样.

查看当前目录文件 (ls、ll)

llls -l 的别名,ls只打印文件(夹)名,ls -l 会打印 文件(夹)ID、创建日期、大小(仅文件)、文件名。

该命令支持在两种模式下运行,后面可以接一个 当前目录子文件夹名作为参数(与 cd 类似)。

示例:./main.py ll./main.py ls /
注意: 如果参数错误会打印当前目录文件信息。

新建文件夹 (mkdir)

在当前工作目录新建文件夹,如果文件夹已经存在,会返回存在文件夹的 id 信息。

该命令支持在两种模式下运行,需要紧紧接 文件名。

示例: > mkdir my-folder./main.py mkdir another-folder.

移动文件(夹) (mv)

本命令非常耗时,因为需要递归查找所有子文件夹,并建立文件夹路径-id索引 直接跟上目标文件夹id可以跳过递归查询所有文件夹过程

该命令支持在两种模式下运行,参数:文件(夹)名 [新文件夹名/文件夹id],后一个参数可以交互式输入。

示例:

./main.py mv my-file.zip
Info : 正在获取所有文件夹信息,请稍后...
请输入路径(TAB键补全) : `全部文件/file-folders`

> mv my-file.zip 全部文件/file-folders
> mv my-file-bak.zip 1234567800

其他:
推荐直接输入文件id,减少耗时。

重命名文件(夹) (rename)

该命令支持在两种模式下运行,参数:原文件名 [新文件名],新文件名可以交互式输入。

示例:> rename my-file.zip my_new_file.zip

./main.py rename my_new_file.zip
请输入新文件名:another-name.zip

删除文件(夹) (rm)

文件(夹)删除后会进入回收站

该命令支持在两种模式下运行,参数:删除文件(夹)名

文件(夹)上传 (upload、u)

uupload 的简短别名,支持参数 -f-F-n,上传到当前工作目录,暂不支持到指定文件夹。

该命令(upload)支持在两种模式下运行,参数:[-fFn] 文件(夹)路径1 文件(夹)路径2 ...

参数说明:

  1. -f = --follow 表示前台显示进度,
  2. -F = --force 强制上传云端已经存在的文件,
  3. -n = --nodir 上传文件夹时,不创建这个文件夹名(子文件夹会递归创建)

示例:

./main.py upload /home/my/folder/path-1 /home/my/folder/path-2
[0] .....  | folder-name (x/y) -> 远端文件夹
[1] .....  | folder-name (a/b) -> 远端文件夹

yb 表示两个目录总文件数量,xa表示已经上传完成的的数量,在 ..... 未知可能会出现 秒传检查秒传!87%等进度信息。

> u -n /home/my/folder/path-1 my-file.7z进入后台任务,使用 jobs命令查看详情。

其他: u 只在交互模式下能够使用。

下载文件(夹) (down、d)

进度显示与 upload 类似,不推荐下载文件夹,原因见这里.

该命令支持在两种模式下运行,参数:需下载文件(夹)名

参数说明:

  1. -f 表示前台显示进度

示例与上传文件类似。

账户信息 (who、quota)

该命令支持在两种模式下运行,无参数

示例自行探索。

添加用户 (login、clogin)

与登录类似,添加一个新的用户,并切换,除了新增用户,还能修改密码,更新cookie.

切换用户 (su)

支持参数 -l,列出所有已经登录了的账户信息

该命令支持在两种模式下运行,可选参数 用户名(11位手机号),
不输入参数进入交互选择模式,按提示操作即可。

示例自行探索。

设置下载位置 (setpath)

默认下载在软件目录的 downloads文件夹。

该命令支持在两种模式下运行,无参数。
会先打印当前下载路径,按提示键入新的下载保存位置即可

示例自行探索。

清屏 (clear、c)

清空屏幕内容,Linux 下我更喜欢 Ctrl + L

示例自行探索。

分享文件 (share)

分享文件

该命令支持在两种模式下运行,参数:需要分享的文件 [1/2/3] [1/2]
后面两个参数分别表示分享时间是否需要提取码,请使用交互方式查看参数意义。

示例自行探索。

列出分享文件 (shared)

自行探索。

签到+抽奖 (sign)

支持参数 -a/--auto

该命令支持在两种模式下运行,参数 -a or --auto 表示对所有登录账户都签到+抽奖。

示例自行探索。

软件检测新版 (update)

自行探索。 (待完善)

后台任务 (jobs)

自行探索。 (待完善)

列出文件 (ls)

自行探索。 (待完善)

回收站 (cdrec)

自行探索。 (待完善)

恢复文件 (rec)

自行探索。 (待完善)

t退出回收站 (cd ..)

刷新当前目录 (refresh)

自行探索。 (待完善)

退出软件 (bye、exit、b)

b 为简短命令别名

无参数

示例自行探索。

删除登录账户 (logout)

参数: 需要删除账户名(11位手机号)

示例自行探索。