# cursorrules-cn

**Repository Path**: leonda/cursorrules-cn

## Basic Information

- **Project Name**: cursorrules-cn
- **Description**: CursorRulesCN网站旨在收集和展示中文场景下的cursor规则，为使用Cursor编辑器的开发者提供便利。用户可以浏览、搜索、筛选不同类型的规则，还可以提交自己的规则供审核。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 27
- **Forks**: 1
- **Created**: 2025-03-25
- **Last Updated**: 2025-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CursorRules中文网站

官网地址（已备案）：https://www.cursorrulescn.cn/


## 项目概述
CursorRules中文网站
是一款专注于提升Cursor中文开发者效率的规则查询与代码辅助平台。网站旨在收集和展示中文场景下的cursor规则，为使用Cursor编辑器的开发者提供便利。用户可以浏览、搜索、筛选不同类型的规则，还可以提交自己的规则供审核。
其核心优势在于：

**极简界面设计**：页面布局以功能分区为主，支持快速跳转至代码示例、规则文档等核心模块。

**中文友好适配**：全中文界面及本地化文档，降低非英语开发者的使用门槛，尤其适合国内团队协作场景。

**高效检索系统**：内置智能关键词匹配功能，用户输入部分术语即可联想相关编程规则（如Python缩进、SQL语法等），响应速度媲美专业IDE插件。

![CursorRules中文网站首页](media/logo/1.png)

**无需复杂注册**：类似国内部分高效工具（如ChatGPT镜像网站），用户可直接访问网站使用核心功能，无需繁琐的账号注册流程，节省时间成本。

**极简风格**：页面布局清晰，功能模块分区明确，避免冗余信息干扰，用户可快速定位目标功能。

**多场景覆盖**：若其功能涉及开发辅助，可支持代码规范检查、快捷键自定义等，帮助开发者提升编码效率；若偏向办公场景，可能提供模板化工具或协作管理模。

![规则详情页支持多种格式查看和复制](media/logo/2.png)

**功能迭代**：平台持续更新规则库，引入最新技术及AI相关开发规则，保持新鲜血液。

**用户反馈机制**：提供注册功能，鼓励用户参与新规则对的共享，形成良性互动生态。

![提供注册和规则提交](media/logo/3.png)
 
**本网站完全本人使用cursor独立开发完成，用时4小时，后续计划将本项目开源。** 

## 功能特点

- **🔍 智能筛选和搜索**：支持按编程语言和使用场景多条件筛选，显示每个标签关联的规则数量
- **📄 Markdown 渲染**：规则内容支持 Markdown 格式，包含代码高亮，可在详情页切换MD与文本格式
- **🌙 深色模式**：支持深色/浅色主题切换，并记住用户偏好
- **🔒 安全登录**：登录和注册页面集成验证码，防止恶意攻击
- **📱 响应式设计**：完美适配各种设备屏幕
- **📋 便捷复制**：一键复制规则内容到剪贴板
- **📊 访问统计**：记录网站、规则、文章的访问量和操作数据
- **🎯 广告系统**：支持添加并行展示广告，后台可配置

## 功能模块

### 前台模块
1. **主页**
   - 左侧筛选区 (25%)：支持搜索和多条件筛选，显示标签数量
   - 右侧展示区 (75%)：以卡片形式展示规则，每行3个
   - 顶部广告区：并行显示多个广告(PC端4列，平板2列，手机1列)
   - 每个规则卡片包含：标签、内容(支持Markdown和滚动条)、复制按钮、作者信息、访问量

2. **规则详情**
   - 完整显示规则内容，支持Markdown渲染
   - 支持MD格式和文本格式切换查看
   - 提供复制规则和返回列表功能
   - 显示作者信息、访问统计和相关规则推荐

3. **文章**
   - 文章列表：展示所有文章概览
   - 文章详情：展示完整文章内容，包含访问量统计

4. **提交规则**
   - 规则提交表单
   - 提交后等待管理员审核

5. **关于**
   - 网站信息（管理员可自定义）

6. **用户中心**
   - 登录/注册（含验证码校验）
   - 个人资料管理
   - 退出登录

### 后台模块
1. **规则管理**
   - 添加、编辑、删除规则
   - 审核用户提交的规则

2. **文章管理**
   - 添加、编辑、删除文章

3. **网站信息管理**
   - 编辑"关于"页面内容
   - 管理站点设置

4. **统计信息**
   - 网站访问统计
   - 规则访问和操作统计
   - 文章阅读统计

5. **广告管理**
   - 添加、编辑、删除广告
   - 控制广告显示顺序和状态
   - 查看广告点击统计

## 技术栈

### 后端
- Django 4.2+
- Django REST Framework
- Django Simple Captcha
- MySQL/PostgreSQL

### 前端
- Bootstrap 5
- jQuery
- Markdown 解析与渲染
- 深色模式支持
- 响应式布局设计

### 部署
- Nginx
- Gunicorn
- Redis (缓存)

## 运行环境

- Python 3.8+
- Node.js 14+ (仅用于前端资源编译，可选)
- 详细依赖见 `requirements.txt`

## 快速开始

1. 克隆代码库
```bash
git clone https://github.com/yourusername/cursorrules.git
cd cursorrules
```

2. 安装依赖
```bash
pip install -r requirements.txt
```

3. 迁移数据库
```bash
python manage.py migrate
```

4. 创建超级用户
```bash
python manage.py createsuperuser
```

5. 启动开发服务器
```bash
python manage.py runserver
```

## 数据模型

### CursorRule
- 标题
- 内容
- 标签 (多对多关系)
- 作者
- 创建时间
- 状态 (已审核/待审核)

### Tag
- 名称
- 分类 (语言/场景)

### 访问统计
- 页面访问记录
- 内容访问计数
- 用户操作计数

### 广告
- 标题与描述
- 图片和链接
- 显示状态与顺序
- 点击统计

### 文章
- 标题
- 内容
- 作者
- 创建时间
- 更新时间

### 用户
- 使用Django内置用户模型
- 添加额外的用户配置文件

## 项目结构
```
cursorrules/
├── manage.py
├── cursorrules/             # 项目配置
├── core/                    # 核心应用
│   ├── templatetags/        # 自定义模板标签和过滤器
├── rules/                   # 规则管理应用
├── articles/                # 文章管理应用
├── accounts/                # 用户账户应用
├── static/                  # 静态文件
└── templates/               # HTML模板
```

## 最近更新

- 优化了主页与规则列表页面代码结构，统一使用相同的视图与筛选逻辑
- 修改广告展示方式，从轮播改为一行并排显示4个广告
- 调整广告图片高度，降低视觉干扰
- 修复了筛选功能无法正常工作的问题
- 将网站统计信息移至页脚，使界面更加简洁
- 添加了自动图片处理功能，确保广告图片显示质量
- 深色模式和主题切换功能
- 验证码支持，提高登录和注册安全性
- 规则详情页可切换MD和文本两种格式查看
- 调整了布局比例，使筛选区占25%、展示区占75%
- 优化了规则卡片的显示效果，支持完整内容查看