# DESU.Life Support

设备支持与下载站，把配置器、说明书和安装文档整理到一起

Source: https://works.im0o.top/projects/3a3fdb9d/
Date: 2025-05-24
Tags: Web开发, Astro, Svelte, UI设计, 设计与开发

## Project links

- [网站](https://support.desu.life/)
- [源代码](https://github.com/desu-life/support-desu-life)


DESU.Life Support 是供设备用户下载文件、查阅文档的支持站。配置器、固件、说明书、安装手册分散在不同内容里，我负责这版站点的界面设计和前端开发，用 Astro 写页面，配合 Svelte 处理交互。

## 下载和文档页面

设备用户既要下载文件，也要查阅较长的说明文档。我为下载入口、产品介绍、搜索和提示分别做了组件，让这些内容在不同页面里保持一致。菜单和抽屉也共用组件。

文章使用 MDX 编写，放进统一的内容脚手架。写新文档时可以沿用布局、封面和正文组件，设备、文章、产品的图片也分别存放。

![支持站的页面展示](https://image.im0o.top/2026/20261117104126307.webp)

固件、文章、产品和条款分别管理，页面入口由 Astro 生成。站点支持深色界面与不同窗口宽度，文档和下载内容使用同一套组件样式。

## 页面加载与链接检查

这一版使用 Astro 静态生成，服务器通过 Nginx 提供页面并开启 gzip。我用 PageSpeed Insights 检查加载表现，也用 Screaming Frog 查死链和页面结构，补充 robots.txt 与自动生成的 sitemap.xml。

下面是 2025 年 6 月 4 日保存的桌面测试记录：性能 100、无障碍 93、最佳实践 100、SEO 100。截图还留着当时的页面缩略图和各项加载指标。

![2025 年 6 月 4 日的桌面 Lighthouse 记录](https://image.im0o.top/2026/20261117104128165.webp)

## 发布流程

构建和部署由 GitHub Actions 执行，工作流按 Conventional Commits 区分内容更新与版本发布。部署认证沿用了时间戳与 HMAC 的一次性密码方案。

从写 MDX 到构建站点、检查链接，再到发布，这些步骤放在同一个项目里维护。后来整理相关实现时，我也把[部署认证](https://blog.im0o.top/posts/29f324f.html)和[语义化提交发版](https://blog.im0o.top/posts/31eaaef6.html)写进了博客。

[支持站](https://support.desu.life/) · [源代码](https://github.com/desu-life/support-desu-life)


[相关工作经历](/about/#desu-life)

