diff --git a/README.md b/README.md index fce6704..691b12f 100644 --- a/README.md +++ b/README.md @@ -28,9 +28,17 @@ GET /api/images ] } ``` +偏好推荐 +0. 使用权重推荐模型(propose=true) +* 根据用户ID作为权重推荐 +* 根据来源图像作为权重推荐 +* 根据浏览历史作为权重推荐 + + 标准查询(select) +0. 按照名称搜索(search=xxx) 1. 按照标签查询权重最相近的(tag=tag1) -2. 按照时间段查询(date=20210203~20220102||20210203+||20210203-) +2. 按照时间区间查询(date=20210203~20220102||20210203+||20210203-) 3. 按照发表用户查询(user=1234) 4. 按照精选集查询(choice=1234) @@ -52,7 +60,8 @@ GET /api/images 数据排序(sort) -1. 按照时间正反序(sort=date+||date-) +1. 按照时间正反排序(sort=date+||date-) +2. 按照热门正反排序(sort=hot+||hot-) 列表分页(page) @@ -69,15 +78,25 @@ GET /api/tags next: true, list: [ { - id: 1234, // 标签ID - name: 'tagName', // 标签名 - count: 2, // 标签索引的图像数量 + id: 1234, // 标签ID + name: 'tagName', // 标签名(按照请求语种对应变化, 支持简体中文,繁体中文,英文,日文) + count: 2, // 标签索引的图像数量(非实时, 应避免使用) } ] } ``` +标准查询(select) +0. 按照名称模糊搜索(search=xxx) +1. 按照创建时间区间查询(date=20210203~20220102||20210203+||20210203-) -## 实时搜索 +数据排序 +1. 按照时间正反排序(sort=date+||date-) +2. 按照热门正反排序(sort=hot+||hot-) + +* 标签以ID为准而非以标签名为准, 因为需要支持多语种翻译 +* 指定语种 headers: Accept-Language: zh-cn;q=0.8,en-US;q=0.9 (义:优先支持英文,如果没有英文则支持中文) + +## 搜索推荐 WS /api/search ```javascript @@ -93,3 +112,40 @@ WS /api/search ``` * 选中搜索框时建立WS连接 * 离开搜索框时应及时断开WS连接 + + +## 浏览记录 +GET /api/history + +```javascript +{ + page: 1, + pageSize: 20, + next: true, + list: [ + { + time: '2021-12-12 09:24:33', + type: 'image' + data: { + id: 1234, + width: 512, + height: 512 + } + }, + { + time: '2021-12-12 09:24:33', + type: 'article' + data: { + id: 1234, + title: '文章标题' + } + } + ] +} +``` + +筛选 +1. 按类型筛选(type=image) +2. 按时间区间筛选(date=20210203~20220102||20210203+||20210203-) +* 浏览记录属于日志没有ID, 以用户身份与时间区间批量操作(移除记录) +* 浏览记录默认30天内保留最大1000条(不超过1000条的保留全部记录)