﻿蘑菇壁纸中继 Relay 1.3.1 · 图形管理版

首次安装（不再输入命令）
1. 解压到固定目录，例如 D:\MoguWallpaperRelay，勿在压缩包里运行。
2. 双击 MoguWallpaperRelay.exe，按 Windows 提示允许管理员运行。
3. 点击“配置门店”，首次创建管理密码；服务器默认 https://wallpaper.mgwk.cn，连接并选择门店。首次自动提交申请，在已经登录的后台“待授权设备”核对门店、电脑名称及申请编号，点击允许。可先保存配置并启动服务，不需等待后台确认，也不需在本机登录或复制识别码。已有配置会自动复用。局域网 IP 自动预填，请核对为本机固定 IP；端口默认 8201，其余可保持默认。
4. 点击“保存配置”，关闭配置窗口。
5. 点击“一键安装并启动”，自动安装 Windows 服务、自启动和本地子网防火墙规则。
6. 确认服务“正在运行”；后台登记的 Relay IP、端口和本机配置一致。门店发布壁纸后，确认缓存就绪，再运行一台客户机验收。
关闭管理窗口不会停止后台服务。服务器重启后服务自动启动。

日常维护
双击打开管理窗口，可配置门店、安装启动、重启、停止服务、检查更新和查看日志。
修改配置后点击“重启服务”生效。未配置时先配置，不要直接安装。
后台显示的在线状态仍需中心网络畅通；本机“正在运行”不等于中心同步已成功，请同时查看缓存和最近故障。

在线更新
点击“检查更新”。有新版时显示版本及说明，由您确认后才更新。
下载和签名、文件大小、SHA-256、版本校验通过后，自动备份程序与配置，短暂停止服务、替换 EXE、重新启动并检查本机状态。
更新失败会尝试恢复原程序和服务，界面提示结果。自动恢复仍失败时请查看 update-result.txt 和 backups 中的备份。
配置、缓存及原有运行数据不会被主动清空。停止服务的机器确认更新后也会被启动。
当前安装 1.3.1 后，第一次检查会提示已是最新；今后发布更高版本才会提示更新。更新不会后台自动安装。

从旧版 1.0 / 1.1 升级（仅首次需要人工操作）
1. 在 Windows“服务”中停止 Mogu Wallpaper Relay。
2. 备份原 Relay 程序目录。
3. 将本包 MoguWallpaperRelay.exe 覆盖到原安装目录，保留原 config.dat、state.dat、cache 和 logs。
4. 双击新版，点击“一键安装并启动”。已有服务会复用，不需重新输入 Token。
5. 检查门店、IP、缓存和后台在线状态。以后通过“检查更新”升级。
不要解压到新目录后直接安装第二份 Relay；程序会提示已有服务的位置。

注意
Relay 的 config.dat 绑定原 Windows 机器，迁移服务器须重新配置，不可与客户机的 config.dat 混用。
Relay 安装在门店长期在线、固定局域网 IP 的 Windows 服务器上；不需要对公网开放 8201。
跨 VLAN 客户机由网络管理员配置所需路由及限定网段防火墙规则。
Relay 缓存好新壁纸后，客户机仍需运行 WallpaperClient.exe 才会更新桌面；客户端启动方式不变。

兼容命令仍保留：--config、--install-service、--uninstall-service、--service。

1.2.1 安装修复：优先调用 Windows 防火墙接口，失败时尝试备用命令；仍失败时启动中继并显示网络待验证提示。请在客户机访问 http://Relay局域网IP:8201/status 验证。错误详情写入 logs 和 firewall-warning.txt。程序不会自动关闭防火墙或启动被禁用的防火墙服务。1.2.0 用户点击“检查更新”完成升级，再点击“一键安装并启动”重新配置规则。

1.3.1：选择门店后自动获取授权；首次需在后台“待授权设备”确认，随后自动回填，7 天内有效。超时可点击“重新获取授权”。原有客户机识别码不变；切换门店需要该门店的新授权。

新流程：软件选择门店 → 等待后台确认 → 后台待授权设备点击允许 → 软件自动获取 → 保存配置。申请有效期 7 天，超时重新获取即可。

无需等待授权：选择门店后可立即点击“保存配置”，关闭配置窗口并部署运行。后台未允许时不下载、不下发；允许后中继在下一轮同步开始拉取（通常 60 秒内），客户端下次运行即可拉取。无需再次制作或复制 config.dat。申请超出 7 天未处理，请重新申请。
