常见问题

安装与配置

HandyCafe 支持哪些类型的商家？

HandyCafe 面向网吧、电竞馆、电竞中心、网咖和 PC 房。任何提供按时计费的 PC 或游戏主机使用服务的商家都可以使用 HandyCafe 管理时段、计费和会员。

HandyCafe Server 的系统要求是什么？

服务端需要 Windows 10 或更高版本（64 位），至少 4 GB 内存，500 MB 磁盘空间和局域网连接。客户端 PC 需要 Windows 10 或更高版本，2 GB 内存。所有 PC 必须在同一局域网内。详情请参阅系统要求。

如何安装 HandyCafe Server？

从官方网站下载安装程序，运行并按照提示操作。首次启动时，首次设置向导会创建您的管理员账户。详情请参阅服务端安装。

如何将客户端 PC 连接到服务端？

在 PC 上安装 HandyCafe Client。它使用 mDNS 在局域网上自动发现服务端。如果自动发现失败，在客户端设置中手动输入服务端的 IP 地址。请参阅客户端安装。

为什么客户端无法连接到服务端？

常见原因：服务端未运行、PC 不在同一子网、防火墙阻止了端口（TCP 5001、5002、5003 和 UDP 5004），或连接密钥不匹配。详情请参阅故障排除。

HandyCafe 使用哪些端口？

TCP 5001（命令）、TCP 5002（文件传输）、TCP 5003（远程管理）、UDP 5004（屏幕传输）。这些端口可在网络设置中配置。

如何激活许可证？

在许可证面板中输入许可证密钥。服务端将与许可证服务器进行验证。初始激活需要互联网连接。请参阅授权许可。

服务端离线超过 72 小时会怎样？

HandyCafe 有 72 小时的离线宽限期。在此期间，所有功能正常运行。超过 72 小时未连接许可证服务器后，服务端进入锁定状态，直到恢复互联网连接。

时段与定价

如何在 PC 上开始时段？

在管理面板中，选择一台空闲 PC（青色）并点击卡片上的开始。选择后付费或预付费模式，可选分配会员，如为预付费则设置时长/金额，选择支付方式，确认即可。请参阅时段管理。

预付费和后付费时段有什么区别？

后付费模式下，顾客根据实际使用时间在结束时付款。预付费模式下，顾客预先支付固定时长或金额。预付费支持两种子模式：购买时锁定（费用在开始时冻结）和实时排期（费用随时段变化调整）。请参阅时段管理。

定价排期如何工作？

定价排期是一个 7 天 x 24 小时的网格，每个时间块分配一个带颜色的定价档位。每个档位有一个倍率（如 1.0x 标准、1.5x 高峰、0.5x 低谷）。时段费用计算方式为：基础小时费率 x 档位倍率 x 时长。请参阅时段定价。

如何设置工作日和周末不同的价格？

在"设置 > 定价排期"中，创建具有不同倍率的定价档位（如"工作日"1.0x、"周末"1.3x）。在网格中用周末档位颜色涂抹周末列，用工作日档位颜色涂抹工作日列。请参阅定价排期设置。

如何暂停和恢复时段？

点击在线 PC 卡片上的暂停。计费在暂停期间停止。恢复时，点击已暂停 PC 卡片上的恢复。恢复时开始新的定价段。请参阅时段管理。

如何为活跃时段追加时间？

点击在线 PC 卡片上的追加时间。输入要追加的分钟数（正数延长，负数缩短）。系统为此调整创建交易记录。

时段跨越多个定价档位时怎么处理？

时段在档位边界处自动分段。每个分段使用该时段内有效的倍率。总费用为所有分段费用之和。请参阅时段定价。

什么是起步费？

起步费是每个时段的最低收费。即使时段很短，顾客也至少需要支付这个金额。在定价设置中配置。

会员与忠诚度

如何创建新会员？

导航到会员页面，点击添加会员。输入用户名、显示名称、可选的邮箱、电话等信息。如适用，分配等级。请参阅会员管理。

钱包系统如何工作？

每位会员有一个钱包余额。充值时创建一笔钱包余额，包含特定金额和余额类型（付费、赠送、手动等）。时段期间自动消耗钱包余额。余额可以设置过期日期和设备限制。请参阅会员钱包。

什么是钱包余额条目？

钱包余额条目是单次充值创建的离散余额记录。每条记录追踪自身的金额、类型（付费、赠送、手动）、状态（活跃、过期、已消费）和适用设备限制。余额按顺序消费（先进先出）。请参阅会员钱包。

忠诚等级和积分如何工作？

