虚幻引擎离线库 Abeskandr/dsh-ue-db

dsh-ue-db — 为 DeepSeek Harness 打造的离线 Unreal Engine 5.8 数据库

向智能体提问 Unreal Engine 相关问题，它会从本地语料库作答，全程不碰网络。蓝图节点、C++ API、Python API 以及完整的 Epic 文档，都能通过 DSH 中注册的四个工具检索。

You: "how do I cast to another blueprint class"
Agent: [ue_db_search] → Cast To Class (with pin types)

You: "AActor"
Agent: [ue_db_get] → header path, include line, full class signature

⏱ 安装前请先读这段

首次下载要花几小时，不是几分钟。

语料库约 324 MB 文档，刻意不随包发布（GitHub 拒收超过 100 MB 的文件，而且打包进语料库会很快过期）。首次使用时从 Epic 拉取。

Epic 对公开文档限流，大约每秒 4 个请求，超限就封 IP 15–20 分钟。所以完整的首次下载得跑一整夜：

| 范围 | 大致耗时 |
| pyapi — Python API（纯 HTTP，无 Cloudflare） | 约 15 分钟 |
| guides — 3 600 个文档页面 | 约 45 分钟 |
| bpapi — 52 000 个蓝图节点 | 数小时 |
| cppapi — C++ 核心模块 | 约 2.5 小时 |
| 全部 | 挂着跑一整夜 |

不必一次跑完。 每一步都支持续传：随时停下，之后再调 ue_db_update，它会从断点继续，不重复下载任何内容。每一步开始前还会打印预计耗时，所以长时间运行不会看起来像卡死。

如果你只需要回答「哪个节点 / 哪个函数」，部分下载就已经够用——先下 pyapi，再按需补充。

里面有什么

| 来源 | 条目数 | 给智能体提供什么 |
| Blueprint API | 52 314 个节点 | 每个节点及其 Inputs/Outputs 表：引脚类型、名称、描述 |
| C++ API | 30 841 个类 | AActor、UObject、UWorld 等：头文件路径、include 行、完整签名 |
| Python API | 11 642 个类 | unreal. 签名、参数、属性、继承关系 |
| Guides | 3 643 个页面 | Epic 文档，分为 36 个章节：Gameplay、Animation、Niagara、UMG、PCG、Cinematics、Audio…… |

共 98 440 条，磁盘上约 324 MB，索引 70 MB。全部是 dev.epicgames.com 上发布的 Unreal Engine 5.8。

智能体被要求使用它

工具描述告诉模型某个工具是什么，但不能可靠地让模型主动去用——没有引导，模型会凭记忆回答 Unreal 问题，或者去搜网页，而完整的离线语料库就搁在那儿没人用。

所以插件还贡献了一段系统提示词（顺序 210，与其他第一方工具引导并列），大意是：任何 Unreal Engine 问题先查 ue_db_，优先于网页搜索和凭记忆作答，只有数据库确实没有时，才回退到网页答。只有当工具确实出现在调用方的作用域里，这一节才会输出，所以没有这个工具的智能体不会被它打扰。

You: «как сделать двойной прыжок?»
Agent: [ue_db_search] → JumpMaxCount … ← not web_search, not memory

这就是为什么你不必在每次对话里都提醒智能体。

语言

语料库只有英文——Epic 就是这么发布的——插件完全不做翻译。

这是有意为之。智能体已经知道用户用什么语言写的，翻译起来比任何固定词表都好：一份只覆盖多种语言中一种的词典，天生就是残缺的，它给出的答案是悄悄错的，而不是干脆失败。

约定写在工具描述里，模型每一轮都会读到：

| 谁 | 职责 |
| 智能体 | 理解任何语言的问题，搜索前先译成英文，用用户的语言回答 |
| 插件 | 从英文语料库检索，仅此而已 |

User (Russian): «как создать материал»
Agent translates: "create material" -> [ue_db_search]
Agent answers: отвечает по-русски, используя найденное

