quark-mswnlz-publisher

版本: v1.4.2

夸克网盘 → mswnlz GitHub 资源仓库 → 站点自动更新，一条龙发布。

更新日志

v1.4.2 (2026-03-15)

• 🐛 修复：脚本启动时自动加载 secrets.env 环境变量，无需手动 export
• 📝 影响脚本：quark_batch_run.py、mswnlz_publish.py

v1.4.1

• 初始稳定版本

📺 视频教程

【资源运营神器Skills】完全开源，夸克网盘+GitHub一条龙全自动发布工具！转存、归类、TG通知、站点更新一键搞定！

📝 文字教程

Twitter/X 教程帖子

触发条件

当用户提供夸克分享链接并需要执行以下任一操作时：

• 批量转存夸克资源
• 生成永久加密分享链接
• 发布到 mswnlz GitHub 仓库
• 更新站点内容

工作区约定

路径	用途
/Users/m./Documents/QNSZ/project	项目根目录
/Users/m./Documents/QNSZ/project/QuarkPanTool	夸克自动化工具
/Users/m./Documents/QNSZ/project/mswnlz	mswnlz 组织仓库
/Users/m./Documents/QNSZ/project/skills	Skills 仓库 (wlzh/skills)

安全要求

• 不要在聊天中粘贴或回显 Token
• 优先使用 GitHub SSH 方式（git@github.com:...）
• 如需 GitHub API，通过环境变量 GITHUB_TOKEN 传入，不要写入文件
• Telegram Token 必须通过环境变量配置（见下方）

环境变量配置

在运行脚本前，需要设置以下环境变量：

# Telegram Bot Token（必须）
export TELEGRAM_BOT_TOKEN="你的Bot Token"

# Telegram 群组配置（可选，用于发送通知）
export TG_GROUP_1_ID="-100XXXXXXXXXX"      # 群组 1 ID
export TG_GROUP_1_THREAD="5"               # 群组 1 话题 ID
export TG_GROUP_2_ID="-100YYYYYYYYYY"      # 群组 2 ID
export TG_GROUP_2_THREAD="2"               # 群组 2 话题 ID

# Telegram 频道 ID（可选）
export TELEGRAM_CHANNEL_ID="@your_channel"

# GitHub Token（可选，用于 API 调用）
export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"

⚠️ 安全提示：

• 永远不要将 Token 硬编码在脚本中
• 永远不要将 Token 提交到 Git 仓库

完整工作流

0) 输入收集

需要用户提供：

• 夸克分享 URL 列表（每条可包含标题）
• 目标月份 YYYYMM（默认：当前月份）
• 批次标签（默认：短裤哥批次）

1) 确保夸克登录状态

• 检查 QuarkPanTool/config/cookies.txt
• 如果不存在或为空：运行 python quark_login.py
• 登录流程：自动打开 Chrome → 用户扫码 → Cookie 自动保存

2) 批量转存 + 生成分享链接

使用 scripts/quark_batch_run.py：

1. 在夸克根目录创建批次文件夹（格式：YYYY-MM-DD_HHMM_<label>）
2. 批量转存所有分享 URL 到该文件夹
3. 列出文件夹内所有项目
4. 为每个顶层项目生成分享链接：
   • url_type=2（加密）
   • expired_type=1（永久）
   • 随机提取码
5. 输出 JSON：batch_share_results.json

3) 复制推广文件到每个资源文件夹内部 🆕

使用 scripts/copy_promo_to_folders.py：

• 从夸克网盘的 temp/要共享的文件 文件夹读取推广文件
• 复制到每个转存的资源文件夹内部（不是批次文件夹）

重要：推广文件会被复制到每个资源文件夹里面，这样分享出去的每个文件夹都包含推广文件。

前提条件：

• 需要提前在夸克网盘创建 temp/要共享的文件 文件夹
• 上传推广文件到该文件夹

推广文件清单：

• 必看免责声明_及加入资源分享群_及_副业_0_成本赚钱教程_资源网站doc_869hr_uk.txt
• 1_解压密码869hr_uk_移动端双击这里.html
• 0_双击获取解压密码_Mac系统双击这里.webloc
• 0_双击获取解压密码_windows系统双击这里.url

4) 自动归类到 mswnlz 仓库

使用 scripts/mswnlz_publish.py：

1. 调用 GitHub API 获取 mswnlz 组织仓库列表
2. 根据标题关键词归类：
   • 影视/电影/剧/纪录片/演唱会 → movies
   • 书/书单/新书/杂志/电子书/合集 → book
   • 其他：根据仓库 description 关键词匹配
