dsh-desktop-kit 2.1.4 → 2.2.1

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+## 2.2.1 — 2026-11-06
+
+- В npm-пакет добавлены `install.ps1`, `uninstall.ps1` и `doctor.ps1` — документация ссылается на них, но в 2.2.0 их не было в tarball.
+- Манифест навыков пересобран под 2.2.1; хэши не изменились.
+- Проверка: 25 навыков, тесты, `/kit` на 0.2.2.
+
+## 2.2.0 — 2026-11-06
+
+Безопасные обновления: пакет больше не оставляет старые навыки «навсегда» и не затирает правки пользователя.
+
+- **Манифест и состояние навыков.** `skills/manifest.json` хранит SHA-256 каждого навыка; `~/.dsh/skills/.dsh-kit-skills.json` — что установлено и когда. При обновлении неизменённые навыки обновляются, изменённые пользователем — сохраняются и попадают в конфликты.
+- **Бэкап перед заменой.** Старая версия навыка уходит в `~/.dsh/skills/.dsh-kit-backups/skills/<name>-<дата>`.
+- **Команда `/kit`:** `status`, `sync`, `conflicts`, `force` (принудительно, с бэкапом).
+- **Изоляция клиентских частей.** Ошибка одного клиентского плагина не снимает остальные; версия и ошибки видны в `window.__DSH_DESKTOP_KIT__`.
+- **Диагностика установки:** `doctor.ps1` показывает версию пакета, состояние синхронизации и конфликты.
+- **0.2.2-rc.1:** исправлен разбор `user/message` для автопилота; добавлен отчёт [docs/TEST-0.2.2.md](docs/TEST-0.2.2.md).
+
+## 2.1.4 — 2026-11-06
+
+- Автопилот читает оба формата `user/message` (0.2.1 и 0.2.2) + fallback на `session.snapshotEvents()`.
+- Отчёт тестирования на DSH 0.2.2-rc.1 win-x64.
+
+## 2.1.3 — 2026-11-06
+
+- Исправлены машинные переводы RU-словаря и добавлен живой DOM-fixer (retry/stream/cache/queue).
+
+## 2.1.2 — 2026-11-06
+
+- Убрана дублирующая строка стека в дайджесте памяти.
+
+## 2.1.1 — 2026-11-06
+
+- Стек `Node.js` для проектов без фреймворков; паспорт проекта заполняется из автоскана.
+
+## 2.1.0 — 2026-11-06
+
+- Память проектов 2.1: авто-распознавание, локальный автоскан, `brief`/`scan`, auto-recall, redaction, `/memory`.
+- Раздел «Окно-напоминание» и hero 2.1.
+
+## 2.0.1 — 2026-11-06
+
+- Исправлены ссылки на изображения и документация.
+
+## 2.0.0 — 2026-11-06
+
+- 25 компактных навыков, автопилот, Token Lab, Skills Studio, адаптивный сайдбар.
+
+## 1.0.0 — 2026-11-06
+
+- Первый публичный выпуск: русский UI, пиковый тариф, память, перенос чатов и профиля.

package/README.md

@@ -1,17 +1,18 @@
-# DSH Desktop Kit 2.1
+# DSH Desktop Kit 2.2
 
 **Навыки, которые применяются сами. Контекст, который видно. Интерфейс, который не мешает.**
 
 Набор из **7 плагинов и 25 навыков** для DeepSeek Harness 0.2.x: русский интерфейс, автопилот навыков, токен-лаборатория, студия навыков, память проектов, перенос чатов и резервные копии профиля.
 
-![DSH Desktop Kit 2.1](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/docs/images/hero.png)
+![DSH Desktop Kit 2.2](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/docs/images/hero.png)
 
-**v2.1.4** · MIT · проверено на DSH `0.2.1-rc.5` (Windows 11) · без внешних зависимостей и телеметрии
+**v2.2.1** · MIT · проверено на DSH `0.2.1-rc.5` и `0.2.2-rc.1` (Windows 11) · без внешних зависимостей и телеметрии
 
 ---
 
 ## Что нового
 
