前言¶
在 DeepSeek Harness（DSH）里做 Dragonfly 相关支持或二次开发时，常见问题往往落在扩展手册、Help 文档或本地 Python 源码上：模型若只靠对话记忆，容易把不同版本、不同扩展的能力混在一起。手工翻目录又慢，且很难在回复里标明依据。
下面介绍社区插件 dragonfly_chatbot（维护者 caozixiong，npm 包名 dsh-dragonfly-chatbot）。它把可检索的语料挂到 Harness 工具链上，让智能体通过显式工具查询并读取证据，再在回答中引用 evidence ID 与源码行号。检索在本地完成，插件本身不发起外网请求；Harness 仍会按你所选模型把问题与检索结果发给模型服务，这一点与「是否联网」要分开理解。
这是什么¶
dragonfly_chatbot 是面向 DeepSeek Harness 的 Dragonfly 技术知识检索插件。SkillHub 目录将其归类为联网工具（web-tools），仓库地址为 caozixiong/dragonfly_chatbot。
官方简介为：Dragonfly technical knowledge search and cited answers for DeepSeek Harness。更完整的 manifest 描述为：面向 Harness 的版本感知本地 Dragonfly 文档与 Python 源码检索（Version-aware local Dragonfly documentation and Python source search for DeepSeek Harness）。
当前目录同步版本为 v0.1.0，GitHub 星标为 0，许可证 MIT。SkillHub 校验安装性为 verified。
核心功能¶
插件向 Harness 注册三类工具（名称以仓库 README 为准）：
| 工具 | 作用 |
|---|---|
search_dragonfly_knowledge |
BM25 检索，支持中文别名、API/标题精确词，以及版本与文档类型的严格过滤 |
read_dragonfly_evidence |
按 evidence ID 读取命中片段，输出有界文本与引用坐标 |
get_dragonfly_corpus_status |
查看已加载语料的来源类型、版本与条数 |
行为要点（均来自项目 README）：
- 内置 162 份来自 112 个 Prototype Apps 扩展的第一方手册，以及三份原创工程说明；不包含 Dragonfly 专有 Help 或你已安装的 Python 源码，后者需自行导入。
- 在常规 Harness 提示词上增加 Dragonfly 相关指引，不替换完整系统提示，也不关闭宿主其它工具。
- 检索为词法级（BM25），无 embedding 或 reranker；跨语言随意改述可能匹配不到。项目不承诺端到端 LLM 答案准确率；在语料与查询相同的前提下，显式工具调用的证据结果与聊天模型无关。
- 插件进程不进行网络请求；问题与检索到的文本仍会经 Harness 发往你所配置的模型服务。若证据必须留在本机，应选用本地模型，并勿向语料中导入凭据、客户数据或敏感配置（详见仓库
NOTICE.md）。
环境要求（README 写明）：DeepSeek Harness 0.2.1-rc.2，Node ≥ 22.19.0（文档在 Node 22.23.3 下测试）。无需构建步骤、Python 环境、Ollama，也无需关闭 Dragonfly。
安装与启用¶
在 web profile 下，README 给出的安装命令为：
dsh plugin --profile web add github:caozixiong/dragonfly_chatbot#v0.1.0
SkillHub 安装方案另提供钉到精确 commit 的写法（与目录同步的 headSha 一致时可用）：
dsh plugin --profile web add github:caozixiong/dragonfly_chatbot#30d8f81a192f905112763cee138eeb8741fdb13b
安装后需重新加载或重启 web profile（例如 dsh --profile web）。若使用 Desktop 管理的 profile，应在应用内插件管理器中安装；CLI 的 web profile 与之分离。本插件没有自定义浏览器面板。
卸载示例：
dsh plugin --profile web remove dsh-dragonfly-chatbot
典型用法¶
在会话里提问¶
安装并重启后，可直接用自然语言要求智能体调用插件，例如 README 中的英文与中文示例：
- “Use dragonfly_chatbot to find which Prototype Apps tool measures mesh surface area. Read and cite its manual.”
- “查询网格整体测量功能，并引用依据。”
智能体应通过 search_dragonfly_knowledge 与 read_dragonfly_evidence 拉取证据后再作答。
导入本地 Help 与 Python 源码¶
若需检索本机 Dragonfly Help 或 OrsPythonPlugins 等目录，项目提供 bin/dragonfly-chatbot.mjs 命令行（需在仓库中安装依赖后使用）。README 示例流程如下。
先安装依赖并查看帮助：
cd dragonfly_chatbot
npm ci --ignore-scripts
node bin/dragonfly-chatbot.mjs --help
在 Windows 上可按实际路径替换示例，导入并合并语料：
node bin/dragonfly-chatbot.mjs import --root 'D:/DragonflyHelp' --source-id help_2027_1 --version 2027.1 --kind help --out 'D:/DragonflyKnowledge/help.json'
node bin/dragonfly-chatbot.mjs import --root 'D:/Dragonfly/python/OrsPythonPlugins' --source-id python_2027_1 --version 2027.1 --kind source_code --out 'D:/DragonflyKnowledge/source.json'
node bin/dragonfly-chatbot.mjs merge --corpus 'D:/DragonflyKnowledge/help.json' --with 'D:/DragonflyKnowledge/source.json' --out 'D:/DragonflyKnowledge/combined.json'
node bin/dragonfly-chatbot.mjs search --corpus 'D:/DragonflyKnowledge/combined.json' --query 'getAllRepresentableInstances' --version 2027.1
导入有体积与深度上限（如单文件 2 MiB、合计 32 MiB 源文本、最多 10 000 个 eligible 文件等），超大文件会跳过并在报告中说明。
在 Harness 中指向合并后的语料，可在 profile 的 cordis.patch.yml 中配置（路径换成你的实际文件）：
- id: dragonfly-chatbot
config:
corpusFile: 'D:/DragonflyKnowledge/combined.json'
includeManuals: true
maxResults: 8
更新语料后需重新加载；用 get_dragonfly_corpus_status 确认加载情况。includeManuals: false 可只保留扩展手册之外的三份 starter 笔记。严格 version 过滤会排除其它版本及未标注版本的来源；内置手册版本未指定时，检索时不加版本过滤并人工核对正文后再做兼容性结论。
适用场景与注意¶
适合谁
- 在 DSH 中为 Dragonfly / Prototype Apps 做技术支持、脚本排错或 API 查阅，且希望回答能追溯到手册或源码行。
- 愿意维护本地语料（可选导入 Help 与 Python 树），并接受词法检索对表述方式的限制。
权限与安全
DSH 插件以当前 dsh 进程权限运行。安装前请自行审阅 GitHub 源码 与 MIT 许可证；SkillHub 的 verified 仅表示 manifest 等校验通过，不是安全审计。
社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；Harness 生态本身是「一切皆插件」，第三方条目需按依赖惯例评估风险。
其它注意
- 移除插件不会删除你已生成的
combined.json等导入文件；升级请安装带明确 tag 的新版本。 - 仓库由 DragonflyPrototypeLabs 的
deepseek_harness_agent/dragonfly_chatbot子项目导出，仅该子项目公开；手册快照脚本面向开发检出，终端用户不必运行。
小结¶
dragonfly_chatbot 把 Dragonfly 扩展手册与可选本地 Help/源码纳入 Harness 工具检索，通过 evidence ID 与行号支撑可核对的技术回答；安装以 dsh plugin --profile web add 为准，并需 Node 22.19+ 与 Harness 0.2.1-rc.2。
- 目录页：https://www.skillhub.cn/plugins/caozixiong/dragonfly_chatbot
- 源码与 README：https://github.com/caozixiong/dragonfly_chatbot
