前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的生态理念。在开发智能体应用时，如果需要集成 EPUB360 模板资源，手动浏览和筛选既耗时又低效。本插件通过封装 API，为智能体提供了直接检索和获取 EPUB360 模板列表的能力，简化了开发流程。

这是什么¶

xby-epub-template-server 是一个智能模板发现助手，属于 DSH 的联网工具类插件。它由 xby-skill 维护，旨在解决 AI 应用在调用 EPUB360 模板时缺乏高效检索手段的问题，支持通过关键词快速定位所需模板。

核心功能¶

• set_xby_apikey：在对话中设置 API 密钥。该操作会自动持久化，重启 DSH 进程后依然有效。
• search_templates：根据关键词搜索 EPUB360 模板。
  • 参数：
    • query：搜索关键词（如“商务”、“教育”、“科技”）。
    • limit：返回结果数量限制，默认 10 个，最大支持 50 个。
  • 返回：JSON 格式的搜索结果列表。

安装与启用¶

使用官方安装命令将该插件添加到 DSH 中：

dsh plugin --profile web add github:xby_skill/xby-epub-template-server

安装完成后，重启 DSH 使插件生效。

典型用法¶

使用前，你需要前往 小笨羊官网 注册并获取 API 密钥。

在 DSH 的聊天界面中，智能体可以调用以下步骤进行操作：

1. 设置密钥：调用 set_xby_apikey 工具，输入你的 API 密钥。
2. 执行搜索：调用 search_templates 工具。例如，输入关键词“商务”，并将 limit 设置为 5，即可获取 5 个相关的 EPUB360 模板信息。

适用场景与注意¶

本插件适合需要集成 EPUB360 模板搜索功能的 AI 智能体开发者。

注意事项：
- 使用前必须拥有小笨羊官网的账号和 API 密钥。
- 插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证（MIT）。
- 该插件仅提供搜索能力，具体的模板渲染逻辑需由应用层自行实现。

结尾¶

安装并配置 API 密钥后，智能体即可具备自动化检索 EPUB360 模板的能力，从而专注于逻辑编排。更多技术细节可查阅 GitHub 仓库。