# bilijumper

**Repository Path**: haozexu/bilijumper

## Basic Information

- **Project Name**: bilijumper
- **Description**: Bilibili 网页端广告跳过插件、规则分享平台
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# BiliJumper

BiliJumper 是一个基于 Django 开发的 B站相关时间线管理后端服务，提供用户认证、条目管理、审核等功能。

## 项目简介

BiliJumper 是一个用于管理 Bilibili 相关时间条目的后端系统，支持用户注册登录、时间条目提交、审核管理、点赞反对等功能。系统采用 Django + Django REST Framework 构建，提供完整的 API 接口和 Web 界面。

## 技术栈

- **后端**: Django / Django REST Framework
- **数据库**: MySQL (支持 HBase)
- **前端**: 原生 JavaScript + CSS (PJSK 风格主题)
- **部署**: ASGI (Django Channels)

## 主要功能

### 用户模块 (user)

- 用户注册与登录
- 会话 Token 管理
- 权限系统 (Permission/Grant)
- 用户权限授予与撤销
- 管理员功能
- 封禁用户管理

### API 模块 (api)

- **条目管理**
  - 添加条目（需要审核）
  - 普通用户提交未审核条目
  - 审核通过条目
  - 删除条目
  - 按CID删除条目

- **用户操作**
  - 获取用户信息
  - 用户注册
  - 用户登录/登出
  - 点赞/反对条目

- **审核功能**
  - 获取未审核条目列表
  - 审核通过条目
  - 删除条目

### 异常处理

自定义异常类 (HBaseException)：
- `ServerError` - 服务器错误
- `NotAllowed` - 权限不足
- `AdminOnly` - 仅管理员可用
- `MissingArgument` - 缺少参数
- `InvalidArgument` - 参数无效
- `NotFound` - 资源不存在
- `NoSuchRecord` - 记录不存在
- 用户相关异常：`UserNotFound`、`UserIsBanned`、`InvalidCred`、`UserNotLogin`、`UserExisted`、`IllegalPassword`

## 目录结构

```
bilijumper/
├── api/                    # API 应用
│   ├── api.py            # API 接口实现
│   ├── models.py         # 数据模型
│   ├── tools/            # 工具类
│   │   ├── apibase.py    # API 基础类
│   │   └── apitool.py    # API 装饰器
│   └── urls.py
├── user/                  # 用户应用
│   ├── models.py         # 用户模型
│   ├── usertool.py      # 用户工具函数
│   ├── um_exceptions.py # 用户模块异常
│   └── admin.py         # Django Admin 配置
├── web/                  # Web 应用
│   └── views.py         # 视图函数
├── bilijumper/          # 项目配置
│   ├── settings.py     # Django 设置
│   ├── urls.py         # URL 路由
│   └── asgi.py        # ASGI 配置
├── static/             # 静态资源
│   ├── css/           # 样式文件
│   ├── js/           # JavaScript 文件
│   └── asset/        # 图片资源
└── templates/          # 模板文件
```

## 快速开始

### 环境要求

- Python 3.8+
- Django 4.x
- MySQL 或其他支持的数据源

### 安装

1. 克隆项目：
```bash
git clone https://gitee.com/haozexu/bilijumper.git
cd bilijumper
```

2. 安装依赖：
```bash
pip install django
```

3. 配置数据库：

编辑 `bilijumper/settings.py` 中的数据库配置。

4. 初始化数据库：
```bash
python manage.py migrate
```

5. 运行服务：
```bash
python manage.py runserver
```

## API 接口

### 用户接口

| 方法 | 路径 | 描述 | 认证 |
|------|------|------|------|
| POST | /api/register | 用户注册 | 否 |
| POST | /api/login | 用户登录 | 否 |
| POST | /api/logout | 用户登出 | 是 |
| GET | /api/user_info | 获取用户信息 | 是 |

### 条目接口

| 方法 | 路径 | 描述 | 认证 |
|------|------|------|------|
| POST | /api/add_entry | 添加条目 | 管理员 |
| POST | /api/add_unaudited_entry | 提交未审核条目 | 是 |
| POST | /api/approve_entry | 审核通过 | 管理员 |
| POST | /api/remove_entry | 删除条目 | 管理员 |
| POST | /api/thumb_up_or_down | 点赞/反对 | 是 |
| GET | /api/get_unaudited_entries | 获取未审核条目 | 是 |
| GET | /api/get_entries_by_cid | 按CID获取条目 | 否 |

## 界面预览

项目包含精美的 PJSK 风格前端界面，具有：
- 动态背景效果
- 粒子系统动画
- 加载过渡动画
- 消息提示组件

## 开源协议

本项目仅供学习交流使用，请遵守相关法律法规。

## 贡献者

项目作者：Haozexu

如有问题，请提交 Issue 或 Pull Request。