Chrome MV3 侧边栏插件实战：从自动评论到试用额度与卡密授权

Chrome MV3 侧边栏插件实战：从自动评论到试用额度与卡密授权

本文复盘一个真实上线的浏览器插件（小红书自动评论助手）的开发与商业化落地：MV3 架构怎么拆、防风控节奏怎么设计、试用期如何用「时间 + 条数」双闸门防止被薅、到期为什么不硬锁而是降级，以及卡密授权后端的对接细节。文中代码与参数均来自线上版本 v1.7.9。

一、为什么做成浏览器插件

运营小红书最大的时间开销是"手动翻笔记 + 手动评论"：找内容、点开、输入、提交，一篇笔记要几十秒，一天几十篇就是一两个小时。

选型时对比过三种形态：

插件形态还有一个隐性优势：数据可以完全留在用户本地，这在"工具要卖给用户"的场景里是最硬的信任背书。

二、整体架构：三个组件 + 一条铁律

侧边栏常驻只需一行配置：

if (chrome.sidePanel && chrome.sidePanel.setPanelBehavior) {
    chrome.sidePanel.setPanelBehavior({ openPanelOnActionClick: true });
}

铁律：MV3 的 Service Worker 随时可能被浏览器挂起，内存态不可信。 我们把所有状态都落到 chrome.storage.local：试用起点时间、额度计数、授权缓存、评论记录、AI 配置。上线初期踩过坑——试用计时存在内存里，SW 被回收后倒计时归零重算，用户凭空少半天试用。

三、评论主流程的三个关键点

3.1 三种评论方式（以及被砍掉的第四种）

AI 模式请求体就是标准的 /chat/completions，提示词用 {{content}} 占位符替换笔记正文，用户可自定义：

messages: [{ role: 'user', content: prompt }],
temperature: 0.7,
thinking: { type: 'disabled' }   // 思考型模型关思考，正文不会被 max_tokens 截断

侧边栏三种评论方式与 AI 配置

真实踩坑：第四种"图片回复"模式被整个移除。 上线后实测发现，小红书网页版评论框根本没有图片上传入口（仅手机端支持）。我们的处理是分两步：v1.7.7 先在 UI 加显著警告"该模式大概率发不出"，v1.7.8 连同发送逻辑、配置面板、存储字段整体删除，并把老用户残留的 image 模式自动回退为固定池。教训很简单：先验证平台能力边界，再决定功能去留，带病上线的功能只会消耗信任。

3.2 防风控：随机间隔 + 发送双重校验

固定频率是自动化最明显的指纹。间隔在设定范围内随机取值（默认 1~2 分钟，支持小数），并在进度条上实时倒计时：

const totalSec = Math.round((min + Math.random() * (max - min)) * 60); // 如 60~120 秒

发送后不做"发了就算成功"的乐观假设，而是校验：评论框被清空 或 评论列表里出现了该文本才算成功，才写入统计与额度计数。失败的评论既不记录也不扣额度。

3.3 数据全程本地

文字库、评论记录（今日/本月/总计）、模型 Key、图片等全部存 chrome.storage.local。唯一外发的是随机设备码 + 版本号，只用于授权校验和安装统计——这一点写进了插件的隐私页，也是打动付费用户的关键话术。

四、商业化：试用、额度与卡密授权

4.1 只限时间的试用一定会被薅

早期版本是"1 天全功能试用"。拉长试用的直接后果是：试用期越长，白送的评论量越多——时间本身就是免费额度。所以 v1.7.9 改成时间与条数双闸门，先到先停：

const TRIAL_MS      = 72 * 60 * 60 * 1000; // 72 小时试用
const TRIAL_QUOTA   = 100;                 // 试用期最多 100 条评论
const GRACE_DAILY   = 3;                   // 到期降级：每天 3 条体验额度
const PROMO = { code: 'XHS24H', percent: 20, windowMs: 24 * 60 * 60 * 1000 }; // 到期 24h 优惠

试用倒计时与剩余额度实时显示

4.2 额度计数挂在哪

计数点选择评论成功之后（失败不扣），通过消息发给后台：

// content.js：每成功一条
const res = await chrome.runtime.sendMessage({ action: 'usageTick' });
if (res.data.allowed === false) {
    this.isAutoClicking = false;   // 额度用完，立即停止本轮任务
    this.showToast('⛔ ' + res.data.message);
}

闸门一共两道：开始前侧边栏 isFeatureAllowed() 拦一次（含"今日 3 条已用完"的场景），运行中每条成功后检查一次。授权用户直接返回 allowed: true，不计数。

4.3 到期不硬锁，改降级

状态机只有三个状态：authorized（付费无限）/ trial（72 小时且未满 100 条）/ grace（降级体验）。没有 locked 状态。

到期后：评论记录、文字库、模型配置全部保留，每天放 3 条，跨天自动恢复；侧边栏顶部出现 24 小时限时优惠条（倒计时精确到秒、一键复制）。产品逻辑是——"记录还在，解锁继续"远比"到点锁死"更接近付款动作，硬锁等于亲手扔掉转化钩子。

4.4 授权后端的三条对接经验

我们用自建卡密系统（卡密 + 机器码绑定、支付成功自动发卡、百分比优惠券按 project_ids 隔离）：

1. 下单金额以后端为准：服务端按套餐原价重算 pay_amount，客户端传的 amount 不可信（实测同一天管理员改价 299→88，任何写死金额的客户端都会出错）。
2. 优惠码必须带降级重试：带券下单失败时自动去掉 coupon_code 重试一次——优惠码异常绝不能挡住付款，这是营收路径。
3. 客户端 fail-open：授权服务超时/宕机时放行并提示"临时放行"，绝不因为自己的服务器挂了锁死付费用户。

五、踩坑速查表

六、合规提示

自动化评论存在违反平台社区规范的风险，可能触发限流甚至封号。本文的技术分享不构成使用建议：请控制频率（建议间隔 1 分钟以上）、仅用于自有账号的运营，使用行为由使用者自行负责。

七、相关链接

• 产品官网（可直接下载试用）：https://dl.88531.cn/xhs.html
• 开源部分（授权与框架代码）：https://github.com/personal82555/xhs-auto-comment
• 试用政策：3 天 + 100 条额度，到期每天仍可体验 3 条，24 小时内购买自动 8 折