+- **Обновления без потерь 2.2.0.** Навыки синхронизируются по манифесту SHA-256: неизменённые обновляются, ваши правки сохраняются и попадают в `/kit conflicts`; перед заменой — бэкап. Клиентские плагины изолированы: ошибка одной части не отключает остальные. Подробности — [docs/UPGRADING.md](docs/UPGRADING.md).
 - **Проверено на DSH `0.2.2-rc.1` (win-x64).** Установка из репозитория, все 7 плагинов, 25 навыков, Skills Studio, Token Lab, Peak Guard, перенос чатов/профиля и память проектов. Найден и исправлен сдвиг формата `user/message` в 0.2.2, из-за которого автопилот молчал. Отчёт: [docs/TEST-0.2.2.md](docs/TEST-0.2.2.md).
 - **Русский интерфейс 2.1.3.** Исправлены машинные переводы: «Этот повтор не удался» → «Не удалось выполнить запрос», ошибка потока DeepSeek, «Кэш попаданий», очередь сообщений и ещё 18 формулировок — в словаре и на живом экране.
 - **Память проектов 2.1.** Проект распознаётся сам по рабочей папке, локальный автоскан (без LLM и сети) сразу даёт стек, команды, точки входа и тесты; дайджест сам подмешивает фрагменты досье, похожие на текущий запрос. Секреты и PII вычищаются до записи, файлы приватные (`0700/0600`). Новые действия `brief`/`scan` и команда `/memory`.
@@ -59,19 +60,19 @@
 
 ### Skills Studio: каталог, стоимость и редактор
 
-![Каталог навыков](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-gkb-ru-ui/screenshots/02-skills-1440-light.png)
+![Каталог навыков](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-gkb-ru-ui/screenshots/02-skills-1440-light.png)
 
-![Редактор навыка](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-gkb-ru-ui/screenshots/03-skills-editor-1440-light.png)
+![Редактор навыка](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-gkb-ru-ui/screenshots/03-skills-editor-1440-light.png)
 
 ### Token Lab: куда уходит контекст
 
-![Токен-лаборатория](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-token-lab/screenshots/01-token-lab-1440-light.png)
+![Токен-лаборатория](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-token-lab/screenshots/01-token-lab-1440-light.png)
 
 ### Тёмная тема и мобильный
 
-![Тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-gkb-ru-ui/screenshots/04-skills-1440-dark.png)
+![Тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-gkb-ru-ui/screenshots/04-skills-1440-dark.png)
 
-<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-gkb-ru-ui/screenshots/05-skills-390-light.png" alt="Каталог навыков на 390 px" width="390">
+<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-gkb-ru-ui/screenshots/05-skills-390-light.png" alt="Каталог навыков на 390 px" width="390">
 
 ## Окно-напоминание: пиковый тариф
 
