dsh-desktop-kit 1.0.0 → 2.0.1

package/README.md

@@ -1,83 +1,148 @@
-# DSH Desktop Kit
+# DSH Desktop Kit 2.0
 
-Набор плагинов и навыков для **DeepSeek Harness 0.2.x** (проверено на `0.2.1-rc.5` и `0.2.2-rc.1`): русский интерфейс, плитки «Навыки / Баланс / Расход», предупреждение о двойном расходе токенов в пиковые часы, память проектов, перенос чатов между рабочими областями и резервное копирование профиля.
+**Навыки, которые применяются сами. Контекст, который видно. Интерфейс, который не мешает.**
 
-![Пиковый тариф](plugins/dsh-peak-guard/screenshots/03-peak-card-1440-light.png)
+Набор из **7 плагинов и 25 навыков** для DeepSeek Harness 0.2.x: русский интерфейс, автопилот навыков, токен-лаборатория, студия навыков, память проектов, перенос чатов и резервные копии профиля.
+
+![DSH Desktop Kit 2.0](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.1/docs/images/hero.png)
+
+**v2.0.1** · MIT · проверено на DSH `0.2.1-rc.5` (Windows 11) · без внешних зависимостей и телеметрии
+
+---
+
+## Что нового в 2.0
+
+- **Навыки стали в 3–5 раз дешевле.** Ядро `content-writing` — 2,1k токенов вместо 11k, `seo` — 2,0k вместо 11k. Вся библиотека из 25 навыков — ≈37,6k вместо ≈60,6k, а грузятся только нужные ядра.
+- **`dsh-skill-autopilot`** читает ваш запрос и подсказывает модели 2–3 точных навыка. Подсказка появляется только при совпадении и стоит 80–140 токенов.
+- **`dsh-token-lab`** — живая лаборатория контекста: состав, топ потребителей, рост и экономия библиотеки навыков.
+- **Skills Studio** — каталог навыков стал редактором: правка `SKILL.md`, живой счётчик токенов, создание, дублирование и обратимое удаление.
+- **Сайдбар стал компактным и адаптивным:** плитки не выталкивают аккаунт и настройки, на 390 px работает мобильная кнопка каталога.
+- **Новый визуал пакета:** hero, скриншоты light/dark/390 и честные ссылки на изображения.
+
+## Экономия токенов
+
+| Что | До 2.0 | В 2.0 |
+|---|---:|---:|
+| `content-writing` (ядро) | ≈11 100 | ≈2 100 |
+| `seo` (ядро) | ≈11 000 | ≈2 000 |
+| `wow-design` (ядро) | ≈5 000 | ≈1 900 |
+| `skills-router` (ядро) | ≈2 900 | ≈1 700 |
+| Библиотека 25 навыков | ≈60 600 | ≈37 600 |
+| Типовая задача (3 ядра) | 15 000–30 000 | ≈4 500 |
+| Подсказка автопилота | — | 80–140 |
+
+Как это устроено:
+
+1. **Ядро + references.** В `SKILL.md` остались триггеры, жёсткие правила и гейт сдачи; подробности лежат в `references/` и грузятся только по необходимости.
+2. **Карта ссылок.** В конце каждого ядра — таблица «Нужно → файл → ≈токенов», чтобы модель не читала справочники «на всякий случай».
+3. **Автопилот.** Перед шагом модели добавляется короткий блок с точными именами навыков и их ценой.
+4. **Измерение.** `dsh-token-lab` показывает фактический замер `ctx.tokenMeter`, а не догадки.
+
+Подробный разбор и методика замера — [docs/TOKENS.md](docs/TOKENS.md).
+
+## Скриншоты
+
+### Skills Studio: каталог, стоимость и редактор
+
+![Каталог навыков](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.1/plugins/dsh-gkb-ru-ui/screenshots/02-skills-1440-light.png)
+
+![Редактор навыка](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.1/plugins/dsh-gkb-ru-ui/screenshots/03-skills-editor-1440-light.png)
+
+### Token Lab: куда уходит контекст
+
+![Токен-лаборатория](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.1/plugins/dsh-token-lab/screenshots/01-token-lab-1440-light.png)
+
+### Тёмная тема и мобильный
+
+![Тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.1/plugins/dsh-gkb-ru-ui/screenshots/04-skills-1440-dark.png)
+
+<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.1/plugins/dsh-gkb-ru-ui/screenshots/05-skills-390-light.png" alt="Каталог навыков на 390 px" width="390">
 
 ## Что внутри
 
 | Компонент | Что делает |
 |---|---|
