DeepSeek HarnessHub
提交插件

108943962/dsh-plugin-rpa-center ↗★ 1

dsh-plugin-rpa-center

RPA 中心（DSH 插件）：对已登录店铺批量跑推广/订单/财务/账户余额的日常导出与采集；店铺与「账号管理」插件共用档案与登录态。

金融資料效率工具
套件
dsh-plugin-rpa-center
相容性
待驗證
Cordis 依賴範圍
^4.0.2
版本
1.7.2
最近更新
2026年11月13日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:108943962/dsh-plugin-rpa-center

說明文件

閱讀完整 README ↗

RPA 中心（dsh-plugin-rpa-center）

DSH 左侧栏的「作业 × 店铺」自动化中心：对已登录的店铺批量跑推广 / 订单 / 财务 / 账户余额的日常导出与采集。

  • 本仓库：
  • 当前接入平台：拼多多（13 条作业，见下方清单）
  • 配套插件：账号管理 dsh-plugin-shop-accounts（店铺与登录态都来自它）

店铺与「账号管理」共用档案

RPA 中心不存密码、不另建浏览器档案。默认（source: "shop-accounts"）直接读 ~/.dsh/shop-accounts/accounts.json，复用「账号管理」插件里每个店铺的：

复用什么从哪来用途
店铺名 / storeIdaccounts.json面板上的店铺列表、运行记录、推送里的 store
Chrome 用户目录 profileDir同上跑作业时用同一份档案，登录一次长期复用
调试端口 port同上CDP 连接（默认 9222）
登录态同上（cookie 在档案里）掉登录/弹验证码时如实报 LOGIN_REQUIRED，去「打开店铺」手动过一次即可

于是两家插件分工是：「账号管理」负责有哪些店、登没登录；「RPA 中心」负责对这些店跑什么。 在「账号管理」里新增或登录一家店，这里刷新就能看到；这里的「打开店铺」拉起的是同一份档案，不是第二份。

用到的「账号管理」插件：

  • 本机部署用的 fork：
  • 上游原仓库：（MIT，作者 monagisa）

不共用：只用本插件自己的店铺

设置 → 店铺来源 →「只用本插件自己的店铺」，下面会出现店铺编辑区，直接填：

字段说明
店铺名面板上显示的名字
storeId可空，默认用店铺 id（推送/统计里用它）
端口可空，自动从 9200 起分配（多家不撞）
Chrome 档案目录可空，默认 ~/.dsh/rpa-center/profiles/

保存后这家店会出现在店铺列表里，作业照常跑。用哪份档案由你决定：档案是新的，第一次点「打开店铺」会拉起浏览器停在登录页， 手动登录一次即可（登录态留在该档案里，长期复用；不会读「账号管理」的任何数据）。

安装

# 1) profile 里加依赖（两个一起装：RPA 中心 + 账号管理）
cd ~/.dsh/profiles/desktop
pnpm add github:108943962/dsh-plugin-rpa-center github:108943962/dsh-plugin-shop-accounts

# 2) package.json 的 dsh.profile.bundles 里要有这两行：
#    "dsh-plugin-shop-accounts"、"dsh-plugin-rpa-center"

# 3) 重启 DSH，左栏出现「RPA 中心」

本地开发用 link：pnpm add link:/path/to/dsh-plugin-rpa-center。

运行数据都在 ~/.dsh/rpa-center/：config.json（设置）、runs.json（运行记录）、raw/（产物）、data/（指标台账）。

作业清单（13 条，拼多多）

作业 id分组区间产出
promotion_month推广上月 1 号 → 今天指标 17 项
ads_goods_month推广本月 1 号 → 今天xls
ads_month_export推广上月 1 号 → 今天xls
order_guonei / order_guowai订单近 3 个月（平台上限）csv
finance_month财务上月整月xls
finance_30d财务昨天往前 30 天xls
bill_guonei财务上月整月zip（内含 csv）
bill_guowai财务上月整月zip
bill_deposit财务上月整月zip
balance_guonei / balance_guowai账户余额月汇总（表格含全年各月）指标
ads_balance账户余额月账单（含各月）指标

界面

  • 批量开关（作业行左侧）：决定这条作业算不算跑量成员；关掉后单条「运行」照样能跑
  • 本次运行（顶部 chip）：这一次只跑勾上的；店铺的「跑作业」和「全部店铺跑一遍」都按它来
  • 折叠：本次运行 / 作业目录 / 每个分组都能点标题收起，状态记在 localStorage
  • 最近运行：每条都带产物下载按钮与推送结果
  • 设置：店铺来源、Chrome 路径、推送接口、按作业配接口

产物：任何作业都能下载

每次运行都有 artifacts: [{role, kind, name, path, bytes}]，界面渲染成下载按钮：

role内容谁有
business站点下载的文件（zip / xls / csv）下载型作业
metrics本次运行的指标 CSV（带 BOM，Excel 直接开）指标型作业
snapshot指标快照 JSON指标型作业
run整条运行记录 JSON（区间、日志、推送结果）所有作业（兜底）

指标台账另有一份追加式长表 ~/.dsh/rpa-center/data/metrics.csv（ts,storeId,jobId,rangeStart,rangeEnd,key,label,value）， 每天跑一次自然形成时间序列；GET /rpa/metrics?storeId=&jobId=&limit= 可查。

结果推送（每条作业可以有自己的接口）

{
  "push":   { "enabled": true, "url": "http://127.0.0.1:8000/rpa/inbox?task={task}", "method": "POST", "timeoutMs": 20000 },
  "pushes": { "bill_guonei": { "url": "http://127.0.0.1:8000/finance/bill", "includeFileBase64": false } }
}

