DSH Plugins Marketplace

DSH Plugins

Plugins

/

radial-fan-selector-DSH

R

radial-fan-selector-DSH

Discovered

DeepSeek Harness plugin for selecting VR 86-77 / VR 280-46 radial fans by flow and pressure: throttle, VFD and comparison modes, bulk CSV selection.

fan-selector

License: Apache-2.0 CI npm Python Node

Русский · English

Подбор радиальных вентиляторов серий ВР 86-77 и ВР 280-46 по расходу и давлению: подбор электродвигателя, расчёт дорегулирования и КПД, массо-габаритные характеристики, график характеристик и массовый пакетный подбор.

Проект оформлен как плагин DeepSeek Harness (DSH): встраивается в DSH строкой в профиле, раздаёт REST-API, регистрирует инструмент fan_selector_history и React-панель «Подбор вентилятора». Расчёт выполняет отдельное Python-ядро fan_selector (JSON на входе → JSON на выходе).

Возможности

  • Единичный подбор по точке (Q, P) с ранжированием по дорегулированию.
  • Три режима регулирования: дроссельное, частотное (ЧРП) и сравнение.
  • Тип давления: полное или статическое (с пересчётом динамического напора).
  • Подбор электродвигателя с коэффициентом запаса и реального частотного преобразователя.
  • График характеристик P(Q) / η(Q) в виде PNG прямо в панели.
  • Массовый подбор из CSV (шаблон + превью разбора) и durable-история подборов.
  • MCP-сервер и REST-фолбэк для сторонних клиентов (MCP-слой — экспериментальный).

Демо

Дроссельное регулирование (дорегулирование)

Дроссельное регулирование

Частотное регулирование (ЧРП + дорегулирование)

Частотное регулирование

Массовый подбор из CSV

Массовый подбор

Состав репозитория

Каталог/файлНазначение
fan-selector-plugin/DSH-бандл: хост index.js + клиент client.js (+ locale, cordis.patch.yml, core/)
fan-selector-plugin/core/расчётное ядро внутри пакета: run_once.py + select-radial-fan/
fan-selector-plugin/core/select-radial-fan/Python-ядро fan_selector, справочники data/, MCP/REST-адаптеры, React-UI web/
.dsh/skills/fan-selector/SKILL.mdнавык для агента DSH
run-rest.pyREST-фолбэк ядра на отдельном порту (опционально)
LICENSEApache-2.0

Требования

  • DeepSeek Harness (DSH) >= 0.2.0;
  • Python ≥ 3.11 с numpy и Pillow (обязательно для расчёта);
  • для разработки: Node ≥ 20.19 + pnpm.

Установка (пользователям)

Плагин ставится как обычный пакет DSH — клонировать репозиторий и устанавливать ядро через pip не нужно: Python-ядро и справочники уже внутри пакета.

1. Поставить Python 3.11+ и библиотеки

pip install numpy pillow

Расчёт выполняет локальный Python-процесс, поэтому интерпретатор нужен на машине. Если python не в PATH, укажите его переменной FAN_SELECTOR_PYTHON.

2. Установить плагин в профиль DSH

Через интерфейс DSH (Профили → установка плагина → @rusky_kot/fan-selector) или официальной CLI-командой:

dsh plugin --profile <профиль> add @rusky_kot/fan-selector

Если команда dsh не найдена в PATH, добавьте её (настройки DSH → установка командной строки) или вызывайте полный путь <DSH>/resources/runtime/cli/bin/dsh.cmd.

Команда добавляет зависимость в ~/.dsh/profiles/<профиль>/package.json и выполняет pnpm install. Убедитесь, что бандл @rusky_kot/fan-selector указан в dsh.profile.bundles — DSH загружает только перечисленные бандлы:

{
  "dependencies": {
    "@rusky_kot/fan-selector": "^1.0.0"
  },
  "dsh": { "profile": { "bundles": ["@rusky_kot/fan-selector"] } }
}

3. Перезапустить DSH

После перезапуска появится панель «Подбор вентилятора», а у агента — инструмент fan_selector_history и навык fan-selector.

Если Python или библиотеки не найдены, панель покажет понятную ошибку с командой установки, а API вернёт код ENV.

Устранение неполадок установки

