光鸭云盘 秒传工具 (txt 解析)

📋 基本信息

项目	内容
脚本名称	光鸭云盘 秒传工具 (txt 解析)
版本	1.4.2
作者	opencode
更新日期	2026-08-14
适用平台	光鸭云盘 (guangyapan.com / gy.airp0.pw)
脚本类型	油猴脚本 (Tampermonkey / 暴力猴 / 脚本猫)

---

🎯 功能简介

这是一个为光鸭云盘设计的秒传工具，允许用户通过解析秒传文档（.txt/.json）来快速上传文件到云盘，无需实际传输文件内容。

核心功能

1. 秒传文档解析 - 自动扫描当前目录的秒传文档
2. 批量秒传 - 支持批量选择文件进行秒传
3. 实时状态显示 - 显示每个文件的秒传状态
4. 进度跟踪 - 显示整体进度和成功/失败统计

---

✨ 主要特性

1. 智能文档扫描

• 自动识别当前目录下的秒传文档
• 支持 .txt 和 .json 两种格式
• 文件名匹配规则：包含"秒传"、"flash"、"hash"等关键词

2. 用户友好的界面

• 右下角常驻悬浮按钮（⚡）
• 暗色主题弹窗界面
• 响应式设计，支持各种屏幕尺寸

3. 灵活的选择机制

• 支持全选/取消全选
• 单独勾选需要秒传的文件
• 实时显示已选文件数量

4. 实时状态反馈

• ⏳ 排队中
• 🔄 秒传中
• ✅ 秒传成功
• ❌ 秒传失败
• ⚠️ 错误

5. 并发控制

• 默认4个并发请求
• 避免触发服务器限流
• 自动重试机制

---

🔧 技术实现

秒传原理

秒传（Instant Upload）是一种基于文件哈希的上传技术：

1. 计算文件哈希 - 包括 MD5、GCID、CID
2. 比对服务器 - 检查服务器是否已有相同文件
3. 快速完成 - 如果匹配成功，直接建立文件引用，无需传输实际文件

API 调用流程

1. get_res_center_token → 获取上传凭证
2. check_can_flash_upload → 检查是否可以秒传
3. 成功 → 文件立即可用
   失败 → 需要实际上传文件

文件哈希说明

哈希类型	说明	用途
MD5	文件内容哈希	基础校验
GCID	光盘内容标识符	文件唯一标识
CID	内容标识符（3窗口SHA-1）	新版秒传必需

---

📖 使用方法

安装脚本

1. 安装 Tampermonkey 或其他用户脚本管理器
2. 点击安装本脚本
3. 刷新光鸭云盘页面

基本使用步骤

1. 进入云盘目录 - 导航到包含秒传文档的文件夹
2. 点击悬浮按钮 - 页面右下角的 ⚡ 按钮
3. 选择秒传文档 - 勾选要解析的秒传文档
4. 解析文档 - 点击"解析所选文档"按钮
5. 选择文件 - 勾选要秒传的文件
6. 开始秒传 - 点击"开始秒传"按钮
7. 等待完成 - 查看实时进度和状态

秒传文档格式

[
  {
    "name": "文件名.mkv",
    "size": 1234567890,
    "md5": "abc123...",
    "gcid": "DEF456...",
    "cid": "789ABC..."
  }
]

支持的文档格式

格式	说明
.txt	纯文本JSON数组（推荐）
.json	标准JSON格式

---

⚙️ 配置选项

并发数

默认并发数为4，可根据网络情况调整：

const CONCURRENCY = 4;  // 修改此值

文件名匹配规则

const FLASH_DOC_FILE_RE = /秒传|flash|hashes?/i;

支持的文件扩展名

const FLASH_DOC_EXTS = ['.json', '.txt'];

---

🔒 安全说明

权限说明

权限	用途
GM_xmlhttpRequest	跨域API请求
GM_addStyle	动态样式注入
@connect api.guangyapan.com	API通信
@connect h5.guangyapan.com	H5页面通信
@connect guangyacdn.com	CDN资源访问

数据安全

• 脚本不收集任何用户数据
• 所有API调用使用本地存储的凭证
• 不上传任何敏感信息到第三方服务器

---

🐛 常见问题

Q: 为什么秒传失败？

可能原因：

1. 秒传文档格式不正确
2. 文件哈希与服务器不匹配
3. 网络连接问题
4. 服务器限流

解决方法：

1. 检查秒传文档格式
2. 重新生成秒传文档
3. 等待一段时间后重试
4. 检查网络连接

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.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 (用于调试)

构建步骤

1. 克隆仓库
2. 修改脚本
3. 测试功能
4. 提交PR

---

📄 许可证

MIT License

---

🔗 相关链接

• 光鸭云盘
• Tampermonkey
• Greasy Fork

---

📞 联系方式

如有问题或建议，请通过以下方式联系： QQ 2223515969