1、123Pan Cli工具

123 网盘命令行工具，支持列出文件、下载、上传、分享、删除、创建目录及回收站管理。

• 1、123Pan Cli工具
  • 1.1 特性
  • 1.2 脚本环境要求
  • 1.3 安装与运行
    • 1.3.1 脚本运行
    • 1.3.2 下载release版
  • 1.4 配置文件（JSON）
  • 1.5 常用命令（交互式）
• 2、Python API 模块
• 3、下载说明
• 4、注意事项
• 5、免责声明

1.1 特性

• 登录 / 登出
• 列出当前目录文件（ls）
• 切换目录（cd）与刷新（refresh / re）
• 下载单文件或递归下载文件夹（download / d）
• 上传文件（upload）
• 创建文件夹（mkdir）
• 删除文件（rm）
• 创建分享链接（share）
• 获取文件直链（link）
• 回收站管理（recycle / restore）
• 协议切换（protocol android|web）
• 支持保存配置到 JSON 文件（authorization、device/os、protocol 等）

1.2 脚本环境要求

• Python 3
• 依赖库：requests
  安装：

  pip install requests  

1.3 安装与运行

1.3.1 脚本运行

1. 克隆或下载本仓库到本地。
2. 进入项目目录。
3. 运行脚本：

   python pan123_cli.py  

   启动后会提示输入用户名 / 密码，或自动读取配置文件（默认 pan123_config.json，脚本内部根据传入参数使用该文件）。

1.3.2 下载release版

根据系统下载对应的 release 版本，解压后运行 123pan.exe（Windows）或 123pan（Linux）。

1.4 配置文件（JSON）

脚本会读取并保存一个配置文件（示例 pan123_config.json），保存登录状态与偏好，格式示例：

{
  "userName": "your_username",
  "passWord": "your_password",
  "authorization": "Bearer xxxxx",
  "deviceType": "M2007J20CI",
  "osVersion": "Android_10",
  "protocol": "android"
}  

注意：保存密码或 token 到本地会有安全风险，请在可信环境下使用并妥善保护该文件。

1.5 常用命令（交互式）

在脚本交互提示符中输入命令，部分带参数：

指令	用法示例	功能说明
直接输入编号	3	若编号对应文件夹 → 进入该文件夹；若为文件 → 直接下载该文件
ls	ls	显示当前目录的文件与文件夹列表
cd [编号|..|/]	cd 3、cd ..、cd /	切换目录：进入指定编号的文件夹、返回上级、返回根目录
mkdir [名称]	mkdir test	在当前目录创建文件夹
upload [路径]	upload C:\Users\you\Desktop\file.txt	上传文件到当前目录（仅支持单个文件）
rm [编号]	rm 2	删除当前列表中指定编号的文件/文件夹（移入回收站）
share [编号 ...]	share 2 4	为指定文件创建一个或多个分享链接，可设置提取码（可为空）
link [编号]	link 3	获取指定文件的直链地址
download / d [编号]	download 5 或 d 5	下载指定编号的文件或文件夹（文件夹将递归下载）
recycle	recycle	查看回收站内容，可恢复指定编号项或输入 clear 清空回收站
refresh / re	refresh 或 re	刷新当前目录列表
reload	reload	重新加载配置文件并刷新目录
login / logout	login、logout	手动登录或登出（清除授权信息）
clearaccount	clearaccount	清除已登录账号（包括用户名和密码）
more	more	当目录分页未加载完时，继续加载更多内容
protocol [android|web]	protocol web	切换通信协议（如 android/web），并可选择保存配置
exit	exit	退出程序

---

交互示例：

/> cd demo  
无效命令，使用 '..' 返回上级，'/' 返回根目录，或输入文件夹编号  
/> cd 1     
当前目录为空  
/demo1> ls  
当前目录为空  
/demo1> mkdir test  
目录 'test' 创建成功  

/demo1> 1  
当前目录为空  
/demo1/test> upload 123pan.py  
上传进度: 100.0%  
上传完成，正在验证...  
文件上传成功  
------------------------------------------------------------  
编号    类型      大小          名称  
------------------------------------------------------------  
1     文件      38.66 KB    123pan.py  
============================================================  

/demo1/test> 1  
开始下载: 123pan.py  
进度: 100.0% | 38.66 KB/38.66 KB | 10.29 MB/s        
下载完成: 123pan.py  
/demo1/test>  

2、Python API 模块（pan123_core.py）

Python API 详细文档请见 PYTHON_API.md，涵盖：

• 快速开始（3种初始化方式）
• 完整 API 方法列表（登录、目录浏览、文件操作、上传、下载、分享）
• 工具类 Pan123Tool 使用说明
• 完整示例代码
• 返回值格式和文件字段说明
• 注意事项

---

3、下载说明

• 下载到脚本所在目录的 download 文件夹，下载过程中使用临时后缀 .123pan，下载完成后会重命名为原文件名。
• 如果文件已存在，会提示覆盖 / 跳过 / 全部覆盖 / 全部跳过等选项。

4、注意事项

• 本工具用于学习与自用场景，请勿用于违法用途。对任何滥用造成的后果，本人概不负责。
• 模拟客户端协议可能存在账号或服务端策略风险，请谨慎使用。
• 建议不要在公用或不受信任的机器上保存明文密码或授权信息。

5、免责声明

本工具用于学习场景，请勿用于违法用途。对任何滥用造成的后果，作者概不负责。 任何未经允许的api调用都是不被官方允许的，对于因此产生的账号风险、数据损失等后果自负。