dsh-desktop-kit 0.0.0-stage → 2.0.0

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# One Host row for the whole kit: index.js mounts every bundled plugin as a
+# child plugin, so disabling the kit disables all of them at once.
+- insert:
+    - id: dsh-desktop-kit
+      name: dsh-desktop-kit

package/docs/ARCHITECTURE.md

@@ -0,0 +1,114 @@
+# Архитектура
+
+## Состав репозитория
+
+```
+dsh-desktop-kit/
+├─ package.json          пакет-«зонтик», который ставится через «Add plugin»
+├─ index.js              host-половина: монтирует семь плагинов дочерними
+├─ client.js             сгенерированная браузерная половина (5 плагинов)
+├─ cordis.patch.yml      одна строка bundle → dsh-desktop-kit
+├─ plugins/
+│  ├─ dsh-gkb-ru-ui/     русский UI, плитки, Skills Studio
+│  ├─ dsh-skill-autopilot/  маршрут навыков по сообщению
+│  ├─ dsh-token-lab/     замер контекста и панель
+│  ├─ dsh-peak-guard/    предупреждение о пиковом тарифе
+│  ├─ dsh-project-memory/
+│  ├─ dsh-session-move/
+│  └─ dsh-profile-transfer/
+├─ skills/               25 навыков (ядро + references)
+├─ tools/                сборка, smoke, проверка бюджета навыков
+├─ docs/                 документация и hero-картинка
+└─ assets/               исходник hero.html (в npm не входит)
+```
+
+## Почему один пакет, а не семь зависимостей
+
+DSH ставит плагин как пакет профиля и загружает его клиентскую половину по имени пакета. Пакет-«зонтик» с зависимостями на подпакеты не годится: pnpm кладёт их в `node_modules/.pnpm`, а загрузчик ищет `dsh.client` у пакета, который указан в строке bundle. Поэтому зонтик **вендорит** исходники и объединяет половины сам.
+
+## Host-половина
+
+`index.js` импортирует семь host-модулей и монтирует каждый через `ctx.plugin(plugin)`:
+
+- у каждого дочернего плагина свой `inject`, поэтому отсутствующий сервис оставляет pending только этот плагин, а не весь набор;
+- отключение `dsh-desktop-kit` в списке плагинов снимает все семь;
+- ошибка монтирования одного плагина логируется и не мешает остальным.
+
+При старте `installSkills()` копирует из `skills/` только отсутствующие папки в `~/.dsh/skills`. Существующие навыки не перезаписываются: обновление библиотеки — отдельное осознанное действие.
+
+## Автопилот навыков
+
+`dsh-skill-autopilot` регистрирует `ctx.systemPrompt.context({ name: "dsh-desktop-kit:skill-autopilot", order: 132 })`:
+
+1. при сборке промпта берёт живую сессию из `assemblyContext.agent.session`;
+2. читает последний `user/message` из `session.surface.nodes` (кэш по `seq`);
+3. прогоняет текст по 16 правилам (`RULES`), фильтрует имена по реально существующим `~/.dsh/skills/*/SKILL.md`;
+4. возвращает блок `<skill-autopilot>` с ядрами и их ценой либо пустую строку.
+
+RPC `/api/dsh-skill-autopilot/state|set|route` отдаёт состояние, меняет режим и позволяет прогнать текст через маршрутизатор. Режим хранится в `~/.dsh/dsh-autopilot.json`.
+
+## Token Lab
+
+`dsh-token-lab` — два RPC:
+
+- `report` — `ctx.tokenMeter.measure(session)`, группировка узлов по типу события, топ-6, серия роста, стоимость библиотеки навыков;
+- `ping` — health-check.
+
+Подписи tool-результатов берутся из `tool/call` (`callId → name + hint`), поэтому в панели видно `Результат · read · src/app.ts`, а не сырой JSON. Клиент — плитка в общем стеке сайдбара и оверлей-панель.
+
+## Skills Studio
+
+Хост-часть `dsh-gkb-ru-ui`:
+
+- `lib/skills.js` читает `~/.dsh/skills`, считает usage по session-логам, стоимость ядра и references;
+- RPC `skill`, `skill-save`, `skill-create`, `skill-duplicate`, `skill-delete`, `open-skill`;
+- запись атомарная (tmp + rename), перед сохранением — копия в `.dsh-kit-backups`, удаление — перенос в `.dsh-kit-trash`;
+- имена проверяются по kebab-case, `name` во frontmatter обязан совпадать с папкой.
+
+Клиент — каталог с карточками, деталями и редактором; `Ctrl+S`, живой счётчик токенов, предупреждение при ядре > 6k.
+
+## Клиентская половина
+
+Каждый плагин поставляет самодостаточный `client.js`, который вызывает `window.__ModuleLoader__.load({ id, factory })`.
+
+`tools/build-client.mjs`:
+
+1. читает `exports["./client"]` каждого плагина;
+2. вырезает тело `factory` (до `return module.exports;`);
+3. оборачивает каждое тело в IIFE — переменные плагинов не пересекаются;
+4. собирает один модуль `dsh-desktop-kit`:
+   - `inject` — объединение `inject` всех частей;
+   - `apply` — вызывает `apply` каждой части в try/catch.
+
+Пересобрать и проверить:
+
+```powershell
+node tools/build-client.mjs
+node tools/check-client.mjs client.js
+node tools/smoke-tests.mjs
+```
+
+`smoke-tests.mjs` поднимает фейковый Cordis-контекст и фейковый `__ModuleLoader__`: проверяет регистрацию слотов, RPC, автопилот и редактирование навыков без браузера.
+
+## Общий стек плиток
+
+Плитка Token Lab не регистрирует второй `sidebar.footer.action` (иначе слот раскладывает её в строку с плиткой навыков). Token Lab кладёт компонент в `window.__DSH_TOKEN_TILE__`, а `SidebarTiles` в `dsh-gkb-ru-ui` рендерит его четвёртым элементом общей колонки. На узких экранах (`max-width: 760px`) стек скрыт, вместо него — мобильная кнопка «Навыки».
+
+## Русская локаль
+
+В 0.2.1 плагин `dsh-gkb-ru-ui` добавлял локаль `ru`. В 0.2.2 она уже встроена, и повторная регистрация перезаписывала штатные словари. Теперь блок локали:
+
+- пытается добавить `ru` и ловит «already registered»;
+- при уже существующей локали **не** регистрирует старые словари;
+- продолжает регистрировать плитки и каталог навыков.
+
+## Навыки
+
+Навыки — обычные папки с `SKILL.md` (frontmatter `name`, `description`, `whenToUse`) и `references/`. DSH читает их из `~/.dsh/skills`; каталог в интерфейсе строит `dsh-gkb-ru-ui`.
+
+Проверки перед релизом:
+
+```powershell
+node tools/skill-cost.mjs --check   # ядро не больше 6k токенов
+node tools/validate-skills.mjs      # frontmatter и ссылки
+```

