# 指南

> 面向任务的 PWA how-to 与学习路径——从第一个 PWA 到可安装、离线、性能与进阶专题。

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

[参考](/zh/reference/)描述*事物是什么*，而指南是**面向任务的**——如何真正把事情做完。
它们构成从第一个 PWA 到更难问题的进阶路径，并链回参考与
[兼容性](/zh/compatibility/)数据以获取权威细节。

## 学习路径

自上而下逐步推进：每篇指南都以前一篇的成果为前提。

<CardGrid>
	<LinkCard title="入门" href="/zh/guides/getting-started/" description="构建并发布第一个可安装 PWA——清单、Service Worker、可安装性。" />
	<LinkCard title="让它可安装" href="/zh/guides/installable/" description="超越门槛：设计安装时机与启动体验。" />
	<LinkCard title="离线策略" href="/zh/guides/offline/" description="按请求类型选择缓存策略；无网络也保持可用。" />
	<LinkCard title="性能" href="/zh/guides/performance/" description="测量并改善 LCP、INP、CLS；让启动感觉即时。" />
	<LinkCard title="进阶" href="/zh/guides/advanced/" description="以渐进增强方式接入推送、文件访问与平台集成。" />
</CardGrid>

## 指南与站点其他部分的关系

指南讲的是*怎么做*，从不重复别处已有的事实：

- 关于*某事物是什么、如何表现*，指南链接到[参考](/zh/reference/)。
- 关于*在哪里可用*，指南链接到[兼容性](/zh/compatibility/)数据。

这样事实只存放在一处——指南给出步骤，并引用相应的参考条目或支持矩阵以获取细节，
因此指导永不偏离事实。每篇指南都带有 `sources` 与 `lastVerified` 日期，并以保持长期
有效的方式撰写：教授持久的任务，而非有时效的公告。