常见问题解答
设置与安装
HandyCafe 支持哪些类型的业务？
HandyCafe 专为网吧、游戏中心、电竞馆、网络咖啡厅和 PC bang 设计。任何提供 PC 或游戏机计时使用的业务都可以使用 HandyCafe 来管理会话、计费和会员。
HandyCafe 服务器的系统要求是什么？
服务器需要 Windows 10 或更高版本（64 位），至少 4 GB 内存，500 MB 磁盘空间和本地网络连接。客户端 PC 需要 Windows 10 或更高版本，2 GB 内存。所有 PC 必须在同一局域网内。查看 系统要求 以获取完整详情。
如何安装 HandyCafe 服务器？
从官方网站下载安装程序，运行并按照提示进行操作。首次启动时，首次设置向导会创建您的管理员账户。查看 服务器安装 以获取分步说明。
如何将客户端 PC 连接到服务器？
在 PC 上安装 HandyCafe 客户端。它使用 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 天 24 小时的网格，每个时间块分配到一个颜色编码的定价槽。每个槽都有一个乘数（例如，1.0x 标准，1.5x 高峰，0.5x 非高峰）。会话费用计算为：基础小时费率乘以槽的乘数再乘以时长。查看 会话定价。
如何为周末和工作日设置不同的价格？
在设置 > 定价计划中，创建具有不同乘数的定价槽（例如，“工作日”1.0x，“周末”1.3x）。用周末槽颜色涂抹周末列，用工作日槽颜色涂抹工作日列。查看 定价计划设置。
如何暂停和恢复会话？
点击在线 PC 卡片上的 暂停。暂停时计费停止。要恢复，点击暂停 PC 卡片上的 恢复。恢复时开始一个新的定价段。查看 会话。
如何为活动会话添加额外时间？
点击在线 PC 卡片上的 添加时间。输入要添加的分钟数（正数为延长，负数为减少）。调整会创建一条交易记录。
当会话跨越多个定价槽时会发生什么？
会话会在槽边界自动分段。每个段使用该期间活动的乘数。总费用是所有段费用的总和。查看 会话定价。
什么是启动费？
启动费是每个会话应用的最低收费。即使会话时间很短，客户也至少会被收取此金额。在 定价设置 中配置。
会员与忠诚度
如何创建新会员？
导航到会员页面并点击 添加会员。输入用户名、显示名、可选的电子邮件、电话和其他详细信息。如适用，分配一个等级。查看 会员。
钱包系统如何运作？
每个会员都有一个钱包余额。当您充值钱包时，会创建一个具有特定金额和信用类型（付费、奖励、手动等）的 钱包信用。在会话期间，钱包会自动消耗。信用可以有到期日期和设备限制。查看 会员钱包。
什么是钱包信用？
钱包信用是通过单次充值创建的钱包余额的离散条目。每个信用跟踪其自身的金额、信用类型（付费、奖励、手动）、状态（活动、过期、已消耗）和设备限制。信用按顺序消耗（最早的优先）。查看 会员钱包。
忠诚度等级和积分如何运作？
会员通过活动（消费、访问、充值、订单）赚取积分。每个等级都有一个积分门槛。当会员积累足够的积分时，他们晋升到下一个等级。更高的等级可以享有更好的折扣率。查看 忠诚度等级。
如何为会员的钱包充值？
在会员页面选择会员，点击支付/充值选项，输入金额，选择信用类型和支付方式并确认。会创建一个新的钱包信用。查看 会员钱包。
会员可以同时在 PC 和游戏机上使用他们的钱包余额吗？
这取决于信用的设备限制。信用可以限制为“仅限 PC”、“仅限游戏机”或“两者皆可”。购买套餐时，设备限制由套餐配置定义。查看 套餐。
当钱包信用过期时会发生什么？
当信用达到其到期日期时，其状态变为“过期”，剩余余额不再可用。过期金额记录在会员的交易历史中。
如何查看会员的交易历史？
在会员页面选择会员。会员详细信息面板显示交易账簿，包含所有钱包充值、消费、退款和调整的时间戳和金额。
产品、订单与库存
如何将产品添加到目录？
导航到产品并点击 添加产品。输入名称、类别、单位、条形码、销售价格、成本价格和增值税率。切换激活/停用。查看 产品。
如何为客户创建订单？
导航到订单，点击 新订单，可选分配到 PC 或添加备注，从产品目录中添加商品及数量，然后使用支付方式关闭订单。查看 订单。
如何取消或退款订单？
从订单页面打开订单并点击 取消。订单被作废且未记录付款。对于已关闭订单的退款，请使用适当的退款流程。
库存跟踪如何运作？
每个产品都有一个库存水平。库存日志跟踪变更及原因：销售（订单关闭时自动减少）、采购（来自库存条目）、调整、损耗和退货。查看 产品 和 库存。
活动与套餐
如何创建活动？
导航到活动并点击 添加活动。输入名称、描述，设置为活动状态，并配置到期日期（如适用）。然后将套餐添加到活动中。查看 活动。
基于分钟和基于金额的套餐有什么区别？
基于分钟的套餐为会员提供可用于会话的时间（分钟）。基于金额的套餐将资金添加到会员的钱包中。两者都可以包含奖励金额。查看 套餐。
套餐中的奖励系统如何运作？
套餐可以在基础权益之上包含奖励。例如，套餐可能提供“60 分钟 + 15 分钟奖励”或“$10 + $2 奖励”。奖励创建一个标记为“奖励”信用类型的单独信用条目。
套餐的设备限制如何运作？
每个套餐定义一个设备限制：客户端（PC）、游戏机（游戏机）、两者皆可、仅限 PC 或仅限游戏机。购买套餐时，创建的钱包/时间信用继承此限制，并只能用于匹配的设备类型。
收银员管理
如何创建收银员账户？
导航到管理 > 收银员。点击添加收银员，输入用户名和密码，并分配角色。收银员可以使用这些凭据登录。查看 收银员角色。
如何为收银员角色设置权限？
导航到管理 > 收银员角色。创建新角色或编辑现有角色。在 6 个类别（身份验证、会员、游戏机、日志、报告、支付方式）中勾选或取消勾选各个权限标志。查看 收银员角色。
6 个权限类别是什么？
身份验证（1 个标志），会员（6 个标志：查看、添加、删除、更新、显示电子邮件、显示电话），游戏机（4 个标志：查看、添加、删除、更新），日志（4 个标志：查看、完整历史、仅限今天、删除），报告（3 个标志：查看、完整历史、仅限今天），支付方式（4 个标志：管理、添加、删除、更新）。总计：22 个单独的权限标志。
收银员登录的暴力破解保护如何运作？
在 10 分钟内 5 次登录失败后，账户将被锁定 15 分钟。所有失败的尝试都会记录在审计日志中，并发出安全警报。
如何查看收银员班次报告？
打开现金报告页面。按收银员姓名过滤以查看特定收银员在其班次期间处理的交易。班次摘要显示总计和按支付方式的细分。
设置与配置
如何更改语言？
导航到设置 > 常规，从下拉菜单中选择您的语言。HandyCafe 支持 24 种语言。界面会立即更新。查看 常规设置。
如何设置 Google OAuth 登录？
导航到设置 > OAuth。全局启用 OAuth，然后启用 Google。输入您的 Google 客户端 ID 和客户端密钥（来自 Google Cloud Console）。可选导入 JSON 凭据文件。通过从客户端 PC 发起 OAuth 登录进行测试。查看 OAuth 设置。
如何配置定价计划网格？
导航到设置 > 定价计划。启用计划，创建颜色编码的槽并设置乘数，然后在 7x24 小时网格上点击/拖动以用所需槽涂抹时间块。查看 定价计划设置。
如何自定义客户端空闲屏幕？
导航到设置 > 客户端 > 空闲屏幕选项卡。启用幻灯片，添加图片或视频，设置持续时间和过渡。可选启用时钟和咖啡厅名称覆盖。查看 客户端空闲屏幕。
如何更改客户端外观主题？
导航到设置 > 客户端 > 外观选项卡。选择一个主题（Neon Arena, Crimson Pulse, Emerald Depth），选择布局预设，并配置背景、卡片密度和效果。查看 客户端外观。
如何设置声音通知？
导航到设置 > 声音。启用主声音开关，然后为每个事件（呼叫收银员、新订单、会话结束、登录请求）从 15 个内置选项中选择一个声音。查看 声音设置。
什么是连接密钥，为什么它很重要？
连接密钥是用于服务器和客户端之间加密认证的共享密钥。它可以防止未经授权的设备连接到您的服务器。所有客户端必须使用与服务器相同的密钥。在 网络设置 中配置。
远程管理
如何远程截取客户端 PC 的屏幕截图？
在管理面板中选择客户端并点击卡片上的 截图。截图查看器显示捕获的图像。您可以刷新以获取新截图或下载图像。查看 截图。
如何使用远程桌面控制客户端 PC？
选择客户端卡片并点击 远程桌面。一个窗口打开，显示实时 H.264 视频流。您可以远程控制鼠标和键盘，并且剪贴板同步在服务器和客户端之间有效。查看 远程桌面。
文件同步系统如何运作？
在设置 > 同步资源管理器中配置要同步的目录。触发时，服务器创建一个文件清单。客户端将清单与本地文件进行比较，仅下载更改或新文件，使用基于块的传输。查看 文件同步。
如何查看客户端 PC 上正在运行的应用程序？
在管理面板中选择客户端并点击卡片上的 运行的应用程序。一个面板显示所有当前运行的进程及其名称和详细信息。您还可以从相同的操作按钮查看 启动应用程序、已安装应用程序 和 窗口应用程序。
如何向客户端 PC 发送消息？
选择客户端卡片并点击 发送消息。输入您的消息并确认。消息会显示在客户的屏幕上。
如何远程关闭或重启客户端 PC？
选择客户端卡片并点击 关机 或 重启。您还可以多选客户端进行批量操作。支持的离线 PC 可以使用局域网唤醒功能。
报告与分析
如何查看现金报告？
从侧边栏导航到 现金报告。报告显示摘要卡片、交易历史、设备收入和图表。使用日期过滤器缩小时间范围。查看 现金报告。
如何导出报告数据？
在现金报告中，使用导出/复制功能将交易数据以 CSV 格式复制到剪贴板。然后您可以将其粘贴到 Excel 或任何电子表格应用程序中。
统计页面中有哪些分析？
九个分析标签：收入趋势、销售分析、费用跟踪、会话统计、游戏机利用率、应用程序使用、计算机使用率、会员活动和收银员表现。查看 统计。
如何检查计算机利用率？
导航到统计 > 计算机使用标签。这显示每台 PC 的利用率百分比、正常运行时间和每台机器的收入。它还识别出您最繁忙的 PC。查看 会话与计算机统计。
故障排除
客户端显示“离线”但 PC 是开着的。我该怎么办？
检查：1）HandyCafe 客户端在 PC 上运行，2）两台 PC 在同一网络/子网，3）防火墙允许 TCP 端口 5001-5003，4）连接密钥在服务器和客户端之间匹配。查看 故障排除。
会话定价似乎不正确。我该如何验证？
检查定价设置（设置 > 定价）中的基础小时费率和增值税。检查定价计划（设置 > 定价计划）中会话时间的活动乘数。查看交易详情中的会话定价段以了解每个段是如何计算的。
OAuth 登录卡在“待处理”状态。我该如何解决？
确保管理员已在请求页面上批准请求。如果请求卡住，请检查：1）OAuth 提供商凭据在设置 > OAuth 中是否正确，2）服务器是否有互联网访问权限以访问提供商的 API，3）设备代码是否未过期（通常在 15-30 分钟内过期）。
远程桌面延迟。我该如何提高性能？
在流设置中降低比特率（尝试 1000-2000 kbps 用于局域网）。检查服务器和客户端之间的网络带宽。确保 UDP 端口 5004 未被阻止。使用有线以太网而不是 WiFi 以获得最佳效果。
我的许可证显示“超出限制”。这是什么意思？
连接的客户端 PC 超过了您的许可证允许的数量。断开未使用的客户端或升级您的许可证。服务器将不会启动新的会话，直到连接的客户端数量达到或低于限制。
收银员因多次登录失败被锁定。我该如何解锁？
等待 15 分钟，自动锁定将过期。如果紧急，管理员可以通过管理界面管理收银员账户。
餐饮服务
客户如何从他们的桌子下订单？
他们用手机扫描桌子上的二维码，输入员工提供的 6 位安全代码，浏览菜单，选择语言，添加商品到购物车，并通过现金或在线（Stripe）支付提交订单。订单会在 3 秒内出现在您的餐饮服务订单仪表板上。查看 客户菜单。
如何启用餐饮服务模块？
打开设置 > 餐饮服务并切换启用餐饮服务。服务器会自动使用您的 HandyCafe 许可证进行授权。配置向导会询问您的 slug、显示名称、国家、货币和时区。查看 餐饮服务概述 和 如何设置餐饮服务。
客户菜单支持哪些语言？
handy.cafe/{slug} 上的客户菜单支持 24 种语言。首次访问时会根据浏览器的 Accept-Language 头选择最佳匹配。客户可以随时使用顶部的选择器切换语言。
餐饮服务可以在没有互联网的情况下工作吗？
不可以。餐饮服务是云优先的。配置、菜单同步和订单轮询都需要外部互联网访问。面向客户的页面由云提供，不依赖于您的本地服务器可以从互联网访问。
旧版客户端
HandyCafe 支持我的旧版 V3 或 V4 客户端吗？
支持。在设置 > 旧版客户端中启用运行时支持，服务器将在原始旧版端口（UDP 710/711、TCP 712、文件传输 717）上启动监听。您的现有客户端无需任何更改即可连接。它们在管理面板中显示的操作集减少（登录、注销、添加时间、截图、注销、重启、关机）。查看 旧版客户端。
旧版和现代客户端可以同时在同一服务器上运行吗？
可以。两个协议栈使用不同的端口，不会冲突。您可以在同一局域网上混合使用旧版和新版客户端，并从同一管理面板进行管理。
我可以从旧的 HandyCafe 安装中导入数据吗？
可以，在 Windows 上。打开设置 > 旧版客户端，滚动到数据库迁移并点击开始迁移。会员、定价、产品、订单、交易和日志将被导入。原始文件不会被修改或删除。如果结果不符合预期，点击撤销迁移以回滚。查看 如何从旧版安装迁移。
STE 和标准协议变体有什么区别？
STE（智能/涡轮版）帧包括一个 70 字节的许可证信息前缀；帧大小为 1337 字节。标准帧省略前缀；帧大小为 1267 字节。选择与您的旧版服务器构建方式匹配的变体。选择错误的变体会导致帧丢失或误读。