前言¶

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 倉庫。