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	行动号召按钮

快速开始

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