dsh-locale-russian

中文文档
0.17.0发布于 2026/11/03MITES Module零依赖构建来源已验证

为DeepSeek Harness网络客户端提供俄语本地化,为语音输入提供俄语本地语音识别

中文使用文档
文档目录23 节
  1. Быстрыйстарт
  2. Возможности
  3. Каквыглядит
  4. Установка
  5. Профиль web (сервер dsh web )
  6. Приложение DeepSeek线束(桌面)
  7. Удаление
  8. Голосовойввод
  9. Однакнопка
  10. Лимитдиктовки
  11. Личныйсловарь
  12. Диктовка, фоне
  13. Провайдер по умолчанию
  14. Словарь распознавания(热词)
  15. Приватность
  16. Если голосовой ввод не нужен
  17. Проверка после установки
  18. Диагностика
  19. Как это работает
  20. Совместимость
  21. Участие
  22. Ссылки
  23. Опроекте

dsh-locale-russian

俄罗斯网络 DeepSeek利用 ——ирусскийголосовойвводвкомплекте:распознаваниеречиработаетлокально,безоблака-киAPIлючей。

checks npm npm downloads stars license coverage dashboard

Быстрыйстарт

Приложение DeepSeek线束- обычный случай:

npx dsh-locale-russian-install --desktop

Перезапустите приложение * выберите Настройки→Общие→Язык→Русский. Всё:интерфейснарусском,склонения(«1файл»,«2файла»,«5файлов»)работаютизкоробки。

Сервер dsh web:

dsh plugin --profile web add dsh-locale-russian

Рукаминичегозапускатьнеобязательно:можнодатьагентуссылкунаэтотрепозиторий——онпоставитпакетсам。Подробности; частые вопросы 常见问题解答。

Голосовой ввод - вторая половина пакета。Онтребуетштатныйплагин«Голосовойввод»иодинразскачанныйдвижокраспознавания:

  1. включите«Голосовой ввод»на странице«Плагины»;
  2. откройте его карточку * нажмите «Скачать * подготовить» - движок * модель скачаются * настроятся сами;
  3. перезапуститеприложениеинажмитемикрофонвполеввода。

Подробности - разделе «Голосовойввод。。

Возможности

ВозможностьЧтоименно
Переводинтерфейса75年3929年строкв名称空间:панели,настройки,диалог,икарточкиинструментов,подсказки,ошибкиUI,единицыизмеренияиформатыдат
Описанияплагинов555年строк:названияиописаниякарточеквразделе«Встроенныеплагины»ивобзореплагинов
Русскиесклоненияформы выбираются по Intl.PluralRules('ru'), * не по английскому правилу«1 или много»
Голосовойвводлокальныйраспознаватель GigaAM v3 дляштатногоголосовоговвода:аудионепокидаетмашину、ключиненужны,ставитсяоднойкнопкой
Терминологияединый глоссарий (GLOSSARY.md) * правила стиля (STYLE.md), проверяемые линтером
Установкаодинпакет:ставитсяизnpm, git, tarballилилокальногопути

Пакет——обычныйклиентскийплагинDSH:ондобавляетязык ru врасширяемыйкаталоглокалейирегистрируетпереводыдлявсех名称空间интерфейса。Недостающиеключиавтоматическипоказываютсяпо-английски,поэтомунеполныйпереводнеломаетинтерфейс。Одновременноэтоbundle,поэтомуставитсяоднойкомандойиобновляетсякакобычныйпакет。

Строкиснятыизтрёхисточников:клиентскихпакетовустановленногоприложения(app.asar), cli -сборки * репозитория。Пропущенныхключейнет-актуальныецифрыиразбивкапо名称空间на дашбордепокрытия。

Каквыглядит

Главный экран на русском

Выбор языка в настройках

Установка

ПакетнетребуетфоркаDeepSeek利用инеменяетегофайлы。

Профиль web (сервер dsh web)

dsh plugin --profile web add dsh-locale-russian

Командаставитпакетизnpmчерез规划,добавляетегов dependencies и dsh.profile.bundles, после чего строка locale-ru появляется, собранном дереве。

Еслисразупослевыпуска规划ставитпредыдущуюверсию——такработаетегозащитаотслишкомсвежихпакетов;укажите версию явно ([email protected]) или повторите позже。 npm такой ситуации ставит актуальную версию сразу。

Так же пакет ставится из git или локального пути:

dsh plugin --profile web add github:nemezida1337/dsh-locale-russian
dsh plugin --profile web add file:/абсолютный/путь/к/рабочей/копии

