dsh-composer-plus 1.20.0 → 1.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ru.md CHANGED
@@ -29,7 +29,7 @@ dsh plugin --profile web add dsh-composer-plus
29
29
 
30
30
  Затем перезапустите dsh. (CLI не может устанавливать плагины в профиль настольного приложения: им управляет само приложение.)
31
31
 
32
- > pnpm в dsh пропускает версии, которые вышли меньше 24 часов назад. Сразу после выпуска укажите версию: `dsh-composer-plus@1.20.0`.
32
+ > pnpm в dsh пропускает версии, которые вышли меньше 24 часов назад. Сразу после выпуска укажите версию: `dsh-composer-plus@1.21.0`.
33
33
 
34
34
  ## Функции
35
35
 
@@ -71,9 +71,21 @@ dsh plugin --profile web add dsh-composer-plus
71
71
  | **Запланированные шаги** | <a id="feature-plannedsteps"></a>По умолчанию выключено: включите функцию в **Настройки → Composer Plus**. Агент получает инструмент `plan_next_steps`: в том же сообщении, что и команда, он может спланировать следующие команды с точными аргументами и условием, например «запусти `npm test`, если сборка прошла». Когда результат выполняет условие, Composer Plus сам запускает следующий шаг без нового вызова модели, и длинный чат расходует меньше токенов. Шаг видно в чате как короткую строку «Composer Plus · Planned steps: ran `test` … without a model call», за ней идут вызов инструмента и результат. Только шаги `bash`, `read`, `grep` и `glob`; подтверждения, песочница и «Защищённые файлы» действуют на каждый шаг как обычно. Модель отвечает снова, когда условие не выполнено, когда два шага готовы одновременно, после последнего шага и когда вы отправляете сообщение. Идея взята из HarnessMM (arXiv 2610.32813). | <a href="assets/features/plannedSteps.webp"><img src="assets/features/plannedSteps.webp" width="160" alt="Снимок экрана: Запланированные шаги"></a> |
72
72
  | **Защищённые файлы** | <a id="feature-protectedfiles"></a>Включено по умолчанию. Собственные файловые инструменты агента не могут читать или изменять файлы, подходящие под ваши шаблоны: `read`, `read_image` и `grep` по файлу отклоняются для шаблонов **чтение и запись**, а `write`, `edit` и `str_replace_editor` — для обоих видов. Агент читает причину, и ему предлагается спросить вас. Шаблоны по умолчанию: `.env*`, `*.pem` и `*.key`. Настройки → Composer Plus → **Защищённые файлы**: добавьте шаблон (например, `published/**` или `config/*.yml`), нажмите на его вид, чтобы переключить между **чтение и запись** и **только запись**, удалите его кнопкой ✕ или нажмите **Использовать значения по умолчанию**. Шаблон без `/` подходит к имени файла в любой папке. Это ограждение, а не песочница: команда оболочки (`cat .env`), скрипт или инструмент MCP всё равно могут добраться до файла (см. «Ограничения»). | <a href="assets/features/protectedFiles.webp"><img src="assets/features/protectedFiles.webp" width="160" alt="Снимок экрана: Защищённые файлы"></a> |
73
73
  | **Заблокированные команды** | <a id="feature-blockedcommands"></a>Включено по умолчанию, список изначально пуст. Команды оболочки агента (`bash`, `pwsh`) не могут запустить команду, подходящую под ваши правила: правило **блокировать** отклоняет вызов (агент читает причину, и ему предлагается спросить вас), правило **сначала спросить** показывает карточку одобрения dsh, и команда запускается, только когда вы её разрешите. Настройки → Composer Plus → **Заблокированные команды**: введите правило (например, `npm publish`, `git push --force` или `ssh *192.168.2.19`), нажмите на вид, чтобы переключить между **блокировать** и **сначала спросить**, затем нажмите **Добавить**; нажмите на вид правила, чтобы изменить его, удалите правило кнопкой ✕. Правило — это имя команды и слова, которые должны идти после него в этом порядке; `*` подходит к любому тексту. Функция также находит команду после `&&`, `;`, `\|`, внутри `$(…)`, `bash -c "…"` или `eval`, а также после `sudo` или `env`. Это ограждение, а не песочница: переменная (`$CMD`), файл скрипта или другая программа всё равно могут запустить команду (см. «Ограничения»). | <a href="assets/features/blockedCommands.webp"><img src="assets/features/blockedCommands.webp" width="160" alt="Снимок экрана: Заблокированные команды"></a> |
74
- | **Доска задач** | <a id="feature-taskboard"></a>Левая боковая панель → **Доска задач**. Канбан-доска ваших чатов dsh с тем же живым состоянием, что показывает боковая панель: чат, который ждёт вашего одобрения, ответа или проверки плана, находится в **На проверке** с оранжевой точкой, работающий чат — в **В работе**, завершённый чат — в **Готово** (зелёный, пока вы его не откроете). Выберите слева проект или **Все проекты**; папка ветки для каждого чата считается частью своего проекта. Введите текст в **Поиск проектов** над списком, чтобы найти проект по названию (регистр и диакритические знаки не важны; `Esc` очищает поле), и нажмите **Активные за последние 2 часа**, чтобы показать только проекты с чатом, который ждёт, работает, завершился и ещё не просмотрен или изменился за последние 2 часа (настройка хранится на этом устройстве). **Новая задача** (или `n`) открывает собственный новый чат dsh в проекте, который показывает доска (при **Все проекты** — в проекте, который выбирает «Новый сеанс» dsh), поэтому вы можете добавлять файлы, использовать команды и выбирать модель, как в любом чате. Когда ваше первое сообщение отправлено, доска возвращается сама. До этого чат ждёт в **К выполнению** как **Новая задача**: нажмите на него, чтобы написать первое сообщение. Столбец **К выполнению** показывается только в это время. У проекта с чатом, который ждёт вас, в списке проектов есть оранжевая точка. dsh даёт чату название, а модель чата пишет до 3 тегов по этому сообщению. Нажмите на карточку, чтобы открыть её чат. На оранжевой карточке нажмите **Ответить**, чтобы ответить прямо на доске: **Отклонить** или **Разрешить один раз**, **Одобрить** или **Запросить изменения** для плана, либо варианты и ваш собственный текст для вопроса. **Скрыть завершённые** скрывает **Готово** на этом устройстве. Наведите указатель на карточку в **В работе** (или переведите на неё фокус клавиатуры), чтобы увидеть ход работы: сколько времени работает чат, шаг его списка задач, инструмент, который работает сейчас, и последнюю строку агента. В разделе Настройки → Composer Plus → Доска задач параметр **Ход работы при наведении** выбирает **Быстро (без ИИ)** (по умолчанию: только читает чат) или **Сводка ИИ** (один короткий вызов модели чата дополнительно пишет одно-два предложения). | <a href="assets/features/taskBoard.webp"><img src="assets/features/taskBoard.webp" width="160" alt="Снимок экрана: Доска задач"></a> |
74
+ | **Доска задач** | <a id="feature-taskboard"></a>Левая боковая панель → **Доска задач** или `Cmd+Shift+K` (`Ctrl+Shift+K` в Windows и Linux) в любом месте dsh. Канбан-доска ваших чатов dsh с тем же живым состоянием, что показывает боковая панель: чат, который ждёт вашего одобрения, ответа или проверки плана, находится в **На проверке** с оранжевой точкой, работающий чат — в **В работе**, завершённый чат, который вы ещё не открыли, — в **Готово** (зелёный). Когда вы открываете чат, его карточка сама уходит из **Готово**; нажмите **Недавно завершённые (N)** под зелёными карточками, чтобы увидеть прочитанные завершённые чаты (10 самых новых, затем **Показать более старые: N**; открыто или закрыто — запоминается на этом устройстве). Чат, который завершился, пока был открыт за доской (**Новая задача**), остаётся зелёным, пока вы его не откроете. Нажмите на название проекта вверху доски, чтобы открыть список проектов, и выберите проект или **Все проекты**; папка ветки для каждого чата считается частью своего проекта. Список закрывается после выбора, по `Esc` или по щелчку вне его. Введите текст в **Поиск проектов** вверху списка, чтобы найти проект по названию (регистр и диакритические знаки не важны; `Esc` очищает поле), нажмите `Enter`, чтобы выбрать первое совпадение, и нажмите **Активные за последние 2 часа**, чтобы показать только проекты с чатом, который ждёт, работает, завершился и ещё не просмотрен или изменился за последние 2 часа (настройка хранится на этом устройстве). **Новая задача** (или `n`) открывает собственный новый чат dsh в проекте, который показывает доска (при **Все проекты** — в проекте, который выбирает «Новый сеанс» dsh), поэтому вы можете добавлять файлы, использовать команды и выбирать модель, как в любом чате. Когда ваше первое сообщение отправлено, доска возвращается сама. До этого чат ждёт в самом верху столбца **В работе** как **Новая задача**: нажмите на него, чтобы написать первое сообщение. У проекта с чатом, который ждёт вас, в списке проектов есть оранжевая точка (пока какой-либо чат ждёт, она есть и у названия проекта вверху). dsh даёт чату название, а модель чата пишет до 3 тегов по этому сообщению. Нажмите на карточку, чтобы открыть её чат. Нажмите на оранжевую карточку (или на её **Ответить**), чтобы ответить прямо на доске; в панели есть **Открыть чат**, чтобы увидеть весь чат: **Отклонить** или **Разрешить один раз**, **Одобрить** или **Запросить изменения** для плана, либо варианты и ваш собственный текст для вопроса. Нажмите **×** на завершённой карточке, чтобы убрать её с доски, или откройте **Недавно завершённые** и нажмите **Очистить всё** вверху столбца **Готово**, чтобы убрать эти карточки с доски: сначала окно показывает, сколько карточек какого проекта уйдёт, а непрочитанные (зелёные) карточки остаются. В течение 8 секунд после этого кнопка **Отменить** возвращает карточки; **Убранные (N)** под столбцом **Готово** показывает список карточек, убранных с доски, а **Вернуть на доску** снова показывает одну из них в **Готово**. Ни один чат не удаляется: чаты остаются на боковой панели dsh, доска помнит это и после перезапуска (Tether показывает ту же доску), а чат, который снова запускается, возвращается на доску. Наведите указатель на карточку в **В работе** (или переведите на неё фокус клавиатуры), чтобы увидеть ход работы: сколько времени работает чат, шаг его списка задач, инструмент, который работает сейчас, и последнюю строку агента. В разделе Настройки → Composer Plus → Доска задач параметр **Ход работы при наведении** выбирает **Быстро (без ИИ)** (по умолчанию: только читает чат) или **Сводка ИИ** (один короткий вызов модели чата дополнительно пишет одно-два предложения). | <a href="assets/features/taskBoard.webp"><img src="assets/features/taskBoard.webp" width="160" alt="Снимок экрана: Доска задач"></a> |
75
75
  | **Память проекта** | <a id="feature-projectmemory"></a>По умолчанию выключено: включите функцию в **Настройки → Composer Plus**. У каждой папки проекта своя память, которую читают следующие чаты этого проекта, так же как DS Bot хранит память для каждого бота. После каждого завершённого хода один вызов модели чата читает новые сообщения (без отменённых откатом), сохраняет ваши постоянные предпочтения, решения и факты как короткие заметки и изменяет или удаляет старые. Агент также может сам сохранять, удалять и искать заметки (`memory_remember`, `memory_forget`, `memory_recall`). Заметка может быть и глобальной: её читают все проекты. Новый чат получает заметки в системном промпте; заметка, сохранённая позже, появляется со следующего чата. Файлы хранятся в формате Markdown в домашней папке dsh (`storages/dsh-composer-plus/memory/`), никогда в папке проекта. Кнопка **Открыть память** в той же строке показывает все сохранённые заметки по проектам (и глобальную память), с фильтром. Опишите своими словами, что изменить (например, «я перешёл с yarn на pnpm»), затем нажмите **Предпросмотр изменений**: модель dsh по умолчанию предлагает изменения, а сохраняет их только **Применить**. В Tether: меню заголовка чата → Project memory. | <a href="assets/features/projectMemory.webp"><img src="assets/features/projectMemory.webp" width="160" alt="Снимок экрана: Память проекта"></a> |
