dsh-desktop-kit 2.0.0 → 2.1.0

package/README.md

@@ -1,17 +1,18 @@
-# DSH Desktop Kit 2.0
+# DSH Desktop Kit 2.1
 
 **Навыки, которые применяются сами. Контекст, который видно. Интерфейс, который не мешает.**
 
 Набор из **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)
+![DSH Desktop Kit 2.1](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.0/docs/images/hero.png)
 
-**v2.0.0** · MIT · проверено на DSH `0.2.1-rc.5` (Windows 11) · без внешних зависимостей и телеметрии
+**v2.1.0** · MIT · проверено на DSH `0.2.1-rc.5` (Windows 11) · без внешних зависимостей и телеметрии
 
 ---
 
-## Что нового в 2.0
+## Что нового
 
+- **Память проектов 2.1.** Проект распознаётся сам по рабочей папке, локальный автоскан (без LLM и сети) сразу даёт стек, команды, точки входа и тесты; дайджест сам подмешивает фрагменты досье, похожие на текущий запрос. Секреты и PII вычищаются до записи, файлы приватные (`0700/0600`). Новые действия `brief`/`scan` и команда `/memory`.
 - **Навыки стали в 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`** — живая лаборатория контекста: состав, топ потребителей, рост и экономия библиотеки навыков.
@@ -40,23 +41,51 @@
 
 Подробный разбор и методика замера — [docs/TOKENS.md](docs/TOKENS.md).
 
+## Память проектов
+
+`dsh-project-memory` работает без ручной настройки:
+
+- **Распознаёт проект** по рабочей папке (`.git`, `composer.json`, `package.json`, `artisan`, `wp-config.php`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `bitrix`, compose) и склеивает его после переноса по git-remote.
+- **Сканирует локально** (без LLM и сети): стек, фреймворки, БД, команды запуска/тестов/сборки, точки входа, каталоги, тесты, CI, docker-сервисы, имена переменных из `.env.example`. Лимиты: 1500 файлов, глубина 3, 96 КБ на файл.
+- **Подмешивает дайджест** ≤ 2800 символов: стек и команды, инварианты, грабли, свежесть, последний журнал и строки досье, похожие на текущий запрос (auto-recall).
+- **Даёт `brief` и `scan`**: карточка проекта на один экран или обновление локального скана; `/memory brief|scan|on|off|projects`.
+- **Безопасно хранит**: `.env`, ключи и дампы не читаются; токены, пароли, URL с логином, e-mail и телефоны вычищаются; каталог и файлы — `0700/0600` (best-effort на Windows).
+
+Подробности — [plugins/dsh-project-memory/README.md](plugins/dsh-project-memory/README.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.1.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)
+![Редактор навыка](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.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.1.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)
+![Тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.0/plugins/dsh-gkb-ru-ui/screenshots/04-skills-1440-dark.png)
+
+<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.0/plugins/dsh-gkb-ru-ui/screenshots/05-skills-390-light.png" alt="Каталог навыков на 390 px" width="390">
+
+## Окно-напоминание: пиковый тариф
+
+DeepSeek включает двойной тариф в пиковые часы (04:00–07:00 и 09:00–13:00 МСК). Плагин `dsh-peak-guard` показывает это прямо в чате, а не в документации:
+
+- **за 5 минут до окна** — жёлтая карточка «скоро ×2» с обратным отсчётом;
+- **в окне** — красная карточка: причина, границы окна в местном времени и UTC, живой отсчёт до конца и рекомендация, когда вернуться;
+- **после окна** — карточка исчезает; состояние всегда доступно через `window.__DSH_PEAK_GUARD__.state()`.
+
+![Окно-напоминание: светлая тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.0/plugins/dsh-peak-guard/screenshots/03-peak-card-1440-light.png)
+
+![Окно-напоминание: тёмная тема](https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.0/plugins/dsh-peak-guard/screenshots/04-peak-card-1440-dark.png)
+
+<img src="https://cdn.jsdelivr.net/npm/dsh-desktop-kit@2.1.0/plugins/dsh-peak-guard/screenshots/05-peak-card-390-light.png" alt="Окно-напоминание на 390 px" width="390">
 
-<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">
+Подробности и настройки — [plugins/dsh-peak-guard/README.md](plugins/dsh-peak-guard/README.md).
 
 ## Что внутри
 
@@ -66,7 +95,7 @@
 | `dsh-skill-autopilot` | Читает последнее сообщение и добавляет в промпт точный маршрут навыков. Нет совпадения — нет накладных расходов. |
 | `dsh-token-lab` | Живой замер контекста: состав по типам, топ-6 узлов, рост, давление на окно, цена библиотеки навыков. |
 | `dsh-peak-guard` | Красная карточка в чате, когда действует пиковый тариф ×2: причина, окно, живой отсчёт и совет, когда вернуться. |
-| `dsh-project-memory` | Локальная память проектов: досье, дайджест в контексте, инструмент `project_memory`, автожурнал, `/remember`. |
+| `dsh-project-memory` | Локальная память проектов: авто-распознавание, локальный автоскан, дайджест с recall, `brief`/`scan`, автожурнал, `/remember` и `/memory`. |
 | `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-*` и другие. |

package/docs/ARCHITECTURE.md

@@ -56,6 +56,15 @@ RPC `/api/dsh-skill-autopilot/state|set|route` отдаёт состояние,
 
 Подписи tool-результатов берутся из `tool/call` (`callId → name + hint`), поэтому в панели видно `Результат · read · src/app.ts`, а не сырой JSON. Клиент — плитка в общем стеке сайдбара и оверлей-панель.
 
+## Память проектов
+
+`dsh-project-memory` — два слоя:
+
+1. **Хост-плагин** (`index.js`): определяет проект по `workingDirectory` (вверх до маркера, с guard от home/drive), регистрирует и склеивает по git-remote, ведёт `registry.json`, досье и журнал, отдаёт `systemPrompt.context` с дайджестом и инструмент `project_memory` (`status/brief/read/search/scan/append_journal/update_section/register`), команды `/remember` и `/memory`.
+2. **Сканер** (`scan.js`): чистые функции `detectProject`, `scanProject`, `redactText`, `renderAutoSections`, `mergeAutoBlock`, `scanSummary`, `renderBrief`. Читает только allowlist манифестов/README, не открывает `.env`/ключи, ограничен 1500 файлами и глубиной 3.
+
+Дайджест кэшируется по mtime секций, `scan.json`, git-head и хэшу последнего сообщения; auto-recall ищет до трёх релевантных строк досье по ключевым словам запроса. Блоки `AUTO-SCAN` обновляются заменой между маркерами, поэтому ручной текст секций не теряется. Записи проходят `redactText`; на POSIX каталог и файлы получают `0700/0600`.
+
 ## Skills Studio
 
 Хост-часть `dsh-gkb-ru-ui`:

package/docs/COMPATIBILITY.md

@@ -4,11 +4,11 @@
 
 | 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.1-rc.5` | работает | **2.1 проверена вживую**: память проектов (авто-распознавание, автоскан, `brief`/`scan`, `/memory`, redaction), Skills Studio, Token Lab, автопилот, 25 навыков |