@@ -81,11 +82,11 @@ DeepSeek включает двойной тариф в пиковые часы (
 - **в окне** — красная карточка: причина, границы окна в местном времени и UTC, живой отсчёт до конца и рекомендация, когда вернуться;
 - **после окна** — карточка исчезает; состояние всегда доступно через `window.__DSH_PEAK_GUARD__.state()`.
 
-![Окно-напоминание: светлая тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-peak-guard/screenshots/03-peak-card-1440-light.png)
+![Окно-напоминание: светлая тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-peak-guard/screenshots/03-peak-card-1440-light.png)
 
-![Окно-напоминание: тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-peak-guard/screenshots/04-peak-card-1440-dark.png)
+![Окно-напоминание: тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-peak-guard/screenshots/04-peak-card-1440-dark.png)
 
-<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.4/plugins/dsh-peak-guard/screenshots/05-peak-card-390-light.png" alt="Окно-напоминание на 390 px" width="390">
+<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.2.1/plugins/dsh-peak-guard/screenshots/05-peak-card-390-light.png" alt="Окно-напоминание на 390 px" width="390">
 
 Подробности и настройки — [plugins/dsh-peak-guard/README.md](plugins/dsh-peak-guard/README.md).
 
@@ -156,9 +157,20 @@ powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\dsh-desktop-kit\insta
 | Перенос чатов | `...\dsh-desktop-kit\plugins\dsh-session-move` |
 | Перенос и бэкапы | `...\dsh-desktop-kit\plugins\dsh-profile-transfer` |
 
+## Обновление без сюрпризов
+
+Обновляйтесь поверх старой версии — данные и правки сохраняются:
+
+- **Навыки.** `skills/manifest.json` хранит хэши, `~/.dsh/skills/.dsh-kit-skills.json` — что установлено. Неизменённые навыки обновляются, ваши правки **не перезаписываются** и видны в `/kit conflicts`; перед заменой создаётся копия в `.dsh-kit-backups/skills/`.
+- **Команда `/kit`:** `status`, `sync`, `conflicts`, `force` (принудительно, с бэкапом).
+- **Настройки.** `dsh-autopilot.json` и память проектов дочитываются с дефолтами; новые поля не ломают старые файлы.
+- **DSH.** Пакет не фиксирует `@deepseek-ai/*` и не задаёт жёсткий `engines.dsh`; дочерние плагины и клиентские части изолированы. Ошибки видны в `window.__DSH_DESKTOP_KIT__` и `doctor.ps1`.
+
+Полный протокол и откат — [docs/UPGRADING.md](docs/UPGRADING.md), история — [CHANGELOG.md](CHANGELOG.md).
+
 ## Совместимость
 
-- DSH `0.2.1-rc.5` — проверено вживую: хост-часть, клиентские плагины, Skills Studio, Token Lab, автопилот.
+- DSH `0.2.1-rc.5` — проверено вживую: хост-часть, клиентские плагины, Skills Studio, Token Lab, автопилот, синхронизация навыков 2.2.0.
 - DSH `0.2.2-rc.1` (win-x64) — проверено 2026-11-06: установка из репозитория, 4 плитки, 25 навыков, редактор, Token Lab, Peak Guard, Session Move, Profile Transfer, память проектов и автопилот. Подробности и ограничения — [docs/TEST-0.2.2.md](docs/TEST-0.2.2.md).
 - Пакет **не тянет** версии `@deepseek-ai/*`: обновление клиента не ломает плагины.
 
@@ -173,6 +185,8 @@ powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\dsh-desktop-kit\insta
 ## Документация
 
 - [docs/TEST-0.2.2.md](docs/TEST-0.2.2.md) — отчёт тестирования на DSH 0.2.2-rc.1.
+- [docs/UPGRADING.md](docs/UPGRADING.md) — обновление, конфликты навыков, откат.
+- [CHANGELOG.md](CHANGELOG.md) — история версий.
 - [docs/TOKENS.md](docs/TOKENS.md) — экономика токенов, бюджеты, как измерять.
 - [docs/ROADMAP.md](docs/ROADMAP.md) — развитие плагинов и навыков.
 - [docs/INSTALL.md](docs/INSTALL.md) — все способы установки и проверка.

package/client.js

@@ -4147,6 +4147,16 @@ var(--dsw-alias-bg-layer-1,#fff);box-shadow:inset 0 1px 0 color-mix(in srgb,#fff
       return module.exports;
     })());
 
