DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

VladikDragon /

VladikDragon/dsh-session-unread-toggle

Verified

DeepSeek Harness plugin. dsh-session-unread-toggle adds a Session context-menu action that marks a finished session as unread again, restoring the sidebar's green completion dot.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: main@c4f2836e

dsh-session-unread-toggle

release license

Пункт контекстного меню сессии, который возвращает зелёный кружок «Завершено» — чтобы вернуться к разговору позже. Плюс счётчики на папке: сколько сессий ждёт ответа и сколько завершилось и не просмотрено.

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 для «Отметить как прочитанное».

Метки на папке

Два пути, один результат:

  1. Штатный слот sidebar.workspace.row.trailing — приоритетный. Стоковый DSH его не объявляет; его добавляет пропатченный @deepseek-ai/dsh-client-ui-workspace. Когда слот есть, плагин регистрирует в нём ячейку unread-folder-mark и рисует метки средствами React.
  2. 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.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit c4f2836ef023

Community comments

No comments yet. Be the first to write one.