医生网页迁移补充：后端下载清单及安装包验证
日期：2026-10-20（Asia/Shanghai）
验证范围：后端新增 downloads()/downloadCatalog()、控制器免登录白名单、原更新契约和网页面诊政策回归、真实已发布 Windows 1.4.8 元数据。
操作限制：仅运行本地纯 PHP 测试、源码检查、生产公开更新 GET 和安装包 HEAD。未读取 .env/密钥，未执行真实上传/发布/业务写入，未下载安装包或执行安装。未修改业务代码或测试。

结果：本次指定验证全部通过。

PHP 运行环境
D:/phpstudy_pro/Extensions/php/php8.2.9nts/php.exe

指定测试（全部退出码 0）
1. php server/tests/DesktopWorkstationDownloadsTest.php
   输出：Desktop workstation downloads: 21 assertions passed
   覆盖：仅 version/packages 顶层字段、可用平台、SHA 小写规范化、Windows inno_setup、平台标签、管理策略字段不泄露、enabled=0 仍能手动下载、无效/凭据嵌入 URL 和无效 SHA 被剔除、空清单、免登录白名单和控制器委托现有配置读取。
2. php server/tests/DesktopWorkstationUpdateContractTest.php
   输出：Desktop workstation update contract: OK
   覆盖：原版本比较、平台映射、可选/强制/最低版本更新、关闭自动检测、缺少平台包、更新 check 的公开契约，以及原安装包直传权限和菜单契约。
3. php server/tests/DoctorWebConsultationPolicyTest.php
   输出：Doctor web consultation policy: 62 assertions passed
   原网页面诊截止策略回归通过。

PHP 语法检查（每项退出码 0）
php -l server/app/adminapi/logic/setting/DesktopWorkstationLogic.php
php -l server/app/adminapi/controller/setting/DesktopWorkstationController.php
php -l server/tests/DesktopWorkstationDownloadsTest.php
php -l server/tests/DesktopWorkstationUpdateContractTest.php
四项均输出 No syntax errors detected。

源码核对
- DesktopWorkstationLogic::downloads() 仅返回 self::downloadCatalog(self::getConfig())，沿用已发布配置和现有 URL 补全逻辑，没有新增配置存储或上传行为。
- downloadCatalog() 固定遍历 windows_x64、macos_arm64、macos_x64。每个包先经 plainPackage()，最终仅有 platform/label/url/sha256/size/filename/type；顶层只有 version/packages，不包含 notes/title/min_version/force_update/enabled。
- 下载清单不依赖 enabled，关闭自动检测仍可供首次安装。原 evaluate() 未改变，关闭后仍不提示自动升级。
- DesktopWorkstationController 的 notNeedLogin 精确为 ['check', 'downloads']。getConfig/setConfig 未列入；downloads() 使用 data(DesktopWorkstationLogic::downloads())。
- BaseLikeAdminController::isNotNeedLogin() 按动作名检查该白名单；LoginMiddleware 对非免登录动作要求有效 token，AuthMiddleware 对免登录动作跳过管理菜单权限校验。管理设置读写没有被本次白名单扩大。
- downloadCatalog() 拒绝无 host、嵌入用户名/密码以及非 HTTP(S) scheme；实际生产安装器为 HTTPS。当前函数仍兼容 HTTP，未把“强制 HTTPS”作为实现事实。

真实已发布 1.4.8 元数据验证
读取：
GET https://admin.zhenyangtang.com.cn/adminapi/setting.desktop_workstation/check?current_version=0.0.0&platform=windows&arch=x64
匿名 GET 返回 HTTP 200、JSON code=1、latest_version=1.4.8。

将该 GET 的真实 data.package 传给本地新 downloadCatalog()，构造 enabled=0，同时加入未知平台 linux_x64 和额外 package 字段 extra，以及管理 title/notes。独立 PHP 断言全部通过：
- 顶层键精确为 version/packages；
- 只输出一个 windows_x64 包，未知平台被忽略；
- 包键精确为 platform/label/url/sha256/size/filename/type，额外字段被剔除；
- url/sha256/size/filename/type 与真实发布元数据逐字段一致；
- version=1.4.8，enabled=0 不阻断清单。
输出：Live public 1.4.8 metadata accepted with automatic checks disabled; top-level, package and platform whitelists passed.

实际接受的包：
platform=windows_x64
label=Windows 64位
filename=DoctorWorkstation-Setup-Windows-x64-1.4.8.exe
type=inno_setup
size=171474334
sha256=792f2273bba9f1d92d3b9e8eacabedcc53755ac003c284d648a9dca105bfb321
url=https://gz-1349751149.cos.ap-guangzhou.myqcloud.com/uploads/desktop_package/1/20261017/1792229692103-0288326cfce9f6dc.exe

对上述真实 URL 仅发 HEAD：
HTTP 200
Content-Type=application/x-msdownload
Content-Length=171474334（与清单一致）
Last-Modified=Sat, 17 Oct 2026 09:34:52 GMT
证明现有线上地址可读取且大小吻合；未重新下载远程整包或进行安装验收。

验证边界
新 /adminapi/setting.desktop_workstation/downloads 是当前工作树实现；未声称该新接口已部署到生产。公开访问范围依据源码及指定纯测试核对，未启动完整框架/数据库进行本地 HTTP 集成请求。真实线上元数据来自已有 check 接口，不依赖新端点部署。本文件不包含前端分阶段提醒视觉或交互验收结果。