-| `dsh-gkb-ru-ui` | Русский интерфейс, плитки «Навыки», «Баланс», «Расход» в сайдбаре, каталог навыков со статистикой использования. Баланс и расход токенов опрашиваются через аккаунт DeepSeek и обновляются в реальном времени. |
-| `dsh-peak-guard` | Красная карточка в чате, когда действует пиковый тариф ×2: причина, окно в местном времени и UTC, живой отсчёт, совет когда вернуться. За 5 минут до пика — жёлтое предупреждение. |
-| `dsh-project-memory` | Локальная память проектов: досье, авто-дайджест в контексте, инструмент `project_memory`, автожурнал, `/remember`. |
+| `dsh-gkb-ru-ui` | Русский интерфейс, компактные плитки «Навыки / Токены / Баланс / Расход», Skills Studio с редактированием и статистикой использования. |
+| `dsh-skill-autopilot` | Читает последнее сообщение и добавляет в промпт точный маршрут навыков. Нет совпадения — нет накладных расходов. |
+| `dsh-token-lab` | Живой замер контекста: состав по типам, топ-6 узлов, рост, давление на окно, цена библиотеки навыков. |
+| `dsh-peak-guard` | Красная карточка в чате, когда действует пиковый тариф ×2: причина, окно, живой отсчёт и совет, когда вернуться. |
+| `dsh-project-memory` | Локальная память проектов: досье, дайджест в контексте, инструмент `project_memory`, автожурнал, `/remember`. |
 | `dsh-session-move` | Drag & drop чатов между рабочими областями и пункт меню «Переместить в рабочую область…». |
-| `dsh-profile-transfer` | Настройки → «Перенос и резервные копии»: экспорт и импорт профиля, плагинов, навыков, памяти, сессий. |
-| `skills/` | 24 навыка: `wow-design`, `seo`, `content-writing`, `php-laravel`-правила, `database-safety`, `testing-strategy`, `debugging-playbook`, `release-and-deploy`, `service-desk-*` и другие. |
+| `dsh-profile-transfer` | Настройки → «Перенос и резервные копии»: экспорт и импорт профиля, плагинов, навыков, памяти и сессий. |
+| `skills/` | 25 навыков: `wow-design`, `design-critique`, `seo`, `content-writing`, `context-economy`, `database-safety`, `testing-strategy`, `debugging-playbook`, `service-desk-*` и другие. |
 
-## Установка через интерфейс «Плагины» (рекомендуется)
+## Как работает автопилот
 
-В DSH откройте **Плагины → Add plugin** и вставьте одно из значений.
+Плагин не заставляет модель грузить всё подряд. Он добавляет короткий контекст только тогда, когда запрос совпал с правилами:
 
-**Вариант А — имя пакета из npm** (после публикации; реестр — Official npm):
-
-```
-dsh-desktop-kit
+```xml
+<skill-autopilot>
+Запрос похож на: UI/дизайн + SEO.
+Загрузи через tool skill только эти ядра: wow-design ≈1.7k токенов, seo ≈2k токенов.
+Это ядра навыков: references внутри них грузи только при реальной необходимости.
+Другие навыки сейчас не нужны — не загружай их «на всякий случай».
+</skill-autopilot>
 ```
 
-**Вариант Б — локальная папка.** Склонируйте репозиторий и укажите путь к его корню:
+- 16 семейств задач: UI, SEO, контент, факты, планирование, отладка, БД, безопасность, тесты, релиз, git, память, ревью, Service Desk, токены, навыки.
+- Имена фильтруются по реально установленным навыкам — правило не может отправить модель за отсутствующим файлом.
+- Режим и лимит: `~/.dsh/dsh-autopilot.json` (`mode: on/off`, `maxSkills: 1–5`).
+- Статус и последнее совпадение доступны в Skills Studio и по RPC `dsh-skill-autopilot/state`.
+
+## Установка
+
+### Через интерфейс «Плагины» (рекомендуется)
+
+В DSH: **Плагины → Add plugin** → вставьте `dsh-desktop-kit` → перезапустите окно (`Ctrl+R`).
+
+### Локальная папка
 
 ```powershell
 git clone <URL-репозитория> "$env:USERPROFILE\dsh-desktop-kit"
 ```
 
-В диалоге: `C:\Users\<вы>\dsh-desktop-kit`
+В диалоге «Add plugin» укажите `C:\Users\<вы>\dsh-desktop-kit`.
 
-**Вариант В — адрес GitHub.** Если репозиторий опубликован, вставьте его URL:
+### Скриптом
 
-```
-https://github.com/<логин>/dsh-desktop-kit
+```powershell
+powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\dsh-desktop-kit\install.ps1"
 ```
 
