macOS 使用帮助 安装 · 更新 · 常见问题

macOS 安装指南

在 Mac 上使用迪小牛

先选对芯片版本,再按步骤完成安装;遇到安全提示也有对应说明。当前版本 V—。

最后更新:2026-09-01 · 发布者:优分网络科技成都有限公司

开始前先了解

迪小牛储值卡账单系统(macOS 桌面客户端)面向门店收银与日常经营,提供会员储值卡管理、充值消费、预约、账单与通知等功能。 基于 Electron 构建,在「应用程序」文件夹中显示为「迪小牛储值卡账单系统」。

请仅从本官网下载安装包:客户端下载中心。 勿使用来路不明的拷贝,以免遭遇篡改或恶意软件。

产品基本信息
应用显示名迪小牛储值卡账单系统
Bundle IDcom.merchant.member.system
安装包命名dxn-merchant-{版本}-arm64.dmg / dxn-merchant-{版本}-x64.dmg
安装方式DMG 磁盘映像,拖入「应用程序」文件夹
CPU 架构Apple 芯片(arm64)与 Intel(x64) 分架构提供,请按本机芯片选择

系统要求

  • 操作系统:macOS 11 Big Sur 或更高(建议 macOS 12 Monterey 及以上)
  • 芯片:Apple Silicon(M 系列)或 Intel 处理器,须下载对应架构 DMG
  • 内存:建议 4 GB 及以上
  • 分辨率:建议 1280×720 及以上
  • 磁盘空间:建议预留 500 MB 可用空间
  • 网络:DMG 安装可离线完成;登录与业务同步需要稳定互联网
  • 运行时依赖:内置 Electron 运行时,无需单独安装 Java / Node.js

不支持:macOS 10.x 及更早版本;iPhone / iPad 请使用独立原生应用,本 DMG 无法在 iOS / iPadOS 上安装。

安装指南

  1. 打开 下载中心,点击「下载 macOS」。页面会自动识别 Apple 芯片或 Intel,也可手动选择对应架构。
  2. 双击下载的 .dmg 文件,挂载磁盘映像。
  3. 将窗口中的 App 图标拖入「应用程序」文件夹。
  4. 弹出 DMG 后,在「应用程序」中双击打开。若出现 Gatekeeper 提示,见下方 Gatekeeper 说明。
  5. 首次打开若提示「无法验证开发者」,可按住 Control 键点击图标,选择「打开」。
  6. 若已安装旧版,直接拖入覆盖即可就地升级,用户数据目录通常保留。

安装与升级均不需要重启 macOS。若提示应用正在运行,请先完全退出迪小牛后再覆盖安装。

Gatekeeper 与公证说明

macOS 客户端使用 Developer ID Application 签名,并提交 Apple 公证(Notarization)。 在公证声誉尚未完全建立或首次下载时,系统可能提示「无法打开,因为无法验证开发者」或「已损坏」。 这是 Gatekeeper 的常见拦截,并非病毒检测结论。

如何继续打开

  1. 打开「系统设置 → 隐私与安全性」,在底部找到被拦截的应用,点击「仍要打开」
  2. 或在「应用程序」中按住 Control 键点击图标,选择「打开」
  3. 公证完成后,多数情况下可直接双击打开

安装前请核对来源:只从 www.dixiaoniu.cn 下载。不要安装来自第三方网盘、聊天工具或未知网站的文件。

安装时可能遇到的情况

以下为安装过程中常见系统状态及处理方式,供商户参考。

安装成功

App 已拖入「应用程序」文件夹,图标可正常启动。首次打开可能需按 Gatekeeper 说明额外确认一次。启动后可在菜单栏「关于本机」或应用内查看版本号。

用户取消安装

在挂载 DMG 后未拖入 App、或直接关闭窗口时,不会写入系统。关闭 DMG 并推出磁盘映像即可,系统保持原状。

应用程序已存在(就地升级)

检测到同 Bundle ID 的旧版时,将新 App 拖入「应用程序」会覆盖程序文件。用户数据目录通常保留;若卸载时选择清除数据,则按卸载策略处理。

安装正在进行

请勿同时挂载多个 DMG 并重复拖入。等待当前复制完成后再操作,避免文件不完整。

磁盘空间已满

复制到「应用程序」时若空间不足,会提示无法完成。请清理至少 500 MB 后重新拖入安装。

需要重新启动

不需要重启 macOS。安装完成后可直接使用。若提示需关闭应用,指退出迪小牛进程,而非重启电脑。

网络故障

DMG 本地安装不受网络影响。应用内检查更新需联网;若更新下载失败,可稍后重试或从官网下载最新 DMG 覆盖安装。

拒绝打开(Gatekeeper)

若未在系统设置中选择「仍要打开」,应用不会启动。请按 Gatekeeper 说明 操作;企业环境请联系 IT 将开发者证书加入白名单。

其他故障排查

常见问题与处理
现象 建议处理
提示「已损坏,无法打开」 多为 Gatekeeper 拦截;按 Gatekeeper 说明操作,勿随意执行终端「移除隔离属性」命令
下载了错误架构(arm64 / x64) 在下载中心手动选择与本机芯片匹配的 DMG 重新安装
覆盖安装时提示应用正在运行 完全退出迪小牛(含菜单栏图标)后重新拖入
DMG 无法挂载或文件损坏 从官网重新下载;核对文件大小是否与下载页一致
应用内更新下载失败 检查网络;或从官网下载最新 DMG 手动覆盖
启动后白屏或无法加载 确认 macOS 版本 ≥ 11;检查防火墙是否拦截 www.dixiaoniu.cn
无法登录 / 同步失败 检查网络;确认可访问 https://www.dixiaoniu.cn/api
权限弹窗(辅助功能、文件访问等) 按系统提示在「隐私与安全性」中授权,以便正常使用打印或本地导出功能

更新与卸载

应用内更新

登录后点击「检查更新」。发现新版本时可下载并在就绪后重启应用完成升级。更新元数据来自 latest-mac.yml(electron-updater)。

手动更新

从 下载中心 获取最新 DMG,拖入「应用程序」覆盖旧版即可。

卸载

  • 将「应用程序」中的「迪小牛储值卡账单系统」移到废纸篓
  • 可选:清理用户数据目录(见下方路径),以完全移除本地配置

卸载前若应用正在运行,请先退出。默认用户数据目录在卸载后可能保留,便于日后重装恢复。

安装路径与数据目录

路径说明
应用程序位置 /Applications/迪小牛储值卡账单系统.app
用户数据 ~/Library/Application Support/迪小牛储值卡账单系统/
更新元数据 https://www.dixiaoniu.cn/downloads/updates/latest-mac.yml
签名 Developer ID Application + Apple Notarization(Hardened Runtime 已启用)

安全与隐私

  • 业务 API 经 HTTPS 访问 https://www.dixiaoniu.cn/api
  • 登录凭证优先存储在 macOS 钥匙串(操作系统级加密)
  • 安装包经 Developer ID 签名与 Apple 公证,更新包提供 SHA-512 校验(见 latest-mac.yml)

更多说明请参阅 隐私声明 与 使用协议。

仍需帮助?

请登录商户端,通过站内信联系官方客服,或向您的服务顾问反馈(请说明 macOS 版本、芯片类型、客户端版本与问题截图)。