Приложение DeepSeek线束(桌面)

Профиль desktop принадлежит电子——приложению,иCLIотказываетсяимуправлять。Пакетставитсяоднойкомандой:онанаходитпрофиль,делаетрезервнуюкопию,добавляетзависимостьистрокубандла(послеголосовоговвода,чтобыприменилисьпатчиконфигурации——провайдерпоумолчаниюилимитдиктовки),ставитпакетвстроенным规划приложенияипроверяетрезультат。

npx dsh-locale-russian-install --desktop

Полезныережимы: --dry-run - показать изменения без записи, --revert - откатить установку, --profile <путь> - другой каталог dsh。

Безтерминала: включите«Пользовательскиерынкиплагинов»настранице«Плагины»,откройтевкладку«Обзор»→«Источникииндексов»,добавьтеадрес https://nemezida1337.github.io/dsh-locale-russian/index.json установите пакет из«Обзора»。

Вручную: добавьте "dsh-locale-russian": "^0.17.0" в ~/.dsh/profiles/desktop/package.json и dsh-locale-russian вего dsh.profile.bundles, затем выполните pnpm add dsh-locale-russian каталоге профиля。PNPM лежит внутри приложения: …/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/pnpm/bin/pnpm.mjs。

Строкойпатча - - - - - -когданужнаживаярабочаякопия:возьмитекопиюрепозиториявпостоянноеместоидобавьтев ~/.dsh/profiles/desktop/cordis.patch.yml, сохранив остальные записи:

- insert:
    - id: locale-ru
      name: file:///абсолютный/путь/к/dsh-locale-russian/lib/index.js

После любого способа перезапустите приложение。Язык выбирается Настройках→Общие→Язык;еслисистемаибраузерприложениянастроенынарусский,интерфейспереключитсясам。

Удаление

  • приложение: npx dsh-locale-russian-install --desktop --revert (или удалите пакет на странице«Плагины»);
  • web -профиль: dsh plugin --profile web remove dsh-locale-russian。

Движок * модель голосового ввода остаются * ~/.dsh/bin и ~/.gigastt - их можно удалить вручную。

Голосовойввод

Пакет - не только словари: его хост-половина (lib/index.js) регистрирует регистрирует штатном реестре speechToText провайдера gigaam-local,поэтомумикрофон,волна,停止/取消ивставкатекстаостаютсяштатными,араспознаваниеидётнамашинечерез gigastt имодель GigaAM v3 (e2e_rnnt, int8, 271 МБ) SberDevices。

Однакнопка

  1. Включите«Голосовойввод»настранице«Плагины»——этоштатныйплагинDSH,впоставкеонвыключен。
  2. Откройте его карточку * нажмите «Скачать * подготовить». Провайдерсамскачаетдвижокдлявашейплатформы(macOS arm64, Linux x64 / arm64 Windows x64)спроверкойконтрольнойсуммырелиза,распакуетегов ~/.dsh/bin, затем скачает модель ~/.gigastt/models * запустит / /。Прогресс обоих шагов виден, карточке。
  3. Перезапуститеприложение——внастройкахголосовоговводапоявится GigaAM v3 (локально, RU)。

Еслирусскийраспознавательвыбранпоумолчанию,движокпрогреваетсявфонечерезнесколькосекундпослезапуска:перваядиктовканеждётзагрузкимодели。

Еслидвижокилимодельудалить,тажекнопкавосстановитих。Альтернатива для терминала - npx dsh-locale-russian-install. На платформах без готовой сборки возьмите релизgigastt вручную * укажите binaryPath настройках плагина。

Лимитдиктовки

Пакет поднимает штатный лимит записи r 2 до 5минут (иобъёмаудиос4до10МиБ——на300секундвформате16кГц/мононужно~ 9日2МиБ)。Движокраспознаёттакуюзаписьпримерноза15секунд。Изменить лимит можно - патче профиля - строка api-speech-to-text, причём менять нужно оба значения:

- id: api-speech-to-text
  config:
    maxDurationSeconds: 600      # 10 минут
    maxAudioBytes: 20971520      # 20 МиБ

Личныйсловарь

Движокнезнаетвашихтерминов——онможетуслышать«конфигхотводс»вместо configHotwords. Дляэтогоестьличныйсловарь:онхранитсяотдельнойсекциейв ~/.dsh/speech-ru/hotwords.txt * подмешивается * распознаванию。

Первичноезаполнение - из терминала, списком или файлом:

