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