动手安装之前，先把这三件事确认好
多数安装失败并不是步骤复杂，而是安装包来源、磁盘权限或网络放行其中一项没有准备好。花两分钟核对，后面会省下不少时间。
- 安装包来源：从本站下载入口获取文件，文件名会带版本号与架构标记，例如 hth-setup-3.8.2-x64.exe。收到他人转发的安装包时，先核对校验值再使用。
- 磁盘与权限：预留 4 GB 以上可用空间；Windows 安装过程需要管理员权限，macOS 需要到隐私与安全性面板放行一次，否则会卡在写入阶段。
- 网络环境：安装完成后首次启动需要访问 443 端口，公司内网使用代理的，提前把客户端域名加入白名单，避免停在加载界面。
选你的系统，照着编号往下走
每个平台六个步骤，编号右侧的灰色标签是操作时会用到的路径、文件名或命令，可以直接对照屏幕核对。
Windows 安装步骤
适用于 Windows 10 1809 及以上 · x64-
取出安装包
在下载入口选择 Windows 稳定版并保存到本地磁盘。不要从压缩软件窗口里直接双击安装程序，先完整解压或移动到一个固定目录再运行。
hth-setup-3.8.2-x64.exe 218 MB -
核对安装包完整性
右键查看文件属性核对大小，或在命令行中计算哈希值，与下载入口标注的 SHA-256 逐位比对。数值不一致说明文件在传输中被截断，删除后重新下载。
certutil -hashfile hth-setup-3.8.2-x64.exe SHA256 -
暂时关闭实时防护干扰
部分安全软件会拦截安装程序写入系统目录。可在安装期间临时关闭实时防护，装好之后立即重新打开，并把客户端目录加入信任列表。
-
选择安装目录
默认写入 C:\Program Files\hth。自定义路径时避免使用中文和空格，否则部分组件可能无法正常注册。
C:\Program Files\hth 剩余空间 ≥ 4 GB -
完成组件写入
按需勾选桌面快捷方式与开机自启，整个写入过程约 40 秒。进度条走完后不要立刻关闭窗口，等待安装程序自行退出。
-
首次启动并核对版本
从开始菜单打开客户端，等待本地缓存初始化完成，随后在「关于」面板确认版本号与安装包一致。
版本号应为 v3.8.2
macOS 安装步骤
适用于 macOS 12 及以上 · arm64 / x64-
按芯片选择安装包
Apple 芯片机型选择 arm64 版本，Intel 机型选择 x64 版本。选错架构安装后可能出现启动闪退。
hth-3.8.2-arm64.dmg 196 MB -
拖入应用程序文件夹
打开 dmg 后把图标拖进「应用程序」，不要在挂载卷内直接双击运行，否则程序无法被系统正确登记。
/Applications -
放行安全提示
首次打开若提示无法验证开发者，前往「系统设置 → 隐私与安全性」，在页面下方点击「仍要打开」，随后再次启动即可。
-
授权必要权限
按提示允许网络访问与本地文件读写。若拒绝文件权限，客户端会在初始化阶段反复重试，表现为长时间无响应。
-
卸载镜像
安装完成后在访达侧边栏推出 dmg 挂载卷，再删除下载目录中的镜像文件，避免占用磁盘空间。
-
确认版本信息
从启动台打开客户端，在菜单栏的「关于」中核对版本号与安装包是否一致。
Android 安装步骤
适用于 Android 9 及以上-
下载 apk 安装包
在手机浏览器中打开下载入口获取安装包，使用下载工具时注意不要中断，文件不完整会导致安装程序直接报错。
hth-3.8.2-android.apk 96 MB -
允许安装未知来源应用
系统弹出提示时，进入设置中为当前浏览器或文件管理器开启「允许安装应用」权限，安装完成后可以再关闭该权限。
-
授予运行权限
按提示允许网络与存储权限。拒绝存储权限会导致离线内容无法缓存，后续需要手动到应用信息页面重新开启。
-
完成安装并打开
点击安装后等待进度完成，桌面出现图标即可打开。
-
登录并等待同步
首次进入使用账号登录，等待数据同步结束再操作，中途退出可能导致本地索引不完整。
iOS 安装步骤
适用于 iOS 15 及以上-
获取应用
通过 App Store 页面完成安装；测试期内会使用邀请链接加入 TestFlight，按邮件或链接中的提示接受邀请。
-
信任描述文件
企业分发版本首次打开会提示未受信任，前往「设置 → 通用 → VPN 与设备管理」，选择对应描述文件并点击信任。
-
完成登录
打开应用后登录账号，按需开启通知权限，以便及时收到版本更新与安装状态提醒。
-
确认运行状态
在应用内的设置页核对版本号，与下载入口标注的版本保持一致即可正常使用。
安装过程中出现的提示，对应这条处理
下面这些是在安装环节出现频率较高的现象，左侧是屏幕上的提示或表现，右侧是建议的处理动作。处理完再回到对应平台继续往下走。
- 安装程序双击后没有反应
- 先确认文件已完整复制到本地磁盘，再以管理员身份运行；若仍无响应，临时关闭安全软件的实时防护后重试。
- 安全软件提示写入被拦截
- 把安装目录加入信任列表，或安装期间暂停实时防护。安装结束后重新开启防护，并在客户端设置中排除缓存目录。
- macOS 提示安装包已损坏
- 多数情况是下载过程被打断，删除文件后重新下载即可。若确认来源无误，可在终端执行
xattr -d com.apple.quarantine后再次安装。 - 校验值与页面标注不一致
- 删除已下载的安装包，改用浏览器直接下载，避免使用第三方下载器或多线程续传；重新比对通过后再安装。
- 启动后停留在加载界面
- 确认网络可以访问 443 端口，内网环境检查代理白名单；随后清理本地缓存目录并重启客户端，通常可以恢复。
- 提示当前版本过低无法继续
- 先卸载旧版本并保留必要的配置备份，再安装最新稳定版 v3.8.2，安装完成后核对版本号并恢复个人设置。
- 安装到一半提示磁盘空间不足
- 清理临时文件后保证可用空间在 4 GB 以上；若安装目录所在分区容量偏小，安装时改选其他分区。
- 手机端提示应用未安装
- 多为安装包下载不完整或系统版本低于要求，删除文件重新下载，并确认系统版本符合页面标注的最低要求。
四项核对，确认客户端已经装上并可用
装完不等于可用。花一分钟把下面四项过一遍，可以减少后续升级时反复排查的情况。
版本号与安装包一致
在「关于」面板查看版本号，与下载时选择的稳定版一致，说明文件写入完整。
能正常完成一次登录
登录成功后不会立即掉线，说明网络端口与账号状态都没有问题。
本地缓存目录可写
缓存目录可写，离线内容与临时数据才会正常保存，避免每次启动重新初始化。
更新提示可以正常弹出
客户端能接收到版本更新提示，说明后续升级不需要重新手动下载安装包。
安装指引相关问答
以下问题来自安装环节的实际咨询，回答只保留可执行的处理方式。