npx dsh-locale-russian-install --hotwords-add "configHotwords, GigaAM, dsh-locale-russian"
npx dsh-locale-russian-install --hotwords-add-file terms.txt   # по одному слову в строке
pbpaste | npx dsh-locale-russian-install --hotwords-add-file - # список из буфера (stdin)
npx dsh-locale-russian-install --hotwords-list                 # посмотреть словарь
npx dsh-locale-russian-install --hotwords-remove "GigaAM"
npx dsh-locale-russian-install --hotwords-export terms.json    # выгрузить словарь и замены
npx dsh-locale-russian-install --hotwords-import terms.json    # загрузить (например, от коллеги)
npx dsh-locale-russian-install --hotwords-from .              # собрать термины из проекта

Изпроекта: --hotwords-from <папка> сканируетисходники(именафайлов,компонентов,camelCase / PascalCase -идентификаторы),ранжируетпочастотеиберётсамыеполезные——поумолчанию150 (--hotwords-limit). Служебные слова, React-хуки, node_modules иобрывкиужесуществующихфраз(«利用»при«DeepSeek利用»)пропускаются。Повторныйзапускзаменяетсловапрошлогосканирования(манифест projects.json рядомсословарём),поэтомусканированиеможноповторятьпослерефакторинга。Найденноевидноиудаляетсявпанели«Словарь(N)。”

Пополнение прямо из распознанного текста: выделитеслововполеввода-рядомпоявитсяпоповерскандидатамиизсловаря(фонетическоесопоставление:«гитхаб»→ GitHub) * пунктом«+ * словарь»。Выбраликандидата-слововполезаменилось,апара«какуслышали→какнадо»запомнилась。Нажали«+всловарь»-фразапростопопалавсловарь。Впоповереестьстрока«Словарь(N)»——открываетвесьсписокскнопками«×»дляудаления。Есливыделенноесловоужеестьвсловаре,поповерпредлагает«−убратьизсловаря。”Это явные действия, ничего не правится молча。Дубликатысловсравниваютсябезучётарегистра:«GitHub»и«GitHub»——однослово。

Авто-обучение из правок: правитьслововручнуюнеобязательно——еслипоследиктовкивыисправилислововполе,пара«какуслышали→какнадо»запоминаетсясама。Учитсятолькотерминология:ссылки,числа,код,служебныеслова,склоненияисмысловыеправкипропускаются。Внизу появится«Выучено: гитхаб→GitHub»。

Замены хранятся ~/.dsh/speech-ru/replacements.json и применяютсяавтоматически ккаждойрасшифровке:еслидвижокуслышал«гитхап»,вполепоявится GitHub,авнизу——уведомление«Словарь:заменено1:гитхап→GitHub»。Это видимая правка, не молчаливая。Hotwordsподсказываютнаписани,еноневсегдапересиливаютакустику,поэтомувыученныепары——надёжныйпутьдлятерминов,которыепроизносятпо——русски。

Лимитличногословаря- 400фраз(движокчитаетфайлцеликом,ограничениевф64разыотноситсятолькокHTTP -запросу)。Послеизменениясловарядвижокодинразперезагружается:перваядиктовкабудетна~ 5секунддольше。

Диктовка, фоне

Штатныйголосовойвводотменяетзапись,когдаокнотеряетфокус:переключилисьнабраузер——диктовкапропадала。Пакетэтоисправляет:записьпродолжается,асостояниевиднопотрёмпризнакам——бейдж«●Диктовкаидётвфоне»вокнеприложения,точка«●»взаголовкеокнаисистемноеуведомление。Вернувшисьвприложени,енажмите«Стоп»——текстраспознаетсяивставитсякакобычно;еслиневозвращаться,записьостановитсясамаполимитудлительности。

Провайдер по умолчанию

Провайдерпоявляетсявсписке«Сервисраспознавания»ивыбираетсявнастройках。Чтобырусскийраспознавательбылвыборомпоумолчаниюсразу,добавьтев ~/.dsh/profiles/<профиль>/cordis.patch.yml:

- id: speech-to-text
  config:
    defaultProvider: gigaam-local

Сампакеттоженесётэтотпатч,ноонприменяетсятолькоеслибандлголосовоговводаидётв dsh.profile.bundles раньше нашего: патчи применяются по порядку слоёв。Строкавпатчепрофиляприменяетсяпоследнейиработаетприлюбомпорядке;выбор, сделанный, настройках, перекрывает。

Словарь распознавания(热词)

