# ink-rules-web

**Repository Path**: AlQIQI/ink-rules-web

## Basic Information

- **Project Name**: ink-rules-web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-20
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# InkRules 管理系统

InkRules是一个基于Next.js 16构建的现代化管理平台，包含登录认证和完整的CRUD功能。

## 功能特性

### 1. 登录认证
- 用户登录页面
- Token认证机制
- 登录状态持久化
- 自动路由保护

### 2. 用户管理（CRUD）
- **创建**：新增用户信息
- **查询**：查看用户列表，支持搜索功能
- **更新**：编辑用户信息
- **删除**：删除用户（保护管理员账户）

### 3. 模型接入管理
- AI模型配置和管理
- 支持多种提供商（OpenAI、Anthropic、Google、Azure等）
- Temperature和Max Tokens参数配置
- 模型类型选择（对话/补全）

### 4. 智能体管理
- AI智能体创建和配置
- 关联AI模型
- 系统提示词配置
- 头像设置
- 参数调优

### 5. 小说管理
- 小说内容管理
- 分类管理（玄幻/都市/言情/科幻/武侠）
- 章节和字数统计
- 评分系统（0-5星）
- 封面图片支持
- 状态跟踪（连载中/已完结/暂停）

### 6. 章节管理
- 章节内容管理
- 审核状态跟踪
- AI辅助创作

### 7. 作者管理
- 作者信息管理
- 作者主页配置
- 作品统计

### 8. 审核规则
- 自定义审核规则
- 规则分类管理
- 规则启用/禁用

### 9. AI任务管理
- 任务监控
- 任务历史
- Token消耗统计

## 技术栈

- **框架**: Next.js 16.2.4
- **React**: 19.2.4
- **TypeScript**: 5.x
- **样式**: Tailwind CSS 4
- **路由**: Next.js App Router

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 启动开发服务器

```bash
npm run dev
```

服务器将在 http://localhost:3000 启动

### 3. 访问系统

浏览器打开: **http://localhost:3000**

系统会自动跳转到登录页面。

### 4. 登录系统

**测试账号:**
- 用户名: `admin`
- 密码: `admin123`

## 项目结构

```
ink-rules-web/
├── src/
│   ├── app/
│   │   ├── login/                    # 登录页面
│   │   │   └── page.tsx
│   │   ├── admin/                    # 管理后台
│   │   │   ├── page.tsx             # 管理首页（仪表盘）
│   │   │   ├── list/                # 用户管理
│   │   │   │   └── page.tsx
│   │   │   ├── models/              # 模型管理
│   │   │   │   └── page.tsx
│   │   │   ├── agents/              # 智能体管理
│   │   │   │   └── page.tsx
│   │   │   ├── novels/              # 小说管理
│   │   │   │   └── page.tsx
│   │   │   └── ...                  # 其他管理模块
│   │   ├── api/                     # API路由
│   │   │   ├── auth/
│   │   │   ├── users/
│   │   │   ├── models/
│   │   │   ├── agents/
│   │   │   ├── novels/
│   │   │   └── ...
│   │   ├── page.tsx                 # 首页（重定向到登录）
│   │   └── layout.tsx              # 根布局
│   ├── components/                   # React组件
│   ├── hooks/                       # 自定义Hooks
│   ├── lib/                         # 工具库
│   └── types/                       # TypeScript类型
├── package.json
└── tsconfig.json
```

## 常用命令

```bash
# 开发模式
npm run dev

# 构建生产版本
npm run build

# 启动生产服务器
npm start

# 代码检查
npm run lint
```

## API接口文档

### 基础URL
```
http://localhost:3000/api
```

### 认证接口

#### POST /api/auth/login
用户登录

**请求体:**
```json
{
  "username": "admin",
  "password": "admin123"
}
```

**响应:**
```json
{
  "message": "登录成功",
  "token": "...",
  "user": {
    "id": 1,
    "username": "admin",
    "name": "管理员",
    "role": "admin"
  }
}
```

### 用户接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/users | 获取所有用户 |
| POST | /api/users | 创建新用户 |
| GET | /api/users/:id | 获取单个用户 |
| PUT | /api/users/:id | 更新用户 |
| DELETE | /api/users/:id | 删除用户 |

### 模型接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/models | 获取所有模型 |
| POST | /api/models | 创建新模型 |
| GET | /api/models/:id | 获取单个模型 |
| PUT | /api/models/:id | 更新模型 |
| DELETE | /api/models/:id | 删除模型 |

### 智能体接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/agents | 获取所有智能体 |
| POST | /api/agents | 创建新智能体 |
| GET | /api/agents/:id | 获取单个智能体 |
| PUT | /api/agents/:id | 更新智能体 |
| DELETE | /api/agents/:id | 删除智能体 |

### 小说接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/novels | 获取所有小说 |
| POST | /api/novels | 创建新小说 |
| GET | /api/novels/:id | 获取单个小说 |
| PUT | /api/novels/:id | 更新小说 |
| DELETE | /api/novels/:id | 删除小说 |

## 界面预览

### 登录页面
- 简洁美观的登录界面
- 表单验证
- 错误提示

### 管理首页（仪表盘）
- 统计卡片展示
- 快捷操作入口
- 最近活动
- 功能模块导航

### 管理页面
- 响应式表格设计
- 实时搜索功能
- 模态框表单
- 状态徽章显示
- 角色和状态标识

## 注意事项

1. **数据存储**: 当前使用内存存储，重启后数据会重置
2. **安全性**: 这是演示版本，生产环境需要使用JWT等安全认证
3. **密码加密**: 实际应用应该对密码进行加密存储
4. **数据库**: 建议集成真实的数据库系统（MySQL/MongoDB等）

## 后续扩展建议

### 短期优化
1. 添加分页功能
2. 实现数据导出（CSV/Excel）
3. 添加图表统计（Chart.js）
4. 实现批量操作
5. 添加消息通知

### 中期扩展
1. 集成真实数据库
2. 使用JWT认证
3. 添加角色权限系统
4. 实现文件上传
5. 添加操作日志
6. 实现WebSocket实时更新

### 长期规划
1. 微服务架构
2. Docker容器化
3. CI/CD流水线
4. 单元测试
5. E2E测试
6. 性能优化

## 常见问题

**Q: 为什么刷新页面后要重新登录？**  
A: 当前使用内存存储，生产环境会使用数据库持久化

**Q: 如何修改测试数据？**  
A: 编辑对应的API路由文件

**Q: 如何添加新字段？**  
A: 修改表单和数据接口定义即可

**Q: 支持哪些浏览器？**  
A: Chrome、Firefox、Safari、Edge等现代浏览器