dsh-desktop-kit 0.0.0-stage → 2.0.0

package/plugins/dsh-peak-guard/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Host half of the "peak-price guard" plugin.
+# The browser half is loaded from this package's dsh.client entry.
+- insert:
+    - id: peak-guard
+      name: dsh-peak-guard

package/plugins/dsh-peak-guard/icon.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Peak price guard">
+  <defs>
+    <linearGradient id="pg-a" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#e5484d"/>
+      <stop offset="1" stop-color="#8f1d22"/>
+    </linearGradient>
+  </defs>
+  <rect x="2" y="2" width="60" height="60" rx="14" fill="url(#pg-a)"/>
+  <circle cx="32" cy="32" r="17" fill="none" stroke="#ffffff" stroke-width="3.4" opacity=".95"/>
+  <path d="M32 22v11l7 4" fill="none" stroke="#ffffff" stroke-width="3.4" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="32" cy="32" r="1.6" fill="#ffffff"/>
+</svg>

package/plugins/dsh-peak-guard/index.js

@@ -0,0 +1,2 @@
+// Host half: this bundle is client-only; the notice runs entirely in the Web client.
+export function apply() {}

package/plugins/dsh-peak-guard/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Peak-price guard",
+    "description": "Shows a red notice while DeepSeek peak hours double the token price: the reason, the current window in your local time, a live countdown and a recommendation when to come back."
+  }
+}

package/plugins/dsh-peak-guard/locale/ru.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Страж пикового тарифа",
+    "description": "Красное уведомление в чате, пока действует пиковый тариф DeepSeek: причина, окно по вашему времени, живой обратный отсчёт и рекомендация, когда вернуться."
+  }
+}

package/plugins/dsh-peak-guard/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "高峰价格提醒",
+    "description": "在 DeepSeek 高峰时段（Token 价格上涨 2 倍）显示红色提醒：原因、本地时间窗口、实时倒计时以及建议何时返回。"
+  }
+}

package/plugins/dsh-peak-guard/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "dsh-peak-guard",
+  "version": "1.2.0",
+  "private": true,
+  "description": "Red peak-pricing notice in the chat: when DeepSeek peak hours double the token price, a card explains the reason, the window in your local time, and how long to wait before continuing.",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": []
+    }
+  }
+}

package/plugins/dsh-peak-guard/screenshots/qa-report.json

@@ -0,0 +1,74 @@
+{
+ "prePeak": {
+  "before": {
+   "fakeNow": "2026-11-04T05:54:59.118Z",
+   "mode": "off",
+   "cards": 0
+  },
+  "appeared": true,
+  "delayMs": 240,
+  "mode": "soon"
+ },
+ "peakStart": {
+  "before": {
+   "fakeNow": "2026-11-04T05:59:59.091Z",
+   "mode": "soon",
+   "cards": 1
+  },
+  "switched": true,
+  "delayMs": 217,
+  "mode": "peak"
+ },
+ "peakEnd": {
+  "before": {
+   "fakeNow": "2026-11-04T09:59:59.097Z",
+   "mode": "peak",
+   "cards": 1
+  },
+  "gone": true,
+  "delayMs": 240
+ },
+ "peakVisual": {
+  "mode": "peak",
+  "text": "×\nПИКОВЫЙ ТАРИФ\n×2\nТокены сейчас стоят вдвое дороже\nВ пиковые часы стоимость всех типов токенов для deepseek-flash и deepseek-v4-pro увеличивается вдвое. Вне этих часов действует скидка 50% (off-peak).\n26\nмин\nДО КОНЦА ПИ"
+ },
+ "peakAxe": {
+  "violations": []
+ },
+ "tablet": {
+  "scrollWidth": 768,
+  "clientWidth": 768,
+  "cardWidth": 310.828125
+ },
+ "mobile": {
+  "scrollWidth": 390,
+  "clientWidth": 390,
+  "cardWidth": 370
+ },
+ "dismissed": {
+  "cards": 0,
+  "stored": "1793786400000"
+ },
+ "soonVisual": {
+  "mode": "soon",
+  "text": "×\nСКОРО ПИК\n×2\nПиковый тариф начнётся через 4 мин\nСейчас ещё действует off-peak со скидкой 50%. Когда начнётся окно, все типы токенов будут стоить ×2 до самого конца пика.\n4\nмин\nДО НАЧАЛА ПИКА\nОкно 09:00–13:00 МСК\nСейчас 08:56\n→\nДО ПОДОРОЖА",
+  "badge": "Пик через 4 мин"
+ },
+ "soonMobile": {
+  "scrollWidth": 390,
+  "clientWidth": 390,
+  "cardWidth": 370
+ },
+ "offPeak": {
+  "mode": "off",
+  "cards": 0,
+  "badges": 0
+ },
+ "logs": [
+  "[info] [session-move] ready",
+  "[info] [profile-transfer] ready",
+  "[info] [peak-guard] ready",
+  "[error] [deepseek-account] account read failed {field: profile}",
+  "[error] [deepseek-account] account read failed {field: balance}"
+ ]
+}

