dsh-switchman 1.5.0 → 1.6.0

package/README.it.md

@@ -2,7 +2,7 @@
 
 [English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-TW.md) | [日本語](./README.ja.md) | [한국어](./README.ko.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | **Italiano** | [Português](./README.pt.md) | [Русский](./README.ru.md)
 
-> **La famiglia switchman**, stesso autore, stessa orchestrazione: [opencode-switchman](https://github.com/mrzturn/opencode-switchman) (l'originale per OpenCode) · [zcode-switchman](https://github.com/mrzturn/zcode-switchman) (il port per ZCode) · **dsh-switchman** (questo repository, per DeepSeek Harness).
+> **La famiglia switchman**, stesso autore, stessa orchestrazione: [opencode-switchman](https://github.com/mrzturn/opencode-switchman) (l'originale per OpenCode) · [zcode-switchman](https://github.com/mrzturn/zcode-switchman) (il port per ZCode) · **dsh-switchman** (questo repository, l'edizione DeepSeek Harness).
 
 ![dsh-switchman — il livello dell'acqua del contesto comanda lo switchman, che devia la rotta](docs/assets/hero.svg)
 
@@ -10,35 +10,34 @@
 
 ## Perché serve
 
-Se lavori con DSH, col passare del tempo ti imbatti in due cose:
+Se lavori con DSH, col passare del tempo ti imbatti in due cose: la sessione pesa sempre di più — la cronologia gonfia il contesto fino a centinaia di migliaia di token, il modello inizia a dimenticare, rallenta e costa di più, e il /compact manuale comprime perdendo dettagli nel farlo; e il modello principale fa tutto da solo — leggere un file, lanciare un test, confrontare dati: è sempre lui a masticarli, lento e costoso, quando gran parte di quel lavoro spetterebbe a un modello economico.
 
-1. **La sessione pesa sempre di più.** La cronologia gonfia il contesto fino a centinaia di migliaia di token: il modello inizia a dimenticare, rallenta e costa di più, e alla fine non resta che un /compact manuale — che comprime e perde dettagli nel farlo.
-2. **Il modello principale fa tutto da solo.** Leggere un file, lanciare un test, confrontare dati: è sempre lui a masticarli — lento e costoso, quando gran parte di quel lavoro spetterebbe a un modello economico.
+dsh-switchman è un plugin per [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). Una volta installato, il modello principale smette di «fare tutto da solo» e diventa un dispatcher: misura il livello dell'acqua, sceglie la corsia, assegna i task, verifica il risultato. Non è un nuovo modello: è un regolamento di orchestrazione agganciato a DSH più un'interfaccia di configurazione. In concreto fa sette cose:
 
-dsh-switchman è un plugin per [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). Una volta installato, il modello principale smette di «fare tutto da solo» e diventa un dispatcher: misura il livello dell'acqua, sceglie la corsia, assegna i task, verifica il risultato. Non è un nuovo modello: è un regolamento di orchestrazione agganciato a DSH più un'interfaccia di configurazione. In concreto fa sei cose:
-
-**1. Livello dell'acqua del contesto: le sessioni lunghe non esplodono.** A ogni turno conta i token della sessione in tempo reale, e tre soglie inaspriscono a gradini: 50k (soft, regolabile) ricorda che «è ora di delegare»; 90k (hard) stringe il budget di lettura per singola chiamata e spinge verso la chiusura; 130k (force) avvia l'handover automatico — fork della sessione come copia di backup, contesto compattato, continuazione risvegliata: il task non si interrompe. Nemmeno i subagent in background ancora in corsa al momento del passaggio si perdono: id, descrizione del task e percorso del report finiscono nel documento di handover, così la sessione ripresa sa dove raccogliere i report invece di ri-assegnare lo stesso lavoro. Ogni subagent inviato porta con sé un tetto massimo indipendente e, raggiunto il limite, esce dopo aver scritto il riepilogo HANDOFF.
+**1. Livello dell'acqua del contesto: le sessioni lunghe non esplodono.** A ogni turno conta i token della sessione in tempo reale, e tre soglie inaspriscono a gradini: 50k (soft, regolabile) ricorda che «è ora di delegare»; 90k (hard) stringe il budget di lettura per singola chiamata e spinge verso la chiusura; 130k (force) avvia l'handover automatico — fork della sessione come copia di backup, contesto compattato, continuazione risvegliata: il task non si interrompe. Nemmeno i subagent in background ancora in corsa al momento del passaggio si perdono: id, descrizione del task e percorso del report finiscono nel documento di handover, così la sessione ripresa sa dove raccogliere i report invece di ri-assegnare lo stesso lavoro. Ogni subagent inviato porta con sé un tetto massimo indipendente e, raggiunto il limite, esce dopo aver scritto il riepilogo HANDOFF. Se l'intervento automatico non ti torna, prendi tu il comando in qualsiasi momento: `/ctx-pause` ferma tutte le azioni della soglia (la misurazione continua, l'avviso passa a paused — smette solo di agire), `/ctx-resume` ripristina in qualsiasi momento — dopo un riavvio di DSH l'intervento torna anche da solo, un mollare la presa temporaneo, non uno spegnimento definitivo; `/ctx-handover` non aspetta che la soglia tocchi il limite e avvia su richiesta lo stesso handover: fork di una copia di backup, compattazione del contesto, risveglio della continuazione (la sessione viene prima guidata fino al confine di inattività, quindi il risultato può richiedere qualche minuto).
 
 **2. Sei pool di dispatch: a ogni lavoro il suo modello.** Pool leggero (economy, piccoli lavori in serie), pool meccanico (mechanical, riscritture modellate), pool principale (main, coding di tutti i giorni), pool ad alta difficoltà (hard, ragionamento complesso e refactoring su larga scala), pool multimodale (vision, lettura delle immagini), pool di revisione (review, verifica indipendente). Nella pagina delle impostazioni spunti i candidati, ordini le priorità (con fasce opzionali S/A/B/C) e fichi un reasoning effort per ogni route — il menu a tendina elenca i livelli che quel modello supporta davvero, non tre livelli generici. A ogni turno il prompt del modello principale viaggia con una tabella di raccomandazioni `[SWITCHMAN:POOLS]`: si assegna il lavoro seguendo la tabella. La modalità di esecuzione ha tre stati: off / advice / enforce (enforce = i modelli fuori pool vengono rifiutati sul posto).
 
 **3. Modalità Agent Teams: dal lavoro solitario alla squadra.** Disattivata di default: appena installato si lavora con un dispatch leggero via subagent. Nella pagina delle impostazioni, due interruttori indipendenti:
 
-- **Modalità Agent Teams** — una volta attivata, inietta la dottrina di squadra (delega per default + verifica a livelli + disciplina del task board condiviso) e abilita automaticamente gli Agent Teams di DSH: il modello principale può arruolare compagni permanenti (`spawn_teammate`), assegnare lavori al task board condiviso (`team_task_*`) e scambiarsi messaggi con loro (`send_message`). Quando formare la squadra segue una disciplina precisa: sotto-task indipendenti parallelizzabili, lavori voluminosi e autosufficienti, livello dell'acqua del contesto principale già alto, necessità di separare i ruoli; le indagini una-tantum restano al subagent. La politica di fabbrica di DSH è «niente squadra se l'utente non la nomina»: qui si inverte in «usala quando serve». Ri-spegnendo l'interruttore, le clausole di squadra spariscono senza residui, e gli strumenti di squadra nelle sessioni in corso non vengono ritirati.
-- **Sincronizzazione della whitelist dei modelli per i subagent** — DSH ha una whitelist di autorizzazione «Consenti agli agenti di scegliere i modelli per i subagent»: le route scelte nei pool ma non autorizzate vengono rifiutate se il modello principale le nomina esplicitamente (in modalità squadra, la tabella di raccomandazioni e la pagina delle impostazioni le marcano con ⚠). Con questo interruttore attivo, l'unione dei sei pool viene scritta in un colpo solo in quella whitelist — niente configurazione doppia: switchman è l'unica fonte di verità, e vi rientra anche il percorso di dispatch via fork. La whitelist scatta come snapshot alla «nuova sessione»: la sincronizzazione vale solo per le sessioni aperte dopo.
+- **Modalità Agent Teams** — una volta attivata, inietta la dottrina di squadra (delega per default + verifica a livelli + disciplina del task board condiviso) e abilita automaticamente gli Agent Teams di DSH: il modello principale può arruolare compagni permanenti (`spawn_teammate`), assegnare lavori al task board condiviso (`team_task_*`) e scambiarsi messaggi con loro. Quando formare la squadra segue una disciplina precisa: sotto-task indipendenti parallelizzabili, lavori voluminosi e autosufficienti, livello dell'acqua del contesto principale già alto, necessità di separare i ruoli; le indagini una-tantum restano al subagent. Ri-spegnendo l'interruttore, le clausole di squadra spariscono senza residui, e gli strumenti di squadra nelle sessioni in corso non vengono ritirati.
+- **Sincronizzazione della whitelist dei modelli per i subagent** — DSH ha una whitelist di autorizzazione «Consenti agli agenti di scegliere i modelli per i subagent»: le route scelte nei pool ma non autorizzate vengono rifiutate se il modello principale le nomina esplicitamente (in modalità squadra, vengono marcate con ⚠). Con questo interruttore attivo, l'unione dei sei pool viene scritta in un colpo solo in quella whitelist — niente configurazione doppia: switchman è l'unica fonte di verità. La whitelist scatta come snapshot alla «nuova sessione»: la sincronizzazione vale solo per le sessioni aperte dopo.
 
 L'intestazione della sessione dà un riscontro immediato: badge ⚡ «Squadra autonoma», ◇ modello effettivo della sessione in corso; durante un handover automatico compare un avviso in tempo reale del tipo «Handover in corso · backup della sessione / compattazione del contesto / risveglio della continuazione».
 
 **4. Preferenze linguistiche: chiede una volta, ricorda per sempre.** Un menu a tendina per ciascuna delle tre lingue — risposte, commenti nel codice, documenti — con ambito a scelta globale o per progetto (`.switchman/lang.json`). Puoi anche non impostarlo: al primo utilizzo ti viene chiesto una volta, nella lingua dell'interfaccia DSH, e da lì in poi ogni sessione lo rispetta da sé.
 
-**5. Verifica a livelli: finita la modifica, si controlla.** Le modifiche oltre 20 righe vanno a un tester per la verifica; oltre 300 righe, o quando si toccano logica centrale / sicurezza / coerenza dei dati, subentra anche un reviewer con revisione indipendente. Il modello del reviewer si sceglie ancorandolo a quello dell'«agente che ha scritto il diff», evitandolo per quanto possibile; se nel pool proprio non si riesce, la conclusione dichiara DOWNGRADED. Basta dire «non usare le squadre» e torna subito a lavorare da solo.
+**5. Lingua dell'interfaccia: il plugin parla anche la tua lingua.** In cima alla pagina delle impostazioni arriva una nuova sezione «Interfaccia» con un menu a tendina «Lingua dell'interfaccia» (chiave di impostazione `uiLocale`): Automatico (predefinito — segue la lingua dell'app DeepSeek Harness) o una qualsiasi delle lingue dell'interfaccia del plugin, sempre mostrata con il suo endonimo, mai tradotta. Cambia solo l'interfaccia del plugin stesso — il badge nell'intestazione, il pannello home e la pagina delle impostazioni —, non la lingua dell'app DSH: l'anteprima è immediata, senza riavvio; il salvataggio ricorda la scelta; il prossimo avvio la ripristina; ogni errore ricade sulla lingua dell'app; e tutti i dizionari viaggiano nel bundle, nessun download.
+
+**6. Verifica a livelli: finita la modifica, si controlla.** Le modifiche oltre 20 righe vanno a un tester per la verifica; oltre 300 righe, o quando si toccano logica centrale / sicurezza / coerenza dei dati, subentra anche un reviewer con revisione indipendente. Il modello del reviewer si sceglie ancorandolo a quello dell'«agente che ha scritto il diff», evitandolo per quanto possibile; se nel pool proprio non si riesce, la conclusione dichiara DOWNGRADED. Basta dire «non usare le squadre» e torna subito a lavorare da solo.
 
-**6. `/vision`: anche i modelli solo testo trattano le immagini.** Quando il modello principale non sa leggere le immagini, DSH rifiuta al varco i messaggi che le contengono. Alleghi l'immagine e digiti `/vision dov'è l'errore in questa immagine`: l'immagine viene risolta in un percorso di file e affidata alla lettura di un modello del pool multimodale, e la conclusione torna nella sessione corrente. Sopra la casella di input compare in anticipo l'avviso «il modello corrente non supporta la lettura delle immagini»; se un invio diretto dell'immagine viene rifiutato, il messaggio viene riscritto una volta in `/vision` e reinviato da solo, senza dover rifare tutto a mano; senza pool multimodale configurato, il comando rifiuta e indica come configurarlo.
+**7. `/vision`: anche i modelli solo testo trattano le immagini.** Quando il modello principale non sa leggere le immagini, DSH rifiuta al varco i messaggi che le contengono. Alleghi l'immagine e digiti `/vision dov'è l'errore in questa immagine`: l'immagine viene affidata alla lettura di un modello del pool multimodale, e la conclusione torna nella sessione corrente. Sopra la casella di input compare in anticipo l'avviso «il modello corrente non supporta la lettura delle immagini»; se un invio diretto dell'immagine viene rifiutato, il messaggio viene riscritto una volta in `/vision` e reinviato da solo, senza dover rifare tutto a mano; senza pool multimodale configurato, il comando rifiuta e indica come configurarlo.
 
 Un solo modello? Vale comunque la pena installarlo — il controllo del livello dell'acqua e la verifica a livelli non guardano a quanti modelli hai, e ne giovancono allo stesso modo le sessioni lunghe con un modello unico.
 
 ## Skill incluse
 
-- **db-query** — verifica in sola lettura su MySQL/Redis: esegui SQL per controllare record, chiavi di cache / TTL, coerenza tra store. Rifiuta ogni scrittura. Configurazione una tantum qui sotto.
+- **db-query** — verifica in sola lettura su MySQL/Redis: esegui SQL per controllare record, chiavi di cache / TTL, coerenza tra store. Rifiuta ogni scrittura. Inizializzazione al primo uso (vedi sotto).
 - **git-commit-message** — testo di commit conforme alle convenzioni. Solo testo; non tocca mai git.
 - **requirement-docs** — un'unica specifica per requisiti / PRD / documenti di design, archiviata in `docs/requirements-and-design/`.
 
@@ -65,29 +64,20 @@ Un solo modello? Vale comunque la pena installarlo — il controllo del livello
 
 2. **Riavvia DSH** — chiudi completamente l'app e riaprila (ricaricare la pagina non basta), così la tabella dei moduli client rileva il bundle.
 
-3. **Preferenze linguistiche** — Settings → dsh-switchman, oppure la voce «Switchman Control Center» nella barra laterale della home. Nella prima schermata si sceglie prima l'ambito: globale (questo profilo) o per progetto (il `.switchman/lang.json` di ciascun progetto); poi tre menu a tendina fissano rispettivamente la lingua di risposte / commenti / documenti, ciascuno con una riga di stato «Attuale: …» sottostante. Puoi anche saltare: al primo uso ti verrà chiesto una volta e ricordato (la domanda segue la lingua dell'interfaccia DSH).
-
-   ![Preferenze linguistiche: ambito e tre lingue](docs/assets/conf-language-en.png)
-
-4. **Configura i pool di dispatch** — in ogni scheda di pool spunti i modelli candidati raggruppati per provider; spuntando «ordine manuale» la scheda diventa una lista di priorità numerata, da riordinare con ↑ ↓ ×, e accanto a ogni route puoi fichare il reasoning effort (predefinito «segui la corsia»; una volta fichato elenca le fasce che quel modello supporta davvero). La riga di riepilogo in alto riflette i progressi in tempo reale, per esempio «6/6 pool configurati · 2 in classifica · modalità advice».
-
-   ![Pool di dispatch: i quattro pool economy / mechanical / main / hard](docs/assets/conf-pool-1-en.png)
-
-   Il pool multimodale e quello di revisione stanno più sotto; ancora più in basso arrivano la **classifica di capacità** (l'unione dei modelli scelti nei sei pool: la numerazione è l'ordine di capacità, i più forti davanti, con fasce opzionali S/A/B/C) e la **modalità di esecuzione** (advice / enforce).
-
-   ![Pool multimodale e pool di revisione, classifica di capacità e modalità di esecuzione](docs/assets/conf-pool-2-en.png)
-
-5. **Agent Teams** — entrambi gli interruttori partono spenti: prima falla girare in puro modello subagent. Per lasciare che arruoli la squadra da sola, attiva «Modalità Agent Teams»; per risparmiare la doppia autorizzazione, attiva «Sincronizzazione della whitelist dei modelli per i subagent» — sotto l'interruttore una riga di stato del tipo «N voci sincronizzate + ora» conferma l'esito della scrittura.
-
-   ![Agent Teams: i due interruttori e lo stato di sincronizzazione della whitelist](docs/assets/conf-team-en.png)
+3. **Configura** — Impostazioni → dsh-switchman, oppure la voce «Switchman Control Center» nella barra laterale della home. La configurazione sta tutta in una pagina; eccola — un giro dall'alto in basso e hai finito:
 
-6. **Livello dell'acqua del contesto** — le tre soglie (predefinite 50000 / 90000 / 130000), il budget di lettura per singola chiamata, il comportamento della soglia hard (passa con limitazione / blocca), l'interruttore dell'handover automatico e il tetto indipendente dei subagent stanno tutti in quest'area. Una riga di comandi in fondo: `/ctx-pause` sospende gli interventi · `/ctx-resume` li riprende · `/ctx-handover` fa subito backup e passaggio di consegne (guida la sessione fino al confine di inattività e attende la finestra di retry della compattazione: il risultato può richiedere alcuni minuti).
+   ![Vista completa della pagina di configurazione di dsh-switchman: lingua dell'interfaccia, preferenze linguistiche, sei pool di dispatch, classifica di capacità e modalità di esecuzione, interruttori squadra, livello dell'acqua del contesto e comandi](docs/assets/conf-interface-it.png)
 
-   ![Livello dell'acqua del contesto: soglie, budget e comandi](docs/assets/conf-ctx-en.png)
+   - **Interfaccia** — la lingua dell'interfaccia del plugin stesso. Nella schermata è selezionato «Italiano»: è l'anteprima immediata, l'intera pagina cambia all'istante; per predefinito c'è «Automatico», che segue la lingua dell'app DSH. La scelta viene ricordata al salvataggio, e puoi tornare a «Automatico» quando vuoi.
+   - **Lingua** — la lingua di ciò che produce l'agente. L'ambito nella schermata è «Globale (questo profilo)» (si può anche per progetto, ognuno legge il proprio `.switchman/lang.json`); i tre menu a tendina risposte / commenti nel codice / documenti sono tutti fissati su «Italiano (it)», ciascuno con la riga di stato «Attuale: …» sotto. Puoi anche non impostarli: al primo uso viene chiesto una volta e ricordato.
+   - **Pool di dispatch** — sei schede su due righe da tre: in alto leggero / meccanico / principale; in basso alta difficoltà / multimodale / revisione. In ogni scheda si spuntano i candidati raggruppati per provider; spunta «ordine manuale» e diventa una lista di priorità numerata da riordinare con ↑ ↓ ×; accanto a ogni route puoi fichare il reasoning effort (predefinito «segui la corsia»). La riga di riepilogo in alto si aggiorna in tempo reale; nella schermata: «4/6 pool configurati · 2 in classifica · modalità advice».
+   - **Classifica di capacità + modalità di esecuzione** — l'unione dei modelli scelti nei sei pool, ordinata per capacità con i più forti davanti (nella schermata glm-5.3 ancorato in S e glm-5.3-flash ancorato in A); si può riordinare e ridurre; la modalità di esecuzione va da advice / enforce (enforce = i modelli fuori pool vengono rifiutati sul posto).
+   - **Squadra di agenti** — i due interruttori, modalità squadra e sincronizzazione della whitelist, partono spenti; nella schermata sono accesi, con sotto una riga di stato della sincronizzazione.
+   - **Livello dell'acqua del contesto** — le tre soglie (nella schermata 50000 / 90000 / 130000), il budget di lettura per singola chiamata (1500), il comportamento della soglia hard (passa con limitazione / blocca), l'interruttore dell'handover automatico e il tetto indipendente dei subagent: tutto in quest'area. Una riga di comandi in fondo: `/ctx-pause` sospende gli interventi · `/ctx-resume` li riprende · `/ctx-handover` fa subito backup e passaggio di consegne (guida la sessione fino al confine di inattività prima di compattare: il risultato può richiedere alcuni minuti).
 
-7. **Verifica** — nell'intestazione della sessione compare il badge ⚡ «Squadra autonoma» (accanto, il ◇ mostra il modello della sessione in corso); oppure chiedi direttamente al modello «qual è il titolo dell'ultima sezione del tuo system prompt?» — la risposta dovrebbe menzionare la dottrina dsh-switchman.
+4. **Verifica** — nell'intestazione della sessione compare il badge ⚡ «Squadra autonoma» (accanto, il ◇ mostra il modello della sessione in corso); oppure chiedi direttamente al modello «qual è il titolo dell'ultima sezione del tuo system prompt?» — la risposta dovrebbe menzionare la dottrina dsh-switchman.
 
-**Configurazione una tantum di db-query** (le dipendenze degli script vivono nella directory della skill, senza sporcare il progetto):
+**Inizializzazione di db-query al primo uso** (le dipendenze degli script vivono nella directory della skill, senza sporcare il progetto):
 
 ```bash
 bash <install-dir>/skills/db-query/scripts/setup.sh
@@ -96,8 +86,8 @@ bash <install-dir>/skills/db-query/scripts/setup.sh
 ## Come funziona
 
 - La parte Host (`index.js` + `host/`) inietta le sezioni dinamiche del system prompt (lingue / corsie / livello dell'acqua / squadra), il doppio cancello budget di lettura + enforce e i quattro comandi slash (il trio ctx più `/vision`). Ogni impostazione salvata vale già dall'assemblaggio del prompt successivo, senza riavvio.
-- La parte Client (`client.js`) renderizza la pagina delle impostazioni, il badge ⚡ e l'identificativo ◇ del modello nell'intestazione della sessione e l'avviso dinamico durante l'handover, appoggiandosi ai servizi ufficiali settings-form.
-- La voce «Switchman Control Center» nella barra laterale della home apre con un clic la stessa pagina di configurazione (preferenze linguistiche, pool di dispatch e classifica, livello dell'acqua) come pannello centrale; la voce nelle impostazioni resta al suo posto.
+- La parte Client (`client.js`) renderizza la pagina delle impostazioni, il badge ⚡ e l'identificativo ◇ del modello nell'intestazione della sessione e l'avviso dinamico durante l'handover; gli snapshot di configurazione si leggono e scrivono tramite la famiglia di route Host.
+- La voce «Switchman Control Center» nella barra laterale della home apre con un clic questa stessa pagina di configurazione come pannello centrale; la voce nelle impostazioni resta al suo posto.
 - `cordis.patch.yml` conserva integralmente la lista di plugin dei preset di fabbrica e interviene solo sul persona suffix; gli strumenti Agent Teams in sé vengono dal bundle di fabbrica e vengono abilitati automaticamente all'attivazione della modalità squadra.
 
 ## Manutenzione

package/README.ja.md

@@ -2,109 +2,99 @@
 
 [English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-TW.md) | **日本語** | [한국어](./README.ko.md) | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Italiano](./README.it.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
 
-> **switchman ファミリー**。同じ作者、同じオーケストレーション指針：[opencode-switchman](https://github.com/mrzturn/opencode-switchman)（OpenCode 原版）· [zcode-switchman](https://github.com/mrzturn/zcode-switchman)（ZCode 移植版）· **dsh-switchman**（本リポジトリ、DeepSeek Harness 版）。
+> **switchman ファミリー**。同じ作者、同じディスパッチ思想：[opencode-switchman](https://github.com/mrzturn/opencode-switchman)（OpenCode 原版）· [zcode-switchman](https://github.com/mrzturn/zcode-switchman)（ZCode 移植版）· **dsh-switchman**（本リポジトリ、DeepSeek Harness 版）。
 
-![dsh-switchman — コンテキスト水位が転轍機を動かし、タスクを正しいレーンへ投げ込む](docs/assets/hero.svg)
+![dsh-switchman — コンテキスト水位が転てつ機を切り替え、タスクを正しいレーンへ流す](docs/assets/hero.svg)
 
-> コンテキストに水量計を付けると、タスクは自分でレーンを見つけます。
+> コンテキストに水量計を付けろ。タスクは自分でレーンを見つける。
 
 ## なぜ必要か
 
-DSH で作業を続けていると、時間がたつうちに次の 2 つにぶつかります：
+DSHで長く作業していると、悩みが2つ出てくる。1つはセッションの肥大化。履歴がコンテキストを数十万トークンまで膨らませ、モデルは忘れ始め、遅くなり、高くつき、手動の /compact は細部を失う。もう1つは主力モデルが何でも自分でやること。ファイルを追い、テストを回し、データを突き合わせる——その大半は実は安いモデルに任せるべき仕事だ。
 
-1. **会話がどんどん重くなる。** 履歴でコンテキストが数十万 token まで膨らむと、モデルは物忘れが増え、遅くなり、高くつきます。最後には手動 /compact 一択になりますが、圧縮するたびに細部がこぼれ落ちます。
-2. **主力モデルが何もかも自分でこなす。** ファイルを 1 つ調べる、テストを回す、データを照合する——そのすべてを主力モデルが齧っています。遅い上にお金もかかり、その大半は実は安いモデルに任せられるはずの仕事です。
+dsh-switchman は [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）のプラグインだ。入れると主モデルは「自分で作業する」役から運転指令へ変わる：水位を測り、レーンを選び、タスクを投げ、受け入れを確認する。新モデルではない。DSHに取り付けるディスパッチ規程と設定ページであり、7つのことを行う。
 
-dsh-switchman は [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）のプラグインです。導入すると、メインモデルは「何もかも自分でこなす」役からディスパッチャーへ変わります：水位を測り、レーンを選び、タスクを配り、検収を見届ける。新しいモデルではなく、DSH に載せるオーケストレーション規律と設定画面ひと組です。具体的には 6 つのことをします：
+**1. コンテキスト水位：長いセッションを破裂させない。** 毎ターンリアルタイムでセッショントークンを数え、3本の水位線が段階的に締め上げる：50k（soft、調整可）は「そろそろ委譲を」、90k（hard）は1回の読み取り予算を引き締めて収束へ導き、130k（force）で自動引き継ぎ——セッションをフォークして記録に残し、コンテキストを圧縮し、後継を起こして継続する。タスクは切れない。引き継ぎの瞬間に走っているバックグラウンドのサブエージェントも失われない：id・タスク・レポートパスを引き継ぎドキュメントに書き込み、再開したセッションはどこでレポートを受け取るか分かっていて、同じ仕事を二度投げない。各サブエージェントは独立のハード上限を持ち、到達したら HANDOFF サマリを書いて退場する。自動介入が手に合わないときは、いつでも一時的に手動で引き取れる：`/ctx-pause` は水位の動作をすべて止める（計測は走り続け、バナーは paused に切り替わる、ただ手を出さなくなるだけ）、`/ctx-resume` でいつでも復帰。DSH を再起動しても介入は自動で戻る。一時的に手を離すだけで、恒久的なオフではない。`/ctx-handover` は水位が満ちるのを待たず、同じ引き継ぎを自分から起こす：フォークしてバックアップを残し、コンテキストを圧縮し、後継を起こす（セッションはまずアイドル境界まで導かれるため、結果には数分かかることがある）。
 
-**1. コンテキスト水位：長いセッションを溢れさせない。** 毎ラウンド、セッションの token 数をリアルタイムに集計し、3 本の水位線で段階的に引き締めます：50k（soft、変更可）で「そろそろ委譲すべき」と促し、90k（hard）で 1 回あたりのファイル読み取り予算を絞って締めくくりへ誘導し、130k（force）で自動ハンドオーバー——セッションを fork して記録を残し、コンテキストを圧縮し、続きを担うセッションを起こします。タスクは途切れません。ハンドオーバーの瞬間にまだ走っているバックグラウンドのサブエージェントも失われません：id・タスク説明・レポートのパスはすべて引き継ぎ文書に書き込まれ、続行するセッションはレポートをどこから回収するかを知っていて、同じ仕事を二重に振りません。配られた各サブエージェントには独立したハード上限が付き、上限に達したら HANDOFF 要約を書いて退場します。
+**2. 6つのディスパッチプール：仕事に合ったモデルを。** economy（小口の雑務のバッチ）、mechanical（テンプレート化された書き換え）、main（日常のコーディング）、hard（難問推論と大規模リファクタリング）、vision（画像）、review（独立検証）。設定ページで候補にチェックを付け、優先順を決め、S/A/B/C のグレードを付け、さらにルートごとに思考強度をピン留めできる——強度のドロップダウンはそのモデルが実際に対応するレベルから立ち上がり、汎用の3段ではない。主モデルの毎ターンのプロンプトには必ず `[SWITCHMAN:POOLS]` 推薦表が載り、表に従って投げる。実行モードは3態：オフ / アドバイス / 強制（強制＝プール外のモデルは即拒否）。
 
-**2. 6 つのディスパッチプール：仕事に見合うモデルを選ぶ。** 軽量プール（economy、小口の大量タスク）、機械的プール（mechanical、テンプレート的な書き換え）、主力プール（main、日常のコーディング）、高難度プール（hard、難推論と大規模リファクタリング）、マルチモーダルプール（vision、画像の読み取り）、レビュープール（review、独立した検証）。設定ページで候補にチェックを入れ、優先順位を付け（S/A/B/C ティアのアンカーは任意）、ルートごとに思考強度をピン留めできます——強度のドロップダウンは各モデルが実際に対応しているレベルから直接来るもので、汎用の 3 段階ではありません。メインモデルのプロンプトには毎ラウンド `[SWITCHMAN:POOLS]` 推奨表が添えられ、表に従って仕事を振ります。実行モードは 3 態：オフ / アドバイス / 強制（強制 = プール外モデルは即座に拒否）。
+**3. Agent Teams モード：単独作業からチーム運用へ。** 既定はオフで、インストール直後は軽量なサブエージェント運用。設定ページに独立したトグルが2つ：
 
-**3. Agent Teams モード：単独作業からチーム運用へ。** デフォルトはオフで、導入直後は軽量な subagent ディスパッチです。設定ページには独立した 2 つのスイッチがあります：
+- **エージェントチーム**——オンにするとチーム規程（デフォルト委譲＋段階的検証＋共有タスクボードの規律）を注入し、DSH の Agent Teams を自動で有効にする：主モデルは常駐のチームメイトを引く（`spawn_teammate`）、共有タスクボードに仕事を置く（`team_task_*`）、チームメイトとメッセージをやり取りする。チームを組むべき場面は規律で決まっている：並列化できる独立サブタスク、量が多く自己完結した作業、主コンテキストの水位が既に高い、役割の分離が必要——使い捨ての単発調査は引き続きサブエージェントへ。トグルを戻せばチーム条項は跡形なく消え、実行中のセッションからチームツールを引き上げることもない。
+- **サブエージェントモデルのホワイトリスト同期**——DSH には「エージェントにサブエージェントのモデル選択を許可する」認可リストがある：プールで選んだのに認可されていないルートは、名指しでの発令が拒否される（チームモードでは ⚠ 表示）。このトグルを入れると、6プールの和集合がまるごとそのリストへ書き込まれる——switchman が唯一の情報源になり、二重管理は不要。リストは「新規セッション」単位のスナップショットで効き、同期はそれ以降に開いたセッションにだけ効く。
 
-- **エージェントチームモード**——オンにするとチーム規律（デフォルト委譲 + 段階的検証 + 共有タスクボードの規律）が注入され、DSH の Agent Teams が自動で有効になります：メインモデルは常駐チームメイトを招集し（`spawn_teammate`）、共有タスクボードに仕事を積み（`team_task_*`）、チームメイトとメッセージをやり取り（`send_message`）できます。チームを組むべきタイミングには明確な規律があります：並行して進められる独立サブタスク、量が多く自己完結した仕事、メインコンテキストの水位がすでに高いとき、役割の分離が必要なとき。単発の一点調査は引き続き subagent へ。DSH の出荷時ポリシーは「ユーザーが名指ししなければチームを作らない」ですが、ここでは「使うべきときに使う」へ反転します。スイッチをもう一度オフにすれば、チーム関連の条項は残さず消え、実行中のセッションからチームツールを引き剥がすこともありません。
-- **サブエージェントモデル許可リストの同期**——DSH には「Agent によるサブエージェントのモデル選択を許可」という承認リストがあります：プールで選んでも承認されていないルートを、メインモデルが名指しでディスパッチすると拒否されます（チームモードでは、推奨表と設定ページがそのようなルートに ⚠ を付けます）。このスイッチをオンにすると、6 プールの和集合がまるごとそのリストに書き込まれます——二重設定は不要になり、switchman が唯一の事実源となり、fork ディスパッチ経路もまとめて取り込まれます。許可リストは「新規セッション」時点のスナップショットで効くため、同期はそれ以降に開いたセッションにのみ反映されます。
+セッションヘッダーには即座に分かるフィードバックがある：⚡「自律チーム」バッジ、◇ 現在セッションの実際のモデル。自動引き継ぎの実行中は「引き継ぎ実行中 ・ バックアップセッション / コンテキスト圧縮 / 後継の起動」のライブ表示が出る。
 
-セッションヘッダーには分かりやすい表示が出ます：⚡「自律チーム」バッジ、◇ 現在のセッションで実際に使われているモデル。自動ハンドオーバーが進行している間は「ハンドオーバー進行中 · セッションをバックアップ / コンテキストを圧縮 / 起こして継続」というリアルタイム表示が現れます。
+**4. 言語設定：一度聞けば、ずっと守る。** 返信・コードコメント・ドキュメントの3言語にそれぞれドロップダウンが1つ。スコープはグローバルまたはプロジェクト単位（`.switchman/lang.json`）。未設定のままでもよい——初回使用時に DSH インターフェースの言語で一度だけ尋ね、覚えれば以後すべてのセッションが守る。
 
-**4. 言語設定：一度尋ねて、ずっと覚える。** 返信・コードコメント・ドキュメントの 3 種類それぞれにドロップダウンをひとつ、スコープはグローバルまたはプロジェクト単位（`.switchman/lang.json`）を選べます。設定しなくても構いません——最初に必要になった時点で、DSH の UI 言語で一度だけ尋ねて覚え、以後のすべてのセッションが自動で従います。
+**5. インターフェース言語：プラグイン自身もあなたの言葉で。** 設定ページ最上部の「インターフェース」領域にある「インターフェース言語」ドロップダウン（設定キー `uiLocale`）：自動（既定、DeepSeek Harness アプリの言語に追従）または内蔵のインターフェース言語から任意に選択——選択肢は常にその言語の原語名のまま、翻訳しない。切り替わるのはプラグイン自身のインターフェース（バッジ・ホームパネル・設定ページ）だけで、DSH アプリの言語は動かさない：選択はその場でプレビュー、再起動不要、保存後に記憶し次回起動時に復元、失敗時はすべてアプリの言語へフォールバックする。辞書はすべてプラグインバンドルに内蔵、ダウンロード不要。
 
-**5. 段階的検証：変えたら必ず確かめる。** 20 行を超える変更は tester による検証へ、300 行を超える変更やコア・セキュリティ・データ整合性のロジックに触れる変更は、さらに reviewer による独立レビューを重ねます。レビュー担当モデルは「この diff を書いたエージェント」が使ったモデルを基準に選び、可能な限りそれを避けます。プール内でどうしても避けられない場合は、結論に DOWNGRADED と明記されます。「チームを使うな」と一言言えば、即座に単独作業へ戻ります。
+**6. 段階的検証：直したら必ず検査する。** 20行超の変更は tester へ。300行超、またはコア / セキュリティ / データ整合性に触れる変更は、さらに reviewer の独立再審へ。再審モデルは「その diff を書いたエージェント」のモデルを錨に選び、極力避ける。プール内で避けきれない場合は、結論の中で DOWNGRADED と宣言される。「チームは使うな」の一言で即座に単独へ戻る。
 
-**6. `/vision`：テキスト専用モデルでも画像を扱える。** メインモデルが画像を読めないとき、DSH は入り口で画像付きメッセージをそのまま拒否します。画像を貼り付けて `/vision この画像のどこがおかしいか` と入力すれば、画像はファイルパスに解決されてマルチモーダルプールのモデルに読んでもらえ、結論は現在のセッションに戻ってきます。入力ボックスの上には「現在のモデルは画像を読み取れません」というヒントが先に表示されます。画像を直接送って拒否された場合は、自動的に `/vision` 形式に書き直して一度だけ再送するので、打ち直しは不要です。マルチモーダルプールが未設定の場合、コマンドは拒否して設定案内を示します。
+**7. `/vision`：テキスト専用モデルでも画像を扱える。** 主力モデルが画像を読めないとき、DSH は画像付きメッセージを入口で拒否する。画像を貼って `/vision この画像のどこが悪い` と打てば、画像は vision プールのモデルへ渡され、結論は現在のセッションに戻る。入力欄の上には「現在のモデルは画像を読めません」の事前表示が出る。画像を直接送って拒否されたら、自動で `/vision` に書き換えて再送するので手直しは不要。vision プールが未設定ならコマンドは拒否し、設定への案内を出す。
 
-モデルがひとつだけ？それでも入れる価値はあります——水位制御と段階的検証はモデルの数に依存せず、単一モデルの長時間セッションでも同じように恩恵を受けられます。
+モデルが1つでも入れる価値はある——水位制御と段階的検証はモデルの数と無関係で、単一モデルの長いセッションも同じく恩恵を受ける。
 
 ## 同梱スキル
 
-- **db-query** — MySQL / Redis の読み取り専用検証：SQL を回してレコードを突き合わせ、キャッシュキー / TTL を確認し、ストア横断の整合性をチェックします。書き込みは一切拒否します。初回使用時に初期化が必要です（下記参照）。
-- **git-commit-message** — 規範に沿った commit 文面を生成します。テキストだけを出力し、git の操作は一切代行しません。
-- **requirement-docs** — 要件分析 / PRD / 設計ドキュメントの統一規範。成果物は `docs/requirements-and-design/` にアーカイブします。
+- **db-query**——MySQL / Redis の読み取り専用検証：SQL でデータを突き合わせ、キャッシュキー / TTL を調べ、クロスDBの整合性を検査する。書き込みは一切拒否。初回使用前に初期化が必要（下記）。
+- **git-commit-message**——規約に沿ったコミットメッセージを生成する。テキストだけ出し、git を代行することはない。
+- **requirement-docs**——要件分析 / PRD / 設計ドキュメントの統一規程。成果物は `docs/requirements-and-design/` にアーカイブする。
 
 ## クイックスタート
 
-1. **インストール** — 任意のセッションでエージェントに実行させるか、Web のプラグイン管理ページから：
+1. **インストール**——任意のセッションで agent に実行させるか、Web のプラグイン管理ページで：
 
    ```
    plugin_manager: install_bundle  target=dsh-switchman
    ```
 
-   またはローカルチェックアウトから（link 方式。更新を取り込んだ後は `remove_bundle` + `install_bundle` で再インストール）：
+   またはローカルのチェックアウトから（link 方式。更新後は `remove_bundle` + `install_bundle` で入れ直す）：
 
    ```
    plugin_manager: install_bundle  target=/path/to/dsh-switchman
    ```
 
-   またはターミナルから `dsh` コマンドでインストール——実行形態に合わせてプロファイルを選びます：
+   または端末で `dsh` コマンドを——実行方法に合う profile を選ぶ：
 
    ```bash
    dsh plugin --profile web add dsh-switchman      # Web GUI
    dsh plugin --profile desktop add dsh-switchman   # デスクトップアプリ
    ```
 
-2. **DSH を再起動** — アプリを完全に終了してから開き直します（ページの再読み込みでは足りません）。クライアントモジュールのテーブルがこの bundle を認識できるようになります。
+2. **DSH を再起動**——アプリを完全に終了して開き直す（ページの再読み込みでは不可）。そうしてはじめてクライアントのモジュール表がこの bundle を認識する。
 
-3. **言語設定** — 設定 → dsh-switchman、またはホームのサイドバーにある「Switchman ディスパッチセンター」。最初の画面でスコープを選びます：グローバル（この profile）またはプロジェクト単位（各プロジェクトの `.switchman/lang.json`）。次に 3 つのドロップダウンで、返信 / コメント / ドキュメントの言語をそれぞれ決めます。各項目の下には「現在: …」のステータス行が付きます。飛ばしても大丈夫——最初に使うときに一度だけ尋ねて記憶します（尋ねる言語は DSH の UI 言語に従います）。
+3. **設定**——設定 → dsh-switchman、またはホームサイドバーの「Switchman ディスパッチセンター」。設定は1ページだけ。見た目はこうで、上から下へ一度なぞれば終わり：
 
-   ![言語設定：スコープと 3 つの言語](docs/assets/conf-language-en.png)
+   ![dsh-switchman 設定ページの全体：インターフェース言語、言語設定、6つのディスパッチプール、能力順位と実行モード、チームのトグル、コンテキスト水位とコマンド](docs/assets/conf-interface-ja.png)
 
-4. **ディスパッチプールを設定** — 各プールカードで、プロバイダー別にグループ化された候補モデルにチェックを入れます。「手動順」にチェックすると、カードは番号付き優先リストに変わり、↑ ↓ × で順序を調整できます。各ルートの横では思考強度をピン留めできます（初期値は「レーンに従う」。ピン留めすると、そのモデルが実際に対応しているレベルが選べます）。上部のサマリー行は進捗をリアルタイムに反映します。たとえば「プール設定 6/6 · ランク付け 2 件 · モード アドバイス」。
+   - **インターフェース**——プラグイン自身の UI 言語。図のドロップダウンは「日本語」——切り替えのライブプレビュー。出荷時の既定は「自動」（DSH アプリの言語に追従）。言語を選べばその場でページ全体が切り替わり、保存後に記憶、いつでも「自動」に戻せる。
+   - **言語**——エージェントの成果物の言語。図のスコープは「グローバル（この profile）」（プロジェクト単位も可、それぞれ `.switchman/lang.json` を読む）。返信 / コードコメント / ドキュメントの3つのドロップダウンは図ではすべて日本語で、各項目は「原語名（タグ）」表示——例えば「日本語 (ja)」。下には「現在：…」の状態行が付く。全部未設定でもよい——初回使用時に一度尋ね、覚えたらそれを使う。
+   - **ディスパッチプール**——六枚のカードが三列二段（上段 economy・mechanical・main、下段 hard・vision・review）。カードはプロバイダーごとに候補モデルにチェックを付ける。「手動順」にチェックすると番号付きの優先リストになり、↑ ↓ × で並べ替える。各ルートには思考強度をピン留めできる（既定「レーンに追従」）。最上部の集計行はリアルタイムに更新され、図では「4/6 プール構成済み ・ 順位 2 件 ・ モード アドバイス」。
+   - **能力順位 + 実行モード**——6プールの選択モデルの和集合を能力順に並べ、最強を先頭に（図では glm-5.3 を S、glm-5.3-flash を A に錨付き）。並べ替え・削減は自由。実行モードはアドバイス / 強制（強制＝プール外のモデルを即拒否）。
+   - **エージェントチーム**——チームモードとホワイトリスト同期の2つのトグル。既定は両方オフ。図ではオンで、トグルの下に同期状態行がある。
+   - **コンテキスト水位**——3段の閾値（図で 50000 / 90000 / 130000）、1回の読み取り予算（1500）、hard 段の挙動（絞って通す / ブロック）、自動引き継ぎトグル、サブエージェントの独立上限——すべてこの領域にある。最下部のコマンド行：`/ctx-pause` 介入を一時停止 ・ `/ctx-resume` 再開 ・ `/ctx-handover` すぐバックアップして引き継ぎ（セッションをアイドル境界まで導いてから圧縮するため、結果には数分かかることがある）。
 
-   ![ディスパッチプール：軽量 / 機械 / 主力 / 高難度の 4 プール](docs/assets/conf-pool-1-en.png)
+4. **確認**——セッションヘッダーに ⚡「自律チーム」バッジ（隣の ◇ に現在セッションのモデル）。あるいはモデルに「あなたのシステムプロンプトの最終段落の見出しは何か」と尋ねる——答えに dsh-switchman の規程が出てくれば正しい。
 
-   マルチモーダルプールとレビュープールはその下にあります。さらに下には**能力ランキング**（6 プールで選んだモデルの和集合。番号が能力順、最強が先頭、S/A/B/C ティアでアンカー可能）と**実行モード**（アドバイス / 強制）があります。
-
-   ![マルチモーダルプール・レビュープールと能力ランキング・実行モード](docs/assets/conf-pool-2-en.png)
-
-5. **エージェントチーム** — 2 つのスイッチはデフォルトでオフ。まずは純粋な subagent モードで回します。自分でチームを組んでほしいときは「エージェントチームモード」を、二重の承認設定を省きたいときは「サブエージェントモデル許可リストの同期」をオンにします——スイッチの下に「N 件を同期済み + 同期時刻」のステータス行が出て、書き込み結果を確認できます。
-
-   ![エージェントチーム：2 つのスイッチと許可リスト同期の状態](docs/assets/conf-team-en.png)
-
-6. **コンテキスト水位** — 3 段階のしきい値（デフォルト 50000 / 90000 / 130000）、1 回あたりの読み取り予算、hard 段の挙動（制限付き通過 / 遮断）、自動ハンドオーバーのスイッチ、サブエージェントの独立上限、そのすべてがこのエリアにあります。最下部にはコマンドが 1 行：`/ctx-pause` 介入を一時停止 · `/ctx-resume` 再開 · `/ctx-handover` 即座にバックアップして引き継ぐ（セッションをアイドル境界へ誘導し、圧縮のリトライ期間を待つため、結果まで数分かかることがあります）。
-
-   ![コンテキスト水位：しきい値・予算・コマンド](docs/assets/conf-ctx-en.png)
-
-7. **確認** — セッションヘッダーに ⚡「自律チーム」バッジが現れます（隣の ◇ に現在のセッションモデルが表示されます）。またはモデルに直接「システムプロンプトの最後のセクションのタイトルは何ですか」と尋ねてみてください。dsh-switchman の規律に言及するはずです。
-
-**db-query の初回セットアップ**（スクリプトの依存関係はスキルディレクトリ内に入るので、プロジェクトを汚しません）：
+**db-query の初回初期化**（スクリプトの依存はスキルディレクトリ内に置かれ、プロジェクトを汚さない）：
 
 ```bash
-bash <install-dir>/skills/db-query/scripts/setup.sh
+bash <インストールディレクトリ>/skills/db-query/scripts/setup.sh
 ```
 
 ## 仕組み
 
-- Host 側（`index.js` + `host/`）は、動的なシステムプロンプトセクション（言語 / レーン / 水位 / チーム）、読み取り予算と enforce の二重ゲート、4 つのスラッシュコマンド（ctx の 3 つ + `/vision`）を注入します。設定はすべて、保存した次のプロンプト組み立てから有効になり、再起動は不要です。
-- Client 側（`client.js`）は設定ページ、セッションヘッダーの ⚡ バッジと ◇ モデル表示、ハンドオーバー進行中の動的表示を描画します。公式の settings-form サービス経由です。
-- ホームのサイドバーにある「Switchman ディスパッチセンター」の入口は、クリック 1 回で同じ設定ページ（言語設定、ディスパッチプールとランキング、水位）を中央パネルとして開きます。元の設定入口もそのまま残ります。
-- `cordis.patch.yml` は出荷時プリセットのプラグインリストを完全に保持し、persona suffix だけを拡張します。Agent Teams ツール本体は出荷時の bundle から供給され、チームモードをオンにすると自動で有効になります。
+- ホスト側（`index.js` + `host/`）が動的なシステムプロンプト段（言語 / レーン / 水位 / チーム）、読み取り予算と enforce の二重ゲート、4つのスラッシュコマンド（ctx 3点セット + `/vision`）を注入する。保存した設定は次のターンのプロンプト組み立てで即効き、再起動は不要。
+- クライアント側（`client.js`）は設定ページ、セッションヘッダーの ⚡ バッジと ◇ モデル表示、引き継ぎ中のライブ表示を描画する。設定スナップショットは Host のルートファミリー経由で読み書きする。
+- ホームサイドバーの「Switchman ディスパッチセンター」入口は、ワンクリックで同じ設定ページを中央パネルで開く。元の設定入口は残る。
+- `cordis.patch.yml` は出荷プリセットのプラグイン一覧を完全に保ち、persona suffix だけを拡張する。Agent Teams ツール本体は出荷バンドル由来で、チームモードをONにすると自動で有効になる。
 
-## メンテナンス
+## メンテナンスの注意
 
-- DSH のアップグレード後に出荷時プリセットのプラグインリストが変わっていたら、新しい `presets/*.patch.yml` から `cordis.patch.yml` を再同期し（doctrine suffix は維持）、再インストールします。
-- プロトコル行（`[SWITCHMAN:LANG|POOLS|WATERMARK|TEAMS]`）は意図的に英語・バイト安定を保っています——ローカライズしないでください。
-- `npm pack --dry-run` は監査済みの 50 ファイル / ~205 kB の形を維持する必要があります（`docs/` のスクリーンショットはパッケージに入りません）。
+- DSH のアップグレードで出荷プリセットのプラグイン一覧が変わったら、新しい `presets/*.patch.yml` から `cordis.patch.yml` を再同期（doctrine suffix は保持）し、入れ直す。
+- プロトコル行（`[SWITCHMAN:LANG|POOLS|WATERMARK|TEAMS]`）は意図的に英語のままバイト安定——ローカライズしない。
+- `npm pack --dry-run` は監査済みの 50 ファイル / ~205 kB の形状を保つこと（`docs/` のスクリーンショットはパッケージに入らない）。
 
 ## License
 

package/README.ko.md

@@ -2,109 +2,99 @@
 
 [English](./README.md) | [简体中文](./README.zh.md) | [繁體中文](./README.zh-TW.md) | [日本語](./README.ja.md) | **한국어** | [Español](./README.es.md) | [Français](./README.fr.md) | [Deutsch](./README.de.md) | [Italiano](./README.it.md) | [Português](./README.pt.md) | [Русский](./README.ru.md)
 
-> **switchman 패밀리**, 같은 저자, 같은 조율 방침: [opencode-switchman](https://github.com/mrzturn/opencode-switchman)(OpenCode 원판) · [zcode-switchman](https://github.com/mrzturn/zcode-switchman)(ZCode 이식판) · **dsh-switchman**(이 저장소, DeepSeek Harness 버전).
+> **switchman 패밀리**, 같은 저자, 같은 디스패치 사상: [opencode-switchman](https://github.com/mrzturn/opencode-switchman)(OpenCode 원판) · [zcode-switchman](https://github.com/mrzturn/zcode-switchman)(ZCode 이식판) · **dsh-switchman**(이 저장소, DeepSeek Harness 버전).
 
-![dsh-switchman — 컨텍스트 수위가 전환수를 움직여 작업을 올바른 레인으로 던져 넣는다](docs/assets/hero.svg)
+![dsh-switchman — 컨텍스트 수위가 전철기를 돌려 태스크를 맞는 차선에 던져 넣는다](docs/assets/hero.svg)
 
-> 컨텍스트에 수도계량기를 달면, 작업이 스스로 레인을 찾습니다.
+> 컨텍스트에 수도계를 달면, 태스크가 스스로 차선을 찾는다.
 
 ## 왜 필요한가
 
-DSH 로 작업을 하다 보면 시간이 지날 때 두 가지에 부딪힙니다:
+DSH로 오래 일하면 귀찮은 일이 두 가지 생긴다. 첫째, 세션이 길어질수록 무거워진다. 히스토리가 컨텍스트를 수십만 토큰까지 밀어 올리면 모델은 까먹기 시작하고, 느려지고, 비싸진다. 수동 /compact 은 디테일을 잃는다. 둘째, 주력 모델이 뭐든 직접 한다. 파일을 뒤지고, 테스트를 돌리고, 데이터를 맞춰 보는 일 — 그 대부분은 사실 싼 모델에게 맡겨야 할 일이다.
 
-1. **세션이 갈수록 무거워집니다.** 히스토리가 컨텍스트를 수십만 token 까지 부풀리면, 모델은 건망증이 심해지고 느려지고 비용이 올라갑니다. 결국 수동 /compact 에 기댈 수밖에 없는데, 압축할 때마다 세부 사항이 떨어져 나갑니다.
-2. **주력 모델이 모든 걸 스스로 처리합니다.** 파일 하나 조회하고, 테스트를 돌리고, 데이터를 대조하는 것까지 전부 주력 모델이 씹어 먹습니다 — 느린 데다 비용도 많이 드는데, 그 대부분은 사실 저렴한 모델에 맡겨야 할 작업입니다.
+dsh-switchman은 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH) 플러그인이다. 설치하면 주 모델은 '직접 일하기'에서 디스패처로 바뀐다: 수위를 재고, 차선을 고르고, 태스크를 던지고, 인수를 검수한다. 새 모델이 아니다. DSH에 얹는 디스패치 규정과 설정 화면이며, 일곱 가지 일을 한다.
 
-dsh-switchman 은 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH) 플러그인입니다. 설치하고 나면 기본 모델은 "모든 걸 자기가 처리"하던 방식에서 디스패처로 바뀝니다: 수위를 재고, 레인을 고르고, 작업을 나눠주고, 검수를 확인합니다. 새로운 모델이 아니라 DSH 에 얹는 조율 규율 한 세트와 설정 화면 하나입니다. 구체적으로는 여섯 가지를 합니다:
+**1. 컨텍스트 수위: 긴 세션도 터지지 않게.** 매 턴 세션 토큰을 실시간으로 세고 세 단계 수위선이 순서대로 조인다: 50k(soft, 조정 가능)은 '이제 위임할 때', 90k(hard)은 1회 읽기 예산을 조이고 마무리로 유도하며, 130k(force)은 자동 인계다 — 세션을 fork해 기록으로 남기고, 컨텍스트를 압축하고, 후속을 깨워 이어 달린다. 태스크는 끊기지 않는다. 인계 순간에 돌고 있던 백그라운드 서브에이전트도 잃지 않는다: id, 태스크, 보고서 경로를 인계 문서에 적어 두어 재개된 세션은 어디서 보고를 받을지 알고 중복 발령하지 않는다. 서브에이전트마다 독립 하드 상한이 있어 도달하면 HANDOFF 요약을 쓰고 퇴장한다. 자동 개입이 손에 맞지 않으면 언제든 임시로 직접 맡을 수 있다: `/ctx-pause`는 수위 동작을 전부 멈춘다(측정은 계속 돌고 배너는 paused로 바뀐다, 그냥 손을 놓을 뿐), `/ctx-resume`으로 언제든 복구한다 — DSH를 재시작해도 개입은 자동으로 돌아온다. 잠시 손을 놓는 것이지 영구 끄기가 아니다. `/ctx-handover`는 수위가 차오르기를 기다리지 않고 같은 인계를 직접 시작한다: fork로 백업을 남기고, 컨텍스트를 압축하고, 후속을 깨워 이어 달린다(세션은 먼저 유휴 경계로 유도되므로 결과까지 몇 분 걸릴 수 있다).
 
-**1. 컨텍스트 수위: 긴 세션이 넘치지 않습니다.** 라운드마다 세션의 token 을 실시간으로 집계하고, 세 개의 수위선으로 단계적으로 강도를 높입니다: 50k(soft, 조정 가능)는 "이제 위임할 때"라고 알리고, 90k(hard)는 1회 파일 읽기 예산을 줄이며 마무리로 유도하고, 130k(force)는 자동 인계 — 세션을 fork 해 기록을 남기고, 컨텍스트를 압축하고, 이어받을 세션을 깨웁니다. 작업은 끊기지 않습니다. 인계 순간에 아직 실행 중이던 백그라운드 서브에이전트도 사라지지 않습니다: id, 작업 설명, 리포트 경로가 모두 인계 문서에 기록되어, 이어받은 세션은 리포트를 어디서 회수할지 알며 같은 일을 이중으로 시키지 않습니다. 나간 각 서브에이전트에는 독립 하드 한도가 붙고, 한도에 도달하면 HANDOFF 요약을 남기고 퇴장합니다.
+**2. 6개 디스패치 풀: 일에 맞는 모델.** economy(잔일 배치), mechanical(템플릿 개작), main(일상 코딩), hard(고난도 추론과 대규모 리팩터링), vision(이미지), review(독립 검증). 설정 페이지에서 후보에 체크하고, 우선순위를 정하고, S/A/B/C 등급을 매기고, 루트별로 추론 강도를 고정할 수도 있다 — 강도 드롭다운은 그 모델이 실제 지원하는 수준에서 오고, 범용 3단이 아니다. 주 모델의 매 턴 프롬프트에는 항상 `[SWITCHMAN:POOLS]` 추천표가 실리고, 표대로 발령한다. 실행 모드는 세 가지: 끔 / 조언 / 강제(강제 = 풀 밖 모델은 즉시 거절).
 
-**2. 여섯 개 디스패치 풀: 일에 맞는 모델을 붙입니다.** 경량 풀(economy, 소량 반복 작업), 기계 풀(mechanical, 템플릿형 재작성), 주력 풀(main, 일상 코딩), 고난도 풀(hard, 어려운 추론과 대규모 리팩터링), 멀티모달 풀(vision, 이미지 읽기), 리뷰 풀(review, 독립 검증). 설정 페이지에서 후보에 체크하고 우선순위를 정하며(S/A/B/C 티어 앵커는 선택), 라우트마다 사고 강도를 고정할 수 있습니다 — 강도 드롭다운은 각 모델이 실제 지원하는 레벨에서 직접 나오는 것이지 범용 3단계가 아닙니다. 기본 모델의 프롬프트에는 매 라운드 `[SWITCHMAN:POOLS]` 추천 표가 붙고, 모델은 그 표대로 일을 배분합니다. 실행 모드는 세 가지: 끄기 / 조언 / 강제(강제 = 풀 밖 모델은 즉시 거부).
+**3. Agent Teams 모드: 혼자 일하던 데서 팀 운영으로.** 기본은 꺼져 있고, 설치 직후에는 가벼운 subagent 발령이다. 설정 페이지에 독립 토글 두 개:
 
-**3. Agent Teams 모드: 단독 작업에서 팀 운영으로.** 기본값은 꺼짐이며, 설치 직후에는 가벼운 subagent 디스패치입니다. 설정 페이지에는 독립적인 스위치 두 개가 있습니다:
+- **에이전트 팀** — 켜면 팀 규정(기본 위임 + 단계별 검증 + 공유 태스크보드 규율)을 주입하고 DSH의 Agent Teams를 자동으로 켠다: 주 모델은 상주 팀원(`spawn_teammate`)을 뽑고, 공유 태스크보드(`team_task_*`)에 일을 올리고, 팀원과 메시지를 주고받는다. 팀을 꾸릴 때는 명확한 규율이 있다: 병렬로 돌릴 수 있는 독립 서브태스크, 양이 많고 자립적인 작업, 주 컨텍스트 수위가 이미 높음, 역할 분리 필요 — 한 번 쓰고 끝내는 단발 조사는 여전히 subagent로. 토글을 끄면 팀 조항은 흔적 없이 사라지고, 돌고 있는 세션에서 팀 도구를 걷어 가지도 않는다.
+- **서브에이전트 모델 화이트리스트 동기화** — DSH에는 '에이전트가 서브에이전트 모델을 고르도록 허용' 인가 화이트리스트가 있다: 풀에서 골랐지만 인가되지 않은 루트는 지명 발령이 거절된다(팀 모드에서는 ⚠ 표시). 이 토글을 켜면 6개 풀의 합집합이 통째로 그 화이트리스트에 기록된다 — switchman이 유일한 원천이 되어 이중 설정이 없어진다. 화이트리스트는 '새 세션' 스냅샷으로 적용되고, 동기화는 그 이후에 새로 연 세션에만 적용된다.
 
-- **에이전트 팀 모드** — 켜면 팀 규율(기본 위임 + 단계별 검증 + 공유 작업 보드 규율)이 주입되고, DSH 의 Agent Teams 가 자동으로 활성화됩니다: 기본 모델은 상주 팀원을 데려오고(`spawn_teammate`), 공유 작업 보드에 일을 올리고(`team_task_*`), 팀원과 메시지를 주고받습니다(`send_message`). 팀을 꾸릴 타이밍에는 명확한 규율이 있습니다: 병렬로 돌릴 수 있는 독립 서브태스크, 양이 많고 자기완결적인 작업, 기본 컨텍스트 수위가 이미 높을 때, 역할 분리가 필요할 때. 일회성 단발 조사는 여전히 subagent 로 갑니다. DSH 출하 정책은 "사용자가 지명하지 않으면 팀을 만들지 않음"이지만, 여기서는 "필요하면 쓴다"로 뒤집습니다. 스위치를 다시 끄면 팀 조항은 흔적 없이 사라지고, 실행 중인 세션에서 팀 도구를 빼앗는 일도 없습니다.
-- **서브에이전트 모델 허용 목록 동기화** — DSH 에는 "Agent 가 서브에이전트 모델 선택을 허용"하는 승인 목록이 있습니다: 풀에서 골랐지만 승인되지 않은 라우트를 기본 모델이 지명 디스패치하면 거부됩니다(팀 모드에서는 추천 표와 설정 페이지가 이런 라우트에 ⚠ 를 표시). 이 스위치를 켜면 여섯 풀의 합집합이 통째로 그 목록에 기록됩니다 — 양쪽에 이중 설정할 필요가 없어지고, switchman 이 유일한 사실 원천이 되며, fork 디스패치 경로도 함께 편입됩니다. 허용 목록은 "새 세션" 시점의 스냅샷으로 적용되므로, 동기화는 그 이후에 열린 세션에만 반영됩니다.
+세션 헤더에는 바로 보이는 피드백이 있다: ⚡ '자율 팀' 배지, ◇ 현재 세션의 실제 모델. 자동 인계가 진행 중일 때는 '인계 진행 중 · 백업 세션 / 컨텍스트 압축 / 후속 기상' 실시간 표시가 뜬다.
 
-세션 헤더에는 직관적인 피드백이 있습니다: ⚡ "자율 팀" 배지, ◇ 현재 세션의 실제 모델. 자동 인계가 진행되는 동안에는 "인계 진행 중 · 세션 백업 / 컨텍스트 압축 / 깨워서 계속" 실시간 안내가 나타납니다.
+**4. 언어 기본 설정: 한 번 물으면 평생 기억.** 답장, 코드 주석, 문서 세 가지 언어에 각각 드롭다운 하나. 범위는 전역 또는 프로젝트별(`.switchman/lang.json`). 안 두어도 된다 — 처음 쓸 때 DSH 인터페이스 언어로 한 번 물어보고, 기억하면 이후 모든 세션이 따른다.
 
-**4. 언어 기본 설정: 한 번 물어보고, 평생 기억합니다.** 답변·코드 주석·문서 세 종류에 각각 드롭다운 하나, 범위는 전역 또는 프로젝트별(`.switchman/lang.json`)에서 고를 수 있습니다. 설정하지 않아도 됩니다 — 처음 필요해졌을 때 DSH 화면 언어로 한 번 물어보고 기억한 뒤, 이후 모든 세션이 자동으로 따릅니다.
+**5. 인터페이스 언어: 플러그인도 당신 말을 쓴다.** 설정 페이지 맨 위 '인터페이스' 영역의 '인터페이스 언어' 드롭다운(설정 키 `uiLocale`): 자동(기본, DeepSeek Harness 앱 언어를 따름) 또는 내장 인터페이스 언어 중 아무거나 직접 선택 — 옵션은 항상 그 언어의 원명 그대로, 번역하지 않는다. 바뀌는 건 플러그인 자신의 인터페이스(배지, 홈 패널, 설정 페이지)뿐이고 DSH 앱 언어는 건드리지 않는다: 선택 즉시 미리보기, 재시작 불필요, 저장 후 기억하고 다음 실행 때 복원, 실패 시 모두 앱 언어로 되돌아간다. 사전은 전부 플러그인 번들에 내장, 다운로드 불필요.
 
-**5. 단계별 검증: 고치면 반드시 확인합니다.** 20줄을 넘는 변경은 tester 검증으로 넘기고, 300줄을 넘거나 코어·보안·데이터 일관성 로직을 건드린 변경에는 reviewer 의 독립 리뷰를 한 겹 더 얹습니다. 리뷰 모델은 "이 diff 를 쓴 에이전트"가 쓰던 모델을 기준으로 골라 가급적 피합니다. 풀 안에서 어쩔 수 없이 피할 수 없을 때는 결론에 DOWNGRADED 로 선언합니다. "팀 쓰지 마" 한마디면 즉시 단독 작업으로 돌아갑니다.
+**6. 단계별 검증: 고치면 반드시 검사.** 20줄 넘는 변경은 tester에게. 300줄 초과, 또는 코어 / 보안 / 데이터 일관성 로직을 건드린 변경은 reviewer 독립 재검까지. 재검 모델은 '그 diff를 쓴 에이전트'의 모델을 앵커로 골라 최대한 피하고, 풀 안에서 피할 수 없으면 결론에 DOWNGRADED를 명시한다. "팀 쓰지 마" 한마디면 즉시 혼자 일하는 모드로 돌아간다.
 
-**6. `/vision`: 텍스트 전용 모델도 이미지를 다룹니다.** 주력 모델이 이미지를 읽지 못하면 DSH 는 입구에서 이미지가 붙은 메시지를 바로 거부합니다. 이미지를 붙이고 `/vision 이 이미지 어디가 잘못됐나요` 를 입력하면, 이미지는 파일 경로로 해석되어 멀티모달 풀의 모델이 읽고 결론이 현재 세션으로 돌아옵니다. 입력창 위에는 "현재 모델은 이미지를 읽을 수 없습니다" 안내가 미리 뜹니다. 이미지를 바로 보냈다가 거부되면 `/vision` 형태로 자동으로 고쳐 한 번만 재전송하므로 다시 타이핑할 필요가 없습니다. 멀티모달 풀이 설정되지 않으면 명령은 거부하며 설정 안내를 보여줍니다.
+**7. `/vision`: 텍스트 전용 모델도 이미지를 다룬다.** 주력 모델이 이미지를 못 읽으면 DSH는 이미지 포함 메시지를 입구에서 거절한다. 이미지를 붙이고 `/vision 이 이미지 어디가 잘못됐어`라고 입력하면 이미지는 vision 풀 모델에게 넘어가고 결론이 현재 세션으로 돌아온다. 입력창 위에는 '현재 모델은 이미지를 읽을 수 없음' 안내가 미리 뜬다. 이미지를 직접 보내다 거절되면 자동으로 `/vision`으로 고쳐 다시 보낸다 — 손으로 다시 할 필요 없다. vision 풀이 비어 있으면 명령은 거절하고 설정 안내를 준다.
 
-모델이 하나뿐인가요? 그래도 설치할 가치가 있습니다 — 수위 제어와 단계별 검증은 모델 개수와 무관하므로, 단일 모델의 긴 세션도 똑같이 이득을 봅니다.
+모델이 하나뿐이어도 설치할 가치가 있다 — 수위 제어와 단계별 검증은 모델 수와 무관하고, 단일 모델의 긴 세션도 같은 혜택을 본다.
 
 ## 번들 스킬
 
-- **db-query** — MySQL / Redis 읽기 전용 검증: SQL을 돌려 레코드를 대조하고, 캐시 키 / TTL 을 확인하며, 스토어 간 일관성을 검사합니다. 쓰기는 일절 거부합니다. 최초 사용 시 초기화가 필요합니다(아래 참조).
-- **git-commit-message** — 규범에 맞는 commit 문구를 생성합니다. 텍스트만 내보내고 git 작업은 절대 대신하지 않습니다.
-- **requirement-docs** — 요구사항 분석 / PRD / 설계 문서의 통일 규범. 산출물은 `docs/requirements-and-design/` 에 아카이브합니다.
+- **db-query** — MySQL / Redis 읽기 전용 검증: SQL로 데이터를 대조하고, 캐시 키 / TTL을 조회하고, DB 간 일관성을 검사한다. 쓰기는 일절 거절. 첫 사용 전 초기화 필요(아래).
+- **git-commit-message** — 규칙에 맞는 커밋 메시지를 만든다. 텍스트만 내고 git을 대신 실행하지 않는다.
+- **requirement-docs** — 요구사항 분석 / PRD / 설계 문서의 통일 규범. 산출물은 `docs/requirements-and-design/`에 보관된다.
 
 ## 빠른 시작
 
-1. **설치** — 아무 세션에서나 에이전트에게 실행시키거나, 웹 플러그인 관리 페이지에서:
+1. **설치** — 아무 세션이나 agent에게 실행시키거나, Web 플러그인 관리 페이지에서:
 
    ```
    plugin_manager: install_bundle  target=dsh-switchman
    ```
 
-   또는 로컬 체크아웃에서(link 방식. 업데이트 반영 후 `remove_bundle` + `install_bundle` 로 재설치):
+   또는 로컬 체크아웃에서 설치(link 방식. 업데이트 후에는 `remove_bundle` + `install_bundle`으로 재설치):
 
    ```
    plugin_manager: install_bundle  target=/path/to/dsh-switchman
    ```
 
-   또는 터미널에서 `dsh` 명령으로 설치 — 실행 방식에 맞는 프로파일을 고르세요:
+   또는 터미널에서 `dsh` 명령으로 — 실행 방식에 맞는 profile을 고른다:
 
    ```bash
    dsh plugin --profile web add dsh-switchman      # Web GUI
    dsh plugin --profile desktop add dsh-switchman   # 데스크톱 앱
    ```
 
-2. **DSH 재시작** — 앱을 완전히 종료한 뒤 다시 엽니다(페이지 새로고침으로는 부족). 클라이언트 모듈 테이블이 이 bundle 을 인식하게 됩니다.
+2. **DSH 재시작** — 앱을 완전히 끄고 다시 연다(페이지 새로고침은 안 된다). 그래야 클라이언트 모듈 테이블이 이 번들을 알아본다.
 
-3. **언어 기본 설정** — 설정 → dsh-switchman, 또는 홈 사이드바의 "Switchman 디스패치 센터". 첫 화면에서 범위를 고릅니다: 전역(이 profile) 또는 프로젝트별(각 프로젝트의 `.switchman/lang.json`). 그다음 드롭다운 세 개로 답변 / 주석 / 문서의 언어를 각각 정합니다. 각 항목 아래에는 "현재: …" 상태 줄이 붙습니다. 건너뛰어도 괜찮습니다 — 처음 사용할 때 한 번 물어보고 기억합니다(질문 언어는 DSH UI 언어를 따릅니다).
+3. **설정** — 설정 → dsh-switchman, 또는 홈 사이드바의 'Switchman 디스패치 센터'. 설정은 한 페이지, 생김새는 이렇다. 위에서 아래로 한 번 훑으면 끝:
 
-   ![언어 기본 설정: 범위와 세 가지 언어](docs/assets/conf-language-en.png)
+   ![dsh-switchman 설정 페이지 전체 모습: 인터페이스 언어, 언어 기본 설정, 6개 디스패치 풀, 능력 순위와 실행 모드, 팀 토글, 컨텍스트 수위와 명령](docs/assets/conf-interface-ko.png)
 
-4. **디스패치 풀 구성** — 각 풀 카드에서 공급자별로 묶인 후보 모델에 체크합니다. "수동 순서"에 체크하면 카드가 번호식 우선순위 목록으로 바뀌고, ↑ ↓ × 로 순서를 조정합니다. 라우트마다 사고 강도를 고정할 수도 있습니다(기본값은 "레인 따르기". 고정하면 해당 모델이 실제 지원하는 레벨이 선택지로 나옵니다). 상단 요약 줄은 진행 상황을 실시간으로 반영합니다. 예: "풀 구성 6/6 · 랭킹 2개 · 모드 조언".
+   - **인터페이스** — 플러그인 자체 UI 언어. 그림의 드롭다운은 '한국어' — 전환 미리보기. 출고 기본은 '자동'(DSH 앱 언어를 따름). 언어를 고르면 그 자리에서 페이지 전체가 바뀌고 저장 후 기억된다. 언제든 '자동'으로 되돌릴 수 있다.
+   - **언어** — 에이전트 산출물의 언어. 그림의 범위는 '전역(이 profile)'(프로젝트별도 가능, 각자 `.switchman/lang.json`을 읽는다). 답장 / 코드 주석 / 문서 세 드롭다운은 그림에서 모두 한국어, 각 항목은 '원명 (태그)' 표기 — 예: '한국어 (ko)'. 아래에는 '현재: …' 상태 줄이 따른다. 셋 다 안 두어도 된다 — 처음 쓸 때 한 번 물어보고 기억하면 그걸 쓴다.
+   - **디스패치 풀** — 두 줄에 세 장씩 여섯 카드(위 economy/mechanical/main, 아래 hard/vision/review). 카드는 공급자별로 묶은 후보 모델에 체크. '수동 순서'에 체크하면 번호 매긴 우선 목록이 되고 ↑ ↓ ×로 순서를 정한다. 루트별로 추론 강도를 고정할 수 있다(기본 '레인 따름'). 맨 위 요약 줄은 실시간 갱신되고 그림에서는 '4/6 풀 구성됨 · 순위 2건 · 모드 조언'.
+   - **능력 순위 + 실행 모드** — 6개 풀에서 선택한 모델의 합집합을 능력순으로, 최강이 맨 앞(그림에서 glm-5.3은 S, glm-5.3-flash는 A에 고정). 순서 조정과 삭제가 가능하다. 실행 모드는 조언 / 강제(강제 = 풀 밖 모델 즉시 거절).
+   - **에이전트 팀** — 팀 모드와 화이트리스트 동기화 두 토글. 기본은 둘 다 꺼짐. 그림에서는 켜져 있고 토글 아래에 동기화 상태 줄이 있다.
+   - **컨텍스트 수위** — 3단 임계값(그림에서 50000 / 90000 / 130000), 1회 읽기 예산(1500), hard 단계 동작(조여 통과 / 차단), 자동 인계 토글, 서브에이전트 독립 상한이 모두 이 영역에 있다. 맨 아래 명령 줄: `/ctx-pause` 개입 일시정지 · `/ctx-resume` 재개 · `/ctx-handover` 즉시 백업하고 인계(세션을 유휴 경계로 이끈 뒤 압축하므로 결과까지 몇 분 걸릴 수 있다).
 
-   ![디스패치 풀: 경량 / 기계 / 주력 / 고난도 4개 풀](docs/assets/conf-pool-1-en.png)
+4. **확인** — 세션 헤더에 ⚡ '자율 팀' 배지(옆 ◇에 현재 세션 모델)가 뜬다. 또는 모델에게 '너의 시스템 프롬프트 마지막 단락 제목이 뭐야?'라고 물어보라 — 답에 dsh-switchman 규정이 언급되어야 한다.
 
-   멀티모달 풀과 리뷰 풀은 그 아래에 있습니다. 더 아래로는 **능력 랭킹**(여섯 풀에서 선택한 모델의 합집합. 번호가 곧 능력 순서, 최강이 먼저, S/A/B/C 티어 앵커 가능)과 **실행 모드**(조언 / 강제)가 있습니다.
-
-   ![멀티모달 풀·리뷰 풀과 능력 랭킹·실행 모드](docs/assets/conf-pool-2-en.png)
-
-5. **에이전트 팀** — 두 스위치 모두 기본값은 꺼짐. 먼저 순수 subagent 모드로 돌려 보세요. 스스로 팀을 꾸리게 하려면 "에이전트 팀 모드"를, 양쪽 이중 승인을 없애려면 "서브에이전트 모델 허용 목록 동기화"를 켭니다 — 스위치 아래에 "N개 동기화됨 + 동기화 시각" 상태 줄이 나타나 기록 결과를 확인할 수 있습니다.
-
-   ![에이전트 팀: 두 스위치와 허용 목록 동기화 상태](docs/assets/conf-team-en.png)
-
-6. **컨텍스트 수위** — 3단계 임계값(기본값 50000 / 90000 / 130000), 1회 읽기 예산, hard 단계 동작(제한 허용 / 차단), 자동 인계 토글, 서브에이전트 독립 한도가 모두 이 영역에 있습니다. 맨 아래 한 줄의 명령: `/ctx-pause` 개입 일시 중지 · `/ctx-resume` 재개 · `/ctx-handover` 즉시 백업 후 인계(세션을 유휴 경계로 유도하고 컴팩션 재시도 창을 기다리므로 결과까지 몇 분 걸릴 수 있습니다).
-
-   ![컨텍스트 수위: 임계값·예산·명령](docs/assets/conf-ctx-en.png)
-
-7. **검증** — 세션 헤더에 ⚡ "자율 팀" 배지가 나타납니다(옆의 ◇ 에 현재 세션 모델이 표시됩니다). 또는 모델에게 직접 "시스템 프롬프트 마지막 섹션의 제목이 뭐예요?"라고 물어보세요. dsh-switchman 규율을 언급해야 합니다.
-
-**db-query 최초 사용 초기화**(스크립트 의존성은 스킬 디렉터리 안에 설치되어 프로젝트를 오염시키지 않습니다):
+**db-query 첫 사용 초기화**(스크립트 의존성은 스킬 디렉터리 안에 설치되어 프로젝트를 오염시키지 않는다):
 
 ```bash
-bash <install-dir>/skills/db-query/scripts/setup.sh
+bash <설치-디렉터리>/skills/db-query/scripts/setup.sh
 ```
 
-## 동작 방식
+## 작동 원리
 
-- Host 쪽(`index.js` + `host/`)은 동적 시스템 프롬프트 섹션(언어 / 레인 / 수위 / 팀), 읽기 예산과 enforce 이중 게이트, 4개의 슬래시 명령(ctx 3개 + `/vision`)을 주입합니다. 설정은 모두 저장 후 다음 프롬프트 조립부터 적용되며 재시작이 필요 없습니다.
-- Client 쪽(`client.js`)은 설정 페이지, 세션 헤더의 ⚡ 배지와 ◇ 모델 표시, 인계 진행 중 동적 안내를 렌더링합니다. 공식 settings-form 서비스를 통해 이루어집니다.
-- 홈 사이드바의 "Switchman 디스패치 센터" 항목은 클릭 한 번으로 같은 설정 페이지(언어 기본 설정, 디스패치 풀과 랭킹, 수위)를 중앙 패널로 엽니다. 기존 설정 입구도 그대로 유지됩니다.
-- `cordis.patch.yml` 은 출하 시 기본 프리셋의 플러그인 목록을 그대로 유지하고 persona suffix 만 확장합니다. Agent Teams 도구 본체는 출하 bundle 에서 오며, 팀 모드를 켜면 자동으로 활성화됩니다.
+- 호스트 쪽(`index.js` + `host/`)이 동적 시스템 프롬프트 단(언어 / 레인 / 수위 / 팀), 읽기 예산과 enforce 이중 게이트, 슬래시 명령 4개(ctx 3종 + `/vision`)를 주입한다. 설정을 저장하면 다음 턴 프롬프트 조립 때 바로 반영되고 재시작은 필요 없다.
+- 클라이언트 쪽(`client.js`)은 설정 페이지, 세션 헤더의 ⚡ 배지와 ◇ 모델 표시, 인계 진행 중 동적 표시를 그린다. 설정 스냅샷은 Host 라우트 패밀리를 통해 읽고 쓴다.
+- 홈 사이드바의 'Switchman 디스패치 센터' 입구는 클릭 한 번으로 같은 설정 페이지를 중앙 패널로 연다. 기존 설정 입구는 그대로 둔다.
+- `cordis.patch.yml`은 출고 프리셋 플러그인 목록을 온전히 유지하고 persona suffix만 확장한다. Agent Teams 도구 본체는 출고 번들에서 오며 팀 모드를 켜면 자동으로 활성화된다.
 
-## 유지 보수
+## 유지보수 주의사항
 
-- DSH 업그레이드 후 출하 시 기본 프리셋 플러그인 목록이 바뀌었다면, 새 `presets/*.patch.yml` 에서 `cordis.patch.yml` 을 다시 동기화하고(doctrine suffix 유지), 재설치합니다.
-- 프로토콜 줄(`[SWITCHMAN:LANG|POOLS|WATERMARK|TEAMS]`)은 의도적으로 영어·바이트 안정을 유지합니다 — 현지화하지 마십시오.
-- `npm pack --dry-run` 은 감사된 43개 파일 / ~205 kB 형태를 유지해야 합니다(`docs/` 스크린샷은 패키지에 포함되지 않습니다).
+- DSH 업그레이드 후 출고 프리셋 플러그인 목록이 바뀌면 새 `presets/*.patch.yml`에서 `cordis.patch.yml`을 다시 동기화하고(doctrine suffix 유지) 재설치한다.
+- 프로토콜 행(`[SWITCHMAN:LANG|POOLS|WATERMARK|TEAMS]`)은 의도적으로 영어 그대로 바이트 안정으로 둔다 — 현지화하지 않는다.
+- `npm pack --dry-run`은 감사된 50 파일 / ~205 kB 형태를 유지해야 한다(`docs/` 스크린샷은 패키지에 들어가지 않는다).
 
 ## License