客户端安装

Windows

下载中心提供两种方式：

• 在线安装：下载 ClerkBit.application，按提示完成安装。适合可以访问外网的环境。
• 离线安装包：下载 zip，解压到本地目录，运行 install.cmd。适合内网或在线安装被拦截的环境。

系统要求：

• Windows 10 及以上
• .NET Framework 4.8
• WebView2 Runtime（安装包会检测并提示）

离线包不要只复制 Clerk.exe，需要保持目录结构完整。安装完成后首次登录仍然需要网络。

macOS

按芯片选择安装包：

• Apple 芯片：Clerk-Bit-<版本>-osx-arm64.dmg
• Intel 芯片：Clerk-Bit-<版本>-osx-x64.dmg

要求 macOS 15.0 及以上。首次启动如果被系统拦截，请在「系统设置 → 隐私与安全性」中允许，并授予文稿、下载、桌面权限。

校验安装包

下载中心会显示文件大小和 SHA256。Windows 可以用 PowerShell 校验：

Get-FileHash .\Clerk-Offline-<版本>.zip -Algorithm SHA256

macOS 可以用：

shasum -a 256 Clerk-Bit-<版本>-osx-arm64.dmg

安装失败怎么办

• 被安全软件拦截：允许安装或加入白名单；内网优先用离线包。
• ClickOnce 被禁用：改用离线安装包，或联系 IT 启用 ClickOnce。
• macOS 无法打开：在隐私与安全性中允许；仍不行时重新下载并确认系统版本。
• 内网代理 407：在线安装需要放行 admin.clerkbit.com；离线包不访问网络。
• 缺少 WebView2：按提示安装，或从微软官网下载 WebView2 Runtime。

更多问题见常见问题。