dsh-switchman 1.7.1 → 1.8.0

package/README.pt.md

@@ -12,9 +12,9 @@
 
 Se você trabalha com o DSH, com o tempo esbarra em duas coisas: a sessão fica cada vez mais pesada — o histórico empurra o contexto para centenas de milhares de tokens, o modelo começa a esquecer, fica lento e caro, e o /compact manual compacta perdendo detalhes no processo; e o modelo principal faz tudo sozinho — consultar um arquivo, rodar um teste, conferir dados: é sempre ele que mastiga tudo, lento e caro, sendo que a maior parte desse trabalho caberia a um modelo barato.
 
-dsh-switchman é um plugin para o [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). Depois de instalado, o modelo principal deixa de “fazer tudo sozinho” e vira um dispatcher: mede o nível de água, escolhe a faixa, entrega as tarefas, confere o resultado. Não é um modelo novo: é um regulamento de despacho plugado ao DSH mais uma interface de configuração. Em concreto, ele faz sete coisas:
+dsh-switchman é um plugin para o [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). Depois de instalado, o modelo principal deixa de “fazer tudo sozinho” e vira um dispatcher: mede o nível de água, escolhe a faixa, entrega as tarefas, confere o resultado. Não é um modelo novo: é um regulamento de despacho plugado ao DSH mais uma interface de configuração. Em concreto, ele faz oito coisas:
 
-**1. Nível de água do contexto: sessões longas não estouram.** A cada turno ele conta os tokens da sessão em tempo real, e três limiares apertam em degraus: 50k (soft, ajustável) lembra que “é hora de delegar”; 90k (hard) aperta o orçamento de leitura por chamada e empurra para encerrar; 130k (force) dispara o handover automático — fork da sessão como cópia de segurança, contexto compactado, continuação despertada: a tarefa não cai no meio. Nem os subagents em segundo plano que ainda estiverem rodando no momento da entrega se perdem: id, descrição da tarefa e caminho do relatório vão para o documento de handover, e a sessão retomada sabe onde coletar os relatórios em vez de despachar o mesmo trabalho de novo. Cada subagent enviado carrega um teto próprio e independente e, ao atingi-lo, sai depois de escrever o resumo HANDOFF. Se a intervenção automática não estiver do seu jeito, assuma o comando manualmente a qualquer momento: `/ctx-pause` interrompe todas as ações do nível (a medição continua rodando, o aviso muda para paused — só deixa de agir), `/ctx-resume` retoma a qualquer momento — depois de reiniciar o DSH a intervenção também volta sozinha, você tira o pé por um tempo, não desliga de vez; `/ctx-handover` não espera o nível encher e dispara sob demanda o mesmo handover: fork de uma cópia de segurança, compactação do contexto, despertar da continuação (a sessão é conduzida primeiro até o limite de inatividade, então o resultado pode demorar alguns minutos).
+**1. Nível de água do contexto: sessões longas não estouram.** A cada turno ele conta os tokens da sessão em tempo real, e três limiares apertam em degraus: 80k (soft, ajustável) lembra que “é hora de delegar”; 120k (hard) aperta o orçamento de leitura por chamada e empurra para encerrar; 150k (force) dispara o handover automático — fork da sessão como cópia de segurança, contexto compactado, continuação despertada: a tarefa não cai no meio. Nem os subagents em segundo plano que ainda estiverem rodando no momento da entrega se perdem: id, descrição da tarefa e caminho do relatório vão para o documento de handover, e a sessão retomada sabe onde coletar os relatórios em vez de despachar o mesmo trabalho de novo. Cada subagent enviado carrega um teto próprio e independente e, ao atingi-lo, sai depois de escrever o resumo HANDOFF. Se a intervenção automática não estiver do seu jeito, assuma o comando manualmente a qualquer momento: `/ctx-pause` interrompe todas as ações do nível (a medição continua rodando, a linha de nível de água ao vivo do final muda para paused — só deixa de agir), `/ctx-resume` retoma a qualquer momento — depois de reiniciar o DSH a intervenção também volta sozinha, você tira o pé por um tempo, não desliga de vez; `/ctx-handover` não espera o nível encher e dispara sob demanda o mesmo handover: fork de uma cópia de segurança, compactação do contexto, despertar da continuação (a sessão é conduzida primeiro até o limite de inatividade, então o resultado pode demorar alguns minutos).
 
 **2. Seis pools de despacho: a cada trabalho, o seu modelo.** Pool leve (economy, trabalho pequeno em lote), pool mecânico (mechanical, reescritas de molde), pool principal (main, codificação do dia a dia), pool difícil (hard, raciocínio pesado e refatoração em grande escala), pool multimodal (vision, leitura de imagens), pool de revisão (review, verificação independente). Na página de configurações você marca os candidatos, ordena as prioridades (com níveis opcionais S/A/B/C) e fixa um reasoning effort por rota — o dropdown lista os níveis que aquele modelo realmente suporta, não três níveis genéricos. A cada turno, o prompt do modelo principal carrega uma tabela de recomendações `[SWITCHMAN:POOLS]`: o trabalho é despachado seguindo a tabela. O modo de execução tem três estados: off / advice / enforce (enforce = modelos fora do pool são recusados na hora).
 
@@ -33,6 +33,8 @@ O cabeçalho da sessão dá um retorno imediato: badge ⚡ “Equipe autônoma
 
 **7. `/vision`: até modelo somente texto lida com imagens.** Quando o modelo principal não sabe ler imagens, o DSH recusa na entrada as mensagens que as trazem. Você anexa a imagem e digita `/vision onde está o erro nesta imagem`: a imagem é entregue à leitura de um modelo do pool multimodal, e a conclusão volta para a sessão atual. Acima da caixa de entrada aparece antes o aviso “o modelo atual não suporta leitura de imagens”; se um envio direto da imagem for recusado, a mensagem é reescrita uma vez para `/vision` e reenviada sozinha, sem precisar refazer à mão; sem pool multimodal configurado, o comando recusa e indica como configurar.
 
