运行历史
先把定时任务这个词说清楚。这个插件不是一直挂着不动的，它是隔一会儿自己跑一轮： 把主店改过的东西推到各个分店去。这种“自己按时间跑的活儿“，就叫定时任务。 它跑成功了还是失败了，得有个地方能看，这一页就是干这个的。 顺带先提醒一句：界面上进这一页的按钮叫「定时任务状态」，不叫「运行历史」 —— 下面第二段就把这件事讲清楚。
先说一件容易找不着的事：界面上这个入口的名字，跟这一页的标题不一样。 在「跟随设置」页最下面，那个按钮写的是**「定时任务状态」**； 而说明书这一页的标题叫「运行历史」（页面里那张列记录的表，标题也是「运行历史」）。 两个名字指的是同一个地方 —— 你在菜单里找的是「定时任务状态」，翻说明书找的是这一页。
从哪儿进去：这一页不是页签，是从「跟随设置」页最下面那行链接进去的二级页。 先点左边菜单「门店档案同步」，进去以后默认停在「跟随设置」那一页； 拉到最下面，有一行「定时任务状态 ›」，点它就进来了。 进来以后，最上面是「‹ 返回跟随设置」，点它回到跟随设置页。
什么时候会用到它
- 分店的资料迟迟没跟着主店改，你想知道同步到底跑没跑、跑成什么样；
- 怀疑同步失败了 —— 这一页是唯一能看出来的地方，跑失败不会自己弹出来提醒你；
- 刚重启过服务器，发现“刚开机就又跑了一轮“，想确认这是正常的；
- 想当场催一把，不想等下一轮，用「立即跑一次」；
- 觉得同步越来越慢，想看看每一轮的耗时是不是在往上涨。
怎么操作
第一步：看上面那张「定时任务」卡片
卡片标题就是任务名，后面跟着一句小字，写着它多久跑一次（默认是「每 60 秒跑一次」）。 卡片里四格写的是最近一次的情况：
- 上次运行：上一次跑的时间；一次都还没跑过，就写「还没跑过」；
- 结果：成功还是失败；一条记录都没有的时候显示「无记录」；
- 耗时：这一轮花了多少秒；
- 任务名：这个任务的标识，叫
product-sync-sweep。
这四格下面还有一行「上次结果：」，把这一轮干了什么写成一句话。
第二步：想当场跑一轮，就点「立即跑一次」
点下去按钮会变成「正在跑…」，跑完会提示“跑完一轮：…“。
这个按钮跟定时那一轮跑的是同一段逻辑 —— 所以它跑多少遍结果都一样， 不会因为你多点了几次，就重复同步一遍。放心点。
第三步：到下面「运行历史」这张卡片里看每一轮
这里一行就是一轮，从最近的一轮往下排。想知道这一轮具体改了哪些商品， 得去同步记录看 —— 这一页只记“跑了没有、成不成、花了多久“， 不改哪个商品的明细在这儿是没有的。
第四步：一条记录都没有的时候
卡片上会写「还没有运行记录。如果等了很久还是没有，去框架的「插件管理」看一眼这个插件的状态。」 也就是说：这一页是空的，不代表同步在正常跑，得去框架那边确认一下这个插件是不是好好的。
界面上都有什么
这一页有两张卡片。
「定时任务」这张卡片
| 卡片上的东西 | 是什么、从哪来 |
|---|---|
| 卡片标题 | 任务名，标题后面那句小字写着它多久跑一次（默认「每 60 秒跑一次」） |
| 上次运行 | 最近一次跑的时间，年月日和时分秒 |
| 结果 | 成功 / 失败，两个小标；一条记录都没有时显示「无记录」 |
| 耗时 | 这一轮花了多少秒，带一位小数 |
| 任务名 | 任务的标识 product-sync-sweep |
| 「上次结果：」那一行 | 这一轮干了什么，写成一句话 |
| 立即跑一次 | 人手工催一轮，跑的是跟定时同一段逻辑；跑的时候按钮写「正在跑…」 |
| 卡片下面那句说明 | 「立即跑一次」跟定时那一轮是同一段逻辑，跑多少遍结果都一样，不会重复同步 |
「运行历史」这张卡片
卡片标题右边有一句小字：「框架只记最后一次结果一句话，详细记录由本插件自己记」—— 意思是上面那张卡片里的“最近一次“来自框架，而这张表里一条条的历史，是这个插件自己攒下来的。
| 这一列 | 写的是什么、从哪来 |
|---|---|
| 时间 | 这一轮是什么时候跑的 |
| 结果 | 成功还是失败，两个小标 |
| 耗时 | 这一轮花了多少秒，写成带一位小数的秒数（数字后面跟一个小写的 s） |
| 说明 | 这一轮扫的是哪家店、扫了多少个品种、多少家分店，改了几行、建了几行、跳过几条、有几条冲突 |
卡片最下面还有一行「共 N 条」，N 是这一页显示了多少轮。
常见疑问
问：「定时任务状态」和「运行历史」是两个不同的地方吗？
答：是同一个地方。入口按钮叫「定时任务状态」，页面里那张记录表叫「运行历史」， 说明书这一页的标题用的是「运行历史」。从「跟随设置」页最下面那行点进去就是了。
问：为什么我刚重启服务器，就多出来一条运行记录？
答：这是正常的。框架记“上次跑的时间“是放在内存里的，一重启就清空了， 所以重启之后所有任务都会立刻先跑一次。看到刚重启就有一条记录，不用管它。
问：每一轮都要跑好几秒，是不是有问题？
答：先别急着下结论。框架的调度器是串行的 —— 说人话就是“一件一件排队做，不能几件事同时做“： 前面有一个任务跑得久，后面所有插件的任务都得等着。所以这里写“几百毫秒“甚至“几秒“的时候， 要当回事：不光是你这个同步慢，全系统都在等。 真觉得慢得离谱，把「说明」那一列写的品种数和门店数记下来，报给我们的实施同事。
问：同步失败了，我会收到提醒吗？
答：不会自己弹出来。这一页是唯一能看出来的地方。 所以隔几天来扫一眼「结果」那一列，有没有写着「失败」的；有的话，去同步记录 看看那一轮到底卡在哪个商品上。
问：这一页里为什么看不到“改了哪个商品“？
答：这一页只回答“跑了没有、成没成、花了多久“。要看改了哪些商品， 去同步记录：那里一行是一批，点「明细」能把这一批里的每一条改动展开看。
本页修订记录
| 说明版本 | 日期 | 对应系统版本 | 改了什么 |
|---|---|---|---|
| v1 | 2026-10-07 | 框架 1.0.91 / pk_sync 0.1.3 | 第一版 |