前言¶
在 DeepSeek Harness 中开发智能体时，需要让模型访问特定领域的技术文档与源码。如果领域产品（如 Dragonfly 3D World）有大量官方帮助页面和本地 Python 源码，手动整理索引或依赖不稳定的网络爬虫都难以保证准确性和时效性。下面介绍一个本地化、版本感知的检索代理插件，它能在用户本地环境内搜索 Dragonfly 的官方帮助与 Python 源码。
插件定位¶
Dragonfly Chatbot 是 howpy 维护的 DeepSeek Harness 插件，属于「联网工具」分类。它为 Dragonfly 3D World 提供内置功能的智能问答支持，在用户计算机上搜索官方帮助页和 Python 源码，并返回带引用的答案。插件不依赖网络抓取，仅读取本地已提取的文档文本和指定目录下的源码文件。
核心功能¶
- 版本感知的帮助搜索：默认使用检测到的 Dragonfly 版本进行帮助检索；支持显式指定版本（如 2027.1）。查询结果包含引用的原文行。
- 本地 Python 源码检索：在用户安装目录的
python/OrsPythonPlugins、ORSServiceClass、OrsHelpers、OrsLibraries、ORSModel下进行只读搜索。 - 多语言支持：内置 525 页 Dragonfly 2027.1 英文帮助；中文查询会触发双语词扩展，答案可在中英文之间。
- 环境诊断：提供
dragonfly-chatbot doctor命令，报告 Dragonfly 是否存在、路径、版本和帮助覆盖情况。 - 可配置的检索范围：通过
maxResults控制每条搜索返回的最大结果数（1–20，默认 8）。
安装与启用¶
该插件要求 Node.js >= 22.19 和 DeepSeek Harness 0.2.1-rc.2。
安装命令：
dsh plugin add github:howpy/dragonfly_chatbot#v0.2.0
首次激活时，插件会检查本地 Dragonfly 安装路径：
- Windows：检查卸载注册表、标准安装位置、驱动根目录的产品文件夹和 PATH。
- Linux/macOS：尝试最佳路径，但未在这些系统上充分测试。
- 可通过环境变量
DRAGONFLY_ROOT/DRAGONFLY_HOME或配置字段dragonflyPath指定自定义路径。 - 检测仅验证可执行文件和产品目录结构，不会启动 Dragonfly 或扫描整盘。
若未检测到 Dragonfly，插件仍可运行在「帮助模式」；首次回答会明确提示，且工具返回中会说明当前为帮助模式。
安装 Dragonfly 或更改路径后，请重新加载插件。
配置项¶
在 Harness 的 dragonfly-chatbot 行中配置以下字段：
dragonflyPath（可选）：产品根目录或可执行文件路径，用于覆盖自动检测。helpCorpusFile（可选）：额外的帮助 JSON 文件路径，用于导入额外帮助内容。maxResults（可选）：每条搜索返回的最大结果数，范围 1–20，默认 8。
典型用法¶
在 Harness 中调用工具：
search_dragonfly_knowledge：版本过滤的帮助搜索。search_dragonfly_source：有字节预算的只读本地 Python 搜索。read_dragonfly_evidence：读取上述搜索返回的 ID 对应的原文。get_dragonfly_corpus_status：查看环境、路径、版本和帮助覆盖情况。
命令行示例（来自 README）：
dragonfly-chatbot doctor
dragonfly-chatbot doctor --dragonfly-path "D:/Dragonfly2027.1"
dragonfly-chatbot search --query "threshold segmentation" --version 2027.1
dragonfly-chatbot source --query "Channel" --version 2027.1
导入额外帮助（仅支持 help 类型和特定版本）：
dragonfly-chatbot import --root HELP_PATH --source-id my_help --version 2027.1 --kind help --out help.json
适用场景与注意¶
- 适合在 DeepSeek Harness 中构建 Dragonfly 3D World 技术支持智能体，需要访问官方帮助和本地 Python 源码。
- 插件以当前 DSH 进程权限运行，请提前检查源码与许可证后再安装使用。
- 仅读取本地提取的帮助文本和指定源码目录；不分发产品源码、二进制、扩展或安装包。
- 搜索有文件/字节预算，可能返回截断内容；未命中不代表 API 不存在。
- 插件仅包含 525 页 Dragonfly 2027.1 帮助，其他版本或产品代码不包含在 corpus 中。
- 导入 corpus 时仅支持
help类型和特定版本，拒绝产品源码和其他帮助版本。
总结¶
Dragonfly Chatbot 为 DeepSeek Harness 提供了一个本地化、版本感知的 Dragonfly 知识与源码检索接口。它通过 search_dragonfly_knowledge 和 search_dragonfly_source 工具，将检索到的证据送入模型上下文，再由 LLM 生成答案。检索是确定性的，答案质量也取决于模型。插件本身不存储持久化索引，也不会导出源码，仅作为检索代理运行。
- 插件目录：https://www.skillhub.cn/plugins/howpy/dragonfly_chatbot
- 源码仓库：https://github.com/howpy/dragonfly_chatbot
