城南小馆点餐 App（安卓端）v1.10.23 下载：服务员手机就是点菜宝

餐厅里最影响翻台率的，往往不是菜好不好吃，而是服务员能不能第一时间把单子送进后厨。传统点菜宝要专门买手持机、要配基站；用纸质单子，字认不清就漏单、退菜改单全凭嘴传。

这个「城南小馆点餐 App」就是把这个环节搬到服务员自己的手机上：开台、点单、按份退菜、换台、打小票，一部手机全干完。它需要配合同系列的 Windows 服务端一起用（服务端下载在这里）。

一、手机上能干什么

• 手机点单：菜品按分类 Tab 排布（分类完全跟随服务端设置，后台改分类手机自动同步），选好进购物车，一键下单；
• 餐台状态：每桌是空闲、占用还是已被预订，一屏看全，红绿一眼分辨；
• 按份退菜：点开某桌的订单明细，用步进器选退几份，总额自动重算，不会出现"退了菜金额还挂着"的情况；
• 换台 / 清台：客人换桌、吃完结账，一键完成，餐台状态立即刷新；
• 手机打小票：直接把厨房单或前台结账单发给服务端的热敏小票机出纸，手机本身不用连打印机；
• 预订管理：月历视图看每天有几桌预订（红点 + 角标），当天列表按状态出按钮，客人到店一键确认排台；
• 新预订通知：顾客在线上订台，手机后台立刻收到推送提醒，不怕漏单（Android 13 以上首次会申请通知权限）；
• 追加菜品：同一桌客人加菜，直接在该桌订单上继续加，不用重新开台。

二、下载

文件校验（SHA256）：E9CC8E9121D0EBCAF9DAFEF2DB0794CE306084A41C35C7CC94B1C5CF7B254200

这是已签名的 release 包（作者 DavidQin），安装包只有 3.13 MB，老手机也装得下。后续版本升级请使用同一签名安装包，直接覆盖安装即可，不会丢数据。

三、安装与首次连接

1. 安装：下载 APK 后点击安装。因为不是应用市场分发，系统会提示"来自未知来源"，允许一次即可；
2. 找服务端：首次打开会进设置向导，点「自动搜索」——App 会在局域网内广播探测，自动找到同一网络里运行着的服务端并填入地址；
3. 手动填也行：搜不到就手动输入，格式像 192.168.1.100:5000（就是运行服务端那台电脑的局域网 IP + 5000 端口）；
4. 开始用：连上之后首页就是餐台列表，点桌子即可开台点单。

小提示：服务端所在电脑的 IP 建议在路由器里做一下静态绑定，免得电脑换了 IP 手机连不上；手机和服务端必须在同一个局域网内。

四、和 Windows 服务端怎么配合

• 数据同源：手机上的订单、餐台状态、菜品价格，全部来自服务端，手机只做展示和操作，不怕两端数据打架；
• 实时同步：一边手机下单，收银机和后厨看板同步刷新；
• 打印走服务端：小票机只有服务端连，手机发指令即可，省得每台手机配一遍打印机；
• 多台手机同时用：几个服务员各拿一台手机同时操作，互不冲突。

五、常见问题

• 搜不到服务端？先确认手机和电脑连的是同一个 Wi-Fi（别一个连 5G 一个连 2.4G 的不同网段），再确认电脑上服务端已经启动、且 Windows 防火墙放行了 5000 端口和 UDP 探测端口。也可以直接手动填 IP。
• 提示连不上/闪退？App 里所有网络请求都做了异常捕获，连不上会给出提示而不是闪退；如果页面空白，通常是地址填错或服务端没起。
• 会不会把我的数据传到网上？不会。App 只和店里那台服务端通信，走的是局域网。
• 换手机了怎么办？重新装一次、重新连一次服务端即可，所有数据都在服务端，不在手机里。

六、版本记录

• v1.10.23：餐台操作弹窗按钮重排（退菜移到追加菜品下方，操作更顺手）；
• v1.10.22：退菜弹窗的确认按钮改为描边样式，与取消按钮视觉统一；
• v1.10.21：修复餐台操作弹窗菜品较多时底部按钮被挤出屏幕的问题（明细改为限高内部滚动）；
• v1.10.20：修复退菜弹窗菜品多时「提交」按钮被裁掉的问题；
• v1.10.19：退菜列表按有效份数显示，月历同步网页端口径（仅当天及以后可点）；
• v1.10.18：新增按份退菜功能；
• v1.10.15：新增预订月历视图、到店确认与新预订后台通知。

有想加的功能或遇到问题，欢迎评论区留言。

—— DavidQin