静态站点与后续维护
玖云 Learn 使用 Astro Starlight 文档主题。页面、图片和站内搜索均可构建为静态文件，按产品扩展内容时不需要另建后台。
当前托管与 Blob 的选择
Section titled “当前托管与 Blob 的选择”当前站点实际托管在 Azure Static Web Apps（Free），不是 App Service，也尚未迁入 Blob 的 $web。SWA 免费与标准计划均提供全局分布式静态内容；标准计划面向生产应用并提供相应 SLA 等能力。升级计划不等于所有网络下的大图下载都会自动加快。托管计划对比
| 项目 | Azure Static Web Apps | Blob 静态网站 |
|---|---|---|
| 静态 HTML、图片和脚本 | 支持 | 支持，部署到 $web 容器 |
| 客户匿名阅读 | 可直接提供公开链接 | 可通过静态网站终结点匿名阅读 |
| 默认地址 HTTPS | 支持 | 支持静态网站终结点的 HTTPS |
| 自定义域名 HTTPS | 服务提供证书配置能力 | 需要结合 Azure Front Door 或 CDN 等实现 |
| 文档扩展方式 | 更新静态构建结果 | 更新静态构建结果 |
站点继续使用现有 Static Web Apps 公开地址。随着内容增加，仍可继续使用当前方式；如果以后需要统一接入组织的 Front Door、域名和内容分发方案，也可以把同一套静态构建结果部署到 Blob。
Blob 可以承载这个 Wiki，但它不会自动提供内容编辑后台。主题、内容目录、搜索索引和图片浏览由站点构建结果提供。Blob 静态网站说明
加载速度与扩展方式
Section titled “加载速度与扩展方式”现有 Azure 地址继续作为正式入口。本轮已做以下优化：
- 最大的桌面截图在文章中使用约 703 KB 的清晰预览，点击后再打开约 6.87 MB 的原图。
- 操作引导先加载当前画面，后续画面按步骤加载。
- 图片携带内容版本标识并缓存一天；带内容哈希的脚本和样式缓存一年。HTML 保持短缓存，便于更新。
- 图片补充宽高，减少页面加载时的跳动；官方文档链接在新标签页打开。
另已部署 Cloudflare Pages 对照预览，沿用同一份静态内容，没有修改原站 DNS 或客户入口。预览站设置不参与搜索引擎索引。
当前测试网络中，大图样本通过 Cloudflare 下载更快，HTML 响应没有一致优势。单次网络与代理路径的样本不能代表客户所在地表现；先让目标地区的客户对照访问，再决定是否调整正式域名。Cloudflare Pages 支持直接上传构建文件和通过 _headers 设置响应头。直接上传、响应头配置
图片体积不会因为改为 Blob 托管而自动减小。
需要组织统一的域名、缓存规则、边缘分发或更大的媒体库时，再评估 Blob 与 Azure Front Door 的组合。Blob 默认网站地址支持 HTTPS；自定义域名的 HTTPS 需要 Front Door 等配套服务，同时应计入新增服务和流量成本。自定义域名与 HTTPS
增加文章、产品和英文版本仍然是更新同一套静态构建结果，不要求迁移存储。内部 AVD 文件共享使用 Azure Files，详见存储与文件共享入门，与公开网站的 Blob 方案分别规划。
内容更新流程
Section titled “内容更新流程”- 在相应产品目录新增或修改文章，按侧栏顺序组织步骤。
- 使用真实操作截图，保留页面入口与导航；关键按钮加编号框。
- 处理账号、密钥、二维码及其他敏感内容，发布目录只放处理后的图片。
- 构建并预览站点，检查链接、图片放大、搜索和手机阅读。
- 发布静态构建结果，再用未登录浏览器检查公开访问。
截图原始文件、身份验证二维码、临时密码和发布凭据应留在站点目录之外。英文内容可以在中文流程确认后增加独立语言目录，并沿用同一主题与导航结构。