企业官网建设流程全解析

cloud-uploader 版本演进史：更新日志全盘点与未来路线图展望

【免费下载链接】cloud-uploader网易云音乐MAC云盘上传工具项目地址: https://gitcode.com/gh_mirrors/cl/cloud-uploader

cloud-uploader 是一款专为 macOS 打造的网易云音乐MAC云盘上传工具，它用 Electron 解决了 Mac 版网易云音乐没有"上传音乐到云盘"功能的痛点，还内置了每日自动签到、自动刷歌 300 首等实用能力。本文将从最初的 1.0.0 一路梳理到 1.3.5，完整盘点每一版更新日志，并展望这个网易云音乐上传工具的未来路线图，帮你快速看懂它的成长脉络。

cloud-uploader 是什么：诞生背景与核心定位

Mac 用户长期面临一个尴尬：Windows 端网易云音乐可以轻松把本地歌曲传上云盘，而 MAC 版本却始终没有这个功能。作者出于自用需求，用 Electron 写了 cloud-uploader 并开源分享，随后不断根据社区反馈迭代，最终成长为集云盘上传、自动签到、自动刷歌于一体的全能小工具，还贴心地祝你"早日成为 10 级大佬"。

cloud-uploader 版本演进时间线：从 1.0.0 到 1.3.5 的完整更新日志

项目共发布了 13 个正式版本（含 2 个 debug 版），演进脉络清晰，大致可分为三个阶段。

第一阶段：起步期——解决"能上传"的问题

早期版本围绕最核心的上传功能打转，更新日志密集且实用：

批量上传和随机间隔的设计，在 src/common/const.js 中演化为UPLOADER_UPLOAD_INTERVAL_TIME的 Min/Max 随机区间，用"每次请求间隔 1~3 秒随机"的方式有效规避了接口频率限制。

第二阶段：爆发期——功能最丰富的更新日志

这一阶段更新日志条目最密集，几乎每周都有新功能上线：

• 5/22：新增退出登录、每日自动签到、自动刷歌 300 首。开发者没有引入笨重的第三方定时库，而是每次窗口激活时检查配置与完成状态，思路非常轻巧
• 6/4：新增账号密码登录（手机号 + 邮箱），所有密码在调用登录接口前统一 MD5 加密，但仍建议优先使用二维码登录
• 7.17：修复若干崩溃问题与歌曲列表覆盖问题
• 7.23：新增代理功能（暂未提供前端界面，可在const.js中配置PROXY_ADDRESS），并整理代码
• 8.10：新增全局快捷键command + Q（退出）、command + H（隐藏）

自动刷歌的实现位于 src/windows/controller/listen.js：拉取每日推荐歌单后逐首上报播放反馈，最多听 350 首（留出 50 首冗余应对已听歌曲），出现接口繁忙时自动休息 5 秒重试，完成后通过事件通知前端。

第三阶段：稳定期——修复与打磨

进入稳定期后，更新日志转向修 bug、升级依赖与适配：

• 修复刷歌中激活窗口导致重复刷歌的问题、强制退出导致刷歌状态异常
• 修复 Apple 芯片（M1）Mac 第一次登录无法上传的 bug，这是社区反馈最多的痛点
• 修复密码登录问题、列表撑满屏幕导致上传区域无法滚动的问题
• Electron 依赖从 18.x 一路升级到 24.x，NeteaseCloudMusicApi 从 4.5 升级到 4.10
• 增加 Linux 打包命令（deb 格式），覆盖更广的用户群体

重要里程碑：B/S 网页版上传

2023 年 4 月，项目迎来重要更新——推出 B/S 程序：直接通过浏览器访问即可上传，无需下载软件，旨在帮助软件无法正常运行的 Mac 用户。同年 6 月，B/S 项目整理完成并独立放出，同时修复了登录状态异常问题。不过受服务器资源所限，该在线服务目前已到期暂停，作者表示正在准备恢复，软件端依然是主力上传方式。

核心功能模块与对应源码位置

想深入了解实现，可以直接从这些关键文件入手：

• 主进程入口与窗口调度：src/main.js，负责登录/上传窗口切换、签到与刷歌模块的初始化
• 上传核心逻辑：src/windows/controller/uploader.js，支持文件选择、拖拽、粘贴路径三种方式，上传完成会弹系统通知统计成功数
• 自动刷歌模块：src/windows/controller/listen.js
• 常量与策略配置：src/common/const.js，包括刷歌上限、休息时间、上传间隔等
• 配置读写：src/common/config.js
• 构建脚本与版本号：package.json，当前最新版本为1.3.5

更新日志背后的已知问题与作者回应

客观来说，项目也有遗憾。更新日志与 README 中明确记录了 M1 芯片 Mac 长时间等待无法上传的问题（社区多人反馈，并非 100% 复现），作者因缺少测试环境一直未能根治，这也是 B/S 版诞生的直接原因之一。这种"直面问题、给出替代方案"的态度，值得点赞。

cloud-uploader 未来路线图展望

基于更新日志与代码中的注释线索，可以合理推测以下演进方向：

• M1/Apple 芯片深度适配：修复首次登录无法上传的遗留问题，提升稳定性
• 代理配置可视化：代码中代理功能已实现，但"目前没提供前端"，作者明确说过"后续如果有必要会加到前端配置"
• 歌曲匹配纠错：上传模块中保留着cloud_match纠错接口的注释代码，随时可能启用
• B/S 服务恢复：服务器到期暂停后，作者正在准备恢复在线上传服务
• 更丰富的音频格式支持：从 mp3 到 wav、ape 的扩展路径已经跑通

如何获取与参与

想自己构建体验，可以克隆仓库并运行：

git clone https://gitcode.com/gh_mirrors/cl/cloud-uploader cd cloud-uploader npm install npm run start # 启动调试 npm run pkg_mac # 构建 macOS dmg npm run pkg_linux # 构建 Linux deb

总结一下：从 1.0.0 到 1.3.5，cloud-uploader 用一份份扎实的更新日志完成了从"能上传"到"好用到顺手"的蜕变。对于普通用户，直接下载最新版即可享受全部功能；对于开发者，这份更新日志本身就是学习 Electron 桌面工具演进的绝佳案例。期待它的下一个版本，也期待 M1 问题被彻底解决的那一天。

【免费下载链接】cloud-uploader网易云音乐MAC云盘上传工具项目地址: https://gitcode.com/gh_mirrors/cl/cloud-uploader