Quark To Zsxq

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

功能概述

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

核心模块

使用方式

前置条件

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})

命令示例

# 初始化配置
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>

批量任务格式

[
  {
    "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)

注意事项

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