fundrive-quark

夸克网盘（Quark）Web API 封装，提供分享链接解析、文件转存、文件列表、 文件夹批量分享等常用能力，供 fundrive 及其他项目以统一命名空间接入夸克网盘。

环境要求

Cookie 的取法：浏览器登录 https://pan.quark.cn，开发者工具 → Network → 任意一个 drive-pc.quark.cn 请求 → 复制请求头里的 cookie 整行。 该 Cookie 等同于账号登录态，不要写进代码或提交到仓库，建议走环境变量读取。

安装

本包尚未发布到 PyPI，目前从仓库安装：

pip install git+https://github.com/farfarfun/fundrive-quark.git
# 或
uv add git+https://github.com/farfarfun/fundrive-quark.git

快速开始

from fundrives.quark import QuarkPanError, QuarkPanManage

import os

# cookies 为已登录夸克网盘账号的浏览器 Cookie 字符串，从环境变量读取，不要写死在代码里
drive = QuarkPanManage(cookies=os.environ["QUARK_COOKIES"])

# 将他人分享的文件转存到自己网盘的根目录
# 返回 True 表示转存任务确实完成，False 表示被跳过（网盘中已存在、分享为空等）
saved = drive.save_shared("https://pan.quark.cn/s/xxxxxxxx", folder_id="0")

# 列出根目录文件
file_list = drive.get_file_list(pdir_fid="0")
for item in file_list["data"]["list"]:
    print(item["file_name"])

# 批量分享：传网盘的文件夹网页地址，末段形如 `<目录fid>-<目录名>`
# 返回失败条目，可直接喂回 share_retry 重试
try:
    failed = drive.share("https://pan.quark.cn/list#/list/all/<目录fid>-<目录名>")
    if failed:
        drive.share_retry("\n".join(failed))
except QuarkPanError as e:
    print(f"批量分享中断：{e}")

主要能力

• 分享链接解析、转存（单文件 store、批量 save_shared）
• 文件/文件夹列表、搜索、删除、新建目录
• 文件夹批量分享（share/share_retry），支持提取码与失败重试

返回值与异常约定

• 「跳过」用返回值表达（save_shared 返回 False、safe_copy 返回 False、 share/share_retry 返回失败条目列表），调用方据此判断是否真的做了事。
• 「失败」一律抛异常：接口返回非 JSON、异步任务轮询超时、分页超过上限等都抛 QuarkPanError，异常信息带接口路径 / task_id / 目录等上下文；网络层错误直接 透出 requests.RequestException。不会出现「记一条日志后装作成功」的情况。

关于 farfarfun

farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。

• 🏠 组织主页：https://github.com/farfarfun
• 📦 PyPI：https://pypi.org/user/niuliangtao/
• 📧 联系：farfarfun@qq.com

本项目基于 MIT 协议开源。