@ragnoryok1/dsh-plugin-doctor
DeepSeek Harness 诊断工具：查找加载失败的插件、从未启动的捆绑包条目、版本不匹配和无法管理的条目，并说明处理方法
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Ragnoryok1/dsh-plugin-doctor#f3733d512313485446ffc81d0b1ad0dc658df6baPlugin Doctor 以 @ragnoryok1/dsh-plugin-doctor 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Диагностика проблем плагинов DeepSeek Harness
Панель диагностики плагинов для веб-интерфейса DeepSeek Harness (dsh).
Вкладка «Диагностика» в разделе «Встроенные плагины». Показывает все плагины, которые знает работающий харнесс, и объясняет, что именно не работает: плагины, которые не загрузились (с их собственным сообщением об ошибке), строки бандлов, объявленные но так и не запущенные — след неудачного обновления, — записи, которыми нельзя управлять из интерфейса, с указанием причины, выключенные плагины и предупреждения о версиях. Для каждого раздела даётся одна подсказка, а не повторяется под каждой строкой, и панель всегда сообщает, сколько плагинов она проверила: иначе «проблем нет» неотличимо от «проверка ничего не увидела». Читает только штатные сервисы (remote.pluginManager по Remote-протоколу) и никогда — файлы или внутренности других пакетов, поэтому переживает обновления харнесса.
| Раздел | Что означает |
|---|---|
| Не загрузились | Плагин сообщил об ошибке при запуске. Показывается само сообщение. |
| Объявлены, но не запущены | Бандл объявляет строку, но живой записи у неё нет — так выглядит след неудачного обновления. |
| Не управляются из интерфейса | Запись есть, но переключить её отсюда нельзя. Указывается причина: management-required, unaddressable и другие. |
| Выключены | Отключены намеренно. |
| Предупреждения о версиях | Не смертельно, но стоит прочитать перед обновлением. |
Проблемами считаются только ошибки. Справочные разделы видны, но не делают здоровый профиль сломанным.
Вкладка «Диагностика» рядом с инвентарём плагинов
dsh plugin --profile web add @ragnoryok1/dsh-plugin-doctor
Затем откройте Настройки → Встроенные плагины → Диагностика.
Плагин не читает чужие файлы и не лезет во внутренности пакетов. Всё, что он
показывает, приходит из штатных сервисов: плагин-менеджер отдаёт состояние
через Remote-протокол (remote.pluginManager), а ответы распаковываются из
конверта { ok, value }.
Отсюда же две особенности, которые легко сделать неправильно и которые здесь сделаны намеренно:
Утверждение «находит неработающие плагины» ничего не стоит без настоящей поломки,
поэтому проверка сделана на живом харнессе с заведомо сломанным плагином:
в fixtures/canary/ лежит фикстура, чей apply() всегда падает.
| Состояние профиля | Что показала панель |
|---|---|
| канарейка установлена | «Найдена 1 проблема» → «Объявлены, но не запущены (1): doctor-canary», с модулем и советом |
| канарейка удалена | «Проблем нет: все плагины загружены и совместимы.» |
Порядок повторения — в fixtures/canary/README.md.
Отдельно стоит знать: упавшая на хосте строка не попадает в список живых
плагинов, поэтому meta.error показать некому — срабатывает проверка строк
бандлов. Обе проверки нужны, и это подтвердилось на практике.
Панель читает состояние плагинов через штатные сервисы — но они живут в браузере и файловой системы не видят. Отказы, которые мы раз за разом разбираем руками, лежат именно на диске, поэтому о них сообщает отдельный скрипт:
node bin/doctor-scan.mjs
# или, если пакет установлен отдельно: npx dsh-doctor
| Что ищет | Почему это важно |
|---|---|
Каталоги *.parked | отложенная копия плагина — след обхода заблокированного переименования при обновлении |
Каталоги _tmp_* | остаток неудачной установки; именно из-за него обновления падают с EPERM |
Битые ссылки file: | профиль указывает на файл, которого больше нет: установка падает с ENOENT ещё до начала |
| Отчёты о сбоях запуска | logs/startup-*.log: лаунчер сам называет плагины, которые не активировались, — с пакетом, ошибкой и числом ждущих сервисов |
Проверено на настоящем мусоре. Скрипт запускался на чистом профиле, затем на профиле с намеренно созданными остатками (нашёл оба), затем снова на чистом — замечаний нет. Попутно он нашёл и настоящий *.parked, оставшийся в профиле от обхода EPERM при обновлении плагина, — тот был убран.
Почему остатки не в панели. Чтобы показать их в интерфейсе, плагину нужен собственный remote-сервис, а имена в ctx.remote.* генерируются сборочным конвейером харнесса. Генератор (@deepseek-ai/dsh-typert-generator) опубликован, так что путь существует — но это отдельная работа, и она не выдаётся за сделанную.
В peerDependencies стоит не короткий диапазон, а девять ветвей с явными пререлизными метками. Это не украшение: node-semver пропускает пререлизную версию, только если в диапазоне есть сравнение на том же тупле major.minor.patch, и само оно помечено пререлизом. Поэтому выглядящий широким >=0.1.0-rc.2 <0.3.0 не пропускает ни 0.1.7-alpha.2, ни 0.2.1-alpha.1 — и пользователь получает ERESOLVE. Проверено на самом npm: короткий диапазон отдаёт только 0.1.0-rc.2 … 0.1.0-rc.8, длинный — все нужные версии.
npm install
npm run build # tsdown -> lib/index.js (host half) + lib/client.js (client bundle)
npm pack
lib/client.js собирается в формате, который понимает клиентский загрузчик dsh
(__ModuleLoader__.load), и экспортирует inject/apply. React и пакеты
харнесса остаются внешними и резолвятся загрузчиком.
src/client/index.ts — панель, проверки и регистрация вкладки;src/client/locales.ts — словари ru, zh и en для собственного интерфейса;src/index.ts — пустая host-половина (нужна как загружаемая node-точка входа);cordis.patch.yml — профиль-патч (- insert: клиентской строки plugin-doctor);bin/doctor-scan.mjs — проверка диска (остатки и битые ссылки);fixtures/canary/ — фикстура-канарейка для проверки панели.MIT. Пакет сообщества, не связан с DeepSeek.