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

This commit is contained in:
卡若
2026-02-03 11:36:53 +08:00
parent 1219166526
commit b404bf546e
131 changed files with 37618 additions and 3930 deletions

View File

@@ -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. **测试验证** - 功能开发后浏览器验证