旧版客户端

HandyCafe 可以在同一台服务端上同时管理 V3 和 V4 客户端安装以及现代客户端。旧版客户端会以独立的卡片类型出现在管理面板中，并且只提供原始协议所支持的那组简化操作。

在您启用运行时支持之前，旧版客户端不会出现在管理面板里。请先在设置 > 旧版客户端中开启运行时支持。

旧版客户端如何显示

旧版客户端通过原始 UDP 组播协议连接到服务端，不使用现代客户端那套 mDNS。服务端会通过两种方式发现它们：

发现路径	触发条件
TCP 登录	客户端会在 TCP 命令端口发送 `LoginRequest`。服务端记录对端并发出已连接事件。
UDP Ping	客户端会在组播组上广播一个 `Ping` 帧。服务端接收后更新对端记录并发出在线事件。

按 MAC 地址保存的旧版客户端状态会包含 IP、主机名、登录用户、客户端版本、时段计时器和最近一次出现时间戳。每次收到入站帧都会重置不活跃计时器。如果计时器在默认 10 秒内没有收到流量就超时，客户端会被标记为离线。该记录会保留在数据库中，因此历史不会丢失。

每个旧版客户端都会渲染成一种不同于现代客户端卡片的样式。标题栏会显示显示名称（有主机名则显示主机名，没有则显示 MAC），在线或离线徽标，以及状态标签。

当有活跃时段时，卡片会显示一个时钟块：

卡片始终会显示：

当客户端在线时，身份信息下方的操作栏会提供可用操作。

按钮	显示条件	行为
登录	状态为空闲	打开设备登录对话框。选择分钟数和支付方式。服务端会使用所选值发送 Login 命令，时段在客户端上开始。
注销	状态为在线、限时、已暂停、忙碌或支付中	如果时段是后付费，会弹出支付对话框收取金额和方式，并写入一条交易记录。随后服务端发送 Logout 命令，客户端上的时段结束。

会打开一个分钟数选择器。可输入正数（延长）或负数（扣减）。双向的最大绝对值为 10,000 分钟。适用于预付费和后付费时段。

如果您在定价设置中配置了预设分钟值，卡片还会显示一行预设按钮。点击任意预设即可直接应用数值，而无需打开选择器。

通过文件传输端口向旧版客户端请求实时截图。流程如下：

如果客户端在超时时间内没有响应（默认连接 30 秒，数据 20 秒），请求会失败并弹出错误提示。您可以立即重试。

操作	确认	结果
注销登录	无	注销客户端机器上的 Windows 用户。Windows 会话结束，但电脑仍保持通电。
重启	是	发送重启命令。客户端机器会重新启动。
关机	是	发送关机命令。客户端机器会断电。

重启和关机会显示确认对话框，以防误操作。

旧版客户端并不支持现代 HandyCafe 客户端的全部功能。主要差异包括：

不支持时段中途暂停调整。 在时段暂停期间提交的时间变更会被排队，但客户端可能会忽略它们。请先恢复时段，应用变更，然后再按需暂停。
不能通过服务端命令进入管理模式。 客户端内部的管理状态无法从服务端切换，只能在客户端机器本地控制。
不能从服务端注册许可。 服务端只会镜像它在客户端帧中看到的许可字节，无法把新许可推送给客户端。请在本地注册客户端。
旧版客户端上开始的时段不支持会员钱包集成。 支付会记录为普通 transactions 行，transaction_type=sessions，并附带客户端 MAC。现代钱包流程不适用。
不支持远程桌面。 远程桌面功能使用的是旧版客户端中不存在的 UDP 流式路径。
不支持文件同步推送。 Sync Explorer 只会通过现代协议推送文件。

如需完整功能，请尽可能迁移到现代 HandyCafe 客户端。

当不活跃超时到期时，卡片会变暗，状态徽标变为灰色，所有操作按钮都会被禁用。客户端记录会继续保存在存储中，因此历史、MAC、主机名和最后出现数据都能保留。当客户端再次在线（新的 UDP Ping 或 TCP 登录）时，卡片会恢复正常，操作也会重新可用。

该记录不会自动移除。若要永久删除旧客户端，请在管理数据库中编辑它，或者通过相应的管理工具删除。

除非您知道旧版客户端广播得更慢，否则请将不活跃超时保持在 10 秒。过短的超时会在短暂网络抖动期间错误地把健康客户端标记为离线。
如果旧版客户端显示在线但不响应命令，请确认设置中的协议变体。服务端变体（STE 或 Standard）与客户端构建不匹配会导致命令静默丢失。
来自旧版客户端的截图是压缩 BMP，体积比现代 PNG 截图更大。如果您会大量截屏，请把 legacy_screenshots 文件夹放在有足够剩余空间的磁盘上。
在班次切换时使用带预设按钮的追加时间。轻点一下就能按预定义增量延长时段，比手动输入分钟更快。
逐步淘汰旧版客户端。一次迁移一批，确认新客户端在管理面板中的表现完全一致，然后再退役旧设备。