+**8. Roteamento por intenção: o modelo certo se escolhe sozinho.** A página de configurações ganha um grupo “Roteamento por intenção”: uma chave mestra (desligada por padrão; para ligar são precisos um classificador e pelo menos um candidato), a rota do modelo pequeno do classificador (provider + model + effort opcional — servem tanto modelos de decisão tipo TypeSafe Jev quanto modelos de conversa genéricos, e a saída é interpretada com tolerância), uma escolha do tipo de classificador em três opções (auto / decision / chat), uma lista de candidatos independente (cada candidato: provider + model + effort opcional + uma nota de capacidade de uma linha), a janela de cache em segundos (300 por padrão, alinhada com os caches de prompt dos provedores, cerca de 5 minutos), o limiar de confiança para a troca (80 por padrão), o timeout de classificação (60000 ms por padrão), a contagem de mensagens do histórico (6 por padrão) e o orçamento de caracteres (2400 por padrão), além de um modelo de fallback opcional. No seletor de modelos aparece uma entrada “Auto” no grupo “Auto · Switchman” (o cliente a renderiza localizada — “Automático (roteamento por intenção)” em português); escolhida, cada mensagem do usuário passa pelo classificador para eleger o melhor candidato, e a decisão fica travada por aquele turno: se a confiança não alcança ou a janela de cache ainda está aberta, o modelo atual permanece (reaproveitando o cache); só troca quando a confiança é suficiente ou o modelo atual não está entre os candidatos. A troca acontece em silêncio na camada de chamada — nenhuma mensagem de “modelo trocado” entra na sessão. Acima da caixa de entrada há um chip de status (no roteamento automático, ele mostra o modelo roteado atual e a confiança da última decisão); candidatos e limiares ficam sempre visíveis na página de configurações.
+
 Só um modelo? Ainda vale a pena instalar — o controle do nível de água e a verificação em níveis não ligam para quantos modelos você tem, e sessões longas de modelo único se beneficiam do mesmo jeito.
 
 ## Skills embutidas
@@ -73,7 +75,8 @@ Só um modelo? Ainda vale a pena instalar — o controle do nível de água e a
    - **Pools de despacho** — seis cards em duas fileiras de três: em cima leve / mecânico / principal; embaixo difícil / multimodal / revisão. Em cada card você marca os candidatos agrupados por provider; marque “ordem manual” e ele vira uma lista de prioridade numerada, reordenável com ↑ ↓ ×; ao lado de cada rota dá para fixar o reasoning effort (padrão “seguir a faixa”). A linha de resumo no topo se atualiza em tempo real; na captura: “4/6 pools configurados · 2 no ranking · modo advice”.
    - **Ranking de capacidade + modo de execução** — a união dos modelos escolhidos nos seis pools, ordenada por capacidade com os mais fortes na frente (na captura glm-5.3 ancorado em S e glm-5.3-flash ancorado em A); dá para reordenar e cortar; o modo de execução vai de advice / enforce (enforce = modelos fora do pool são recusados na hora).
    - **Equipe de agentes** — as duas chaves, modo equipe e sincronização da whitelist, começam desligadas; na captura estão ligadas, e abaixo de cada uma há uma linha de status de sincronização.
-   - **Nível de água do contexto** — os três limiares (na captura 50000 / 90000 / 130000), o orçamento de leitura por chamada (1500), o comportamento do limiar hard (deixa passar com limitação / bloqueia), a chave do handover automático e o teto independente dos subagents ficam todos nesta área. Uma linha de comandos embaixo: `/ctx-pause` pausa as intervenções · `/ctx-resume` retoma · `/ctx-handover` faz backup e entrega na hora (ele conduz a sessão até o limite de inatividade antes de compactar: o resultado pode levar alguns minutos).
+   - **Nível de água do contexto** — os três limiares (na captura 80000 / 120000 / 150000), o orçamento de leitura por chamada (3000), o comportamento do limiar hard (deixa passar com limitação / bloqueia), a chave do handover automático e o teto independente dos subagents ficam todos nesta área. Uma linha de comandos embaixo: `/ctx-pause` pausa as intervenções · `/ctx-resume` retoma · `/ctx-handover` faz backup e entrega na hora (ele conduz a sessão até o limite de inatividade antes de compactar: o resultado pode levar alguns minutos).
+   - **Roteamento por intenção** — a chave mestra, a rota do modelo pequeno do classificador, o tipo de classificador (auto / decision / chat), a lista de candidatos independente (cada um com sua nota de capacidade), janela de cache / limiar de confiança / timeout / orçamento de histórico e um modelo de fallback opcional. Ligado, o seletor de modelos ganha a entrada localizada “Automático (roteamento por intenção)” e acima da caixa de entrada aparece o chip com o modelo roteado e a confiança.
 
 4. **Verifique** — no cabeçalho da sessão aparece o badge ⚡ “Equipe autônoma” (ao lado, o ◇ mostra o modelo da sessão atual); ou pergunte direto ao modelo “qual é o título da última seção do seu system prompt?” — a resposta deve mencionar a doutrina dsh-switchman.
 
@@ -83,9 +86,27 @@ Só um modelo? Ainda vale a pena instalar — o controle do nível de água e a
 bash <install-dir>/skills/db-query/scripts/setup.sh
 ```
 
+**Dicas de escolha do classificador:** para rodar o modelo de decisão localmente, o recomendado é servir `tev1:4b-mxfp8` com Ollama: escolha o tipo de classificador “endpoint de decisão (systemone)”, preencha o endpoint com `http://127.0.0.1:11434/v1/systemone` e coloque `tev1:4b-mxfp8` como nome do modelo. Se preferir o classificador de chat do catálogo LLM, aposte em um modelo pequeno na nuvem, ou em um modelo local pequeno sem capacidade de pensamento (raciocínio): desligar o pensamento reduz ao mesmo tempo a latência e a taxa de falhas por timeout de classificação.
+
+## Configuração padrão
+
+Estes são todos os valores logo depois de uma instalação nova (fonte autoritativa: o esquema zod em `host/config.js`).
+
+**Interface e idiomas**: `uiLocale` = `auto` (segue o idioma do app DSH); `langScope` = `global`; `langConversation/Comments/Docs` = vazios (pergunta uma vez na primeira sessão e fica guardado; o idioma de comentários e documentos segue o da conversa).
+
+**Pools de despacho**: as seis faixas (economy/mechanical/main/hard/vision/review) começam sem candidatos (= os modelos padrão do sistema, sem intervenção); ordem manual e effort fixado desligados/vazios; `dispatchEnforce` = `advice` (só aconselha, não obriga).
+
+**Nível de água do contexto**: soft `80000` / hard `120000` / force `150000` tokens; orçamento de leitura por chamada `3000`; comportamento ao estourar o orçamento `cap` (corta e avisa); `wmAutoHandover` = ligado (no force, backup automático + entrega com compactação); o teto dos subagents = ligado (150k compartilhadas).
+
+**Agent Teams**: `teamsMode` = desligado; `syncWhitelist` = desligado (as duas chaves são independentes entre si).
+
+**Roteamento por intenção** (indisponível por padrão; são precisos classificador + pelo menos um candidato + ligar a chave mestra): `intentEnabled` = desligado (desligado, a entrada Auto fica oculta e as sessões que já a tinham escolhido caem na cadeia de fallback); rota do classificador sem definir; tipo de classificador `chat`; lista de candidatos vazia (as categorias pré-instaladas só entram no roteamento com um modelo preenchido); janela de cache `300` s / limiar de confiança da troca `80` / timeout de classificação `60000` ms; histórico de `6` mensagens / `2400` caracteres; `intentContextWindow` = `200000`.
+
+**Observações de fábrica**: ① o roteamento por intenção vir indisponível de fábrica é proposital — três passos para ligar (classificador, candidatos, chave); ② a janela efetiva do Auto já nasce em 200000 — o guard-rail garante 0.8×janela ≥ force (150000), então a linha de compactação do núcleo (160000) fica sempre depois da linha de entrega suave (150000); ③ o que mais se sente de fábrica é o trio de níveis: 80k lembra de delegar / 120k aperta a leitura / 150k faz backup e entrega sozinho — sem nenhuma configuração.
+
 ## Como funciona
 
