ARTICLE · 1364429
插件上架 Chrome 商店,我被拒了三次
上一篇写了「列表导出助手」怎么在本地跑起来。这一篇讲后半段——本地能用,和能上架,是两件事。
我的插件第一次提交,两周内被拒三次。三次的原因都不在代码逻辑,而在「平台怎么看你这个插件」。这篇把三次拒稿和最后的过审版本完整写出来,给同样卡在审核的人省点时间。

第一次被拒:权限太宽
第一次提交的 manifest.json 是这样的:
{"host_permissions": ["<all_urls>"],"permissions": ["storage", "scripting", "activeTab", "tabs"]}
本地开发这么写最省事,装上去什么网站都能用。但审核给的回复很直接:请说明为什么需要访问所有网站,并提供最小化权限的方案。
问题在于:导出助手确实需要「任意网站」——但我需要的是「用户当前点的那个网站」和「用户主动授权过的网站」,不是「所有网站的后台访问权」。
改法是把权限拆成三层:
{"permissions": ["storage", "scripting", "activeTab"],"optional_host_permissions": ["*://*/*"]}
activeTab:用户点插件图标或快捷键时,临时获得当前标签页的权限,不需要在安装时声明任何域名; optional_host_permissions:只有用户点「在这个网站启用」时才申请,运行期弹授权; 去掉 tabs:tabs权限能读所有标签页的 URL 和标题,是审核重点。我要的功能用activeTab就够。
代码上,从「安装即注入」改成「点按钮才注入」:
// popup.jsdocument.getElementById('enable').addEventListener('click', async () => {const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });const granted = await chrome.permissions.request({origins: [new URL(tab.url).origin + '/*']});if(!granted) return;await chrome.scripting.executeScript({target: { tabId: tab.id },files: ['content.js']});});
这一步改完,安装时用户看到的权限提示从「读取和更改您在所有网站上的所有数据」变成了「读取您在当前网站上的数据」。过审率差别巨大,用户卸载率也是。
第二次被拒:单一用途写成了功能清单
第二次的回复是:插件的单一用途描述与实际功能不一致。
我当时写的是:
本插件可以帮助用户导出网页列表、支持 CSV/JSON 导出、支持自动翻页、支持 DOM 解析、支持字段映射……
这是功能清单,不是用途。平台要的是一句话:这个插件到底只干哪一件事。
最后改成:
把网页上的列表数据导出为 CSV 文件。
所有功能都往这句话上靠:翻页是为了把列表取全,字段映射是为了导出的列对齐,DOM 解析是当页面没有接口时的兜底。描述里不再出现「还能……」「以及……」这类扩展句式。
顺带把插件里两个与主线无关的小功能删了——一个「夜间模式切换」、一个「一键截图」。它们各自都需要额外权限,而且都会让审核问一句「这和导出有什么关系」。
经验:一个插件只解决一个问题。想加第二件事,就做第二个插件。
第三次被拒:远程代码
第三次最冤,也最值得写。
我的 background.js 里有一段配置拉取:
// 旧写法:从服务器拉一段脚本再 evalconst code = await (await fetch(CONFIG_URL)).text();eval(code);
本意是「改配置不用重新发版」。但在 MV3 里,从远程加载并执行代码是明确禁止的,eval、new Function、远程 <script> 都算。哪怕你拉的是自己服务器的代码,也不允许——因为商店无法审计运行内容。
正确做法是把「配置」和「代码」分开:
// 新写法:只拉 JSON 数据,用本地代码解释它const cfg = await (await fetch(CONFIG_URL)).json();const rules = sanitize(cfg.rules); // 白名单校验,只允许固定字段applyRules(rules);
applyRules 里只接受声明式的结构,比如:
{"rules": [{ "host": "example.com", "listSelector": "table tbody", "pageParam": "page" }]}
这样远程下发的是数据,不是可执行逻辑,审核能看懂,也符合 CSP。
顺便提一句:MV3 的 CSP 默认不允许内联脚本和 eval,页面上任何 <script> 拼接字符串执行都会报错。写插件时别用 javascript: URL,也别用 setTimeout('字符串')。
过审版本的 manifest 长什么样
最终提交的完整配置:
{"manifest_version": 3,"name": "列表导出助手","version": "1.2.0","description": "把网页上的列表数据导出为 CSV 文件。","permissions": ["storage", "scripting", "activeTab"],"optional_host_permissions": ["*://*/*"],"action": { "default_popup": "popup.html" },"background": { "service_worker": "background.js", "type": "module" },"icons": {"16": "icons/16.png","48": "icons/48.png","128": "icons/128.png"}}
几个容易忽略但会被打回的细节:
description不能超过 132 个字符,不能堆关键词; 图标必须 128×128,缺了会在列表页糊成一团; 版本号必须是 1.2.0这种三段式,且只能递增,写错了要重新提一个更高的版本号;隐私政策链接是必填项,哪怕你不收集任何数据,也要勾选「不收集用户数据」并写一句说明。
隐私声明:三个勾选框,勾错就退回
提交页有一页「数据使用」,需要逐项声明:个人信息、健康信息、财务信息、认证信息、个人通讯、位置、网页历史、用户活动、网站内容。
导出助手会读网页内容,所以「网站内容」必须勾。但勾了之后要回答两个问题:
数据是否传输到你的服务器?——答:不传输,全部在本地处理。 数据是否用于与单一用途无关的目的?——答:不用于。
这里不能为了省事全部不勾。审核会拿权限和代码去对,声明「不访问网站内容」但代码里有 document.querySelectorAll,直接判定描述不实。
上架之后:更新比发布更麻烦
发布只是开始。真正长期的成本是更新:
审核时间:首次通常 1-3 个工作日,更新一般几小时,但遇到规则调整会突然变慢; 灰度:新版不是立刻全量,商店会分批推送,用户可能还在旧版,所以后台接口要兼容旧版本至少两周; 回滚:没有「撤回」按钮,只能发一个更高版本号把功能改回去。
所以我在 background.js 里留了一个版本协商:
const MIN_SUPPORTED = '1.1.0';if (compareVersion(chrome.runtime.getManifest().version, MIN_SUPPORTED) < 0) {showUpgradeTip();}
新接口上线时先兼容旧版,等旧版本占比低于 1% 再删兼容代码。这套流程在公众号这种「一次发出去就收不回」的场景里同样适用。
一页纸的自查清单
<all_urls> | activeTaboptional_host_permissions | |
tabs、webRequest | ||
eval | ||
1.0.0 |
最后
被拒三次之后我有个变化:写代码之前先看平台规则。
以前是「先做出来,不行再改」,现在是「先确认这条路平台允许,再动手」。这不是妥协,是把时间花在能被用户用到的地方——一个过不了审的插件,代码写得再漂亮也只是存在自己电脑里的一个文件夹。
下一篇换赛道,讲讲怎么在 Windows 的 WSL 里,不用 Mac 也能编译出能跑的 iOS 插件。
免责声明:本文为个人开发记录,插件仅用于导出用户本人有权访问的数据。请遵守目标网站服务条款与所在平台规则。















































































