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

---

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 确认）