---
name: quark-sign-skill
description: 夸克网盘自动签到。支持通过 URL 参数执行每日签到获取容量奖励，零外部依赖（Python 标准库即可运行）。
---

# 夸克网盘签到

自动执行夸克网盘每日签到，获取容量奖励。

## 触发场景

- 用户提到「夸克签到」「夸克网盘签到」「签到」且上下文明确指向夸克网盘
- 用户要求配置夸克网盘自动签到

## 前置要求

- Python 3.7+（已预装）
- 夸克网盘签到 URL（从夸克 App 或网页获取）

## 获取签到 URL

1. 打开夸克网盘 App 或网页版
2. 进入「容量管理」或「签到」页面
3. 浏览器开发者工具 → Network → 找到类似 `growth/sign` 或 `growth/reward_record` 的请求
4. 复制完整 URL（包含 `kps`、`sign`、`vcode` 参数）

URL 格式示例：
```
https://drive-m.quark.cn/1/clouddrive/capacity/growth/reward_record?kps=xxx&sign=yyy&vcode=zzz
```

## 使用方式

### 方式一：直接运行（推荐）

如果 skill 目录下已配置了默认 `config.json`，无需任何参数即可运行：

```bash
python scripts/quark_sign.py
```

### 方式二：直接传 URL

```bash
python scripts/quark_sign.py --url "你的完整URL"
```

### 方式三：配置文件

```bash
# 1. 复制示例配置并编辑
cp config.json.example ~/.config/quark_sign.json
# 填入你的 URL

# 2. 运行
python scripts/quark_sign.py --config ~/.config/quark_sign.json
```

### 方式四：环境变量

```bash
export QUARK_SIGN_URL="你的完整URL"
python scripts/quark_sign.py
```

## 常用命令

```bash
# 执行签到
python scripts/quark_sign.py --url "URL"

# 仅检查今日是否已签到
python scripts/quark_sign.py --url "URL" --check

# 查看签到信息
python scripts/quark_sign.py --url "URL" --info
```

## 输出示例

```
🚀 执行签到...
✅ 签到成功！获得 100.00 MB
```

```
🚀 执行签到...
ℹ️ 今日已签到过，无需重复签到
```

## 默认配置

skill 目录下已内置 `config.json`，作为默认 URL 来源。URL 查找优先级：

1. `--url` 参数
2. `--config` 指定的配置文件
3. 环境变量 `QUARK_SIGN_URL`
4. skill 内置 `config.json`（默认使用）

## 注意事项

- URL 中的 `kps` 和 `sign` 参数有有效期，如失效需重新获取
- 签到奖励通常为 100MB~1GB 不等，随机发放
- 脚本支持 `requests` 库（如已安装）或纯 Python 标准库（零依赖）
- 默认配置适合个人使用，多用户场景建议各自使用 `--config` 或 `--url`

## 配置 cron 定时任务

```bash
# 每天 9 点自动签到
crontab -e
# 添加：
0 9 * * * python3 /path/to/quark-sign-skill/scripts/quark_sign.py --config /root/.config/quark_sign.json >> /var/log/quark_sign.log 2>&1
```
