---

Compatibility

Surface	Status
Harness	DeepSeek Harness 0.1.1-rc.2
Node	`^22.19.0
Platforms	Todas (bundle ESM puro; sem código nativo, sem rede)
Model	Qualquer (sem interação com o modelo)

What you get

O dsh-plugin-guide é a base de conhecimento de desenvolvimento de plugins DSH, empacotada como um bundle instalável que registra tudo como a agent skill dsh-plugin-guide. A skill permanece visível no catálogo de toda sessão e carrega seus passos de fluxo de trabalho, documentação oficial e deep-dives da comunidade sob demanda.

• Contrato de plugin e regras rígidas — effects/disposers, waterfall next(), visível para o modelo ⟺ registrado, configuração Schemastery.
• Arquivo de documentação oficial — uma cópia textual da documentação oficial do repo (EN + ZH), byte-idêntica ao upstream na última instantânea verificada.
• Primer de Cordis — os cinco conceitos e a linha do tempo de mecanismos (repository-plugin introduzido 0809, removido 0811; os dois canais de instalação).
• 20+ armadilhas do mundo real com causa raiz + correção (cópias duplas de cordis, trio tsconfig, sessões zstd multi-frame, junctions do Windows, latest obsoleto do npm, …).
• Deep-dives da comunidade — 114 repositórios da comunidade arquivados (15 com deep-dive), mais um índice fonte completo onde cada fato aponta para sua origem.
• Toolchain CLI — dsh-plugin-dev new / check / verify: gerar, verificar estaticamente e validar o empacotamento de plugins DSH; cada check aponta para a seção da skill que ele aplica.

Knowledge base

Path	O que é
SKILL.md	A agent skill dsh-plugin-guide: regras rígidas + caminhos de desenvolvimento por tarefa
package.json · cordis.patch.yml · index.js	O bundle DSH instalável: manifesto dsh.bundle.patch + ponto de entrada que registra a skill
guide/plugin-dev-guide.md	O guia de desenvolvimento completo (10 capítulos)
guide/quick-reference.md	Folha de referência de uma página (5 idiomas)
guide/links.md	Índice de URL curado: docs oficiais de desenvolvimento (site ↔ cópias locais) + links de docs da comunidade
references/official-docs/	Cópia textual da documentação oficial do repo (EN + ZH)
references/*.md	Relatórios de pesquisa: docs do repo, site, Cordis, o paper, ecossistema da comunidade, arquivo de 114 repos (15 com deep-dive)
scripts/	Scripts de download idempotentes + verificador de integridade + gerador de instantânea de tópico
bin/ · src/cli/ · dist/	O CLI dsh-plugin-dev: scaffolder, checker, verifier (TypeScript, empacotado com tsdown)
templates/	Esqueletos TS + JS: modelo de contrato, Config, tests, cordis.patch.yml, READMEs em cinco idiomas
downloads/	Instantâneas cruas — geradas por scripts/, não commitadas

CLI toolchain

O bundle inclui o CLI dsh-plugin-dev sem dependências de runtime (bin/ → dist/dsh-plugin-dev.js empacotado com tsdown). Cada check cita a seção da skill que ele aplica, para que um agente possa continuar auditando manualmente.

dsh-plugin-dev new <name> [--lang ts|js] [--dir <path>] [--force] [--git]
dsh-plugin-dev check [--cwd <dir>] [--json] [--strict]
dsh-plugin-dev verify [--cwd <dir>] [--dsh <bin>] [--pnpm <bin>]

Subcomando	O que faz
new <name>	Gera um repo de plugin TS ou JS: modelo de contrato src/index.ts, Config de Schemastery, tests, tsdown/vitest, cordis.patch.yml comentado, READMEs em cinco idiomas. Idempotente; recusa destinos não vazios sem --force.
check	Checks estáticos: validade de cordis.patch.yml, metadados de package.json (ponteiro dsh.bundle.patch, peer deps, engines, whitelist de files), consistência de READMEs em cinco idiomas, padrões de linha vermelha de engenharia. Emite JSON consumível por CI.
verify	pnpm pack, depois instala/inicia/desinstala o bundle em um perfil DSH_HOME mkdtemp limpo (alinhado com verify:self-contained). Falhas reportam a cauda do log mais sugestões.

CLI configuration

O CLI não tem ajustes hardcoded — cada um é um flag ou uma variável de ambiente.

Ajuste	Flag	Env	Padrão
Diretório de templates	—	DSH_PLUGIN_DEV_TEMPLATES	<package>/templates
Binário dsh	--dsh	DSH_PLUGIN_DEV_DSH	dsh
Binário pnpm	--pnpm	DSH_PLUGIN_DEV_PNPM	pnpm
Timeout de instalação/pack	--timeout	DSH_PLUGIN_DEV_TIMEOUT	300000 ms
Timeout de smoke headless	--smoke-timeout	DSH_PLUGIN_DEV_SMOKE_TIMEOUT	120000 ms

Upstream roadmap

O dsh-plugin-dev é um candidato upstream para o CLI oficial de desenvolvimento de plugins (item C12): o scaffolder/checker/verifier são as camadas mecânicas, enquanto SKILL.md + guide/ seguem sendo a camada cognitiva.

Quick start

# 1. install the bundle into your profile
dsh plugin --profile web add "github:PerryLink/dsh-plugin-guide#main"

# or from npm (published releases)
dsh plugin --profile web add dsh-plugin-guide

# 2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-guide'

Depois é só pedir ao seu agente: "Use a skill dsh-plugin-guide para me construir um plugin de …."

Ou use o CLI diretamente:

npx dsh-plugin-guide new hello-plugin            # gera um repo de plugin TS
npx dsh-plugin-guide check --json                # check estático
npx dsh-plugin-guide verify                      # pack + smoke de perfil limpo

Install & uninstall

• canal git (último main): dsh plugin --profile web add github:PerryLink/dsh-plugin-guide#<sha> — fixe um commit para reprodutibilidade; o ponto de entrada é JS ESM puro, sem etapa de build.
• canal npm (versões publicadas): dsh plugin --profile web add dsh-plugin-guide.
• canal tarball: pnpm pack neste repo, depois dsh plugin --profile web add ./dsh-plugin-guide-<version>.tgz.
• desinstalar: dsh plugin --profile web remove dsh-plugin-guide.

Copy as a plain agent skill

Você também pode copiar a pasta inteira para o diretório de skills do seu agente (os caminhos relativos permanecem intactos):

# Windows (PowerShell)
pwsh -File scripts/install-skill.ps1 `
  -Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide"   # ou <project>\.agents\skills\dsh-plugin-guide

