dsh-desktop-kit 0.0.0-stage → 1.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,88 @@
-# Temporary Holding Version
+# DSH Desktop Kit
 
-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.
+Набор плагинов и навыков для **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)
+
+## Что внутри
+
+| Компонент | Что делает |
+|---|---|
+| `dsh-gkb-ru-ui` | Русский интерфейс, плитки «Навыки», «Баланс», «Расход» в сайдбаре, каталог навыков со статистикой использования. Баланс и расход токенов опрашиваются через аккаунт DeepSeek и обновляются в реальном времени. |
+| `dsh-peak-guard` | Красная карточка в чате, когда действует пиковый тариф ×2: причина, окно в местном времени и UTC, живой отсчёт, совет когда вернуться. За 5 минут до пика — жёлтое предупреждение. |
+| `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 откройте **Плагины → Add plugin** и вставьте одно из значений.
+
+**Вариант А — имя пакета из npm** (после публикации; реестр — Official npm):
+
+```
+dsh-desktop-kit
+```
+
+**Вариант Б — локальная папка.** Склонируйте репозиторий и укажите путь к его корню:
+
+```powershell
+git clone <URL-репозитория> "$env:USERPROFILE\dsh-desktop-kit"
+```
+
+В диалоге: `C:\Users\<вы>\dsh-desktop-kit`
+
+**Вариант В — адрес GitHub.** Если репозиторий опубликован, вставьте его URL:
+
+```
+https://github.com/<логин>/dsh-desktop-kit
+```
+
+После установки DSH сам подключит пакет как bundle. Перезапустите DSH (или нажмите `Ctrl+R` в окне), чтобы клиентская часть и навыки применились.
+
+> Навыки копируются автоматически при первом запуске: плагин добавляет в `~/.dsh/skills` только те навыки, которых там ещё нет, и никогда не перезаписывает отредактированные.
+
+### Установка отдельных плагинов
+
+Если нужен не весь набор, а один плагин, добавьте его папку из `plugins/`:
+
+| Плагин | Путь для «Add plugin» |
+|---|---|
+| Русский UI, баланс и расход | `...\dsh-desktop-kit\plugins\dsh-gkb-ru-ui` |
+| Предупреждение о пиковом тарифе | `...\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 `0.2.1-rc.5` — исходная версия набора.
+- DSH `0.2.2-rc.1` — проверено: хост-часть и клиентские плагины загружаются, ошибок в консоли нет. В 0.2.2 русская локаль уже встроена, поэтому пакет не перезаписывает её (иначе ломается штатный интерфейс).
+- Пакет **не тянет** версии `@deepseek-ai/*`. Именно закреплённые experimental-бандлы `0.2.1-rc.5` в старом профиле давали «плагины несовместимы» после обновления клиента — здесь их нет.
+
+Подробности: [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md).
+
+## Без личных данных
+
+В репозитории нет: `~/.dsh/.credentials.yaml`, сессий, вложений, памяти проектов, `AGENTS.md`, скриншотов с личными путями. Пути, имена и домены в навыках обезличены (`%USERPROFILE%`, `example.org`, `организация`). Подробности: [docs/PRIVACY.md](docs/PRIVACY.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).