Windows 客户端
适用于 Windows 10 1809 及以上版本与 Windows 11，安装过程会自动注册开始菜单快捷方式、资源管理器右键入口与系统托盘图标。
- 安装向导提供图形界面，保留默认目录即可
- 支持静默参数，便于批量部署到多台设备
- 覆盖安装不会清空账号配置与本地缓存
SHA-256：a7f3c9e2b41d5f8c…（完整值见下方校验区）
安装包下载
按系统选择 hth网站 客户端安装包
标准安装包体积小、下载快，适合网络通畅的个人电脑；离线镜像内含完整运行组件，适合内网环境、机房或多台设备统一部署。下载完成后请先核对页面给出的校验值，再开始安装。
macOS 客户端
安装包同时包含 Apple 芯片与 Intel 机型，安装时把应用拖入「应用程序」文件夹即可，首次打开需要在访达中右键选择打开完成一次确认。
- 支持 macOS 12 Monterey 及以上版本
- 通用二进制，Apple 芯片原生运行
- 可在系统设置中开启开机自启动
SHA-256：4d81b0e6c9a27315…（完整值见下方校验区）
Linux 客户端
提供 deb 与 rpm 两种格式，覆盖 Ubuntu、Debian、CentOS 与 openSUSE 等常见发行版，可通过包管理器直接完成安装与卸载。
- 命令行与桌面环境均可使用
- 安装后自动写入系统菜单项
- 支持无图形界面环境下的后台运行
SHA-256：b2e570a1f8c3460d…（完整值见下方校验区）
安装方式
三种安装方式，按使用场景挑一种就行
个人电脑用图形界面安装最省事；公司里要给几十台机器部署，走静默参数；只在临时设备上使用，直接选便携版。
推荐
Windows
macOS
图形界面安装
下载后双击运行安装包，按向导提示点击下一步：确认许可条款、选择安装目录、等待文件写入，最后点击完成即可启动。全程无需命令行操作，安装结束后可以在设置里把语言、缓存目录、开机自启动一次性配置好。
- 建议保留默认安装目录，避免路径含中文或空格
- 安装前请预留至少 2 GB 可用空间给缓存
- 勾选「创建桌面快捷方式」方便下次直接打开
批量部署
静默批量安装
在命令行中执行安装包并附加静默与目录参数，安装过程不会弹出任何窗口，适合通过脚本或运维工具推送到多台设备。
Windows 示例参数：/S /DIR="D:\Apps"
免安装
便携免安装版
解压即用，配置与缓存都保存在同一目录，删除文件夹就等于卸载。适合放在 U 盘、公共电脑或只临时使用几天的场景。
退出前记得在设置中执行一次配置导出。
安装步骤
从下载到首次启动，四步走完
按顺序做完这四步，hth网站 就可以正常使用了。中途遇到提示不要直接跳过，多数问题在前两步就能避免。
全部平台
选择对应平台的安装包
先确认电脑的系统版本与芯片类型，再回到上方下载区选包。Windows 选 64 位安装程序，macOS 直接使用通用版，Linux 按发行版在 deb 与 rpm 之间挑选。如果机器无法访问外网，改用离线镜像。
下载提示：同一时间只保留一个下载任务，避免带宽被分散。
Windows
macOS
Linux
核对安装包的完整性
下载结束后计算文件的 SHA-256 值，与页面下方校验区给出的字符串比对。两者完全一致说明文件在传输过程中没有损坏；不一致就先删除文件重新下载，不要带着损坏的安装包继续下一步。
macOS 与 Linux 可使用终端命令 shasum -a 256 计算。
Windows
macOS
运行安装程序并选择安装目录
Windows 双击安装包后按向导提示操作，安装目录建议保留默认位置；macOS 把应用拖入「应用程序」文件夹；Linux 使用包管理器安装 deb 或 rpm 文件。安装期间请关闭正在运行的旧版本客户端。
安装目录请避免使用含中文、空格或特殊符号的路径。
全部平台
首次启动并完成基础配置
安装完成后启动 hth网站，按引导选择界面语言、设置缓存与下载目录、登录账号。全部配置都可以在后续的设置页面中随时修改，不需要重新安装。确认主界面能正常打开，就说明部署已经完成。
建议在设置中开启自动更新，后续版本会静默升级。
下载前确认
花一分钟对照四项信息，安装过程会顺利很多
安装失败大多不是程序本身的问题，而是磁盘空间不足、系统版本过低或安装包下载不完整。开始之前先看一眼磁盘剩余空间和系统版本，下载完成后再核对一次校验值，绝大多数报错都可以提前避开。
Windows 校验命令示例（PowerShell）
Get-FileHash .\hth-client-5.4.2-x64.exe -Algorithm SHA256
macOS / Linux 校验命令示例
shasum -a 256 ./hth-client-5.4.2-universal.dmg
磁盘可用空间
≥ 2 GB
包含安装目录与缓存目录
系统版本要求
Win10 1809+ / macOS 12+
Linux 建议 Ubuntu 20.04 及以上
安装包体积
128 MB
离线镜像为 640 MB
当前版本校验值
a7f3c9e2b41d5f8c
完整 SHA-256 请与下载页比对
安装常见问题
下载与安装时最常遇到的几个问题
下面这些情况在安装过程中出现得比较频繁，多数可以自行解决；如果仍然卡住，把日志文件提交到帮助支持即可。
先删除没有下载完成的临时文件，重新从下载区获取一次。如果所在网络使用了代理、加速工具或下载器，建议先关闭再重试，这类工具偶发会截断大文件。下载完成后用 SHA-256 值与页面给出的进行比对，一致就说明文件完整，可以放心安装。
部分安全软件会对首次出现在本机的安装程序弹出拦截提示，确认安装包来源是本页提供的版本后选择允许即可。如果拦截发生在写入注册表或创建服务阶段，可以临时退出安全软件，安装完成后再重新开启，并把安装目录加入信任列表。
在访达中找到应用图标，按住 Control 键点击或右键选择「打开」，在弹窗中再确认一次即可正常启动。也可以前往系统设置的隐私与安全性页面，允许来自已识别开发者的应用。请不要直接把应用拖进废纸篓，那样会导致安装文件被删除。
有的。Windows 可以在命令行执行安装包并附加静默参数与目录参数，安装过程不弹出任何界面；macOS 可以使用安装器命令加载镜像完成静默安装。建议先在测试机上验证参数与安装目录权限，确认无误后再对整批设备执行。
先确认系统版本是否满足要求，再检查安装目录是否被安全软件隔离或误删。Windows 用户可以尝试以管理员身份运行一次；如果仍然无法启动，请把安装目录下的日志文件通过帮助支持提交，我们会在一个工作日内回复处理建议。
不需要。直接运行新版本安装包覆盖安装即可，账号配置与本地缓存都会保留。如果是跨越大版本升级，建议先在设置中导出一次配置备份，避免个别设置项在升级过程中被重置，升级完成后可以按需导入。