12 · 方法论
murRipple 收官:把一首歌织成看得见的涟漪
项目做完了。留下两份材料:一份给想看懂它的人,一份给想用它的人。
知漪(murRipple)做的事一句话能说完:给它一个 mp3 和一份歌词,它交出一个零依赖的单文件网页和一段同样内容的视频,歌被拆成声部,每个声部在屏幕上荡出自己的涟漪。这个项目现在做完了,这篇是收官记录。
做完不是搁下。它有能跑通的全链路,有把「浏览器里看到的就是视频里出来的」变成一条会自己跑的检查的门禁,也有明说做不到什么的边界。这些都写进了两份材料里,两份都是中文。
两份材料,各给一种读者
技术拆解 写给想知道它怎么被做出来的人:架构怎么分层,渲染为什么是时间的确定性函数,检查怎么一条条立起来,以及一路踩过的坑——连坑带修法一起列出来。
产品介绍 写给想用它的人,只回答四个问题:它把什么变成什么,你能拿它干什么,从哪开始,它做不到什么。第四个问题有自己完整的一节,不是脚注。
哪一份都不需要先读另一份。
三个入口
- 产品页:murripple.miao-yu.com
- 公开仓:github.com/ymustc/murRipple-public
- 在线演示:ymustc.github.io/murripple-demo
材料里沿用我一贯的规矩:不写没出处的数字。它是什么、做到了哪一步,以能点开、能复算的东西为准。