Точныенаписанияфирменныхсловитерминовлежатв ~/.dsh/speech-ru/hotwords.txt ——пофразенастроку,правкиподхватываютсясоследующейдиктовкибезперезапуска。Встроенныйсписок: DeepSeek Harness, DSH, GigaAM, gigastt. Слишкомпохожиефрагментыоднойфразыдобавлятьнестоит:конкурирующиезаписипортятрезультат。

Приватность

  • Аудиообрабатываетсялокально:движокслушаеттолько 127.0.0.1 наслучайномпорту,всетьничегонеотправляется。
  • Api -ключи * подписки не используются;модель * движок - обычные файлы на диске。
  • Пакетнесобираеттелеметрию:единственныйсетевойобмен——npmприустановкеизагрузкадвижкасмодельюповашемуявномудействию。

Если голосовой ввод не нужен

Ничегоделатьненужно:безвключённогобандлаголосовоговводахост——половинанеактивируется,переводработаеткакобычно。Движокимодельнескачиваются,покавысаминенажмётекнопкуподготовки。

Проверка после установки

  1. Язык: «Настройки→Общие→Язык»——выбран«Русский»,интерфейспо——русски。
  2. Страница: исходнике страницы html lang="ru"。
  3. Голосовойввод: «Плагины→Голосовойввод→Сервисраспознавания»——вспискеесть GigaAM v3 (локально, RU), статус«Готов»。Кнопка микрофона записывает * вставляет текст。

Диагностика

СимптомПричинаЧтосделать
Интерфейс остался английскимязык не выбран или пакет не, композиции«Настройки→Общие→Язык»→«Русский»;проверьте dsh plugin --profile <имя> list * перезапустите приложение
Часть строк по-английскиключ новый * ещё не переведёнштатноеповедение:недостающиеключипадаютванглийский;обновитесь до свежей версии пакета
В«Сервис распознавания»нет GigaAM v3невключёнштатный«Голосовойввод»илинеустановленнашпакетвключите«Голосовойввод»настранице«Плагины»,установитепакет,перезапустите
Провайдер есть, но не выбран по умолчаниюпорядок слоёв: наш патч применился раньшевыберитевнастройкахилидобавьтестрокувпатчпрофиля(см。 выше)
«Не удалось скачать движок»нет сети или недоступен GitHubповторите кнопку«Скачать * подготовить»;при блокировке скачайте релизgigastt вручную * укажите binaryPath
«Модель GigaAM не подготовлена»модель удалена или не докачанакарточка«Плагины→Голосовойввод»→«Скачатьиподготовить»
Диктовка путает терминысловарь не знает ваших словдопишите фразы ~/.dsh/speech-ru/hotwords.txt
Пакет не загружается, логе engines.dshверсия DSH вне диапазонаобновитепакет——диапазонрасширяетсяспроверкойновыхсборок

Логиприложения: ~/Library/Logs/DeepSeek Harness/ (macOS)。Покрытие переводов - на дашборде。

Как это работает

  1. Плагин объявляет язык: ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' })。
  2. Для каждого namespace регистрируется словарь: ctx.locale.register(namespace, 'ru', {...}). Ключисовпадаютсоригинальными,значения——русские。
  3. Русскиесклонения:словарьможетхранитьдотрёхформ,разделённых |, * пакет подменяет LocaleRuntime.prototype.translate, выбирая форму по числу。Дляне-ru локалейвызываетсяисходныйметод,поэтомуанглийскийикитайскийинтерфейсыработаюткакраньше。
  4. Метаданныеплагинов:описанияиназванияприходятотхостакак LocalizedText * рисуются через LocaleRuntime.resolveText;пакет подменяет * этот метод。Еслипакетотдаётсвойрусскийвариан,тонвыигрывает。
  5. Голосовойввод:хост——половинарегистрируетпровайдера gigaam-local штатном реестре speechToText;движокпрогреваетсявфоне,когдапровайдервыбранпоумолчанию,изапускаетсяприпервойдиктовкевостальныхслучаях。

ВDSH 0.2.2 русский язык * небольшие словари common/settings встроенывядро:пакетдополняетих——занятыеслотынемешаютактиваци,иапереводдлянихнакладываетсяповерх。Подробнее语文формате ф з з з STYLE.md。

