# Quark To Zsxq

> 夸克网盘分享链接自动创建并发布到知识星球，支持文件/文件夹/文档分享、 文件夹扫描批量分享、异步任务轮询、文件列表/搜索，Playwright浏览器自动化发布

- Skill: `whb786200/quark-to-zsxq` (Agent Skill, multi-file: 19 files)
- Install (CLI): `npx skillmds@latest add whb786200/quark-to-zsxq`
- Raw SKILL.md: https://api.skillmd.com/api/skills/whb786200/quark-to-zsxq/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: whb786200 (https://skillmd.com/u/whb786200)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/whb786200/quark-to-zsxq

---


# 夸克网盘 → 知识星球 自动发布 Skill (v2.0)

## 功能概述

将夸克网盘的文件/文件夹/文档创建分享链接，并自动发布到知识星球。
**v2.0 新增**: 文件夹扫描批量分享、文件列表/搜索、异步任务轮询、自发群文件夹一键分享。

## 核心模块

| 文件 | 功能 |
|------|------|
| `quark_share.py` | 夸克网盘分享 + 文件管理（API方式，Cookie认证） |
| `zsxq_publisher.py` | 知识星球发布（Playwright浏览器自动化） |
| `main.py` | CLI入口，串联全流程 |
| `get_cookie.py` | Playwright登录获取Cookie（推荐） |
| `get_cookie_cdp.py` | 通过CDP连接已打开Chrome提取Cookie |

## 使用方式

### 前置条件

1. 安装依赖: `pip install requests playwright && playwright install chromium`
2. 配置夸克Cookie: 运行 `python get_cookie.py`（推荐，自动提取完整Cookie）
   - 或手动运行 `python main.py --init-config`
3. Cookie手动获取: 登录 https://pan.quark.cn → F12 → Network → 复制Cookie
4. 星球ID: 从知识星球URL中提取 (`wx.zsxq.com/dweb/#/group/{星球ID}`)

### 命令示例

```bash
# 初始化配置
python main.py --init-config

# 单个文件分享+发布
python main.py --file-id <fid> --title "工程资料" --group-id <星球ID>

# 文档分享+发布
python main.py --doc-id <doc_id> --title "方案文档" --group-id <星球ID>

# ★ 扫描文件夹(先预览, 不实际分享)
python main.py --scan-folder "自发群" --dry-run

# ★ 扫描文件夹+创建分享链接
python main.py --scan-folder "自发群"

# ★ 扫描文件夹+分享+发布到知识星球
python main.py --scan-folder "自发群" --publish

# ★ 用文件夹ID直接扫描
python main.py --scan-folder 123456789

# 仅分享不发星球
python main.py --file-id <fid> --title "资料" --no-publish

# 列出根目录文件
python main.py --list-files

# 搜索文件
python main.py --search "工程资料"

# 批量执行(JSON配置)
python main.py --batch config/tasks.json

# 仅发布已有链接
python main.py --publish-only --url "https://pan.quark.cn/s/xxx" --title "好资料" --group-id <星球ID>
```

### 批量任务格式

```json
[
  {
    "file_id": "fid_001",
    "type": "file",
    "title": "安全生产资料合集",
    "content": "描述内容",
    "expire_time": 0,
    "password": ""
  }
]
```

## 工作流程

### 单文件分享流程
```
用户指定文件ID → 夸克API创建分享链接 → 获取share_url+密码
                                          ↓
                    知识星球Playwright自动发布 ← 拼接标题+链接+密码
```

### 文件夹批量分享流程 (v2.0)
```
用户指定文件夹名称/ID → 模糊匹配查找文件夹
                            ↓
              扫描文件夹内所有文件 → 逐个创建分享链接
                            ↓
              (可选) 批量发布到知识星球
```

## quark_share.py 新增方法 (v2.0)

| 方法 | 说明 |
|------|------|
| `get_file_list(folder_id, page_size, sort_by)` | 获取文件夹文件列表(自动翻页) |
| `get_folder_list(parent_id)` | 获取子文件夹列表 |
| `search_files(keyword, folder_id)` | 搜索文件 |
| `get_file_info(file_id)` | 获取文件详情 |
| `scan_folder_for_sharing(folder_id)` | 扫描可分享文件(生成器) |
| `find_folder_by_name(name, parent_id)` | 按名称查找文件夹 |
| `auto_scan_and_share_folder(...)` | 一键扫描+分享文件夹 |

## 注意事项

- 夸克Cookie有效期有限，需定期更新（推荐用 `get_cookie.py` 或 `get_cookie_cdp.py` 获取完整Cookie）
- 首次运行知识星球发布会弹出浏览器窗口，需手动扫码登录
- 登录后Cookie会自动保存，后续无需重复登录
- 批量操作建议间隔3秒以上，避免触发风控
- Windows终端遇到emoji编码错误时，用 `-X utf8` 参数运行 Python