判定顺序：pushes[作业id] 有地址就用它（enabled:false = 这条不推）→ 否则用全局 push → 都没有就只存本地。 请求体 { source, version, task, job:{id,name,group}, store:{id,name,storeId,platform}, range, ranAt, metrics?, file?{name,size,base64?} }； GET 方式把 storeId/task/start/end 拼进 URL。只接受 http(s) 地址。

定时任务（可以有多条）

面板「运行计划」卡片里点「＋ 添加任务」，每条规则独立配置：

字段说明
启用关掉只是不自动跑，规则还留着
名称比如「早间账单」「午间推广」，出现在运行记录与日志里
时间该规则的 HH:mm（本地时区）
星期点一下切换；默认每天
补跑开着：当天任意时刻启动都会补一次；关掉：只在到点后 1 小时内跑
跑哪些空 = 跟着每条作业的「批量」开关；也可以「用当前勾选」固定清单
  • 到点时逐条顺序执行（同一时刻到点的多条规则不会并发开一堆浏览器）
  • 状态按规则分开存 ~/.dsh/rpa-center/schedule-state.json（rules..lastRunDate / lastRunAt / lastResult），不改 config.json
  • 每条规则的「上次 11-13 08:01（成功 6 / 失败 0）」直接显示在规则行里；卡片标题显示「定时 2 条（下次 11-14 08:00）」
  • 「立即执行」「删除」都是二次确认：第一下只变成「确认执行？/ 确认删除？」，3 秒内再点才真的执行，不点会自动取消
  • 运行记录里带 trigger：manual / schedule / schedule-manual
  • 老配置里那条单规则会自动升级成第一条规则（id rule-1），不用手改

前提：到点时 DSH 得开着。没开不丢：下次启动如果当天还没跑过，会按补跑设置补一次。

停止正在跑的任务

顶部按钮区在跑作业时会多出一个红色「停止」（面板刷新后也还在，因为状态来自 /rpa/state 的 running）。

点它之后：

  • 当前作业会在下一次等待时退出（作业里的等待都走可中断的 sleep，一般 1–2 秒内），运行记录里标 CANCELLED / 已手动停止
  • 这一批里后面的作业不再开跑，店铺、定时规则的队列同理
  • 已经下载的文件、已经写入的记录都保留，不回滚

接口：POST /rpa/stop（无需参数）。下次开始运行会自动清掉停止标记，不用手动恢复。

可选：外部登录门槛（通用约定，不绑定任何登录系统）

有些交付场景要求「先登录才能看到作业」。RPA 中心不认识任何具体登录系统， 它只认一个状态文件，由部署方自己写：

/rpa-center/gate.json          # 可用 config.gate.statusFile 或 RPA_GATE_STATUS_FILE 覆盖
{
  "enforced": true,                      // 这个部署要不要拦
  "loggedIn": false,                     // 当前有没有登录
  "user": { "name": "张三" },             // 可选：登录后显示在副标题
  "reason": "no-account",                // 可选：排障用
  "title": "需要先登录途阳",               // 可选：提示卡标题
  "message": "点右上角「登录途阳」…"        // 可选：提示卡正文
}

开关：config.gate.enabled = true 才读这个文件（默认关闭，不写这个文件就等于没有门槛）。 文件缺失/读不出来时放行（fail-open）：门槛是体验约束，不该把用户锁在门外。

启用后：

  • 未登录：面板只显示一张提示卡（标题/正文取状态文件里的 title/message），作业列表、运行计划、店铺、最近运行都不出现；页面每 10 秒自动刷新，登录成功后作业列表自动出现
  • 接口层同样拦：/rpa/run、/rpa/run-all、/rpa/schedule-run、/rpa/open 返回 401 LOGIN_REQUIRED
  • 定时任务在未登录时不跑

示例：途阳jiajia。ptc-suite 每 5 秒把途阳登录态写进这个文件（ptc-suite/gate-sync.mjs）， 交付包的 cordis.patch.yml 里给 rpa-center 打开 gate.enabled: true 即可——RPA 中心本身完全不知道「途阳」的存在。

已知边界

  • 订单批量导出有 5 分钟间隔（站点限制）；5 分钟内重复跑会下载「最近一份」，extra.reportTime 里记录它的生成时间
  • 掉登录、弹验证码时如实报 LOGIN_REQUIRED，不会自动填短信验证码
  • 账单/流水是 zip 或 xls，本插件只负责拿到文件，解析交给下游
  • 目前只接了拼多多；其它平台在 lib/platforms.mjs 里是 ready:false，不会给假按钮

开发与排障

node tools/run-job.mjs --list                      # 列店铺 + 作业
node tools/run-job.mjs              # 不经界面跑一条（同一份代码）
node tools/peek.mjs  'document.title'         # 开临时标签看页面（只读，跑完关掉）
node tools/smoke.mjs                               # 提交前自检：/state、/config 全打一遍（临时 DSH_HOME）
node tools/dl-test.mjs                             # 下载捕获回归：同名文件原地覆盖、每次运行独立子目录
# 定时任务逻辑（到点/已跑/补跑窗口）在 tools/smoke.mjs 里，会真的触发一次 tick
cd tools/ui-test && pnpm install && pnpm test      # 界面点击检查：把面板真渲染出来，点一遍折叠/批量
  • 作业登记：lib/jobs/index.mjs（加作业只改这里 + 一个 lib/jobs/*.mjs，界面自动出现）
  • 页面动作：lib/jobs/common.mjs（选择器、日期面板、下载）
  • 引擎：lib/engine/cdp.mjs（Chrome CDP：点击、下载、等文件写完）
  • 接口：GET /rpa/state、POST /rpa/run、POST /rpa/run-all、POST /rpa/open、GET /rpa/file、POST /rpa/config、GET /rpa/metrics、POST /rpa/clear-runs