chore: 以本地为准，上传全部并替换 GitHub

2026-02-03 11:36:53 +08:00
parent 1219166526
commit b404bf546e
131 changed files with 37618 additions and 3930 deletions
--- a/.cursor/rules/shensheshou.mdc
+++ b/.cursor/rules/shensheshou.mdc
@@ -0,0 +1,179 @@
+---
+description: 神射手数据中台项目规则 - 每次对话前必读
+globs: **/*
+alwaysApply: true
+---
+
+# 神射手数据中台 - Cursor规则
+
+## 一、对话前必读文档
+
+每次开始对话前，必须先读取以下文档了解项目上下文：
+
+```
+1. 开发文档/00_项目核心文档.md  → 数据库结构、AI规则、API规范
+2. 开发文档/01_开发进度文档.md  → 当前进度、待办任务、落地规范
+3. 开发文档/02_提示词文档.md   → 历史对话提示词、默认规则
+```
+
+## 二、项目记忆要点
+
+### 2.1 技术栈
+- 前端: Next.js 14 + Radix UI + TailwindCSS + Recharts
+- 后端: Python FastAPI + MongoDB
+- AI模型: Qwen2.5(本地) / DeepSeek
+
+### 2.2 数据库
+- 地址: `mongodb://localhost:27017`
+- 主库: `KR` (用户估值)
+- 数据库: `KR_腾讯`(7亿), `KR_微博`(1.4亿), `KR_京东`, `KR_存客宝`
+
+### 2.3 核心查询规则
+```javascript
+// 手机号: 11位 1[3-9]开头
+// QQ号: 5-11位数字
+// 微博UID: uid字段
+// RFM评分: 0-100分
+// 用户等级: S/A/B/C/D
+```
+
+### 2.4 AI Skill位置
+```
+/Users/karuo/Documents/个人/卡若AI/04_卡火（火）/_团队成员/火炬/神射手/SKILL.md
+```
+
+## 三、对话后更新规范
+
+每次对话结束后，必须更新以下内容：
+
+1. **开发进度文档**
+   - 标记完成的任务 ✅
+   - 添加完成日期
+   - 更新待办任务
+
+2. **提示词文档**
+   - 记录用户提示词
+   - 记录执行结果
+   - 记录时间节点
+
+3. **项目核心文档**
+   - 新发现的规则
+   - 数据库结构变更
+   - API接口更新
+
+## 四、UI设计规范
+
+### 4.1 风格
+- 苹果毛玻璃风格 (backdrop-blur)
+- 渐变背景 (from-slate-50 via-blue-50/30 to-purple-50/20)
+- 圆角卡片 (rounded-xl)
+- 阴影效果 (shadow-lg)
+
+### 4.2 颜色
+```css
+/* 主色调 */
+purple-500 → purple-600  /* 主要按钮 */
+blue-500 → blue-600      /* 次要按钮 */
+green-500                 /* 成功状态 */
+red-500                   /* 错误状态 */
+yellow-500                /* 警告状态 */
+
+/* 背景 */
+bg-white/80              /* 卡片背景 */
+bg-gradient-to-r         /* 渐变背景 */
+```
+
+### 4.3 图标
+- 使用 lucide-react 图标库
+- 每个模块有专属图标和emoji
+- 状态有对应颜色图标
+
+## 五、代码规范
+
+### 5.1 文件结构
+```
+app/
+├── page.tsx              # 首页
+├── [module]/             # 功能模块
+│   ├── page.tsx          # 模块首页
+│   └── [subpage]/        # 子页面
+│       └── page.tsx
+```
+
+### 5.2 组件规范
+```typescript
+"use client"  // 客户端组件必须声明
+
+import { useState, useEffect } from "react"
+import { Card, Button } from "@/components/ui"
+import { Icon } from "lucide-react"
+
+export default function PageName() {
+  // 状态定义
+  const [data, setData] = useState([])
+  
+  // 副作用
+  useEffect(() => {
+    // 初始化逻辑
+  }, [])
+  
+  // 事件处理
+  const handleAction = () => {
+    // 处理逻辑
+  }
+  
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-slate-50 via-blue-50/30 to-purple-50/20">
+      {/* 页面内容 */}
+    </div>
+  )
+}
+```
+
+## 六、API规范
+
+### 6.1 基础路径
+```
+内部API: /api/[name]/route.ts
+外部API: /api/shensheshou/[endpoint]
+```
+
+### 6.2 响应格式
+```typescript
+// 成功响应
+{
+  success: true,
+  data: {...},
+  message?: string
+}
+
+// 错误响应
+{
+  success: false,
+  error: string,
+  code?: number
+}
+```
+
+## 七、调试与测试
+
+### 7.1 开发服务器
+```bash
+pnpm dev  # 端口 3117，启动在 localhost:3117
+./scripts/start.sh --kill  # 带端口冲突检查
+# 本地端口登记: 卡若AI/00_本地端口登记.md
+```
+
+### 7.2 数据库测试
+```bash
+# 连接本地MongoDB
+mongosh mongodb://localhost:27017
+```
+
+## 八、注意事项
+
+1. **不要删除导航模块** - 保持5个主导航完整
+2. **先读文档再开发** - 确保了解上下文
+3. **及时更新文档** - 保持项目记忆
+4. **中文注释** - 所有注释使用中文
+5. **测试验证** - 功能开发后浏览器验证