---

Compatibility

• DeepSeek Harness 0.1.2-rc.1 (peers fixados em 0.1.2-rc.1). 0.1.2-rc.1 (adaptado em 2026-09-02): o envelope de sessão mantém seu campo ignorable apenas para compatibilidade de leitura de logs armazenados - o Session.append ainda não consegue estampá-lo, então o comportamento da porta não muda.
• Node ^22.19.0 || >=24.0.0, somente ESM ("type": "module").
• Peers: @deepseek-ai/cordis ^4.0.2, @deepseek-ai/schemastery ^3.18.2, e @deepseek-ai/dsh-session, @deepseek-ai/dsh-tools, @deepseek-ai/dsh-commands, @deepseek-ai/dsh-compaction, @deepseek-ai/dsh-storage-domain em >=0.1.0-rc.8 <0.2.0.

What you get

• Tempo de carga da sessão — latência publicação→primeira requisição, classificada open (nova) ou restore (com semente/retomada), mais a contagem de eventos de semente.
• Contagem de spill — quantos resultados de ferramenta foram descarregados em um artefato de sessão (detectado pelo aviso persistente de spill).
• Contagem e motivo de compaction — total, separado manual (comando) vs automatic (pressão), e total de tokens sombreados.
• Volume de contexto injetado — tokens de system-prompt (AGENTS.md + skills + persona), schema de ferramentas e superfície, com suas proporções.
• Taxa de acertos do cache LLM — tokens input / cache-read / cache-write / output agregados e a taxa derivada.
• Sugestões de otimização — baseadas em limiares (cortar skills, ajustar schemas, compactar antes, ativar cache de prompts, ativar spill-policy…).
• Amostragem assíncrona — dobra O(1) por evento; a amostragem roda em um timer, nunca no caminho de append.

Quick start

git channel

# De um profile temporário (fixa o commit; roda o build `prepare` autocontido)
dsh plugin --profile demo add "github:YOUR_ORG/dsh-fast#<sha>"
# O pnpm-workspace.yaml do profile ganha uma entrada allowBuilds para dsh-fast no primeiro add.

npm channel

dsh plugin --profile demo add dsh-fast

Ambos os canais instalam a linha do bundle (ver cordis.patch.yml) na pilha dsh.profile.bundles e surtem efeito ao reiniciar.

Install & uninstall

dsh plugin --profile demo add dsh-fast       # instalar
dsh plugin --profile demo remove dsh-fast    # desinstalar

Verifique a montagem: dsh --profile demo --dump-config | grep dsh-fast.

Configuration

Todos os ajustes são campos Schemastery Config; valores inválidos falham a carga do profile de forma audível.

Key	Default	Description
enabled	true	Interruptor mestre; false não monta nada.
privacy.includeCwd	false	Incluir o diretório de trabalho saneado nos relatórios.
sampling.snapshotIntervalMs	60000	A cada quanto as sessões ativas são amostradas (ms).
sampling.maxHistorySamples	20	Amostras retidas por sessão no histórico durável.
thresholds.systemPromptTokens	20000	Avisar se o system prompt exceder esses tokens.
thresholds.toolSchemaTokens	8000	Avisar se o schema de ferramentas exceder esses tokens.
thresholds.surfaceTokens	60000	Avisar se a superfície exceder esses tokens.
thresholds.cacheHitRateFloor	0.1	Avisar se a taxa de cache cair abaixo disso (0..1).
thresholds.compactionCountWarn	10	Avisar após tantas compactions.
thresholds.compactionShadowTokens	40000	Avisar se a média de tokens sombreados por summary exceder isso.
spill.detectSpilledResults	true	Detectar resultados descarregados pelo marcador de aviso persistente.

Tools & surfaces

• /fast — comando humano que imprime o relatório de saúde da sessão: carga, spill, compaction, ranking de volume de contexto, taxa de cache e sugestões.
• fast_report — ferramenta de modelo que devolve o mesmo relatório como JSON estruturado (para o modelo raciocinar), com render de texto legível.

Permissions & data