package/plugins/dsh-profile-transfer/README.md

@@ -0,0 +1,62 @@
+# dsh-profile-transfer — перенос и резервные копии
+
+Плагин для DeepSeek Harness: страница **Настройки → «Перенос и резервные копии»**,
+в которой можно галочками выбрать части рабочего окружения, собрать один архив
+`.tar.gz`, а на другой машине — проверить и развернуть его с автоматическим бэкапом.
+
+## Что можно переносить
+
+| Группа | Что внутри |
+|---|---|
+| Профиль и конфиги | `package.json`, `cordis.patch.yml`, `cordis.yml`, `pnpm-lock.yaml`, `.npmrc` (без `node_modules`) |
+| Рабочие области | реестр `storages/workspace.json`: названия, папки, группировка чатов, архив/закрепления |
+| Папки рабочих областей | опционально (по умолчанию выкл.): код и артефакты папок рабочих областей без `node_modules`, `.git`, `pgruntime`, `tmp`, кэшей; лимит 1 ГБ |
+| Локальные плагины | исходники плагинов, установленных из папок (`link:`/`file:` в зависимостях профиля) |
+| Навыки | `~/.dsh/skills` (без `node_modules`) |
+| Память | `~/.dsh/memory` |
+| Память проектов | `~/.dsh/projects-memory` (без `_access.log`/`_state.json`) |
+| Глобальные конфиги | `AGENTS.md`, `dream-skin.json` |
+| История сессий | `~/.dsh/sessions` (опционально, может быть большой) |
+| Вложения | `~/.dsh/attachments` (опционально) |
+| Секреты | `.credentials.yaml` (по умолчанию выключено; только доверенная машина) |
+
+## Как это работает
+
+- **Экспорт.** Host-плагин собирает выбранные файлы в `payload/…` и кладёт рядом
+  `manifest.json` (формат, версия, дата, машина, профиль, состав, перечень файлов
+  с размерами). Архив по умолчанию: `<Документы>\DSH-обмены\dsh-profile-<дата>.tar.gz`.
+- **Рабочие области.** В архив попадает реестр рабочих областей: названия, папки, группировка чатов, закреплённые и архивные чаты. При импорте он **сливается** с локальным реестром, пути переписываются со старого домашнего каталога на новый, а ссылки на отсутствующие на новой машине сессии отфильтровываются. После импорта нужен перезапуск DSH, чтобы реестр перечитался.
+- **Папки рабочих областей (опция).** Если включить, в архив добавляются файлы папок рабочих областей (`payload/workspace-folders/<id>/...`). Импорт **никогда не перезаписывает** существующие каталоги: если путь уже существует и не пуст, папка разворачивается рядом с суффиксом `-dsh-restored-<дата>`, путь сообщается в отчёте. Исключаются `node_modules`, `.git`, `pgruntime`, `tmp`, виртуальные окружения и кэши; лимит — 1 ГБ / 250 000 файлов (иначе экспорт откажется и попросит скопировать папки вручную).
+- **Импорт.** Архив проверяется (манифест/формат), затем текущее состояние
+  резервируется в `~/.dsh/backup-import-<дата>/`, файлы разворачиваются, `link:`
+  зависимости профиля переписываются на `~/.dsh/local-plugins/<пакет>`,
+  а затем автоматически выполняется `pnpm install` (можно отложить отдельной кнопкой).
+- **Чистая машина.** После установки DSH достаточно открыть Настройки → «Перенос»,
+  указать архив и нажать «Проверить» → «Развернуть»; профиль `desktop`, навыки,
+  память, плагины и (по желанию) сессии/секреты встанут на место. После импорта
+  нужен перезапуск DSH.
+
+## Безопасность
+
+- Перед разворачиванием всегда создаётся бэкап текущего профиля/навыков/памяти.
+- Пути внутри архива проверяются: никаких абсолютных путей и `..`.
+- Секреты не включаются, пока не отмечены явно; переносить их следует только на
+  доверенную машину.
+- Установка зависимостей запускается только по кнопке/флагу и пишет лог в ответ.
+
+## Состав
+
+- `transfer.js` — чистый Node-модуль: tar.gz (ustar + gzip), сборка/разбор архива,
+  бэкап, разворачивание, перезапись `link:`-путей. Тестируется на временных домашних
+  папках: `node test/transfer.test.mjs`.
+- `index.js` — Host-плагин: аутентифицированные RPC-маршруты `/api/dsh-profile-transfer/*`
+  (`options`, `export`, `inspect`, `import`, `install`, `reveal`, `diagnose`).
+- `client.js` — браузерная половина со страницей настроек.
+
+## Ограничения
+
+- `node_modules` не переносится — восстанавливается через `pnpm install`.
+- По умолчанию архив содержит только `~/.dsh` (профиль, плагины, навыки, память, реестр рабочих областей, сессии). Содержимое папок проектов переносится **опциональной группой «Папки рабочих областей»** (по умолчанию выключена — может быть много гигабайт, исключены `node_modules`/`pgruntime`/`tmp`).
+- Максимально большой перенос ограничен диском и таймаутом RPC; сессии/вложения
+  включайте осознанно.
+- После импорта обязателен перезапуск DSH.