# macOS / Linux
pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide   # ou <project>/.agents/skills/dsh-plugin-guide

O instalador pula downloads/ (gerado) e .github/, e então verifica cada arquivo copiado byte a byte. Um Copy-Item -Recurse manual da pasta inteira também funciona.

Configuration

O bundle de skill não expõe nenhum Config de Schemastery — ele registra a base de conhecimento como uma agent skill sem chaves ajustáveis. O CLI dsh-plugin-dev lê seus ajustes de flags e variáveis de ambiente DSH_PLUGIN_DEV_* (veja CLI toolchain).

Tools & surfaces

Surface	Kind	Notes
dsh-plugin-guide	skill	Registrada via ctx.skills; carrega SKILL.md + ./guide/ + ./references/ sob demanda
dsh-plugin-dev	bin (CLI)	Subcomandos new / check / verify; não é uma linha de plugin DSH

Permissions & data

• Permissions: declara filesystem:read em seu manifesto de workshop.
• Data: somente leitura — lê seus próprios arquivos empacotados guide/ e references/. Sem solicitações de rede, sem escritas, sem chamadas de modelo.

Security boundaries

• Base de conhecimento somente leitura. O bundle apenas lê seus próprios arquivos; nunca escreve, nunca usa a rede e nunca invoca um modelo.
• A documentação oficial são cópias textuais. references/official-docs/ nunca é editada aqui; reporte problemas ao upstream e ressincronize apenas com scripts/sync-official-docs.ps1.
• Limites de distribuição. O conteúdo de terceiros empacotado mantém sua licença de upstream; consulte NOTICE.md (ex.: downloads/ é somente local; awesome-dsh-plugins não deve ser redistribuído).

Known limitations

• A documentação oficial é uma instantânea. Ressincronize com scripts/sync-official-docs.ps1 quando o upstream mudar; o selo de atualidade e o hash de commit referenciam references/official-docs/SNAPSHOT.md.
• downloads/ é gerado, não commitado. As instantâneas cruas (arquivos de repos da comunidade, Discussions, artigos) devem ser geradas com os scripts antes do uso.
• O conteúdo de awesome-dsh-plugins é somente local. Seu upstream declara uma restrição de uso interno, então não é redistribuído com o repo.

Keeping it fresh

pwsh -File scripts/sync-official-docs.ps1                     # cópia textual de docs a partir de um checkout local
pwsh -File scripts/download-sources.ps1                       # site/docs oficiais, Cordis, paper
pwsh -File scripts/download-community-repos.ps1               # repositórios da comunidade (tarballs codeload)
pwsh -File scripts/download-community-articles.ps1            # artigos da comunidade zh/en/HN
pwsh -File scripts/archive-discussions.ps1                    # Discussions oficiais (precisa de $env:GH_TOKEN)
pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <dir>       # censo do tópico dsh-plugin
pwsh -File scripts/verify-kit.ps1 -Checkout <checkout>        # caminhos críticos + varredura de links + deriva de docs

Development

O bundle de skill (index.js) é ESM puro, sem etapa de build; o CLI dsh-plugin-dev é TypeScript compilado com tsdown. Portas:

pnpm install --frozen-lockfile
pnpm run typecheck && pnpm run typecheck:ci
pnpm test
pnpm run build
pnpm run verify:artifacts        # auto-check + smoke de scaffold (sem rede)
pnpm run verify:self-contained   # pack + smoke de instalação/início/desinstalação em perfil limpo
pnpm pack
pwsh -File scripts/verify-kit.ps1   # caminhos críticos + varredura de links (+ deriva de docs com -Checkout <checkout>)

Topics

dsh, deepseek-harness, dsh-plugin, cordis, agent-skill, plugin-development, knowledge-base, cli, scaffold, checker

Contributors

• PerryLink — criador e mantenedor: conteúdo da base de conhecimento, a transformação para bundle instalável, envios ao ecossistema e engenharia de comunidade.
• A manutenção diária é assistida por agentes do DeepSeek Harness (eles não têm conta no GitHub e são listados aqui por transparência, não como contribuidores).

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-fast	Diagnóstico de desempenho só de leitura 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-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.

Disclaimer

Mantido pela comunidade, não é um produto oficial da DeepSeek. O DeepSeek Harness está em preview de desenvolvedor e publica mudanças quebradoras; na dúvida, a documentação oficial em references/official-docs/ é a fonte da verdade.

License

Apache License 2.0 © 2026 dsh-plugin-guide contributors — nosso próprio texto (SKILL.md, guide/, references/, scripts/, este README) é Apache-2.0; o conteúdo de terceiros empacotado é documentado em NOTICE.md.