Совместимость

  • engines.dsh <e:1> манифесте (^0.1.5-rc.1 || ^0.2.1-rc.2 || ^0.2.2-alpha.2) перечисляет проверенные сборки: 0.1.5-rc.x (cli -сборка, клиентские пакеты 0.1.5-rc.2), CLI -сборки 0.2.1-rc.2…rc.4,приложения 0.2.1-rc.3 и 0.2.1-rc.5 (клиентские пакеты распакованы из app.asar)и 0.2.2-alpha.2 изтега alpha. Пропусков нет: 22 0.2.1-rc.5 нетниоднойновойстроки,однаудалена,английскийтекстнеменялся。
  • Голосовойвводпроверенвживойкомпозициисбандломголосовоговводаибезнего;тест хост-половины входит npm test。
  • Пакет использует публичный контракт локали (addLanguage, register, getSnapshot) * два приватных метода рантайма: translate для склонений * resolveText для метаданных плагинов。Обавызовазащищеныпроверкойтипа:еслиметодисчезнет,пакетпродолжитработать——склоненияперестанутвыбираться,описанияплагиновостанутсяанглийскими,строкиинтерфейсанепострадают。
  • Обсуждения <e:1>上游: хуксклонений, локализацияоболочки и локализуемые описания навыков;тексты - 22 contrib / upstream-issues.md, витрина плагина - 讨论/ 10146。

Участие

  • Вопросыпоустановк,еголосовомувводуиобновлению- 常见问题解答 и обсуждениярепозитория (категории«Вопросы»*«Идеи»)。
  • Нашли ошибку перевода - 发行по шаблону。
  • Предлагаете правку - CONTRIBUTING.md:правилаперевода,порядоквыпускаикакдобавитьновыйязыкгенератором tools/scaffold-locale.mjs。
  • Покрытие по namespace * источникам - дашборд。
  • ОтветывобсужденияхDeepSeek利用проверяетеженедельныий工作流приновомкомментарииоткрывает问题вэтомрепозитории。
  • Мейнтейнерам- 文档/ DEVELOPMENT.md (инструменты, ci, выпуски) 文档/ MAINTENANCE.md (чек-листобслуживания:новаяверсияDSH,движок,жалобынаперевод)。

Ссылки

ЧтоАдрес
Пакет Пакет NPMhttps://www.npmjs.com/package/dsh-locale-russian
Релизы * история измененийhttps://github.com/nemezida1337/dsh-locale-russian/releases
Дашбордпокрытияhttps://nemezida1337.github.io/dsh-locale-russian/
Индекс маркета (для«Плагины→Обзор»)https://nemezida1337.github.io/dsh-locale-russian/index.json
Витрина Витрина обсуждениях DSHhttps://github.com/deepseek-ai/deepseek-harness/discussions/10146
Предложение: хук склоненийhttps://github.com/deepseek-ai/deepseek-harness/discussions/10147
Предложение: локализация оболочкиhttps://github.com/deepseek-ai/deepseek-harness/discussions/10148
Предложение: локализуемые описания навыковhttps://github.com/deepseek-ai/deepseek-harness/discussions/11533
Рецепт плагина для DSHcontrib / plugin-recipe.md
DeepSeek利用https://github.com/deepseek-ai/deepseek-harness
Gigastt (движок распознавания)https://github.com/ekhodzitsky/gigastt
GigaAM(модель)https://github.com/salute-developers/GigaAM

Опроекте

Неофициальнаялокализация,несвязаннаясDeepSeek。МодельGigaAMраспространяетсяполицензии麻省理工学院еёавторами;движок gigastt - отдельный проект своей лицензией。Пакет распространяется по лицензии 麻省理工学院。

版本与发布记录

dsh-locale-russian 共发布 38 个版本,首次发布于 2026/10/18;过去 12 个月发布了 38 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.17.0latest2026/11/03今天
0.16.12026/11/03今天
0.16.02026/11/03今天
0.15.02026/11/03今天
0.14.02026/11/03今天
0.13.02026/11/03今天

关于 dsh-locale-russian 的常见问题

dsh-locale-russian 是什么?

为DeepSeek Harness网络客户端提供俄语本地化,为语音输入提供俄语本地语音识别

如何安装 dsh-locale-russian?

在项目目录运行 npm install dsh-locale-russian,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dsh-locale-russian-install,可以用 npx dsh-locale-russian-install 直接运行。

dsh-locale-russian 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dsh-locale-russian 是否存在。

dsh-locale-russian 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

dsh-locale-russian 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

dsh-locale-russian 可以商用吗?

dsh-locale-russian 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

dsh-locale-russian 还在维护吗?

最新版本 0.17.0 发布于 2026/11/03(今天);至今共发布 38 个版本,其中过去 12 个月发布了 38 个;首次发布于 2026/10/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。