NPM Scripts Launcher for DeepSeek Harness (DSH)

Плагин для веб-интерфейса DeepSeek Harness (DSH), который добавляет в левый нижний угол сайдбара кнопку быстрого запуска NPM-скриптов с автоопределением текущего проекта и выводом в отдельное интерактивное окно терминала.

🌟 Возможности

Компактная кнопка в интерфейсе:
- Находится в левом нижнем углу сайдбара (рядом с настройками).
- Заменяет собой стандартную служебную кнопку "Cordis Plugin".
- Выполнена в виде аккуратного официального логотипа NPM без лишнего текста.
Автоопределение и переключение Workspace:
- Автоматически считывает активный Workspace через хуки сессии DSH.
- Умеет находить package.json как в корне проекта, так и во вложенных подпапках (например, prj/package.json или src/package.json).
- Если открыто несколько проектов, в шапке окна доступен мгновенный переключатель-дропдаун для запуска скриптов в любом воркспейсе без необходимости переключать активный чат.
Запуск в живом окне терминала:
- Запуск скриптов происходит через системный вызов cmd.exe /c start "npm: " cmd.exe /k npm run .
- Открывается физическое отдельное окно командной строки Windows в директории проекта.
- Окно остаётся открытым после выполнения команды (/k), позволяя просматривать логи dev-сервера, сборки, тестов или прерывать их по Ctrl+C.
Удобный UI:
- Всплывающее меню аккуратно открывается вверх от футера.
- Автоматически закрывается при клике в любое свободное место экрана.

📂 Структура файлов

npm-run-shell/
├── client.js          # Клиентская половина (UI попапа, хуки сессий/воркспейсов, SVG-иконка)
├── host.js            # Хостовая половина (поиск package.json, Host RPC, запуск терминала)
├── package.json       # Описание пакета и точек входа DSH
├── cordis.patch.yml   # Манифест подключения плагина к Cordis профилю
└── README.md          # Документация по установке и использованию

🚀 Установка на постоянной основе в DSH

Чтобы плагин запускался автоматически при каждом старте DSH (без необходимости динамического подтверждения cordis_run):

Вариант 1. Через симлинк в пользовательский веб-профиль (Рекомендуемый)

Откройте терминал PowerShell и создайте символическую ссылку на папку плагина в ~/.dsh/profiles/web/node_modules:

New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.dsh\profiles\web\node_modules\npm-run-shell" -Target "D:\Dev\JS\Prj\2026\dsh-plugins\npm-run-shell" -Force

Добавьте плагин в ~/.dsh/profiles/web/package.json в секцию bundles:

{
  "name": "dsh-profile-web",
  "private": true,
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dshmarket",
        "npm-run-shell"
      ],
      "patchReload": "live"
    }
  },
  "dependencies": {
    "dshmarket": "^1.65.0",
    "npm-run-shell": "workspace:*"
  }
}

Либо добавьте запись активации в файл ~/.dsh/profiles/web/cordis.patch.yml:

- insert:
    - id: npm-run-shell
      name: 'npm-run-shell'

Перезапустите веб-сервер DSH или обновите страницу в браузере.

🛠 Динамический запуск (в текущей сессии)

Если плагин не установлен постоянно, его всегда можно запустить на лету через вызовы Cordis Tool:

Передайте содержимое client.js и host.js в инструмент cordis_define.
Запустите полученный пакет через cordis_run.

dsh-plugin-npm-run-shell

Install

README