docs: add AI Web workspace template and For AI Agents section to README
All checks were successful
Deploy Website / build-and-deploy (push) Successful in 13s

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
WangDL 2026-05-20 10:58:23 +08:00
parent d7757921b7
commit 955ed6c90b
2 changed files with 127 additions and 69 deletions

66
AI_WEB_WORKSPACE.md Normal file
View File

@ -0,0 +1,66 @@
# AI Web 工作台
> Web Agent 维护。仅中/大任务填写,小任务在对话中直接反馈。提交后清空。
---
## 当前任务
(待填写)
---
## 已确认范围
(待填写)
---
## 本次修改
(待填写)
---
## 修改文件
| 文件 | 变更 | 说明 |
|------|------|------|
| — | — | — |
---
## 本地测试方式
```
npm run dev 测试步骤)
```
---
## 阻塞项
- 需要后端支持xxx
---
## 需要 Global Agent 决策
(待填写)
---
## 需要其他 Agent 支持
- 需要后端新增接口xxx
---
## 是否建议进入 Review
- [ ] 是
- [ ] 否,有阻塞
---
## 提交后清空

130
README.md
View File

@ -1,93 +1,85 @@
# 龙德AI学习 官网
# 知习 ZhiXi 官网
AI 学习产品的官方网站,基于 Astro + TypeScript 构建。
AI 学习产品官方网站,基于 Astro + Tailwind CSS v4 构建。
## 技术栈
- **框架**: Astro 5.x
- **语言**: TypeScript
- **样式**: 原生 CSSApple 风格)
- **样式**: 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` 中统一管理
- 域名 `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 确认)