ZHelper Search 配置小工具 YiBook 的详细教程

YiBook 是一个轻量级的电子书阅读器，支持多种格式（如 EPUB、TXT、PDF 等），而 ZHelper Search 是一款强大的搜索辅助工具，可以通过自定义配置为 YiBook 提供增强型搜索功能，比如快速查找电子书内容、在线词典查询等。如果你想将 ZHelper Search 集成到 YiBook 中，本文将为你提供详细的配置教程。

前置条件

在开始之前，请确保以下条件已满足：

1. 安装 YiBook：
   请确保已经在设备上安装了最新版的 YiBook。可以通过其官网下载或应用商店获取。
2. 安装 ZHelper Search：
   下载并安装 ZHelper Search 小工具，确保工具正常运行。ZHelper Search 是一个开源搜索工具，可以通过其 GitHub 页面或其他可信渠道获取。
3. 基本功能了解：
   ZHelper Search 支持通过自定义 URL 配置搜索功能，而 YiBook 提供了外部工具配置接口。因此，我们将通过 URL 配置实现两者的集成。

步骤 1：准备 YiBook 和 ZHelper Search

1. 启动 YiBook
   打开 YiBook，进入主界面。确保你已经导入了一些书籍，以便后续测试搜索功能。
2. 启动 ZHelper Search
   打开 ZHelper Search，确保工具运行正常，并可以通过浏览器或其他应用访问其搜索功能。

步骤 2：获取 ZHelper Search 的搜索 URL

ZHelper Search 提供了一个基础的 URL 模板，允许用户通过 GET 请求直接进行搜索。以下是默认的 URL 格式：

http://localhost:8080/search?q={query}

• localhost:8080 是 ZHelper Search 的默认服务地址。如果你在安装时修改了端口号，请根据实际情况替换。
• {query} 是你想搜索的关键词占位符，YiBook 会将查询内容自动填充到这里。

步骤 3：配置 YiBook 的外部工具

1. 进入 YiBook 设置界面
   在 YiBook 主界面，点击右上角的 菜单按钮（通常是“三个点”或“齿轮”图标），选择 设置（Settings）。
2. 找到外部工具选项
   在设置界面中，向下滚动，找到 外部工具（External Tools） 选项。
3. 添加新工具
   点击 添加工具（Add Tool），弹出配置窗口。
4. 配置工具参数
   在弹出的窗口中，按照以下参数填写：
   • 工具名称（Tool Name）：输入 ZHelper Search，这是工具的显示名称。
   • 调用方式（Invocation Method）：选择 通过 URL（Via URL）。
   • URL 模板（URL Template）：输入以下内容：

     http://localhost:8080/search?q={query}
     

   • 参数设置（Parameters）：在 YiBook 中，{query} 会自动替换为你高亮选中的文本或输入的关键词，因此无需额外修改。
5. 保存配置
   点击 保存（Save） 按钮，完成工具的添加。

步骤 4：测试 ZHelper Search 的功能

1. 打开一本书
   回到 YiBook 的主界面，打开一本书，随意找到一段文字。
2. 选择文本并调用工具
   长按某段文字，弹出选项菜单。你会看到添加的工具 ZHelper Search 显示在菜单中。
3. 执行搜索
   点击 ZHelper Search，YiBook 会调用 ZHelper Search，通过浏览器或内置窗口打开搜索结果页面，显示与你高亮文本相关的内容。

步骤 5：优化配置（可选）

如果你想进一步优化搜索体验，可以根据以下建议进行调整：

1. 修改 ZHelper Search 的默认端口

• 如果你觉得 8080 端口可能与其他服务冲突，可以在 ZHelper Search 的配置文件中修改默认端口号。例如，将端口改为 9090：

  http://localhost:9090/search?q={query}
  

• 修改端口号后，别忘了同步更新 YiBook 中的 URL 模板。

2. 添加更多搜索功能

• ZHelper Search 支持多种搜索模式，例如词典查词、在线百科搜索等。如果需要，可以通过 ZHelper Search 的配置文件添加自定义搜索引擎，比如：
  • 百度搜索：

    https://www.baidu.com/s?wd={query}
    

  • Google 搜索：

    https://www.google.com/search?q={query}
    

  • 在线词典（有道）：

    https://dict.youdao.com/search?q={query}
    

  • 在 YiBook 中重复上述配置步骤，为每个搜索引擎添加独立的工具。

3. 设置快捷键调用工具

• YiBook 支持为外部工具设置快捷键。在工具配置界面中，找到 快捷键（Shortcut） 选项，并绑定一个常用键位（如 Ctrl+Shift+S）。这样你无需通过菜单即可快速调用工具。

常见问题及解决方法

Q1：ZHelper Search 无法连接怎么办？

1. 检查 ZHelper Search 是否正在运行。
2. 确保防火墙未阻止其服务端口（默认 8080）。
3. 如果网络地址非 localhost（例如远程服务器），请将 URL 替换为实际 IP 地址。

Q2：YiBook 无法调用外部工具？

1. 确保 YiBook 是最新版本，部分旧版本可能不支持外部工具功能。
2. 检查 URL 是否正确，尤其是 {query} 占位符是否遗漏。

Q3：搜索结果不准确？

ZHelper Search 的结果依赖配置的搜索引擎。如果搜索结果不符合预期，可以尝试更换搜索引擎 URL。

总结

通过以上步骤，你可以成功将 ZHelper Search 集成到 YiBook 中，实现快速查找功能。无论是本地搜索、在线辞典查询，还是百科知识检索，ZHelper Search 都是 YiBook 的一个强大辅助工具。根据自己的需求，灵活调整搜索引擎和工具配置，让你的电子书阅读体验更加高效！

希望本教程能帮助你顺利完成配置，祝你阅读愉快！