O dsh-fast consome apenas seams públicos: eventos session/* e agent/*, o opcional ctx.tokenMeter, ctx.storageDomain, ctx.commands e ctx.tools. É estritamente somente leitura sobre o log de sessão — nunca muta a requisição do modelo, os resultados de ferramentas nem a superfície. As métricas são persistidas no domínio dsh_fast (uma história limitada por sessão), não no log. A identidade do relatório e o diretório opcional são saneados antes de exibição ou escrita durável.

Security boundaries

• Somente leitura, zero sobrecarga no caminho do modelo — dobra O(1) por evento; amostragem por timer.
• Sem rede, sem manuseio de credenciais — nenhuma requisição de saída nem armazenamento sensível.
• Configuração que falha audível — cada ajuste é validado na montagem; limites inválidos lançam erro.
• Dados de exibição/duráveis saneados — caracteres de controle são removidos e comprimentos limitados; cwd fica desativado por padrão.
• Registros reversíveis — tudo passa por ctx.effect() / ctx.on() / register().

Known limitations

• Domínio de armazenamento, não eventos de sessão — o Session.append do rc.2 não oferece marcador ignorable nem superfície de registro de eventos externa; um evento fast/* faria o coordenador de persistência recusar o log ao restaurar. As métricas vão ao domínio de armazenamento; os eventos brutos seguem como fonte reconstruível.
• A detecção de spill é heurística — lê o aviso persistente (Full … stored at:); não há evento de sessão dedicado.
• O system prompt é um único balde — AGENTS.md, skills e persona formam o system prompt montado; não há contagem por seção.
• O tempo de carga começa na publicação — a leitura de disco de uma restauração ocorre antes de session/created; a duração reportada é publicação→primeira requisição.

Development

pnpm install
pnpm run typecheck && pnpm run typecheck:ci
pnpm test
pnpm run build
pnpm run verify:self-contained && pnpm run verify:artifacts
node scripts/check-readme-sync.mjs
pnpm pack

Topics

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, performance, diagnostics, profiling, context-engineering, llm-cache

Contributors

Obrigado a todas as pessoas que contribuíram com o dsh-fast:

• PerryLink — autor e mantenedor: projetou e construiu os diagnósticos somente leitura (latência de carregamento de sessão, contagens de spill, métricas de compactação, volume de injeção de contexto, taxa de acertos de cache do LLM), o comando /fast e a ferramenta fast_report, o domínio de armazenamento dsh_fast e a documentação em cinco idiomas.

PerryLink DSH Plugin Family

Este projeto é um dos 33 plugins de DeepSeek Harness mantidos por PerryLink. Se este ajuda você, os outros provavelmente também:

Plugin	One-liner
dsh-dsh-auto-review	Auto-revisão de segundo modelo na cadeia de aprovação, com falha fechada por padrão
dsh-dsh-background-agents	Agentes filhos em segundo plano duráveis com barra lateral de UI web, mensagens e interrupção
dsh-dsh-budget	Governança de custos para DeepSeek Harness: orçamentos, carbono e latência em um painel.
dsh-dsh-checkpoint-rewind	Equivalente ao /rewind do Claude Code: instantâneos, bifurcações de sessão, restauração de uso único
dsh-dsh-claude-move	Migre sessões, memória, habilidades e CLAUDE.md do Claude Code para o DSH
dsh-dsh-click	Controle de desktop nativo multiplataforma para DeepSeek Harness — Windows primeiro.
dsh-dsh-composer-history	Histórico de entrada estilo terminal para o compositor web: setas, busca Ctrl+R
dsh-dsh-data-quality	Verificações de qualidade de datasets e verificação de citações (a ponte numérica opcional consumida aqui)
dsh-dsh-defend	Defesa contra injeção de prompt, jailbreak e vazamento de segredos para DeepSeek Harness.
dsh-dsh-doublecheck	Guardião de disciplina de engenharia: sabatina de requisitos, portões de teste, revisão adversária
dsh-dsh-draw	Roteamento unificado de geração de imagens estáticas para DeepSeek Harness.
dsh-dsh-fund-research	Relatórios de pesquisa deterministas para fundos mútuos públicos chineses
dsh-dsh-github	Integração de PR/issues do GitHub para o DSH, cada escrita controlada por aprovação
dsh-dsh-industry-research	Orquestração de pesquisa setorial que sela as suas entregas através do ctx.researchReport.assemble deste plugin
dsh-dsh-library	Base de conhecimento documental local para DeepSeek Harness.
dsh-dsh-local-ai	Integração de modelos locais (Ollama) para DeepSeek Harness.
dsh-dsh-lsp-actions	Diagnósticos, formatação, autocompletar, ações de código e renomeação LSP sobre servidores de linguagem
dsh-dsh-mask	Middleware de mascaramento de PII: anonimiza no limite do modelo, restaura na camada de exibição
dsh-dsh-mcp-panel	Painel de tempo de execução MCP somente leitura: comando /mcp + aba Settings com status, ferramentas e erros
dsh-dsh-memento	Memória entre sessões controlada por aprovação: costura ctx.memory + SQLite + ferramenta de memória
dsh-dsh-observe	Exportador de observabilidade OpenTelemetry e Langfuse para DeepSeek Harness.
dsh-dsh-output-styles	Troca de estilo em tempo de execução equivalente ao outputStyles do Claude Code
dsh-dsh-permission-rules	Regras de permissão declarativas allow/deny/ask estilo Claude Code com auditoria
dsh-dsh-plugin-guide	Base de conhecimento de desenvolvimento de plugins como habilidade de agente sob demanda
dsh-dsh-research-report	Motor de relatórios de pesquisa verificáveis com evidência endereçada por conteúdo
dsh-dsh-score	Pontuação de qualidade multidimensional para plugins de DeepSeek Harness.
dsh-dsh-session-pin	Fixe sessões na barra lateral web com ordenação durável
dsh-dsh-session-sync	Sincronização de sessões entre dispositivos para DeepSeek Harness — um espelho git dedicado do seu armazenamento de sessões.
dsh-dsh-skill-pack-security	Pacote de habilidades de auditoria de segurança: varredura de segredos, revisão de dependências e cadeia de suprimentos
dsh-dsh-talk	Loop de sessão com voz para DeepSeek Harness: fale e ouça a resposta.
dsh-dsh-test-drive	Test drives isolados de instalação e smoke para plugins de DeepSeek Harness.
dsh-dsh-translate	Tradução de parâmetros entre fornecedores e reparo determinístico de JSON para DeepSeek Harness.

License

Apache-2.0 — ver LICENSE.

Instalar a partir do mercado do DSH Desktop

Todos os plugins PerryLink podem ser explorados no mercado integrado do DSH Desktop: Market → Sources → add source → colar https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → selecionar. A instalação continua passando pela verificação de identidade npm do mercado e pela sua confirmação.