-- A metade Host (`index.js` + `host/`) injeta as seções dinâmicas do system prompt (idiomas / faixas / nível de água / equipe), a dupla trava de orçamento de leitura + enforce e os quatro comandos slash (o trio ctx mais `/vision`). Toda configuração salva já vale na montagem do prompt seguinte, sem reinício.
+- A metade Host (`index.js` + `host/`) injeta as seções byte-estáveis do system prompt (idiomas / faixas / protocolo do nível de água / equipe) mais a linha de nível de água ao vivo pelo snapshot de runtime-context do final (um canal que acrescenta em vez de reescrever o cabeçalho do prompt, então o cache de prompt do provedor fica intacto), além da dupla trava de orçamento de leitura + enforce e os quatro comandos slash (o trio ctx mais `/vision`). Toda configuração salva já vale na montagem do prompt seguinte, sem reinício.
 - A metade Client (`client.js`) renderiza a página de configurações, o badge ⚡ e o identificador ◇ do modelo no cabeçalho da sessão e o aviso dinâmico durante o handover; os snapshots de configuração são lidos e gravados pela família de rotas Host.
 - A entrada “Switchman Control Center” na barra lateral da página inicial abre com um clique esta mesma página de configuração como painel central; a entrada nas configurações permanece.
 - `cordis.patch.yml` conserva integralmente a lista de plugins dos presets de fábrica e intervém só no persona suffix; as ferramentas Agent Teams em si vêm do bundle de fábrica e são habilitadas automaticamente ao ligar o modo equipe.

package/README.ru.md

@@ -12,9 +12,9 @@
 
 Если работать в DSH подольше, рано или поздно упираешься в две вещи: сессия тяжелеет с каждым сообщением — история раздувает контекст до сотен тысяч токенов, модель начинает забывать, тормозить и дорожать, а ручной /compact при каждом сжатии ещё и теряет детали; и главная модель всё делает сама — прочитать файл, прогнать тест, сверить данные: всё она грызёт сама, медленно и дорого, хотя большая часть этой работы по праву досталась бы дешёвой модели.
 
-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) урезает бюджет разового чтения и подталкивает к завершению; 130k (force) запускает автоматическую передачу — форкает копию сессии в архив, сжимает контекст и будит продолжение, работа не обрывается. Фоновые субагенты, которые ещё бегут в момент передачи, тоже не теряются: id, описания задач и пути к отчётам записываются в документ передачи, и продолжившаяся сессия знает, куда идти за отчётами, а не раздаёт работу заново. У каждого отправленного субагента свой жёсткий потолок: доработав до него, он завершается резюме HANDOFF. Если автоматическое вмешательство работает не так, как вам нужно, возьмите управление в свои руки в любой момент: `/ctx-pause` останавливает все действия по уровню (замер продолжает работать, баннер переключается на paused — вмешательство просто перестаёт действовать), `/ctx-resume` всё возвращает в любой момент — после перезапуска DSH вмешательство тоже вернётся само, вы временно отпускаете, а не выключаете навсегда; `/ctx-handover` не ждёт, пока уровень дойдёт до верха, и запускает ту же передачу по требованию — форкнуть копию, сжать контекст, разбудить продолжение (сессию сначала подводят к границе простоя, поэтому результат может занять несколько минут).
+**1. Уровень воды в контексте: длинная сессия не переполняется.** Каждый ход подсчитывает токены сессии в реальном времени, и три линии уровня ужесточаются по нарастающей: 80k (soft, настраивается) подсказывает «пора делегировать»; 120k (hard) урезает бюджет разового чтения и подталкивает к завершению; 150k (force) запускает автоматическую передачу — форкает копию сессии в архив, сжимает контекст и будит продолжение, работа не обрывается. Фоновые субагенты, которые ещё бегут в момент передачи, тоже не теряются: id, описания задач и пути к отчётам записываются в документ передачи, и продолжившаяся сессия знает, куда идти за отчётами, а не раздаёт работу заново. У каждого отправленного субагента свой жёсткий потолок: доработав до него, он завершается резюме HANDOFF. Если автоматическое вмешательство работает не так, как вам нужно, возьмите управление в свои руки в любой момент: `/ctx-pause` останавливает все действия по уровню (замер продолжает работать, хвостовая строка уровня в реальном времени переключается на paused — вмешательство просто перестаёт действовать), `/ctx-resume` всё возвращает в любой момент — после перезапуска DSH вмешательство тоже вернётся само, вы временно отпускаете, а не выключаете навсегда; `/ctx-handover` не ждёт, пока уровень дойдёт до верха, и запускает ту же передачу по требованию — форкнуть копию, сжать контекст, разбудить продолжение (сессию сначала подводят к границе простоя, поэтому результат может занять несколько минут).
 
 **2. Шесть пулов диспетчеризации: под каждую работу — своя модель.** Лёгкий пул (economy — мелкие массовые задачи), механический (mechanical — шаблонные переработки), основной (main — повседневный кодинг), пул высокой сложности (hard — тяжёлые рассуждения и крупные рефакторинги), мультимодальный (vision — чтение картинок), пул ревью (review — независимая проверка). На странице настроек отмечаете кандидатов, расставляете приоритеты (можно с привязкой к ступеням S/A/B/C) и для каждого маршрута отдельно фиксируете reasoning effort — выпадающий список ступеней берётся из уровней, которые модель реально поддерживает, а не из трёх универсальных. Каждый ход промпт главной модели несёт с собой таблицу рекомендаций `[SWITCHMAN:POOLS]`, и работа раздаётся по ней. У режима исполнения три состояния: off / advice / enforce (enforce = модель вне пула просто отклоняется).
 