+| `0.2.2-rc.1` | работает (1.x) | хост-часть монтируется, клиентский бандл грузится, ошибок в консоли нет, навыки копируются; 2.x на этой сборке ещё не прогонялась |
 | новее `0.2.2` | не проверено | API плагинов в 0.2.x ещё меняется; см. «Если сломалось» |
 
-## Что использует 2.0
+## Что использует 2.x
 
 | Возможность DSH | Где используется | Проверено |
 |---|---|---|
@@ -18,6 +18,10 @@
 | `ctx.systemPrompt.context()` + `assemblyContext.agent.session` | автопилот навыков | да |
 | `ctx.sessions.get/list` | выбор живой сессии | да |
 | `ctx.skills` / `~/.dsh/skills` | каталог и загрузка навыков | да |
+| `ctx.workingDirectory.get(session)` | корень проекта для памяти | да |
+| `ctx.systemPrompt.context()` (дайджест) | память проектов | да |
+| `ctx.commands.register` | `/remember`, `/memory` | да |
+| `session/event` (`user/message`, `turn/end`) | автожурнал и recall | да |
 | `connection.rpc.call` + `connection.fetch.register` | RPC плагинов | да |
 | `window.__ModuleLoader__.load({id, factory})` | клиентский бандл | да |
 
@@ -52,6 +56,7 @@ DSH 0.2.2 при старте проверяет `engines.dsh` и peer-диап
 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` — все ядра в бюджете.
+9. **2.1:** `node tools/memory-tests.mjs` — распознавание, скан, redaction, дайджест, `brief`/`scan`, авто-блок; живой профиль перезагружен, для проекта `dsh` создан `scan.json` и блоки `AUTO-SCAN`.
 
 ## Если сломалось на новой версии
 

package/docs/INSTALL.md

@@ -3,10 +3,20 @@
 ## Требования
 
 - Windows 10/11.
-- DeepSeek Harness **0.2.1-rc.5** или новее (`0.2.2-rc.1` проверен).
+- DeepSeek Harness **0.2.1-rc.5** или новее (`0.2.2-rc.1` проверен на 1.x).
 - Профиль `desktop` уже создан: запустите DSH один раз и закройте окно.
 
-## Способ 1. Интерфейс «Плагины» (как у обычного пользователя)
+## Способ 0. Пакет из npm (быстрее всего)
+
+В DSH: **Плагины → Add plugin** → вставьте:
+
+```
+dsh-desktop-kit@2.1.0
+```
+
+Либо локально: `npm i dsh-desktop-kit@2.0.0` — но для GUI всё равно нужен Add plugin/bundle.
+
+## Способ 1. Интерфейс «Плагины» (локальная папка)
 
 1. Скопируйте репозиторий себе:
 
@@ -32,7 +42,7 @@
 
 Плагин сам:
 - добавит один bundle `dsh-desktop-kit` в профиль;
-- смонтирует пять плагинов как дочерние;
+- смонтирует семь плагинов как дочерние;
 - скопирует недостающие навыки в `~/.dsh/skills`.
 
 ## Способ 2. Скрипт
@@ -58,11 +68,15 @@ powershell -ExecutionPolicy Bypass -File .\install.ps1
 ## Проверка после установки
 
 1. **Плагины**: в списке появился `dsh-desktop-kit` (или отдельные плагины), переключатель включён.
-2. **Сайдбар**: внизу — плитки «Навыки», «Баланс», «Расход» (нужен вход в аккаунт DeepSeek; на экране входа сайдбар скрыт).
-3. **Пиковый тариф**: если сейчас 04:00–07:00 или 09:00–13:00 МСК — над композером красная карточка; за 5 минут до окна — жёлтая.
-4. **Навыки**: `~/.dsh/skills` содержит 24 папки, в интерфейсе открывается каталог навыков.
-5. **Перенос**: Настройки → «Перенос и резервные копии».
-6. **Перемещение чатов**: правый клик по чату → «Переместить в рабочую область…».
+2. **Сайдбар**: внизу — плитки «Навыки», «Токены», «Баланс», «Расход» (нужен вход в аккаунт DeepSeek; на экране входа сайдбар скрыт). На узком окне плитки скрыты, каталог открывает кнопка «Навыки» внизу справа.
+3. **Skills Studio**: плитка «Навыки» → карточки со стоимостью ядра → «Редактировать»; `Ctrl+S` сохраняет, копия — в `~/.dsh/skills/.dsh-kit-backups`.
+4. **Token Lab**: плитка «Токены» → состав контекста, топ-6 узлов, давление на окно.
+5. **Автопилот**: напишите «свёрстай лендинг» — в промпт добавится маршрут `wow-design` (+ `seo`); статус виден в шапке каталога.
+6. **Память проектов**: откройте папку проекта — в первом же ответе появится `project_memory`-дайджест с автосканом (стек, команды, точки входа). `/memory brief` — карточка, `/memory scan` — обновить, `/memory projects` — список. Файлы: `~/.dsh/projects-memory/<slug>/`.
+7. **Пиковый тариф**: если сейчас 04:00–07:00 или 09:00–13:00 МСК — над композером красная карточка; за 5 минут до окна — жёлтая.
+8. **Навыки**: `~/.dsh/skills` содержит 25 папок, каждое ядро ≤ 6k токенов.
+9. **Перенос**: Настройки → «Перенос и резервные копии».
+10. **Перемещение чатов**: правый клик по чату → «Переместить в рабочую область…».
 
 Диагностика: `powershell -ExecutionPolicy Bypass -File .\doctor.ps1`.
 

package/docs/PRIVACY.md

@@ -33,6 +33,10 @@
 | `~/.dsh/dsh-autopilot.json` | режим автопилота и лимит навыков | да, вернётся к значениям по умолчанию |
 | `~/.dsh/skills/.dsh-kit-backups/*.md` | резервные копии `SKILL.md` перед сохранением в Studio | да, это только копии |
 | `~/.dsh/skills/.dsh-kit-trash/<дата>-<навык>/` | навыки, удалённые через Studio | да, после проверки |
+| `~/.dsh/projects-memory/` | локальные досье проектов, журнал, `scan.json`, реестр | да, но потеряется память проектов |
+| `~/.dsh/projects-memory/_access.log` | диагностика обращений (300 строк) | да |
+
+Память проектов **не читает** `.env`, ключи, `credentials*`, `wp-config.php`, дампы и бинарники; из `.env.example` берутся только имена переменных. Перед записью строки проходят redaction (ключи, JWT, токены, URL с паролем, `*_PASSWORD/_SECRET/_TOKEN/_KEY`, e-mail, телефоны). На POSIX каталог и файлы получают `0700/0600`.
 
 Token Lab ничего не пишет: он читает `ctx.tokenMeter` и отдаёт отчёт в интерфейс. Ни один плагин набора не отправляет данные в сеть.
 

package/docs/TOKENS.md

@@ -1,6 +1,6 @@
-# Экономия токенов в DSH Desktop Kit 2.0
+# Экономия токенов в DSH Desktop Kit 2.1
 
-Документ отвечает на три вопроса: **куда уходили токены раньше**, **что изменилось в 2.0** и **как измерить эффект** на своей сессии.
+Документ отвечает на три вопроса: **куда уходили токены раньше**, **что изменилось в 2.x** и **как измерить эффект** на своей сессии.
 
 ## 1. Откуда берётся расход
 
@@ -79,9 +79,16 @@ node tools/skill-cost.mjs --check  # падает, если ядро > 6k ток
 - резервная копия перед каждой записью в `~/.dsh/skills/.dsh-kit-backups`;
 - предупреждение, если ядро выходит за бюджет 6k токенов.
 
-### 2.5. Память проекта
+### 2.5. Память проекта (2.1)
 
-Дайджест памяти ограничен 2 800 символами (≈900 токенов) и обновляется по сигнатуре проекта. В 2.0 добавлено правило: при 60–70% окна сначала записать handoff, потом сжимать.
+Дайджест ограничен 2 800 символами (≈900 токенов) и обновляется по сигнатуре досье, `scan.json`, git-head и хэшу последнего сообщения. В него входят стек и команды из **локального автоскана**, инварианты, грабли, последний журнал и до трёх строк досье, похожих на текущий запрос (auto-recall).
+
+Экономия:
+
+- автоскан заменяет первичную разведку манифестов и структуры — модель не тратит шаги на `read`/`grep`;
+- `brief` — карточка на один экран вместо чтения пяти секций;
+- `scan` обновляет только авто-блоки, не переписывая досье;
+- при 60–70% окна сначала запишите handoff в журнал, потом сжимайте.
 
 ## 3. Как измерить эффект
 
@@ -100,12 +107,12 @@ node tools/skill-cost.mjs --json > skill-cost.json
 
 | Показатель | До | После |
 |---|---|---|
-| `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 |
+| `content-writing` ядро | ≈11 000 токенов | ≈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 |
 
 Цифры — оценка `байты / 3.2`; фактический расход зависит от модели и языка.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-desktop-kit",
-  "version": "2.0.0",
-  "description": "DeepSeek Harness desktop kit 2.0: self-applying skills, live token lab, Skills Studio, Russian UI, project memory, peak guard, chat move and profile transfer.",
+  "version": "2.1.0",
+  "description": "DeepSeek Harness desktop kit 2.1: self-applying skills, live token lab, Skills Studio, self-scanning project memory, Russian UI, peak guard, chat move and profile transfer.",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -48,7 +48,7 @@
   "scripts": {
     "build:client": "node tools/build-client.mjs",
     "check:client": "node tools/check-client.mjs client.js",
-    "test": "node tools/smoke-tests.mjs",
+    "test": "node tools/smoke-tests.mjs && node tools/memory-tests.mjs",
     "skills:cost": "node tools/skill-cost.mjs",
     "skills:check": "node tools/skill-cost.mjs --check"
   },

package/plugins/dsh-project-memory/README.md

@@ -1,71 +1,84 @@
 # dsh-project-memory — локальная долговременная память по проектам
 
-Плагин для DeepSeek Harness: превращает «разберись и запомни проект» в постоянную
-локальную базу знаний, которая сама подгружается в новые чаты.
+Плагин для DeepSeek Harness: сам распознаёт проект по рабочей папке, делает **локальный
+автоскан** (без LLM и сети), ведёт досье и подмешивает в промпт компактный дайджест.
+Ставится один раз — работает у любого пользователя без ручной настройки.
 
 ## Что делает
 
-1. **Определяет проект по рабочей директории сессии.** Если каталог не зарегистрирован,
-   но в нём (или выше) есть маркеры проекта (`.git`, `AGENTS.md`, `composer.json`,
-   `package.json`, `artisan`, `wp-config.php`, …), проект регистрируется самозаранее
-   и для него создаётся скелет досье.
-2. **Подмешивает компактный дайджест** (≤ ~2.8 К символов) в контекст каждого запроса
-   модели: название, корень, стек, статус свежести (git), главные инварианты, известные
-   грабли, последняя запись журнала и напоминание, если в прошлом ходе проект менялся,
-   а память не обновлялась. Для подагентов дайджест не подмешивается.
-3. **Даёт модели инструмент `project_memory`**: `status`, `list`, `read`, `search`,
-   `append_journal`, `update_section`, `register`.
-4. **Автоматически пишет журнал.** После каждого хода, в котором проект правился или
-   выполнялись команды, в `JOURNAL/YYYY-MM.md` добавляется детерминированная запись:
-   время, ход, сессия, изменённые файлы, команды, ошибки, признак «память обновлена
-   моделью». Это работает даже если модель не успела ничего записать.
-5. **Команда `/remember`** — просит агента загрузить скилл `project-deep-dive`,
-   проанализировать проект и заполнить досье.
+1. **Распознаёт проект.** Идёт вверх по рабочей директории до ближайшего маркера
+   (`.git`, `composer.json`, `package.json`, `artisan`, `wp-config.php`, `pyproject.toml`,
+   `go.mod`, `Cargo.toml`, `Gemfile`, `bitrix`, compose) и регистрирует его. Одинаковый
+   git-remote склеивает проект после переноса/переименования папки.
+2. **Сканирует локально.** Читает только allowlist манифестов и документации: стек,
+   фреймворки, БД, команды запуска/тестов/сборки, точки входа, ключевые каталоги, тесты,
+   CI, docker-сервисы, имена переменных из `.env.example`. Скан ограничен 1500 файлами,
+   глубиной 3 и 96 КБ на файл.
+3. **Подмешивает дайджест** (≤ 2800 символов): стек, команды, точки входа, инварианты,
+   грабли, свежесть, последний журнал и **фрагменты досье, похожие на текущий запрос**
+   (auto-recall). Для подагентов дайджест не подмешивается.
+4. **Даёт инструмент `project_memory`:** `status`, `brief`, `list`, `read`, `search`,
+   `scan`, `append_journal`, `update_section`, `register`.
+5. **Пишет журнал автоматически.** После хода с правками/командами в `JOURNAL/YYYY-MM.md`
+   добавляется детерминированная запись: файлы, команды, ошибки, признак «память обновлена».
+6. **Команды:** `/remember` — глубокий анализ с `project-deep-dive`; `/memory brief|scan|on|off|projects`
+   — карточка, обновление скана, включение/выключение и список проектов.
 
-## Где хранится
+## Безопасность и приватность
+
+- Всё лежит локально в `<DSH_HOME>/projects-memory`; сетевых вызовов нет.
+- Секреты не читаются: `.env`, ключи, `credentials*`, `wp-config.php`, дампы и бинарники
+  исключены. Из `.env.example` берутся **только имена** переменных.
+- Перед записью каждая строка проходит redaction: приватные ключи, JWT, токены GitHub/
+  Slack/AWS/Google/Stripe, URL с логином/паролем, `*_PASSWORD/_SECRET/_TOKEN/_KEY`,
+  e-mail и телефоны. Это последняя линия защиты: в досье всё равно не должно быть секретов.
+- На POSIX каталог и файлы получают права `0700/0600`; на Windows — best-effort.
+- Блоки `<!-- AUTO-SCAN:START … END -->` в секциях обновляются только сканером; текст
+  модели вокруг них не трогается.
 
-`<DSH_HOME>/projects-memory/` (по умолчанию `C:\Users\<user>\.dsh\projects-memory\`):
+## Где хранится
 
 ```
-registry.json               проекты и настройки
-_state.json                 служебное состояние сессий
-_access.log                 диагностика (ограничен 300 строками)
-<slug>/PROJECT.md           паспорт проекта
-<slug>/ARCHITECTURE.md      архитектура
-<slug>/CODE-MAP.md          карта кода
-<slug>/INVARIANTS.md        инварианты и запреты
-<slug>/GOTCHAS.md           грабли и решения
-<slug>/RUNBOOK.md           запуск/тесты/деплой/откат
-<slug>/JOURNAL/YYYY-MM.md   журнал по месяцам
-<slug>/INDEX.json           машинный индекс/свежесть
+<DSH_HOME>/projects-memory/
+  registry.json               проекты и настройки
+  _state.json                 состояние сессий (7 дней)
+  _access.log                 диагностика (300 строк)
+  <slug>/PROJECT.md           паспорт + автоскан
+  <slug>/ARCHITECTURE.md      структура + автоскан
+  <slug>/CODE-MAP.md          карта кода + автоскан
+  <slug>/INVARIANTS.md        инварианты и запреты
+  <slug>/GOTCHAS.md           грабли и решения
+  <slug>/RUNBOOK.md           запуск/тесты/деплой + автоскан
+  <slug>/JOURNAL/YYYY-MM.md   журнал
+  <slug>/INDEX.json           машинный индекс
+  <slug>/scan.json            кэш последнего скана
 ```
 
-Ничего не отправляется в сеть: наружу уходит только обычный промпт модели, в который
-попадает дайджест. Секреты/PII при записи вычищаются регулярками (и это последняя
-линия защиты — в досье их быть не должно).
+## Настройки (`registry.json → settings`)
 
-## Установка
-
-```
-plugin_manager install_bundle  target = <этот каталог>
-```
-После установки хост-кода достаточно перезагрузки конфига (`set_bundle`), клиентская
-часть и скиллы подхватываются без перезапуска приложения (страницу достаточно
-обновить, чтобы увидеть изменения клиентских плагинов).
+| Ключ | По умолчанию | Назначение |
+|---|---|---|
+| `digestBudgetChars` | `2800` | бюджет дайджеста в символах |
+| `autoRegister` | `true` | регистрировать проект по маркерам |
+| `autoScan` | `true` | локальный скан при первом входе и устаревании |
+| `autoRecall` | `true` | подмешивать фрагменты досье по текущему запросу |
+| `maxProjects` | `200` | предохранитель авто-регистрации |
+| `scanTtlHours` | `24` | как часто пересканировать без изменений git |
+| `injectSubagents` | `false` | дайджест подагентам |
+| `curator.enabled` | `false` | фоновый LLM-куратор (включается осознанно, стоит токенов) |
 
-## Настройки (registry.json → settings)
+## Экономия контекста
 
-- `digestBudgetChars` — бюджет дайджеста в символах (по умолчанию 2800);
-- `injectSubagents` — подмешивать ли дайджест подагентам (по умолчанию `false`);
-- `autoRegister` — авто-регистрация проектов по маркерам (по умолчанию `true`);
-- `curator.enabled`, `curator.idleMs` — фоновый куратор-субагент (если подключён мост).
+- Автоскан заменяет первичную разведку файлов: модель получает стек и команды сразу.
+- `brief` — карточка на один экран вместо чтения пяти секций.
+- `search`/`read` — точечно; дайджест сам подсказывает релевантные строки.
+- Дайджест кэшируется по файлам, git-head и тексту запроса; повторно не пересобирается.
 
 ## Ограничения
 
-- Признак «проект» выводится из путей; для нестандартных раскладок регистрируйте проект
-  вручную (`project_memory action=register name=... root=...`).
-- Дайджест — сжатая выжимка; полную информацию агент читает инструментом.
-- Плагин использует внутренние сервисы Harness (`systemPrompt.context`, `tools`,
-  `session/event`); после крупного обновления DSH возможна адаптация.
-- Автожурнал пишет факты, но не литературные выводы: смысловое резюме — задача модели
-  или куратора.
+- Распознавание эвристическое (маркеры + git). Для нестандартных раскладок —
+  `project_memory action=register name=... root=...`.
+- Скан не заменяет глубокий анализ: он даёт факты «что за проект и как запускать»,
+  смысловые выводы пишет модель через `update_section` или `/remember`.
+- Куратор по умолчанию выключен: это субагент, он расходует токены. Включайте, если
+  нужна автоматическая смысловая запись после каждого хода.