前言¶
在 DSH 里做电商上架、改价、同步库存一类自动化时,脚本往往要连卖家后台。常见做法是每次跑流程都起浏览器、扫码或过滑块,或者把 cookie 抄进环境变量——店铺一多,端口和会话很容易串,掉线也难及时发现。
DeepSeek Harness 的插件机制可以把这类能力做成可挂载模块。下面介绍社区插件 dsh-plugin-shop-accounts(维护者 monagisa,分类:客户端):把拼多多、淘宝、天猫、抖音抖店、京东京麦、1688 等商家端的登录态集中管理,一店对应一份独立 Chrome 用户数据目录和固定 CDP 调试端口,登录一次后长期复用,上架脚本直接连端口、用档案路径即可。
这是什么¶
dsh-plugin-shop-accounts 是 DSH 桌面端插件,定位是「账号与浏览器档案管理」,不碰商品、不提交、不改价,只负责把各平台卖家后台的登录态养在本地。
- 目录页:skillhub.cn/plugins/monagisa/dsh-plugin-shop-accounts
- 源码与文档:github.com/monagisa/dsh-plugin-shop-accounts
- 许可证:MIT(见仓库
package.json) - 运行环境:Node
>=22.19.0,依赖 DSH Desktop;本机需有 Chrome(没有则尝试 Edge)
社区插件目录由 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 无安装入口时)¶
- 将整个插件目录复制到
%DSH_HOME%\profiles\<profile名>\node_modules\dsh-plugin-shop-accounts\(%DSH_HOME%默认为~/.dsh)。 - 编辑同 profile 下的
package.json:在dsh.profile.bundles中加入"dsh-plugin-shop-accounts";在dependencies中加入"dsh-plugin-shop-accounts": "file:<本目录绝对路径>"。 - 重启 DSH Desktop。
说明:改宿主侧(如 lib/index.js)需重启 DSH;仅改客户端(lib/client.js)刷新页面即可,但文件须先同步到 profile 的 node_modules 副本。
装好后,「设置」中会出现 账号管理。
典型用法¶
新增店铺并登录¶
- 打开 设置 → 账号管理 → + 新增店铺,选择平台、填写店铺名(备注可选;调试端口留空则自动分配)。
- 点 创建并去登录,在弹出的 Chrome 窗口中登录对应卖家端后台。
- 回到 DSH,行内状态变为「已登录」后,点 完成并关闭(窗口关闭,登录态保留在档案中)。
- 后续上架或其它脚本使用该店时,记下列表中的 调试端口 与 复制路径 得到的档案目录。
与上架脚本对接¶
脚本复用账号时需对齐两样信息:
- 调试端口:列表「调试端口」列(脚本侧常对应
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。