Quark Netdisk Skill

AI 智能体技能：通过 quarkpan CLI 操作夸克网盘，实现文件上传、下载、分享和管理。

概述

本技能使 AI 编程助手（Claude Code、Cursor、Clawdbot 等）能够操作夸克网盘进行文件管理。基于 quarkpan CLI 工具的修复版本实现。

核心功能

二维码扫码登录：安全便捷的认证方式
文件上传：支持单文件和文件夹上传，自动分片，支持秒传
文件下载：支持断点续传的文件下载
文件管理：创建目录、删除、重命名、移动、搜索
分享功能：创建分享链接、转存他人分享

前置条件

安装修复版 quarkpan（包含秒传修复）：

pip install git+https://github.com/z1w2r3/QuarkPan.git

注意：原版 quarkpan 存在上传 bug，建议使用上述修复版本。

验证安装：

quarkpan version

使用策略（重要）

在执行任何操作前，请遵循以下逻辑：

先尝试直接执行命令（如 quarkpan ls 或 quarkpan status）
如果命令执行成功，说明已登录，继续执行后续操作
只有在出现明确的认证错误时（如 "未登录或登录已过期"），才需要重新登录

不要在每次操作前都要求用户重新扫码登录！ quarkpan 会自动保存登录状态。

快速检查登录状态

# 执行这个命令，如果返回文件列表，说明已登录
quarkpan ls

如果上述命令成功返回结果，可以直接进行上传、下载等操作，无需登录。

工作流程

登录认证（仅在未登录或登录过期时需要）

方式一：AI 助手展示二维码（推荐）

AI 助手使用 scripts/qr_login.py 脚本生成二维码图片并展示给用户：

# 1. 生成二维码图片
python3 scripts/qr_login.py generate
# 输出: {"status": "ok", "qr_image": "/tmp/quark_qr/login_qr.png", ...}

# 2. AI 助手使用 Read 工具展示二维码图片
# Read /tmp/quark_qr/login_qr.png

# 3. 用户扫码后检查登录状态
python3 scripts/qr_login.py check
# 输出: {"status": "success", "message": "登录成功！", ...}

方式二：用户终端登录

# 显示二维码，用夸克 APP 扫描登录
quarkpan auth login

# 检查登录状态
quarkpan status

登录状态会自动保存，无需每次登录。

文件列表

# 列出根目录
quarkpan ls

# 列出指定目录
quarkpan ls /path/to/folder

# 查看目录树结构
quarkpan list-dirs

上传文件

# 上传文件到根目录（支持绝对路径和相对路径）
quarkpan upload ./file.txt
quarkpan upload /Users/xxx/file.txt

# 上传文件到指定目录
quarkpan upload ./file.txt -f /remote/path/

# 上传并自动创建不存在的目录
quarkpan upload ./file.txt -f /new/folder/ -c

注意事项：

支持绝对路径和相对路径
大文件会自动分片上传
支持秒传（相同文件秒速完成）
使用 -f 指定目标路径，-c 自动创建目录

下载文件

# 下载文件到当前目录
quarkpan download file /网盘路径/文件名

# 下载文件到指定目录
quarkpan download file /网盘路径/文件名 -o /本地目录/

# 下载整个文件夹
quarkpan download folder /网盘文件夹路径/ -o /本地目录/

特性：

支持断点续传
大文件分片下载
使用 -o 指定下载目录

文件管理

# 创建目录
quarkpan mkdir /new/folder

# 删除文件或目录
quarkpan rm /path/to/file

# 重命名
quarkpan rename /old/name /new/name

# 移动文件
quarkpan mv /source/path /target/path
quarkpan move-to /file/path "目标文件夹名"

# 搜索文件
quarkpan search "关键词"

# 获取文件信息
quarkpan fileinfo /path/to/file

分享功能

# 创建分享链接
quarkpan share /path/to/file

# 列出我的分享
quarkpan shares

# 批量分享
quarkpan batch-share /path/to/folder

# 转存他人分享
quarkpan save "分享链接"

# 批量转存
quarkpan batch-save links.txt

命令速查表

功能	命令
登录	`quarkpan auth login`
检查状态	`quarkpan status`
列出文件	`quarkpan ls [路径]`
目录树	`quarkpan list-dirs`
上传	`quarkpan upload 本地路径 -f 网盘路径`
下载	`quarkpan download file 网盘路径 -o 本地目录`
创建目录	`quarkpan mkdir 路径`
删除	`quarkpan rm 路径`
重命名	`quarkpan rename 旧名新名`
移动	`quarkpan mv 源路径目标路径`
搜索	`quarkpan search 关键词`
分享	`quarkpan share 路径`
转存	`quarkpan save 分享链接`
交互模式	`quarkpan interactive`

错误处理

未登录或登录过期

Error: 未登录或登录已过期

解决： 运行 quarkpan auth login 重新扫码登录

文件不存在

Error: 文件或目录不存在

解决： 使用 quarkpan ls 确认正确路径

网络错误

Error: 网络连接失败

解决： 检查网络连接，稍后重试

存储空间不足

Error: 存储空间不足

解决： 清理网盘文件或升级会员

最佳实践

定期检查登录状态：长期不使用后运行 quarkpan status
使用绝对路径：网盘路径始终以 / 开头
分批处理大量文件：避免触发 API 频率限制
上传前确认本地文件：确保文件存在且路径正确
下载后验证文件：检查文件完整性

交互模式

对于复杂操作，可以使用交互模式：

quarkpan interactive

或使用浏览模式：

quarkpan browse

quark-netdisk