-После установки DSH сам подключит пакет как bundle. Перезапустите DSH (или нажмите `Ctrl+R` в окне), чтобы клиентская часть и навыки применились.
+Проверка — `doctor.ps1`, удаление — `uninstall.ps1`.
 
-> Навыки копируются автоматически при первом запуске: плагин добавляет в `~/.dsh/skills` только те навыки, которых там ещё нет, и никогда не перезаписывает отредактированные.
+> Навыки копируются автоматически при первом запуске: плагин добавляет в `~/.dsh/skills` только отсутствующие и никогда не перезаписывает отредактированные.
 
-### Установка отдельных плагинов
-
-Если нужен не весь набор, а один плагин, добавьте его папку из `plugins/`:
+### Отдельные плагины
 
 | Плагин | Путь для «Add plugin» |
 |---|---|
-| Русский UI, баланс и расход | `...\dsh-desktop-kit\plugins\dsh-gkb-ru-ui` |
-| Предупреждение о пиковом тарифе | `...\dsh-desktop-kit\plugins\dsh-peak-guard` |
+| Русский UI, Skills Studio | `...\dsh-desktop-kit\plugins\dsh-gkb-ru-ui` |
+| Автопилот навыков | `...\dsh-desktop-kit\plugins\dsh-skill-autopilot` |
+| Токен-лаборатория | `...\dsh-desktop-kit\plugins\dsh-token-lab` |
+| Пиковый тариф | `...\dsh-desktop-kit\plugins\dsh-peak-guard` |
 | Память проектов | `...\dsh-desktop-kit\plugins\dsh-project-memory` |
 | Перенос чатов | `...\dsh-desktop-kit\plugins\dsh-session-move` |
-| Перенос и бэкапы профиля | `...\dsh-desktop-kit\plugins\dsh-profile-transfer` |
-
-## Установка скриптом (для терминала)
-
-```powershell
-git clone <URL-репозитория> "$env:USERPROFILE\dsh-desktop-kit"
-powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\dsh-desktop-kit\install.ps1"
-```
-
-Скрипт находит DSH, ставит пакет в профиль `desktop`, включает bundle и копирует навыки. Проверка состояния — `doctor.ps1`, удаление — `uninstall.ps1`.
+| Перенос и бэкапы | `...\dsh-desktop-kit\plugins\dsh-profile-transfer` |
 
 ## Совместимость
 
-- DSH `0.2.1-rc.5` — исходная версия набора.
-- DSH `0.2.2-rc.1` — проверено: хост-часть и клиентские плагины загружаются, ошибок в консоли нет. В 0.2.2 русская локаль уже встроена, поэтому пакет не перезаписывает её (иначе ломается штатный интерфейс).
-- Пакет **не тянет** версии `@deepseek-ai/*`. Именно закреплённые experimental-бандлы `0.2.1-rc.5` в старом профиле давали «плагины несовместимы» после обновления клиента — здесь их нет.
+- DSH `0.2.1-rc.5` — проверено вживую: хост-часть, клиентские плагины, Skills Studio, Token Lab, автопилот.
+- DSH `0.2.2` — API совместим, но набор ещё не прогонялся на этой сборке; в 0.2.2 русская локаль встроена, поэтому пакет её не перезаписывает.
+- Пакет **не тянет** версии `@deepseek-ai/*`: обновление клиента не ломает плагины.
 
-Подробности: [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md).
+Подробности — [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md).
 
 ## Без личных данных
 
-В репозитории нет: `~/.dsh/.credentials.yaml`, сессий, вложений, памяти проектов, `AGENTS.md`, скриншотов с личными путями. Пути, имена и домены в навыках обезличены (`%USERPROFILE%`, `example.org`, `организация`). Подробности: [docs/PRIVACY.md](docs/PRIVACY.md).
+В репозитории нет `~/.dsh/.credentials.yaml`, сессий, вложений, памяти проектов и `AGENTS.md`. Пути и домены в навыках обезличены. Автопилот пишет только свой режим в `~/.dsh/dsh-autopilot.json`; Studio хранит резервные копии навыков локально в `~/.dsh/skills/.dsh-kit-backups`. Ничего не уходит в сеть.
+
+Подробности — [docs/PRIVACY.md](docs/PRIVACY.md).
 
 ## Документация
 
+- [docs/TOKENS.md](docs/TOKENS.md) — экономика токенов, бюджеты, как измерять.
+- [docs/ROADMAP.md](docs/ROADMAP.md) — развитие плагинов и навыков.
 - [docs/INSTALL.md](docs/INSTALL.md) — все способы установки и проверка.
 - [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — как устроен пакет и слияние плагинов.
 - [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md) — версии DSH и что менялось.