quark-to-zsxq

name	quark-to-zsxq
version	2.0.0
description	夸克网盘分享链接自动创建并发布到知识星球，支持文件/文件夹/文档分享、 文件夹扫描批量分享、异步任务轮询、文件列表/搜索，Playwright浏览器自动化发布
trigger_words	["夸克分享","夸克转星球","知识星球发布","夸克网盘分享到星球","自动分享到知识星球","扫描文件夹分享","自发群文件夹","quark share","zsxq publish","scan folder share"]

夸克网盘 → 知识星球 自动发布 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})

命令示例

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

方法	说明
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