76
+ | **История версий памяти** | <a id="feature-memoryhistory"></a>По умолчанию включено, пока включена **Память проекта**. Перед каждым сохранением памяти (агентом, проверкой после хода, через **Открыть память**) сохраняется копия заметок в прежнем виде. В **Открыть память** выберите проект или **Глобальная память**, затем **История**: версии по дате и кто изменил память после каждой. Выберите версию, чтобы увидеть в виде diff, что изменит восстановление, затем **Восстановить**. Заметки до восстановления тоже сохраняются, поэтому его можно отменить. Для каждой памяти остаются 50 последних версий. В Tether: меню заголовка чата → Project memory → History. | <a href="assets/features/memoryHistory.webp"><img src="assets/features/memoryHistory.webp" width="160" alt="Снимок экрана: История версий памяти"></a> |
77
+ | **Экспорт памяти в AGENTS.md** | <a id="feature-memoryexport"></a>В **Открыть память** выберите проект, затем **Экспорт в AGENTS.md**: заметки проекта попадут в отмеченный раздел `AGENTS.md` в его папке, чтобы вы могли закоммитить их и поделиться с командой и другими инструментами агентов. Сначала вы видите изменение в виде diff; сохраняет только **Записать AGENTS.md**. Следующий экспорт заменяет только этот раздел. Глобальная память, источники и даты не записываются. В Tether: меню заголовка чата → Project memory → Export to AGENTS.md. | <a href="assets/features/memoryExport.webp"><img src="assets/features/memoryExport.webp" width="160" alt="Снимок экрана: Экспорт памяти в AGENTS.md"></a> |
78
+ | **Ссылка на источник заметки памяти** | <a id="feature-memorysource"></a>В **Открыть память** рядом с заметкой из чата (её сохранил агент, оставила проверка после хода или вы приняли предложение) есть **Источник**: щелчок открывает этот чат на сообщении, чтобы перед изменением или удалением проверить, почему заметка там. Заметка из более ранней версии открывает только свой чат. В Tether: меню заголовка чата → Project memory → Source. | <a href="assets/features/memorySource.webp"><img src="assets/features/memorySource.webp" width="160" alt="Снимок экрана: Ссылка на источник заметки памяти"></a> |
79
+ | **Копировать память в другой проект** | <a id="feature-memorycopy"></a>В **Открыть память** выберите проект или **Глобальная память**, затем **Копировать в проект**: отметьте заметки, найдите проект dsh и щёлкните по нему. Все отмеченные заметки попадут в память этого проекта (с темой и источником) или ни одна: если одна не помещается, ничего не копируется и показывается причина. Заметка, которая в проекте уже есть, пропускается. В Tether: меню заголовка чата → Project memory → Copy to project. | <a href="assets/features/memoryCopy.webp"><img src="assets/features/memoryCopy.webp" width="160" alt="Снимок экрана: Копировать память в другой проект"></a> |
80
+ | **Поиск устаревших заметок памяти** | <a id="feature-memorystale"></a>Когда вы выбираете проект в **Открыть память**, пути к файлам (в `коде`), скрипты npm и имена веток из его заметок сверяются с текущим проектом. Заметка, где упомянуто то, чего в проекте больше нет, показывает ⚠ и что отсутствует, чтобы вы исправили или удалили её до того, как модель будет на неё опираться. Читаются только обычные файлы в папке проекта и один список веток git; ничего не меняется, модель не вызывается. В Tether: меню заголовка чата → Project memory. | <a href="assets/features/memoryStale.webp"><img src="assets/features/memoryStale.webp" width="160" alt="Снимок экрана: Поиск устаревших заметок памяти"></a> |
81
+ | **Не использовать память в этом чате** | <a id="feature-memoryperchat"></a>Пока **Память проекта** включена, в заголовке чата видна кнопка **Память включена**: щёлкните её, чтобы выключить память только для этого чата (**Память выключена**). Тогда модель этого чата не получает раздел памяти и инструменты памяти, а проверка после каждого хода его не читает. В dsh 0.2.1 и новее та же кнопка есть на экране нового чата, поэтому тестовый чат начинается без памяти. Другие чаты не меняются. В Tether: меню заголовка чата → Use project memory. | <a href="assets/features/memoryPerChat.webp"><img src="assets/features/memoryPerChat.webp" width="160" alt="Снимок экрана: Не использовать память в этом чате"></a> |
82
+ | **Предложить заметки памяти из чата** | <a id="feature-memorysuggest"></a>Пока **Память проекта** включена, в заголовке чата есть **Предложить для памяти**: щелчок спрашивает модель чата, какие правила и решения из этого чата стоит сохранить для следующих чатов. Каждое предложение объясняет причину; **Принять** сохраняет его со ссылкой на чат и сообщение, откуда оно взято, **Отклонить** отбрасывает. До принятия ничего не сохраняется, а модель вызывается только по щелчку. Сообщения, отозванные откатом, не отправляются. В Tether: меню заголовка чата → Suggest for memory. | <a href="assets/features/memorySuggest.webp"><img src="assets/features/memorySuggest.webp" width="160" alt="Снимок экрана: Предложить заметки памяти из чата"></a> |
76
83
  | **Разрешить для этого чата** | <a id="feature-allowforchat"></a>Когда автопроверка спрашивает вас, на карточке одобрения появляется кнопка **Разрешить для этого чата**. После этого тот же инструмент в том же чате разрешён с любыми аргументами, пока не истечёт лимит времени (по умолчанию 1 час; выберите его в **Настройки → Composer Plus → Разрешить для этого чата**). Затем агент снова спрашивает. Значок в заголовке показывает список разрешений со временем их окончания и позволяет их отозвать. Разрешения сохраняются после перезапуска. | <a href="assets/features/allowForChat.webp"><img src="assets/features/allowForChat.webp" width="160" alt="Снимок экрана: Разрешить для этого чата"></a> |
84
+ | **Отклонить с примечанием** | <a id="feature-rejectnote"></a>На карточке подтверждения рядом с **Отклонить** появляется **Отклонить с примечанием…**. Нажмите её, напишите причину или что сделать вместо этого и нажмите **Отклонить** (или `Enter`; `Shift+Enter` добавляет строку, `Esc` закрывает поле). Сначала примечание уходит агенту как сообщение в ожидающий ход, затем запрос отклоняется: модель читает отказ и ваше примечание в том же ходе, без отдельного сообщения от вас. Если примечание не удалось отправить, ничего не отклоняется и поле остаётся открытым. В Tether: лист подтверждения → Reject with note. | <a href="assets/features/rejectNote.webp"><img src="assets/features/rejectNote.webp" width="160" alt="Снимок экрана: Отклонить с примечанием"></a> |
85
+ | **Ввод секрета** | <a id="feature-secretinput"></a>Агент получает инструмент `request_secret`. Когда ему нужен пароль, токен или ключ API, он запрашивает его этим инструментом, а не в чате: в строке инструмента появляется карточка с названием, причиной, полем пароля и кнопками **Сохранить** и **Отклонить**. **Сохранить** записывает значение в файл на этом Mac, который можете читать только вы, а агент получает только путь к файлу и использует его как входные данные команды (например, `"$(cat <path>)"`). Если позже результат инструмента покажет значение, `[secret]` заменит его до того, как его увидит модель. Файл удаляется в конце хода. **Отклонить** сообщает агенту, что вы не дали значение. Выключите функцию в **Настройки → Composer Plus**, чтобы убрать инструмент. В Tether: полоса «Secret: …» над полем ввода → Enter. | <a href="assets/features/secretInput.webp"><img src="assets/features/secretInput.webp" width="160" alt="Снимок экрана: Ввод секрета"></a> |
86
+ | **Цитата в ответе** | <a id="feature-quotereply"></a>Выделите часть ответа: над выделением появится кнопка **Цитировать**. Нажмите её: эта часть попадёт в поле ввода, в позицию курсора, как цитата Markdown (`> …`) с пустой строкой после неё, а поле ввода получит фокус, и вы напишете ответ ниже. Учитывается только текст ответа, а не рассуждения, строки инструментов или ваши собственные сообщения. Цитата содержит не больше 2 000 символов. `Cmd+Z` (`Ctrl+Z`) убирает её. В Tether: нажмите и удерживайте ответ → Quote (весь ответ). | <a href="assets/features/quoteReply.webp"><img src="assets/features/quoteReply.webp" width="160" alt="Снимок экрана: Цитата в ответе"></a> |
87
+ | **Побочный чат** | <a id="feature-sidechat"></a>Напишите побочный вопрос в поле ввода и нажмите кнопку с облачками (**Спросить в побочном чате**): откроется копия чата, которая ответит в режиме только чтения dsh, а чат продолжит работу. Копия знает чат до текущего момента, кроме сообщений, которые ещё ждут в очереди, и использует его модель. На панели над её полем ввода есть **Вернуть**: откроется чат, и в его поле ввода попадут ваши вопросы (как цитаты `> `) и ответы. **Назад в чат** только открывает чат. Побочный чат остаётся на боковой панели как «↳ <вопрос>»; архивируйте его там. В Tether: меню заголовка чата → Side chat…. | <a href="assets/features/sideChat.webp"><img src="assets/features/sideChat.webp" width="160" alt="Снимок экрана: Побочный чат"></a> |
88
+ | **Заметки к diff** | <a id="feature-diffcomments"></a>В разделе **Панель изменений** откройте diff файла и нажмите **+** у строки (Shift+щелчок по второй строке того же блока — диапазон), напишите заметку и нажмите **Сохранить заметку**. Заметки чата ждут на панели сверху; **Отправить в поле ввода** помещает их в позицию курсора в формате Markdown: `path:12-14`, строки как блок `diff` и ваша заметка. **Очистить** удаляет их. Заметки хранятся в этом браузере, пока вы их не отправите или не очистите. Нужна **Панель изменений**. В Tether: diff файла → удерживайте строку → Add note…. | <a href="assets/features/diffComments.webp"><img src="assets/features/diffComments.webp" width="160" alt="Снимок экрана: Заметки к diff"></a> |
77
89
  | **Статус проекта** | <a id="feature-projectstatus"></a>Строка проекта на боковой панели показывает ту же метку, что и его чаты: индикатор выполнения, ожидание или «готово». Поэтому даже свёрнутый проект сообщает, что чат внутри работает или ждёт вас. Сначала показывается чат, который ждёт вас, затем завершённый чат, который вы ещё не открыли (зелёная точка, даже пока другой чат ещё выполняется), затем индикатор выполнения. Наведите на метку указатель, чтобы увидеть подробности. В режиме **Дерево рабочих областей** строка родительской папки также показывает чаты каждого проекта внутри неё (например, каждой папки ветки в `.worktrees/`), даже когда папка свёрнута. | <a href="assets/features/projectStatus.webp"><img src="assets/features/projectStatus.webp" width="160" alt="Снимок экрана: Статус проекта"></a> |
78
90
  | **Ветка Git в строках чатов** | <a id="feature-sessionbranch"></a>В режиме «Одним списком» на боковой панели каждая строка чата показывает маленькую серую метку с веткой git, на которой была папка проекта чата в его последнем ходе (например, `main` или `feature/login`; при отсоединённом HEAD ветки нет, и метка не показывается). Два чата одного проекта на разных ветках больше не выглядят одинаково, и вы сразу видите, если собираетесь продолжить чат не на той ветке. Наведите указатель на метку, чтобы увидеть полное имя. Host-часть читает ветку (`git branch --show-current`, только чтение), когда ход начинается и когда заканчивается; у чата без хода с момента установки этой функции или у папки, которая не является репозиторием git, метки нет. В режимах «По рабочей области» и «Дерево рабочих областей» ни одна строка чата не показывает метку, потому что чат уже находится под строкой своего проекта. | <a href="assets/features/sessionBranch.webp"><img src="assets/features/sessionBranch.webp" width="160" alt="Снимок экрана: Ветка Git в строках чатов"></a> |
79
91
  | **Отметить все как прочитанные** | <a id="feature-markprojectread"></a>На боковой панели нажмите кнопку **…** проекта → **Отметить все как прочитанные**. У всех чатов этого проекта сразу пропадает зелёная точка непрочитанного. У других проектов точки остаются. Если в проекте нет непрочитанных чатов, пункт показан серым (**Нет непрочитанных чатов**). | <a href="assets/features/markProjectRead.webp"><img src="assets/features/markProjectRead.webp" width="160" alt="Снимок экрана: Отметить все как прочитанные"></a> |
@@ -83,8 +95,11 @@ dsh plugin --profile web add dsh-composer-plus
83
95
  | **Сортировка по состоянию** | <a id="feature-statusorder"></a>Боковая панель → параметры просмотра → **Сортировать** → **По состоянию** (вместе с **Одним списком**). Сначала идут завершённые чаты (с точкой dsh «готово»; её получает и ход, который закончился ошибкой), затем выполняющиеся или ожидающие чаты, затем чаты с активной автоматизацией (расписанием), затем остальные в порядке dsh. Когда вы открываете завершённый чат, он опускается ниже. Меняется только вид: чтобы вернуться, выберите **Вручную** или **По дате изменения**. | <a href="assets/features/statusOrder.webp"><img src="assets/features/statusOrder.webp" width="160" alt="Снимок экрана: Сортировка по состоянию"></a> |
84
96
  | **Фоновые уведомления** | <a id="feature-notifications"></a>Пока dsh работает в фоне, вы получаете уведомление, когда ход завершён (первая строка ответа) или когда чат действительно ждёт вас: одобрения (имя инструмента), ответа (сам вопрос) или проверки плана. Запрос должен оставаться открытым и через 1,5 с. Поэтому одобрения, на которые ответили автоматически (разрешения автопроверки, другие плагины), не вызывают уведомлений. Уведомление убирается, как только на его запрос ответили. Значок в Dock или на панели задач показывает число ожидающих чатов. Щелчок по уведомлению открывает этот чат. | <a href="assets/features/notifications.webp"><img src="assets/features/notifications.webp" width="160" alt="Снимок экрана: Фоновые уведомления"></a> |