ERR_PNPM_EPERM: rename '…\@rusky_kot\fan-selector_tmp_<pid>_1' -> '…\@rusky_kot\fan-selector' или предупреждение [WARN] Moving @rusky_kot/fan-selector_tmp_… to "node_modules\.ignored\…". Причина — в каталоге профиля остался каталог-ссылка (junction) от прежней установки через link:, например если плагин раньше подключался прямо из репозитория. На Windows pnpm не может переименовать новый каталог поверх junction, поэтому операция откатывается. Удалите ссылку (именно ссылку, не содержимое репозитория) и повторите установку:

# rmdir удаляет только саму ссылку; каталог проекта остаётся на месте
cmd /c rmdir "%USERPROFILE%\.dsh\profiles\<профиль>\node_modules\@rusky_kot\fan-selector"

Если ссылка указывала на рабочий чекаут, установка может успеть удалить часть его файлов — восстановите их из git: git checkout -- . (проверьте git status). Надёжнее сначала убрать link:-зависимость, а уже затем ставить версию из реестра.

Плагин установлен, но панели нет. Проверьте, что имя есть в dsh.profile.bundles профиля (см. шаг 2). Команда dsh plugin … add добавляет только зависимость; включение бандла выполняет интерфейс DSH при установке плагина.

Разработка

git clone https://github.com/Ruskykot/radial-fan-selector-DSH.git
cd radial-fan-selector-DSH

# ядро как обычный пакет (или pip install -e ...)
pip install ./fan-selector-plugin/core/select-radial-fan

# подключить локальный чекаут плагина в профиль DSH
dsh plugin --profile <профиль> add "link:<путь_к_репозиторию>/fan-selector-plugin"

Требования для разработки: Node ≥ 20.19 + pnpm (для сборки web/), Python 3.11+.

Тесты расчётного ядра и адаптеров:

cd fan-selector-plugin/core/select-radial-fan
pip install -r requirements.txt -r requirements-mcp.txt
python tests/test_golden.py
python tests/test_golden_fixture.py
python tests/test_mcp.py
python tests/test_mcp_registration.py
python tests/test_rest.py
  • UI (опциональный самостоятельный React-виджет, плагином не используется): cd web && pnpm install && pnpm dev (проверка сборки — pnpm build).
  • MCP-сервер: python mcp_stdio.py streamable-http (экспериментально: API и запуск могут меняться, поддержка не гарантирована).
  • REST-фолбэк: python run-rest.py 8100.

Логика работы плагина

Плагин — бандл DSH из двух половин.

Хост-половина (fan-selector-plugin/index.js)

Экспортирует inject = ['tools', 'webServer', 'subprocess'] и apply(ctx). На каждом старте DSH плагин:

  1. регистрирует HTTP-маршруты на встроенном web-сервере DSH;
  2. регистрирует инструмент агента fan_selector_history.
Метод и путьНазначение
POST /fan-selector/selectподбор (дроссельный режим)
POST /fan-selector/chartподбор + PNG-график
POST /fan-selector/compareсравнение дроссельного и ЧРП
POST /fan-selector/catalogкаталожные карточки
POST /fan-selector/batch/parseразбор CSV без расчёта (превью)
POST /fan-selector/batchмассовый подбор по CSV
GET /fan-selector/template.csvшаблон CSV
GET/POST/DELETE /fan-selector/historyчтение / добавление / очистка истории
POST /fan-selector/history/batchпакетная запись истории

Ключевая идея: постоянного процесса нет. На каждый запрос хост запускает python run_once.py, передаёт {op, payload} через stdin и забирает JSON со stdout через штатный сервис subprocess DSH. Поэтому плагин переживает перезапуски DSH без внешних сервисов.

Клиент-половина (fan-selector-plugin/client.js)

Грузится через window.__ModuleLoader__.load и вставляет React-панель в слоты sidebar.panellist (иконка в боковой панели) и main (сама панель). В панели две вкладки: Единичный подбор и Массовый подбор.

Цикл запроса

sequenceDiagram
    participant U as Пользователь
    participant C as client.js (панель)
    participant H as index.js (хост)
    participant P as python run_once.py
    participant Core as fan_selector
    U->>C: Q, P, тип давления, режим
    C->>H: POST /fan-selector/chart
    H->>P: stdin {op, payload}
    P->>Core: run_selection / chart_selection
    Core-->>P: JSON fan-result/v1
    P-->>H: stdout JSON
    H-->>C: JSON
    C-->>U: сводка + график + таблица

