Что это
KOMPAS-3D GUARD SDK Core V2 — зафиксированный набор артефактов для локального SDK поиска, проверки и безопасного запуска кода KOMPAS-3D API. Это не самостоятельная sentence-transformers модель и не HTTP-сервис.
При первом создании KompasGuard() пакет kompas-3d-guard скачивает ровно
этот immutable snapshot, проверяет SHA-256 из manifest.json и затем работает
из локального Hugging Face cache. Интернет для последующих запусков не нужен.
from kompas_guard import KompasGuard
guard = KompasGuard(status=print)
batch = guard.batch([
"получить радиус окружности",
"создать документ детали и сохранить его",
], k=5)
print(batch.render("compact"))
print(batch.inspect("Q1.R1"))
Что входит в Core V2
| Компонент | Назначение |
|---|---|
| USER2 V1 ONNX encoder | Локальное RU/EN кодирование поисковых запросов |
| Dense index | Поиск по 19 331 карточке API КОМПАС-3D |
| Graph | Members, enum, casts, acquisition paths и relations |
| Interop | Авторитетные числовые значения и metadata API |
| Knowledge | GOST-поиск, constants и рецепты API |
Core V2 содержит 5 443 числовых значения из 420 enum-типов. Exact lookup, constants и acquisition paths выполняются локально; для поиска и проверки кода не требуется внешний сервер или внешняя LLM.
Требования и совместимость
kompas-3d-guard==0.6.x;- Windows x64, CPython 3.10–3.14 для полного SDK;
onnxruntimeиспользуется локально;- установленный КОМПАС-3D требуется только для
run(), но не для поиска, graph-проверки или просмотра constants.
Размер Core V2 — около 255 МБ. Измеренное потребление памяти Windows после первого API-поиска — около 382 МБ RSS.
Стабильность
Репозиторий dwnmf/kompas-guard-sdk-core-v2 — технический стабильный ID для
релизов SDK 0.6.x. Клиент закрепляет точный Git revision Core V2; не используйте
содержимое этого репозитория как замену новой embedding-модели и не смешивайте
его index с другими encoder-ами.
Core V2 остаётся legacy production profile. Новые embedding-модели публикуются отдельно и требуют собственных согласованных индексов.
Лицензия
KOMPAS-specific fine-tuned weights, индексы, graph projections и production артефакты распространяются по CC BY-NC 4.0. Коммерческое использование требует отдельного письменного разрешения.
Компоненты upstream deepvk/USER2-small сохраняют условия Apache-2.0.
Подробности и атрибуция — в LICENSE.md и
NOTICE.md.