许可
HandyCafe 正式版在进行本地服务器设置或员工登录之前，需要一个经过验证的 HandyCafe 账户。您的方案决定了服务器接受的客户端 PC 与主机同时连接数量，同时也决定了方案专属功能的访问权限。
许可激活
- 启动 HandyCafe 服务器。
- HandyCafe 检查本服务器上是否已激活账户许可证。
- 若不存在已激活的账户许可证，请在登录界面输入您的邮箱和密码。
- 需要创建账户时，请选择免费创建一个。您只需输入邮箱地址。
- 打开邮件中的安全注册链接。在浏览器中设置密码并完成注册。
- 返回 HandyCafe 服务器，用新账户登录。
- HandyCafe 为该账户创建或选择网吧许可证，并在服务器上激活它。
- 如果服务器还没有管理员，请创建第一个本地管理员账户。否则将直接显示管理员或收银员登录界面。
新验证的账户会自动获得免费方案。系统内部仍会使用一个与方案无关的 HC- 许可证密钥。该密钥不包含当前方案名称，方案变更时它作为身份标识保持不变。正式版用户无需输入或复制该密钥。
正式版不再提供试用方案。如果较早的安装中仍保留着已签名的试用记录，HandyCafe 会保留经过验证的账户激活状态，并在云端迁移完成前将其显示为免费版。应用不会在每次启动时再次索要账户密码。
账户激活界面是正式版的第一个必经步骤。在账户激活成功之前，本地首次设置向导以及管理员或收银员登录界面都不会加载。正式版的账户界面无法通过演示预览跳过。
在密码输入框下方选择**忘记密码？**即可申请重置链接。无论提交什么内容，HandyCafe 始终显示相同的确认信息。这样界面就不会泄露该邮箱是否已注册。
免费方案
免费方案永不过期。它需要可用的互联网连接，并包含以下限额：
| 功能 | 免费方案的行为 |
|---|---|
| 客户端 PC | 最多 2 个同时连接 |
| 主机 | 最多 2 个同时连接 |
| 员工 | 1 位老板和 1 位启用的收银员。自定义角色和经理角色不可用。 |
| 远程桌面 | 每个 UTC 日 2 次会话。同一时间只能进行一次会话。3 分钟内重新连接视为同一次会话。 |
| 截图 | 每个 UTC 日 2 张新截图，全屏、窗口和移动端截取方式合并计算 |
| 会员 | 无限制 |
| 单张入场券 | 无限制 |
| 批量入场券 | 批量创建、导入和打印需要 Genesis |
| 报表 | 标准报表可用。高级报表生成器需要 Genesis。 |
| 数据库安全 | 可使用本地备份、导出、恢复和完整性检查 |
| 数据库维护 | 清理、分析、优化、计划维护和旧日志清理需要 Genesis |
| 客户端 QR 码 | 在待机界面和在线界面上始终可见 |
免费方案处于活动状态时，HandyCafe 会在顶栏显示免费版。应用启动时会出现一次可关闭的免费版卡片。关于页面同样会标明免费版及其 2 台 PC 和 2 台活动主机的限额，不显示试用倒计时或到期日期。
免费方案要求始终保持通过身份验证的 HandyCafe 云端实时连接。服务器每 30 秒发送一次 WebSocket 心跳。连续三个心跳窗口丢失，约 90 秒，会停止运营使用。已有的 PC 和主机会话将关闭。新会话、远程桌面、截图和其他写入操作会一直被阻止，直到通过身份验证的实时连接重新建立。
已签名的 10 分钟在线租约是第二道验证防线。仅恢复一般的互联网访问并不够。必须重新建立通过身份验证的云端实时连接，且已签名的租约仍需有效。在运营使用被锁定期间，许可和购买控件、日志、本地备份、导出和恢复工具仍可访问。
每日远程桌面和截图限额以云端记录为准。截取失败不会消耗配额。打开或保存已有截图也不会消耗配额。付费 Genesis 方案的本地远程桌面和截图不受限制。
付费方案到期、被取消或付款失败时，网吧会转为免费方案，而不会失去对自身记录的访问权限。超出免费限额的连接和主机会话会立即停止。被撤销或因安全原因停用的许可证会关闭所有客户端和主机的访问。
固定期限 Genesis 方案
Genesis 方案可以按固定期限直接分配给某家网吧，无需周期性付款订阅。HandyCafe 控制面板会在控制面板、我的方案和结算中把它显示为该网吧的当前方案，并显示固定的结束日期，而不是续订日期。
固定期限方案没有自动续订，也没有 Stripe 取消流程。该方案下，订阅取消、重新激活以及自助更换方案的控件均不可用。如果需要在结束日期之前更改已分配的方案，请联系 HandyCafe 支持团队。
旧版年度方案的过渡
2026 年 7 月 1 日之前购买的、仍在有效期内的 Legacy 年度订阅可以转入 Genesis，且不会损失已付费的 Legacy 期限。HandyCafe 会先核实 Legacy 付款成功，然后才提供过渡选项。仅有已存储的价格或订阅标识符不能作为付款凭证。HandyCafe 会选择能够覆盖 Legacy 客户端上限的最小 Genesis 套餐。Genesis 访问权限立即开通，其包含的访问期限在现有 Legacy 期限结束的时间点终止。
打开我的方案，找到符合条件的 Legacy 许可证。选择转入 Genesis 并核对确认信息。确认界面显示今日扣费为零，同时显示确切的 Genesis 年费金额和首次付款日期。Stripe 会验证并保存银行卡。随后 HandyCafe 会安排新的 Genesis 年度订阅在已付费的 Legacy 期限结束时开始。此过渡不会创建试用期。
只有在成功创建未来的 Genesis 订阅排期之后，现有的 Legacy 续订才会被停用。设置失败时会恢复此前的 Legacy 续订设置。HandyCafe 还会在允许再次结账之前对中断的设置进行核对。这样可以避免出现计费空档、看不见的未来扣费或两项同时生效的续订。
选择取消已安排的续订可停止未来的 Genesis 扣费。包含的 Genesis 访问权限会持续到已付费的 Legacy 结束日期。该日期之后，网吧转为免费方案。首次 Genesis 付款失败同样会使网吧转为免费方案。记录在免费方案的限额下仍然可用。
通过 PayPal 续订的 Legacy 订阅需要支持团队协助才能过渡，无法自助完成。在现有 PayPal 续订可能仍然有效时，HandyCafe 不会安排第二笔周期性扣费。
账户设置
打开设置，然后选择账户，即可管理与服务器关联的 HandyCafe 账户。页面显示联系人及邮箱、网吧、国家/地区、当前方案、PC 配额、活动主机配额以及联网要求。已生效的云端和咖啡厅套餐会在方案下方的附加组件区块中显示为独立卡片。选择控制面板可在系统浏览器中打开关联的 HandyCafe 控制面板。
对于自动续订的 Stripe 订阅，页面把实际的计费周期分界点标注为续订日期。如果自动续订未启用，页面会说明续订未启用，并改为显示许可证的访问结束日期。访问结束日期可能晚于计费周期分界点，因为 HandyCafe 为延迟到达的付款 webhook 预留了一小段核对缓冲时间。由管理员授予的云端或咖啡厅访问权限会显示为已生效的套餐，而不会虚构一个续订日期。
选择刷新可请求最新的已签名账户和方案状态。选择升级到 Genesis 或管理方案可打开现有的方案选择和安全结账流程。
只有本地管理员收银员可以选择退出登录。HandyCafe 会在从服务器移除该账户之前请求确认。退出登录会断开云端实时连接和咖啡厅中继、清除共享的云端凭据，并使服务器返回必经的 HandyCafe 账户登录界面。当本地管理员无法登录时，仍可从拦截性的恢复界面清除损坏或处于只读状态的许可证。
许可状态
| 状态 | 描述 |
|---|---|
| missing_key | 未输入许可证密钥 |
| inactive | 已输入密钥但尚未验证 |
| active | 许可证有效且可正常使用 |
| offline_grace | 付费服务器无法连接许可服务，但仍处于所配置的宽限期内 |
| offline_locked | 宽限期已过期。服务器被锁定，直到恢复连接。 |
| online_required | 免费方案近期没有通过身份验证的云端实时连接心跳，或无法续期其已签名的在线租约 |
| expired | 许可证已过期 |
| revoked | 许可证已被许可机构撤销 |
| over_limit | 连接的客户端超过许可证允许的数量 |
PC 限制
您的许可证规定了可以同时连接的客户端 PC 与主机的最大数量。
- 达到上限时，新的客户端连接会被拒绝。
- 在免费方案下开始第三个主机会话会被拒绝，即使在启用免费方案之前注册过更多主机也是如此。
- 服务器会显示本地化的限额通知，不会暴露内部错误代码。
- 免费方案支持同时连接 2 台 PC 和 2 台主机。
如果您需要更多 PC，请通过 HandyCafe 网站升级您的许可证。
只读模式
当 PC 限制设置为 0（或许可证处于某些受限状态）时，服务器进入只读模式：
- 您可以查看所有数据和报表
- 您无法开始新的会话
- 您无法更改影响客户端运行的设置
- 管理面板会显示许可覆盖层，指出该项限制
联网与离线行为
付费方案使用所配置的离线宽限期，默认为 48 小时。如果服务器无法连接许可服务：
- 许可证进入 offline_grace 状态。
- 您需要在配置的宽限期截止时间之前恢复互联网连接。
- 在宽限期内，所有功能正常工作。
- 超过截止时间后，许可证进入 offline_locked 状态，服务器功能受限。
免费方案不使用付费方案的离线宽限期。它必须保持通过身份验证的云端实时连接。90 秒的心跳丢失窗口可以容忍短暂的网络抖动。已签名的 10 分钟在线租约提供第二道验证防线。
只有当响应带有与当前安装和当前请求绑定的有效 HandyCafe 签名时，HandyCafe 服务器才会接受云端许可状态。未签名、被篡改、过期、重放或来自其他安装的响应都会被拒绝。在收到有效响应之前，运营访问将保持锁定。
提示： 请确保您的服务器 PC 拥有稳定的互联网连接，并允许与 HandyCafe 云端之间的安全 WebSocket 流量。心跳占用的带宽极少。
许可覆盖层
许可覆盖层同时用于显示免费版的一次性启动摘要。出现许可问题时，同一个覆盖层会给出需要采取的操作。该覆盖层：
- 显示当前许可状态
- 显示 PC 限制
- 显示活动主机限制
- 提供解决问题的说明
- 在许可证需要处理时阻止运营使用