web-projects/README.md

# 知习 ZhiXi 官网

AI 学习产品官方网站，基于 Astro + Tailwind CSS v4 构建。

## 技术栈

- **框架**: Astro 5.x
- **语言**: TypeScript
- **样式**: Tailwind CSS v4（`@tailwindcss/vite`）
- **主题**: 浅色玻璃拟态 "Luminous Clarity"

## 页面

| 路由 | 文件 | 说明 |
|------|------|------|
| `/` | `index.astro` | 首页 |
| `/product` | `product.astro` | 产品介绍 |
| `/philosophy` | `philosophy.astro` | 学习理念 |
| `/privacy` | `privacy.astro` | 隐私政策 |
| `/terms` | `terms.astro` | 用户协议 |
| `/support` | `support.astro` | 支持与反馈 |
| `/waitlist` | `waitlist.astro` | 等待名单 |
| `/changelog` | `changelog.astro` | 更新日志 |
| `/download` | `download.astro` | Mac 下载页 |
| `/sitemap.xml` | `sitemap.xml.astro` | 站点地图 |

## 组件

| 组件 | 说明 |
|------|------|
| `BaseLayout.astro` | 基础布局（SEO 统一管理） |
| `Header.astro` | 全局导航栏 |
| `Footer.astro` | 全局页脚 |
| `Hero.astro` | 首页主横幅 |
| `FeatureCard.astro` | 功能卡片 |
| `CTA.astro` | 行动号召按钮 |

## 快速开始

```bash
npm install
npm run dev        # http://localhost:4321
npm run build      # 生产构建
npm run preview    # 预览生产版本
```

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `SITE_URL` | http://localhost:4321 | 站点地址（SEO/sitemap） |
| `HOST` | localhost | 服务器主机 |
| `PORT` | 4321 | 服务器端口 |

## 注意事项

- 域名 `longde.cloud` 已备案
- 等待名单表单当前 Mock 模式，后端接入后修改
- 设计规范见 `startup-plan/技术设计/web-projects/设计文档.md`