Yuzhiran Dev
c1d6dd3b29
- 目录重命名: backend/wdkj-server/ → server/, frontend/ai-dimension/ → client/ - 删除 20+ 冗余文件（WDKJ 旧脚本、Windows 脚本、过时文档、设计稿） - 更新 package.json 元数据（移除 wdkj 命名） - 完善三级 .gitignore（根 + server + client） - 重写 README.md 和 CHANGELOG.md - 工具脚本移至 scripts/
101 lines
3.7 KiB
Markdown
101 lines
3.7 KiB
Markdown
# 宇之然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) |