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
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:
parent
d7757921b7
commit
955ed6c90b
66
AI_WEB_WORKSPACE.md
Normal file
66
AI_WEB_WORKSPACE.md
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
# AI Web 工作台
|
||||||
|
|
||||||
|
> Web Agent 维护。仅中/大任务填写,小任务在对话中直接反馈。提交后清空。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 当前任务
|
||||||
|
|
||||||
|
(待填写)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 已确认范围
|
||||||
|
|
||||||
|
(待填写)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 本次修改
|
||||||
|
|
||||||
|
(待填写)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 修改文件
|
||||||
|
|
||||||
|
| 文件 | 变更 | 说明 |
|
||||||
|
|------|------|------|
|
||||||
|
| — | — | — |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 本地测试方式
|
||||||
|
|
||||||
|
```
|
||||||
|
(npm run dev 测试步骤)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 阻塞项
|
||||||
|
|
||||||
|
- 需要后端支持:xxx
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 需要 Global Agent 决策
|
||||||
|
|
||||||
|
(待填写)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 需要其他 Agent 支持
|
||||||
|
|
||||||
|
- 需要后端新增接口:xxx
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 是否建议进入 Review
|
||||||
|
|
||||||
|
- [ ] 是
|
||||||
|
- [ ] 否,有阻塞
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 提交后清空
|
||||||
130
README.md
130
README.md
@ -1,93 +1,85 @@
|
|||||||
# 龙德AI学习 官网
|
# 知习 ZhiXi 官网
|
||||||
|
|
||||||
AI 学习产品的官方网站,基于 Astro + TypeScript 构建。
|
AI 学习产品官方网站,基于 Astro + Tailwind CSS v4 构建。
|
||||||
|
|
||||||
## 技术栈
|
## 技术栈
|
||||||
|
|
||||||
- **框架**: Astro 5.x
|
- **框架**: Astro 5.x
|
||||||
- **语言**: TypeScript
|
- **语言**: TypeScript
|
||||||
- **样式**: 原生 CSS(Apple 风格)
|
- **样式**: Tailwind CSS v4(`@tailwindcss/vite`)
|
||||||
|
- **主题**: 浅色玻璃拟态 "Luminous Clarity"
|
||||||
|
|
||||||
## 页面结构
|
## 页面
|
||||||
|
|
||||||
- `/` - 首页
|
| 路由 | 文件 | 说明 |
|
||||||
- `/privacy` - 隐私政策
|
|------|------|------|
|
||||||
- `/terms` - 用户协议
|
| `/` | `index.astro` | 首页 |
|
||||||
- `/support` - 支持与反馈
|
| `/product` | `product.astro` | 产品介绍 |
|
||||||
- `/waitlist` - 等待名单
|
| `/philosophy` | `philosophy.astro` | 学习理念 |
|
||||||
- `/changelog` - 更新日志
|
| `/privacy` | `privacy.astro` | 隐私政策 |
|
||||||
- `/download` - Mac 下载页
|
| `/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
|
```bash
|
||||||
npm install
|
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 | 服务器主机 |
|
| `HOST` | localhost | 服务器主机 |
|
||||||
| `PORT` | 4321 | 服务器端口 |
|
| `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 使用环境变量管理
|
- 域名 `longde.cloud` 已备案
|
||||||
- 等待名单表单当前为 Mock 模式,后端接入后修改 `WaitlistForm.astro`
|
- 等待名单表单当前 Mock 模式,后端接入后修改
|
||||||
- SEO 配置在 `BaseLayout.astro` 中统一管理
|
- 设计规范见 `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 确认)
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user