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`

---

## For AI Agents

### 负责 Agent

Web Agent（`@web-agent`），配置在 `.claude/agents/web-agent.md`。

### 设计规范

- Tailwind CSS v4 工具类，禁止内联 style
- 紫色系：`#4F7CFF` (tech-blue)、`#1550d3` (primary)
- 动画缓动：`cubic-bezier(0.16, 1, 0.3, 1)`
- 必须支持 `prefers-reduced-motion`、`focus-visible`
- Light mode 文字对比度 ≥ 4.5:1 (WCAG AA)

### 工作台

`web-projects/AI_WEB_WORKSPACE.md` — 仅跨模块多 Agent 任务时填写，小任务跳过。

### 禁止

- 不能修改 api-server
- 不能自行发明后端接口
- 不能引入新第三方依赖（除非 Global Agent 确认）