# 宇之然AI维度（Yuzhiran AI Dimension）

> AI 知识探索社区 — 用 5 个维度系统化理解人工智能

| | 维度 | 内容方向 |
|---|------|---------|
| 🌌 | **AI 起源** | 图灵测试→达特茅斯→深蓝→AlphaGo→GPT |
| 🚀 | **AI 发展** | 深度学习→Transformer→MoE→多模态→Agent |
| 🔭 | **AI 当前** | 模型对比、开源/闭源生态、具身智能 |
| 🛠️ | **AI 学习** | 提示词工程→RAG→微调→工具链→入门教程 |
| 📡 | **AI 趋势** | 每日资讯、产品动态、论文快报 |

## 项目结构

```
ai-dimension/
├── server/                      # 后端 API（Node.js + Express + MongoDB）
│   ├── src/
│   │   ├── index.js             # 入口
│   │   ├── config/              # 数据库配置
│   │   ├── middleware/           # 认证中间件
│   │   ├── models/              # Mongoose 数据模型
│   │   ├── routes/              # API 路由（auth/knowledge/aiChat/trend/user/payment/feedback/admin）
│   │   ├── scripts/             # 数据脚本（趋势更新/商品定价/内容填充）
│   │   └── utils/               # 工具（日志/响应/微信支付）
│   ├── tests/                   # Jest 测试
│   └── package.json             # npm 依赖
├── client/                      # 前端（uni-app 微信小程序 + H5）
│   ├── src/
│   │   ├── pages/               # 16 个页面
│   │   ├── components/          # 公共组件（DimCard / NewsCard）
│   │   ├── stores/              # Pinia 状态管理（user/knowledge/chat）
│   │   ├── utils/               # 工具（API封装/维度配置/错误处理）
│   │   ├── styles/              # 主题系统（theme.scss）
│   │   └── static/              # 图标资源
│   ├── pages.json               # 路由配置
│   ├── manifest.json            # 小程序配置
│   └── package.json             # pnpm 依赖
├── scripts/                     # 项目工具
│   └── upload-wx.js             # 微信开发者工具上传脚本
└── package.json                 # 根 workspace
```

## 技术栈

| 层 | 技术 |
|---|------|
| 前端框架 | uni-app 3（Vue 3 + Vite + Pinia） |
| 跨端 | 微信小程序 + H5 |
| UI 主题 | 宇宙深空暗色/亮色双主题，CSS 自定义属性 |
| 后端 | Node.js + Express |
| 数据库 | MongoDB（Mongoose 8） |
| 认证 | JWT + 微信登录 |
| 支付 | 微信支付（V3 API） |
| AI 问答 | 多模型适配（AIModel 配置） |

## 快速开始

### 后端

```bash
cd server
cp .env.example .env    # 编辑数据库连接等配置
npm install
npm run dev             # 开发模式（nodemon）
npm start               # 生产模式
```

### 前端

```bash
cd client
pnpm install
pnpm dev:h5             # H5 开发
pnpm build:mp-weixin    # 构建微信小程序
pnpm build:h5           # 构建 H5
```

## API 概览

| 端点 | 说明 |
|------|------|
| `POST /api/auth/login` | 微信/H5登录 |
| `GET /api/knowledge` | 知识列表（按维度筛选） |
| `GET /api/knowledge/search` | 知识搜索 |
| `POST /api/ai-chat/ask` | AI问答 |
| `GET /api/trend` | 趋势资讯 |
| `POST /api/payment/create-order` | 创建支付订单 |
| `GET /api/user/progress` | 学习进度 |
| `GET /api/user/achievements` | 成就列表 |
| `GET /api/user/leaderboard` | 排行榜 |

## 部署

线上服务：`yzr-wdkj.service`（systemd），端口 3001，反向代理至 `wdkj.yuzhiran.com.cn`。

趋势数据由 Hermes cron 每日 8:00 自动更新。

## 版本

v1.1.0 — 详见 [CHANGELOG.md](./CHANGELOG.md)