光鸭云盘 秒传工具 (txt 解析)
📋 基本信息
| 项目 |
内容 |
| 脚本名称 |
光鸭云盘 秒传工具 (txt 解析) |
| 版本 |
1.9.15 |
| 作者 |
opencode |
| 更新日期 |
2026-08-22 |
| 适用平台 |
光鸭云盘 (guangyapan.com / gy.airp0.pw) |
| 脚本类型 |
油猴脚本 (Tampermonkey / 暴力猴 / 脚本猫) |
⭐ 快速测试（安装后第一步）
安装脚本后，用下面的四大名著秒传文档测试秒传工具是否正常：
测试资源：四大名著 2025 最新优酷 4K 超高清修复（秒传文档）
https://www.guangyapan.com/s/1938170348303835140_ad5KFI8EdLN_2Dyr
操作步骤：
- 转存/保存上面的分享链接到自己的云盘（内含 4 个剧的秒传文档）
- 进入你保存秒传文档的那个文件夹目录
- 看导航栏"云添加"按钮右侧——会出现高亮的 ⚡秒传 按钮（紫色呼吸动画）
- 点「秒传」→ 勾选秒传文档 → 点「解析所选文档」→ 勾选文件 → 点「开始秒传」
秒传成功即说明脚本安装配置正确。若按钮未出现，检查脚本猫的「允许使用用户脚本」开关是否已开启。
🎯 功能简介
这是一个为光鸭云盘设计的秒传工具，允许用户通过解析秒传文档（.txt）来快速上传文件到云盘，无需实际传输文件内容。
核心功能
- 秒传文档解析 - 自动扫描当前目录的秒传文档
- 批量秒传 - 支持批量选择文件进行秒传
- 实时状态显示 - 显示每个文件的秒传状态
- 进度跟踪 - 显示整体进度和成功/失败统计
- 智能检测 - 自动检测当前目录是否有秒传文档，有才显示按钮并高亮提示
- 一键复制接口凭证 - 复制完整凭证（access_token + refresh_token + did + smid），供 AI 直接调用光鸭 web API
- 秒传分享清单 - 没有秒传文档时，从弹窗内置的固定分享链接清单选一部，自动转存到当前目录再秒传
✨ 主要特性
1. 智能文档扫描
- 自动识别当前目录下的秒传文档
- 仅支持
.txt 格式
- 文件名匹配规则：以 "秒传.txt" 结尾（如
西游记86_4K优酷_秒传.txt）
- 智能显示：只有检测到当前目录有秒传文档时，按钮才会出现
2. 用户友好的界面
- 按钮位于导航栏"云添加"按钮右侧，与云盘原生按钮风格一致
- 高亮引导：检测到秒传文档时，按钮自动高亮（紫色脉冲动画）并显示红色 badge 标注数量，引导用户点击秒传
- 暗色主题弹窗界面
- 响应式设计，支持各种屏幕尺寸
3. 灵活的选择机制
- 支持全选/取消全选
- 单独勾选需要秒传的文件
- 实时显示已选文件数量
4. 实时状态反馈
- ⏳ 排队中
- 🔄 秒传中
- ✅ 秒传成功
- ❌ 秒传失败
- ⚠️ 错误
5. 并发控制
- 默认4个并发请求
- 避免触发服务器限流
- 自动重试机制
6. SPA 路由感知
- 自动监听目录切换，进入新目录立即重新检测
- 检测节流（3秒），避免频繁请求 API 触发限流
7. 一键复制接口凭证（给 AI 用）
- 导航栏「秒传」按钮之后的常驻按钮「🔑 复制接口凭证」，无需打开弹窗即可使用
- 一键复制完整凭证：
access_token + refresh_token + did + smid
- 复制内容格式：
{
"access_token": "eyJhbGci...",
"refresh_token": "gy.WU0...",
"did": "32位设备ID",
"smid": "数美指纹"
}
- 用途：AI 拿到凭证后即可按光鸭 API 文档（§2.2 公共请求头）直接调用 web API
（
authorization + did + smid + dt 四要素齐备）
- 自动检测缺失项，缺失时提示（如未登录/缺 did/smid）
🔧 技术实现
秒传原理
秒传（Instant Upload）是一种基于文件哈希的上传技术：
- 计算文件哈希 - 包括 MD5、GCID、CID
- 比对服务器 - 检查服务器是否已有相同文件
- 快速完成 - 如果匹配成功，直接建立文件引用，无需传输实际文件
API 调用流程
1. get_res_center_token → 获取上传凭证
2. check_can_flash_upload → 检查是否可以秒传
3. 成功 → 文件立即可用
失败 → 需要实际上传文件
文件哈希说明
| 哈希类型 |
说明 |
用途 |
| MD5 |
文件内容哈希 |
基础校验 |
| GCID |
光盘内容标识符 |
文件唯一标识 |
| CID |
内容标识符（3窗口SHA-1） |
新版秒传必需 |
📖 使用方法
安装脚本
- 安装 Tampermonkey 或其他用户脚本管理器
- 点击安装本脚本
- 刷新光鸭云盘页面
基本使用步骤
- 进入云盘目录 - 导航到包含秒传文档的文件夹
- 等待检测 - 脚本自动检测当前目录（约1-3秒），若存在秒传文档，导航栏"云添加"按钮右侧会出现高亮的"秒传"按钮
- 点击秒传按钮 - 点击导航栏右侧的"秒传"按钮
- 选择秒传文档 - 勾选要解析的秒传文档
- 解析文档 - 点击"解析所选文档"按钮
- 选择文件 - 勾选要秒传的文件
- 开始秒传 - 点击"开始秒传"按钮
- 等待完成 - 查看实时进度和状态
提示：若当前目录没有秒传文档，"秒传"按钮会隐藏，避免误点击。
给 AI 复制接口凭证
导航栏「秒传」按钮后面有常驻的 「🔑 复制接口凭证」 按钮，点击即复制完整凭证
（access_token / refresh_token / did / smid），可直接粘贴给 AI 调用光鸭 web API。
秒传文档格式
[
{
"name": "文件名.mkv",
"size": 1234567890,
"md5": "abc123...",
"gcid": "DEF456...",
"cid": "789ABC..."
}
]
支持的文档格式
| 格式 |
说明 |
.txt |
纯文本JSON数组（唯一支持，文件名需以"秒传.txt"结尾） |
⚙️ 配置选项
并发数
默认并发数为4，可根据网络情况调整：
const CONCURRENCY = 4; // 修改此值
文件名匹配规则
const FLASH_DOC_FILE_RE = /秒传\.txt$/i;
支持的文件扩展名
const FLASH_DOC_EXTS = ['.txt'];
🔒 安全说明
权限说明
| 权限 |
用途 |
GM_xmlhttpRequest |
跨域API请求 |
GM_addStyle |
动态样式注入 |
@connect api.guangyapan.com |
API通信 |
@connect h5.guangyapan.com |
H5页面通信 |
@connect guangyacdn.com |
CDN资源访问 |
数据安全
- 脚本不收集任何用户数据
- 所有API调用使用本地存储的凭证
- 不上传任何敏感信息到第三方服务器
🐛 常见问题
Q: 为什么秒传失败？
可能原因：
- 秒传文档格式不正确
- 文件哈希与服务器不匹配
- 网络连接问题
- 服务器限流
解决方法：
- 检查秒传文档格式
- 重新生成秒传文档
- 等待一段时间后重试
- 检查网络连接
Q: 如何获取秒传文档？
可以使用以下工具生成秒传文档：
gy-flash.exe - 光鸭云盘CLI工具- 其他支持光鸭云盘的工具
Q: 支持哪些文件类型？
支持所有类型的文件，包括但不限于：
- 视频文件 (.mp4, .mkv, .avi)
- 音频文件 (.mp3, .flac, .wav)
- 图片文件 (.jpg, .png, .gif)
- 文档文件 (.pdf, .doc, .txt)
- 压缩文件 (.zip, .rar, .7z)
Q: 秒传有文件大小限制吗？
理论上没有限制，但建议：
- 小文件（<100MB）：直接上传可能更快
- 大文件（>1GB）：秒传优势明显
📝 更新日志
v1.9.15 (2026-08-23)
v1.9.14 (2026-08-23)
- 小圆点按钮和云朵提示词一起左移，保持对齐（避开刷新按钮）
v1.9.13 (2026-08-23)
v1.9.12 (2026-08-23)
v1.9.11 (2026-08-23)
- 小圆点上方显示云朵提示词（常驻）：云朵形状气泡含「点击获取秒传文档」+「从分享清单选一部转存」，带浮动动画
- 替换原手指动画
v1.9.10 (2026-08-23)
- 小圆点 hover 加多行气泡提示：「点击获取秒传文档分享链接」+ 副说明，深色圆角气泡带箭头
v1.9.9 (2026-08-23)
- 「获取秒传文档」改为悬浮小圆点：位于文件列表表头「类型」列上方角落，带紫色光晕 + 👆 手指点按引导
- 导航栏不再显示该按钮（完全移到类型列上方）
v1.9.8 (2026-08-23)
- 「获取秒传文档」按钮加 👆 手指引导动画：手指在按钮上方持续做「点按」动作，提示用户点击
v1.9.7 (2026-08-23)
- 重新设计「获取秒传文档」常驻按钮：两行（主文字+副文字），「点这里 ➜」持续弹跳动画
v1.9.6 (2026-08-23)
- 每个分享固定 2 行：第 1 行名称+转存按钮，第 2 行简述
- 详细信息（children 子项）点「查看详情」才展开
v1.9.5 (2026-08-23)
- 搜索改为服务端实现：脚本请求
GET /sharelist?q=关键词，服务端在 Redis 数据里过滤（name/desc/children）
- 展开全部最多展示 5 条（默认 2 条）
- 配套：
gy-sharelist-server 新增 ?q= 搜索参数
v1.9.4 (2026-08-23)
- 修复「展开全部」只显示 2 个：
__all__ 状态也显示全部清单
v1.9.3 (2026-08-23)
- 点「转存分享」后弹窗立即关闭
- 填入云添加输入框改用原生 value setter（React/Vue 兼容），修复聚焦后链接消失
v1.9.2 (2026-08-23)
- 转存分享：不做目录校验，只把分享链接填入页面「云添加」的添加链接输入框
- 目标目录由云添加自己选择（云添加已内置选目录功能），不再自动点确认
v1.9.1 (2026-08-23)
- 打开分享弹窗不再要求先进入文件夹（看清单不需要目录）
- 点「转存分享」时才检查目标目录，并提示当前目录状态
v1.9.0 (2026-08-23)
- 「获取秒传文档分享链接」改为独立弹窗（不再嵌入秒传弹窗）
- 秒传弹窗恢复纯净：只做扫描秒传文档 → 解析 → 秒传
- 独立弹窗功能：搜索分享清单（默认展示前2个+展开全部）→ 点「转存分享」→ 自动填入页面云添加转存
v1.8.5 (2026-08-23)
- 分享清单默认只展示前 2 个，支持「展开全部」
- 新增搜索框，按剧名/子项/描述过滤
- 每条分享带「转存分享」按钮：点击把链接填入页面「云添加」，由页面完成转存
v1.8.4 (2026-08-23)
- 「获取秒传文档分享链接」改为导航栏常驻按钮（位于秒传按钮前面），带紫色呼吸光晕动画
- 点击直接打开秒传弹窗并自动展开分享面板
v1.8.3 (2026-08-23)
- 弹窗按钮文案改为「📚 获取秒传文档分享链接」（修复残留的 undefined 变量）
v1.8.2 (2026-08-23)
- 秒传分享清单 URL 指向线上服务：
http://ali.ismewen.com:16666/sharelist
- 服务已部署到阿里云（Redis 同机），清单数据存 Redis
guangya:share_list
v1.8.1 (2026-08-23)
- 分享清单支持
desc（说明）和 children（合集子项）展示
- sharelist.json 填入 4 个分享：豆瓣精选360部/四大名著/权力的游戏/甄嬛传
v1.8.0 (2026-08-23)
- 秒传分享清单改为从 HTTP 服务拉取（不再硬编码到脚本）
- 点选清单某剧 → 自动打开页面「云添加」填入分享链接，由页面原生转存（脚本不自己调转存接口）
- 清单地址在脚本顶部
FLASH_SHARE_LIST_URL 配置
- 配套：
poster/gy-sharelist-server/ 提供清单 HTTP 服务（GET /sharelist 返回 JSON 数组）
v1.7.7 (2026-08-23)
- 新增「📚 秒传分享清单」：弹窗内固定分享链接清单，没有秒传文档时点选一部 → 自动转存到当前目录 → 继续秒传
- 清单在脚本顶部
FLASH_SHARE_LIST 常量维护（剧名 + 分享链接）
v1.7.6 (2026-08-23)
- listFolder 改为按修改时间排序（orderBy:3，最新在前），与光鸭 UI 默认一致
- 刚上传的秒传文档必然排最前，第一页即命中；分页仍作兜底
v1.7.5 (2026-08-23)
- 修复大目录（>200 文件）检测不到秒传文档：listFolder 改为分页遍历所有页
- 解决「豆瓣精选 360 部电影」这类超 200 文件的目录不显示秒传按钮的问题
v1.7.4 (2026-08-22)
- 复制凭证按钮 hover 提示改为自定义气泡 tooltip（深色圆角+箭头），悬停立即显示无延迟
v1.7.3 (2026-08-22)
- 复制接口凭证按钮从弹窗内改为导航栏常驻按钮（位于「秒传」按钮之后），无需打开弹窗即可一键复制
- 按钮样式适配导航栏（浅色白底风格，与「秒传」按钮一致）
v1.7.2 (2026-08-22)
- 修复复制凭证按钮 tooltip 显示不完整：气泡改为右对齐定位，不再被弹窗边缘裁剪
v1.7.1 (2026-08-22)
- 优化「复制接口凭证到AI」按钮：渐变胶囊样式 + 悬浮上浮光效 + 成功/失败变色反馈
- 原生 title 提示改为自定义 CSS 气泡 tooltip（更美观）
v1.7.0 (2026-08-22)
- 新增「📋 复制接口凭证到AI」按钮
- 一键复制完整凭证：access_token + refresh_token + did + smid
- AI 拿到凭证即可直接调用光鸭 web API（含设备指纹四要素）
- 自动检测缺失凭证项并提示
v1.6.2 (2026-08-22)
- 秒传按钮判断放宽为文件名以"秒传.txt"结尾即可，不再要求下划线
v1.6.1 (2026-08-22)
- 秒传按钮仅对以"_秒传.txt"结尾的文档显示
- 排除 .json 与其它 .txt 文档（如"秒传工具使用说明.txt"不再触发）
v1.6.0 (2026-08-22)
- 秒传按钮自动检测当前目录是否有秒传文档
- 有秒传文档才显示按钮，并高亮（紫色脉冲动画）+ 红色 badge 标注数量
- 切换目录自动重新检测（节流3秒，避免频繁API）
- 无秒传文档时按钮隐藏
v1.5.0 (2026-08-22)
- 按钮从右下角悬浮改为导航栏"云添加"按钮右侧
- 按钮样式与云盘原生 ant-btn 风格一致
- SPA 路由切换自动重挂载按钮
v1.4.2 (2026-08-14)
- 修复CDN域名兼容性问题
- 简化@connect配置
- 使用guangyacdn.com覆盖所有子域名
v1.4.1 (2026-08-13)
v1.4.0 (2026-08-12)
v1.3.0 (2026-08-10)
- 支持.txt格式秒传文档
- 新增文件名匹配规则
- 优化性能
v1.2.0 (2026-08-08)
v1.1.0 (2026-08-06)
v1.0.0 (2026-08-04)
🤝 贡献
欢迎提交Issue和Pull Request来改进这个脚本。
开发环境
- Node.js (用于测试)
- Tampermonkey (用于调试)
构建步骤
- 克隆仓库
- 修改脚本
- 测试功能
- 提交PR
📄 许可证
MIT License
🔗 相关链接
🛠️ 配套上传工具（guangya-upload）
秒传文档生成后，在无凭证环境下也能用官方上传工具把文件/秒传文档传到云盘。
- 工具分享链接：
https://www.guangyapan.com/s/1938182178082459660_ad5KFI8EdLN_2Dyr
- 文件名：
guangya-upload-nocred-multiplatform.tar.gz（约 13 MB）
- 内含 5 个平台预编译二进制（windows / linux / macos × arm64/amd64）+
credentials.json 样例 + README
- 凭证要求：只需
access_token + refresh_token（来自浏览器 localStorage / 本脚本「复制接口凭证到AI」按钮），内部只用 Authorization + dt:11，不需要 did/smid
- 适用场景：手机端 / 其他设备 / 想脱离浏览器直接上传时
📞 联系方式
如有问题或建议，请通过以下方式联系：
