浏览记录与标签语种

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条的保留全部记录)