会员通过消费、到店、充值、下单等活动获得积分。每个等级有积分门槛。当会员积累足够积分时，晋升到下一等级。更高等级可享受更好的折扣。请参阅会员等级。

如何给会员钱包充值？

在会员页面选择会员，点击支付/充值选项，输入金额，选择余额类型和支付方式，确认即可。系统创建新的钱包余额条目。请参阅会员钱包。

会员可以同时在 PC 和主机上使用钱包余额吗？

取决于余额的设备限制。余额可以限制为"仅 PC"、"仅主机"或"两者皆可"。购买套餐时，设备限制由套餐配置定义。请参阅套餐。

钱包余额过期后会怎样？

余额到达过期日期后，状态变为"已过期"，剩余金额不再可用。过期金额记录在会员的交易历史中。

如何查看会员的交易历史？

在会员页面选择会员。会员详情面板显示交易账簿，包含所有充值、消费、退款和调整的时间戳和金额。

商品、订单与库存

如何向商品目录添加商品？

导航到商品页面，点击添加商品。输入名称、分类、单位、条码、售价、成本价和增值税率。切换启用/停用状态。请参阅商品管理。

如何为顾客创建订单？

导航到订单页面，点击新建订单，可选分配到某台 PC 或添加备注，从商品目录中添加商品和数量，然后选择支付方式关闭订单。请参阅订单管理。

如何取消或退款订单？

打开订单页面中的订单，点击取消。订单作废且不记录付款。对已关闭订单的退款，请使用相应的退款流程。

库存追踪如何工作？

每件商品有库存数量。库存日志追踪变动及原因：销售（订单关闭时自动扣减）、采购（来自库存条目）、调整、报废和退货。请参阅商品管理和库存。

促销活动与套餐

如何创建促销活动？

导航到活动页面，点击添加活动。输入名称、描述，设为活跃状态，如需要则设置过期日期。然后向活动添加套餐。请参阅促销活动。

时间类套餐和金额类套餐有什么区别？

时间类套餐给予会员可用于时段的分钟数。金额类套餐向会员钱包充入资金。两者都可以包含赠送额度。请参阅套餐。

套餐中的赠送系统如何工作？

套餐可以在基础权益之上包含赠送。例如，套餐可以提供"60 分钟 + 15 分钟赠送"或"10 元 + 2 元赠送"。赠送会创建一条标记为"赠送"类型的单独余额条目。

套餐的设备限制如何工作？

每个套餐定义设备限制：仅客户端（PC）、仅主机、或两者皆可。购买套餐时，创建的钱包/时间余额继承此限制，只能在匹配的设备类型上使用。

收银员管理

如何创建收银员账户？

导航到"管理 > 收银员"。点击"添加收银员"，输入用户名和密码，分配角色。收银员即可使用这些凭证登录。请参阅收银员角色。

如何设置收银员角色的权限？

导航到"管理 > 收银员角色"。创建新角色或编辑现有角色。在 6 个类别（身份验证、会员、主机、日志、报表、支付方式）中逐一勾选或取消勾选权限标志。请参阅收银员角色。

6 个权限类别是什么？

身份验证（1 个标志）、会员（6 个标志：查看、添加、删除、修改、显示邮箱、显示电话）、主机（4 个标志：查看、添加、删除、修改）、日志（4 个标志：查看、完整历史、仅今日、删除）、报表（3 个标志：查看、完整历史、仅今日）、支付方式（4 个标志：管理、添加、删除、修改）。总计 22 个独立权限标志。

收银员登录的暴力破解防护如何工作？

10 分钟内 5 次失败登录尝试后，账户锁定 15 分钟。所有失败尝试都记录在审计日志中并触发安全警报。

如何查看收银员的班次报表？

打开财务报表页面。按收银员名称筛选，查看特定收银员在班次内处理的交易。班次摘要显示总计和按支付方式的明细。

设置与配置

如何更改语言？

导航到"设置 > 常规"，从下拉菜单中选择语言。HandyCafe 支持 24 种语言。界面立即更新。请参阅常规设置。

如何设置 Google OAuth 登录？

导航到"设置 > OAuth"。全局启用 OAuth，然后启用 Google。输入您的 Google Client ID 和 Client Secret（来自 Google Cloud 控制台）。可选导入 JSON 凭证文件。从客户端 PC 发起 OAuth 登录进行测试。请参阅OAuth 设置。

如何配置定价排期网格？

导航到"设置 > 定价排期"。启用排期，创建带倍率的彩色档位，然后在 7x24 小时网格上点击/拖动以所需档位涂抹时间块。请参阅定价排期设置。

如何自定义客户端待机画面？

