Windows 安装教程

下载适合电脑的安装包

打开晾台官网下载区，国内访问可优先选择 Gitee，连接不畅时使用 GitHub 备用链接。普通 Intel／AMD 电脑选择 x64，Windows ARM 电脑选择 ARM64；可在“设置 → 系统 → 系统信息”的“系统类型”中确认。

首次安装选择对应架构的 Setup.zip。完整解压后，文件夹内应有名称以 -Setup.exe 结尾的安装程序、Hangrail-Development.cer 公开证书和 Windows-INSTALL.txt 说明。保留这些文件，先核对证书，再运行安装器。

核对开发证书

双击 Hangrail-Development.cer 查看证书，在“详细信息”中核对主题与指纹。当前固定身份如下：

CER 文件摘要可在解压目录打开 PowerShell，运行 Get-FileHash .\Hangrail-Development.cer -Algorithm SHA256 核对。字母大小写不影响比较。官网下载区的“版本说明”可找到该版本的 SHA256SUMS.txt；把命令中的文件名换成已下载 ZIP 的完整路径，即可核对安装包摘要。证书摘要不能代替安装包摘要。

名称相同不代表证书相同。任一摘要或指纹不符时，先停止安装，从官网下载区重新核对来源。

决定是否信任发行者

只有确认来源和证书一致、并愿意信任该发行者时，再操作：

1. 双击公开 CER，点击“安装证书”。
2. 存储位置选择“本地计算机”，按系统提示确认管理员权限。
3. 选择“将所有的证书放入下列存储”，浏览并选择“受信任的人”。
4. 确认所选存储后完成导入，再启动同目录中名称以 -Setup.exe 结尾的安装程序。

不要选择“受信任的根证书颁发机构”。 导入“本地计算机 → 受信任的人”会让这台电脑信任此证书签署的安装包，影响范围不限于当前下载的一个文件，也会对这台电脑的其他用户生效。它不会把证书变成微软或公共证书机构的背书。安装器本身不会导入证书或修改系统信任。

安装程序与运行时

若晾台正在运行，先保存便签，再从托盘菜单正常退出。打开安装程序，点击“安装 Hangrail”。安装器会检查对应架构的 .NET 桌面运行时；缺少时从微软官方下载、校验摘要和微软数字签名，再引导安装，可能出现管理员确认。无需安装 .NET SDK。

网络失败或取消时可稍后重试；若运行时安装要求重启，重启电脑后重新运行晾台安装器。直接安装精简 MSIX 不会自动准备运行时，首次安装建议使用 Setup。

SmartScreen 提示

如果弹窗显示“Windows 已保护你的电脑”，并说明阻止了未识别的应用，先核对文件名、下载来源和安装包摘要。只有你确认信任这份安装程序时，才点击“更多信息”，查看详情后选择“仍要运行”（如有）。这是对这次运行的确认，不用关闭 SmartScreen；相关说明见微软的首次分发指南。

若提示检测到恶意软件、证书不一致，或系统策略没有提供继续选项，停止安装并反馈；不要关闭防护或添加排除项来运行。

升级与安装受阻

普通升级保留资料库、分组和设置，重要资料仍建议先做独立备份。已安装版本可从“设置 → 更新”检查，也可正常退出后使用官网安装器升级。

遇到安全拦截时，先检查下载来源、架构、签名和证书信任；单位管理的电脑还可能受安装策略限制。安装不需要关闭 Defender、禁用签名检查或开启测试模式。仍无法确认时，请将报错内容发给晾台支持。

微软对 MSIX 的签名与信任要求可参阅签名概述及MSIX 签名指南。