85
97
  | **Открывать ожидающий чат при бездействии** | <a id="feature-idleswitch"></a>Когда чат задаёт вопрос, ждёт одобрения или проверки плана (оранжевая точка) или завершает ход, который вы ещё не прочитали (зелёная точка), а вы не пользуетесь dsh 30 секунд, dsh открывает этот чат. Оранжевые чаты открываются раньше зелёных. В каждой группе первым открывается тот, что ждёт дольше всех; следующий открывается ещё через 30 секунд бездействия. Нажатие клавиши, щелчок, движение мыши, колесо прокрутки или касание запускают отсчёт 30 секунд заново. Текст в поле с фокусом, выделенный текст или открытое меню либо диалог тоже не дают переключиться. Пока ожидающий чат на экране, ничего не меняется. Если вы ушли из ожидающего чата, не ответив, он может открыться снова после следующих 30 секунд бездействия. Когда открывается зелёный чат, его точка исчезает; следующий зелёный чат откроется только после того, как вы снова воспользуетесь dsh, а затем 30 секунд не будете им пользоваться. Функция работает и когда dsh в фоне, но окно dsh не выходит на передний план. | <a href="assets/features/idleSwitch.webp"><img src="assets/features/idleSwitch.webp" width="160" alt="Снимок экрана: Открывать ожидающий чат при бездействии"></a> |
98
+ | **Следующий ожидающий чат** | <a id="feature-nextwaiting"></a>Кнопка в заголовке боковой панели показывает, сколько других чатов ждут вас, и точку цвета следующего чата: оранжевую, когда он задаёт вопрос или ждёт одобрения или проверки плана, зелёную, когда он завершил ход, который вы ещё не прочитали. Нажмите на кнопку или нажмите Cmd+Shift+E (Ctrl+Shift+E в Windows и Linux), чтобы открыть этот чат. Оранжевые чаты идут раньше зелёных; в каждой группе первым идёт чат, который ждёт дольше всех. Чат на экране не считается. Если других ожидающих чатов нет, кнопка не видна, а клавиша ничего не делает. Клавишу можно изменить на странице сочетаний клавиш dsh (Следующий ожидающий чат). | <a href="assets/features/nextWaiting.webp"><img src="assets/features/nextWaiting.webp" width="160" alt="Снимок экрана: Следующий ожидающий чат"></a> |
99
+ | **Кнопки вариантов** | <a id="feature-optionpicks"></a>Когда ответ заканчивается списком вариантов (нумерованный список из 1–9 пунктов под заголовком «Варианты» или жирной строкой «Варианты», а также «Следующие шаги» и те же слова на языках приложения), под ответом появляется кнопка для каждого варианта. Нажатие отправляет «Option N: …» с полным текстом варианта как ваше сообщение, как будто вы его напечатали. Вариант с пометкой «(рекомендуется)» выделен. Кнопки появляются только под самым новым ответом, пока чат простаивает и поле сообщения пусто; у уже выбранного ответа и у ответа, отозванного откатом, кнопок нет. Пока кнопки видны, прогноз следующего сообщения ничего не предлагает. На карточке вопроса агента клавиши 1–9 выбирают этот вариант, как нажатие (не в поле ответа и не в первые 0,8 секунды после появления вопроса). | <a href="assets/features/optionPicks.webp"><img src="assets/features/optionPicks.webp" width="160" alt="Снимок экрана: Кнопки вариантов"></a> |
86
100
  | **Язык приложения** | <a id="feature-language"></a>Настройки → Composer Plus → **Язык приложения** переключает весь интерфейс dsh на Türkçe, Español, Português (Brasil), Français, Deutsch, Русский, 日本語, 한국어, Bahasa Indonesia, Tiếng Việt или हिन्दी (см. ниже). | <a href="assets/features/language.webp"><img src="assets/features/language.webp" width="160" alt="Снимок экрана: Язык приложения"></a> |
