yml2213
9a342e7ea6
1. 新增 content.js 页面级保活引擎，自动注入拼多多商家后台 (mms.pinduoduo.com)； 2. 主动防休眠与静默续期：每 2 分钟向 MMS 接口发送轻量只读心跳并派发微动作，主动刷新服务端 PASS_ID 有效期，从根本上阻止空闲弹窗生成； 3. 超时弹窗秒级自动拦截：使用 MutationObserver 实时监听 DOM，毫秒级捕获「当前页面停留时间过长」弹窗并自动点击「刷新」，彻底解决页面挂死导致 Cookie 会话过期被踢出账号的问题； 4. 后台长效平滑刷新：后台标签页静置超 25 分钟自动执行无感安全重载，保障 CSRF Token 与会话 24 小时鲜活； 5. 日志链路打通：将页面防休眠、弹窗拦截与周期刷新事件接入扩展日志控制台。
4.7 KiB
4.7 KiB
拼多多商家后台 Cookie 自动保活扩展 (Chrome / Edge Extension)
本浏览器扩展程序专为解决拼多多商家后台（MMS）会话 Cookie 易过期、人工每日 F12 抓包容易遗忘与导致系统漏单而设计。
核心工作原理与安全机制
-
自动嗅探与监听（Silent Capture）：
- 监听
mms.pinduoduo.com的 Cookie 变更事件； - 自动在后台提取新鲜的会话凭证（包含
PASS_ID、rckk等）； - 内置 SHA-256 指纹比对去重机制，无实质变动时不发起网络请求，绝不浪费带宽与频控。
- 监听
-
主动防休眠与防退出引擎（v1.2.0 新增 Anti-Logout Engine）：
- 静默会话续期：定时（每 2 分钟）自动调用轻量后台接口，主动刷新拼多多服务端
PASS_ID的 TTL 有效期； - 前端防休眠心跳：向页面派发微弱活跃事件，重置 MMS 前端空闲计时器，从根源阻止「页面停留时间过长」弹窗产生；
- 秒级弹窗拦截：DOM 监听器毫秒级捕获停留过长弹窗并自动秒点「刷新」，彻底避免页面挂死导致 Session 过期被强制踢出登录；
- 周期平滑刷新：长时间挂机自动无感重载，确保 24 小时保持登录与 Token 鲜活。
- 静默会话续期：定时（每 2 分钟）自动调用轻量后台接口，主动刷新拼多多服务端
-
端到端信封加密（End-to-End Envelope Encryption）：
- 传输层：强制走 HTTPS / TLS 1.3 通道；
- 应用层：使用浏览器原生 Web Crypto API 生成随机 256 位 AES-GCM 对称密钥；
- 非对称公钥包装：使用服务端的 RSA-2048 公钥（RSA-OAEP SHA-256）加密 AES 密钥；
- 防重放与防篡改：每个数据包附带 60 秒失效时间戳与加密 Nonce，服务端做幂等校验，AES-GCM Auth Tag 确保任意环节防篡改。
- 无私钥泄漏风险：扩展仅内置/获取公钥，即使他人获取插件源码也绝对无法解密回传数据包。
-
双向鉴权与店铺绑定（Pairing Token）：
- 每个店铺在管理后台均有独立的
syncToken； - 只有持有该配对密钥的插件上报才会被服务端接受。
- 每个店铺在管理后台均有独立的
安装使用指南（面向客服与运营人员）
第一步：安装插件到 Chrome / Edge 浏览器
- 打开 Chrome 或 Edge 浏览器；
- 在地址栏输入并前往扩展管理页：
- Chrome 浏览器：
chrome://extensions - Edge 浏览器：
edge://extensions
- Chrome 浏览器：
- 开启页面右上角的 【开发者模式】（Developer mode）；
- 点击左上角出现的 【加载已解压的扩展程序】（Load unpacked） 按钮；
- 在文件选择窗口中，选中本项目目录下的：
apps/extensions/pdd-cookie-sync - 确认加载，浏览器右上角扩展栏将出现「拼多多 Cookie 自动保活」图标。
第二步：配对店铺与配置
- 打开管理系统后台 -> 【平台配置】 -> 【拼多多平台】；
- 找到需要保活的目标店铺，在表格操作列点击 【插件配对】 按钮；
- 弹窗中点击 【一键复制完整配置】；
- 点击浏览器右上角扩展图标，在弹窗中点击 【一键导入配置 JSON】，粘贴刚才复制的内容，点击 【解析并填充】；
- 点击 【保存配置并重连】；
- 插件立即发起第一次加密上传与连通性验证。
第三步：日常使用与状态观察
- 正常运行（角标显示绿色 OK）：
- 客服日常只需像往常一样在浏览器中登录拼多多商家后台（
mms.pinduoduo.com）； - 只要商家后台处于登录状态，插件会在后台自动完成 Cookie 刷新与加密上报，服务端同步生效，全程无感。
- 客服日常只需像往常一样在浏览器中登录拼多多商家后台（
- 角标显示红色 ERR：
- 点击插件图标查看具体错误原因。
- 若提示「会话已过期 (43001)」或「未检测到 PASS_ID」：请在当前浏览器中打开
mms.pinduoduo.com重新登录商家后台，然后点击插件【立即上传同步 Cookie】。
- 角标显示黄色 OFF / NO_CK / 未登录：
- 代表当前浏览器未登录拼多多商家后台，只需在网页中正常登录即可自动恢复。
诊断中心与运行日志（v1.1.0 新增）
- 实时日志控制台：
- 插件界面下方自带【运行日志】面板，记录包括 Cookie 嗅探、公钥获取、加密打包、服务端响应状态在内的全链路日志；
- 关键令牌安全脱敏显示，敏感信息不落地、不泄露。
- 一键复制日志：
- 遇到任何异常时，点击【复制日志】即可将诊断上下文完整复制至剪贴板，方便快速排查；
- 手动指定 Cookie (选填)：
- 针对多浏览器环境或特定隔离场景，插件配置区支持手动粘贴 Cookie 覆盖，默认留空即采用全自动多维嗅探。