掌局桌面客户端在线更新说明（2026-10-26）

Windows 10/11 64 位：1.3.0-rc.19；Mac Apple Silicon：1.3.0-rc.19；Windows 7 SP1 32 位联网兼容版：1.3.0-win7.9。
首次升级可下载安装 EXE 按向导完成，或下载完整 ZIP，完整解压后运行 Zhangju.exe / Zhangju.app / ZhangjuWin7.exe，不能只复制 exe。
升级时保留原操作系统用户和应用数据目录；不要删除 %APPDATA%\VenueOps、%APPDATA%\VenueOps-Win7 或 Mac 对应 Application Support 目录。

后续升级：顶部“全部功能 → 客户端设置 → 版本与更新”，检查新版本 → 下载更新 → 重启安装。更新清单采用独立 Ed25519 签名，程序包按签名中的大小和 SHA-256 校验后解压安装。原程序有备份；新程序无法确认启动时尝试恢复旧程序。不要删除程序备份或本机营业资料。
存在待确认命令、待核对打印、尚未同步的离线营业或独占离线授权时，不能安装；先核对营业和打印状态。更新不自动重放收款、加单或打印。

正式平台地址：https://app.zhangju.com.cn。官网及客户端下载：https://zhangju.com.cn。原 IP:10001 测试入口已关闭，请在客户端设置中将平台地址改为 HTTPS 域名并关闭 HTTP 测试模式。
Win7 兼容版不提供离线营业。Windows 真机、Win7 32 位系统与真实打印设备尚须验收；Mac 仅提供 Apple Silicon 目标。
程序尚未完成商业签名和 Mac 公证。更新清单的数字签名不等于系统分发签名或公证；系统阻止运行时请联系客服，不要关闭系统保护。

客服电话：15858282338。
网页版仍从服务器发布，不需要更新客户端才能获得普通业务页面调整；桌面更新负责本机运行、打印与离线能力。

安装向导：Windows / Win7 的 setup.exe 完整内置程序，无需下载其他运行依赖；下一步选择安装目录，创建快捷方式。当前用户安装不要求管理员权限。已有客户端需先退出，勿重复开户；安装和卸载保留原用户数据。免安装便携 ZIP 仍可下载。
顶部传统菜单移除，房间收银、重新连接和客户端设置在本机工具栏；设置页提供打印、更新、连接与退出。编辑操作使用右键和常用快捷键。

运行状态兼容修复：官网下载 Windows/Win7 的 setup.exe。运行状态检查改用 Windows 原生进程列表，不依赖 PowerShell。旧安装包报检查失败时，请删除旧下载文件并重新下载修订安装包；保留现有程序目录和本机营业资料。

安装器第 4 修订：请下载 setup.exe。首次安装选择程序存放位置即可，向导自动使用 Zhangju 或 ZhangjuWin7 子目录，不需手动改目录名称。最终程序目录已有未知文件或无权限时会停止。升级仍沿用已登记的原程序位置。修复空目录检查遗留错误标记导致首次安装误失败的问题，营业资料不变。

第 4 修订补充：修复首次安装目录尚未创建时被提示“无法识别安装位置”的问题。默认目录、中文目录和新建子目录通过 Windows 原生路径接口解析；无需先手动创建文件夹。未知非空目录及营业资料目录仍不会被覆盖。

RC9 场景更新：茶楼、棋牌室、台球厅、桌游吧、足浴、网咖。足浴技师服务与提成核对，桌游人数收费与借还，网咖采购/报损/盘点/库存成本需联网。Win7 联网版同步服务器界面，离线能力按原约定。

RC10 棋牌优化：收费套餐入口提前，房间卡片突出套餐名称，宽限期间标明未加收。离线开台完整展示全部包时方案；修改现金实收后需重新确认，过期报价须重新试算。联网网页和小程序结果不明确时锁定该房间其他提交，先查询原操作编号。小程序员工开发版尚未正式发布。

2026-10-12：客户端设置新增“打印异常核对”。打印回调中断或重启前未确认的记录，须核对实际出纸和系统队列，再确认“已经出纸”或“未出纸，已清除系统任务”。确认记录永久保留，不自动补打、不重新收款；补打到原账单操作。旧客户端若因异常打印记录阻止在线安装，请先完整下载安装新版，保留本机数据目录。Win7 真机与实际打印机仍待验收。

RC14：修复工作区显示时的原生视图尺寸刷新，联网工作台同步紧凑排版和员工/店长权限。

RC15：新增短时套餐提前结账时价推荐；老板可在房间与计费的结账与优惠中配置开关和适用时长。

2026-10-15 更新：客户端顶部工具栏移入“全部功能”；重新连接、打印凭证、本机离线营业及客户端设置统一从这里进入。连接使用 https://app.zhangju.com.cn，旧 IP 与端口入口已关闭。
房间卡片可直接登记预约并自选起止时间；维护需手动结束，维护期间不能开台或新增预约。以上操作联网同步到网页、客户端和小程序；维护不会自动解除。

本次更新：客户端显示名称统一为“掌局”。Mac 解压后将 Zhangju.app 放入“应用程序”并重命名为“掌局.app”后打开；保留内部程序名以兼容旧版在线更新。原本机资料和账号保持。
员工权限：收银员、服务员不可查看报表、经营助手、简报、采购成本、利润账和员工管理；店长可查看经营数据，账号和授权仅店主管理。

2026-10-26：网页与客户端统一布局及搜索入口；历史缺成本可凭据补正，新增钱箱收支/冲销、采购更正/退货、逐笔渠道核对、月结版本快照。全部沿用原角色权限。客户端更新文件仅按已确认成功的记录回收，保留当前版本与必要回退；未知、失败或待确认文件不自动删除。

2026-10-26 修复增补：Mac读取原设备身份改为异步，系统授权等待时设置页保持响应，可正常退出；更新超时按有界步骤回退。授权拒绝、资料损坏、写盘失败均不确认启动成功，不清空资料。系统仍可能要求本人授权；本包未增加Developer ID签名或公证。报表/库存沿用已发布正式网页，老板与员工权限不变。