# AiMiniprogramSale

**Repository Path**: leejersey/ai-miniprogram-sale

## Basic Information

- **Project Name**: AiMiniprogramSale
- **Description**: 于 **微信小程序 + 微信云开发 + 火山引擎大模型** 的 AI 课程销售助手，帮助销售人员通过智能 AI 顾问为客户提供一对一课程咨询服务。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-02-12
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 课程销售助手小程序

基于 **微信小程序 + 微信云开发 + 火山引擎大模型** 的 AI 课程销售助手，帮助销售人员通过智能 AI 顾问为客户提供一对一课程咨询服务。

## ✨ 功能特性

- 🤖 **AI 智能对话** — 接入火山引擎大模型，专业课程销售话术
- 💬 **仿微信聊天 UI** — 气泡、头像、打字机动画、时间戳
- 🎯 **课程感知** — 根据所选课程动态切换欢迎语和快捷回复
- ⚡ **快捷回复** — 横向滑动 Chip 建议，一键提问
- 📊 **销售追踪** — `salesId` 参数穿透分享链路，支持销售归因
- 🛡️ **内容安全** — 微信 `msgSecCheck` 自动审核用户输入
- 🗄️ **数据持久化** — 云数据库自动记录每次对话
- 👤 **用户中心** — 咨询统计、联系客服、缓存管理

## 📁 项目结构

```
AiMiniProgram/
├── cloudfunctions/               # 云函数
│   ├── chat/                     # AI 对话 + 内容安全 + 日志记录
│   │   ├── index.js
│   │   └── package.json
│   └── getHistory/               # 用户统计 + 咨询记录
│       ├── index.js
│       └── package.json
├── miniprogram/                  # 小程序前端
│   ├── custom-tab-bar/           # 自定义 TabBar（毛玻璃风格）
│   ├── pages/
│   │   ├── index/                # 首页（渐变 Header + 课程卡片）
│   │   ├── chat/                 # AI 聊天页
│   │   └── profile/              # 用户中心
│   ├── app.js / app.json / app.wxss
│   └── sitemap.json
├── project.config.json
└── README.md
```

## 🚀 快速开始

### 1. 环境准备

- 安装 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
- 注册微信小程序账号并开通 **云开发**
- 注册 [火山引擎](https://www.volcengine.com/) 账号，部署模型并获取 API Key

### 2. 导入项目

1. 打开微信开发者工具，选择 **导入项目**
2. 目录选择本项目根目录
3. 填入你的小程序 AppID

### 3. 部署云函数

1. 云开发控制台 → 数据库 → **新建集合 `chat_logs`**
2. 右键 `cloudfunctions/chat` → **上传并部署：云端安装依赖**
3. 右键 `cloudfunctions/getHistory` → **上传并部署：云端安装依赖**

### 4. 配置环境变量

云开发控制台 → 云函数 → `chat` → 环境变量：

| 变量名 | 说明 |
|--------|------|
| `VOLCANO_API_KEY` | 火山引擎 API Key |
| `VOLCANO_ENDPOINT_ID` | 模型 Endpoint ID |

### 5. 编译运行

点击开发者工具中的 **编译** 即可预览。

## 🔧 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | 微信小程序原生开发 |
| 后端 | 微信云开发 (Cloud Functions) |
| AI | 火山引擎方舟 (Ark) API |
| 数据库 | 云开发数据库 (MongoDB-like) |

## 📝 注意事项

- **密钥安全**：`VOLCANO_API_KEY` 必须通过环境变量配置，**严禁**硬编码在代码中
- **内容安全**：已集成微信内容安全 API，违规内容将被自动拦截
- **云开发环境**：首次使用需在 `app.js` 中配置 `env` 参数为你的云环境 ID

## 📄 License

MIT