WangDL
955ed6c90b
All checks were successful
Deploy Website / build-and-deploy (push) Successful in 13s
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
86 lines
2.3 KiB
Markdown
86 lines
2.3 KiB
Markdown
# 知习 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 确认）
|