package/plugins/dsh-profile-transfer/bootstrap/01-INSTALL.cmd

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+rem Root launcher for a clean DSH machine (ASCII name so Windows tar extracts it safely).
+rem The PowerShell script auto-detects the bundled plugin copy in bootstrap-plugin\.
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0install-on-clean-machine.ps1" %*
+echo.
+pause

package/plugins/dsh-profile-transfer/bootstrap/README-ARCHIVE.md

@@ -0,0 +1,54 @@
+# Перенос DSH на новую машину — прочитай меня первым
+
+Этот архив создан плагином **«Перенос и резервные копии»** DeepSeek Harness.
+В нём лежит всё выбранное при экспорте: профиль, локальные плагины, навыки,
+память, конфиги (и опционально сессии/вложения/секреты).
+
+## Установка на чистой машине (только что установленный DSH)
+
+1. Установите **DeepSeek Harness** и запустите его **один раз** (чтобы создался
+   профиль `%USERPROFILE%\.dsh\profiles\desktop`), затем закройте DSH.
+2. Распакуйте этот архив, например в `C:\DSH-Import\unpacked`:
+   ```powershell
+   mkdir C:\DSH-Import\unpacked
+   tar -xzf "путь\к\этому\архиву.tar.gz" -C C:\DSH-Import\unpacked
+   ```
+3. Запустите **`01-INSTALL.cmd`** из корня распакованной папки
+   (двойной щёлчок). Скрипт найдёт DSH, поставит плагин «Перенос и резервные копии»
+   из `bootstrap-plugin\` через встроенный pnpm DSH и включит его в профиле.
+4. Откройте DSH → нажмите **Ctrl+Alt+,** → раздел **«Перенос и резервные копии»**:
+   - укажите путь к **этому архиву** (файл `.tar.gz`, который вы только что распаковали);
+   - **«Проверить архив»** → **«Развернуть архив»**;
+   - дождитесь установки зависимостей.
+5. Полностью перезапустите DSH.
+
+После перезапуска на новой машине будут профиль, локальные плагины, навыки,
+память, конфиги и (если включили) сессии/вложения/секреты.
+
+## Если `01-INSTALL.cmd` не сработал
+
+- `dsh` не найден в PATH — скрипт сам проверяет
+  `%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd`.
+  Если DSH установлен в другое место, запустите в PowerShell:
+  ```powershell
+  powershell -ExecutionPolicy Bypass -File .\install-on-clean-machine.ps1 -DshHome "C:\Users\<user>\.dsh" -Profile desktop
+  ```
+- Либо откройте чат в DSH и попросите агента: «Установи плагин из папки
+  `<распакованная папка>\bootstrap-plugin\dsh-profile-transfer` через
+  `plugin_manager install_bundle`», затем Ctrl+R и продолжайте с шага 4.
+
+## Что внутри
+
+| Путь | Что это |
+|---|---|
+| `01-INSTALL.cmd`, `install-on-clean-machine.ps1` | bootstrap: ставит плагин переноса на чистую машину |
+| `bootstrap-plugin\dsh-profile-transfer\` | исходник плагина для bootstrap |
+| `manifest.json` | манифест: дата, машина, состав, размеры |
+| `payload\profiles\<profile>\` | файлы профиля DSH |
+| `payload\local-plugins\` | исходники локальных плагинов |
+| `payload\workspaces\` | реестр рабочих областей и группировка чатов |
+| `payload\workspace-folders\` | файлы папок рабочих областей (если включены при экспорте) |
+| `payload\skills\`, `payload\memory\`, `payload\projects-memory\` | навыки и память |
+| `payload\sessions\`, `payload\attachments\` | история и вложения (если включены) |
+
+Состав конкретного архива смотрите в `manifest.json` (`selection`, `totals`).

package/plugins/dsh-profile-transfer/bootstrap/README-/320/243/320/241/320/242/320/220/320/235/320/236/320/222/320/232/320/220.md

@@ -0,0 +1,42 @@
+# Установка на чистую машину (только DeepSeek Harness)
+
+Эта папка нужна один раз — чтобы на новой машине появился раздел
+**Настройки → «Перенос и резервные копии»**, через который затем разворачивается
+экспортированный архив.
+
+## Что нужно иметь
+
+1. DeepSeek Harness, установленный и **один раз запущенный** (чтобы появилась папка
+   `%USERPROFILE%\.dsh\profiles\desktop`). Перед установкой плагина DSH лучше закрыть.
+2. Архив `dsh-profile-<дата>.tar.gz`, созданный на старой машине через
+   Настройки → «Перенос и резервные копии».
+
+## Шаги
+
+1. Скопируйте на новую машину:
+   - этот файл/папку `dsh-profile-transfer` (можно прямо из архива: распакуйте его и
+     возьмите `payload\local-plugins\dsh-profile-transfer`);
+   - архив `dsh-profile-<дата>.tar.gz`.
+2. Дважды щёлкните **`УСТАНОВИТЬ.cmd`** (или в PowerShell:
+   `powershell -ExecutionPolicy Bypass -File .\install-on-clean-machine.ps1`).
+   Скрипт поставит плагин через собственный pnpm DSH и включит его bundle.
+3. Откройте DSH → **Ctrl+Alt+,** → «Перенос и резервные копии».
+4. Укажите путь к архиву → **«Проверить архив»** → подтвердите → **«Развернуть архив»**.
+5. Перезапустите DSH. Готово.
+
+## Если `dsh` не находится в PATH
+
+Скрипт сам попробует
+`%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd`.
+Если DSH установлен в другое место — запустите скрипт с параметром:
+
+```powershell
+.\install-on-clean-machine.ps1 -DshHome "C:\Users\<user>\.dsh" -Profile desktop
+```
+
+## Альтернатива без скрипта
+
+Откройте чат в DSH на новой машине и попросите агента:
+«Установи плагин из папки `<полный путь к dsh-profile-transfer>` через
+`plugin_manager install_bundle`». После этого обновите страницу (Ctrl+R) и
+продолжайте с шага 3.

package/plugins/dsh-profile-transfer/bootstrap/install-on-clean-machine.ps1

@@ -0,0 +1,119 @@
+#requires -Version 5.1
+<#
+.SYNOPSIS
+  Bootstrap the dsh-profile-transfer plugin on a clean DSH machine.
+
+.DESCRIPTION
+  1. finds the dsh CLI (PATH or the default Desktop installation);
+  2. installs this plugin folder into the chosen profile through DSH's own
+     bundled pnpm (`dsh plugin --profile <name> add <path>`);
+  3. adds the bundle to the profile's dsh.profile.bundles selection, because the
+     `dsh plugin` CLI only installs the package (bundle selection normally
+     belongs to the Plugin Manager UI);
+  4. prints the next steps: open DSH -> Settings -> Transfer and restore the
+     exported archive.
+
+.PARAMETER Profile
+  DSH profile name, default "desktop".
+
+.PARAMETER PluginPath
+  Plugin source folder; by default the parent of this script's folder.
+
+.PARAMETER DshHome
+  DSH home directory; default $env:DSH_HOME or %USERPROFILE%\.dsh.
+#>
+param(
+  [string]$Profile = "desktop",
+  [string]$PluginPath = "",
+  [string]$DshHome = ""
+)
+
+$ErrorActionPreference = "Stop"
+
+function Write-Step([string]$Text) {
+  Write-Host ""
+  Write-Host "==> $Text" -ForegroundColor Cyan
+}
+
+if ([string]::IsNullOrWhiteSpace($PluginPath)) {
+  # The same script lives in two layouts:
+  #   <archive root>\install-on-clean-machine.ps1      -> bootstrap-plugin\dsh-profile-transfer
+  #   <archive root>\payload\local-plugins\...\bootstrap -> parent of this folder
+  $candidates = @(
+    (Join-Path $PSScriptRoot "bootstrap-plugin\dsh-profile-transfer"),
+    (Join-Path $PSScriptRoot "payload\local-plugins\dsh-profile-transfer"),
+    (Split-Path -Parent $PSScriptRoot)
+  )
+  foreach ($candidate in $candidates) {
+    if (Test-Path (Join-Path $candidate "package.json")) {
+      $PluginPath = $candidate
+      break
+    }
+  }
+  if ([string]::IsNullOrWhiteSpace($PluginPath)) {
+    throw "Plugin package.json not found next to this script. Expected bootstrap-plugin\dsh-profile-transfer or payload\local-plugins\dsh-profile-transfer."
+  }
+}
+if (-not (Test-Path (Join-Path $PluginPath "package.json"))) {
+  throw "Plugin package.json not found: $PluginPath"
+}
+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-Step "Checking DSH environment"
+$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 (-not $dsh) {
+  throw "dsh CLI not found. Install DeepSeek Harness, run it once, then retry."
+}
+Write-Host "dsh: $dsh"
+Write-Host "DSH_HOME: $DshHome"
+Write-Host "Profile: $Profile"
+Write-Host "Plugin: $PluginPath"
+
+if (-not (Test-Path $profileJson)) {
+  throw "Profile '$Profile' does not exist yet ($profileDir). Run DSH once, close it, then retry."
+}
+
+Write-Step "Backing up the profile package.json"
+$stamp = Get-Date -Format "yyyyMMdd-HHmmss"
+$backup = $profileJson + ".bak-transfer-bootstrap-" + $stamp
+Write-Host "Copying $profileJson -> $backup"
+[System.IO.File]::Copy($profileJson, $backup, $true)
+Write-Host "Backup: $backup"
+
+Write-Step "Installing the plugin package through DSH pnpm (dsh plugin add)"
+& $dsh plugin --profile $Profile add $PluginPath
+if ($LASTEXITCODE -ne 0) {
+  throw "dsh plugin add exited with code $LASTEXITCODE. See the output above."
+}
+
+Write-Step "Selecting the bundle in the profile manifest"
+$json = Get-Content -Path $profileJson -Raw | ConvertFrom-Json
+if ($null -eq $json.dsh) { $json | Add-Member -NotePropertyName dsh -NotePropertyValue ([pscustomobject]@{}) }
+if ($null -eq $json.dsh.profile) { $json.dsh | Add-Member -NotePropertyName profile -NotePropertyValue ([pscustomobject]@{}) }
+$bundles = @()
+if ($json.dsh.profile.bundles) { $bundles = @($json.dsh.profile.bundles) }
+if ($bundles -notcontains "dsh-profile-transfer") {
+  $bundles += "dsh-profile-transfer"
+}
+$json.dsh.profile | Add-Member -NotePropertyName bundles -NotePropertyValue $bundles -Force
+$jsonText = $json | ConvertTo-Json -Depth 20
+[System.IO.File]::WriteAllText($profileJson, $jsonText, (New-Object System.Text.UTF8Encoding($false)))
+Write-Host "bundles: $($bundles -join ', ')"
+
+Write-Step "Done"
+Write-Host "1. Open DeepSeek Harness (restart it if it was running)." -ForegroundColor Green
+Write-Host "2. Settings: Ctrl+Alt+, (or account menu -> Settings)." -ForegroundColor Green
+Write-Host "3. Section 'Transfer and backups' -> archive path -> 'Check archive' -> 'Restore archive'." -ForegroundColor Green
+Write-Host "4. Restart DSH after the import." -ForegroundColor Green
+Write-Host ""
+Write-Host "Rollback of this step only: restore package.json from $backup and remove the package from the profile node_modules." -ForegroundColor DarkGray

package/plugins/dsh-profile-transfer/bootstrap//320/243/320/241/320/242/320/220/320/235/320/236/320/222/320/230/320/242/320/254.cmd

@@ -0,0 +1,5 @@
+@echo off
+setlocal
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0install-on-clean-machine.ps1" %*
+echo.
+pause