package/docs/COMPATIBILITY.md

@@ -0,0 +1,61 @@
+# Совместимость
+
+## Матрица
+
+| DSH | Состояние | Что проверено |
+|---|---|---|
+| `0.2.1-rc.5` | работает | **2.0 проверена вживую**: 7 плагинов, Skills Studio (редактирование/создание/корзина), Token Lab на `tokenMeter`, автопилот в промпте, 25 навыков, скриншоты 1440/390 light/dark |
+| `0.2.2-rc.1` | работает (1.x) | хост-часть монтируется, клиентский бандл грузится, ошибок в консоли нет, навыки копируются; 2.0 на этой сборке ещё не прогонялась |
+| новее `0.2.2` | не проверено | API плагинов в 0.2.x ещё меняется; см. «Если сломалось» |
+
+## Что использует 2.0
+
+| Возможность DSH | Где используется | Проверено |
+|---|---|---|
+| `sidebar.footer.action` | общий стек плиток | да |
+| `shell.overlay` | каталог, Token Lab, мобильная кнопка | да |
+| `ctx.tokenMeter.measure(session)` | точный замер контекста | да, 0.2.1-rc.5 |
+| `ctx.systemPrompt.context()` + `assemblyContext.agent.session` | автопилот навыков | да |
+| `ctx.sessions.get/list` | выбор живой сессии | да |
+| `ctx.skills` / `~/.dsh/skills` | каталог и загрузка навыков | да |
+| `connection.rpc.call` + `connection.fetch.register` | RPC плагинов | да |
+| `window.__ModuleLoader__.load({id, factory})` | клиентский бандл | да |
+
+## Почему после обновления было «плагины несовместимы»
+
+Старый профиль после импорта содержал:
+
+- `dependencies` с точными версиями `@deepseek-ai/dsh-experimental-*` = `0.2.1-rc.5`;
+- `dsh.profile.bundles` с теми же experimental-бандлами.
+
+DSH 0.2.2 при старте проверяет `engines.dsh` и peer-диапазоны зависимостей профиля. Пакеты, собранные под `0.2.1-rc.5`, не проходят проверку — клиент отказывается их грузить и показывает «плагины несовместимы». Профиль при этом может быть пересоздан в минимальный (`dsh-base` + `dsh-web-app`), и все локальные плагины исчезают из списка.
+
+В этом репозитории таких зависимостей нет: пакет не тянет `@deepseek-ai/*` и не фиксирует версии. Поэтому установка из «Плагинов» проходит проверку совместимости.
+
+## Что изменилось в 0.2.2 и как учтено
+
+| Изменение | Как учтено |
+|---|---|
+| Русская локаль `ru` встроена | плагин не регистрирует свою копию, если `ru` уже есть; иначе перезапись словарей ломала штатные экраны |
+| Слоты сайдбара и настроек | проверено: `sidebar.footer.action`, `sidebar.workspaces.session.menu.item`, `shell.overlay`, `settings.section`, `conversation.composer.dock`, `conversation.session.header.utilities` существуют в 0.2.2 |
+| Сервис аккаунта | `remote.account` присутствует в `dsh-client-ui-settings-account` 0.2.2 |
+| Фасад `window.__ModuleLoader__.load({id, factory})` | сохранён в 0.2.2; рукописные бандлы грузятся наравне со сборкой tsdown |
+| Проверка `engines.dsh` | поле не задаётся: без объявленного требования установка не блокируется |
+
+## Как проверялось
+
+1. Собран профиль `probe` из шаблона `web` в изолированном `DSH_HOME`.
+2. `dsh plugin --profile probe add <репозиторий>` — установка прошла без `incompatible-version`.
+3. В `package.json` добавлен bundle `dsh-desktop-kit`, `--dump-config` показал host-ряд.
+4. Запущен `dsh --profile probe --no-open --port 58888`.
+5. В HTML boot-графа присутствует `dsh-desktop-kit/client.js`.
+6. Headless Chromium + CDP: `EXCEPTIONS []`, ни одной неактивированной записи, `window.__DSH_PEAK_GUARD__` и `window.__DSH_SESSION_MOVE__` — объекты, режим пика `peak` (09:0x МСК).
+7. После старта хоста в `DSH_HOME/skills` появились все 25 навыков.
+8. **2.0:** пакет поставлен в живой профиль `desktop` через Plugin Manager (локальная папка), хост применился без перезапуска; Skills Studio сохранила и откатила навык (бэкап в `.dsh-kit-backups`), Token Lab показал фактический замер 402k токенов, автопилот выдал маршрут по сообщению; `node tools/smoke-tests.mjs` — 2/2, `skill-cost --check` — все ядра в бюджете.
+
+## Если сломалось на новой версии
+
+1. Проверьте `doctor.ps1`: нет ли в профиле закреплённых `@deepseek-ai/*` версий.
+2. Обновите пакет: `git pull`, затем в «Плагинах» удалите и поставьте заново.
+3. Если DSH изменил имена слотов, плитки просто не отрисуются, а остальное продолжит работать: каждая часть изолирована.
+4. Аварийный обход проверки совместимости (на свой риск): `dsh plugin --profile desktop allow-version <пакет@версия> --dsh-version <версия> --accept-risk`.

