{"id":50819659,"url":"https://github.com/dtsola/xiaoyaopeipei","last_synced_at":"2026-06-13T12:37:43.257Z","repository":{"id":340801665,"uuid":"1167186663","full_name":"dtsola/xiaoyaopeipei","owner":"dtsola","description":"小遥配配，AI 对话式电脑导购，帮你 24 小时接单。Xiaoyaopeipei, AI-Powered PC Shopping Assistant. Taking Orders 24/7 for You.","archived":false,"fork":false,"pushed_at":"2026-05-22T09:50:42.000Z","size":10191,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T12:37:38.275Z","etag":null,"topics":["agent","ai-assistant","chatbot","conversational-ai","pc-builder","product-recommendation","shopping-assistant"],"latest_commit_sha":null,"homepage":"https://project.xiaoyaosai.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dtsola.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-26T03:01:46.000Z","updated_at":"2026-05-22T09:50:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dtsola/xiaoyaopeipei","commit_stats":null,"previous_names":["dtsola/xiaoyaopeipei_opensource","dtsola/xiaoyaopeipei"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dtsola/xiaoyaopeipei","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtsola%2Fxiaoyaopeipei","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtsola%2Fxiaoyaopeipei/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtsola%2Fxiaoyaopeipei/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtsola%2Fxiaoyaopeipei/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dtsola","download_url":"https://codeload.github.com/dtsola/xiaoyaopeipei/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dtsola%2Fxiaoyaopeipei/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34285191,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai-assistant","chatbot","conversational-ai","pc-builder","product-recommendation","shopping-assistant"],"created_at":"2026-06-13T12:37:41.812Z","updated_at":"2026-06-13T12:37:43.244Z","avatar_url":"https://github.com/dtsola.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 小遥配配\n\n\u003e AI 对话式电脑导购，帮你 24 小时接单\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://www.python.org/)\n[![Vue](https://img.shields.io/badge/Vue-3.4+-brightgreen.svg)](https://vuejs.org/)\n[![FastAPI](https://img.shields.io/badge/FastAPI-0.109+-green.svg)](https://fastapi.tiangolo.com/)\n\n[English](README_EN.md) | 简体中文\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/产品文档/产品截图/宣传海报图.png\" alt=\"小遥配配宣传海报\"\u003e\n\u003c/p\u003e\n\n---\n\n## 简介\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/产品文档/logos/logo.png\" alt=\"小遥配配\" width=\"200\"\u003e\n\u003c/p\u003e\n\n小遥配配是一个 **AI 对话式电脑导购助手**，为电脑店老板提供智能客户需求收集和配置推荐服务的 SaaS 平台，通过 AI 对话方式收集客户需求，智能推荐合适的电脑配置方案。\n\n**核心特点**：\n- 🤖 **AI 智能对话** - 自然语言交互，自动识别客户需求意图\n- 🎯 **精准配置推荐** - 基于需求自动匹配最佳电脑配置方案\n- 📊 **客户线索管理** - 自动收集客户联系方式，不错过任何一个潜在客户\n- 📈 **数据统计分析** - 实时查看营销数据和转化效果，优化经营决策\n- 🚀 **快速部署** - 前后端分离架构，易于部署和扩展\n- 💻 **双端支持** - B 端商家后台 + C 端客户对话界面\n- 📱 **响应式设计** - 支持桌面端和移动端访问\n\n---\n\n## 作者介绍\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/产品文档/产品截图/作者头像.jpg\" alt=\"dtsola\" width=\"120\" height=\"120\" style=\"border-radius: 50%;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003edtsola\u003c/b\u003e — IT架构师 | 一人公司实践者\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  🌐 \u003ca href=\"https://www.dtsola.com\"\u003e个人站点\u003c/a\u003e \u0026nbsp;|\u0026nbsp;\n  📺 \u003ca href=\"https://space.bilibili.com/736015\"\u003eB站\u003c/a\u003e \u0026nbsp;|\u0026nbsp;\n  💬 微信：dtsola（技术交流 | 商务合作）\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/产品文档/产品截图/个人二维码.png\" alt=\"微信二维码\" width=\"120\"\u003e\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"docs/运营文档/开发者交流群图.png\" alt=\"开发者交流群\" width=\"120\"\u003e\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"docs/运营文档/用户交流群图.png\" alt=\"用户交流群\" width=\"120\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csmall\u003e微信联系 \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; 开发者交流群 \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp; 用户交流群\u003c/small\u003e\n\u003c/p\u003e\n\n---\n\n## 功能预览\n\n### C端 - 智能对话，获取推荐\n\n#### 对话首页 - 自然语言交互\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/C端/01-对话首页.png\" alt=\"对话首页\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e🎯 自然语言对话，轻松表达需求\u003c/li\u003e\n\u003cli\u003e🤖 AI 自动识别需求意图\u003c/li\u003e\n\u003cli\u003e⚡ 实时响应，流畅交互体验\u003c/li\u003e\n\u003cli\u003e💬 支持多轮对话，逐步细化需求\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 配置推荐 - 智能匹配方案\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/C端/02-配置推荐-01-为您推荐.png\" alt=\"为您推荐\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e🎲 智能匹配最佳配置方案\u003c/li\u003e\n\u003cli\u003e💰 价格透明，一目了然\u003c/li\u003e\n\u003cli\u003e📋 配置详情清晰展示\u003c/li\u003e\n\u003cli\u003e🏷️ 支持多种配置类型推荐\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/C端/02-配置推荐-02-对比方案.png\" alt=\"对比方案\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e⚖️ 多方案对比，选择更从容\u003c/li\u003e\n\u003cli\u003e📊 配置差异直观展示\u003c/li\u003e\n\u003cli\u003e💡 性价比分析，帮助决策\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 线索提交 - 留下联系方式\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/C端/03-线索提交-01-留下联系方式.png\" alt=\"留下联系方式\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e📱 一键提交联系方式\u003c/li\u003e\n\u003cli\u003e🔔 商家快速跟进\u003c/li\u003e\n\u003cli\u003e🛒 促成交易转化\u003c/li\u003e\n\u003cli\u003e🔐 隐私安全保护\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/C端/03-线索提交-02-提交成功.png\" alt=\"提交成功\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e✅ 提交成功确认\u003c/li\u003e\n\u003cli\u003e⏰ 商家响应时间提示\u003c/li\u003e\n\u003cli\u003e🎯 下一步行动指引\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n### B端 - 商家后台，高效管理\n\n#### 登录注册 - 快速入驻\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/01-登录注册.png\" alt=\"登录注册\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e🔐 简洁安全的登录注册流程\u003c/li\u003e\n\u003cli\u003e✉️ 邮箱验证，保障账号安全\u003c/li\u003e\n\u003cli\u003e⚡ 快速上手，无需培训\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 数据看板 - 经营状况一目了然\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/02-首页-数据看板.png\" alt=\"数据看板\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e📊 核心数据一目了然\u003c/li\u003e\n\u003cli\u003e📈 趋势分析，把握经营状况\u003c/li\u003e\n\u003cli\u003e🎯 关键指标实时追踪\u003c/li\u003e\n\u003cli\u003e📉 转化漏斗可视化\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 配置管理 - SKU 全生命周期管理\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/03-配置管理-01-SKU列表.png\" alt=\"SKU列表\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e💼 配置 SKU 统一管理\u003c/li\u003e\n\u003cli\u003e🔍 快速搜索筛选\u003c/li\u003e\n\u003cli\u003e🏷️ 自定义分类标签\u003c/li\u003e\n\u003cli\u003e📊 库存状态实时显示\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/03-配置管理-02-SKU编辑.png\" alt=\"SKU编辑\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e✏️ 灵活的 SKU 编辑功能\u003c/li\u003e\n\u003cli\u003e📷 支持图片展示，更直观\u003c/li\u003e\n\u003cli\u003e📝 详细参数配置\u003c/li\u003e\n\u003cli\u003e💰 价格设置与调整\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 线索管理 - 客户线索集中管理\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/04-线索管理-01-线索列表.png\" alt=\"线索列表\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e👥 客户线索集中管理\u003c/li\u003e\n\u003cli\u003e🔍 多维度筛选查询\u003c/li\u003e\n\u003cli\u003e📅 时间线视图\u003c/li\u003e\n\u003cli\u003e🏷️ 状态标签追踪\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/04-线索管理-02-线索详情.png\" alt=\"线索详情\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e📋 线索详情完整记录\u003c/li\u003e\n\u003cli\u003e💬 对话历史回溯\u003c/li\u003e\n\u003cli\u003e🎯 推荐方案记录\u003c/li\u003e\n\u003cli\u003e📝 跟进备注功能\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 分享管理 - 专属推广二维码\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/05-分享管理.png\" alt=\"分享管理\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e🎟️ 专属推广二维码\u003c/li\u003e\n\u003cli\u003e📤 一键分享到微信/朋友圈\u003c/li\u003e\n\u003cli\u003e🔗 永久链接，随时随地获客\u003c/li\u003e\n\u003cli\u003e📊 分享数据统计\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n#### 个人中心 - 会员管理与充值\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/06-个人中心-01-支持充值\u0026续期.png\" alt=\"会员管理\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e💳 联系平台充值\u003c/li\u003e\n\u003cli\u003e⏰ 套餐续期管理\u003c/li\u003e\n\u003cli\u003e🔔 会员过期前系统提醒\u003c/li\u003e\n\u003cli\u003e⚙️ 账户设置中心\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cimg src=\"docs/产品文档/产品截图/B端/06-个人中心-02-会员已过期.png\" alt=\"会员已过期\"\u003e\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\u003cul\u003e\n\u003cli\u003e🔒 登录后自动检查会员状态\u003c/li\u003e\n\u003cli\u003e⚠️ 过期状态清晰展示\u003c/li\u003e\n\u003cli\u003e📧 联系续期入口明显\u003c/li\u003e\n\u003cli\u003e🛡️ 权限控制，保障服务安全\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## 快速开始\n\n### 环境要求\n\n- **Node.js**: \u003e= 18.0.0\n- **Python**: 3.10\n- **MySQL**: 8.0\n- **Git**: 最新版本\n\n### 方式一：Docker 部署（推荐）\n\n\u003e 详细的部署指南请参考：[Docker部署文档](docs/部署文档/Docker部署文档.md)\n\n**环境变量配置**：\n\n编辑 `docker/.env` 文件，填写以下必需配置：\n\n| 参数 | 获取方式 | 说明 |\n|------|---------|------|\n| `MYSQL_ROOT_PASSWORD` | 自定义设置\u003cbr\u003e生成：`openssl rand -base64 16` | MySQL root 密码，建议使用强密码 |\n| `MYSQL_PASSWORD` | 自定义设置\u003cbr\u003e生成：`openssl rand -base64 16` | 数据库用户密码，建议使用强密码 |\n| `JWT_SECRET` | 自定义设置\u003cbr\u003e生成：`openssl rand -base64 32` | JWT 密钥，必须是随机字符串（32位以上） |\n| `QWEN_API_KEY` | [阿里云百炼平台](https://bailian.console.aliyun.com/)\u003cbr\u003e开通服务后创建 API-KEY | 通义千问 API 密钥 |\n| `OSS_ACCESS_KEY_ID` | [阿里云 OSS 控制台](https://oss.console.aliyun.com/)\u003cbr\u003e创建 AccessKey 后获取 | OSS 访问密钥 ID |\n| `OSS_ACCESS_KEY_SECRET` | [阿里云 OSS 控制台](https://oss.console.aliyun.com/)\u003cbr\u003e创建 AccessKey 后获取 | OSS 访问密钥 Secret |\n| `OSS_BUCKET` | [阿里云 OSS 控制台](https://oss.console.aliyun.com/)\u003cbr\u003e创建 Bucket 后复制名称 | OSS 存储桶名称 |\n| `OSS_ENDPOINT` | 根据区域选择\u003cbr\u003e• 上海：`oss-cn-shanghai.aliyuncs.com`\u003cbr\u003e• 杭州：`oss-cn-hangzhou.aliyuncs.com`\u003cbr\u003e• 北京：`oss-cn-beijing.aliyuncs.com` | OSS 终端节点 |\n| `OSS_HOST` | 无自定义域名：`https://{bucket}.{endpoint}`\u003cbr\u003e有自定义域名：填写绑定的域名 | OSS 文件访问地址 |\n| `AES_KEY` | 自定义设置\u003cbr\u003e生成：`openssl rand -base64 24 \\| head -c 32` | AES 加密密钥，必须是 32 位字符串 |\n| `MEMBERSHIP_DEFAULT_DAYS` | 自定义设置，默认 `7` | 会员默认天数（注册时赠送） |\n| `MEMBERSHIP_RENEWAL_THRESHOLD` | 自定义设置，默认 `3` | 会员续期提醒阈值（天） |\n\n**快速生成随机密钥**：\n\n```bash\n# 生成 JWT_SECRET（示例）\nopenssl rand -base64 32\n\n# 生成 AES_KEY（必须是32位）\nopenssl rand -base64 24 | head -c 32\n```\n\n**一键启动所有服务**：\n\n```bash\n# 1. 配置环境变量\ncd docker\n# 编辑 .env 文件，填写真实配置\n\n# 2. 启动所有服务（数据库迁移自动运行）\ndocker-compose up -d\n\n# 3. 查看服务状态\ndocker-compose ps\n```\n\n**本地访问地址**：\n- C端前端：http://localhost\n- B端前端：http://localhost/mer\n- 后端 API：http://localhost/api\n\n**优势**：\n- 🚀 一键启动，无需手动配置\n- 📦 环境隔离，不污染本地系统\n- 🔄 自动运行数据库迁移\n- 🛠️ 开发、测试、生产环境一致\n\n---\n\n### 方式二：开发者本地开发\n\n#### 后端启动\n\n```bash\n# 1. 进入后端目录\ncd xiaoyaopeipei-user-merchant-backend\n\n# 2. 创建虚拟环境（Windows）\npy -3.10 -m venv venv\nvenv\\Scripts\\activate\n\n# 3. 安装依赖\npip install -r requirements.txt\n\n# 4. 配置环境变量\ncp .env.example .env\n# 编辑 .env 文件，填写真实配置\n\n# 5. 数据库迁移\nalembic upgrade head\n\n# 6. 启动服务\nuvicorn app.main:app --reload --port 8001\n```\n\n后端运行在：http://localhost:8001\nAPI文档：http://localhost:8001/docs\n\n#### C端前端启动\n\n```bash\n# 1. 进入C端前端目录\ncd xiaoyaopeipei-user-frontend\n\n# 2. 安装依赖\npnpm install\n\n# 3. 启动开发服务器\npnpm dev\n```\n\nC端运行在：http://localhost:3000\n\n#### B端前端启动\n\n```bash\n# 1. 进入B端前端目录\ncd xiaoyaopeipei-mer-frontend\n\n# 2. 安装依赖\npnpm install\n\n# 3. 启动开发服务器\npnpm dev\n```\n\nB端运行在：http://localhost:3001\n\n---\n\n### 方式三：生产环境部署\n\n\u003e 详细的部署指南请参考：[部署文档](docs/部署文档.md)\n\n**部署架构**：\n- 云服务器：阿里云ECS 2核4G\n- Web服务器：Nginx（反向代理 + 静态资源服务）\n- 进程管理：Supervisor\n\n**域名规划**：\n\n| 项目 | 域名 |\n|------|------|\n| **C端** | `user.example.com` |\n| **B端** | `mer.example.com` |\n| **API** | `api.example.com` |\n\n---\n\n## 使用说明\n\n### 商家使用流程（B端）\n\n1. **注册账号**：访问 B 端，完成邮箱注册\n2. **配置管理**：添加电脑配置 SKU，设置价格和分类\n3. **生成二维码**：获取专属推广二维码\n4. **分享推广**：将二维码分享给潜在客户\n5. **查看线索**：实时接收客户线索，快速跟进成交\n6. **数据统计**：查看经营数据，优化营销策略\n\n### 客户使用流程（C端）\n\n1. **扫码访问**：扫描商家专属二维码进入对话页面\n2. **AI 对话**：自然语言表达电脑需求\n3. **获取推荐**：AI 智能匹配最佳配置方案\n4. **对比选择**：查看多个推荐方案，对比选择\n5. **提交线索**：留下联系方式，等待商家联系\n\n---\n\n## 技术栈\n\n### 后端\n\n| 技术 | 版本 | 说明 |\n|------|------|------|\n| Python | 3.10+ | 后端开发语言 |\n| FastAPI | 0.109+ | 高性能 Web 框架 |\n| SQLAlchemy | 2.0+ | ORM 框架 |\n| Alembic | Latest | 数据库迁移工具 |\n| Pydantic | 2.x | 数据验证 |\n| Loguru | 0.7+ | 日志管理 |\n| LangChain | 0.1+ | AI 智能体框架 |\n| 通义千问 | qwen-plus | 大语言模型 |\n| MySQL | 8.0+ | 关系型数据库 |\n| 阿里云OSS | - | 文件存储 |\n| JWT | - | 用户认证 |\n\n### 前端（C端 + B端）\n\n| 技术 | 版本 | 说明 |\n|------|------|------|\n| Vue | 3.4+ | 渐进式前端框架 |\n| Vite | 5.0+ | 下一代构建工具 |\n| TypeScript | 5.0+ | 类型安全的 JavaScript |\n| Ant Design Vue | 4.x | 企业级 UI 组件库 |\n| Vue Router | 4.2+ | 官方路由管理 |\n| Pinia | 2.1+ | 新一代状态管理 |\n| Axios | Latest | HTTP 客户端 |\n| ECharts | 5.4+ | 数据可视化（B端） |\n\n### 部署\n\n| 技术 | 说明 |\n|------|------|\n| Nginx | Web 服务器 / 反向代理 |\n| Supervisor | 进程管理 |\n| Docker | 容器化部署（可选） |\n\n---\n\n## 项目结构\n\n```\nxiaoyaopeipei/\n├── xiaoyaopeipei-user-frontend/         # C端前端项目（Vue 3）\n│   ├── src/\n│   │   ├── api/                         # API 客户端\n│   │   ├── views/                       # 页面组件\n│   │   ├── components/                  # 公共组件\n│   │   ├── stores/                      # 状态管理（Pinia）\n│   │   └── utils/                       # 工具函数\n│   ├── package.json\n│   └── vite.config.ts\n│\n├── xiaoyaopeipei-mer-frontend/          # B端前端项目（Vue 3）\n│   ├── src/\n│   │   ├── api/\n│   │   ├── views/\n│   │   ├── components/\n│   │   ├── stores/\n│   │   └── utils/\n│   ├── package.json\n│   └── vite.config.ts\n│\n├── xiaoyaopeipei-user-merchant-backend/ # 后端项目（FastAPI）\n│   ├── app/\n│   │   ├── api/                         # API 路由层\n│   │   │   ├── user/                    # C端接口\n│   │   │   └── mer/                     # B端接口\n│   │   ├── core/                        # 核心配置\n│   │   ├── models/                      # SQLAlchemy ORM 模型\n│   │   ├── schemas/                     # Pydantic 数据验证\n│   │   ├── services/                    # 业务逻辑层\n│   │   ├── utils/                       # 工具函数\n│   │   └── middleware/                  # 中间件\n│   ├── alembic/                         # 数据库迁移\n│   ├── requirements.txt\n│   └── .env.example\n│\n├── docs/                                # 文档目录\n│   ├── 00-mrd.md                        # 市场需求文档\n│   ├── 01-prd.md                        # 产品需求文档\n│   ├── 03-技术方案.md                    # 技术方案\n│   ├── 代码架构.md                       # 代码架构\n│   ├── 数据库文档.md                     # 数据库设计\n│   ├── 接口文档.md                       # API接口文档\n│   ├── 部署文档.md                       # 部署指南\n│   └── 产品文档/\n│       ├── logos/                       # 品牌素材\n│       └── 产品截图/                    # 功能截图\n│\n└── README.md                            # 本文档\n```\n\n---\n\n## 文档索引\n\n| 文档名称 | 路径 | 描述 |\n|---------|------|------|\n| **MRD文档** | [docs/00-mrd.md](docs/00-mrd.md) | 精益市场需求文档 |\n| **PRD文档** | [docs/01-prd.md](docs/01-prd.md) | 产品需求文档 |\n| **技术方案** | [docs/03-技术方案.md](docs/03-技术方案.md) | 技术架构设计方案 |\n| **代码架构** | [docs/代码架构.md](docs/代码架构.md) | 完整项目代码结构说明 |\n| **接口文档** | [docs/接口文档.md](docs/接口文档.md) | RESTful API接口设计文档 |\n| **数据库文档** | [docs/数据库文档.md](docs/数据库文档.md) | 数据库设计文档 |\n| **部署文档** | [docs/部署文档.md](docs/部署文档.md) | 生产环境部署指南 |\n\n---\n\n## 核心功能\n\n### C端（客户端）\n\n- **AI 智能对话**：基于 LangChain + 通义千问的自然语言交互\n- **意图识别**：自动识别客户需求类型（办公、游戏、设计等）\n- **配置推荐**：根据需求智能匹配最佳配置方案\n- **方案对比**：多方案对比展示，帮助客户决策\n- **线索提交**：一键提交联系方式，促成交易\n\n### B端（商家端）\n\n- **商家认证**：邮箱注册登录，JWT Token 认证\n- **配置管理**：增删改查电脑配置 SKU\n- **线索管理**：查看客户线索列表和详情\n- **数据统计**：访问量、线索量、转化率等数据看板\n- **分享管理**：生成专属推广二维码，追踪来源\n- **个人中心**：账户管理、联系平台充值、套餐续期\n\n---\n\n## 开发规范\n\n### 代码规范\n\n- **Python**: 遵循 [PEP 8](https://pep8.org/) 规范，使用 black + isort 格式化\n- **TypeScript**: 遵循 ESLint + Prettier 规范\n- **命名规范**：\n  - Python: `snake_case`（函数/变量）、`PascalCase`（类）\n  - TypeScript: `camelCase`（变量/函数）、`PascalCase`（类/组件）\n\n### Git 提交规范\n\n```\n\u003ctype\u003e(\u003cscope\u003e): \u003csubject\u003e\n\n# Type 类型\nfeat: 新功能\nfix: bug修复\ndocs: 文档更新\nstyle: 代码格式调整\nrefactor: 重构\ntest: 测试相关\nchore: 构建/工具变动\n```\n\n详细规范请参阅 [CLAUDE.md](.claude/CLAUDE.md)\n\n---\n\n## 贡献指南\n\n欢迎贡献代码、报告问题或提出建议！\n\n### 开发流程\n\n1. Fork 本仓库\n2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'feat: 添加某个功能'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 创建 Pull Request\n\n---\n\n## 常见问题\n\n### Q: 支持哪些大模型？\n\nA: 目前使用阿里云通义千问 (qwen-plus)，后续可扩展支持其他模型。\n\n### Q: 数据如何存储？\n\nA: 使用 MySQL 8.0 存储结构化数据，阿里云 OSS 存储图片等文件。\n\n### Q: 如何自定义 AI 对话提示词？\n\nA: 在后端 `app/services/ai_service.py` 中修改 LangChain 提示词模板。\n\n### Q: 支持移动端吗？\n\nA: 支持。前端采用响应式设计，可在手机浏览器上正常使用。\n\n### Q: 如何充值和续期？\n\nA: 联系平台方进行充值，登录 B 端个人中心可查看会员到期时间并进行续期。系统会在会员过期前发送提醒通知。\n\n### Q: 会员过期后怎么办？\n\nA: 登录后会自动检查会员状态，如已过期会提示联系续期。续期后即可正常使用全部功能。\n\n---\n\n\n## 许可证\n\n本项目采用 [MIT 许可证](LICENSE)\n\n---\n\n## 联系方式\n\n- **项目主页**: [GitHub](https://github.com/dtsola/xiaoyaopeipei)\n- **问题反馈**: [Issues](https://github.com/dtsola/xiaoyaopeipei/issues)\n- **个人站点**: [https://www.dtsola.com](https://www.dtsola.com)\n- **微信**: dtsola（与我建联，备注：github）\n\n---\n\n**小遥配配：AI 对话式电脑导购，帮你 24 小时接单**\n\n**Made with ❤️ by Xiaoyao Team**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtsola%2Fxiaoyaopeipei","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdtsola%2Fxiaoyaopeipei","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdtsola%2Fxiaoyaopeipei/lists"}