3. 克隆/更新本地仓库（SSH 方式）
4. 追加到 <YYYYMM>.md：

   - {标题}-超过100T资料总站网站-doc.869hr.uk | {分享链接}
   

5. 更新 README.md 月份索引（保持倒序）
6. Git commit + push
7. 发送统一的 Telegram 群组通知（多仓库更新只发一条汇总消息）

5) 触发站点重建

使用 scripts/trigger_site_rebuild.sh：

1. 在 mswnlz.github.io 仓库创建空提交
2. Push 到 main 分支
3. 触发 GitHub Actions 构建

6) 返回结果

返回给用户：

• 批次文件夹名称
• 所有分享链接（含提取码）
• 每个项目的目标仓库 + 文件路径
• Actions 运行 URL
• 站点 URL（https://doc.869hr.uk）

7) 生成夸克群组消息 🆕

在 mswnlz_publish.py 执行后：

1. 自动生成格式化的消息
2. 保存到 quark_group_message.txt
3. 控制台输出，方便复制

消息格式：

📦 资源更新通知

📚 书籍资料
------------------------------
• 2026.3.3小说合集推荐
  🔗 https://pan.quark.cn/s/xxx?pwd=xxx

========================================
🌐 资料总站：https://doc.869hr.uk
📂 批次文件夹：2026-03-14_1700_短裤哥批次
📊 共 1 项资源

使用方式：

1. 脚本运行完成后，复制消息内容
2. 打开夸克 APP → 群组（2122364648、2026346189）
3. 粘贴发送

Telegram 通知机制

频道通知（@dabaziyuan）

• 每条资源单独发送
• 包含：资源名称 + GitHub 链接
• 由 GitHub Workflow 自动触发

群组通知（tgmShare 话题5、tgmShareAI 话题2）

• 批量更新只发一条汇总消息
• 包含：已更新仓库列表 + 资源数量 + 频道链接
• 由 Skills 脚本统一发送，避免刷屏

夸克群组消息 🆕

• 手动复制发送（夸克无公开 API）
• 群号：2122364648、2026346189
• 格式：资源名称 + 链接 + 资料总站
• 自动生成并保存到 quark_group_message.txt

脚本说明

scripts/quark_batch_run.py

夸克批量转存 + 生成分享链接。

python scripts/quark_batch_run.py \
  --label "短裤哥批次" \
  --month 202603 \
  --items-json items.json \
  --out-json batch_share_results.json

依赖：

• QuarkPanTool 环境（.venv）
• 夸克 Cookie（config/cookies.txt）

scripts/copy_promo_to_folders.py 🆕

复制推广文件到每个资源文件夹内部。

python scripts/copy_promo_to_folders.py \
  --batch-json batch_share_results.json

工作原理：

1. 读取 batch_share_results.json 中的 share_results
2. 对于每个分享结果，检查其 fid 是否是文件夹
3. 如果是文件夹，复制推广文件到文件夹内部

注意：推广文件会被复制到每个资源文件夹里面，这样每个分享的文件夹都包含推广文件。

scripts/quark_copy.py (已废弃)

此脚本已被 copy_promo_to_folders.py 替代。

scripts/mswnlz_publish.py

发布到 GitHub 仓库 + 发送 Telegram 群组通知。

python scripts/mswnlz_publish.py \
  --month 202603 \
  --batch-json batch_share_results.json

依赖：

• Git SSH 配置
• 可选：GITHUB_TOKEN 环境变量

scripts/trigger_site_rebuild.sh

触发站点重建。

bash scripts/trigger_site_rebuild.sh

依赖：

• Git SSH 配置
• mswnlz.github.io 仓库写权限

推广文件

模板文件夹位置

夸克网盘：temp/要共享的文件

文件清单

文件名	用途
必看免责声明_及加入资源分享群_及_副业_0_成本赚钱教程_资源网站doc_869hr_uk.txt	免责声明 + 联系方式 + 赚钱教程
1_解压密码869hr_uk_移动端双击这里.html	移动端解压密码获取页面
0_双击获取解压密码_Mac系统双击这里.webloc	Mac 快捷方式
0_双击获取解压密码_windows系统双击这里.url	Windows 快捷方式

本地备份

promo_files/ 目录保存了推广文件的本地备份，用于参考和恢复。

详细文档

完整配置、依赖安装、故障排除请参阅 README.md。