+    const __partNames = ["dsh-gkb-ru-ui","dsh-token-lab","dsh-peak-guard","dsh-session-move","dsh-profile-transfer"];
+    const __kitErrors = [];
+    const __pushKitError = (label, error) => {
+      const message = String(error && error.message ? error.message : error);
+      if (__kitErrors.length < 50) __kitErrors.push({ label: String(label || ""), message });
+      if (__kitErrors.length <= 5) console.error("[dsh-desktop-kit] registration failed:", label, message);
+    };
+    try {
+      window.__DSH_DESKTOP_KIT__ = { version: "2.2.1", parts: __partNames, errors: __kitErrors, ready: false };
+    } catch {}
     const __inject = [];
     for (const __part of __parts) {
       for (const __name of __part.inject || []) {
@@ -4155,13 +4165,18 @@ var(--dsw-alias-bg-layer-1,#fff);box-shadow:inset 0 1px 0 color-mix(in srgb,#fff
     }
     exports.inject = __inject;
     exports.apply = function apply(ctx) {
+      /* Keep each plugin isolated at the part boundary. Do not swallow errors
+       * inside ctx.effect: plugins use those synchronous errors for feature
+       * detection (e.g. "ru locale already registered") and must see them. */
       for (let index = 0; index < __parts.length; index += 1) {
         try {
           __parts[index].apply(ctx);
         } catch (error) {
-          console.error("[dsh-desktop-kit] browser part " + index + " failed to start", error);
+          __pushKitError(__partNames[index] || String(index), error);
+          console.error("[dsh-desktop-kit] browser part " + index + " failed to start", String(error && error.message ? error.message : error));
         }
       }
+      try { window.__DSH_DESKTOP_KIT__.ready = true; } catch {}
     };
     return module.exports;
   },

package/docs/ARCHITECTURE.md

@@ -34,7 +34,7 @@ DSH ставит плагин как пакет профиля и загружа
 - отключение `dsh-desktop-kit` в списке плагинов снимает все семь;
 - ошибка монтирования одного плагина логируется и не мешает остальным.
 
-При старте `installSkills()` копирует из `skills/` только отсутствующие папки в `~/.dsh/skills`. Существующие навыки не перезаписываются: обновление библиотеки — отдельное осознанное действие.
+При старте `installSkills()` вызывает `syncSkills()` из `lib/skills-sync.js`. Манифест `skills/manifest.json` хранит SHA-256 каждого навыка, состояние `~/.dsh/skills/.dsh-kit-skills.json` — что установлено. Неизменённые навыки обновляются с бэкапом в `.dsh-kit-backups/skills/`, изменённые пользователем не перезаписываются и попадают в `/kit conflicts`. Установка без state-файла принимается только при совпадении с базой из `skills-baseline.json`.
 
 ## Автопилот навыков
 

package/docs/COMPATIBILITY.md

@@ -4,10 +4,18 @@
 
 | DSH | Состояние | Что проверено |
 |---|---|---|
-| `0.2.1-rc.5` | работает | **2.1 проверена вживую**: память проектов (авто-распознавание, автоскан, `brief`/`scan`, `/memory`, redaction), Skills Studio, Token Lab, автопилот, 25 навыков |
-| `0.2.2-rc.1` | работает (2.1.4+) | **проверено 2026-11-06**: установка из репозитория, 4 плитки, 25 навыков, редактор с бэкапом, Token Lab (27 217 токенов / 24 узла), Peak Guard (карточка + бейдж), Session Move, Profile Transfer, память проектов (`/memory`, `scan.json`, дайджест), автопилот после фикса формата `user/message`. Отчёт: [TEST-0.2.2.md](TEST-0.2.2.md) |
+| `0.2.1-rc.5` | работает | **2.2 проверена вживую**: память проектов (авто-распознавание, автоскан, `brief`/`scan`, `/memory`, redaction), Skills Studio, Token Lab, автопилот, 25 навыков, синхронизация навыков с бэкапом |
+| `0.2.2-rc.1` | работает (2.2.1+) | **проверено 2026-11-06**: установка из репозитория, 4 плитки, 25 навыков, редактор с бэкапом, Token Lab (27 217 токенов / 24 узла), Peak Guard (карточка + бейдж), Session Move, Profile Transfer, память проектов (`/memory`, `scan.json`, дайджест), автопилот после фикса формата `user/message`, обновление 2.2.0 с сохранением правки навыка и `/kit status` (7/7). Отчёт: [TEST-0.2.2.md](TEST-0.2.2.md) |
 | новее `0.2.2` | не проверено | API плагинов в 0.2.x ещё меняется; см. «Если сломалось» |
 
+## Политика обновлений
+
+- **Нет жёстких версий DSH.** Пакет не объявляет `engines.dsh` и не тянет `@deepseek-ai/*`: диапазон сам стал бы причиной «плагины несовместимы» после обновления клиента.
+- **Нет потери правок.** Навыки обновляются по SHA-256-манифесту; изменённые пользователем остаются нетронутыми, перед заменой — бэкап. Состояние: `~/.dsh/skills/.dsh-kit-skills.json`; команда `/kit conflicts`.
+- **Изоляция.** Каждый дочерний хост-плагин монтируется отдельно; каждая клиентская часть набора изолирована — ошибка одной не снимает остальные. Диагностика: `window.__DSH_DESKTOP_KIT__`, `doctor.ps1`.
+- **Проверка перед релизом.** Матрица выше обновляется отчётом `docs/TEST-<версия>.md`; для нового DSH прогоняются установка из репозитория, все 7 плагинов и `/kit status`.
+- **Откат.** Предыдущая версия ставится поверх; навыки возвращаются из `.dsh-kit-backups/skills/`. Полный протокол — [UPGRADING.md](UPGRADING.md).
+
 ### 0.2.2-rc.1: что отличается
 
 - `user/message` storing: Message лежит в `event.data`, а не в `event.data.message`; автопилот теперь читает оба формата и дополнительно смотрит `session.snapshotEvents()`.

package/docs/INSTALL.md

@@ -3,7 +3,7 @@
 ## Требования
 
 - Windows 10/11.
-- DeepSeek Harness **0.2.1-rc.5** или новее (`0.2.2-rc.1` проверен на 1.x).
+- DeepSeek Harness **0.2.1-rc.5** или новее; `0.2.1-rc.5` и `0.2.2-rc.1` проверены вживую на пакете 2.2.0.
 - Профиль `desktop` уже создан: запустите DSH один раз и закройте окно.
 
 ## Способ 0. Пакет из npm (быстрее всего)
@@ -11,7 +11,7 @@
 В DSH: **Плагины → Add plugin** → вставьте:
 
 ```
-dsh-desktop-kit@2.1.4
+dsh-desktop-kit@2.2.1
 ```
 
 Либо локально: `npm i dsh-desktop-kit@2.0.0` — но для GUI всё равно нужен Add plugin/bundle.

package/docs/PRIVACY.md

@@ -31,6 +31,8 @@
 | Файл | Что содержит | Можно удалить |
 |---|---|---|
 | `~/.dsh/dsh-autopilot.json` | режим автопилота и лимит навыков | да, вернётся к значениям по умолчанию |
+| `~/.dsh/skills/.dsh-kit-skills.json` | хэши установленных навыков и конфликты (без текста навыков) | да, тогда пакет заново сравнит файлы |
+| `~/.dsh/skills/.dsh-kit-backups/skills/<name>-<дата>/` | копии навыков перед обновлением или `/kit force` | да, это только копии |
 | `~/.dsh/skills/.dsh-kit-backups/*.md` | резервные копии `SKILL.md` перед сохранением в Studio | да, это только копии |
 | `~/.dsh/skills/.dsh-kit-trash/<дата>-<навык>/` | навыки, удалённые через Studio | да, после проверки |
 | `~/.dsh/projects-memory/` | локальные досье проектов, журнал, `scan.json`, реестр | да, но потеряется память проектов |

package/docs/TEST-0.2.2.md

@@ -1,6 +1,6 @@
 # Тест на DeepSeek Harness 0.2.2-rc.1 (win-x64)
 
-Дата: **2026-11-06** · пакет: **dsh-desktop-kit 2.1.3** (исправление автопилота вошло в 2.1.4) · ОС: Windows 11.
+Дата: **2026-11-06** · пакет: **dsh-desktop-kit 2.2.1** (первый прогон — 2.1.3, фикс автопилота — 2.1.4) · ОС: Windows 11.
 
 ## Стенд
 
@@ -40,6 +40,13 @@
 2. **Путь рабочей области по умолчанию.** На русской Windows 0.2.2 создаёт `C:\Users\<user>\OneDrive\Документы\deepseek-harness\default-workspace` — битая кодировка «Документы», каталог не существует. Это поведение самого 0.2.2, не пакета; для теста путь рабочей области заменён на репозиторий.
 3. **Headless-профиль** по умолчанию использует API-key route `deepseek-official`; без `DEEPSEEK_API_KEY` ход падает `MISSING_CREDENTIAL`. Web-профиль с `deepseek-account` работает; это ограничение окружения, не плагинов.
 
+## Обновление до 2.2.0 (проверено на этом же стенде)
+
+- В `C:\Users\bulav\dsh-022-home` не было state-файла; один навык (`code-review-checklist`) был намеренно изменён в Skills Studio.
+- После запуска 2.2.0: 24 навыка приняты как пакетные, **1 конфликт** (`modified-unknown-base`), правка сохранена в файле; в UI по-прежнему 25 карточек.
+- `/kit status` вернул `DSH Desktop Kit 2.2.0`, `Плагины: 7/7`, `конфликтов: 1`, путь состояния.
+- `window.__DSH_DESKTOP_KIT__`: version `2.2.0`, 5 частей, `errors: []`.
+
 ## Ограничения теста
 
 - Проверялся профиль `web` и UI через Playwright; отдельный `desktop`-шелл 0.2.2 не запускался (он использует тот же рантайм).

package/docs/TOKENS.md

@@ -1,4 +1,4 @@
-# Экономия токенов в DSH Desktop Kit 2.1
+# Экономия токенов в DSH Desktop Kit 2.2
 
 Документ отвечает на три вопроса: **куда уходили токены раньше**, **что изменилось в 2.x** и **как измерить эффект** на своей сессии.
 

package/docs/UPGRADING.md

@@ -0,0 +1,70 @@
+# Обновление без потери данных
+
+Пакет рассчитан на то, что пользователь обновляется поверх старой версии. Ниже — что происходит с навыками, настройками и DSH.
+
+## 1. Навыки
+
+Каждый навык в пакете имеет SHA-256 в `skills/manifest.json`. После установки пакет пишет состояние:
+
+```
+~/.dsh/skills/.dsh-kit-skills.json
+```
+
+При следующем запуске:
+
+| Ситуация | Действие |
+|---|---|
+| Навыка нет | устанавливается |
+| Навык не менялся с прошлой синхронизации | обновляется, старая версия — в `.dsh-kit-backups/skills/` |
+| Навык изменён пользователем | **не трогается**, попадает в `/kit conflicts` |
+| Нет state-файла, но содержимое совпадает с базой 2.1.4/2.2.0 | обновляется |
+| Нет state-файла, содержимое неизвестно | считается пользовательским, не трогается |
+
+Проверить и разрулить:
+
+```text
+/kit status      # версия, состояние, конфликты
+/kit sync        # синхронизировать без перезаписи правок
+/kit conflicts   # список сохранённых пользовательских версий
+/kit force       # принудительно заменить (сначала бэкап)
+```
+
+Принудительная замена делает копию в `~/.dsh/skills/.dsh-kit-backups/skills/<name>-<дата>`; оттуда можно вернуть свою версию.
+
+## 2. Настройки
+
+- `~/.dsh/dsh-autopilot.json` и `~/.dsh/projects-memory/registry.json` читаются с дефолтами: новые ключи появляются автоматически, старые значения сохраняются.
+- `~/.dsh/projects-memory/<slug>/` не мигрируется и не удаляется.
+- `.dsh-kit-backups/` и `.dsh-kit-trash/` — данные пользователя, пакет их не чистит.
+
+## 3. Обновление DSH
+
+Пакет **не фиксирует** `@deepseek-ai/*` и не задаёт `engines.dsh`: жёсткий диапазон сам стал бы причиной «плагины несовместимы» после обновления клиента. Вместо этого:
+
+- каждый дочерний плагин монтируется отдельно; ошибка одного не снимает остальные;
+- каждая клиентская часть (плагин набора) изолирована: ошибка внутри одной не снимает остальные;
+- ошибки клиента доступны в `window.__DSH_DESKTOP_KIT__` (версия, части, список ошибок);
+- `doctor.ps1` показывает версию, bundle, состояние навыков и закреплённые пакеты.
+
+Проверенная матрица: `0.2.1-rc.5`, `0.2.2-rc.1` (win-x64). Новые версии DSH проверяются отдельным прогоном; отчёт — `docs/TEST-<версия>.md`.
+
+## 4. Откат
+
+1. Поставьте предыдущую версию пакета через «Плагины» (`dsh-desktop-kit@2.1.4`) или `npm i`.
+2. Навыки: верните нужные папки из `.dsh-kit-backups/skills/`.
+3. Сброс состояния навыков (если нужно заново принять пакетные версии):
+
+   ```powershell
+   Remove-Item "$env:USERPROFILE\.dsh\skills\.dsh-kit-skills.json"
+   ```
+
+   После этого `/kit sync` заново сравнит хэши; пользовательские правки всё равно не будут перезаписаны без `/kit force`.
+
+## 5. Что проверить после обновления
+
+- `/kit status` — версия и конфликты.
+- Плитки «Навыки / Токены / Баланс / Расход».
+- Skills Studio: открывается, карточки на месте.
+- Token Lab: панель считает текущую сессию.
+- Память: `/memory status` для рабочей папки.
+- `doctor.ps1` — нет закреплённых `@deepseek-ai/*`.

package/doctor.ps1

@@ -0,0 +1,122 @@
+#requires -Version 5.1
+<#
+.SYNOPSIS
+  Report whether dsh-desktop-kit is installed and enabled.
+#>
+param(
+  [string]$Profile = "desktop",
+  [string]$DshHome = ""
+)
+
+$ErrorActionPreference = "Continue"
+
+if ([string]::IsNullOrWhiteSpace($DshHome)) {
+  if ($env:DSH_HOME) { $DshHome = $env:DSH_HOME } else { $DshHome = Join-Path $env:USERPROFILE ".dsh" }
+}
+
+$profileDir = Join-Path $DshHome "profiles\$Profile"
+$profileJson = Join-Path $profileDir "package.json"
+
+Write-Host "DSH home:  $DshHome"
+Write-Host "Profile:   $profileDir"
+
+$dsh = $null
+$command = Get-Command dsh -ErrorAction SilentlyContinue
+if ($command) { $dsh = $command.Source }
+if (-not $dsh) {
+  $fallback = Join-Path ${env:LOCALAPPDATA} "Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
+  if (Test-Path $fallback) { $dsh = $fallback }
+}
+if ($dsh) {
+  $version = & $dsh --version 2>$null
+  Write-Host "DSH CLI:   $version"
+} else {
+  Write-Host "DSH CLI:   not found" -ForegroundColor Yellow
+}
+
+if (-not (Test-Path $profileJson)) {
+  Write-Host "Profile manifest not found." -ForegroundColor Red
+  exit 1
+}
+
+$json = Get-Content -Path $profileJson -Raw | ConvertFrom-Json
+$issues = 0
+
+$dependency = $null
+if ($json.dependencies) { $dependency = $json.dependencies.'dsh-desktop-kit' }
+if ($dependency) {
+  Write-Host "Package:   $dependency" -ForegroundColor Green
+} else {
+  Write-Host "Package:   not installed" -ForegroundColor Red
+  $issues += 1
+}
+
+$bundles = @()
+if ($json.dsh -and $json.dsh.profile -and $json.dsh.profile.bundles) { $bundles = @($json.dsh.profile.bundles) }
+if ($bundles -contains "dsh-desktop-kit") {
+  Write-Host "Bundle:    enabled" -ForegroundColor Green
+} else {
+  Write-Host "Bundle:    not enabled" -ForegroundColor Red
+  $issues += 1
+}
+
+$link = Join-Path $profileDir "node_modules\dsh-desktop-kit"
+if (Test-Path $link) {
+  Write-Host "Link:      $((Get-Item $link).Target)" -ForegroundColor Green
+  $kitPackage = Join-Path $link "package.json"
+  if (Test-Path $kitPackage) {
+    $kit = Get-Content -Path $kitPackage -Raw | ConvertFrom-Json
+    Write-Host "Kit:       $($kit.version)" -ForegroundColor Green
+  }
+} else {
+  Write-Host "Link:      missing (run install.ps1 again)" -ForegroundColor Red
+  $issues += 1
+}
+
+$statePath = Join-Path $DshHome "skills\.dsh-kit-skills.json"
+if (Test-Path $statePath) {
+  try {
+    $state = Get-Content -Path $statePath -Raw | ConvertFrom-Json
+    $skillNames = @()
+    if ($state.skills) { $skillNames = @($state.skills.PSObject.Properties | ForEach-Object { $_.Name } | Where-Object { $_ }) }
+    $conflictNames = @()
+    if ($state.conflicts) { $conflictNames = @($state.conflicts.PSObject.Properties | ForEach-Object { $_.Name } | Where-Object { $_ }) }
+    Write-Host "Skill sync: $($skillNames.Count) packaged, $($conflictNames.Count) conflicts, updated $($state.updatedAt)" -ForegroundColor Green
+    if ($conflictNames.Count -gt 0) {
+      Write-Host "Skill conflicts (your edits were kept): $($conflictNames -join ', ')" -ForegroundColor Yellow
+      Write-Host "  /kit conflicts - list; /kit sync - update without overwriting"
+    }
+  } catch {
+    Write-Host "Skill sync: state file is unreadable ($($_.Exception.Message))" -ForegroundColor Yellow
+  }
+} else {
+  Write-Host "Skill sync: not written yet (start DSH once or run /kit sync)" -ForegroundColor Yellow
+}
+
+$pinned = @()
+foreach ($name in @($json.dependencies.PSObject.Properties.Name)) {
+  if ($name -like "@deepseek-ai/*") { $pinned += $name }
+}
+if ($pinned.Count -gt 0) {
+  Write-Host "Pinned @deepseek-ai packages (possible 'incompatible plugins' after a DSH update):" -ForegroundColor Yellow
+  $pinned | ForEach-Object { Write-Host "  $_" }
+} else {
+  Write-Host "Pinned packages: none" -ForegroundColor Green
+}
+
+$skillsDir = Join-Path $DshHome "skills"
+if (Test-Path $skillsDir) {
+  $count = (Get-ChildItem $skillsDir -Directory | Measure-Object).Count
+  Write-Host "Skills:    $count" -ForegroundColor Green
+} else {
+  Write-Host "Skills:    folder missing (the kit creates it on first start)" -ForegroundColor Yellow
+}
+
+if ($issues -eq 0) {
+  Write-Host ""
+  Write-Host "Everything is in place." -ForegroundColor Green
+  exit 0
+}
+Write-Host ""
+Write-Host "$issues problem(s) found." -ForegroundColor Red
+exit 1