dsh-session-unread-toggle
Пункт контекстного меню сессии, который возвращает зелёный кружок «Завершено» — чтобы вернуться к разговору позже. Плюс счётчики на папке: сколько сессий ждёт ответа и сколько завершилось и не просмотрено.
English summary: a DeepSeek Harness web plugin that adds a right-click action to a finished sidebar Session, restoring the green completion dot (or clearing it), and shows two separate counts on the folder that holds those Sessions: waiting for an answer, and finished but unread.
Что делает
Когда сессия завершает работу, в списке слева появляется зелёный кружок «Завершено». Открытие сессии снимает его. Плагин добавляет в контекстное меню строки (правая кнопка мыши или кнопка «...») пункт:
- Отметить как непрочитанное — кружок возвращается и держится, пока сессию снова не откроют;
- Отметить как прочитанное — снимает отметку.
Если отметить сессию, открытую прямо сейчас, кружок появится, как только вы из неё выйдете, и исчезнет при следующем открытии — отметка работает как «вернуться к этому позже».
Пункт показывается только для сессий, которые уже запускали запрос, не выполняются
сейчас и не лежат в архиве. Отметки живут в браузере (localStorage, ключ
dsh.sessionUnreadMarks.v1), поэтому переживают перезагрузку страницы и перезапуск
приложения, синхронизируются между вкладками и окнами и не теряются при архивации
сессии.
Метки на папке
Сессии сгруппированы по папкам, и свёрнутая папка прячет все строки внутри. Поэтому на строке папки плагин показывает две метки, каждая со своим числом:
| метка | что считает |
|---|---|
| жёлтая точка + число | сессии, которые ждут ответа: подтверждение (approval), проверка плана или вопрос |
| зелёная точка + число | сессии, которые завершились и ещё не просмотрены |
Жёлтая стоит первой: ожидание ответа важнее завершения. Правила те же, что у точки в самой строке сессии, поэтому одна сессия попадает только в один счётчик — ждущая сессия не считается ещё и непрочитанной, а выполняющаяся не считается завершённой. Виды интеракций, для которых строка не рисует предупреждение, папку не подсвечивают.
Подтверждение, поднятое внутри субагента, поднимается до папки родительской сессии и
считается один раз. Архивные, пустые и субагентские сессии в счёт не попадают; сессии
вне папок собираются в строке «Без папки». Обе подписи уходят в aria-label и title
через ; .
Установка
Плагин ставится в профиль как обычный пакет:
dsh plugin --profile desktop add github:VladikDragon/dsh-session-unread-toggle
После установки добавьте его в dsh.profile.bundles профиля — через менеджер плагинов
или вручную в ~/.dsh/profiles/<профиль>/package.json:
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-session-unread-toggle"]
}
}
Локальная разработка — из клона:
git clone https://github.com/VladikDragon/dsh-session-unread-toggle
dsh plugin --profile desktop add file:C:/path/to/dsh-session-unread-toggle
Перезапуск приложения нужен только при добавлении нового пакета. Правки уже подключённого плагина подхватываются выключением и включением его строки в менеджере плагинов.
Как это работает
package.json манифест: dsh.bundle.patch + dsh.client (platform web)
cordis.patch.yml одна строка Loader с id session-unread-toggle
index.js host-половина: пустой apply(), нужен только чтобы у плагина
была строка на стороне хоста
client.js браузерный бандл: пункт меню, его иконки и метки на папках
test/client.test.cjs сценарии на макетах сервисов и DOM
Клиентская половина объявляется в package.json и зависит от трёх пакетов:
"dsh": {
"client": {
"platform": "web",
"immediately": true,
"inject": [
"@deepseek-ai/dsh-client-ui-session",
"@deepseek-ai/dsh-client-ui-workspace",
"@deepseek-ai/dsh-client-ui-context-menu"
]
}
}
ui-session объявляет сервис uiSession, ui-context-menu — реестр пунктов меню и слот
contextMenu.icon, ui-workspace — слот строки сессии, из которого открывается меню.
Сами сервисы sessions и workspaces приходят из ядра и контроллера рабочих
пространств. inject обязателен: без него регистрация пришлась бы на сервисы и слоты,
которых ещё нет.
Отметка
Кружок в строке рисуется по status.completionUnread из сервиса uiSession, а сам набор
живёт только в памяти вкладки и очищается, как только сессию открывают. Плагин пишет
отметку прямо в uiSession.completionUnread и вызывает publishStatus(), поэтому строка
обновляется без перезагрузки.
Свой список отметок в localStorage нужен, чтобы пережить перезагрузку: сверка с
набором сервиса идёт при каждом изменении списка сессий, при публикации
uiSession.sessionStatus и сразу при запуске плагина, поэтому кружок возвращается и
после перезагрузки страницы, и после завершения сессии, которую отметили запущенной.
Отметки синхронизируются между вкладками и окнами через событие storage: отметка,
поставленная в одном окне, появляется в остальных, а снятая — исчезает везде. Плагин
помнит, какие напоминания добавил сам, и снимает только их, не трогая кружок, который
поднял сам сервис сессий.
Архивация отметку не удаляет: пока сессия в архиве, кружка нет, а при восстановлении из архива он возвращается. Отметки удалённых сессий снимаются, как только список сессий загружен.
Меню
Меню — стандартный ctx.contextMenus.register({ target: 'session' }): пункт
session.unread с order: 350 пересчитывается по снимкам списка сессий, архива и своих
отметок. Иконки пункта — две ячейки слота contextMenu.icon: зелёная точка
StateDot state="done" (та же, что в строке) для «Отметить как непрочитанное» и
IconCheckCircleOutline для «Отметить как прочитанное».
Метки на папке
Два пути, один результат:
- Штатный слот
sidebar.workspace.row.trailing— приоритетный. Стоковый DSH его не объявляет; его добавляет пропатченный@deepseek-ai/dsh-client-ui-workspace. Когда слот есть, плагин регистрирует в нём ячейкуunread-folder-markи рисует метки средствами React. - DOM-фолбэк — если слот не объявлен. Плагин находит строки папок по атрибуту
data-row-key="workspace:<id>", который панель ставит сама, вставляет метки перед блоком действий строки и перерисовывает их по изменениям сессий, папок, статусов и по мутациям DOM. При выключении плагина метки и<style>убираются.
Как только слот появляется, фолбэк встаёт на паузу и стирает нарисованное, поэтому двойной отрисовки не бывает.
Счёт идёт по uiSession.sessionStatus — тому же снимку, из которого строки сессий
берут свою точку: pendingInteraction.kind даёт ожидание, completionUnread —
завершение. Разметка фолбэка — один span[data-unread-folder-badge] с двумя
сегментами span[data-kind="waiting"] и span[data-kind="unread"]; у сегмента без
сессий стоит атрибут hidden, поэтому строка не «дёргается» при появлении второй
метки.
Локаль
Словари лежат прямо в client.js и регистрируются в namespace sessionUnreadToggle:
ctx.locale.register('sessionUnreadToggle', DICTIONARIES)
Ключи — mark.unread, mark.read, folders.waiting и folders.unread; языки — ru,
en, zh.
Ограничения
- Только веб-клиент (
platform: "web"); в TUI пункта нет. - Отметка опирается на поле
completionUnreadсервисаuiSession, а счётчики — наuiSession.sessionStatus. Это не публичный контракт: если DSH переименует поля, плагин перестанет показывать точки, но не сломает страницу. - Отметки хранятся в браузере: другой браузер или профиль их не увидит.
- Пункт не показывается для выполняющихся, пустых и субагентских сессий, а также для сессий без единого запроса и для архива.
- Счётчики считают сессии, которые лежат в самой папке; в режиме дерева вложенные папки не суммируются в родительскую строку.
- DOM-фолбэк опирается на разметку строки папки, а не на контракт. Если DSH переименует
data-row-keyили блок действий строки, метки на папках перестанут появляться (страница не сломается). Штатный слот от разметки не зависит.
Разработка
Сборки нет: client.js — обычный скрипт, который загружается загрузчиком модулей хоста
и получает react и примитивы через require. Правки применяются перезапуском
приложения; проверить синтаксис можно node --check client.js.
Тесты идут без браузера и без DSH: test/client.test.cjs подменяет sessions,
workspaces, uiSession и DOM макетами и прогоняет 25 сценариев — отметки, обе метки
папки, подъём подтверждения из субагента, приоритет состояний и переход на слот.
npm test
Лицензия
MIT — см. LICENSE.
No comments yet. Be the first to write one.