dsh-plugin-shop-accounts:一店一份 Chrome 档案,养住电商卖家后台登录态

前言

在 DSH 里做电商上架、改价、同步库存一类自动化时,脚本往往要连卖家后台。常见做法是每次跑流程都起浏览器、扫码或过滑块,或者把 cookie 抄进环境变量——店铺一多,端口和会话很容易串,掉线也难及时发现。

DeepSeek Harness 的插件机制可以把这类能力做成可挂载模块。下面介绍社区插件 dsh-plugin-shop-accounts(维护者 monagisa,分类:客户端):把拼多多、淘宝、天猫、抖音抖店、京东京麦、1688 等商家端的登录态集中管理,一店对应一份独立 Chrome 用户数据目录和固定 CDP 调试端口,登录一次后长期复用,上架脚本直接连端口、用档案路径即可。

这是什么

dsh-plugin-shop-accounts 是 DSH 桌面端插件,定位是「账号与浏览器档案管理」,不碰商品、不提交、不改价,只负责把各平台卖家后台的登录态养在本地。

社区插件目录由 SkillHub 等站点维护,与 DeepSeek / 幻方无官方从属关系;安装前建议自行阅读源码与许可证。插件以当前 DSH 进程权限运行,档案与 cookie 备份落在本机数据目录。

核心功能

能力 说明
一店一档案 每店独立 user-data-dir + 独立 CDP 端口(默认从 9222 起自动找空位),cookie 互不串
有头登录 拉起真实 Chrome 窗口,扫码/密码/滑块由人完成;后台轮询判为已登录后点「完成并关闭」,态写入磁盘
静默检测 无头 Chrome 探一次登录态并写回,约 2.6–3.1 秒/店
定时检测 按排期把全部店铺串行体检,状态自动刷新
保活 判已登录后页面多停留若干秒再复查,利用站点访问续期凭证
自更新 面板检测 GitHub 新提交,支持一键快进合并并覆盖 profile 内副本
多店管理 搜索、按平台筛选、详情页、单店暂停、拖拽调整排期顺序

支持平台及身份 cookie 判据(节选,完整表见 README):

平台 商家端入口侧重 登录态认哪些 cookie
拼多多 mms.pinduoduo.com PASS_ID / SUB_PASS_ID
淘宝 / 天猫 千牛卖家 unb / sgcookie(须命中其一)
抖音抖店 fxg.jinritemai.com passport_assist_user、sessionid 等
京东京麦 passport.shop.jd.com pt_key / pt_pin
1688 login.1688.com _nk_ / __cn_logon__=true

登录态判定原则:被站点重定向到登录页即视为未登录(与 cookie 是否还在罐里无关);优先用身份 cookie + 域名;CDP 读 cookie 失败时才弱依赖 URL。

较新的实现还处理会话级 cookie(如淘宝 cookie2)关窗丢失:启动参数带 --restore-last-session,并在本地 dsh-session-cookies.json 做 cookie 罐备份,启动时通过 CDP 补全档案中缺失项。

安装与启用

前置:已安装 DSH Desktop;本机有 Chrome 或可用的 Edge。

从源码目录安装(开发时推荐)

在 PowerShell 中执行(将路径换成你本机克隆或解压后的插件目录):

dsh plugin --profile <profile名> add file:D:\path\to\dsh-plugin-shop-accounts

手动安装(GUI 无安装入口时)

  1. 将整个插件目录复制到 %DSH_HOME%\profiles\<profile名>\node_modules\dsh-plugin-shop-accounts\(%DSH_HOME% 默认为 ~/.dsh)。
  2. 编辑同 profile 下的 package.json:在 dsh.profile.bundles 中加入 "dsh-plugin-shop-accounts";在 dependencies 中加入 "dsh-plugin-shop-accounts": "file:<本目录绝对路径>"。
  3. 重启 DSH Desktop。

说明:改宿主侧(如 lib/index.js)需重启 DSH;仅改客户端(lib/client.js)刷新页面即可,但文件须先同步到 profile 的 node_modules 副本。

装好后,「设置」中会出现 账号管理。

典型用法

新增店铺并登录

  1. 打开 设置 → 账号管理 → + 新增店铺,选择平台、填写店铺名(备注可选;调试端口留空则自动分配)。
  2. 点 创建并去登录,在弹出的 Chrome 窗口中登录对应卖家端后台。
  3. 回到 DSH,行内状态变为「已登录」后,点 完成并关闭(窗口关闭,登录态保留在档案中)。
  4. 后续上架或其它脚本使用该店时,记下列表中的 调试端口 与 复制路径 得到的档案目录。

与上架脚本对接

脚本复用账号时需对齐两样信息:

  • 调试端口:列表「调试端口」列(脚本侧常对应 PDD_PORT 等变量);
  • 浏览器档案路径:「复制路径」得到的目录(脚本侧如 -Profile <档案目录> 或 chrome_profile)。

若行内显示 CDP 可用,表示该店浏览器已开且端口可用,脚本应直接连该端口,不要对同一档案再启第二个 Chrome 实例。

定时检测(可选)

在列表上方 调整排期 可配置:每日起始时间、组间隔(分钟)、每组店铺数(留空时内存 ≤16GB 为 1 家/组,>16GB 为 2 家/组)、保活停留秒数(默认 8)、总开关「开启定时检测」。到点无头串行检测,错过 2 分钟窗口不补跑;正在登录或浏览器已占端口的店铺会跳过。

自检(开发者)

仓库内不启动浏览器、不碰真实账号的冒烟测试:

node test/smoke.mjs

README 记载该套自检为 47 项;package.json 中亦提供 npm run smoke 指向同一脚本。

适用场景与注意

适合:在 DSH 生态里维护多家电商卖家后台会话、希望上架/运营脚本稳定复用已登录 Chrome profile 的团队或个人。

注意:

  • 插件不代替各平台风控与账号安全策略;「纸面 cookie 到期」不等于会话仍可用,掉线会如实显示「登录已失效,请重新登录」。
  • 数据落在本机(含可选的 dsh-session-cookies.json),需自行备份与权限控制。
  • 加新平台需在 lib/platforms.mjs 补记录并用 node test/live-probe.mjs 等验证,属二次开发范畴。
  • 安装与更新会读写 profile 与 git 合并(面板「更新到最新」使用 git merge --ff-only origin/main 等流程),请在可信源码前提下操作。

结尾

dsh-plugin-shop-accounts 把「一店一份 Chrome 档案 + 固定 CDP 端口」做成 DSH 里的账号管理面板:人工登录一次,静默与定时检测保活,上架脚本按端口和档案路径接入即可。详情与版本变更见 GitHub README 与 CHANGELOG。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