别只做网页版:给 vibe 项目加一个浏览器扩展实战
装了扩展,用户在别的网站上点一下就能保存、被轻轻提醒、一直开着小窗口——但前提是扩展真替主站多干了一件事。三种形态、最小权限、登录与同步、发版纪律,附虚构漏斗 1000→420→210→126→63。

先把一句话说在前面:这篇不讲怎么把扩展传上商店。站内 10 月已有一篇《从 zip 包到商店页:浏览器扩展上架的 7 道坎》,讲的是商店审核、隐私政策和被拒急救,那篇负责“怎么上架”;本篇讲的是另一半——扩展做进产品里之后,到底替你的主站多干哪一件事、三种形态怎么选、权限怎么收、数据怎么跟主站对得上。本文用一个贯穿始终的虚构示例讲透这件事:示例产品是“随手存”,一款把网上看到的好文章存下来、以后慢慢读的工具;示例用户叫“阿南”,示例里的数字、对话和场景全部是虚构的演练,用来把道理讲具体,不是真实产品和真实事件。最后一节的漏斗数字也是虚构样本,用来算账,不是真实数据。
先想清楚:扩展到底替主站多干哪一件事
很多人做扩展的顺序是反的:先去看扩展开发文档,照着教程搭一个弹窗,再回头想这个弹窗能干什么。结果往往是做出来一个“网页版的缩小复刻”——弹窗里塞一个登录框、一个列表、一个搜索框,用户在网页上明明都能做,装扩展只是多了一个入口。这种扩展没有存在的理由,用户装完三天就忘了它,更不会向别人推荐。
扩展的价值只来自一件事:它住在浏览器里,而你的网页住在某一个标签页里。浏览器里能做的事,网页做不了,或者做起来很别扭。想明白这一点,选题就只剩三类。第一类是“随手”:用户正在别的网站上读文章、看商品、刷帖子,不想先打开你的网站、再复制链接、再粘贴保存,他只想点一下、或者划一段文字,东西就存进来了。第二类是“顺手提醒”:用户在某个页面上,你的扩展能认出来“这个页面和你的产品有关”,轻轻提示一句,比如这件商品降价了、这篇文章你已经存过、这个页面有待办事项。第三类是“常驻”:你的产品需要一个一直开着的小窗口,比如计时、待办、剪贴板,用户不想为它单独留一个标签页。
“随手存”的例子很典型。阿南在网上看到一篇长文,想以后再读。没有扩展的时候,他的动作是:复制链接,打开“随手存”的网站,登录,粘贴,点保存,一共五步,中间任何一步被打断,这篇文章就丢了。有了扩展,他的动作变成:点一下工具栏图标,点“保存”,完事。两步和五步的差别,听起来不大,但对“随手”这件事来说,就是“会用”和“不用”的差别。很多用户不是不需要你的产品,而是你的产品离他正在做的事情太远了,远到他懒得过去。
所以动手写代码之前,先写一句话:“装了扩展之后,用户在别的网站上能多做哪一件现在做不了、或者做起来很费劲的事?”这句话写不出来,就不要做扩展。把网页版做好,比多一个没人用的扩展有用得多。这句话如果能写出来,后面的所有决定——形态、权限、同步方式——都有了判断标准:凡是让这件事更顺的,就做;凡是跟这件事无关的,哪怕看起来很酷,都先砍掉。
三种形态,别一上来就全做
浏览器扩展常见的形态有三种:工具栏弹窗、页面里注入的小部件、侧边栏。三种形态解决的是不同的问题,成本也差很多,新手最容易犯的错误,就是三种都想要,最后三种都做得半吊子。
工具栏弹窗是最常见的形态:点一下工具栏图标,弹出来一个小窗口,用户在里面点保存、看列表、改设置。它的优点是简单、独立、不打扰用户正在看的页面;缺点是窗口一关就没了,不适合需要长时间盯着看的东西。弹窗最适合“随手”类的动作:保存、收藏、快速记一笔。阿南的“随手存”就是弹窗形态:点图标,看到当前页面的标题和摘要,点保存,弹窗自动关掉,整个过程不超过三秒。
页面注入是第二种形态:扩展在用户打开的网页里加一个小按钮、一个浮层、或者给某些元素描个边。它离用户正在做的事情最近,体验也最顺;但它也最容易惹麻烦:网页的样式千奇百怪,你的小部件可能被页面的样式顶掉、被广告遮住,或者跟页面自己的按钮撞在一起。更要紧的是,用户会觉得“你在我的页面里动了手脚”,信任成本最高。页面注入只适合一件事:你的产品确实需要对当前页面“动手”,比如划词翻译、高亮、比价、去广告。只在页面上加一个“保存”按钮,算不算动手?算,但这个动作也可以放在弹窗里完成,那就别注入。
侧边栏是第三种形态:浏览器侧边打开一个常驻面板,跟当前页面并排显示。它的优点是能一直开着,用户一边看网页、一边在侧边栏里操作;缺点是只有新版浏览器才支持得比较好,老用户可能找不到入口,而且侧边栏一开,页面就被挤窄了。侧边栏适合“常驻”类的场景:待办清单、笔记、边读边记。阿南如果只是想“随手保存”,侧边栏就是多余的;但如果“随手存”以后要做“边读边划重点”,侧边栏就成了主形态。
选形态的办法很土,但管用:把你那句话里的核心动作写下来,问自己,这个动作发生的时候,用户正在干什么?如果用户正在别的网站上读东西,动作要快、要轻,选弹窗。如果动作必须贴着当前页面的内容做,选页面注入。如果动作要持续十几分钟、跟页面来回对照,选侧边栏。三种形态都想要的时候,先做最能代表核心动作的那一种,上线、看数据、再决定要不要加第二种。扩展的第一个版本越小越好,小到你能在两周内做完、发出去、收到真实反馈。
权限:只拿够用的,晚拿比早拿好
扩展最容易丢分的地方,就是权限。用户在商店页上看到“读取和更改你在所有网站上的数据”这种提示,第一反应不是“这个扩展好强大”,而是“它想干什么”。很多扩展被用户卸载、被商店下架、被媒体点名,根子都在权限上:要得太多、要得太早、要了不用。
先说“只拿够用的”。浏览器的权限是按需申请的,你能只读当前标签页,就不要申请所有网站;你能用主动点击触发,就不要申请后台常驻;你能只在用户点的那一下读页面标题,就不要申请读整个页面内容。拿“随手存”打比方:保存当前页面,只需要知道当前标签页的标题和地址,一个 activeTab 权限就够了,完全不需要“读取所有网站数据”。划词保存才需要读选中文字,自动识别“这篇文章你存过”才需要读页面地址做比对。每一项权限,都要能在商店页的描述里用一句话向用户交代清楚:“我们要这个权限,是为了做这件事。”交代不清楚的权限,就是多余的权限。
再说“晚拿比早拿好”。用户刚装上扩展,你对他来说还是个陌生人,这时候弹出来要一堆权限,他大概率点拒绝,或者直接卸载。更好的做法是:安装的时候一个权限都不要多要,先让用户用起来,等他真正用到需要权限的那个功能时,再当场申请,顺便告诉他为什么需要。比如阿南第一次点“保存”的时候,扩展才申请读取当前标签页的权限,提示写的是“需要读取当前页面的标题和地址,才能帮你保存”。这时候用户已经知道自己要干什么,拒绝的概率就低得多。道理很简单:权限申请不是安装流程的一部分,而是功能的一部分,哪个功能需要,就在哪个功能里申请。
还有一条容易被忽略的规矩:权限说明要写人话,不要抄文档。商店页上的隐私说明、权限解释,是用户决定装不装你的扩展时真正会看的东西。写“本扩展会将您访问的页面地址发送到我们的服务器用于同步”,比写“本扩展需要 host 权限”有用得多。前者让用户知道发生了什么,后者只是把技术名词复读了一遍。如果你自己都写不清楚某个权限是干什么用的,那就说明这个权限很可能不该要。
扩展和主站的数据,怎么对得上
扩展不是第二个产品,它是你主站的一个“分身”。用户在扩展里保存的东西,要能在网页版里看到;他在网页版里删掉的东西,扩展里也不能还留着。数据对不上的扩展,比没有扩展更糟:用户会怀疑到底哪一边是对的,最后两边都不敢信。
最常见的坑是登录态。用户在网页版上已经登录了,装完扩展,还要再登录一次,他会觉得“你们是不是两套系统”。正确的做法是:扩展和主站共用同一套登录凭证,扩展第一次打开的时候,先去问主站“我认不认识这个用户”,认识就直接用,不认识再请他登录一次。技术细节各家不同,但体验标准只有一条:用户在主站登过一次之后,扩展里不应该再出现登录框。
第二个坑是同步时机。用户在地铁上、飞机上、信号不好的地方点了保存,扩展不能因为当时没网就把这次保存丢了,也不能假装保存成功、其实什么都没存。正确的做法是:先把这次保存记在本地,告诉用户“已保存到本地,联网后同步”,等网络恢复再悄悄同步上去,同步完了把本地那条标记成已同步。用户不需要知道“本地队列”“冲突解决”这些词,他只需要知道一件事:我点的保存,没有一次是白点的。
第三个坑是冲突。用户在扩展里改了一个标题,同时在网页版里也改了同一个标题,两个版本不一样,听谁的?最简单的办法,是按时间说话:后改的赢,先改的进历史记录,用户随时能找回来。这条规则不完美,但它简单、可解释、出了问题能讲清楚。千万不要在第一个版本里就做复杂的合并逻辑:两个版本自动合并,听起来很聪明,实际上线之后,你会发现用户根本不知道合并后的是哪个版本,出了问题你也讲不清楚。先做到“不丢数据”,再谈“合并得漂亮”。
还有一个细节:扩展里的数据展示要“够用就好”。弹窗很小,塞不下网页版的全部功能,也不需要塞。阿南在弹窗里只需要做三件事:保存当前页面、看最近保存的五条、搜一下关键词。完整的列表、分类管理、批量操作,都回网页版去做。扩展弹窗是“顺手”的地方,不是“办公”的地方。把弹窗当成网页版的缩小复刻,是扩展最常见的死法。
更新与回滚:发版之后才是开始
扩展发出去之后,商店会替你管分发,但商店不会替你管“发坏了怎么办”。网页版发坏了,你可以立刻再发一个版本,用户刷新页面就好了;扩展发坏了,用户手里的旧版本不会立刻更新,新版本还要过商店审核,中间这段时间,你只能眼睁睁看着用户用坏版本。所以扩展的发版纪律,要比网页版严得多。
第一条纪律是:扩展里不要放“写死”的关键逻辑。判断“这个页面能不能保存”、提示文案、功能开关,这些东西最好从你的服务器上拉取,而不是写死在扩展代码里。这样万一某个网站改版导致你的扩展出错,你可以在服务器端关掉那个功能,不用等商店审核。开关的粒度越细越好:按网站、按功能、按版本,都能单独关。
第二条纪律是:新功能先给一小部分用户。扩展商店一般支持分阶段发布,先给百分之十的用户,观察一两天,没有大规模报错和卸载,再推给所有人。这一两天里你要盯的东西很具体:新版本的崩溃数、卸载数、有没有用户反馈“保存不了了”。数字一有异常,先停下来,别急着推给所有人。网页版可以“先发了再说”,扩展不行,扩展的回滚成本比网页版高得多。
第三条纪律是:写好更新说明,告诉用户这次变了什么。很多扩展的更新说明是空的,或者写着“修复了一些问题”。用户装了更新,打开扩展,发现界面变了、按钮挪了位置,他会以为出问题了。更新说明不用长,三句话就够:新加了什么、改了什么、修了什么。写更新说明的时候,顺便想一想:如果用户完全不看更新说明,他能不能自己发现新功能?如果发现不了,说明新功能的入口藏得太深了。
最后一条是给新手的提醒:商店下架不是世界末日,但是要当回事。扩展被下架,常见的原因就那么几个:权限说明不清、隐私政策缺失、描述与实际功能不符、被人举报。收到下架通知,先读通知里写的具体原因,按原因改,改完重新提交,不要换个名字重新上架一个一模一样的——那是商店最反感的做法,也是最容易被永久封号的做法。站内那篇上架指南里有一份被拒急救包,讲的就是这一段,本篇不再重复,遇到的时候照着那篇处理。
算一笔账:从商店页到每周都在用的漏斗
扩展做得好不好,不能只看安装数。安装数好看,但装完不用,等于白装。下面这组数字是虚构样本,讲的是“随手存”扩展第一个月的样子:1000 个人打开商店页,其中 420 个人点安装,装完之后 210 个人授权并登录,登录的人里 126 个人在第一周真的用扩展保存过东西,最后 63 个人留下来,每周都会用扩展保存至少一次。
步间转化率是这么算的:安装率 420 除以 1000,是百分之四十二;登录率 210 除以 420,是百分之五十;首周使用率 126 除以 210,是百分之六十;周留存率 63 除以 126,是百分之五十。整体转化率是 63 除以 1000,是百分之六点三。账要这么平:1000 减 420,掉了 580 个人;420 减 210,掉了 210 个人;210 减 126,掉了 84 个人;126 减 63,掉了 63 个人;最后剩下 63 个人。580 加 210 加 84 加 63 再加 63,正好是 1000,一分不差。
这张漏斗最值得看的不是最后一格,而是第一格到第二格之间掉的那 580 个人。商店页访问到安装,只有百分之四十二,说明商店页本身有问题:截图没讲清楚扩展是干什么的,或者权限说明吓跑了人,或者用户看了半天没明白“这东西和网页版有什么区别”。很多人一看到安装数低,第一反应是去投广告、去发帖子引流,但漏斗告诉你:先修商店页,把百分之四十二修到百分之五十,比多引一倍流量更划算。
第二格到第三格,210 个人装完没登录,掉了一半。这里最常见的两个原因:一个是登录流程太绕,用户在扩展里点了登录,被跳到网页版,登完又跳不回来;另一个是用户根本不知道扩展需要登录,他以为装上就能用,点了一下没反应,就再也不点了。修法也很直接:把登录做成扩展里一步完成的事,登完立刻告诉用户“好了,现在可以保存了”,再送他一次成功的保存体验——让他亲手保存一次当前页面,看到“已保存”三个字,他就知道这东西怎么用了。
第三格到第四格,84 个人登录了但第一周一次都没用。这 84 个人不是不喜欢你的产品,他们是忘了。扩展装在工具栏里,不点就看不见,用户忙起来就想不起来。修法不是发推送骚扰他,而是把扩展放到他正在做的事情旁边:比如他打开一篇长文的时候,扩展轻轻提示一句“这篇文章可以存下来以后读”,或者在他第三次打开同一篇文章的时候提醒他“你已经打开三次了,要不要存下来”。提醒要发生在用户需要的时候,而不是你想起他的时候。
最后一格,63 个人留下来每周都用。这个数字不大,但它是最值钱的数字:这 63 个人是你的扩展真正服务到的人。他们每周都会打开你的产品,哪怕只是点一下保存。扩展的价值不在安装数上,而在这 63 个人身上。把漏斗的每一格都修一遍,比盯着最后一格感叹“留存太低”有用得多。
上线前清单:十件事,逐项打勾
第一,写出那句话:装了扩展之后,用户在别的网站上能多做哪一件现在做不了、或者做起来很费劲的事?写不出来就别做。第二,形态只选一种,先做最能代表核心动作的那一种。第三,权限清单逐项过:每一项权限都能用一句话向用户交代清楚用途,交代不清楚的删掉。第四,安装时不主动要权限,等到功能真正需要的时候再申请。第五,扩展和主站共用一套登录,用户在主站登过一次,扩展里不再出现登录框。第六,离线保存先生效:没网的时候先记本地,联网后悄悄同步,绝不假装成功。第七,冲突按时间说话,后改的赢,先改的进历史记录。第八,关键逻辑和功能开关放在服务器端,别写死在扩展里。第九,分阶段发布,先给一小部分用户,盯着崩溃数和卸载数再全量。第十,更新说明写三句话:新加了什么、改了什么、修了什么。
这十件事都不难,难的是在赶工期的时候,一件一件都做到。扩展是个慢功夫:它住在用户的浏览器里,离用户最近,也离用户的警惕最近。权限多要一个,用户就多一分怀疑;同步丢一次,用户就少一分信任。反过来,扩展一旦做对了,它就是你的产品离用户最近的地方:用户不用打开你的网站,就能用上你的产品。阿南后来养成了一个习惯:看到好文章,先点一下扩展保存下来,晚上躺在沙发上再慢慢读。这个习惯不是“随手存”教他的,是扩展让他做起来毫不费劲,他才养成的。你的扩展要做的,也就是这件事:把用户本来就想做的事情,变得毫不费劲。
评论 (0)
原始来源
相关文章
主线程又要画页面又要算账,一算就卡。Worker 是另一条线程、另一个全局上下文,两边只靠消息传话。本文按 MDN 的《Using Web Workers》与《Worker》两篇官方文档讲清楚:new Worker、postMessage 与 onmessage、结构化克隆的复制语义、Worker 里能与不能、onerror 与 terminate()、SharedWorker、Transferable 零拷贝,另附虚构咖啡馆点单页一个月 100 次 Worker 翻车的分布。
setTimeout 管一次,setInterval 管反复,但 delay 只保证“最少等这么久”:0 也不立刻、后台标签页还会更晚、超过 2147483647 会溢出。本文按 MDN 的 setTimeout 与 setInterval 两篇官方文档讲清楚:异步返回、传参、delay 的数字规矩、嵌套 4 毫秒、clearTimeout 与 clearInterval、递归 setTimeout、this 丢失与字符串参数,另附虚构咖啡馆点单页一个月 100 次定时器翻车的分布。
数组得一次全算好,生成器一次只给一个值,要的时候再算。本文按 MDN 的《Iterators and generators》《function*》《Generator》三篇官方文档讲清楚:next() 协议、function* 与 yield、for...of 消费、Symbol.iterator、yield* 委托、next(x) 往里传值、throw() 与 return(),以及什么时候该用生成器,另附虚构咖啡馆点单页一个月 100 次生成器翻车的分布。