在開發基於 DeepSeek Harness (DSH) 的智能體時，訪問 ANSYS Fluent 官方文檔是高頻需求。然而，Fluent 的在線文檔結構複雜，手動拼接 URL 或在瀏覽器中逐頁翻閱效率較低。xby-fluent 是一個模型上下文協議（MCP）服務器插件，它將文檔檢索轉化爲直接的指令調用，幫助 AI 助手快速定位所需內容。
這是一個由 xby-skill 維護的聯網工具插件。它提供了一個智能 URL 導航服務，包含預映射的主題路徑和官方文檔鏈接。插件通過解析用戶意圖，直接返回相關的文檔入口，省去了在網頁上搜索的時間。
核心功能¶
該插件提供以下四個主要能力：
- set_xby_apikey：在聊天中設置 API 密鑰。該密鑰會自動持久化保存，重啓進程後依然有效。
- search_help：根據搜索詞查找 ANSYS Fluent 文檔 URL。它返回相關的導航提示和鏈接。參數包括
query（搜索詞）和max_suggestions（默認返回 3 個建議）。 - list_topics：列出常見的 Fluent 主題及其快速文檔鏈接。這有助於快速訪問預定義的主題路徑。
- get_manual_link：獲取特定手冊或章節的直接鏈接。參數包括
manual（手冊名稱）和section（可選章節路徑）。
安裝與啓用¶
使用官方安裝命令添加插件到當前環境。
dsh plugin --profile web add github:xby_skill/xby-fluent
安裝完成後，插件將在當前 DSH 進程中生效。
典型用法¶
- 配置密鑰：在對話開始時，通過
set_xby_apikey指令配置所需的 API 密鑰。 - 搜索文檔：輸入查詢內容，系統會調用
search_help返回相關的文檔 URL。隨後，系統使用 WebFetch 工具獲取 URL 的實際內容。 - 主題導航：調用
list_topics獲取常見主題列表，用於快速定位。 - 獲取特定鏈接：使用
get_manual_link獲取特定手冊（如user_guide,tui,theory,udf）的鏈接。
適用場景與注意¶
此插件需要 API 密鑰才能正常工作，請前往 小笨羊官網 註冊並獲取。插件使用 WebFetch 來獲取返回 URL 的內容。許可證爲 MIT。在使用前，請檢查源碼與許可證，確保符合項目要求。
通過上述步驟，智能體可以無縫接入 ANSYS Fluent 的官方知識庫。更多詳情請訪問 插件目錄 或查看 GitHub 倉庫。
