在开发基于 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 仓库。
