DSH mods
Моды (плагины-бандлы) для DeepSeek Harness — локальные расширения UI и поведения DSH, которые мы сделали для себя и делимся как есть.
Unofficial plugins (mods) for DeepSeek Harness. Each mod is a self-contained local bundle; install a mod folder through DSH's Plugins page. Not affiliated with DeepSeek.
Что внутри
| Мод | Что делает | Где видно |
|---|---|---|
session-cost |
Оценочная стоимость текущей сессии и окно с балансом DeepSeek: пополнения и бонусы, ссылки на пополнение/использование, индикатор пиковых часов | Кнопка-текст в полосе под полем ввода (рядом с индикатором контекста); клик открывает окно |
У каждого мода своя папка и своя документация:
README.md— что делает, как работает, ограничения (это же описание показывается на странице плагина в DSH);AGENTS.md— детали реализации: источники данных, константы, проверки, история решений и известных багов (память для агента и для человека, который будет дописывать мод).
Требования
- DeepSeek Harness 0.2.x (проверено на
0.2.2-rc.3, Desktop-сборка). - Мод
session-costрассчитан на профиль с включённым аккаунтом DeepSeek (для баланса) и штатнымdsh-token-meter(для расхода токенов). Без аккаунта кнопка стоимости продолжает работать, окно сообщает об отсутствии доступа.
Установка
Каждый мод ставится отдельно, как локальный бандл — репозиторий не нужно подключать целиком.
Через интерфейс
- Склонируйте репозиторий (или скачайте нужную папку).
- В DSH откройте Plugins → Add plugin и укажите папку мода,
например
dsh-mods/session-cost. - Включите появившийся бандл, если он не включён, и обновите страницу.
Через агента DSH
plugin_manager install_bundle, target = <абсолютный путь к папке мода>
Обновление и удаление
Правки файлов мода подхватываются без переустановки: папка подключается
символической ссылкой в профиль. Обновление — git pull; удаление — Plugins →
удалить бандл (файлы в репозитории остаются).
Структура репозитория
AGENTS.md память проекта: конвенции, правила, чек-лист
AGENTS.local.md локальный оверлей (окружение машины, в git не входит)
LICENSE MIT
README.md этот файл
tools/run-check.ps1 прогон офлайн-проверки мода через Electron-Node
tools/check-memory.sh проверка «память обновлена вместе с кодом»
tools/check-memory.ps1 тот же прогон из PowerShell (через Git Bash)
tools/git-hooks/ версионируемый pre-push хук
.github/workflows/ та же проверка на стороне GitHub
<mod>/ один мод = одна папка = один бандл @local/<mod>
AGENTS.md память реализации мода
client.js браузерная половина
index.js Host-половина (у session-cost пустая)
cordis.patch.yml строки Host-плагина в Loader
package.json манифест бандла + секция dsh.client
locale/*.json meta.title / meta.description для Plugin Manager
icon.svg иконка мода
test/check.mjs офлайн-проверка с заглушками React/Cordis
Разработка
Конвенции, окружение и подводные камни — в
AGENTS.md. Файлы памяти лежат в репозитории намеренно: и агент, и человек работают по ним.Офлайн-проверка мода (нужен запущенный DSH, скрипт использует его Electron как Node):
pwsh -File tools/run-check.ps1 -Path session-cost/test/check.mjsПроверка не требует браузера: она загружает
client.jsс заглушками React и Cordis и проверяет рендер, расчёты, словари и ветки состояний.Живая проверка:
cordis_inspect_query→ клиентскийSlots.listSubTree→ запись мода в слоте должна бытьactive: true.
Память обновляется вместе с кодом
Память проекта — часть изменения, и это проверяется автоматически:
- локальный хук
tools/git-hooks/pre-pushблокирует пуш, если изменён файл мода без правкиAGENTS.mdэтого мода, если появился/пропал мод без правки таблицы модов, или если изменёнtools//.github/без правки корневогоAGENTS.md; - та же проверка идёт в GitHub Actions (
.github/workflows/memory-check.yml), поэтому правило работает и в клоне без хуков.
Включить хук в своём клоне: pwsh -File tools/enable-hooks.ps1.
Осознанный обход: SKIP_MEMORY_CHECK=1 git push.
Ограничения
- Моды неофициальные и используют публичные точки расширения DSH; при обновлении DSH часть API может измениться.
session-costпоказывает оценку стоимости: тарифы — константа в коде мода (пиковые ставки DeepSeek V4.1 Flash, USD), непиковые часы вдвое дешевле, но пересчёт по фактическому времени запросов не делается. Пиковые окна — 01:00–04:00 и 06:00–10:00 UTC, понедельник–пятница; праздники КНР не учитываются.- Внешний вид модов проверялся в DSH Desktop; в других темах/разрешениях возможны косметические расхождения.
Лицензия
MIT © 2026 Nikolay Pozharskiy.
No comments yet. Be the first to write one.