order_site/apps/extensions/pdd-cookie-sync

拼多多商家后台 Cookie 自动保活扩展 (Chrome / Edge Extension)

本浏览器扩展程序专为解决拼多多商家后台（MMS）会话 Cookie 易过期、人工每日 F12 抓包容易遗忘与导致系统漏单而设计。

---

核心工作原理与安全机制

1. 自动嗅探与监听（Silent Capture）：

   • 监听 mms.pinduoduo.com 的 Cookie 变更事件；
   • 自动在后台提取新鲜的会话凭证（包含 PASS_ID、rckk 等）；
   • 内置 SHA-256 指纹比对去重机制，无实质变动时不发起网络请求，绝不浪费带宽与频控。

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 确保任意环节防篡改。
   • 无私钥泄漏风险：扩展仅内置/获取公钥，即使他人获取插件源码也绝对无法解密回传数据包。

3. 双向鉴权与店铺绑定（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 覆盖，默认留空即采用全自动多维嗅探。