dsh-desktop-kit 0.0.0-stage → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH Desktop Kit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,153 @@
-# Temporary Holding Version
+# DSH Desktop Kit 2.0
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Навыки, которые применяются сами. Контекст, который видно. Интерфейс, который не мешает.**
+
+Набор из **7 плагинов и 25 навыков** для DeepSeek Harness 0.2.x: русский интерфейс, автопилот навыков, токен-лаборатория, студия навыков, память проектов, перенос чатов и резервные копии профиля.
+
+![DSH Desktop Kit 2.0](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.0/docs/images/hero.png)
+
+**v2.0.0** · 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.0/plugins/dsh-gkb-ru-ui/screenshots/02-skills-1440-light.png)
+
+![Редактор навыка](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.0/plugins/dsh-gkb-ru-ui/screenshots/03-skills-editor-1440-light.png)
+
+### Token Lab: куда уходит контекст
+
+![Токен-лаборатория](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.0/plugins/dsh-token-lab/screenshots/01-token-lab-1440-light.png)
+
+### Тёмная тема и мобильный
+
+![Тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.0/plugins/dsh-gkb-ru-ui/screenshots/04-skills-1440-dark.png)
+
+<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.0.0/plugins/dsh-gkb-ru-ui/screenshots/05-skills-390-light.png" alt="Каталог навыков на 390 px" width="390">
+
+## Что внутри
+
+| Компонент | Что делает |
+|---|---|
+| `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/` | 25 навыков: `wow-design`, `design-critique`, `seo`, `content-writing`, `context-economy`, `database-safety`, `testing-strategy`, `debugging-playbook`, `service-desk-*` и другие. |
+
+## Как работает автопилот
+
+Плагин не заставляет модель грузить всё подряд. Он добавляет короткий контекст только тогда, когда запрос совпал с правилами:
+
+```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"
+```
+
+В диалоге «Add plugin» укажите `C:\Users\<вы>\dsh-desktop-kit`.
+
+### Скриптом
+
+```powershell
+powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\dsh-desktop-kit\install.ps1"
+```
+
+Проверка — `doctor.ps1`, удаление — `uninstall.ps1`.
+
+> Навыки копируются автоматически при первом запуске: плагин добавляет в `~/.dsh/skills` только отсутствующие и никогда не перезаписывает отредактированные.
+
+### Отдельные плагины
+
+| Плагин | Путь для «Add plugin» |
+|---|---|
+| Русский 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` |
+
+## Совместимость
+
+- 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).
+
+## Без личных данных
+
+В репозитории нет `~/.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 и что менялось.
+- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — «плагины несовместимы», пустые плитки, навыки не появились.
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE).