dsh-user-code-block
v0.4.0
Published
Renders fenced code blocks in DeepSeek Harness Desktop chat user messages: syntax highlighting, copy button and monochrome mode
Maintainers
Readme
dsh-user-code-block
Плагин для DeepSeek Harness Desktop (DSH): рисует блоки кода в сообщениях пользователя — рамка, плашка языка, подсветка синтаксиса и кнопка копирования. Остальной текст сообщения остаётся обычным текстом.
English | Русский
Совместимость
- DeepSeek Harness Desktop 0.2.1-rc.3 — проверено; сборки 0.1.x дают те же точки расширения
- любой профиль DSH (
desktopилиweb), где смонтирован клиентский пакетui-chat - Node.js 20+ для разработки и тестов
- зависимостей в рантайме нет, сборки нет
Зачем
Сообщения ассистента рендерит markdown (AssistantMarkdown), а сообщения
пользователя — примитив UserText: обычный текст с white-space: pre-wrap.
Поэтому fenced-блок
```python
print("hi")
```в своём сообщении виден вместе с кавычками, без подсветки и рамки. Плагин
добавляет ровно одно исключение: распознаёт забор кода и рисует его так же,
как блок в ответе ассистента. Ссылки, @-упоминания и прочие штатные узлы
UserText работают как раньше.
Что распознаётся
- забор из трёх и более обратных кавычек или тильд;
- отступ до трёх пробелов (четыре — уже не забор);
- язык из информационной строки берётся первым словом:
```python title=x→python; - забор из четырёх кавычек корректно вмещает тройные внутри;
- незакрытый забор блоком не считается: остаток сообщения не превращается в код из-за забытых кавычек.
Одинарные обратные кавычки (код в строке) не трогаются — это не блок.
Подсветка
Цвета берутся из переменных темы --shiki-token-*, которые DSH уже публикует
(shiki.css в @deepseek-ai/dsh-client-ui-theme). Светлая и тёмная палитры
переключаются сами через body[data-ds-dark-theme], поэтому плагину не нужно
определять активную тему.
Токены размечает собственный лексер — без shiki и без клиентских примитивов (документация DSH запрещает плагинам подключать их как модули). Поддерживаются:
| Язык в заборе | Что красится |
|---|---|
| python, py | ключевые слова, True/False/None, строки (включая тройные), комментарии #, числа |
| js, ts, jsx, tsx, javascript, typescript | ключевые слова, true/false/null, строки, // и /* */, числа |
| json, jsonc | ключи-строки, true/false/null, числа |
| bash, sh, shell, zsh | ключевые слова, строки, #-комментарии, числа |
| go, golang | ключевые слова, true/false/nil/iota, строки, // и /* */ |
| rust, rs | ключевые слова, None/Some/Ok/Err, строки, комментарии |
| java | модификаторы и типы, true/false/null, строки, комментарии |
| html, xml, svg, htm | теги, атрибуты, значения-строки, <!-- --> |
| sql (с диалектами), css, scss | ключевые слова/строки/комментарии по возможностям языка |
Монохромный режим. Заборы ```text, ```txt, ```plain, ```output,
```log, ```console, ```terminal, ```diff, ```md не подсвечиваются:
рамка и плашка остаются, а цвет не применяется. Это для транскриптов терминала
и логов, где правила кода дают случайную раскраску (зелёные «строки» из вывода
grep, плюсы трейса как пунктуация и т. п.).
Прочие языки тоже рисуются без подсветки — лучше честный моноширинный текст, чем неверная раскраска.
Палитра
Каждый тип токена берёт цвет из переменной темы, поэтому светлая и тёмная палитры переключаются сами:
| Тип токена | Переменная темы | Что попадает |
|---|---|---|
| keyword | --shiki-token-keyword | def, func, fn, public, if, return |
| string | --shiki-token-string | строки во всех поддерживаемых языках |
| comment | --shiki-token-comment | #, //, /* */, <!-- --> |
| constant | --shiki-token-constant | числа, true/null/nil/None, КАПС-имена (MAX_SIZE) |
| function | --shiki-token-function | вызовы (print, Println, main), атрибуты HTML |
| type | --shiki-token-parameter | встроенные типы (int, String, Vec), CSS-свойства |
| punctuation | --shiki-token-punctuation | скобки, операторы, запятые |
Встроенные типы и CSS-свойства — отдельный тип токена: в Go, Rust, Python и
JavaScript это не ключевые слова, а предобъявленные имена, поэтому лексер кода
их бы не увидел. Списки лежат в GO_TYPES, RUST_TYPES, PYTHON_TYPES,
JAVASCRIPT_TYPES, JAVA_TYPES, SQL_TYPES.
Кнопка копирования
В шапке блока справа есть Copy: в буфер уходит исходный код, без разметки и
подсветки. Через 1.5 секунды подпись возвращается. Если браузер не даёт доступ
к navigator.clipboard, кнопка не рисуется вовсе — вместо сломанной кнопки
лучше ничего.
Точки расширения DSH
Плагин использует штатные механизмы (см. docs пакета ui-chat, раздел
«Sent user text»):
ctx.uiConversation.userText.register({ id, order, match(text, from) })— синхронный матчер, возвращающий кандидата{ id, start, end, data };- слот
conversation.user.text.node— рендерер узла,keyсовпадает сid.
Хост-половина пустая: lib/index.js экспортирует apply() {} — она нужна
только чтобы ряд появился в cordis-дереве профиля.
Установка
Плагин ставится в профиль DSH (desktop или web). Проверялось на
DSH Desktop 0.2.1-rc.3.
Скриптом
git clone https://github.com/VictorKozachek/dsh-user-code-block.git
cd dsh-user-code-block
./install.sh # профиль по умолчанию: ~/.dsh/profiles/desktopСкрипт делает бэкап манифеста профиля, дописывает пакет в dependencies
(link:) и в dsh.profile.bundles, ставит симлинк в node_modules. Другой
профиль задаётся переменной:
DSH_PROFILE_DIR="$HOME/.dsh/profiles/web" ./install.shВручную
Дописать пакет в
~/.dsh/profiles/desktop/package.json:{ "dependencies": { "dsh-user-code-block": "link:/path/to/dsh-user-code-block" }, "dsh": { "profile": { "bundles": [ "@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-user-code-block" ] } } }Поставить ссылку в
node_modulesпрофиля:ln -s /path/to/dsh-user-code-block \ ~/.dsh/profiles/desktop/node_modules/dsh-user-code-blockПерезапустить приложение: граф клиентских модулей собирается при старте хоста, обновлением страницы он не перечитывается.
Через CLI
Если dsh доступен как команда, установку делает сам менеджер плагинов:
dsh plugin --profile desktop add /path/to/dsh-user-code-blockПроверка
Отправить в чат сообщение с забором кода — блок должен отрисоваться рамкой с плашкой языка, остальной текст остаться обычным.
Разработка
Зависимостей нет, сборки нет: правится lib/client.js, проверяется тестами.
node --test test/*.test.mjstest/matcher.test.mjs— разбор забора и лексер: поднимает фальшивыйwindow.__ModuleLoader__, забирает фабрику браузерной половины и вызывает её с заглушкой React, поэтому тесты идут в Node без браузера.test/plugin.test.mjs— связность пакета: манифест, слой патча, совпадение id браузерного модуля с именем пакета.
CI — GitHub Actions, матрица Node 20/22/24 на Ubuntu и macOS
(.github/workflows/tests.yml).
Откат
./uninstall.shИли вручную: убрать dsh-user-code-block из dsh.profile.bundles, удалить
ссылку из node_modules профиля и перезапустить приложение.
Лицензия
MIT — см. LICENSE.