История

История подборов хранится в JSON-файле (~/.fan-selector-history.json по умолчанию) и не теряется между перезапусками. Лимит — 5000 записей. Фиксация вентилятора в таблице сохраняет точку в историю; запись можно восстановить или удалить.

Режимы работы

Режимregulation_modeЧто делаетСортировка
ДроссельноеTHROTTLEподбор по каталожной кривой, дорегулирование дросселемпо Δрег (меньше — лучше)
Частотное (ЧРП)VFDподбор по законам подобия + частотный преобразовательпо требуемой частоте f, Гц
СравнениеCOMPAREоба расчёта для одной точки + общий график—
МассовыйCSV-файлмного точек за один прогонпо строкам файла

1. Дроссельное регулирование (THROTTLE)

Ядро строит аппроксимацию каталожной кривой P(Q) (МНК-полином) и находит давление в рабочей точке. Вентилятор проходит, если: q_min ≤ Q ≤ q_max, P_вент(Q) ≥ p_req, Δрег = P_вент − p_req ≤ d_reg_max, есть данные КПД и подходящий двигатель. Сортировка — по минимальному дорегулированию (энергетически выгоднее).

2. Частотное регулирование (ЧРП / VFD)

  • коэффициент сети k = p_req / q_req²;
  • точка пересечения номинальной кривой P_nom(Q) и параболы сети k·Q² → Q₀;
  • относительная частота f = q_req / Q₀; f_hz = f · 50, n_rpm = f · max_n;
  • проверка диапазона freq_min_hz ≤ f_hz ≤ freq_max_hz;
  • КПД по подобию (смещение точки по расходу), мощность на валу с запасом;
  • двигатель подбирается по номинальной частоте, затем ЧРП по p_kw / i_nom_a.

Подробности — fan-selector-plugin/core/select-radial-fan/docs/CALCULATION_VFD.md.

3. Сравнение (COMPARE)

Один запрос — два расчёта (THROTTLE и VFD) для одной точки плюс общий график сравнения. Ответ содержит оба блока — throttle и vfd.

4. Массовый подбор (CSV)

Вкладка «Массовый подбор»: скачать шаблон CSV, загрузить файл, увидеть превью разбора (число строк, ошибки по строкам) и запустить пакетный расчёт.

Колонки шаблона: Система;Комментарий;Расход Q, м³/ч;Давление P, Па;Тип давления;Режим;Дорегулирование ΔP, Па;Температура, °C;f мин, Гц;f макс, Гц. Разделитель — ; или ,; кодировка — UTF-8 (BOM допускается) или CP1251. Максимум строк на файл — 5000.

Тип давления

  • FULL — полное давление (по умолчанию);
  • STATIC — статическое: кривая пересчитывается по точкам P_стат = P_полн − ρv²/2, а мощность считается по восстановленному полному давлению.

Расчётное ядро

Ядро — чистые функции Python без I/O: dict → dict. Лежит в fan-selector-plugin/core/select-radial-fan/fan_selector/.

Слои и модули

fan_selector/
├── select.py         АДАПТЕР: dict → dict, единственная точка входа
├── repositories.py   загрузка JSON → доменные модели (+ lru_cache)
├── config.py         загрузка/валидация config.json (fail-fast)
├── selector.py       ОРКЕСТРАТОР: фильтры, перебор, сортировка
├── core.py           РАСЧЁТ: дроссельный режим
├── vfd.py            РАСЧЁТ: частотное регулирование (ЧРП)
├── chart.py          построение PNG-графиков
└── models.py         доменные модели (dataclass)

Справочники (data/, не код)

ФайлСодержимое
fans.jsonкарточки вентиляторов: серия, обороты, границы двигателя, шум
impellers.jsonрабочие колёса: точки P(Q), точки η(Q), площадь выхода
motors.jsonэлектродвигатели: марка, кВт, об/мин
vfd.jsonчастотные преобразователи (мощность, ток, напряжение)
catalog.jsonмассо-габариты, шум по оборотам, исполнения
config.jsonρ воздуха, степень полинома, таблица запасов, границы валидации
golden.jsonисполняемый контракт — эталонные ответы

