forked from openkylin/ukui-search
更新README
This commit is contained in:
iaom
parent
ff0dd3384a
commit
b03fb44f6c
95
README.md
95
README.md
|
|
@ -3,7 +3,7 @@
|
|||
[dWIP] UKUI Search is a user-wide desktop search feature of UKUI desktop environment.
|
||||
|
||||
## 简介
|
||||
狭义上的ukui-search指ukui桌面环境中的全局搜索应用，目前最新版本为3.22.x.x。全局搜索应用提供了本地文件、文本内容、应用、设置项、便签等聚合搜索功能，基于其文件索引功能，可以为用户提供快速准确的搜索体验。
|
||||
狭义上的ukui-search指ukui桌面环境中的全局搜索应用，目前最新版本为4.0.x.x。全局搜索应用提供了本地文件、文本内容、应用、设置项、便签等聚合搜索功能，基于其文件索引功能，可以为用户提供快速准确的搜索体验。
|
||||
|
||||
广义的ukui-search除了包括全局搜索应用，还包括在ukui桌面环境中的本地搜索服务以及其开发接口。基于文建索引服务，应用搜索数据服务等基础数据源服务，可以提供基于C++接口的搜索功能，应用开发者可以通过引用动态库的形式直接使用其搜索功能。除此之外，ukui桌面环境搜索服务还提供了一组基于Qt插件框架的插件接口，用户可以通过继承接口以实现搜索功能的扩展。
|
||||
以下提到的ukui-search如无说明均指后者。
|
||||
|
|
@ -19,7 +19,7 @@ ukui-search 目前被打包成6个包（openkylin）：
|
|||
xxx代表版本号。其中，ukui-search 为全局搜索应用本体，libukui-search包提供了搜索服务基本功能以及扩展接口，libukui-search-dev为其开发包。libchinese-segmentation包为搜索服务提供了NLP能力，如中文分词等。ukui-search-systemdbus包提供了一些systemdbus提权操作。
|
||||
|
||||
## 运行
|
||||
搜索服务相关的进程共有5个，包括ukui-search(全局搜索GUI界面)，ukui-search-service(文件搜索服务)，ukui-search-service-dir-manager(文件搜索目录管理), ukui-search-app-data-service(应用数据服务),ukuisearch-systemdbus(systembus)。
|
||||
搜索服务相关的进程共有5个，包括ukui-search(全局搜索GUI界面)，ukui-search-service(文件搜索服务)，ukui-search-service-dir-manager(文件搜索目录管理模块), ukui-search-app-data-service(应用数据服务),ukuisearch-systemdbus(systembus)。
|
||||
|
||||
所有进程默认开机自启。
|
||||
|
||||
|
|
@ -70,9 +70,16 @@ interface: com.ukui.search.service
|
|||
|
||||
搜索的功能有一部分依赖于其他桌面环境组件：
|
||||
|
||||
设置项搜索：依赖ukui-control-center提供的配置文件，安装路径为：
|
||||
设置项搜索：依赖ukui-control-center提供的dbus接口：
|
||||
|
||||
> /usr/share/ukui-control-center/shell/res/search.xml
|
||||
```
|
||||
service:org.ukui.ukcc.session
|
||||
path:/
|
||||
interface:org.ukui.ukcc.session.interface
|
||||
method:getSearchItems () ↦ (Dict of {String, Variant} arg_0)
|
||||
signal:searchItemsAdd(Dict of{String, Variant})
|
||||
searchItemsDelete(Dict of{String, Variant})
|
||||
```
|
||||
|
||||
跳转到搜索结果对应的控制面板页面使用了ukui-control-center的命令行：
|
||||
|
||||
|
|
@ -91,7 +98,7 @@ Options:
|
|||
service: com.kylin.softwarecenter.getsearchresults
|
||||
path: /com/kylin/softwarecenter/getsearchresults
|
||||
interface: com.kylin.getsearchresults
|
||||
get_search_result (String keyword) ↦ (Boolean arg_1)
|
||||
method:get_search_result (String keyword) ↦ (Boolean arg_1)
|
||||
```
|
||||
|
||||
跳转到软件商店安装页面的使用了以下dbus接口：
|
||||
|
|
@ -129,7 +136,7 @@ interface: org.freedesktop.FileManager1
|
|||
|
||||
## 原理与功能特点
|
||||
|
||||
全局搜索支持控制面板设置项搜索，应用搜索，文件搜索，便签本搜索。支持名称，拼音，或拼音首字母搜索（文本内容搜索和便签本搜索不支持拼音搜索）。其中，设置项搜索通过读取控制面板提供的配置文件实现，打开对应的控制面板页面也依赖与控制面板提供的命令行；应用搜索分为本地已安装应用（包括安卓兼容应用）和软件商店已上架的在线应用，在线应用的搜索和跳转安装通过软件商店提供的接口实现。所以，当怀疑搜索的设置搜索或应用搜索有问题时，可以直接测试控制面板或软件商店对应的接口。
|
||||
全局搜索支持控制面板设置项搜索，应用搜索，文件搜索，便签本搜索。支持名称，拼音，或拼音首字母搜索（文本内容搜索和便签本搜索不支持拼音搜索）。其中，设置项搜索通过控制面板提供dbus接口获取数据，打开对应的控制面板页面也依赖与控制面板提供的命令行；应用搜索分为本地已安装应用（包括安卓兼容应用）和软件商店已上架的在线应用，在线应用的搜索和跳转安装通过软件商店提供的接口实现。所以，当怀疑搜索的设置搜索或应用搜索有问题时，可以直接测试控制面板或软件商店对应的接口。
|
||||
|
||||
文件搜索分为文件名（文件夹名）搜索和文本内容搜索。文件搜索有两种模式：`直接搜索`和`建立索引搜索`。
|
||||
|
||||
|
|
@ -138,6 +145,7 @@ interface: org.freedesktop.FileManager1
|
|||
+ 索引搜索：搜索通过遍历文件系统建立数据库（需要消耗一定的时间和资源），搜索时直接对数据库进行搜索，可以实现毫秒级的搜索响应，建立索引的过程中，搜索结果可能不全或者搜不出结果。
|
||||
首次打开索引时，ukui-search-service进程会新建两个数据库分别存储基础索引信息（用于文件名搜索）和文本内容索引信息（用于文本内容搜索），完成首次索引后，索引服务会依赖inotify机制进行实时监听更新。索引关闭再打开或重启服务时，索引服务会对遍历文件并对数据库进行校验以增量更新。
|
||||
索引数据库会基于文件系统监听进行实时更新。但是由于解析文本需要时间，所以大文件的索引新可能会有短暂的延迟。由于各种意外原因，比如索引更新过程中掉电关机，可能会导致索引损坏，此时搜索在下次开机时会重新建立索引来保证正常的文件搜索功能。基于机器配置和本地文件的数量，大小以及种类，索引重建的时间可以从几秒到数分钟不等。
|
||||
搜索目录可以在控制面板中手动配置，目前索引已经支持外接设备。
|
||||
索引搜索支持文本内容搜索，基本原理可以参考 [倒排索引与优麒麟的文件搜索](https://docs.qq.com/doc/DU0p0S1lRelp2aW1y) 。建立索引时，搜索会对常用的文本文件进行解析，提取关键词存入数据库。搜索时，用户输入的文本也会被提取关键词，和数据库中的关键词进行匹配， 所以文本索引并不能保证你搜索一个文本文件里的任意内容都能搜出这个文件，这也不是普遍的应用场景。搜索输入的文本中必须要包含【关键词】才可以。比如你搜索一个‘的’，由于‘的’并不是任何文件的关键词，所以并不会有搜索到任何文件。事实上，我们有一个停用词词库，专门用来排除‘我’‘的’于是‘等等基本上在每个文档都会出现的一些无用词。目前，搜索支持解析的文件格式有：docx，pptx, xlsx, txt(大部分编码格式), doc, dot, wps, ppt, pps, dps, et, xls, pdf，uof，uot，uos，uop，ofd以上格式均不支持加密文件的解析，此外，文件索引支持图片ocr提取文字，所以你也可以通过图片中的文字搜索到图片（就像文档一样），支持的图片格式：png，bmp，gif，tif，tiff，webp，jpe，jpg，jpeg。
|
||||
|
||||
> 注意：应用的.desktop文件并不是应用本身或者“快捷方式”，对于搜索来说它只是一个文件，所以搜索desktop文件的名字并不能搜出这个应用，除非它恰好和应用重名。另外，在文件搜索中显示的dekstop文件并不会以应用的形式显示，而是显示它本来的样子——一个文件。
|
||||
|
|
@ -150,11 +158,13 @@ ukui-search应用和ukui-search-service、ukui-search-app-data-service的配置
|
|||
|
||||
文件说明：
|
||||
|
||||
+ ukui-search.conf ------------------------------------全局搜索GUI配置文件。
|
||||
+ ukui-search-block-dirs.conf ---------------------文件搜索黑名单，在控制面板中设置
|
||||
+ ukui-search-index-status.conf ------------------文件索引服务状态记录
|
||||
+ index_data ---------------------------------------------文件索引数据库
|
||||
+ content_index_data ---------------------------------文本内容数据库
|
||||
+ ukui-search.conf -------------------------------------全局搜索GUI配置文件。
|
||||
+ ukui-search-plugin-order.conf -------------------搜索插件显示顺序
|
||||
+ ukui-search-block-dirs.conf ----------------------文件搜索黑名单，在控制面板中设置
|
||||
+ ukui-search-index-status.conf -------------------文件索引服务状态记录
|
||||
+ ukui-search-current-indexable-dir.conf -------搜索目录配置文件
|
||||
+ index_data --------------------------------------------文件索引数据库
|
||||
+ content_index_data --------------------------------文本内容数据库
|
||||
|
||||
## 编译
|
||||
|
||||
|
|
@ -181,11 +191,11 @@ mkdir build;cd build;qmake ..;make
|
|||
|
||||
## 调试
|
||||
|
||||
ukui-search目前并未采用ukui-log4qt模块的日志功能。如需调试，可在以下目录新建`ukui-search.log`、`ukui-search-service.log`以及`ukui-search-app-data-service.log`文件，分别对应全局搜索GUI应用，全局搜索文件索引服务和应用数据服务。新建日志文件后，日志会自动打印到对应额文件中，但目前日志没有自动备份或删除机制。
|
||||
ukui-search目前并未采用ukui-log4qt模块的日志功能。如需调试，可在~/.config/org.ukui/目录新建`ukui-search.log`、`ukui-search-service.log`以及`ukui-search-app-data-service.log`文件，分别对应全局搜索GUI应用，全局搜索文件索引服务和应用数据服务。新建日志文件后，日志会自动打印到对应文件中，但目前日志没有自动备份或删除机制。
|
||||
|
||||
## 开发接口
|
||||
|
||||
### 搜索服务接口(此接口目前处于快速更新总，请以代码为准)
|
||||
### 搜索服务接口(此接口目前快速更新，请以代码为准)
|
||||
|
||||
#### Use with CMake:
|
||||
|
||||
|
|
@ -210,20 +220,33 @@ PKGCONFIG += ukui-search
|
|||
......
|
||||
//初始化一个搜索实例
|
||||
UkuiSearch::UkuiSearchTask ukst;
|
||||
//初始化需要用到的搜索插件
|
||||
ukst.initSearchPlugin(UkuiSearch::SearchProperty::SearchType::File);
|
||||
//初始化队列
|
||||
UkuiSearch::DataQueue<UkuiSearch::ResultItem> *queue = ukst.init();
|
||||
//加载想要使用的搜索插件
|
||||
ukst.initSearchPlugin(UkuiSearch::SearchType::File);
|
||||
//设置最大结果数量（默认为100）
|
||||
ukst.setMaxResultNum(999999);
|
||||
//添加搜索文件夹
|
||||
QString path = "/home/usr/下载";
|
||||
ukst.addSearchDir("path");
|
||||
//设置需要的信息，将被储存在 UkuiSearch::ResultItem中
|
||||
ukst.setResultProperties(UkuiSearch::SearchProperty::SearchType::File,
|
||||
UkuiSearch::SearchResultProperties{UkuiSearch::SearchProperty::FilePath,
|
||||
UkuiSearch::SearchProperty::FileIconName});
|
||||
//添加关键词，支持添加多个关键词，用 ‘与’的关系搜索,注意，当需要重新添加关键词时需要调用‘clearKeyWords清空关键词’
|
||||
ukst.addKeyword(searchText);
|
||||
//添加搜索条件
|
||||
ukst.setOnlySearchFile(true);
|
||||
ukst.addKeyword(m_keyword);
|
||||
//启动搜索（异步）
|
||||
ukst.startSearch(UkuiSearch::SearchType::File);
|
||||
//执行搜索，参数表示执行搜索的搜索插件，注意每次搜索之前可以调用‘’
|
||||
ukst.startSearch(UkuiSearch::SearchProperty::SearchType::File);
|
||||
//接收结果（示例）
|
||||
while(true) {
|
||||
if(!queue->isEmpty()) {
|
||||
qDebug() << queue->dequeue().getItemKey();
|
||||
}
|
||||
while(!queue->isEmpty()) {
|
||||
auto result = queue->dequeue();
|
||||
//通过属性取值
|
||||
qDebug() << result.getValue(UkuiSearch::SearchProperty::FilePath);
|
||||
//直接获取所有值
|
||||
UkuiSearch::SearchResultPropertyMap map = result.getAllValue();
|
||||
qDebug() << map;
|
||||
}
|
||||
```
|
||||
|
||||
|
|
@ -267,24 +290,30 @@ Q_DECLARE_INTERFACE(UkuiSearch::SearchTaskPluginIface, SearchTaskPluginIface_iid
|
|||
表示加载用户插件
|
||||
|
||||
```c++
|
||||
ukst.initSearchPlugin(UkuiSearch::SearchType::Custom);
|
||||
ukst.initSearchPlugin(UkuiSearch::SearchType::Custom, "<用户自定义的名称>");
|
||||
```
|
||||
|
||||
启动搜索
|
||||
|
||||
```c++
|
||||
ukst.startSearch(UkuiSearch::SearchType::<用户自定义的名称>);
|
||||
ukst.startSearch(UkuiSearch::SearchType::Custom, "<用户自定义的名称>";
|
||||
```
|
||||
|
||||
### 搜索应用插件接口
|
||||
|
||||
搜索应用本身也提供了一个插件接口，可以通过加载用户实现的插件以实现额外搜索功能：
|
||||
搜索应用本身也提供了一个插件接口，可以通过加载用户实现的插件以实现额外搜索以及详情页定制功能：
|
||||
|
||||
```c++
|
||||
namespace UkuiSearch {
|
||||
class SearchPluginIface : public PluginInterface
|
||||
{
|
||||
public:
|
||||
enum InvokableAction
|
||||
{
|
||||
None = 1u << 0,
|
||||
HideUI = 1u << 1
|
||||
};
|
||||
Q_DECLARE_FLAGS(InvokableActions, InvokableAction)
|
||||
|
||||
struct DescriptionInfo
|
||||
{
|
||||
QString key;
|
||||
|
|
@ -305,6 +334,15 @@ public:
|
|||
QVector<DescriptionInfo> description;
|
||||
QString actionKey;
|
||||
int type;
|
||||
ResultInfo(const QIcon &iconToSet = QIcon(), const QString &nameToSet = QString(),
|
||||
const QVector<DescriptionInfo> &descriptionToSet = QVector<DescriptionInfo>(),
|
||||
const QString &actionKeyToSet = QString(), const int &typeToSet = 0) {
|
||||
icon = iconToSet;
|
||||
name = nameToSet;
|
||||
description = descriptionToSet;
|
||||
actionKey = actionKeyToSet;
|
||||
type = typeToSet;
|
||||
}
|
||||
};
|
||||
|
||||
virtual ~SearchPluginIface() {}
|
||||
|
|
@ -313,9 +351,12 @@ public:
|
|||
virtual void stopSearch() = 0;
|
||||
virtual QList<Actioninfo> getActioninfo(int type) = 0;
|
||||
virtual void openAction(int actionkey, QString key, int type) = 0;
|
||||
// virtual bool isPreviewEnable(QString key, int type) = 0;
|
||||
// virtual QWidget *previewPage(QString key, int type, QWidget *parent = nullptr) = 0;
|
||||
virtual QWidget *detailPage(const ResultInfo &ri) = 0;
|
||||
|
||||
void invokeActions(InvokableActions actions);
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
> 接口使用注意事项：
|
||||
|
|
|
|||
Loading…
Reference in New Issue