Webamp背后的Winamp皮肤博物馆:开源如何守护经典皮肤在线永生
Webamp背后的Winamp皮肤博物馆:开源如何守护经典皮肤在线永生
还记得 Winamp 那只甩臀的羊驼和满屏的酷炫皮肤吗?Webamp 开源项目不仅把 Winamp 2 完整重做到浏览器里,更打造了一座收录数万款皮肤的 Winamp 皮肤博物馆:自动截图、MD5 去重、社区审核、每日归档,让 20 多年前的经典皮肤在互联网上"永生"。本文带你快速看懂它背后的运转机制。
一、为什么需要一座"皮肤博物馆"
Winamp 的皮肤(.wsz)本质是一个 zip 压缩包:一张主贴图 + 若干位图,就能把播放器变成任何样子——动漫、游戏、复古 CRT……这些皮肤是互联网早期的"民间艺术"。Webamp 用 JavaScript 还原了 Winamp 2 的全部窗口,浏览器打开即可播放 MP3:
皮肤博物馆则更进一步:收集、索引并公开展示海量皮肤,支持无限滚动浏览、随机跳图和搜索。它已覆盖从 The Verge、PC Gamer 到 Gizmodo 的大量报道,见 skin-museum-press.md。
二、上传流水线:一款皮肤如何"入库"
新皮肤从上传到上架,走的是全自动流水线(见 README.md):
- MD5 去重:客户端算出文件 MD5,向服务端请求上传地址;已收录的皮肤直接跳过(UploadMutation.ts)
- 直传对象存储:文件绕过服务器直传 S3,流量高峰也不惧
- 异步处理:服务端按能力排队,下载、解包、抓取 readme 与元数据(processUserUploads.ts)
- 统一截图:用 Puppeteer 驱动 Webamp 为每款皮肤拍摄像素一致的预览图(screenshotSkin.ts)
所有皮肤、文件、截图记录都存于一套 SQLite 数据库,表结构与用途说明见 docs/database.md。
三、社区审核:质量与人情的平衡
皮肤上架后并非一了百了:博物馆维护一个 Discord 审核机器人,志愿者通过 /review 命令对皮肤做 APPROVED / REJECTED / NSFW 三类人工评审(DiscordEventHandler.ts、review.ts)。NSFW 皮肤会被打码并降权,低质量皮肤则被过滤——这是数万用户投稿下保持观感的关键。
四、在线永生:每日同步到 Internet Archive
"永生"不只是网站不关那么简单。博物馆每天把每款皮肤及其截图同步到 Internet Archive 做长期保存(syncToArchive.ts),并缓存档案元数据(internetArchive.ts)。即使某个服务下线,皮肤原件与预览图仍有独立副本可寻——这正是数字文物保护式的开源守护。
五、无限滚动的秘密:搜索与排序
- 搜索:由 Algolia 驱动,字段级增量更新让索引刷新又快又省(algolia.ts)
- 排序:主滚动流采用综合评分,并用编辑表手动置顶默认皮肤、隐藏近似重复款(museumOrder.sql、computeScrollRanking.ts)
- 推广:审核通过的经典皮肤还会自动分发到 Twitter、Bluesky、Mastodon 等平台(tweet.ts、bluesky.ts)
六、新手上手指南:三步参与博物馆
- 克隆仓库
git clone https://gitcode.com/gh_mirrors/we/webamp
- 体验核心:先看 Webamp 使用文档,再浏览博物馆前端代码 scroll 页面/scroll/page.tsx)
- 读懂数据模型:精读 SkinModel.ts 与 docs/database.md,即可摸清"皮肤 → 文件 → 截图 → 档案"的全链路
| 想做什么 | 看哪里 |
|---|---|
| 了解博物馆全貌 | README.md |
| 理解数据库表设计 | docs/database.md |
| 看上传 API | UploadMutation.ts |
| 看截图生成 | screenshotSkin.ts |
| 看长期归档 | syncToArchive.ts |
写在最后
Webamp 用一行行开源代码证明:怀旧不必依赖旧机器,守护也不必依赖大厂。从 MD5 去重到每日归档,这套朴素的工程把数万份个人记忆变成了公共数字遗产——下次你在博物馆里刷到 20 年前的皮肤时,不妨想想背后那些默默运转的任务队列。🦙