Алгоритм дроссельного подбора

  1. Отбросить вентиляторы, не покрывающие диапазон расхода (q_min..q_max).
  2. Построить МНК-полином характеристики P(Q) (степень ≤ poly_degree).
  3. Проверить P_вент(Q) ≥ p_req и Δрег ≤ d_reg_max.
  4. Найти КПД η(Q) (полином степени min(poly_degree, 3)).
  5. Мощность на валу N = (Q/3600)·P_полн / η, умножить на коэффициент запаса.
  6. Подобрать двигатель: n_rpm == max_n, мощность в границах карточки, n_kw ≥ N_расч, минимальная достаточная.
  7. Оценить шум корпуса и отсортировать по Δрег.

Дроссельный режим — fan-selector-plugin/core/select-radial-fan/docs/CALCULATION.md. Частотный режим (ЧРП) — fan-selector-plugin/core/select-radial-fan/docs/CALCULATION_VFD.md.

Контракт результата (fan-result/v1)

{
  "schema": "fan-result/v1",
  "query": { "q_req": 7500, "p_req": 700, "pressure_type": "FULL" },
  "summary": {
    "total": 10, "passed": 9,
    "best_model": "ВР 280-46-6.3(1DN)-Y-X/750", "best_d_reg_pa": 47.56
  },
  "results": [
    { "model": "...", "status": "OK", "passed": true, "d_reg_pa": 47.56,
      "eta_req": 0.6292, "n_shaft_with_margin_w": 2846.61,
      "motor": { "name": "160S8", "n_kw": 7.5, "n_rpm": 750 },
      "noise_body_dba": 0, "curve": { "q_points": [], "p_points": [] } }
  ]
}

Ошибки возвращаются как {"error": {"code", "message"}} — исключения наружу не выбрасываются.

Проверка (golden)

fan-selector-plugin/core/select-radial-fan/tests/test_golden.py фиксирует эталонные числа: любое изменение результата расчёта ломает тест.

Переменные окружения плагина

ПеременнаяНазначениеПо умолчанию
FAN_SELECTOR_RUNNERпуть к run_once.py<плагин>/core/run_once.py
FAN_SELECTOR_PYTHONинтерпретатор Python (с numpy и Pillow)python / python3
FAN_SELECTOR_COREпуть к пакету fan_selector<плагин>/core/select-radial-fan
FAN_SELECTOR_HISTORYфайл истории подборов~/.fan-selector-history.json

Участие

Лицензия

Apache-2.0 — см. LICENSE. Данные из справочников data/*.json описаны в NOTICE.

Comments

Loading…

Similar plugins

dsh-r-workbench

by HougeLangley

DeepSeek Harness plugin for R data acquisition, cleaning, value gating, statistical analysis, and reporting.

Manifest valid

★ 0

MIT

R

Nov 14, 2026

dsh plugin --profile web add dsh-r-workbench

by uckkk

通风换气

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Aug 20, 2026

dsh plugin --profile web add dsh-ventilate

by houlain

DeepSeek Harness plugin: workspace file browser + code viewer + session change diff + per-hunk partial revert (Trae-style). Windows verified only; Linux/macOS untested — use with caution.

Development & InfrastructureManifest valid

★ 1

MIT

TypeScript

Nov 3, 2026

dsh plugin --profile web add dsh-workspace-studio

by qunqin24

Multi-engine web search plugin for DeepSeek Harness: free AI search rotation with cooldown, Tavily/Brave/Serper/Exa/Perplexity/Jina/Bocha/SearXNG, settings page.

Manifest valid

★ 0

MIT

TypeScript

Oct 19, 2026

dsh plugin --profile web add dsh-plugin-search-hub

by uckkk

空调匹数选择

Manifest valid

★ 0

MIT

JavaScript

Aug 20, 2026

dsh plugin --profile web add dsh-ac-size

Preflight checks for a DeepSeek Harness plugin before submitting it to the community list: verifies the dsh.bundle manifest, cordis.patch.yml wiring, client bundle shape, and peer ranges that silently

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 0

dsh plugin --profile web add dsh-plugin-preflight