package/docs/INSTALL.md

@@ -0,0 +1,84 @@
+# Установка
+
+## Требования
+
+- Windows 10/11.
+- DeepSeek Harness **0.2.1-rc.5** или новее (`0.2.2-rc.1` проверен).
+- Профиль `desktop` уже создан: запустите DSH один раз и закройте окно.
+
+## Способ 1. Интерфейс «Плагины» (как у обычного пользователя)
+
+1. Скопируйте репозиторий себе:
+
+   ```powershell
+   git clone <URL-репозитория> "$env:USERPROFILE\dsh-desktop-kit"
+   ```
+
+2. В DSH откройте **Плагины → Add plugin**.
+3. Вставьте путь к корню репозитория, например:
+
+   ```
+   C:\Users\<вы>\dsh-desktop-kit
+   ```
+
+   Либо URL репозитория, если он опубликован на GitHub:
+
+   ```
+   https://github.com/<логин>/dsh-desktop-kit
+   ```
+
+4. Нажмите **Install** и дождитесь завершения установки.
+5. Перезапустите DSH (или `Ctrl+R` в окне).
+
+Плагин сам:
+- добавит один bundle `dsh-desktop-kit` в профиль;
+- смонтирует пять плагинов как дочерние;
+- скопирует недостающие навыки в `~/.dsh/skills`.
+
+## Способ 2. Скрипт
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\install.ps1
+```
+
+Параметры:
+
+| Параметр | По умолчанию | Назначение |
+|---|---|---|
+| `-Profile` | `desktop` | имя профиля DSH |
+| `-DshHome` | `%DSH_HOME%` или `%USERPROFILE%\.dsh` | домашний каталог DSH |
+| `-RepoPath` | папка скрипта | путь к пакету |
+
+Скрипт делает бэкап `package.json` и `cordis.patch.yml`, вызывает `dsh plugin add` и включает bundle.
+
+## Способ 3. Отдельные плагины
+
+Добавьте в «Add plugin» путь к папке нужного плагина из `plugins/` (см. таблицу в README). Каждый плагин самостоятелен: свой `cordis.patch.yml`, свой клиентский бандл.
+
+## Проверка после установки
+
+1. **Плагины**: в списке появился `dsh-desktop-kit` (или отдельные плагины), переключатель включён.
+2. **Сайдбар**: внизу — плитки «Навыки», «Баланс», «Расход» (нужен вход в аккаунт DeepSeek; на экране входа сайдбар скрыт).
+3. **Пиковый тариф**: если сейчас 04:00–07:00 или 09:00–13:00 МСК — над композером красная карточка; за 5 минут до окна — жёлтая.
+4. **Навыки**: `~/.dsh/skills` содержит 24 папки, в интерфейсе открывается каталог навыков.
+5. **Перенос**: Настройки → «Перенос и резервные копии».
+6. **Перемещение чатов**: правый клик по чату → «Переместить в рабочую область…».
+
+Диагностика: `powershell -ExecutionPolicy Bypass -File .\doctor.ps1`.
+
+## Удаление
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\uninstall.ps1
+```
+
+Навыки остаются (они ваши). Удалить и их: `-RemoveSkills`.
+
+## Ручная установка без скрипта и UI
+
+1. Скопируйте папки плагинов в `%USERPROFILE%\.dsh\local-plugins\`.
+2. В `%USERPROFILE%\.dsh\profiles\desktop\package.json`:
+   - в `dependencies` добавьте `"dsh-desktop-kit": "link:<путь к репозиторию>"` (прямые слэши);
+   - в `dsh.profile.bundles` добавьте `"dsh-desktop-kit"`.
+3. Выполните `dsh plugin --profile desktop install` (встроенный pnpm DSH).
+4. Перезапустите DSH.

package/docs/PRIVACY.md

@@ -0,0 +1,50 @@
+# Конфиденциальность
+
+Репозиторий собран из рабочего профиля DSH, но **не содержит личных данных**.
+
+## Что не включено
+
+| Данные | Почему |
+|---|---|
+| `~/.dsh/.credentials.yaml`, токены, ключи API | секреты |
+| `~/.dsh/sessions`, `attachments` | переписка и вложения |
+| `~/.dsh/memory`, `~/.dsh/projects-memory` | личные заметки, досье проектов, имена и контакты |
+| `AGENTS.md` | личные инструкции и сведения об организациях |
+| `workspace.json`, реестр рабочих областей | локальные пути и история |
+| скриншоты с личными путями | метаданные окружения |
+
+## Что обезличено в навыках и плагинах
+
+| Было | Стало |
+|---|---|
+| `C:\Users\<имя>` | `%USERPROFILE%` |
+| имя владельца | «Владелец профиля» |
+| домен сайта | `example.org` |
+| название организации | `организация` |
+| внутренний сервер | `app-server` |
+| внутренний IP | `127.0.0.1` |
+| путь деплоя | `/var/www/service-desk` |
+| имя машины | `workstation` |
+
+## Что пишется на диск при работе
+
+| Файл | Что содержит | Можно удалить |
+|---|---|---|
+| `~/.dsh/dsh-autopilot.json` | режим автопилота и лимит навыков | да, вернётся к значениям по умолчанию |
+| `~/.dsh/skills/.dsh-kit-backups/*.md` | резервные копии `SKILL.md` перед сохранением в Studio | да, это только копии |
+| `~/.dsh/skills/.dsh-kit-trash/<дата>-<навык>/` | навыки, удалённые через Studio | да, после проверки |
+
+Token Lab ничего не пишет: он читает `ctx.tokenMeter` и отдаёт отчёт в интерфейс. Ни один плагин набора не отправляет данные в сеть.
+
+## Что осталось
+
+- Идентификаторы пакетов (`dsh-gkb-ru-ui` и т. п.) — это имена модулей, а не персональные данные; переименование сломало бы RPC-маршруты и состояние.
+- Технические описания проектов в навыках `service-desk-*` — методология без доступа, адресов и учётных данных.
+
+## Если добавляете свои файлы
+
+Не коммитьте `node_modules`, архивы профиля, `.env`, `*.log`. Проверка перед публикацией:
+
+```powershell
+Select-String -Path (Get-ChildItem -Recurse -File -Include *.md,*.js,*.json,*.yml) -Pattern 'C:\\Users\\|password|secret|token'
+```

package/docs/ROADMAP.md

@@ -0,0 +1,57 @@
+# Развитие DSH Desktop Kit
+
+Дорожная карта от 2.0. Приоритеты: **экономия контекста → качество навыков → управление в интерфейсе → командная работа**.
+
+## Уже в 2.0
+
+- компактные ядра навыков и references (25 навыков);
+- `dsh-skill-autopilot` — навыки применяются по смыслу запроса, а не по памяти модели;
+- `dsh-token-lab` — живой замер контекста, состав, топ потребителей, экономия библиотеки;
+- Skills Studio — редактирование, создание, дублирование и удаление навыков в GUI;
+- единая колонка плиток в сайдбаре и адаптив под низкие окна (настройки/аккаунт больше не уезжают);
+- новый визуал пакета: hero, скриншоты light/dark/390, честные ссылки на изображения.
+
+## 2.1 — умнее маршрутизация и меньше шума
+
+1. **Семантический роутинг.** Заменить/keyword-правила на гибрид: быстрые ключи + эмбеддинги названий/описаний навыков. Офлайн-модель на 20–40 МБ, без внешних API.
+2. **Обучение на истории.** Считать, какие навыки реально помогли (по последующим правкам/тестам), и поднимать их приоритет. Хранить локально в `~/.dsh/skill-stats.json`.
+3. **Дедупликация правил.** Перед загрузкой ядра проверять, не загружено ли оно уже в этой сессии; в подсказке писать «уже в контексте».
+4. **Бюджет на задачу.** Настройка «максимум N токенов на навыки»: автопилот выбирает самые дешёвые подходящие ядра.
+5. **A/B навыков.** Кнопка «сравнить» в Studio: две версии ядра на одинаковой задаче, счётчик токенов и результат.
+
+## 2.2 — Token Lab как центр управления
+
+1. **Прогноз сжатия.** Показывать, сколько освободит компакция и что попадёт в сводку.
+2. **Одноклик «сжать»** с предварительным handoff в память проекта.
+3. **Разбивка по инструментам.** Сколько токенов съели `read`, `grep`, `cordis_inspect_query`; рекомендации «читать диапазоном».
+4. **История сессий.** График расхода по дням, пики, средняя стоимость задачи; интеграция с `dsh-peak-guard` (цена ×2 в пиковые часы).
+5. **Экспорт отчёта** в Markdown/PNG для ретро.
+
+## 2.3 — Skills Studio 2.0
+
+1. **Diff-редактор** с подсветкой синтаксиса Markdown/YAML и валидацией frontmatter.
+2. **Проверка ссылок**: если в ядре упомянут `references/x.md`, а файла нет — ошибка до сохранения.
+3. **Импорт/экспорт навыка** одним `.zip` (совместимо с `dsh-profile-transfer`).
+4. **Шаблоны под роли**: «дизайн», «бэкенд», «безопасность», «контент» — с готовой структурой.
+5. **Песочница**: прогнать сообщение через автопилот и увидеть, какие навыки он выберет, до отправки.
+
+## 3.0 — экосистема
+
+1. **Маркетплейс наборов.** Пакеты навыков от сообщества: подпись, версия, минимальная версия DSH, проверка секретов.
+2. **Граф зависимостей навыков.** Навык может требовать другой (например, `seo` → `content-writing`), Studio показывает циклы.
+3. **Командные профили.** Один профиль на команду: навыки, память проектов, политики; синхронизация через git, без облака.
+4. **Плагин-конструктор.** Визуальная сборка простых плагинов (плитка, панель, команда) с генерацией `client.js` и проверкой в песочнице.
+5. **Локализация.** EN/ES/DE для интерфейса и навыков; русский остаётся эталонным.
+
+## Идеи, которые стоит проверить
+
+- **Контекстные «закладки»**: помечать важные сообщения, чтобы компакция их не съедала.
+- **Навык-детектор** для повторяющихся задач: если три раза подряд грузится один набор — предложить объединённый навык.
+- **Тихий режим**: при пиковом тарифе автопилот предлагает более дешёвую модель/меньше references.
+- **Метрики качества**: после задачи спрашивать «помогло?» и хранить оценку рядом с навыком.
+
+## Как предложить своё
+
+1. Опишите сценарий и ожидаемый эффект (токены, время, качество).
+2. Приложите пример сообщения и желаемый маршрут навыков.
+3. Если это код — тесты `node tools/smoke-tests.mjs` и `node tools/skill-cost.mjs --check` обязательны.

package/docs/TOKENS.md

@@ -0,0 +1,118 @@
+# Экономия токенов в DSH Desktop Kit 2.0
+
+Документ отвечает на три вопроса: **куда уходили токены раньше**, **что изменилось в 2.0** и **как измерить эффект** на своей сессии.
+
+## 1. Откуда берётся расход
+
+Контекст модели на каждом шаге состоит из:
+
+| Слой | Что входит | Типичный размер |
+|---|---|---|
+| Системный промпт | инструкции DSH, каталог навыков, правила плагинов | 3–8k токенов |
+| История диалога | сообщения, ответы, результаты инструментов | растёт с каждым шагом |
+| Загруженные навыки | `SKILL.md` + `references` | 1–12k на навык |
+| Память проекта | дайджест досье | 0.5–1k |
+| Схемы инструментов | описания tool-вызовов | 2–5k |
+
+Главная проблема старого набора: **навыки грузились целиком**. `content-writing` и `seo` весили по 37 КБ каждый — это ≈11k токенов за один вызов. Типовая задача с UI, SEO и контентом набирала 30–35k только на навыки.
+
+## 2. Что сделано в 2.0
+
+### 2.1. Компактные ядра + references
+
+Каждый навык теперь состоит из:
+
+- **ядра** `SKILL.md` — 3–6 КБ: когда применять, жёсткие правила, карта ссылок, гейт сдачи;
+- **references/** — подробные материалы, которые грузятся только по необходимости.
+
+Ядро всегда отвечает на вопрос «что делать», reference — «как делать в частном случае». В конце ядра есть таблица «Нужно → файл → ≈токенов», поэтому модель не грузит справочники «на всякий случай».
+
+Проверка бюджета:
+
+```powershell
+node tools/skill-cost.mjs          # таблица и суммы
+node tools/skill-cost.mjs --check  # падает, если ядро > 6k токенов
+```
+
+### 2.2. Автопилот навыков
+
+Плагин `dsh-skill-autopilot` читает последнее сообщение пользователя при сборке промпта и добавляет короткий блок:
+
+```xml
+<skill-autopilot>
+Запрос похож на: UI/дизайн + SEO.
+Загрузи через tool skill только эти ядра: wow-design ≈1.4k токенов, seo ≈1.8k токенов.
+...
+</skill-autopilot>
+```
+
+Свойства:
+
+- блок появляется **только при совпадении** с правилами; на посторонний вопрос — ноль токенов;
+- имена фильтруются по реально установленным навыкам;
+- бюджет блока — ≈80–140 токенов;
+- режим и лимит навыков хранятся в `~/.dsh/dsh-autopilot.json`;
+- RPC `/api/dsh-skill-autopilot/state` отдаёт статус, правила и последнее совпадение для интерфейса.
+
+Правила лежат в `plugins/dsh-skill-autopilot/index.js` (`RULES`): 16 семейств задач, русские и английские триггеры. Их можно дополнять под свой стек.
+
+### 2.3. Token Lab
+
+Плагин `dsh-token-lab` показывает точный замер контекста из `ctx.tokenMeter`:
+
+- общий объём и заполнение окна;
+- состав по типам сообщений (системный промпт, пользователь, ответы, результаты инструментов, память);
+- топ-6 самых тяжёлых узлов с человеческими подписями (`Результат · read · src/app.ts`);
+- рост контекста по шагам;
+- стоимость библиотеки навыков: сколько было бы, если грузить всё, против трёх средних ядер.
+
+Плитка в сайдбаре показывает `282,6k из 1M · 27%` и полосу давления; порог 50% — жёлтый, 75% — красный.
+
+### 2.4. Skills Studio
+
+Каталог навыков превратился в редактор:
+
+- стоимость ядра на карточке и в деталях;
+- редактирование `SKILL.md` прямо в интерфейсе, `Ctrl+S`, живой счётчик токенов;
+- создание навыка из шаблона и дублирование;
+- удаление в корзину `~/.dsh/skills/.dsh-kit-trash` (обратимо);
+- резервная копия перед каждой записью в `~/.dsh/skills/.dsh-kit-backups`;
+- предупреждение, если ядро выходит за бюджет 6k токенов.
+
+### 2.5. Память проекта
+
+Дайджест памяти ограничен 2 800 символами (≈900 токенов) и обновляется по сигнатуре проекта. В 2.0 добавлено правило: при 60–70% окна сначала записать handoff, потом сжимать.
+
+## 3. Как измерить эффект
+
+1. Откройте Token Lab в начале и в конце задачи.
+2. Сравните `totalTokens` и состав: результаты инструментов обычно занимают 40–50%.
+3. Проверьте, какие навыки загружены: в каталоге есть бейдж «в работе» и число запусков.
+4. Для оценки библиотеки:
+
+```powershell
+node tools/skill-cost.mjs --json > skill-cost.json
+```
+
+В отчёте есть `totalTokens` (вся библиотека) и `rows` (каждое ядро). Типичная задача = 2–3 ядра.
+
+## 4. Ориентиры 2.0
+
+| Показатель | До | После |
+|---|---|---|
+| `content-writing` ядро | ≈11 000 токенов | ≈1 800 |
+| `seo` ядро | ≈11 000 токенов | ≈1 900 |
+| `wow-design` ядро | ≈5 000 токенов | ≈1 700 |
+| `skills-router` ядро | ≈2 900 токенов | ≈1 500 |
+| Библиотека из 25 навыков | ≈60 000 токенов | ≈25 000 |
+| Типовая задача (3 навыка) | 25 000–35 000 | 5 000–7 000 |
+| Подсказка автопилота | — | 80–140 |
+
+Цифры — оценка `байты / 3.2`; фактический расход зависит от модели и языка.
+
+## 5. Правила, которые нельзя нарушать ради экономии
+
+- Не сокращать проверки безопасности, бэкапы и тесты.
+- Не выбрасывать references, которые меняют решение (медицина, право, деньги, данные).
+- Не экономить на финальном ревью: ошибка дороже токенов.
+- Не отключать автопилот на задачах с данными — он подсказывает `database-safety`.

package/docs/TROUBLESHOOTING.md

@@ -0,0 +1,68 @@
+# Если что-то не работает
+
+## «Плагины несовместимы»
+
+1. Откройте `doctor.ps1` — он покажет закреплённые `@deepseek-ai/*` в профиле.
+2. Уберите из `~/.dsh/profiles/desktop/package.json` зависимости `@deepseek-ai/dsh-experimental-*` и их имена из `dsh.profile.bundles` (или создайте профиль заново: `dsh rescue --from-default-profile web`).
+3. Поставьте `dsh-desktop-kit` заново через «Add plugin».
+4. Перезапустите DSH.
+
+## Плагин установился, но ничего не появилось
+
+- В «Плагинах» переключатель `dsh-desktop-kit` включён?
+- Перезапуск DSH (не только `Ctrl+R`): host-часть грузится при старте.
+- Плитки «Навыки / Токены / Баланс / Расход» видны только после входа в аккаунт DeepSeek: на экране входа сайдбар скрыт.
+- На узком окне (≤ 760 px) стек плиток скрыт намеренно: каталог открывает кнопка «Навыки» внизу справа.
+- Проверьте консоль (`Ctrl+Shift+I`) на строки `[dsh-desktop-kit]`, `[token-lab]`, `[skill-autopilot]`.
+
+## Нет каталога навыков
+
+- `~/.dsh/skills` должен содержать 25 папок. Если пусто — плагин не стартовал; скопируйте вручную:
+
+  ```powershell
+  Copy-Item .\skills\* "$env:USERPROFILE\.dsh\skills\" -Recurse -Force
+  ```
+
+- Каталог открывается плиткой «Навыки» (или мобильной кнопкой); если её нет — см. пункт выше.
+
+## Нет данных в Token Lab
+
+- Плитка показывает `0 из 128k` на пустой сессии — это нормально: откройте чат с сообщениями.
+- Панель берёт замер из `ctx.tokenMeter`; если сервис недоступен, будет ошибка `tokenlab/no-meter` — обновите DSH.
+- На очень длинной сессии отчёт может считаться 1–2 секунды: это чтение журнала, а не зависание.
+
+## Автопилот не подсказывает навыки
+
+- Проверьте `~/.dsh/dsh-autopilot.json`: `{"mode":"on"}`.
+- Он молчит, если сообщение не совпало с правилами — это экономия, а не поломка.
+- Последнее совпадение видно в Skills Studio (шапка) или через RPC `dsh-skill-autopilot/state`.
+- Правила лежат в `plugins/dsh-skill-autopilot/index.js` (`RULES`) — дополняйте под свой стек.
+
+## Skills Studio не сохраняет
+
+- Имя навыка: kebab-case `[a-z0-9-]`, `name` во frontmatter обязан совпадать с папкой.
+- Размер `SKILL.md` — до 200 КБ; для больших материалов используйте `references/`.
+- Перед записью создаётся копия в `.dsh-kit-backups`; если запись не удалась, старая версия осталась на месте.
+- Удаление обратимо: папка уходит в `.dsh-kit-trash`, а не удаляется.
+
+## Не показывается карточка пикового тарифа
+
+Карточка появляется только в пиковые окна (04:00–07:00 и 09:00–13:00 МСК) и за 5 минут до начала. Проверка:
+
+```js
+window.__DSH_PEAK_GUARD__.state()
+window.__DSH_PEAK_GUARD__.preview("2026-11-06T06:30:00Z") // принудительно
+window.__DSH_PEAK_GUARD__.clearPreview()
+```
+
+## Пропали чаты после обновления
+
+Сессии лежат в `~/.dsh/sessions` и не удаляются плагином. Если профиль был пересоздан, чаты могут отображаться в «Без проекта» — перенесите их через `dsh-session-move` или верните реестр рабочих областей из бэкапа.
+
+## Откат
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\uninstall.ps1
+```
+
+Скрипт снимает пакет и bundle, `package.json` и `cordis.patch.yml` сохраняются в `backup-kit-*`.