Typesense功能详细说明

当您安装typesesion软件，fecify中配置完成后，就可以使用typesense的功能了

文本搜索

前台商城，搜索栏文本搜索，可以通过商品标题，商品副标题，商品描述作为搜索的内容。您可以通过配置，决定使用那几个字段进行搜索，以及权重

图片搜索

前台商城，搜索栏部分，用户可以通过上传图片，通过图片相似度进行搜索相关商品，类似于1688的图片搜索

• typesense图片相似度算法，使用的是 ts/clip-vit-b-p32 模型

开启后，在前台商城搜索栏，顾客可以上传图片

商品详情页，商品推荐

在前台商城，商品详情页，描述下方会有几个相关商品推荐，系统默认的是使用商品所在的专辑，专辑下的计算出来几个商品，作为商品推荐。

您可以开启下面的选项，开启后，将通过搜索引擎的图片相似度进行图片搜索，将相似度高的商品进行关联显示

开启后，前台商城，商品详情页，相关商品列表，将通过图片相似度进行搜索推荐。

专辑商品页面

专辑商品页面，和搜索页面一样，也使用typesense搜索引擎来计算商品数据。

专辑类型，加入了智能专辑类型，您可以在下面参看详细介绍

侧栏属性过滤

专辑商品列表页面，关键字搜索商品列表页面，都支持侧栏属性过滤

1.关键字搜索，pc效果

2.关键字搜索，手机下的效果

3.专辑商品列表，pc效果

4.支持价格工具条

5.分面结果数设置，分面结果，也就是属性过滤的子项，譬如颜色属性下的：红色，蓝色，黄色，就是分面结果。 如果您的商品数据是采集的，存在大量不规范的子项，您只想显示结果数比较多的颜色子项，您可以在这里设置最大结果数，譬如：您设置了15， 那么颜色属性子项，最多显示15个

多语言支持

对于侧栏的属性过滤，包括：

• 商品的基本属性：价格，商品可用性，vendor
• 商品的规格属性：颜色，尺码等
• 商品的附加属性：材质，袖长，风格，领口等

对于在前台商城，专辑商品列表，搜索页面，显示的侧栏属性过滤部分，fecify都支持多语言显示，支持属性，以及子项的多语言显示。

智能专辑

fecify目前的专辑和商品的对应关系，是手动勾选的方式，通过专辑id和商品id进行对应，通过typesense，您可以通过商品的属性作为筛选条件， 动态的给专辑添加商品，譬如：商品标题包含dress的商品，商品价格大于100的商品，通过这种方式设置智能专辑的筛选条件，当商品满足这个条件，将自动的添加 到该专辑中。

1.由于mysql的搜索性能一般，智能专辑是目前的saas系统（譬如：shopify）普遍存在的功能，fecify没有开发这种功能，是受限于mysql的性能，通过typesense的搜索能力， 进而实现这种功能。

2.无论是手动分类，还是智能分类，在前台商城，都是通过typesense搜索工具来计算商品数据，而不是走mysql。对于独立站而言，商品数据增多，影响最大的就是搜索页面和专辑商品 列表页面，而商品详情页，首页等其他页面则影响不大，因此通过typesense搜索工具，弥补了这2个页面类型性能不足的短板，独立站的商品数据轻松上几十万商品， 甚至百万商品数据

3.在装修卡片中，有一部分的专辑类型的卡片，通过专辑来选择商品，这里有几点需要注意

• 这里的专辑选择器，只能使用手动类型的专辑（专辑选择器列表，进行了专辑类型过滤，只显示手动类型的专辑，不显示智能类型的专辑）
• 前台显示卡片内容，需要查询专辑商品列表数据，这个部分的数据计算是通过typsense搜索引擎计算的。（系统默认是mysql进行查询商品列表，启用typesense后，这部分数据的计算也是使用typesense）

4.商品编辑页面，选择专辑，在专辑选择器里面，只显示手动类型的专辑，不显示智能类型的专辑（因为智能类型的专辑不需要勾选，因此这里不需要做显示）

5.对于一些其他的部分，譬如：前台商城，优惠券主页的商品列表，满减主页的商品列表，需要指定商品，指定商品的类型有：全部商品，专辑商品，指定商品， 如果您使用的是专辑商品，目前的计算依然是mysql的方式计算的，因此，为了提高性能，您尽量使用指定商品，全部商品，尽量不要使用专辑商品（ 专辑商品也可以使用，不过您的专辑里面的商品尽量少一些，如果这个专辑的商品几万甚至几十万，走mysql会很慢）

对于专辑部分，目前的逻辑大致就这些，建议您仔细参看这些内容。

商品数据自动同步

一.商品数据的变动，包括：

1.商品数据编辑保存

• 商品端后台，商品编辑保存
• excel导入商品
• openApi导入商品

当商品创建，或者商品更改主图的时候，则进行商品图片的同步，该过程会比较慢，因为有下载商品图片，生成base64编码的过程。 如果商品更新数据（没有更新商品主图），为了节省资源，则不更新商品图片，因此商品更新会速度比较快

2.商品的库存变动：

• 订单扣除库存
• 订单返还库存
• 商品可用性状态 availability

3.商品批量操作

• 商品批量编辑
• 商品批量上下架
• 商品批量软删除
• 商品回收站恢复商品
• 商品回收站批量删除商品

4.商品和专辑的对应关系

• 商品专辑批量添加商品
• 商品专辑批量删除商品

5.商品销量

• 订单支付后，计算商品的销量

二：商品数据自动同步

当您在配置中打开该选项（如下截图），则在商品数据变动（商品数据变动类型，包含上面的那些部分），则会自动更新到typesesnse

price，vendor，availability字段

这三个字段，属于fecify系统本身就支持的，因此这三个字段的属性过滤，您需要在fecify系统中进行配置开启

• 进入商家端后台，打开菜单： 店铺 --> 菜单导航
• 进入页面后，可以看到筛选器部分，点击按钮 编辑筛选维度 进行添加即可

特别说明

1.当您使用了typesense搜索，插件进行了开启，而且开启了商品自动同步，那么：

• 您不要开启1688商品推荐插件，因为1688的商品点击后，是即时下载的。
• 如果您开启了1688商品推荐插件，前台商城，商品详情页下面将会显示1688 api搜索推荐的商品，用户点击后，将会自动通过1688的api下载创建商品
• 1688的商品创建后，由于typesense搜索开启了商品自动同步, 需要将商品的数据，图片都推送到typesese，图片需要先下载，这个过程将非常慢
• 如果有多个语言，那么每个语言都单独推送，会非常慢。
• 因此，这种情况下，不要开启1688商品推荐插件。