feat: 新增前端首页与缓存资源管理功能

- 添加公共静态目录及首页HTML/CSS/JS文件
- 实现缓存资源列表API,支持分页、过滤与排序
- 移除multer依赖,简化上传功能
- 更新README文档说明新增功能与接口
This commit is contained in:
2025-11-28 22:20:51 +08:00
parent 7d023fc954
commit 15b3926b95
7 changed files with 720 additions and 185 deletions

View File

@@ -19,6 +19,7 @@
- TXT 解析与批量:`server.js:164``server.js:176`
- 静态目录映射:`server.js:192``server.js:193`
- 公共路径与完整 URL`server.js:107``getPublicPath`)、`server.js:121``buildAccessUrl`
- 前端首页注册:`server.js:42``registerPublicHomepage`
## 快速开始
@@ -30,12 +31,86 @@
- 启动服务:`npm start`
- 健康检查:`GET /health``{"ok":true}`
## 前端首页
- 访问路径:`/`
- 内容包含:项目简介、健康检查入口、触发 Seed 抓取入口、免责声明与推荐公共 CDN 列表、已缓存资源的可视化列表(仅展示可直接复制的完整 URL
- 目的:为内部用户提供更直观的访问入口与使用指引
- 高级功能分页加载2050/页)、按名称/类型/更新时间过滤、按名称/大小/时间排序、懒加载与轻量虚拟滚动、统一暗色科技风视觉与动画
## 使用声明(免责声明)
- 本网站收录的开源库均仅支持内部使用,不对外提供公共 CDN 服务
- 如需稳定的外部公共库服务,请使用以下成熟 CDN
- BootCDN 加速服务:`https://www.bootcdn.cn/`
- CDNJS 前端公共库:`https://cdnjs.com/`
- jsDelivr`https://www.jsdelivr.com/`
- 七牛免费 CDN 前端公开库:`https://www.staticfile.org/`
- 又拍云常用 JavaScript 库 CDN 服务:`http://jscdn.upai.com/`
- Google Hosted Libraries`https://developers.google.com/speed/libraries`
- Microsoft Ajax CDN`https://ajax.aspnetcdn.com/`
## 接口说明
- `GET /api/seed`
- 从项目内置 `seed.txt` 读取并批量抓取,无需重启
- 管理抓取仅通过修改服务器上的 `seed.txt` 实现,服务端不接受外部提交 URL
- `GET /api/list-cache`
- 列出当前已缓存的 CSS/JS 文件,按最近修改时间倒序
- 查询参数:
- `type`: `css` | `js`(可选)
- `q`: 关键字(可选,匹配路径片段)
- `limit`: 最大返回条数(默认 200最多 2000
- 返回示例:
```json
{
"count": 200,
"total": 1234,
"hasMore": true,
"items": [
{ "type": "css", "path": "/css/npm/.../file.css", "url": "http://host/css/npm/.../file.css", "size": 12345, "mtime": 1730000000000 }
]
}
```
### 接口更新list-cache 扩展)
- `GET /api/list-cache`
- 支持分页、排序与更丰富的过滤参数:
- `type`: `css` | `js`(可选)
- `q`: 关键字匹配路径片段与URL模糊搜索
- `name`: 库名称(匹配解析出的名称,模糊搜索)
- `updatedFrom` / `updatedTo`: 毫秒时间戳范围过滤(可选)
- `sortBy`: `mtime` | `name` | `size`(默认 `mtime`
- `order`: `asc` | `desc`(默认 `desc`
- `page`: 页码(默认 1
- `pageSize`: 每页条数(默认 30范围 2050
- 返回字段增加:`page`、`pageSize`、`name`、`version`、`ext`、`category`
- 示例:
```json
{
"count": 30,
"total": 1234,
"page": 1,
"pageSize": 30,
"hasMore": true,
"items": [
{
"type": "css",
"path": "/css/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css",
"url": "http://host/css/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css",
"size": 12345,
"mtime": 1730000000000,
"name": "bootstrap",
"version": "5.3.0",
"ext": ".css",
"category": "bootstrap"
}
]
}
```
## 静态访问
- CSS`/css/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css`
@@ -82,4 +157,8 @@
- `.env` 支持(`PORT`),适配多端口部署
- 接口响应统一返回公共路径 `saved` 与完整 URL `accessUrl`
- 依赖升级:`express@^5.1.0`、`multer@^2.0.2`、`axios@^1.13.2`、`morgan@^1.10.1`
- 移除外部提交接口:`POST /api/upload-txt``POST /api/cache`,仅支持通过 `seed.txt` 批量抓取
- 移除外部提交接口:`POST /api/upload-txt` 与 `POST /api/cache`,仅支持通过 `seed.txt` 批量抓取
- 新增前端首页与公共静态目录(`public/`),主页包含免责声明及推荐公共 CDN 列表
- 新增 `GET /api/list-cache` 接口,支持过滤、限制与前端展示一键复制
- 升级首页缓存区域视觉与交互:统一暗色科技风、移除相对路径展示、仅保留完整 URL 复制与打开、优化响应式布局与过渡动画
- 增强缓存管理分页加载2050/页)、按名称/类型/更新时间过滤、按名称/大小/时间排序、轻量虚拟滚动与懒加载、元数据解析(库名/版本/扩展名/类别)