diff --git a/AI_WEB_WORKSPACE.md b/AI_WEB_WORKSPACE.md new file mode 100644 index 0000000..955503d --- /dev/null +++ b/AI_WEB_WORKSPACE.md @@ -0,0 +1,66 @@ +# AI Web 工作台 + +> Web Agent 维护。仅中/大任务填写,小任务在对话中直接反馈。提交后清空。 + +--- + +## 当前任务 + +(待填写) + +--- + +## 已确认范围 + +(待填写) + +--- + +## 本次修改 + +(待填写) + +--- + +## 修改文件 + +| 文件 | 变更 | 说明 | +|------|------|------| +| — | — | — | + +--- + +## 本地测试方式 + +``` +(npm run dev 测试步骤) +``` + +--- + +## 阻塞项 + +- 需要后端支持:xxx + +--- + +## 需要 Global Agent 决策 + +(待填写) + +--- + +## 需要其他 Agent 支持 + +- 需要后端新增接口:xxx + +--- + +## 是否建议进入 Review + +- [ ] 是 +- [ ] 否,有阻塞 + +--- + +## 提交后清空 diff --git a/README.md b/README.md index 47b6ac0..1ec6959 100644 --- a/README.md +++ b/README.md @@ -1,93 +1,85 @@ -# 龙德AI学习 官网 +# 知习 ZhiXi 官网 -AI 学习产品的官方网站,基于 Astro + TypeScript 构建。 +AI 学习产品官方网站,基于 Astro + Tailwind CSS v4 构建。 ## 技术栈 - **框架**: Astro 5.x - **语言**: TypeScript -- **样式**: 原生 CSS(Apple 风格) +- **样式**: Tailwind CSS v4(`@tailwindcss/vite`) +- **主题**: 浅色玻璃拟态 "Luminous Clarity" -## 页面结构 +## 页面 -- `/` - 首页 -- `/privacy` - 隐私政策 -- `/terms` - 用户协议 -- `/support` - 支持与反馈 -- `/waitlist` - 等待名单 -- `/changelog` - 更新日志 -- `/download` - Mac 下载页 +| 路由 | 文件 | 说明 | +|------|------|------| +| `/` | `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 # 预览生产版本 ``` -### 启动开发服务器 - -```bash -npm run dev -``` - -访问 http://localhost:4321 - -### 其他命令 - -| 命令 | 说明 | -|------|------| -| `npm run dev` | 启动开发服务器 | -| `npm run build` | 构建生产版本 | -| `npm run preview` | 预览生产版本 | -| `npm run astro` | 运行 Astro CLI | - ## 环境变量 -复制 `.env.example` 为 `.env` 并根据需要修改: - -```bash -cp .env.example .env -``` - | 变量 | 默认值 | 说明 | |------|--------|------| -| `SITE_URL` | http://localhost:4321 | 站点地址(SEO 和 sitemap 使用)| +| `SITE_URL` | http://localhost:4321 | 站点地址(SEO/sitemap) | | `HOST` | localhost | 服务器主机 | | `PORT` | 4321 | 服务器端口 | -## 项目结构 - -``` -├── src/ -│ ├── components/ # 组件 -│ │ ├── Header.astro -│ │ ├── Footer.astro -│ │ ├── Hero.astro -│ │ ├── FeatureCard.astro -│ │ ├── CTA.astro -│ │ └── WaitlistForm.astro -│ ├── layouts/ # 布局 -│ │ └── BaseLayout.astro -│ └── pages/ # 页面 -│ ├── index.astro -│ ├── privacy.astro -│ ├── terms.astro -│ ├── support.astro -│ ├── waitlist.astro -│ ├── changelog.astro -│ └── download.astro -├── public/ # 静态文件 -│ ├── favicon.svg -│ └── robots.txt -├── astro.config.mjs -├── tsconfig.json -└── package.json -``` - ## 注意事项 -- 域名 `longde.cloud` 正在备案中,所有 URL 使用环境变量管理 -- 等待名单表单当前为 Mock 模式,后端接入后修改 `WaitlistForm.astro` -- SEO 配置在 `BaseLayout.astro` 中统一管理 \ No newline at end of file +- 域名 `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 确认)