87
101
  | **Мобильное подключение (iPhone)** | <a id="feature-mobileconnect"></a>Работайте с dsh на iPhone через приложение [Tether](tether/) в той же сети Wi-Fi или через [Tailscale](https://tailscale.com). Включите функцию в **Настройки → Composer Plus** (по умолчанию она выключена, потому что открывает сетевой порт на этом Mac). Затем нажмите **Мобильное подключение** внизу слева на боковой панели, отсканируйте QR-код камерой iPhone (коснитесь **Open in Tether**) или кнопкой **Scan code** в Tether, коснитесь **Connect** и нажмите **Approve**. Сначала установите Tether: без него камера не сможет открыть код. Телефон показывает ваши чаты, отправляет сообщения (с фото: **+** в поле ввода → Camera, Photos или Paste image), отвечает на запросы одобрения и вопросы, переключает модели и агентов. Можно связать сколько угодно Mac: имя Mac вверху слева в приложении переключает между ними. Панель **Мобильное подключение** показывает связанные iPhone и время их последнего подключения: **Remove** сразу отключает любой из них. «Tailscale only» отклоняет подключения из локальной сети (для общей сети Wi-Fi), а журнал доступа показывает, кто пытался подключиться. В Tether «Settings → Privacy» блокирует приложение с помощью Face ID. | <a href="assets/features/mobileConnect.webp"><img src="assets/features/mobileConnect.webp" width="160" alt="Снимок экрана: Мобильное подключение (iPhone)"></a> |
102
+ | **Удалённые компьютеры** | <a id="feature-remotecomputers"></a>Открывайте dsh на других ваших Mac через [Tailscale](https://tailscale.com) и продолжайте их чаты здесь. Включите функцию в **Настройки → Composer Plus** на каждом Mac (по умолчанию она выключена, потому что открывает сетевые порты). На Mac, который вы хотите открыть, включите **Разрешить другим компьютерам открывать этот Mac**, нажмите **Создать ссылку для сопряжения** и скопируйте ссылку. На этом Mac выберите **Добавить компьютер…** в меню выбора компьютера слева от заголовка чата, вставьте ссылку и нажмите **Подключить**. Затем нажмите **Одобрить** на другом Mac. После этого меню показывает **Этот Mac** и ваши компьютеры. Выберите компьютер, и его dsh откроется на вкладке «Браузер» правой боковой панели (или в окне браузера) со своими чатами, инструментами и файлами. Панель настроек переименовывает и удаляет компьютеры и показывает компьютеры, которые могут открывать этот Mac (**Удалить** сразу отключает любой из них). | <a href="assets/features/remoteComputers.webp"><img src="assets/features/remoteComputers.webp" width="160" alt="Снимок экрана: Удалённые компьютеры"></a> |
88
103
  | **Автоматические обновления** | <a id="feature-autoupdate"></a>При запуске dsh плагин проверяет [последний выпуск на GitHub](https://github.com/furkancak1r/dsh-composer-plus/releases/latest). Если он новее и уже есть в npm, плагин устанавливает именно эту версию через встроенный менеджер плагинов dsh (тем же путём, что и Настройки → Плагины) и уведомляет вас. Перезапустите dsh, чтобы загрузить её. **Настройки → Composer Plus → Обновления Composer Plus** показывает версию и кнопки **Проверить обновления** / **Обновить сейчас**. При первом запуске dsh с новой версией окно **Что нового в Composer Plus N** один раз показывает примечания к этой версии на языке из **Язык приложения** (они приходят вместе с новой версией, без нового сетевого запроса; для языка без примечаний показываются английские); **Закрыть** или `Esc` закрывает его. | <a href="assets/features/autoUpdate.webp"><img src="assets/features/autoUpdate.webp" width="160" alt="Снимок экрана: Автоматические обновления"></a> |
89
104
  | **Резервное копирование** | <a id="feature-backup"></a>Настройки → Composer Plus → **Резервное копирование** → **Создать копию сейчас** записывает всю домашнюю папку dsh (чаты, настройки, плагины, MCP, навыки) в один архив в `~/Desktop/dsh-backups` вместе с контрольной суммой. Секреты в архиве скрыты: файлы учётных данных, файлы ключей (`.pem`, `.key`) и значения token, secret и password в настройках yml остаются только на этом компьютере, в `vault` этой папки. `cache/`, `dsh-runtimes/` и `node_modules` в архив не входят (dsh создаёт их заново). У каждой резервной копии в списке есть **Проверить** (читает её целиком), **Для другого компьютера** (папка для копирования на новый компьютер, вместе с аварийной консолью) и **Удалить**. Архивы dsh-backup в той же папке тоже показываются и работают. Чтобы восстановить данные, выйдите из dsh и используйте аварийную консоль. | <a href="assets/features/backup.webp"><img src="assets/features/backup.webp" width="160" alt="Снимок экрана: Резервное копирование"></a> |
90
105
  | **Автоматическое резервное копирование** | <a id="feature-autobackup"></a>Включите **Автоматическое резервное копирование** (по умолчанию выключено: каждая копия занимает примерно столько же места, сколько ваша домашняя папка dsh без кеша). Выберите, как часто создавать копии (**Каждые**: от 6 часов до 7 дней, по умолчанию 24 часа), и сколько резервных копий хранить (**Хранить**: от 3 до 14, по умолчанию 7). Время следующей копии показано под переключателем; неудачная копия тоже показывается там, и через 30 минут будет новая попытка. Когда dsh или Composer Plus запускается с новой версией, вскоре после запуска создаётся снимок, пока новая версия ещё недолго работала с вашими данными (хранятся два самых новых, с пометкой **Перед обновлением**). | <a href="assets/features/autoBackup.webp"><img src="assets/features/autoBackup.webp" width="160" alt="Снимок экрана: Автоматическое резервное копирование"></a> |
@@ -137,6 +152,9 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
137
152
  | `Cmd+F` на Mac, `Ctrl+F` в Windows и Linux | открытый чат | открыть **Поиск в чате** |
138
153
  | `Enter` / `Shift+Enter`, `↓` / `↑` | поле **Поиск в чате** | следующее / предыдущее совпадение |
139
154
  | `Esc` | поле **Поиск в чате** | закрыть поле |
155
+ | `Cmd+Shift+E` на Mac, `Ctrl+Shift+E` в Windows и Linux | в любом месте dsh | открыть **Следующий ожидающий чат** (меняется на странице сочетаний клавиш dsh) |
156
+ | `Cmd+Shift+K` на Mac, `Ctrl+Shift+K` в Windows и Linux | в любом месте dsh | открыть **Доска задач** (меняется на странице сочетаний клавиш dsh) |
157
+ | `1`–`9` | карточка вопроса dsh, не в поле ответа | выбрать этот вариант (**Кнопки вариантов**) |
140
158
 
141
159
  Открытое меню `/` или `@` забирает эти клавиши себе.
142
160
 
@@ -162,17 +180,20 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
162
180
  - **Разрешить для этого чата:** разрешения хранятся вместе со временем выдачи в `$DSH_HOME/storages/dsh-composer-plus/chat-grants.json` (доступ только для владельца). Разрешение действует для одного конкретного инструмента в одном чате, пока не истечёт лимит времени (по умолчанию 1 час). Если этот инструмент может выполнять запись, разрешение покрывает и любую запись. Отозвать его можно через значок в заголовке.
163
181
  - Автопроверка по-прежнему выполняется при каждом вызове. Если проверка завершилась сбоем, вызов никогда не разрешается автоматически.
164
182
  - **Мобильное подключение:** выключено, пока вы его не включите. Когда оно включено, Host-часть запускает шлюз Tether: HTTPS на порту 19390, который принимает подключения только из вашей подсети Wi-Fi и вашего tailnet (100.64.0.0/10), и страницу сопряжения на `127.0.0.1:19391` (только для этого Mac). Телефону нужен одноразовый код из QR-кода (действует 5 минут) и ваше подтверждение **Approve** на Mac. Телефон закрепляет сертификат шлюза. Mac хранит только хеш токена каждого телефона (30 дней, срок продлевается при использовании); **Remove** сразу закрывает подключения этого телефона. Телефоны могут вызывать только разрешённый список методов dsh (чаты, запросы, вложения, слеш-команды, одобрения, вопросы, модели, агенты, цели), но не настройки, учётные данные, обозреватель файлов или терминал. «Tailscale only» отклоняет любое подключение из локальной сети, в том числе уже открытые. Журнал доступа хранит 200 самых новых попыток подключения (время, IP-адрес, имя устройства, разрешено или отклонено и причина) в `access.json`; токенов и кодов сопряжения в нём никогда нет. Данные: `$DSH_HOME/storages/dsh-composer-plus/mobile/` (файлы доступны только владельцу). Подробности: [tether/README.md](tether/README.md).
183
+ - **Удалённые компьютеры:** функция выключена, пока вы не включите её на каждом Mac. **Разрешить другим компьютерам открывать этот Mac** открывает второй порт HTTPS (19392) только на адресе Tailscale этого Mac (не в сети Wi-Fi и без объявления через Bonjour). Другому Mac нужна одноразовая ссылка для сопряжения (действует 5 минут), соответствующий сертификат (закреплённый) и ваше подтверждение **Одобрить**. Этот Mac хранит только хеш его токена. Сопряжённый компьютер получает полный контроль над dsh на этом Mac, как если бы вы работали здесь: чаты, модели, инструменты, файлы и терминал. Удалите его на панели настроек, и его подключения сразу закроются. Mac, который открывает другой Mac, хранит токен этого компьютера в `$DSH_HOME/storages/dsh-composer-plus/computers.json` (файл доступен только владельцу). Для каждого выбранного компьютера он открывает ретранслятор (relay) на `127.0.0.1`. Страница получает одноразовую ссылку (действует 60 секунд), а ретранслятор принимает только свою страницу (свой адрес, никакой другой сайт). Страница, которую открыл другой Mac, не показывает меню выбора компьютера и не может менять компьютеры этого Mac.
165
184
  - **Обновления:** Host-часть запрашивает у `api.github.com` последний выпуск, а у `registry.npmjs.org` — именно эту версию. Никакие данные о вас или ваших чатах не отправляются. Установка идёт через менеджер плагинов dsh (`pnpm add dsh-composer-plus@<version>`; если dsh 0.2.1 отклоняет её для уже установленного плагина, то `pnpm add https://registry.npmjs.org/dsh-composer-plus/-/dsh-composer-plus-<version>.tgz`, и тогда профиль указывает этот URL как источник плагина), поэтому действуют встроенные проверки dsh: реестр, скрипты и совместимость версий. Предварительные выпуски и более старые версии никогда не устанавливаются.
185
+ - **Подсчёт использования:** раз в день Host-часть запрашивает у GitHub маленький файл `active.txt` из выпуска установленной версии (`github.com/furkancak1r/dsh-composer-plus/releases/download/v<version>/active.txt`). GitHub считает эти запросы для каждого файла, поэтому автор видит только, сколько копий каждой версии сделали запрос в этот день. В запросе нет идентификатора, cookie и данных о вас или ваших чатах; GitHub видит ваш IP-адрес, как и при каждой проверке обновлений. День последнего запроса хранится в `$DSH_HOME/storages/dsh-composer-plus/active.json`. Git-клон этого репозитория и переименованная копия ничего не отправляют. Переключателя для этого нет.
166
186
  - **Предсказание следующего сообщения:** по умолчанию включено. Чтобы остановить эти вызовы модели, выключите его в **Настройки → Composer Plus**. После каждого завершённого хода Host-часть отправляет ваши собственные сообщения в чате и текстовые ответы агента (без вывода инструментов, скрытого контекста и рассуждений), не более примерно 6 000 символов (самую новую часть), выбранной модели (по умолчанию это модель dsh, если вы не выберете другую). Это один запрос через настройки провайдера самого dsh. В чате ничего не сохраняется: предположение не попадает в историю чата. Переключатель и выбранная модель хранятся в `$DSH_HOME/storages/dsh-composer-plus/predict.json` (файл доступен только владельцу).
167
187
  - **Дополнение при вводе:** выключено, пока вы его не включите. Когда оно включено, при каждой паузе в наборе Host-часть отправляет уже набранный текст, а также ваши собственные сообщения в чате и текстовые ответы агента (без вывода инструментов, скрытого контекста и рассуждений), не более примерно 3 000 символов чата, модели, выбранной для **Дополнение при вводе** (по умолчанию это модель **Предсказание следующего сообщения**). Новая пауза останавливает предыдущий запрос. В чате ничего не сохраняется. Переключатель хранится в `$DSH_HOME/storages/dsh-composer-plus/complete.json` (файл доступен только владельцу).
168
188
  - **Улучшить промпт:** ничего не запускается, пока вы не нажмёте волшебную палочку. Затем Host-часть одним запросом отправляет модели, выбранной для **Улучшить промпт** (по умолчанию это модель самого чата), ваш черновик, ваши собственные сообщения в чате и текстовые ответы агента (без вывода инструментов, скрытого контекста, рассуждений и сообщений, убранных откатом; не более примерно 6 000 символов, самую новую часть), ту же сводку проекта, что и **Идеи функций** (с теми же правилами для файлов: без `.env*` и файлов ключей, без символических ссылок за пределы папки, без FIFO), пути, которые `git status` показывает как изменённые, и до 30 отслеживаемых или неотслеживаемых (не игнорируемых) путей, в именах которых есть слова из вашего черновика. Другое содержимое файлов, кроме этой сводки, не отправляется. В чат и в проект ничего не записывается: ответ только заменяет ваш черновик в поле ввода, а отправлять ли его, решаете вы. Выбранная модель хранится в `$DSH_HOME/storages/dsh-composer-plus/improve.json` (файл доступен только владельцу).
169
189
  - **Проверка цели:** запускается, только когда агент в автоматическом раунде отмечает `/goal` как выполненную (или когда вы нажимаете **Запустить сейчас**). Host-часть запускает тестовую команду в папке чата в режиме песочницы этого чата (как собственный инструмент `bash` в dsh: та же политика доступа к файлам; если эта песочница не может запуститься, тест не запускается и проверка не пройдена). Чтобы найти команду, она читает только `package.json`, `Makefile`, `Cargo.toml`, `go.mod`, `pyproject.toml` и `pytest.ini`, как обычные файлы внутри папки (без символических ссылок за пределы папки, без FIFO). Затем она одним запросом без инструментов отправляет модели, выбранной для **Проверка цели** (по умолчанию это модель самого чата), цель, чат с момента начала цели (ваши сообщения, ответы агента, вызовы инструментов, обрезанные до 1 000 символов, и последние 2 000 символов каждого результата инструмента; без рассуждений и шагов, убранных откатом; не более примерно 60 000 символов, самую новую часть), `git status --short` и конец вывода теста. Вывод инструментов может содержать то, что прочитал агент, поэтому в этом запросе могут быть части ваших файлов, как и в самом чате. В чат и в проект ничего не записывается. Ваша тестовая команда, лимиты, последний результат (с концом его вывода) и выбранная модель хранятся в `$DSH_HOME/storages/dsh-composer-plus/goal-check.json` (файл доступен только владельцу, последние 500 чатов).
170
190
  - **Продолжить в новом чате:** ничего не запускается, пока вы не нажмёте этот пункт. Затем Host-часть отправляет чат (так, как его читает Проверка цели: без рассуждений и шагов, убранных откатом) собственной модели чата и показывает заметку для передачи; новый чат создаёт только **Начать новый чат**. В проект ничего не записывается.
171
191
  - **Состав контекста:** Host-часть читает только журнал чата; без вызова модели и без файлов проекта.
172
- - **Доска задач:** доска показывает чаты dsh из собственных списков dsh в этом окне; своих данных о чатах она не добавляет. **Новая задача** открывает собственный новый чат dsh, и вы пишете первое сообщение в поле ввода dsh, поэтому подтверждения, песочница и модель чата действуют как обычно. Host-часть сохраняет первое сообщение этого чата как промпт карточки и отправляет его (первые 4 000 символов, больше ничего) модели этого чата ещё одним запросом, без инструментов, чтобы получить до 3 тегов. Промпт, теги и время запуска каждой задачи хранятся в `$DSH_HOME/storages/dsh-composer-plus/board-chats.json` (файл доступен только владельцу, последние 2 000); переключатель хранится рядом, в `board-switch.json`. В папку проекта ничего не записывается. **Ответить** отправляет ваш ответ в ожидающий запрос dsh так же, как это делает карточка в самом чате. Старый список задач прежних версий (`board.json`) остаётся на диске без изменений и не читается. **Ход работы при наведении** читает журнал чата на этом Mac. В режиме **Быстро (без ИИ)** (по умолчанию) ничего не отправляется. В режиме **Сводка ИИ**, пока видно окно хода работы у работающей карточки (или пока доска в Tether открыта, не более чем для 8 работающих карточек), часть Host отправляет самую новую часть этого чата (не более примерно 6 000 символов: ваши сообщения, текстовые ответы агента, его вызовы инструментов и конец их результатов; без рассуждений и сообщений, убранных откатом) модели чата одним запросом без инструментов. Снова она отправляет только после того, как чат продвинулся, и не чаще одного раза в 20 секунд для каждого чата. Заметка хранится только в памяти; настройка хранится в `$DSH_HOME/storages/dsh-composer-plus/board-progress.json` (файл доступен только владельцу).
192
+ - **Доска задач:** доска показывает чаты dsh из собственных списков dsh в этом окне; своих данных о чатах она не добавляет. **Новая задача** открывает собственный новый чат dsh, и вы пишете первое сообщение в поле ввода dsh, поэтому подтверждения, песочница и модель чата действуют как обычно. Host-часть сохраняет первое сообщение этого чата как промпт карточки и отправляет его (первые 4 000 символов, больше ничего) модели этого чата ещё одним запросом, без инструментов, чтобы получить до 3 тегов. Промпт, теги и время запуска каждой задачи хранятся в `$DSH_HOME/storages/dsh-composer-plus/board-chats.json` (файл доступен только владельцу, последние 2 000), а также идентификаторы чатов, которые вы убрали с доски кнопкой **×** или **Очистить всё** (последние 5 000); переключатель хранится рядом, в `board-switch.json`. В папку проекта ничего не записывается. **Ответить** отправляет ваш ответ в ожидающий запрос dsh так же, как это делает карточка в самом чате. Старый список задач прежних версий (`board.json`) остаётся на диске без изменений и не читается. **Ход работы при наведении** читает журнал чата на этом Mac. В режиме **Быстро (без ИИ)** (по умолчанию) ничего не отправляется. В режиме **Сводка ИИ**, пока видно окно хода работы у работающей карточки (или пока доска в Tether открыта, не более чем для 8 работающих карточек), часть Host отправляет самую новую часть этого чата (не более примерно 6 000 символов: ваши сообщения, текстовые ответы агента, его вызовы инструментов и конец их результатов; без рассуждений и сообщений, убранных откатом) модели чата одним запросом без инструментов. Снова она отправляет только после того, как чат продвинулся, и не чаще одного раза в 20 секунд для каждого чата. Заметка хранится только в памяти; настройка хранится в `$DSH_HOME/storages/dsh-composer-plus/board-progress.json` (файл доступен только владельцу).
173
193
  - **Защищённые файлы:** список и переключатель хранятся в `$DSH_HOME/storages/dsh-composer-plus/protected-files.json` (файл доступен только владельцу). Проверка читает только путь каждого вызова файлового инструмента (и его реальный путь), но никогда не сам файл.
174
194
  - **Заблокированные команды:** правила и переключатель хранятся в `$DSH_HOME/storages/dsh-composer-plus/blocked-commands.json` (файл доступен только владельцу). Проверка читает только текст команды каждого вызова `bash` и `pwsh`; она ничего не запускает и ничего не отправляет.
175
- - **Память проекта:** выключена, пока вы её не включите. Когда она включена, после каждого завершённого хода чата верхнего уровня часть Host отправляет новые сообщения этого чата с момента последнего разбора (ваши сообщения и текстовые ответы агента; без вывода инструментов, рассуждений, скрытого контекста и сообщений, убранных откатом; в ответвлённом чате копия родительского чата не учитывается; не больше примерно 16 000 символов) и сохранённые заметки модели этого чата, одним запросом без инструментов. Заметки — это файлы Markdown в `$DSH_HOME/storages/dsh-composer-plus/memory/` (доступны только владельцу): `projects/<id>/` для каждой папки проекта (`<id>` — хеш реального пути папки; `project.json` указывает папку), `global/`, `journal.jsonl` (каждое изменение со строкой до и после) и `reviewed.json` (до какого места прочитан каждый чат). В папку проекта ничего не записывается. Заметки, похожие на ключ, токен, пароль или номер документа, отклоняются. Заметки проекта попадают в системный промпт каждого нового чата в этой папке, поэтому уходят модели с каждым запросом этого чата. Переключатель хранится в `memory.json` там же. **Открыть память** ничего не отправляет, пока вы не нажмёте **Предпросмотр изменений**; тогда она отправляет показанные заметки и ваш текст модели dsh по умолчанию одним запросом без инструментов. Изменения записываются только по **Применить**, в журнале с `editor`. Tether читает и изменяет заметки через тот же маршрут.
195
+ - **Ввод секрета:** значение уходит из карточки (или из Tether через шлюз, который не записывает содержимое запросов) на Host только в запросе ответа. Host записывает его в `$DSH_HOME/storages/dsh-composer-plus/secrets/<случайное имя>` (папка 0700, файл 0600); ничего не попадает в проект, журнал чата или результат инструмента. Host хранит значение в памяти, чтобы заменять его на `[secret]` в следующих результатах инструментов этого чата. Файл и эта копия удаляются в конце хода чата и при запуске dsh. Переключатель находится рядом, в `secrets.json`. Команда, которую агент запускает с этим файлом, может отправить значение туда, куда отправляет эта команда: в этом и состоит цель.
196
+ - **Память проекта:** выключена, пока вы её не включите. Когда она включена, после каждого завершённого хода чата верхнего уровня часть Host отправляет новые сообщения этого чата с момента последнего разбора (ваши сообщения и текстовые ответы агента; без вывода инструментов, рассуждений, скрытого контекста и сообщений, убранных откатом; в ответвлённом чате копия родительского чата не учитывается; не больше примерно 16 000 символов) и сохранённые заметки модели этого чата, одним запросом без инструментов. Заметки — это файлы Markdown в `$DSH_HOME/storages/dsh-composer-plus/memory/` (доступны только владельцу): `projects/<id>/` для каждой папки проекта (`<id>` — хеш реального пути папки; `project.json` указывает папку), `global/`, `journal.jsonl` (каждое изменение со строкой до и после) и `reviewed.json` (до какого места прочитан каждый чат). В папку проекта ничего не записывается. Заметки, похожие на ключ, токен, пароль или номер документа, отклоняются. Заметки проекта попадают в системный промпт каждого нового чата в этой папке, поэтому уходят модели с каждым запросом этого чата. Переключатель хранится в `memory.json` там же. **Открыть память** ничего не отправляет, пока вы не нажмёте **Предпросмотр изменений**; тогда она отправляет показанные заметки и ваш текст модели dsh по умолчанию одним запросом без инструментов. Изменения записываются только по **Применить**, в журнале с `editor`. Tether читает и изменяет заметки через тот же маршрут. **История версий памяти** (включена по умолчанию) перед каждым сохранением кладёт копию файлов памяти в `memory/history/` рядом с ними (файлы только для владельца, 50 последних для каждой памяти); она ничего не отправляет модели. **Экспорт памяти в AGENTS.md** ничего не отправляет модели и пишет только после нажатия **Записать AGENTS.md**: он читает и пишет `AGENTS.md` в папке проекта этой памяти (только обычный файл внутри неё, никогда через символьную ссылку, ведущую наружу) и меняет только отмеченный раздел. **Поиск устаревших заметок памяти** ничего не отправляет модели и ничего не записывает: он проверяет пути внутри папки проекта через realpath (файлы не читаются), читает `package.json` только как обычный файл внутри папки и запускает там один `git for-each-ref`. **Не использовать память в этом чате** хранит каждый выключенный вами чат в `memory-chats.json` рядом (файл только для владельца, 500 последних); такой чат не отправляет модели никакой памяти. **Предложить заметки памяти из чата** ничего не отправляет, пока вы не нажмёте **Предложить для памяти**; затем он отправляет сохранённые заметки проекта чата и глобальные заметки, а также собственные сообщения и текстовые ответы чата (без вывода инструментов и откаченных сообщений; копия родителя в форке не отправляется; не больше примерно 24 000 символов) собственной модели чата одним запросом без инструментов. Предложение сохраняется только по **Принять**.
176
197
  - **Резервное копирование:** ничего не покидает ваш компьютер. Архивы сохраняются в `~/Desktop/dsh-backups` (файлы доступны только владельцу). Секретов в архиве нет: файлы учётных данных (`.credentials.yaml`, `.env`), файлы ключей (`.pem`, `.key`, `.p12`, `.pfx`) и значения настроек token, secret, password и API-ключей в файлах yml скрыты; их настоящие копии остаются в `composer-plus-vault/<archive>/` в той же папке (доступно только владельцу) и только на этом компьютере. **Для другого компьютера** не копирует vault: введите эти секреты там заново. Ваши журналы чатов, настройки и остальное содержимое домашней папки dsh лежат в архиве как есть: держите папку закрытой, как и сам `$DSH_HOME`. Резервное копирование читает файлы с `O_NOFOLLOW | O_NONBLOCK`; символическая ссылка сохраняется как ссылка (переход по ней не выполняется), а FIFO или устройство пропускается. Переключатель и настройки автоматического резервного копирования хранятся в `$DSH_HOME/storages/dsh-composer-plus/auto-backup.json`, переключатель аварийной консоли — в `rescue-console.json`, а пока dsh работает, `running/host-<pid>.json` указывает каждый процесс dsh (аварийная консоль читает эти файлы, чтобы отказать в восстановлении).
177
198
  - **Аварийная консоль:** меню в терминале; она не открывает сетевой порт. Восстановление пишет только в новую папку рядом с домашней папкой dsh (файлы — с `O_EXCL | O_NOFOLLOW`, символические ссылки — в последнюю очередь и без перехода по ним) и отклоняет архив с небезопасным именем (`..`, абсолютный путь), устройством или FIFO, более чем одной папкой верхнего уровня или записью внутри ссылки.
178
199
 
@@ -194,7 +215,7 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
194
215
  - **На строке чата нет метки ветки:** боковая панель не в режиме «Одним списком» (в режимах «По рабочей области» и «Дерево рабочих областей» ни одна строка чата не показывает метку), у чата не было хода с момента установки этой версии, его папка не является репозиторием git, или функция **Ветка Git в строках чатов** выключена. После обновления перезапустите dsh (ветку записывает Host-часть).
195
216
  - **Проверка цели сообщает, что тест завершился с кодом 127 или «not found»:** у dsh, запущенного из Finder или Dock, PATH может быть короче, чем в вашем терминале, поэтому он не находит `npm`, `pnpm` или `cargo`. Запустите dsh из терминала или задайте свою тестовую команду с полным путём в **Проверка цели** → **Изменить**. **Запустить сейчас** сразу показывает результат.
196
217
  - **Цель не закрывается, и агент продолжает работать:** **Проверка цели** нашла непройденный тест или недоделанную работу; строка под целью показывает причину (наведите указатель на результат, чтобы увидеть подробности). Исправьте причину или тестовую команду либо завершите цель сами командой `/goal` или через панель цели (это не проверяется).
197
- - **Установка не удаётся сразу после выпуска:** укажите версию (`dsh-composer-plus@1.20.0`), см. примечание об установке выше.
218
+ - **Установка не удаётся сразу после выпуска:** укажите версию (`dsh-composer-plus@1.21.0`), см. примечание об установке выше.
198
219
  - **Кнопка «Создать копию сейчас» сообщает «Уже выполняется другое действие с резервными копиями»:** действие выполняется в другом окне dsh или в аварийной консоли (они используют общий файл блокировки `.composer-plus.lock` в папке резервных копий). Дождитесь его окончания. Если никакое действие не выполняется, блокировку закрытого процесса перехватит следующее нажатие.
199
220
  - **Аварийная консоль сообщает «dsh is running»:** сначала выйдите из dsh. Если dsh действительно закрыт, файл, названный в сообщении, остался после сбоя: удалите его и повторите попытку.
200
221
  - **После восстановления dsh не запускается или не хватает плагина:** пакеты плагинов профиля нужно установить заново. Аварийная консоль предлагает это после восстановления; или выполните `pnpm install` в каждой папке внутри `$DSH_HOME/profiles/`, которую она перечисляет. Секреты, которых не было в vault (другой компьютер), нужно ввести заново: консоль перечисляет их.
@@ -215,11 +236,17 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
215
236
  - В очереди dsh нет действия `move`, поэтому Host-часть плагина перемещает само сообщение в очереди dsh (одно изменение, то же самое сообщение). Сообщения с изображениями или файлами тоже перемещаются. Перемещаются только ваши собственные сообщения: раунд цели или ответ на вопрос в очереди остаётся на своём месте. Если сообщение начинает отправляться, пока вы перетаскиваете, ничего не перемещается, и об этом сообщает уведомление.
216
237
  - dsh 0.2.1 загружает обновление сразу, если новая версия не меняет никаких настроек dsh; в остальных случаях, а также в dsh 0.2.0, перезапустите dsh, чтобы загрузить его. Плагин никогда не перезапускает dsh за вас. Профили Web/CLI без менеджера плагинов dsh только сообщают о новой версии.
217
238
  - **Что нового в Composer Plus N** показывает примечания на языке из **Язык приложения**. Язык интерфейса с другим регионом получает примечания своего основного языка (`en-GB` — английские, `zh-TW` — китайские примечания `zh`). Для языка без примечаний (его добавляет другой языковой пакет, или это `pt-PT`, а не `pt-BR`) показываются английские примечания. Примечания приходят вместе с новой версией. Если у запущенной копии нет читаемого файла примечаний (`release-notes.json`), окно показывает английские примечания с GitHub.
239
+ - **Отклонить с примечанием** отправляет примечание как сообщение в ожидающий ход, а затем отклоняет запрос; dsh показывает примечание в чате как ваше сообщение. Пока поле примечания открыто, карточка показывает только **Отмена** и **Отклонить**, поэтому щелчок не может по ошибке разрешить запрос; `Esc` или **Отмена** возвращает кнопки dsh. Пустое примечание ничего не отправляет (используйте собственную кнопку **Отклонить** в dsh). Если отклонить запрос не удалось уже после отправки примечания (например, на запрос тем временем ответили в другом месте), примечание остаётся в чате, и модель прочитает его на своём следующем шаге. Кнопка встраивается в разметку карточки одобрения dsh (`data-approval-key`), потому что в dsh нет места для действий карточки; если обновление dsh изменит эту разметку, кнопка не появится, а собственная кнопка **Отклонить** в dsh работает как раньше. Примечание может содержать не более 4 000 символов.
240
+ - **Ввод секрета** скрывает только точный текст значения: в следующих результатах инструментов того же чата его заменяет `[secret]`. Агент всё равно может прочитать файл командой shell и вывести значение в другой форме (base64, часть значения, с пробелами), и эта форма дойдёт до модели. Собственные файловые инструменты агента (read, grep, write, edit) не могут открыть папку секретов. Если значение — ещё и частое слово, другие результаты этого чата тоже покажут `[secret]`. Файл хранится до конца хода; если dsh закроется во время хода, следующий запуск удалит его. В чате может быть только один открытый запрос одновременно. Инструмент добавляет к каждому запросу к модели около 870 символов (примерно 220 токенов, оценка): выключите его, если не пользуетесь.
241
+ - **Цитата в ответе** цитирует текст так, как его показывает страница: блок кода, таблица или список приходят простыми строками, без разметки Markdown. Если выделение начинается в одном ответе и заканчивается в другом или задевает рассуждения, строку инструмента или ваше собственное сообщение, кнопка не появится: выделяйте внутри одного ответа. Кнопка находит ответ по структуре чата dsh, потому что в dsh нет слота для выделения текста; если обновление dsh изменит эту структуру, кнопка не появится. Если цитата стоит в конце поля, после неё добавляется ещё одна пустая строка, чтобы следующая строка начиналась ниже; при отправке dsh удаляет пустые строки в конце.
242
+ - **Побочный чат** работает только на чтение благодаря собственному режиму только чтения dsh: файловые инструменты не могут писать, а команды оболочки выполняются в песочнице dsh без записи (или не выполняются, если песочница не может запуститься). Агент всё же может запросить больше доступа через карточку подтверждения dsh, а сетевой вызов (например, запрос к API) всё же может изменить что-то за пределами компьютера. Копия делается на самый новый момент, когда в очереди не ждало ни одного сообщения, поэтому вопрос, заданный, пока сообщения ждут в очереди, не видит того, что было после них. Выполняемый шаг чата в копии закрывается, поэтому побочный чат знает начало этого шага, но не его результат. Побочный чат — обычный чат: он остаётся на боковой панели и учитывается в использовании модели; архивируйте его там. «Вернуть» берёт только собственные сообщения побочного чата (не более 12 000 символов) и только последний ответ на каждый вопрос; заметки агента между вызовами инструментов не попадают. dsh не даёт плагинам места для чата на правой боковой панели, поэтому побочный чат открывается в основном виде.
243
+ - **Заметки к diff** работают только на панели изменений, а не в представлении «Последний ход» dsh. Диапазон должен оставаться в одном блоке diff (в одной части `@@`). Заметки хранятся в хранилище этого браузера, поэтому другой браузер или dsh на другом компьютере их не видит; Tether хранит свои заметки в памяти. Заметка сохраняет строки такими, какими они были в момент щелчка: если агент потом изменит файл, заметка покажет старые строки и номера. Не более 50 заметок на чат, 2 000 символов и 40 строк на заметку (дальше строка `…`).
218
244
  - **Разрешить для этого чата** отсчитывает лимит времени с момента выдачи разрешения. Новый лимит времени сразу применяется к действующим разрешениям, поэтому более короткий лимит может сразу их завершить. У разрешений из версии 1.12 и более ранних нет времени: после обновления агент ещё раз спросит об этих инструментах.
219
245
  - **Сохранять фокус в поле ввода** возвращает фокус только после команды `/` или навыка. Пока dsh обрабатывает команду, поле ввода несколько миллисекунд доступно только для чтения, поэтому клавиши, нажатые в это время, теряются. Если меню `/` в dsh ещё открыто, `Enter` выбирает выделенную строку и ничего не отправляет.
220
246
  - **Подгонять карточку вопроса под окно** меняет только карточку вопроса dsh, а не карточку проверки плана. Она находит карточку по разметке dsh (`data-question-key`, `data-question-scroll`); если обновление dsh изменит эту разметку, карточка будет выглядеть так, как её рисует dsh. Высота карточки следует за окном, а не за чатом: в чате в узкой боковой панели высокая карточка всё ещё может выходить выше чата.
221
247
  - **Подогнать заголовок чата под окно** находит заголовок чата dsh по его сгенерированным именам классов (`_titleRow`, `_titleCluster`, `_crumbs`, `_headerActions`, `_headerUtilities`), потому что dsh не даёт точки подключения для его раскладки. Если обновление dsh переименует их, заголовок показывается так, как его рисует dsh. В очень узкой колонке чата заголовок может занять две или три строки, и места над сообщениями становится меньше.
222
- - **Мобильное подключение** работает только в macOS (оно использует `en0`, `openssl`, `swift` и `dns-sd`). Оно использует фиксированные порты 19390 и 19391, поэтому на каждом Mac его может одновременно запускать только один dsh (каждый Mac — одна запись в списке Mac на телефоне). Телефон получает уведомления, только пока Tether открыт или только что ушёл в фон (сервиса push-уведомлений нет). Tether отправляет их только после того, как вы включите в Tether «Settings → Notifications → Send notifications». По умолчанию этот переключатель выключен, а разрешение iOS запрашивает в момент включения. Приложения для iOS пока нет в App Store: соберите его из `tether/ios` в Xcode. «Tailscale only» всё равно требует адрес Wi-Fi или Ethernet на Mac (шлюз запускается только при таком адресе). Журнал доступа у каждого Mac свой и хранит только 200 самых новых попыток; повторная попытка в течение минуты увеличивает счётчик той же строки на один. Блокировка приложения Tether не скрывает превью уведомлений на экране блокировки iPhone: выключите их в настройках iOS. Зелёные точки в Tether следуют за Mac: у чата, который вы открыли в dsh, точка пропадает и на телефоне. У чата, который вы открыли в Tether, точка пропадает только на телефонах. Собственная точка dsh на Mac остаётся, пока вы не откроете чат на Mac.
248
+ - **Мобильное подключение** работает только в macOS (оно использует `en0`, `openssl`, `swift` и `dns-sd`). Оно использует фиксированные порты 19390 и 19391, поэтому на каждом Mac его может одновременно запускать только один dsh (каждый Mac — одна запись в списке Mac на телефоне). Телефон получает уведомления, только пока Tether открыт или только что ушёл в фон (сервиса push-уведомлений нет). Tether отправляет их только после того, как вы включите в Tether «Settings → Notifications → Send notifications». Tether хранит этот переключатель и его часы отдельно для каждого сопряжённого Mac. По умолчанию он выключен на каждом Mac, а разрешение iOS запрашивает в момент включения. Приложения для iOS пока нет в App Store: соберите его из `tether/ios` в Xcode. «Tailscale only» всё равно требует адрес Wi-Fi или Ethernet на Mac (шлюз запускается только при таком адресе). Журнал доступа у каждого Mac свой и хранит только 200 самых новых попыток; повторная попытка в течение минуты увеличивает счётчик той же строки на один. Блокировка приложения Tether не скрывает превью уведомлений на экране блокировки iPhone: выключите их в настройках iOS. Зелёные точки в Tether следуют за Mac: у чата, который вы открыли в dsh, точка пропадает и на телефоне. У чата, который вы открыли в Tether, точка пропадает только на телефонах. Собственная точка dsh на Mac остаётся, пока вы не откроете чат на Mac.
249
+ - **Удалённые компьютеры** требуют Tailscale на обоих Mac и Composer Plus с включённой функцией на Mac, который вы открываете. Этот Mac не должен быть в режиме сна, и на нём должен работать dsh. Другой компьютер открывается на вкладке «Браузер» правой боковой панели чата, который сейчас на экране. Вкладка принадлежит этому чату, поэтому другой чат показывает свою боковую панель. Без чата (или в dsh web без вкладки «Браузер») компьютер открывается в окне браузера. Меню выбора компьютера видно, только когда в основной области открыт чат или экран нового чата. На доске задач его нет. Функция использует порт 19392 (на каждом Mac пускать другие компьютеры может только один dsh). У компьютера, который вы открыли внутри страницы другого компьютера, нет меню выбора, поэтому оттуда нельзя открыть третий Mac.
223
250
  - Ссылка на сеанс работает внутри чатов; щелчок по ней не открывает чат. Ссылка, созданная через **Копировать ссылку на сообщение**, открывает своё сообщение только в dsh 0.2.1 и новее и только из сообщения в чате (в dsh 0.2.0 нет правил для пользовательского текста, поэтому там ссылка копируется, но показывается как обычный текст). Сообщение, которое убрал откат или которое сжатие удалило из истории, загружаемой dsh, показать нельзя: ссылка тогда сообщает об этом. Кнопки 🔗 привязаны к строкам сообщений dsh; если обновление dsh изменит эту разметку, они не появятся.
224
251
  - **Отметить все как прочитанные** меняет собственные точки непрочитанного dsh через часть dsh, которая не является публичным API (список `completionUnread` в состоянии сеансов dsh). Если обновление dsh переименует его, пункт не появится. Пункт добавляется в меню «…» проекта в dsh, где нет места для плагинов; если dsh изменит это меню, пункт тоже не появится.
225
252
  - **Правка сообщения в очереди на месте** не меняет сообщение, которое тем временем начало отправляться, и не перезаписывает сообщение, которое тем временем изменилось (например, в Tether на iPhone): об этом сообщает уведомление. Для нового изображения нужна модель, которая принимает изображения (действуют собственные ограничения dsh на изображения), а новый файл должен загрузиться до того, как вы сможете сохранить. Изменять можно только свои сообщения в очереди: раунд цели или ответ на вопрос в очереди изменить нельзя. После обновления плагина сразу работает только правка текста: перезапустите dsh, прежде чем сохранять сообщение с изображениями или файлами (Host-часть загружается при запуске).
@@ -234,6 +261,8 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
234
261
  - **Ветки в дереве рабочих областей** пишет в git без клика: при переносе чата он возвращает папку проекта на прежнюю ветку (`git switch`) и добавляет worktree (`git worktree add`). Он никогда не удаляет ветку, worktree или файл. dsh не может сменить папку чата, поэтому перенесённый чат — это копия (собственный форк dsh с новым id), а старый чат архивируется. Копия продолжает остановленную задачу; вызов инструмента, который шёл в момент появления ветки, завершается отказом, и агент запускает его снова в новой папке. Цель старого чата не переносится. Переносится только чат, чья папка — главная папка репозитория, и только ради ветки, которую он создал и на которую переключился в этом ходе (`git switch -c`, `git checkout -b`): ветка, созданная только через `git branch`, папка с незакоммиченными изменениями, связанный worktree или подпапка ничего не переносят. В дереве показываются только worktree прямо в `<project>/.worktrees/` с веткой; отсоединённый (detached) worktree или worktree в другом месте не показывается. Копия открывается сама, только если её чат был открытым (плагин читает это из строки боковой панели dsh); иначе она находится в проекте ветки.
235
262
  - **Поиск в чате** ищет только в том, что показывает страница: в загруженных сообщениях и ответах (для более старых прокрутите вверх или нажмите **Загрузить более ранние**), но не в закрытых шагах инструментов и не в свёрнутом тексте вывода инструмента. Он считает не более 2 000 совпадений (дальше — «2000+»). Он использует API подсветки браузера (Chromium 105 и новее; в настольном приложении он есть): в более старом браузере счётчик и переходы работают без цвета. `Cmd+F` на Mac (`Ctrl+F` в Windows и Linux) открывает его, только пока на экране есть чат; в других местах встроенный поиск браузера работает как раньше. На Mac `Ctrl+F` сохраняет своё действие macOS в текстовых полях (курсор сдвигается на один символ вперёд).
236
263
  - **Открывать ожидающий чат при бездействии** знает только то, что видит окно dsh: работа в другом приложении не считается, поэтому, когда dsh в фоне, функция может открыть ожидающий чат через 30 секунд. Окно dsh при этом не выходит на передний план. Чтение без нажатия клавиш, щелчков и движений мыши считается бездействием. Функция смотрит только на чаты с оранжевой точкой dsh (вопрос, одобрение или проверка плана) или с зелёной точкой (завершённый ход, который вы ещё не открыли); запрос субагента показывается в его родительском чате. Оранжевые чаты открываются первыми. Открытие зелёного чата убирает его точку, поэтому 30 секунд следующего зелёного чата начинаются только после вашего следующего нажатия клавиши, щелчка, движения мыши, прокрутки колесом или касания: когда вы вернётесь, остальные зелёные точки останутся на месте. Пока ожидающий чат на экране, другой не открывается; чат, из которого вы ушли без ответа, может открыться снова после следующих 30 секунд бездействия. 30 секунд изменить нельзя.
264
+ - **Следующий ожидающий чат** считает те же чаты, что и **Открывать ожидающий чат при бездействии**: оранжевую точку dsh (вопрос, одобрение или проверка плана, на которые можно ответить здесь) и зелёную точку (завершённый ход, который вы ещё не открывали); запрос субагента показывается в его родительском чате. dsh не сохраняет, когда чат начал ждать, поэтому порядок считается с момента, когда это окно его увидело: после перезагрузки уже ожидавшие чаты сохраняют порядок dsh. Клавиша — это сочетание клавиш dsh: в браузере в Linux у неё нет клавиши, пока вы не зададите её на странице сочетаний клавиш dsh, а расширение браузера или другое приложение может перехватить `Cmd+Shift+E` раньше. В заголовке боковой панели dsh нет места для расширений, поэтому кнопка встраивается в разметку этого заголовка. Если обновление dsh её изменит, кнопка не появится, а клавиша продолжит работать. В узкой боковой панели кнопки нет.
265
+ - **Кнопки вариантов** читает только ответы, которые заканчиваются списком вариантов: нумерованным списком из 1–9 пунктов, с нумерацией от 1, в самом конце ответа, сразу под заголовком или жирной строкой «Варианты» или «Следующие шаги» (или английскими словами «Options», «Choices» и «Next steps» и теми же словами на других языках приложения). Список в середине ответа, в блоке кода или под другим заголовком кнопок не получает. Composer Plus не просит агента писать такой список. Кнопки появляются только под самым новым ответом, пока чат простаивает и поле сообщения пусто, и только когда Composer Plus знает, какие ответы отозвал откат. На карточке вопроса dsh клавиши 1–9 ничего не делают первые 0,8 секунды после появления вопроса, чтобы клавиша, нажатая для другого действия, не выбрала вариант, который вы не прочитали. У карточки вопроса dsh нет API для клавиш, поэтому клавиши находят кнопки карточки в разметке dsh. Если обновление dsh изменит эту разметку, клавиши ничего не делают.
237
266
  - Уведомление, отправленное до перезапуска, при щелчке только выводит dsh на передний план.
238
267
  - Активные проекты перемещаются через сохранённый порядок проектов dsh, поэтому новый порядок сохраняется после перезапуска. Чаты вне проектов («Без группы») перемещать нельзя; dsh всегда показывает их последними.
239
268
  - В меню параметров просмотра на боковой панели у dsh нет точки расширения, поэтому пункт фильтра недавних проектов добавляется во встроенное меню dsh. Если обновление dsh изменит это меню, пункт не появится, и все проекты останутся видны. Фильтр работает со строками проектов, поэтому режим **Одним списком** не фильтруется. В режиме **Дерево рабочих областей** родительская папка остаётся видна, пока активен проект внутри неё, а строки чатов, которые не были активны за последние 2 часа, тоже скрываются; в режиме **По рабочей области** фильтруются только строки проектов. Фильтр узнаёт текущий вид dsh из сохранённой настройки вида dsh (это не публичный API); если обновление dsh её переименует, **Дерево рабочих областей** фильтруется как **По рабочей области**. Функция «Статус проекта» читает ту же настройку: в режиме **Дерево рабочих областей** строка родительской папки учитывает и чаты проектов внутри неё; если dsh переименует настройку, каждая строка показывает только свои чаты. У **По состоянию** ограничение того же рода: в dsh нет места для своего порядка сортировки, поэтому пункт и порядок строк привязаны к разметке меню и списка dsh.
@@ -249,9 +278,16 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
249
278
  - **Продолжить в новом чате** отправляет чат (сообщения, вызовы инструментов и конец каждого результата инструмента, не более примерно 60 000 символов, самую новую часть) собственной модели чата. Заметка для передачи может пропустить решение или файл: прочитайте её перед запуском. Новый чат знает только заметку и связанный чат (dsh прикрепляет старый чат как контекст только для чтения); его контекст модели начинается с малого, а старый чат остаётся как есть. Для одного чата одновременно идёт только одна заметка или один запуск.
250
279
  - **Состав контекста** показывает оценки по собственному правилу dsh (около 4 символов на токен), тому же правилу, что и у кольца контекста dsh; собственный подсчёт модели может отличаться. Определения инструментов взяты из самого нового запроса. Функция показывает контекст так, как он записан в журнале чата; ход, который идёт сейчас, появляется после своего следующего шага.
251
280
  - **Запланированные шаги** экономят токены, только когда модель действительно планирует: пока функция включена, каждый запрос несёт инструмент `plan_next_steps` и короткую инструкцию (около 500 токенов), даже в чатах, где модель никогда не планирует. Условие доказывает только то, что в нём сказано (например: код выхода сборки был 0), а не то, что работа сделана верно. `ok` читает собственные отметки результата dsh (`[exit code: N]`, тайм-ауты, отказы песочницы); команда, которая завершилась неудачей без ненулевого кода выхода, считается успешной. Шаги выполняются по одному; два шага, готовые одновременно, возвращаются модели. Сообщение шага сохраняется как сообщение ассистента модели чата (в dsh нет отметки для сообщения, написанного плагином), поэтому его текст говорит, что шаг запустил Composer Plus. В Tether нет.
252
- - **Доска задач** показывает чаты, которые dsh перечисляет в этом окне: чат вне проекта виден только в **Все проекты**, а папка ветки для каждого чата (`<project>/.worktrees/<name>`) считается частью своего проекта. Колонка карточки — это живое состояние чата, поэтому карточки нельзя перетаскивать: чат переходит в **Готово**, когда его ход заканчивается, в том числе после ошибки или остановки, и возвращается в **В работе**, когда снова запускается. Зелёная точка — это собственная точка завершения dsh, которую dsh хранит только в этом окне: после перезагрузки завершённые чаты показываются без неё. **Готово** показывает 50 последних чатов (**Показать более старые: N** показывает остальные). **Поиск проектов** находит проект только по названию, а не по пути к его папке. **Активные за последние 2 часа** скрывает проект, если каждый его чат старше 2 часов, неактивен и прочитан; доска всё равно показывает выбранный вами проект. **Новая задача** помнит только последний новый чат этого окна: если вы открываете другой чат до первого сообщения, тот чат остаётся в **К выполнению** как **Новая задача**, пока вы в нём не напишете, но доска возвращается сама только для последнего. После перезагрузки новый чат без сообщения не показывается на доске (dsh хранит его как свой пустой «Новый сеанс»). Теги берутся из одного вызова модели на каждую задачу, по её первому сообщению: они могут быть ошибочными, а у чата, который вы начали не на доске, их нет. Название — это собственное название чата в dsh (служба названий dsh, с моделью чата); пока его нет, карточка показывает первую строку первого сообщения. **Ответить** отвечает только на последний запрос чата: если на него уже ответили в другом месте (другое окно, Tether, автопроверка) или чат спрашивает что-то новое, панель сообщает об этом и ничего не отправляет. В прежних версиях был список задач с комментариями и инструментами для агентов; их больше нет, а старый `board.json` не показывается. Идея и внешний вид взяты из [Kanzo](https://github.com/emanuele-em/kanzo) от emanuele-em (AGPL-3.0); Composer Plus не использует его код.
281
+ - **Доска задач** показывает чаты, которые dsh перечисляет в этом окне: чат вне проекта виден только в **Все проекты**, а папка ветки для каждого чата (`<project>/.worktrees/<name>`) считается частью своего проекта. Колонка карточки — это живое состояние чата, поэтому карточки нельзя перетаскивать: чат переходит в **Готово**, когда его ход заканчивается, в том числе после ошибки или остановки, и возвращается в **В работе**, когда снова запускается. Зелёная точка — это собственная точка завершения dsh, которую dsh хранит только в этом окне: после перезагрузки завершённые чаты показываются без неё. **Готово** показывает 50 последних чатов (**Показать более старые: N** показывает остальные). **Поиск проектов** находит проект только по названию, а не по пути к его папке. **Активные за последние 2 часа** скрывает проект, если каждый его чат старше 2 часов, неактивен и прочитан; доска всё равно показывает выбранный вами проект. **Новая задача** помнит только последний новый чат этого окна: если вы открываете другой чат до первого сообщения, тот чат остаётся в самом верху колонки **В работе** как **Новая задача**, пока вы в нём не напишете, но доска возвращается сама только для последнего. После перезагрузки новый чат без сообщения не показывается на доске (dsh хранит его как свой пустой «Новый сеанс»). Теги берутся из одного вызова модели на каждую задачу, по её первому сообщению: они могут быть ошибочными, а у чата, который вы начали не на доске, их нет. Название — это собственное название чата в dsh (служба названий dsh, с моделью чата); пока его нет, карточка показывает первую строку первого сообщения. **×** и **Очистить всё** только убирают карточки с доски: ни один чат не удаляется. Кнопка **Отменить** видна только 8 секунд и только в этом окне; позже карточку возвращает **Убранные (N)** → **Вернуть на доску**, а чат, который снова запускается, возвращается сам. **Очистить всё** сначала спрашивает и убирает прочитанные завершённые карточки показанного проекта (при **Все проекты** — всех проектов), в том числе те, что скрыты за **Показать более старые: N**; непрочитанная (зелёная) карточка остаётся. dsh хранит свою зелёную точку только в этом окне, поэтому после перезагрузки «Очистить всё» может убрать карточку, ответ в которой вы не прочитали. Список хранится на этом Mac и действует для всех окон и для Tether; когда в нём 5 000 чатов, самые старые возвращаются. **Ответить** отвечает только на последний запрос чата: если на него уже ответили в другом месте (другое окно, Tether, автопроверка) или чат спрашивает что-то новое, панель сообщает об этом и ничего не отправляет. В прежних версиях был список задач с комментариями и инструментами для агентов; их больше нет, а старый `board.json` не показывается. Идея и внешний вид взяты из [Kanzo](https://github.com/emanuele-em/kanzo) от emanuele-em (AGPL-3.0); Composer Plus не использует его код. `Cmd+Shift+K` — сочетание клавиш dsh: в браузере на Linux у него нет клавиши по умолчанию (задайте её на странице сочетаний клавиш dsh), а расширение браузера или другое приложение может перехватить её раньше. Карточка уходит из **Готово**, когда исчезает зелёная точка dsh (вы открыли чат), а для чата, который завершился за доской, будучи открытым чатом, — когда этот чат показан без панели поверх него. Это состояние «прочитано» хранится только в этом окне dsh, как и точки dsh: после перезагрузки или в другом окне каждый завершённый чат считается прочитанным и находится в **Недавно завершённые**.
253
282
  - **Приоритет сообщения после остановки** работает только после того, как вы остановили чат (или после хода с ошибкой, или когда вы открываете чат, у которого ещё есть очередь): сообщение, отправленное во время хода, по-прежнему ждёт в конце очереди. Оно обгоняет только ваши собственные сообщения в очереди: если в очереди ждёт раунд цели или ответ на вопрос, остаётся порядок dsh. Функция читает часть dsh, которая не является публичным API (завершается ли ещё остановленный ход); если обновление dsh её переименует, сообщение встанет первым только после завершения этого хода. Чаты субагентов сохраняют порядок dsh.
254
283
  - **Память проекта** принадлежит первой папке чата (папке проекта dsh): чат, который меняет папку командой `cd`, сохраняет память своего первого проекта, а та же папка, открытая по другому пути к тем же файлам, использует ту же память. Чат замораживает свой раздел памяти при запуске, поэтому заметка, сохранённая позже, появляется со следующего чата (`memory_recall` находит её сразу). Разбор сохраняет только то, что решила сохранить модель: он может пропустить факт или сохранить неверный; проверьте их в **Открыть память** и измените там, или правьте файлы вручную, когда dsh закрыт. **Открыть память** отправляет заметки выбранного проекта и глобальные заметки (все проекты, если выбрано «Все заметки»; не больше примерно 60 000 символов, остальные только считаются и не могут измениться в этом запросе) и ваш текст модели dsh по умолчанию, а не модели чата. Предпросмотр хранится на Mac 30 минут и до перезапуска dsh; если за это время разбор или агент изменят заметки, **Применить** откажет, и нужно запросить предпросмотр снова. **Применить** сохраняет все изменения предпросмотра или ни одного: если одно изменение нельзя сохранить (например, MEMORY.md заполнен), заметки остаются как были, и показывается причина. Каждый завершённый ход с вашим сообщением стоит одного вызова модели; неудачный вызов перечитывает те же сообщения после следующего хода. Чаты субагентов не разбираются. Идея и формат файлов взяты из [DS Bot](https://github.com/Fei2411/DS-Bot) (Apache-2.0); Composer Plus не использует его код и никогда не читает и не записывает собственную память DS Bot.
284
+ - **История версий памяти** хранит 50 последних версий каждой памяти (каждого проекта и глобальной памяти); более старые удаляются. Версия хранит всю память проекта, а не одну заметку. **Восстановить** возвращает все файлы этой версии (включая темы) и отказывает, если память изменилась после открытия версии; память до восстановления становится новой версией, поэтому восстановление можно отменить. Пока переключатель выключен, новые версии не сохраняются и **Восстановить** отказывает; сохранённые версии остаются. Версий до появления этой функции нет: история начинается с первого сохранения после установки.
285
+ - **Экспорт памяти в AGENTS.md** записывает только заметки памяти одного проекта; глобальные заметки, источники и даты не записываются. Следующий экспорт заменяет весь отмеченный раздел, поэтому ручная правка внутри него теряется (diff сначала её покажет); текст вне меток остаётся. Если метки повреждены (одной нет или они повторяются), экспорт отказывает, пока вы их не исправите. AGENTS.md больше 512 кБ, символьная ссылка за пределы папки проекта и всё, что не является обычным файлом, отклоняются. Если AGENTS.md или заметки изменились после предпросмотра, **Записать AGENTS.md** отказывает, и вы экспортируете снова.
286
+ - **Ссылка на источник заметки памяти** работает для заметок, сохранённых после установки этой версии: более старая заметка указывает только чат (или ничего), поэтому **Источник** открывает только чат или не показывается. Если сообщения больше нет (его отозвал откат или чат удалён), чат откроется и уведомление скажет, что сообщения там нет.
287
+ - **Копировать память в другой проект** копирует не больше 100 заметок за раз и только в проект из списка dsh (читается собственный список проектов dsh; путь из окна не передаётся). Каждая копия независима: позднее изменение заметки в одном проекте не меняет копию. Если одна отмеченная заметка не помещается (MEMORY.md или тема в целевом проекте заполнены, или там уже 40 тем), ничего не копируется. Заметка, чей текст и тема уже есть в целевом проекте, пропускается, и показывается их число.
288
+ - **Поиск устаревших заметок памяти** находит только то, что заметка пишет в известном ему виде: путь во фрагменте кода (`src/cart.ts`), скрипт npm после `npm run` (или `npm test`, `pnpm lint`), имя ветки во фрагменте кода рядом со словом «ветка». Путь за пределы папки проекта не сообщается; скрипт проверяется, только если в проекте есть `package.json`, ветка — только в репозитории git. За раз проверяется не больше 200 пунктов. Предупреждение значит «сейчас не найдено», а не «ошибка»: файл, который позже создаст сборка, тоже будет отмечен.
289
+ - **Не использовать память в этом чате** действует со следующего запроса этого чата к модели: уже идущий запрос сохраняет то, что у него есть. Переключение в идущем чате один раз меняет его системный промпт, поэтому этот один запрос не может использовать кэш поставщика модели. Субагент следует своему корневому чату. Проверка не читает сообщения, которые чат получает, пока его память выключена, даже если позже вы её снова включите. В dsh 0.2.0 на экране нового чата нет места для кнопки: она появляется в заголовке чата после первого сообщения.
290
+ - **Предложить заметки памяти из чата** показывает не больше 10 предложений и хранит их 30 минут и до перезапуска dsh; после этого при принятии вас попросят запросить предложения снова. Длинный чат отправляет свои последние сообщения: первыми отбрасываются самые старые ответы агента. Предложение может быть неверным: прочитайте его перед принятием и используйте **Открыть память**, чтобы позже изменить заметку. Отклонённое предложение может появиться снова при следующем щелчке.
255
291
  - **Резервное копирование** использует одну постоянную папку, `~/Desktop/dsh-backups` (папку dsh-backup по умолчанию, поэтому его архивы остаются пригодными); настройки для другой папки нет. Архив примерно такого же размера, как домашняя папка dsh без `cache/` и `dsh-runtimes/` (измерено: из 1,6 ГБ файлов получился архив 830 МБ примерно за 30 с на Apple Silicon; dsh при этом отвечал). Файл, который меняется во время чтения, сохраняется в том виде, в каком он был, когда резервное копирование его открыло, поэтому журнал открытого чата может заканчиваться обрезанной записью, которую dsh исправляет при следующей записи. Скрытие находит секрет в файле yml по имени ключа в одной строке (`token:`, `apiKey:`, …); секрет в потоковом словаре (`{token: x}`), в списке под таким ключом, в файле JSON (например, `apiKey` сервера MCP в файле `.json`) или под другим именем остаётся в архиве. Архивы dsh-backup по типам (`dsh-t-…`) не показываются в списке. **Для другого компьютера** копирует архив (в APFS — клон, без дополнительного места); vault с ним не копируется. **Создать копию сейчас** не удаляет ни одной резервной копии. Автоматическое резервное копирование хранит самые новые резервные копии, которые создал Composer Plus (настройка **Хранить** функции **Автоматическое резервное копирование**), и удаляет более старые из них; снимки перед обновлением считаются отдельно (остаются 2 самых новых). Архивы dsh-backup не удаляются никогда: уберите их кнопкой **Удалить**. Пока dsh-backup ещё установлен, он учитывает архивы Composer Plus в своём лимите хранимых копий и может их удалить.
256
292
  - **Восстановить** можно только в аварийной консоли, пока dsh закрыт: восстановление заменяет всю домашнюю папку dsh. Старая остаётся рядом как `.dsh.pre-restore-<time>`, пока вы её не удалите, поэтому на диске нужно место для обеих. Чаты сохраняют пути своих проектов: на другом компьютере проект по другому пути показывается как отсутствующий, пока вы не добавите его снова. Символические ссылки, которые указывают за пределы домашней папки dsh (например, навыки, подключённые ссылкой из другой папки), возвращаются как ссылки; их цели должны существовать на том компьютере.
257
293
  - **Проверка журналов сеансов** читает самый новый журнал каждого чата по собственным правилам dsh о том, что открывается: строка, которая не является JSON или стоит не по порядку, считается повреждением, только когда после неё идёт конец хода (иначе dsh открывает чат без строк начиная с этой, поэтому чат не попадает в список). Она не сверяет события журнала с собственными правилами событий dsh, поэтому журнал, который она считает исправным, всё равно может не открыться после обновления dsh. Исправление берёт копию из резервной копии: сообщения после этой резервной копии из чата пропадают (повреждённый файл остаётся рядом). Чат, открытый в этом dsh, в Настройках не исправляется: его удерживает dsh.
@@ -286,7 +322,13 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
286
322
 
287
323
  **Может ли агент помнить мои предпочтения между чатами, как память DS Bot?** Да, с функцией **Память проекта** (по умолчанию выключена): включите её в **Настройки → Composer Plus**. После каждого хода ваши постоянные предпочтения и решения сохраняются короткими заметками для проекта чата, и каждый новый чат этого проекта их читает. Попросите агента что-то запомнить, и он сразу сохранит это. Чтобы посмотреть или изменить заметки, нажмите **Открыть память** в той же строке и напишите, что изменить.
288
324
 
289
- **Можно ли видеть все мои чаты в виде канбан-доски и начинать с неё новые?** Да, с функцией **Доска задач** (по умолчанию включена): откройте её на левой боковой панели. Каждый чат — это карточка в **В работе**, **На проверке** (он ждёт вас) или **Готово**. **Новая задача** открывает новый чат dsh в проекте, а доска возвращается, когда ваше первое сообщение отправлено; нажмите **Ответить** на оранжевой карточке, чтобы ответить, не открывая чат.
325
+ **Я или ИИ неправильно изменили память. Можно вернуть старые заметки?** Да, с **История версий памяти** (включена по умолчанию): в **Открыть память** выберите проект, затем **История**. Выберите версию до изменения, чтобы увидеть, что вернётся, затем **Восстановить**.
326
+
327
+ **Можно поделиться памятью проекта с командой или другим инструментом агентов?** Да, с **Экспорт памяти в AGENTS.md** (включён по умолчанию): в **Открыть память** выберите проект, затем **Экспорт в AGENTS.md**. Проверьте diff, затем **Записать AGENTS.md**, и закоммитьте файл.
328
+
329
+ **Может ли ИИ предложить, что сохранить из длинного чата?** Да, с **Предложить заметки памяти из чата** (включено по умолчанию, пока включена **Память проекта**): нажмите **Предложить для памяти** в заголовке чата, затем **Принять** для заметок, которые стоит сохранить.
330
+
331
+ **Можно ли видеть все мои чаты в виде канбан-доски и начинать с неё новые?** Да, с функцией **Доска задач** (по умолчанию включена): откройте её на левой боковой панели. Каждый чат — это карточка в **В работе**, **На проверке** (он ждёт вас) или **Готово**. **Новая задача** открывает новый чат dsh в проекте, а доска возвращается, когда ваше первое сообщение отправлено; нажмите **Ответить** на оранжевой карточке, чтобы ответить, не открывая чат. **Очистить всё** в **Готово** сначала спрашивает и убирает с доски завершённые карточки, которые вы прочитали; **Отменить** и **Убранные (N)** возвращают их, а чаты остаются в dsh.
290
332
 
291
333
  **Может ли dsh создавать резервные копии моих чатов и настроек, как dsh-backup?** Да: **Настройки → Composer Plus → Резервное копирование → Создать копию сейчас**. Он записывает архив того же формата в ту же папку (`~/Desktop/dsh-backups`), поэтому архивы dsh-backup тоже показываются и восстанавливаются, а dsh-backup можно удалить. Чтобы копии создавались по расписанию, включите **Автоматическое резервное копирование**.
292
334
 
@@ -314,10 +356,22 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
314
356
 
315
357
  **Как запретить агенту запускать `npm publish` или `git push --force`?** **Настройки → Composer Plus → Заблокированные команды**: введите `npm publish`, выберите **блокировать** или **сначала спросить** и нажмите **Добавить**. Правило **блокировать** отклоняет команду, и агент спрашивает вас; правило **сначала спросить** каждый раз показывает карточку одобрения. «Защищённые файлы» охватывают файловые инструменты агента, а «Заблокированные команды» — его команды оболочки.
316
358
 
359
+ **Можно ли объяснить агенту, почему я отклонил вызов инструмента?** Да, с функцией **Отклонить с примечанием** (включена по умолчанию): нажмите **Отклонить с примечанием…** на карточке одобрения, напишите причину или что сделать вместо этого и нажмите **Отклонить**. Агент прочитает отказ и ваше примечание в том же ходе.
360
+
361
+ **Как передать агенту пароль или токен, не вводя его в чат?** С помощью функции **Ввод секрета** (включена по умолчанию): попросите агента использовать `request_secret` или дождитесь, когда он сам попросит. Введите значение в карточке в строке инструмента и нажмите **Сохранить**. Агент получает только путь к файлу со значением, а файл удаляется в конце хода.
362
+
363
+ **Как ответить только на часть длинного ответа?** Выделите эту часть и нажмите **Цитировать** над выделением (**Цитата в ответе**, включена по умолчанию). Часть попадёт в поле ввода как цитата `> …`, а ниже вы напишете ответ.
364
+
365
+ **Можно ли спросить что-то, пока агент работает, не останавливая его?** Напишите вопрос и нажмите **Спросить в побочном чате** в поле ввода (**Побочный чат**, включено по умолчанию). Копия чата только для чтения ответит, а чат продолжит работу. В побочном чате **Вернуть** помещает ответ в поле ввода чата.
366
+
367
+ **Как сказать агенту, что изменить в его diff?** В разделе **Панель изменений** откройте diff файла, нажмите **+** у строки и напишите заметку (**Заметки к diff**, включено по умолчанию). Затем нажмите **Отправить в поле ввода**: заметки попадут в поле ввода вместе с файлом, номерами строк и самими строками.
368
+
317
369
  **Как сделать, чтобы автопроверка не спрашивала об одном и том же инструменте в одном чате?** Нажмите **Разрешить для этого чата** на карточке одобрения. Разрешение действует только для этого инструмента в этом чате, по умолчанию 1 час; отозвать его можно через значок в заголовке. Изменить время можно в **Настройки → Composer Plus → Разрешить для этого чата**.
318
370
 
319
371
  **Я потерял iPhone. Как не дать ему подключаться к моему Mac?** Нажмите **Мобильное подключение** внизу слева на боковой панели и нажмите **Remove** рядом с этим iPhone. Его ключ сразу перестаёт работать; вернуться он сможет только после нового сопряжения, которое вы подтвердите на Mac.
320
372
 
373
+ **Как продолжить на этом Mac чат с другого моего Mac?** На другом Mac включите **Настройки → Composer Plus → Удалённые компьютеры** и **Разрешить другим компьютерам открывать этот Mac**, нажмите **Создать ссылку для сопряжения** и скопируйте ссылку (отправьте её себе, например через AirDrop или «Заметки»). На этом Mac тоже включите **Удалённые компьютеры**, выберите **Добавить компьютер…** слева от заголовка чата, вставьте ссылку и нажмите **Подключить**. Затем нажмите **Одобрить** на другом Mac. После этого выбирайте этот компьютер в том же меню.
374
+
321
375
  **Можно ли заблокировать Tether с помощью Face ID?** Да: в Tether включите «Settings → Privacy → Lock with Face ID». После этого Tether запрашивает Face ID (или код-пароль) при открытии и при возврате в приложение.
322
376
 
323
377
  **Как показать на боковой панели dsh только проекты, с которыми я работал сегодня?** Боковая панель → параметры просмотра (значок с ползунками) → **Активные за последние 2 часа**. Выберите пункт ещё раз, чтобы показать все проекты.
@@ -330,6 +384,10 @@ English · 中文 · Türkçe · Español · Português (Brasil) · Français ·
330
384
 
331
385
  **Может ли dsh сам открыть чат, который задаёт мне вопрос?** Да, с функцией **Открывать ожидающий чат при бездействии** (включена по умолчанию): когда чат ждёт ответа, одобрения или проверки плана, а вы не пользуетесь dsh 30 секунд, dsh открывает его. Чат, который завершил ход, который вы ещё не прочитали (зелёная точка), открывается так же, после оранжевых. Пока вы печатаете, прокручиваете или двигаете мышь, функция ждёт.
332
386
 
387
+ **Можно ли сразу перейти к следующему чату, который ждёт меня?** Да, с **Следующий ожидающий чат** (включено по умолчанию): нажмите `Cmd+Shift+E` (`Ctrl+Shift+E` в Windows и Linux) или кнопку с числом в заголовке боковой панели. Сначала идут чаты, которые задают вопрос или ждут одобрения, затем чаты, завершившие ход, который вы ещё не прочитали.
388
+
389
+ **Можно ли ответить на варианты агента одним нажатием?** Да, с **Кнопки вариантов** (включено по умолчанию): когда ответ заканчивается списком «Варианты», нажмите кнопку под ним. Она отправляет «Option N: …» как ваше сообщение. На карточке вопроса агента нажмите 1–9.
390
+
333
391
  **Как переключить интерфейс DeepSeek Harness на турецкий, испанский, японский…?** Настройки → Composer Plus → **Язык приложения**.
334
392
 
335
393
  **Как пользоваться dsh с iPhone?** Соберите приложение Tether из `tether/ios` (Xcode), включите **Настройки → Composer Plus → Мобильное подключение (iPhone)**, нажмите **Мобильное подключение** внизу слева, отсканируйте QR-код (камерой iPhone или кнопкой **Scan code** в Tether), коснитесь **Connect** и нажмите **Approve**. Вне дома используйте Tailscale на обоих устройствах.
@@ -359,6 +417,10 @@ PLAYWRIGHT=/path/to/playwright node test/browser-recent-finished.mjs /path/to/ds
359
417
  PLAYWRIGHT=/path/to/playwright node test/browser-recent-tree.mjs /path/to/dsh/lib/bin.js
360
418
  # Order by status (fake model + Schedule): real-app test + its thumbnail
361
419
  SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-status-order.mjs /path/to/dsh/lib/bin.js
420
+ # Next waiting chat and Option buttons (fake model): the sidebar button and Cmd+Shift+E open the waiting chats in order, the Keyboard shortcuts row, the option buttons and the question card keys, switch off + their thumbnails
421
+ SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-agentbox-ideas.mjs /path/to/dsh/lib/bin.js
422
+ # Reject with note, Secret input, Quote in reply, Side chat and Diff notes (fake model + a test-only approval gate): the button on dsh's card, the note after the rejection in the next request, Esc; the secret card, Save, the value in no request, file or page, Decline, Stop; a selected part of an answer → Quote → the sent message; a side question while the chat waits on a card (read-only, no queued message in it), Bring back; notes on a diff line and range → Send to composer → the sent message; switch off + their thumbnails
423
+ SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-t3code-ideas.mjs /path/to/dsh/lib/bin.js
362
424
  # every Settings feature row shows a loading screenshot and a ? link to its README row
363
425
  PLAYWRIGHT=/path/to/playwright node test/browser-settings-shots.mjs /path/to/dsh/lib/bin.js
364
426
  # What's new after an update: the release notes show once, Esc and Close close them
@@ -408,7 +470,7 @@ PLAYWRIGHT=/path/to/playwright node test/browser-continue-queue.mjs /path/to/dsh
408
470
  SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-queue-stop-send.mjs /path/to/dsh/lib/bin.js
409
471
  # Edit queued message in place with images and files (slow fake model) + its thumbnail
410
472
  SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-queue-edit.mjs /path/to/dsh/lib/bin.js
411
- # Task board: New task opens dsh's new chat and comes back after the first message, AI tags, live columns, Answer on the board, Hide finished, the switch
473
+ # Task board: New task opens dsh's new chat and comes back after the first message, AI tags, live columns, Answer on the board, × with Undo, Clear all with its question (unread cards stay), Removed and Put back (kept after a restart), the switch
412
474
  SHOT=1 PLAYWRIGHT=/path/to/playwright node test/browser-task-board.mjs /path/to/dsh/lib/bin.js
413
475
  ```
414
476