@@ -33,6 +33,8 @@ dsh-switchman — плагин для [DeepSeek Harness](https://github.com/deep
 
 **7. `/vision`: картинки по зубам даже чисто текстовой модели.** Когда главная модель не читает изображения, DSH прямо на входе отклоняет сообщения с картинками. Прикрепите картинку и введите `/vision что не так на этой картинке` — изображение будет отдано на чтение модели из мультимодального пула, а вывод вернётся в текущую сессию. Над полем ввода заранее подсказывают: «текущая модель не умеет читать изображения»; если прямая отправка картинки отклонена, она один раз автоматически переоформляется в `/vision` и уходит повторно — вручную ничего переписывать не нужно; если мультимодальный пул не настроен, команда откажется и подскажет, что настроить.
 
+**8. Маршрутизация по намерению: нужная модель выбирается сама.** На странице настроек появляется раздел «Маршрутизация по намерению»: главный переключатель (по умолчанию выключен; для включения нужны классификатор и хотя бы один кандидат), маршрут маленькой модели-классификатора (provider + model + необязательный effort — подходят и решающие модели типа TypeSafe Jev, и обычные разговорные, вывод парсится нестрого), выбор типа классификатора из трёх (auto / decision / chat), независимый список моделей-кандидатов (для каждого: provider + model + необязательный effort + одна строка описания способностей), окно кэша в секундах (по умолчанию 300, подогнано под промпт-кэши поставщиков ~5 минут), порог уверенности для переключения (по умолчанию 80), тайм-аут классификации (по умолчанию 60000 мс), количество сообщений истории (по умолчанию 6) и символьный бюджет (по умолчанию 2400), а также необязательная запасная модель. В селекторе моделей под группой «Auto · Switchman» появляется вход «Auto» (клиент отрисовывает его локализованно — «Авто (маршрутизация по намерению)» на русском); после выбора классификатор оценивает каждое сообщение пользователя, и решение фиксируется на этот ход: если уверенности не хватает или окно кэша ещё открыто, текущая модель остаётся (её кэш переиспользуется); переключение происходит, только когда уверенность высока или текущей модели нет среди кандидатов. Смена проходит бесшумно на уровне вызова — в сессию не вставляется сообщение «модель переключена». Над полем ввода — чип состояния (при автороутинге он показывает текущую модель маршрута и уверенность последнего решения); кандидаты и пороги всегда можно посмотреть на странице настроек.
+
 Всего одна модель? Всё равно стоит поставить — контроль уровня воды и многоуровневая проверка от числа моделей не зависят, и длинная сессия на одной модели выигрывает от них ничуть не меньше.
 
 ## Встроенные навыки
@@ -73,7 +75,8 @@ dsh-switchman — плагин для [DeepSeek Harness](https://github.com/deep
    - **Пулы диспетчеризации** — шесть карточек в два ряда по три: сверху лёгкий / механический / основной; снизу высокосложный / мультимодальный / рецензентский. На каждой карточке отмечаются кандидаты, сгруппированные по поставщикам; отметьте «ручной порядок» — карточка станет нумерованным списком приоритетов, порядок меняется кнопками ↑ ↓ ×; рядом с каждым маршрутом можно зафиксировать reasoning effort (по умолчанию «следовать полосе»). Сводная строка сверху обновляется в реальном времени; на снимке: «пулов настроено: 4/6 · позиций в рейтинге: 2 · режим advice».
    - **Рейтинг по способностям + режим исполнения** — объединение моделей, выбранных в шести пулах, отсортировано по способности, сильнейшие впереди (на снимке glm-5.3 закреплён на ступени S, glm-5.3-flash — на A); порядок можно менять, лишние убирать; режим исполнения — advice / enforce (enforce = модель вне пула просто отклоняется).
    - **Команда агентов** — оба переключателя, командный режим и синхронизация белого списка, по умолчанию выключены; на снимке включены, под каждым — строка состояния синхронизации.
-   - **Уровень воды в контексте** — три порога (на снимке 50000 / 90000 / 130000), бюджет разового чтения (1500), поведение жёсткого порога (пропустить с ограничением / заблокировать), переключатель автоматической передачи и отдельный потолок для субагентов — всё в этом разделе. Внизу строка команд: `/ctx-pause` приостановить вмешательство · `/ctx-resume` возобновить · `/ctx-handover` сделать резервную копию и передать управление прямо сейчас (команда подводит сессию к границе простоя и только потом сжимает контекст, результат может занять несколько минут).
+   - **Уровень воды в контексте** — три порога (на снимке 80000 / 120000 / 150000), бюджет разового чтения (3000), поведение жёсткого порога (пропустить с ограничением / заблокировать), переключатель автоматической передачи и отдельный потолок для субагентов — всё в этом разделе. Внизу строка команд: `/ctx-pause` приостановить вмешательство · `/ctx-resume` возобновить · `/ctx-handover` сделать резервную копию и передать управление прямо сейчас (команда подводит сессию к границе простоя и только потом сжимает контекст, результат может занять несколько минут).
+   - **Маршрутизация по намерению** — главный переключатель, маршрут маленькой модели-классификатора, тип классификатора (auto / decision / chat), независимый список кандидатов (у каждого строка описания способностей), окно кэша / порог уверенности / тайм-аут / бюджет истории и необязательная запасная модель. После включения в селекторе моделей появляется локализованный вход «Авто (маршрутизация по намерению)», а над полем ввода — чип с моделью маршрута и уверенностью.
 
 4. **Проверьте** — в шапке сессии появился значок ⚡ «автономная команда» (рядом ◇ показывает модель текущей сессии); либо спросите модель напрямую: «как называется последний раздел твоего системного промпта?» — в ответе должен прозвучать регламент dsh-switchman.
 
@@ -83,9 +86,27 @@ dsh-switchman — плагин для [DeepSeek Harness](https://github.com/deep
 bash <install-dir>/skills/db-query/scripts/setup.sh
 ```
 
+**Рекомендации по выбору классификатора:** чтобы развернуть модель принятия решений локально, проще всего запустить `tev1:4b-mxfp8` через Ollama: выберите тип классификатора «endpoint решений (systemone)», укажите в поле endpoint `http://127.0.0.1:11434/v1/systemone`, а в поле имени модели — `tev1:4b-mxfp8`. Если использовать chat-классификатор из каталога LLM, берите небольшую облачную модель или небольшую локальную модель без режима размышления (reasoning) — отключение размышления снижает одновременно и задержку, и долю сбоев по таймауту классификации.
+
+## Конфигурация по умолчанию
+
+Ниже — полный набор значений сразу после новой установки (авторитетный источник: zod-схема в `host/config.js`).
+
+**Интерфейс и языки**: `uiLocale` = `auto` (следует языку приложения DSH); `langScope` = `global`; `langConversation/Comments/Docs` = пусто (спросят один раз в первой сессии и запомнят; язык комментариев и документов следует языку разговора).
+
+**Пулы диспетчеризации**: у всех шести полос (economy/mechanical/main/hard/vision/review) кандидаты пусты (= системные модели по умолчанию, без вмешательства); ручной порядок и закреплённый effort выключены/пусты; `dispatchEnforce` = `advice` (только совет, без принуждения).
+
+**Уровень воды в контексте**: soft `80000` / hard `120000` / force `150000` токенов; бюджет разового чтения `3000`; поведение при превышении бюджета `cap` (обрезать с предупреждением); `wmAutoHandover` = включён (на force — автоматическая резервная копия + передача со сжатием); жёсткий потолок субагентов = включён (общие 150k).
+
+**Agent Teams**: `teamsMode` = выключен; `syncWhitelist` = выключен (два переключателя независимы друг от друга).
+
+**Маршрутизация по намерению** (по умолчанию недоступна; нужны классификатор + хотя бы один кандидат + включённый главный переключатель): `intentEnabled` = выключен (пока выключен, вход Auto скрыт, а сессии, где Auto уже выбран, идут по цепочке запасных моделей); маршрут классификатора не задан; тип классификатора `chat`; список кандидатов пуст (предустановленные категории участвуют в маршрутизации, только если у них указана модель); окно кэша `300` с / порог уверенности для переключения `80` / тайм-аут классификации `60000` мс; история `6` сообщений / `2400` символов; `intentContextWindow` = `200000`.
+
+**Что важно знать из коробки**: ① то, что маршрутизация по намерению недоступна из коробки, — намеренное решение; включается в три шага (классификатор, кандидаты, переключатель); ② эффективное окно Auto из коробки равно 200000 — защитная планка гарантирует 0.8×окна ≥ force (150000), поэтому линия сжатия ядра (160000) всегда стоит после линии плавной передачи (150000); ③ заметнее всего из коробки троица уровней: 80k напоминает делегировать / 120k ужимает чтение / 150k сам делает резервную копию и передаёт управление — без каких-либо настроек.
+
 ## Как это работает
 
-- Host-половина (`index.js` + `host/`) внедряет динамические секции системного промпта (язык / полосы / уровень воды / команда), двойной шлюз бюджета чтения и enforce и четыре слэш-команды (ctx-тройка + `/vision`). Все настройки после сохранения вступают в силу при следующей сборке промпта — без перезапуска.
+- Host-половина (`index.js` + `host/`) внедряет побайтово стабильные секции системного промпта (язык / полосы / протокол уровня воды / команда) плюс живую строку уровня через хвостовой runtime-context-снимок (канал, который только дописывает, а не переписывает начало промпта, поэтому промпт-кэш поставщика остаётся целым), а также двойной шлюз бюджета чтения и enforce и четыре слэш-команды (ctx-тройка + `/vision`). Все настройки после сохранения вступают в силу при следующей сборке промпта — без перезапуска.
 - Client-половина (`client.js`) отрисовывает страницу настроек, значок ⚡ и метку модели ◇ в шапке сессии, живую подсказку во время передачи управления; снимки конфигурации читаются и записываются через семейство маршрутов Host.
 - Пункт «Диспетчерская Switchman» в боковой панели главной страницы: один клик открывает эту же страницу настроек в виде центральной панели; прежний вход в настройки остаётся на месте.
 - `cordis.patch.yml` целиком сохраняет список плагинов заводских пресетов и расширяет только persona suffix; сами инструменты Agent Teams приходят из заводского bundle и автоматически включаются вместе с командным режимом.

package/README.zh-TW.md

@@ -12,9 +12,9 @@
 
 用 DSH 幹活久了有兩件煩心事：一是對話越聊越重，上下文被歷史撐到幾十萬 token，模型開始忘事、變慢、變貴，手動 /compact 又丟細節；二是主力模型什麼都自己幹，查個檔案、跑個測試、對個資料都是它在啃，大半活其實該交給便宜模型。
 
-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. 上下文水位：長對話不撐爆。** 每輪即時統計對話 token，三條水位線逐級加碼：50k（soft，可調）提醒「該委派了」；90k（hard）收緊單次讀取預算、引導收尾；130k（force）自動交接——fork 一份對話留底、壓縮上下文、喚醒續跑，任務不斷線。交接那一刻還在跑的背景子代理也不會丟：id、任務、報告路徑都寫進交接文件，續跑的對話知道去哪收報告，不會重複派工。每個子代理自帶獨立硬上限，到頂寫完 HANDOFF 摘要退場。自動干預不合手時可臨時接管：`/ctx-pause` 停掉全部水位動作（量測照跑、橫幅轉成 paused，只是不動手），`/ctx-resume` 隨時恢復——重新啟動 DSH 後干預也會自動回來，是臨時放手，不是永久關閉；`/ctx-handover` 不等水位到頂，主動發起同一次交接：fork 備份、壓縮上下文、喚醒續跑（對話先被引導到閒置邊界，結果可能要等幾分鐘）。
+**1. 上下文水位：長對話不撐爆。** 每輪即時統計對話 token，三條水位線逐級加碼：80k（soft，可調）提醒「該委派了」；120k（hard）收緊單次讀取預算、引導收尾；150k（force）自動交接——fork 一份對話留底、壓縮上下文、喚醒續跑，任務不斷線。交接那一刻還在跑的背景子代理也不會丟：id、任務、報告路徑都寫進交接文件，續跑的對話知道去哪收報告，不會重複派工。每個子代理自帶獨立硬上限，到頂寫完 HANDOFF 摘要退場。自動干預不合手時可臨時接管：`/ctx-pause` 停掉全部水位動作（量測照跑、尾部水位線轉成 paused，只是不動手），`/ctx-resume` 隨時恢復——重新啟動 DSH 後干預也會自動回來，是臨時放手，不是永久關閉；`/ctx-handover` 不等水位到頂，主動發起同一次交接：fork 備份、壓縮上下文、喚醒續跑（對話先被引導到閒置邊界，結果可能要等幾分鐘）。
 
 **2. 六個派發池：什麼活配什麼模型。** 輕量池（批次小活）、機械池（模板化改寫）、主力池（日常編碼）、高難池（高難推理與大規模重構）、多模態池（看圖）、複審池（獨立驗證）。設定頁裡勾候選、排優先順序、標 S/A/B/C 級，還能給每條路線單獨釘選思考強度——強度下拉來自該模型真實支援的級別，不是通用三級。主模型每輪提示詞裡都帶著一張 `[SWITCHMAN:POOLS]` 推薦表，照表派工。執行模式三態：關閉 / 建議 / 強制（強制 = 池外模型直接拒絕）。
 
@@ -33,6 +33,8 @@ dsh-switchman 是一個 [DeepSeek Harness](https://github.com/deepseek-ai/deepse
 
 **7. `/vision`：純文字模型也能處理圖。** 主力模型讀不了圖時，DSH 會在入口直接拒掉帶圖訊息。貼上圖、輸入 `/vision 這張圖錯在哪`，圖片會被交給多模態池的模型去讀，結論回到目前對話。輸入框上方會提前提示「目前模型不支援讀圖」；直接傳圖被拒時，自動改寫成 `/vision` 重送一次，不用手動重來；多模態池沒設時指令會拒絕並給出設定指引。
 
+**8. 意圖識別自動選模型：訊息進來，模型自動落位。** 設定頁新增【意圖識別】分組：主開關（預設關閉，開啟需設定分類器並至少一個候選）、分類器小模型路由（provider + model + 可選 effort，TypeSafe Jev 類決策模型與通用對話模型都支援，輸出寬容解析）、分類器類型三選（auto / decision / chat）、獨立候選模型清單（每個候選 provider + model + 可選 effort + 一句能力描述）、快取視窗秒數（預設 300，對齊廠商 prompt cache 約 5 分鐘）、切換信心閾值（預設 80）、分類逾時（預設 60000ms）、歷史訊息則數（預設 6）與字元預算（預設 2400）、可選備援模型。模型選擇器出現「Auto · Switchman」分組下的「Auto」入口（用戶端渲染為在地化的「自動（意圖識別）」）；選中後每條使用者訊息先由分類器判定最合適的候選，同一輪鎖定決策：信心不足或仍在快取視窗內時優先沿用目前模型（快取續用），信心足夠高或目前模型不在候選裡才切換；切換在呼叫層靜默完成，不往對話裡插「模型已切換」。輸入框上方有狀態 chip（自動路由時顯示目前路由模型與上次決策信心），候選與閾值隨時回設定頁查看。
+
 只有一個模型也值得裝——水位控制和分級驗證與模型數量無關，單模型長對話同樣受益。
 
 ## 隨附技能
@@ -73,7 +75,8 @@ dsh-switchman 是一個 [DeepSeek Harness](https://github.com/deepseek-ai/deepse
    - **派發池**——六張卡片兩行三列：上排輕量、機械、主力，下排高難、多模態、複審。卡片按供應商分組勾候選模型；勾上「手動排序」變成編號優先清單，用 ↑ ↓ × 調順序；每條路線可釘思考強度（預設「跟隨泳道」）。頂部彙總行即時更新，圖中即「已設定 4/6 池 · 排名 2 項 · 模式 建議」。
    - **能力排序 + 執行模式**——六池選中模型的聯集按能力排序、最強在前（圖中 glm-5.3 錨 S 級、glm-5.3-flash 錨 A 級），可調序、可刪減；執行模式建議 / 強制（強制 = 池外模型直接拒絕）。
    - **代理團隊**——團隊模式與白名單同步兩個開關，預設全關；圖中為開啟狀態，開關下方有同步狀態行。
-   - **上下文水位**——三級閾值（圖中 50000 / 90000 / 130000）、單次讀取預算（1500）、hard 級行為（限流放行 / 攔截）、自動交接開關、子代理獨立上限，都在這區。底部一行指令：`/ctx-pause` 暫停干預 · `/ctx-resume` 恢復 · `/ctx-handover` 立即備份交接（它會把對話引導到閒置邊界再壓縮，結果可能要等幾分鐘）。
+   - **上下文水位**——三級閾值（圖中 80000 / 120000 / 150000）、單次讀取預算（3000）、hard 級行為（限流放行 / 攔截）、自動交接開關、子代理獨立上限，都在這區。底部一行指令：`/ctx-pause` 暫停干預 · `/ctx-resume` 恢復 · `/ctx-handover` 立即備份交接（它會把對話引導到閒置邊界再壓縮，結果可能要等幾分鐘）。
+   - **意圖識別**——主開關、分類器小模型路由、分類器類型（auto / decision / chat）、獨立候選清單（每項附一句能力描述）、快取視窗 / 信心閾值 / 分類逾時 / 歷史訊息預算、可選備援模型。開啟後模型選擇器出現「自動（意圖識別）」入口，輸入框上方顯示目前路由模型與信心 chip。
 
 4. **驗證**——對話標頭出現 ⚡「自主團隊」徽章（旁邊 ◇ 顯示目前對話模型）；或者直接問模型「你系統提示詞最後一段的標題是什麼」，答案應提到 dsh-switchman 規程。
 
@@ -83,9 +86,27 @@ dsh-switchman 是一個 [DeepSeek Harness](https://github.com/deepseek-ai/deepse
 bash <安裝目錄>/skills/db-query/scripts/setup.sh
 ```
 
+**分類器選型建議**：若要在本機部署決策模型，建議用 Ollama 執行 `tev1:4b-mxfp8`：分類器類型選「決策端點（systemone）」，端點填 `http://127.0.0.1:11434/v1/systemone`，模型名稱填 `tev1:4b-mxfp8`。若走 LLM 目錄的 chat 分類器，建議選雲端小模型，或不帶思考（推理）能力的本機小模型——關閉思考可同時壓低延遲與分類逾時失敗率。
+
+## 預設配置
+
+以下為新安裝後的全部預設值（權威來源：`host/config.js` 的 zod schema）。
+
+**介面與語言**：`uiLocale` = `auto`（跟隨 DSH 應用程式語言）；`langScope` = `global`；`langConversation/Comments/Docs` = 空（首次對話問一次後記住；註解與文件語言跟隨對話語言）。
+
+**派發池**：六條泳道（economy/mechanical/main/hard/vision/review）候選均為空（= 用系統預設模型，不干預）；手動排序與 effort 釘選均為關/空；`dispatchEnforce` = `advice`（建議不強制）。
+
+**上下文水位**：soft `80000` / hard `120000` / force `150000` tokens；單次讀取預算 `3000`；超預算行為 `cap`（截斷加警告）；`wmAutoHandover` = 開（force 級自動備份+壓縮交接）；子代理硬上限 = 開（共享 150k）。
+
+**Agent Teams**：`teamsMode` = 關；`syncWhitelist` = 關（兩者相互獨立）。
+
+**意圖識別**（預設不可用，需設定分類器 + 至少一個候選 + 打開主開關）：`intentEnabled` = 關（關閉時 Auto 入口隱藏，已選 Auto 的對話走備援鏈）；分類器路由未設定；分類器類型 `chat`；候選清單空（預置分類需填模型才參與路由）；快取視窗 `300` 秒 / 切換信心閾值 `80` / 分類逾時 `60000` ms；歷史 `6` 則 / `2400` 字元；`intentContextWindow` = `200000`。
+
+**開箱要點**：① 意圖識別開箱不可用是有意設計，三步開啟（分類器、候選、開關）；② Auto 有效視窗開箱即為 200000——護欄保證 0.8×視窗 ≥ force 級（150000），核心壓縮線（160000）永遠在平滑交接線（150000）之後；③ 開箱最有感的是水位三件套：80k 提醒委派 / 120k 收斂讀取 / 150k 自動備份交接，無須任何設定。
+
 ## 運作原理
 
-- Host 半（`index.js` + `host/`）注入動態系統提示詞段（語言 / 泳道 / 水位 / 團隊）、讀取預算與 enforce 雙閘、四個斜線指令（ctx 三件套 + `/vision`）。設定儲存後下一輪提示詞組裝即生效，無須重新啟動。
+- Host 半（`index.js` + `host/`）注入位元組恆定的系統提示詞段（語言 / 泳道 / 水位協定 / 團隊），即時水位線改走尾部 runtime-context 快照通道（只附加、不改寫提示詞頭部，廠商 prompt cache 不受影響）、讀取預算與 enforce 雙閘、四個斜線指令（ctx 三件套 + `/vision`）。設定儲存後下一輪提示詞組裝即生效，無須重新啟動。
 - Client 半（`client.js`）渲染設定頁、對話標頭的 ⚡ 徽章與 ◇ 模型標識、交接進行中的動態提示；設定快照經 Host 路由家族讀寫。
 - 首頁側邊欄的「Switchman 調度中心」入口，點一下即以中央面板開啟同一設定頁；原設定入口保留。
 - `cordis.patch.yml` 完整保留出廠預設的外掛清單，只在 persona suffix 上做擴充；Agent Teams 工具本體來自出廠 bundle，開啟團隊模式時自動啟用。

package/README.zh.md

@@ -12,9 +12,9 @@
 
 用 DSH 干活久了有两件烦心事：一是会话越聊越重，上下文被历史撑到几十万 token，模型开始忘事、变慢、变贵，手动 /compact 又丢细节；二是主力模型什么都自己干，查个文件、跑个测试、对个数据都是它在啃，大半活其实该交给便宜模型。
 
-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. 上下文水位：长会话不撑爆。** 每轮实时统计会话 token，三条水位线逐级加码：50k（soft，可调）提醒「该委派了」；90k（hard）收紧单次读取预算、引导收尾；130k（force）自动交接——fork 一份会话留底、压缩上下文、唤醒续跑，任务不断线。交接那一刻还在跑的后台子智能体也不会丢：id、任务、报告路径都写进交接文档，续跑的会话知道去哪收报告，不会重复派活。每个子智能体自带独立硬顶，到顶写完 HANDOFF 摘要退场。自动干预不合手时可临时接管：`/ctx-pause` 停掉全部水位动作（测量照跑、横幅转成 paused，只是不动手），`/ctx-resume` 随时恢复——重启 DSH 后干预也会自动回来，是临时放手，不是永久关闭；`/ctx-handover` 不等水位到顶，主动发起同一次交接：fork 备份、压缩上下文、唤醒续跑（会话先被引导到空闲边界，结果可能要等几分钟）。
+**1. 上下文水位：长会话不撑爆。** 每轮实时统计会话 token，三条水位线逐级加码：80k（soft，可调）提醒「该委派了」；120k（hard）收紧单次读取预算、引导收尾；150k（force）自动交接——fork 一份会话留底、压缩上下文、唤醒续跑，任务不断线。交接那一刻还在跑的后台子智能体也不会丢：id、任务、报告路径都写进交接文档，续跑的会话知道去哪收报告，不会重复派活。每个子智能体自带独立硬顶，到顶写完 HANDOFF 摘要退场。自动干预不合手时可临时接管：`/ctx-pause` 停掉全部水位动作（测量照跑、尾部水位行转成 paused，只是不动手），`/ctx-resume` 随时恢复——重启 DSH 后干预也会自动回来，是临时放手，不是永久关闭；`/ctx-handover` 不等水位到顶，主动发起同一次交接：fork 备份、压缩上下文、唤醒续跑（会话先被引导到空闲边界，结果可能要等几分钟）。
 
 **2. 六个派发池：什么活配什么模型。** 轻量池（批量小活）、机械池（模板化改写）、主力池（日常编码）、高难池（高难推理与大规模重构）、多模态池（看图）、复审池（独立验证）。设置页里勾候选、排优先级、标 S/A/B/C 档，还能给每条路线单独钉思考强度——档位下拉来自该模型真实支持的级别，不是通用三档。主模型每轮提示词里都带着一张 `[SWITCHMAN:POOLS]` 推荐表，照表派活。执行模式三态：关闭 / 建议 / 强制（强制 = 池外模型直接拒绝）。
 
@@ -33,6 +33,8 @@ dsh-switchman 是一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepse
 
 **7. `/vision`：纯文本模型也能处理图。** 主力模型读不了图时，DSH 会在入口直接拒掉带图消息。贴上图、输入 `/vision 这张图错在哪`，图片会被交给多模态池的模型去读，结论回到当前会话。输入框上方会提前提示「当前模型不支持读图」；直接发图被拒时，自动改写成 `/vision` 重发一次，不用手动重来；多模态池没配时命令会拒绝并给出配置指引。
 
+**8. 意图识别自动选模型：消息进来，模型自动落位。** 设置页新增【意图识别】分组：主开关（默认关闭，开启需配置分类器并至少一个候选）、分类器小模型路由（provider + model + 可选 effort，TypeSafe Jev 类决策模型与通用对话模型都支持，输出宽容解析）、分类器类型三选（auto / decision / chat）、独立候选模型列表（每个候选 provider + model + 可选 effort + 一句能力描述）、缓存窗口秒数（默认 300，对齐厂商 prompt cache 约 5 分钟）、切换置信度阈值（默认 80）、分类超时（默认 60000ms）、历史消息条数（默认 6）与字符预算（默认 2400）、可选兜底模型。模型选择器出现「Auto · Switchman」分组下的「Auto」入口（客户端渲染为本地化的「自动（意图识别）」）；选中后每条用户消息先由分类器判定最合适的候选，同一轮锁定决策：置信度不足或仍在缓存窗口内时优先沿用当前模型（缓存续用），置信度足够高或当前模型不在候选里才切换；切换在调用层静默完成，不往会话里插「模型已切换」。输入框上方有状态 chip（自动路由时显示当前路由模型与上次决策置信度），候选与阈值随时回设置页查看。
+
 只有一个模型也值得装——水位控制和分级验证与模型数量无关，单模型长会话同样受益。
 
 ## 捆绑技能
@@ -73,7 +75,8 @@ dsh-switchman 是一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepse
    - **派发池**——六张卡片两行三列：上排轻量、机械、主力，下排高难、多模态、复审。卡片按供应商分组勾候选模型；勾上「手动序」变成编号优先列表，用 ↑ ↓ × 调顺序；每条路线可钉思考强度（默认「跟随泳道」）。顶部汇总行实时更新，图中即「已配置 4/6 池 · 排名 2 项 · 模式 建议」。
    - **能力排序 + 执行模式**——六池选中模型的并集按能力排序、最强在前（图中 glm-5.3 锚 S 档、glm-5.3-flash 锚 A 档），可调序、可删减；执行模式建议 / 强制（强制 = 池外模型直接拒绝）。
    - **智能体团队**——团队模式与白名单同步两个开关，默认全关；图中为开启状态，开关下方有同步状态行。
-   - **上下文水位**——三档阈值（图中 50000 / 90000 / 130000）、单次读取预算（1500）、硬档行为（限流放行 / 拦截）、自动交接开关、子智能体独立上限，都在这区。底部一行命令：`/ctx-pause` 暂停干预 · `/ctx-resume` 恢复 · `/ctx-handover` 立即备份交接（它会把会话引导到空闲边界再压缩，结果可能要等几分钟）。
+   - **上下文水位**——三档阈值（图中 80000 / 120000 / 150000）、单次读取预算（3000）、硬档行为（限流放行 / 拦截）、自动交接开关、子智能体独立上限，都在这区。底部一行命令：`/ctx-pause` 暂停干预 · `/ctx-resume` 恢复 · `/ctx-handover` 立即备份交接（它会把会话引导到空闲边界再压缩，结果可能要等几分钟）。
+   - **意图识别**——主开关、分类器小模型路由、分类器类型（auto / decision / chat）、独立候选列表（每项附一句能力描述）、缓存窗口 / 置信度阈值 / 分类超时 / 历史消息预算、可选兜底模型。开启后模型选择器出现「自动（意图识别）」入口，输入框上方显示当前路由模型与置信度 chip。
 
 4. **验证**——会话头部出现 ⚡「自主团队」徽标（旁边 ◇ 显示当前会话模型）；或者直接问模型「你系统提示词最后一段标题是什么」，答案应提到 dsh-switchman 规程。
 
@@ -83,9 +86,27 @@ dsh-switchman 是一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepse
 bash <安装目录>/skills/db-query/scripts/setup.sh
 ```
 
+**分类器选型建议**：若要本地部署决策模型，推荐用 Ollama 运行 `tev1:4b-mxfp8`：分类器类型选「决策端点（systemone）」，端点填 `http://127.0.0.1:11434/v1/systemone`，模型名填 `tev1:4b-mxfp8`。若走 LLM 目录的 chat 分类器，推荐云端小模型，或不带思考（推理）能力的本地小模型——关闭思考可同时压低延迟与分类超时失败率。
+
+## 默认配置
+
+以下为新安装后的全部默认值（权威来源：`host/config.js` 的 zod schema）。
+
+**界面与语言**：`uiLocale` = `auto`（跟随 DSH 应用语言）；`langScope` = `global`；`langConversation/Comments/Docs` = 空（首次对话问一次后记住；注释与文档语言跟随对话语言）。
+
+**派发池**：六条泳道（economy/mechanical/main/hard/vision/review）候选均为空（= 用系统默认模型，不干预）；手动排序与 effort 钉选均为关/空；`dispatchEnforce` = `advice`（建议不强制）。
+
+**上下文水位**：soft `80000` / hard `120000` / force `150000` tokens；单次读取预算 `3000`；超预算行为 `cap`（截断加警告）；`wmAutoHandover` = 开（force 档自动备份+压缩交接）；子会话硬顶 = 开（共享 150k）。
+
+**Agent Teams**：`teamsMode` = 关；`syncWhitelist` = 关（两者相互独立）。
+
+**意图识别**（默认不可用，需配置分类器 + 至少一个候选 + 打开主开关）：`intentEnabled` = 关（关闭时 Auto 入口隐藏，已选 Auto 的会话走兜底链）；分类器路由未设置；分类器类型 `chat`；候选列表空（预置分类需填模型才参与路由）；缓存窗口 `300` 秒 / 切换置信度 `80` / 分类超时 `60000` ms；历史 `6` 条 / `2400` 字符；`intentContextWindow` = `200000`。
+
+**开箱要点**：① 意图识别开箱不可用是有意设计，三步开启（分类器、候选、开关）；② Auto 有效窗口开箱即为 200000——护栏保证 0.8×窗口 ≥ force 档（150000），核心压缩线（160000）永远在平滑交接线（150000）之后；③ 开箱最有感的是水位三件套：80k 提醒委派 / 120k 收敛读取 / 150k 自动备份交接，无需任何设置。
+
 ## 工作原理
 
-- Host 半（`index.js` + `host/`）注入动态系统提示词段（语言 / 泳道 / 水位 / 团队）、读预算与 enforce 双闸、四个斜杠命令（ctx 三件套 + `/vision`）。设置保存后下一轮提示词装配即生效，无需重启。
+- Host 半（`index.js` + `host/`）注入字节恒定的系统提示词段（语言 / 泳道 / 水位协议 / 团队），实时水位行改走尾部 runtime-context 快照通道（只追加、不改写提示词头部，供应商提示词缓存不受影响）、读预算与 enforce 双闸、四个斜杠命令（ctx 三件套 + `/vision`）。设置保存后下一轮提示词装配即生效，无需重启。
 - Client 半（`client.js`）渲染设置页、会话头部的 ⚡ 徽标与 ◇ 模型标识、交接进行中的动态提示；配置快照经 Host 路由家族读写。
 - 首页侧边栏的「Switchman 调度中心」入口，单击即以中央面板打开同一配置页；原设置入口保留。
 - `cordis.patch.yml` 完整保留出厂预设的插件列表，只在 persona suffix 上做扩展；Agent Teams 工具本体来自出厂 bundle，开启团队模式时自动启用。