dsh-locale-pl
DeepSeek Harness 网页界面的波兰语（Polski）语言包——一个社区 DSH 客户端插件，可将 pl 添加到 Settings → General → Language。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Dragonk/dsh-locale-pl#8d32da7cbf5cee17b025b2b210da40d1705755caLocale Pl 以 dsh-locale-pl 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Polski pakiet językowy dla interfejsu webowego DeepSeek Harness — społecznościowy plugin kliencki, który dodaje język Polski (pl) do listy języków w Ustawienia → Ogólne → Język.
Pakiet nie modyfikuje kodu DeepSeek Harness ani node_modules. Rejestruje się
przez oficjalny system lokalizacji DSH
(@deepseek-ai/dsh-client-locale): dodaje język do katalogu i podłącza słowniki
per namespace. Brakujące klucze są automatycznie uzupełniane angielskim przez
wbudowany łańcuch fallbacku.
pl → en (oficjalny mechanizm DSH)| Element | Wersja |
|---|---|
DeepSeek Harness (klient web / pakiety @deepseek-ai/*) | 0.1.5-rc.2 |
| Tag źródeł, z którego pochodzi korpus | dsh-v0.1.5-rc.2 (fb2c4b9) |
dsh --version na maszynie testowej | 0.1.5-rc.1 (CLI); pakiety są w 0.1.5-rc.2 |
| Node.js | ≥ 22 (testowane na 24) |
DSH jest w fazie developer preview i ma breaking changes. Pakiet używa wyłącznie publicznego API rejestru locale (
ctx.locale.addLanguage/ctx.locale.register), więc aktualizacje DSH nie wymagają zmian w kodzie pluginu — wymagają jedynie doniesienia nowych ciągów (patrz Aktualizacje).
dsh plugin --profile web add github:Dragonk/dsh-locale-pl
Po instalacji zrestartuj DSH (zatrzymaj i uruchom ponownie dsh --profile web).
DSH doda pakiet do dsh.profile.bundles profilu i podłączy go jako warstwę
pluginu. Jeśli w Twojej instalacji działa przeładowywanie klienta (HMR), język
może pojawić się bez pełnego restartu — ale restart jest zawsze bezpieczny.
Możesz też zainstalować z lokalnej kopii:
dsh plugin --profile web add file:/ścieżka/do/dsh-locale-pl
albo z npm (po publikacji):
dsh plugin --profile web add dsh-locale-pl
Wybór jest zapisywany w dokumencie ustawień użytkownika DSH (sekcja locale) i
przetrwa restart oraz ponowne otwarcie przeglądarki.
dsh plugin --profile web remove dsh-locale-pl
Zrestartuj DSH. Interfejs wróci do poprzedniego języka; zapisana preferencja
locale.preference może pozostać w settings.yaml — usuń ją ręcznie, jeśli
chcesz wrócić do języka przeglądarki.
npm run fetch:runtime # instaluje @deepseek-ai/dsh-client-locale w wersji z upstream/reference.json
npm run build # generuje lib/client.js ze słowników dict/pl/*.json
npm run check # porównuje tłumaczenia z upstream/corpus.json (raport)
npm run check:strict # kończy się kodem != 0 przy brakach (bramka CI)
npm test # 20 testów: słowniki, bundle, drift, integracja z LocaleRuntime
npm run drift -- --old a.json --new b.json # porównuje dwa korpusy
npm run verify # fetch:runtime + build + check:strict + test (z wymuszonym LocaleRuntime)
npm run verify to pełna bramka wydania — uruchamia dokładnie to, co CI, i
wymusza wykonanie testu integracyjnego. Sam npm test jest wygodniejszy lokalnie:
jeśli nie znajdzie oficjalnego pakietu locale, pominie tylko test integracyjny.
W CI ustawione jest DSH_REQUIRE_LOCALE_RUNTIME=1, więc brak runtime’u kończy
się błędem, a nie pominięciem.
Checker (check.mjs) wykrywa:
{...} występujące w innym zbiorze niż w angielskim),upstream/identical-allowlist.json),Wykrywanie zmian upstream (scripts/lib/corpus-diff.mjs, scripts/drift.mjs)
porównuje dwa korpusy i raportuje:
UPSTREAM STRING CHANGED — REVIEW REQUIRED (klucz nadal się rozwiązuje, ale
polskie tłumaczenie trzeba zweryfikować ręcznie),{count} → {total}).Do uruchomienia check i testów driftu nie potrzebujesz DSH ani sieci — korpus
angielski jest wersjonowany w upstream/corpus.json, a testy driftu działają na
lokalnych fixture’ach z tests/fixtures/. Tylko test integracyjny wymaga
pobrania @deepseek-ai/dsh-client-locale.
Otwórz issue w repozytorium: https://github.com/Dragonk/dsh-locale-pl/issues.
Podaj:
settings/connection.error), jeśli go znasz,dsh --version).Zmiany tekstów wprowadzaj bezpośrednio w dict/pl/<namespace>.json, a następnie
uruchom npm run build — plik lib/client.js jest generowany i musi być
zacommitowany razem ze słownikiem.
dict/pl/*.json słowniki: namespace → { klucz: "polski tekst" } (źródło prawdy)
lib/client.js wygenerowany bundle klienta (window.__ModuleLoader__.load)
index.js połowa hostowa pluginu (pusta — rejestracja dzieje się w przeglądarce)
cordis.patch.yml warstwa profilu: montuje plugin jako wiersz loadera
scripts/extract.mjs wyciąga korpus angielski ze źródeł DSH
scripts/build.mjs składa lib/client.js ze słowników
scripts/check.mjs kontrola zgodności i kompletności
scripts/lib/corpus-diff.mjs porównanie dwóch korpusów (czysta funkcja)
scripts/drift.mjs CLI: raport zmian między dwoma korpusami
scripts/update-upstream.mjs odświeża korpus z wybranego tagu DSH i raportuje drift
scripts/fetch-locale-runtime.mjs instaluje oficjalny pakiet locale do testów
scripts/verify.mjs pełna bramka: runtime + build + check:strict + testy
upstream/corpus.json angielskie źródło (klucz → {en, zh})
upstream/reference.json z jakiego tagu/commita pochodzi korpus
tests/ testy jednostkowe, driftu i integracyjne
tests/fixtures/ lokalne fixture’y korpusów dla testów driftu
docs/publishing.md wydanie nowej wersji i zgłoszenie do ekosystemu DSH
GLOSSARY.md kontrakt terminologiczny
Gdy DSH doda nowe ciągi:
# 1. odśwież angielskie źródło z nowego tagu i zobacz raport dryfu
node scripts/update-upstream.mjs --ref dsh-v0.1.5-rc.2 --fail-on-drift
# raport trafia też do upstream/drift-report.md
# 2. sprawdź, czego brakuje
npm run check
# 3. przetłumacz nowe klucze w dict/pl/<namespace>.json
# (dodaj też nowe namespace’y; wzoruj się na GLOSSARY.md)
# dla wpisów UPSTREAM STRING CHANGED — zweryfikuj istniejące tłumaczenie
# 4. zbuduj i przetestuj pełną bramką
npm run verify
# 5. wydaj wersję
# zaktualizuj CHANGELOG.md, podnieś version w package.json, commit, tag, push
CI (GitHub Actions) uruchamia przy każdym pushu i pull requeście: build, kontrolę
świeżości lib/client.js, check:strict oraz testy z wymuszonym prawdziwym
LocaleRuntime. Raz w tygodniu osobny job pobiera najnowszy tag DSH, wylicza raport
dryfu i kończy się błędem, gdy upstream dodał, usunął lub zmienił cokolwiek —
włącznie ze zmianą treści istniejącego angielskiego stringa. Job tylko raportuje:
nic nie commituje, nie pushuje i nie tłumaczy automatycznie.
node_modules ani plików upstream.ctx.locale.pl → en), więc nowszy DSH nie zepsuje interfejsu.npm run check zgłosi to jako błąd.Kilka miejsc w DSH nie przechodzi przez rejestr locale i pozostaje po angielsku:
Read Only, Workspace Write, Full access) —
rdzeń definiuje je bez nazw wyświetlanych, więc interfejs pokazuje
identyfikatory maszynowe i żaden słownik locale ich nie obejmuje;Bash, Read, Write, Edit) w niektórych miejscach to
identyfikatory techniczne, nie ciągi locale;Ten pakiet celowo nie nadpisuje tabeli presetów uprawnień w profilu (inaczej niż np. pakiet rosyjski). Dzięki temu nie dubluje konfiguracji rdzenia i nie łamie się przy zmianach upstream; wszędzie tam, gdzie DSH udostępnia ciąg locale, tłumaczenie działa.
Plugin został ogłoszony w społeczności DeepSeek Harness:
Uwagi do tłumaczenia i propozycje lepszego brzmienia zgłaszaj przez issues — albo w wątku dyskusji.
MIT — patrz LICENSE. Słowniki i skrypty powstały na podstawie publicznego korpusu DSH; zobacz THIRD_PARTY_NOTICES.md.