查询里含非拉丁字符会直接报错拒绝，而不是返回空列表——因为空列表读起来像「Epic 没记录过这个」，这是错的，会让智能体跑去别处搜。报错会告诉智能体先翻译再重试。

安装

dsh plugin --profile web add https://github.com/Abeskandr/dsh-ue-db

安装就这一条——dsh 转发给 pnpm，由它克隆打了标签的源码。语料库不在仓库里，首次使用时才下载。

然后执行一次：

python -m pip install cloudscraper # needed only for downloading

让智能体运行 ue_db_update，再重启 DSH，工具才会出现在模型的工具集里。首次下载要几个小时（见开头的说明）；每一步都能续传，所以可以分几次做完。

工具

| 工具 | 用途 |
| ue_db_search | 跨全部来源的排序搜索。用 kind=guide\|pyapi\|bpapi\|cppapi 过滤。 |
| ue_db_get | 按搜索结果里的 id 取单条全文。 |
| ue_db_status | 语料库位置、版本、条目数——用它诊断缺失的库。 |
| ue_db_update | 唯一联网的工具。下载并重建索引。可续传。 |

选择语料库放在哪

解析顺序：

1. 插件行里的 config.knowledgePath——显式路径
2. DSH_UE_DB_ROOT 环境变量
3. <plugin>/data，前提是里面有索引——随包带了语料库的本地安装
4. ~/.dsh/ue-db——全新注册表安装的默认位置

- id: ue-db
name: dsh-ue-db
config:
knowledgePath: D:/unreal-docs

指向已有的语料库，就什么都不下载。删掉那个目录语料库没了，别处也没留副本。

更新

ue_db_update(what="guides") # guides only
ue_db_update(what="bpapi") # Blueprint API only
ue_db_update(what="cppapi") # C++ core modules only
ue_db_update(what="cppall") # C++ including third-party plugins — many hours
ue_db_update(limit=200) # trial run

爬虫全局控制节奏（EPIC_MIN_INTERVAL，默认 0.35 秒），遇到 403 就轮换 Cloudflare 会话。绕过 Cloudflare 靠的是 [cloudscraper]，它会模仿浏览器的 TLS 指纹——纯 Node、curl 和 urllib 一律收到 403，所以网络层用 Python 写。

健康检查

开销很小，任何一次爬取之后都可以跑：

python tools/check_db.py --base <dir> --full # every entry opens
node tools/check_queries.mjs <dir> # 9 representative queries
node tools/check_package.mjs # every tool ships in the tarball

check_db.py 不是白写的：开发期间有两个路径 bug 一直没暴露——搜索照常工作，索引也一直有效，可 ue_db_get 却悄悄返回「file missing」。抽样读取不够用，所以才有了 --full。

环境要求

- DSH >= 0.2.0-rc.1
- Node 20+（随 DSH 一起提供）
- Python 3.10+ 和 cloudscraper——仅 ue_db_update 需要；搜索和读取都是纯 Node

目录结构

index-ue.json unified index (search metadata, precomputed terms)
pyapi/ Python API classes, Markdown
raw/guides/ Epic guide pages
raw/bpapi/ Blueprint API nodes
raw/cppapi/ C++ API classes
raw/*-index.json per-source crawler indexes and resume state
tools/ Python crawlers (network layer)
lib/ Node: search engine, tools, update driver

法律声明

下载到 pyapi/、raw/guides/、raw/bpapi/ 和 raw/cppapi/ 里的文档文本，知识产权归 Epic Games, Inc. 所有，受 Epic 使用条款约束。本项目只提供工具；语料库由你从 Epic 公开文档站点下载，供个人使用。

代码——爬虫、索引器、搜索引擎、DSH 插件——采用 MIT 协议。

许可证

代码采用 MIT 协议。见 LICENSE。

[cloudscraper]: https://pypi.org/project/cloudscraper/