# 商店健康

v1.10.0 新增

商店健康在 **WCPOS v1.10.0** 中引入。它取代了原来独立的日志屏幕，并新增了对同步状况、本地数据覆盖情况和服务器负载的实时可见性。

**商店健康** 是 POS 的仪表板，展示您的设备与 WooCommerce 商店之间发生的一切。请从导航抽屉（心跳图标）中打开它。它包含三个选项卡：**性能**、**数据库** 和 **日志**。

## 性能[​](#performance "直接链接到 性能")

性能选项卡回答的问题是“POS 给我的服务器带来了多少开销，同步是否健康？”

* **状态行**——`✓ 正常` 或 `⚠ 需要关注`，依据引擎的当前状态判断（已经恢复的短暂故障不会连续一天向您报警）。
* **实测活动**——过去 24 小时内发出的请求数和典型响应时间，是本收银台的实际测量值，而非估算值。传输数据量是一个下限，因为未声明大小的响应计为零。
* **运行状况条**——过去 24 小时中每小时一格。绿色表示该小时内的请求均无错误完成；琥珀色表示至少有一个请求失败（哪怕只有一个——没有阈值）；空白表示应用当时未运行。
* **下次检查倒计时**——距离下一次变更检查还有多久。在空闲的收银台上，它显示的时间可能合理地长于所配置的间隔，因为检查带有抖动，并且在空闲 10 分钟后会放慢。安静的收银台上倒计时较长是正常现象，并不代表同步停滞。

### 同步预设[​](#sync-presets "直接链接到 同步预设")

三张预设卡片通过两个调节项设定本设备的同步积极程度——POS 检查变更的频率，以及每次请求获取的记录数：

| 预设             | 检查间隔 | 每次请求的记录数 |
| ---------------- | -------- | ---------------- |
| **节能**         | 5 分钟   | 25               |
| **均衡**（默认） | 60 秒    | 50               |
| **实时**         | 10 秒    | 75               |

共享主机或经济型主机请选择 **节能**；当多台收银台需要快速看到彼此的更改且服务器负担得起时，请选择 **实时**。**自定义** 滑块会开放完整范围（5 秒–5 分钟，10–100 条记录）。

有两点需要了解：

* **设置按设备生效。** 调整一台收银台不会影响其他任何设备——您想调整的每台收银台都需要重复该更改。
* 调节项旁显示的 *约 N 次请求/天* 是根据所配置间隔推导出的名义检查频率，既不是上限也不是预测值。抖动可能使实际数量上下浮动；无变更的 `304` 开销很低，但仍计为一次请求。空闲衰减只会降低快于其 60 秒下限的预设的请求量，因此不会让均衡预设变得更慢。

更改立即生效，无需重启。有关这些数字背后的工程原理，请参见 [同步性能](/zh-CN/reference/sync-performance.md)。

## 数据库[​](#database "直接链接到 数据库")

数据库选项卡回答的问题是“这台设备上有什么，以及是否所有内容都已送达我的服务器？”

顶部有四个磁贴：**可开始销售** 里程碑、本设备上的记录数、已用存储空间，以及等待发送的更改数。

“可开始销售”是一个里程碑，而不是完整下载的门槛

只要设备上有了第一件产品，它就会翻转为已达成。离线并不会阻止它——设备上已有产品的收银台就可以离线销售。这正是本地优先 POS 的意义所在。

### 覆盖表[​](#coverage "直接链接到 覆盖表")

每个同步的集合都有一行：**设备上**、**服务器上** 以及一根覆盖率条。这些数字遵循严格的诚实原则——*服务器上* 的总数始终是服务器真实上报的数字，绝不是猜测：

* ***正在检查…***——POS 还没有获得最新的服务器总数。如果某一行保持这个状态超过约 15 分钟，说明该集合的 REST 路由可能出现故障；请查看 [日志](#logs)。
* **覆盖率条不满通常是正常的。** 客户会在空闲时间逐步下载，分类和优惠券在首次打开时下载，而 **订单** 条是相对于您的整个订单历史来衡量的，而收银台有意只保留未结和最近的订单——因此在完全健康的收银台上，订单也会显示为部分覆盖。
* **在执行“清除并重新下载”之后，计数为空或偏低是设计使然的结果，而不是同步停滞**——按需下载的集合会在使用过程中重新填充，每一行的说明文字都会告诉您该集合是如何重新填充的。

### 从未送达服务器的更改[​](#refused-changes "直接链接到 从未送达服务器的更改")

如果您的服务器永久性地拒绝了某项更改（例如，某笔销售创建时站点认为该请求无效而拒绝了它），POS **不会** 无声地永远重试，也不会把它藏起来。该更改会被搁置并在此列出，同时附带服务器给出的原因、发生时间以及两个操作：

* **重新发送**——根据记录 *当前* 的状态重新构建请求并再次排队。如果同一字段再次被拒绝，尝试次数会明显增加，而不会假装成功。
* **放弃**——丢弃该更改。确认对话框会准确告诉您放弃对该记录意味着什么（包括当该记录只存在于本设备上时，放弃就等于删除它）。

恢复始终是一次刻意且可见的操作——这里没有任何自动行为。

### 清除并重新下载[​](#clear-and-redownload "直接链接到 清除并重新下载")

每个集合行都提供 **清除并重新下载**，它会移除该集合的本地副本并重新获取。确认框会说明将移除多少条记录、大约多少存储空间，以及哪些内容会安全地留在服务器上。请优先使用它，而不是清除全部本地数据——它是有针对性的，而且不会让您退出登录。[清除所有本地数据](/zh-CN/support/troubleshooting/clear-local-data.md) 仍然是彻底的重置手段。

## 日志[​](#logs "直接链接到 日志")

日志选项卡是本设备上同步活动的流水账：每行包含 **时间、级别、事件、时长、状态**，保留 30 天。

* **预设筛选器**——全部 / 操作 / 错误 / 同步，另有一个 **详细诊断** 开关，可捕获 24 小时的额外细节，然后自动关闭。
* **行详情**——错误和警告可展开，显示通俗易懂的原因、一行数据安全说明、建议的下一步操作，以及指向 [错误代码](/zh-CN/error-codes/.md) 的帮助链接。每个详情视图都带有可复制的事件代码——联系支持团队时请附上它。
* 日志条目在显示时会被翻译，因此几个月前写入的一行会以收银台今天所用的语言呈现；事件代码才是稳定的标识符。

两个选项卡，两个计数

日志选项卡仅根据日志条目推导其卡住记录的计数；数据库选项卡还会计入被搁置的、遭拒绝的更改。当两者不一致时，**以数据库选项卡为准**，它才是判断哪些内容尚未送达服务器的权威。

## 相关页面[​](#related "直接链接到 相关页面")

* [同步引擎的工作原理](/zh-CN/reference/sync-engine.md)——关于通道、变更检测和写入队列的开发者级细节
* [同步性能](/zh-CN/reference/sync-performance.md)——保护您服务器的请求上限与退避规则
* [服务器性能](/zh-CN/support/performance/server.md)——调优 WordPress/WooCommerce 主机
* [清除所有本地数据](/zh-CN/support/troubleshooting/clear-local-data.md)——彻底的本地重置