导航到"设置 > 客户端 > 待机画面"标签页。启用幻灯片，添加图片或视频，设置持续时间和转场效果。可选启用时钟和网吧名称叠加层。请参阅客户端待机画面。

如何更改客户端外观主题？

导航到"设置 > 客户端 > 外观"标签页。选择主题（Neon Arena、Crimson Pulse、Emerald Depth），选择布局预设，配置背景、卡片密度和效果。请参阅客户端外观。

如何设置声音通知？

导航到"设置 > 声音"。启用总声音开关，然后为每个事件（呼叫收银员、新订单、时段结束、登录请求）从 15 个内置选项中选择声音。请参阅声音设置。

什么是连接密钥？为什么重要？

连接密钥是服务端和客户端之间用于加密身份验证的共享密钥。它防止未授权的设备连接到您的服务端。所有客户端必须使用与服务端相同的密钥。在网络设置中配置。

远程管理

如何远程截取客户端 PC 的屏幕？

在管理面板中选择客户端，点击卡片上的截图。截图查看器显示捕获的图像。可以刷新获取新截图或下载图像。请参阅截图。

如何使用远程桌面控制客户端 PC？

选择客户端卡片，点击远程桌面。打开一个带有实时 H.264 视频流的窗口。您可以远程控制鼠标和键盘，剪贴板同步功能在服务端和客户端之间工作。请参阅远程桌面。

文件同步系统如何工作？

在"设置 > 同步资源管理器"中配置要同步的目录。触发时，服务端创建文件清单。客户端将清单与本地文件比较，仅下载已更改或新增的文件，使用分块传输。请参阅文件同步。

如何查看客户端 PC 上正在运行的应用？

在管理面板中选择客户端，点击卡片上的运行中的应用。面板显示所有当前运行的进程名称和详情。同一操作按钮还可查看开机启动应用、已安装应用和窗口化应用。

如何向客户端 PC 发送消息？

选择客户端卡片，点击发送消息。输入消息内容并确认。消息将显示在顾客的屏幕上。

如何远程关闭或重启客户端 PC？

选择客户端卡片，点击关机或重启。也可以多选客户端进行批量操作。对于支持网络唤醒的离线 PC，可使用 Wake on LAN 功能开机。

报表与分析

如何查看财务报表？

从侧边栏导航到财务报表。报表显示摘要卡片、交易历史、设备收益和图表。使用日期筛选缩小时间范围。请参阅财务报表。

如何导出报表数据？

在财务报表中，使用导出/复制功能将交易数据以 CSV 格式复制到剪贴板。然后可以粘贴到 Excel 或任何电子表格应用中。

统计页面提供哪些分析？

九个分析标签页：营收趋势、销售分析、支出追踪、时段统计、主机利用率、应用使用率、电脑使用率、会员活跃度和收银员绩效。请参阅统计。

如何查看电脑使用率？

导航到"统计 > 电脑使用"标签页。显示每台 PC 的使用率百分比、运行时间和单机收入。还可识别最繁忙的 PC。请参阅时段与电脑统计。

故障排除

客户端显示"离线"但 PC 已开机，怎么办？

请检查：1）HandyCafe Client 在 PC 上正在运行；2）两台 PC 在同一网络/子网上；3）防火墙允许 TCP 端口 5001-5003；4）服务端和客户端的连接密钥一致。请参阅故障排除。

时段定价似乎不正确，如何验证？

检查定价设置（设置 > 定价）中的基础小时费率和增值税。检查定价排期（设置 > 定价排期）中时段发生时的活跃倍率。在交易详情中查看时段的定价分段，了解每段的计算方式。

OAuth 登录一直停留在"待处理"状态，如何解决？

确保管理员已在请求页面批准请求。如果请求卡住，请检查：1）OAuth 提供商凭证在"设置 > OAuth"中是否正确；2）服务端是否有互联网连接可访问提供商 API；3）设备码是否已过期（通常 15-30 分钟过期）。

远程桌面卡顿，如何改善？

降低流设置中的比特率（局域网建议 1000-2000 kbps）。检查服务端与客户端之间的网络带宽。确保 UDP 端口 5004 未被阻止。使用有线以太网代替 Wi-Fi 可获得最佳效果。

许可证显示"over_limit"是什么意思？

连接的客户端 PC 数量超过了许可证允许的上限。断开未使用的客户端或升级许可证。在已连接客户端数量达到或低于限制之前，服务端不会开始新时段。

收银员因多次登录失败被锁定，如何解锁？

等待 15 分钟让自动锁定到期。如果紧急，管理员可通过管理界面处理收银员账户。