Chaoxing Pan Download

超星网盘文件下载（Chaoxing Pan Download）

把超星网盘的「在线预览链接」转换成「真实下载」，核心是抓出页面里埋的直链并带上防盗链 Referer 头。

链接从哪来（先搞清楚输入是什么）

那种 pan-yz.chaoxing.com/screen/v2/file_xxx 预览链接不是手工拼出来的，它是课程页面里一个隐藏 iframe 的 src。完整来源链路：

泛雅/学习通课程页（浏览器登录后打开）
  https://mooc2-ans.chaoxing.com/mooc2-ans-vue/fanyav3/stu?courseId=...&clazzId=...&cpi=...&enc=...&t=...&v=6&ut=s
      │  左侧「资料」列表里点开一个 PPT / Word / PDF
      ▼
弹出预览窗，里面嵌了一个 iframe：
  <iframe id="panView" ... src="https://pan-yz.chaoxing.com/screen/v2/file_{objectId}?ext=...&appid=...&nonce=...&timestamp=...&signature=...">
      │  这个 iframe 的 src 就是「预览链接」
      ▼
本 skill 处理 → 真实下载直链 → 文件

怎么拿到这条预览链接（给用户 / 给 AI 的指引）：

1. 浏览器登录学习通/泛雅，打开课程页（mooc2-ans.chaoxing.com/mooc2-ans-vue/fanyav3/stu?...），左侧点「资料」。
2. 点开要下载的课件，等预览弹出。
3. 按 F12 打开开发者工具，点左上角的选取按钮（箭头图标，快捷键 Ctrl+Shift+C），再直接点预览窗里的课件画面 —— 元素面板会自动定位到那个 <iframe id="panView">。
4. 在这个 <iframe> 上复制 src 属性值 —— 这就是要交给本 skill 的「预览链接」。

备用方式：在 Elements（元素） 面板 Ctrl+F 搜 panView；或在 Network（网络） 面板筛选 screen/v2，同样能拿到这条链接。

怎么判断链接对不对： 预览链接的 ext 参数里有个 _from_ 字段（形如 {"_from_":"<courseId>_<clazzId>_<数字>_<hash>"}），前两段数字就是来源课程的 courseId 和 clazzId，能和课程页 URL 里的 courseId=、clazzId= 对上。对不上，说明链接不是从这门课来的。

⚠️ 课程页链接（mooc2-ans.chaoxing.com/...）本身不能直接下载，也不能交给本 skill 处理——它需要登录态。真正的输入必须是 pan-yz.chaoxing.com/screen/v2/file_... 这条预览链接。

输入契约（重要）

• 本 skill 只接受 pan-yz.chaoxing.com/screen/v2/file_... 形式的预览链接（或与之等价的 pan.chaoxing.com / cldisk.com 直链）。
• 该预览链接需要登录后才能生成，AI 无法自行获取：
  • 若用户只给了课程页（mooc2-ans.chaoxing.com/...）、或说「下载我课程里的某文件」， 不要尝试登录、不要猜链接，而是引导用户按「链接从哪来」一节用 F12 取出预览链接。
• 拿到预览链接后，下载流程可全自动完成，无需用户再操作。

何时使用

• 用户粘贴一个 pan-yz.chaoxing.com/screen/v2/file_xxxx 或 pan.chaoxing.com 链接，想下载其中的文件
• 用户问「超星网盘的文件怎么下载」「学习通里的 PPT/文档怎么保存下来」
• 链接域名含 chaoxing.com 或 cldisk.com
• 用户在课程/资料里点开文件后，从预览窗 iframe（id="panView"）里复制出来的 screen/v2 链接

关键原理（已验证）

1. 预览链接本身不是下载地址，它返回一个 HTML 预览页（<title>文档</title>），把文件每页渲染成缩略图。
2. 预览页 HTML 里内嵌一个 JS 对象 fileinfo，其中 'download' 字段才是真实直链：

   'download': 'https://d0.cldisk.com/download/{objectId}?at_={时间戳ms}&ak_={签名}&ad_={签名}&fn={urlencoded文件名}'
   

3. 直链里的 at_ / ak_ / ad_ 是时效性签名，几分钟后失效，必须用最新抓到的。
4. 直链下载必须带 Referer: https://pan-yz.chaoxing.com/（防盗链），否则返回 403 Forbidden / Invalid Request。
5. 用 HEAD 请求预览页会 405，要用 GET。

工作流

第 1 步：GET 抓取预览页

curl -sS -L -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0 Safari/537.36" \
  "<预览链接>" -o /tmp/cx_preview.html

注意：不能加 -I/HEAD，会 405。

第 2 步：提取真实直链

grep -oE "'download':[[:space:]]*'https?://[^']+'" /tmp/cx_preview.html

或直接在预览页里搜 cldisk.com/download。文件名可从以下任一来源取：

• 直链里的 fn= 参数（URL 编码）
• 页面里的 <input type="hidden" id="fileInfoNameInput" value="文件名">
• 下载响应头 Content-Disposition

第 3 步：带 Referer 头下载

curl -sS -L -A "Mozilla/5.0 ... Chrome/120.0 Safari/537.36" \
  -e "https://pan-yz.chaoxing.com/" \
  "<直链>" -o "文件名.pptx"

-e 即 Referer，缺了必 403。也可用 -OJ 让 curl 按 Content-Disposition 自动命名。

一键脚本

skill 目录下自带 chaoxing-download.sh：

bash <skill目录>/chaoxing-download.sh "<预览链接>"

补充：给不装命令行的用户（浏览器控制台）

直链不能粘到地址栏（无 Referer → 403）。正确做法是在预览页里触发：

1. 单独用标签页打开预览链接。
2. F12 → Console，执行 location.href = fileinfo.download（fileinfo 是预览页的全局变量）。
3. 若 fileinfo 未定义：先在源码里搜出 d0.cldisk.com/download/... 直链，再在同一预览页控制台执行 location.href = '<直链>'。

原理：这样发起的请求会带上预览页 URL 作为 Referer，正好通过防盗链。

常见问题排查

相关端点备忘

• 预览页：https://pan-yz.chaoxing.com/screen/v2/file_{objectId}?...
• 直链：https://d0.cldisk.com/download/{objectId}?at_=&ak_=&ad_=&fn=（d0 可能为 d1 等）
• 缩略图：https://s3.cldisk.com/sv-w9/doc/{a}/{b}/{c}/{objectId}/thumb/{n}.png（多页文档逐页）
• WPS 在线预览（非下载）：页面里 switchPreviewMode() 跳转的 preview/v2/objectshowpreview.html?objectid=...&puid=...&enc=...&wps=...

注意事项

• 只下载用户有合法访问权限（拿到分享/预览链接）的文件，不绕过登录、不破解 DRM，尊重版权。
• 签名直链时效短，拿到的 URL 不要长期保存复用。
• 若文件需要登录态（p_auth_token 非空、页面无 download 字段），本方法不适用，需用户在浏览器登录后用 F12 抓带 Cookie 的请求。