DeepSeek Harness: Plugins Comunitários

npm package name: @dsh-plugin/plugin-name
GitHub repository name: dsh-plugin-name
Configuration reference name: plugin-name

npm: @dsh-plugin/database    → GitHub: dsh-plugin-database
npm: @dsh-plugin/git-enhanced → GitHub: dsh-plugin-git-enhanced
npm: @dsh-plugin/docker      → GitHub: dsh-plugin-docker

# Buscar repositórios com o tópico dsh-plugin
gh repo list --topic dsh-plugin --limit 20

# Ordenar por estrelas
gh search repos "dsh-plugin" --sort stars --limit 20

# Buscar pacotes de plugins DSH
npm search @dsh-plugin

# Ver detalhes de um plugin específico
npm info @dsh-plugin/database

# Instalar do npm
dsh plugin add @dsh-plugin/database

# Saída da instalação
📦 Installing @dsh-plugin/database@1.2.0...
✅ Plugin installed successfully!

Available tools:
  - database.query: Execute SQL queries
  - database.migrate: Run database migrations
  - database.schema: Inspect database schema

# Instalar do repositório GitHub
dsh plugin add github:alice/dsh-plugin-redis

# Instalar branch específica
dsh plugin add github:alice/dsh-plugin-redis#feature/cluster-support

# Instalar tag de versão específica
dsh plugin add github:alice/dsh-plugin-redis#v2.1.0

# Listar plugins instalados
dsh plugin list

# Saída
📦 Installed Plugins:
  @dsh-plugin/database   v1.2.0  ✅ enabled
  @dsh-plugin/redis      v2.1.0  ✅ enabled
  @dsh-plugin/git-enhanced v0.8.0 ⚠️ disabled

# Desabilitar plugin (sem desinstalar)
dsh plugin disable @dsh-plugin/redis

# Habilitar plugin
dsh plugin enable @dsh-plugin/redis

# Desinstalar plugin
dsh plugin remove @dsh-plugin/database

# Atualizar plugin
dsh plugin update @dsh-plugin/database

# dsh.config.yaml
plugins:
  # Plugin npm
  - name: "@dsh-plugin/database"
    version: "^1.2.0"
    enabled: true
    config:
      default_connection: "postgresql://localhost/mydb"
  
  # Plugin GitHub
  - name: "@dsh-plugin/redis"
    source: "github:alice/dsh-plugin-redis"
    version: "v2.1.0"
    enabled: true
    config:
      host: "localhost"
      port: 6379
  
  # Plugin local
  - name: "my-custom-tool"
    source: "./plugins/my-custom-tool"
    enabled: true

# dsh.config.yaml
plugins:
  - name: "@dsh-plugin/database"
    config:
      connections:
        main: "postgresql://localhost/myapp"
        analytics: "postgresql://localhost/analytics"

👤 Alice: Consulte os 10 usuários mais recentemente registrados da tabela users

🤖 Agent:
🔧 Usando ferramenta: database.query
  → Conexão: main
  → Query: SELECT * FROM users ORDER BY created_at DESC LIMIT 10
  → Resultados: 10 linhas

👤 Bob: Verifique a qualidade do código no diretório src/

🤖 Agent:
🔧 Usando ferramenta: linter.check
  → Diretório: src/
  → Config: .eslintrc.json
  → Resultados: 12 avisos, 3 erros
  
  Erros:
  - src/utils/format.ts:45 — Tipo any inesperado
  - src/routes/api.ts:128 — Tipo de retorno ausente
  - src/models/user.ts:23 — Import não utilizado

# Clonar repositório do plugin para revisão
git clone https://github.com/user/dsh-plugin-example.git
cd dsh-plugin-example

# Verificar arquivo de entrada principal
cat src/index.ts

# Verificar dependências
cat package.json | grep -A 20 "dependencies"

# Verificar requisições de rede suspeitas
grep -r "fetch\|http\|axios\|request" src/

# Verificar operações no sistema de arquivos
grep -r "fs\.\|readFile\|writeFile\|exec\|spawn" src/

# Verificar acesso a variáveis de ambiente
grep -r "process\.env" src/

// Declaração de permissões do plugin
export default definePlugin({
  name: 'dsh-plugin-example',
  permissions: [
    'fs.read',        // Ler arquivos
    'fs.write',       // Escrever arquivos
    'network.outbound', // Requisições de rede de saída
    'shell.execute',  // Executar comandos Shell
    'env.read'        // Ler variáveis de ambiente
  ],
  // ...
});

📦 Installing @dsh-plugin/example@1.0.0

⚠️ Este plugin solicita as seguintes permissões:
  ✅ fs.read        — Ler arquivos no workspace
  ⚠️ network.outbound — Fazer requisições HTTP de saída
  🔴 shell.execute  — Executar comandos shell

Continuar instalação? (y/n)

# Usar o template oficial
npx @deepseek-ai/create-dsh-plugin my-plugin

# Saída
📁 Creating plugin: my-plugin
  ├── src/
  │   └── index.ts
  ├── package.json
  ├── tsconfig.json
  └── README.md

✅ Plugin scaffolded! Run:
  cd my-plugin
  npm install
  npm run dev

dsh-plugin-my-plugin/
├── src/
│   ├── index.ts          # Entrada principal do plugin
│   ├── tools/            # Definições de ferramentas
│   │   └── my-tool.ts
│   └── services/         # Definições de serviços
│       └── my-service.ts
├── package.json
├── tsconfig.json
├── dsh-plugin.yaml       # Metadados do plugin
└── README.md

# Build
npm run build

# Publicar
npm publish --access public

# Adicionar GitHub Topic
# Nas configurações do repositório GitHub, adicione o tópico: dsh-plugin

name: dsh-plugin-my-plugin
version: 1.0.0
description: Mergulhe no ecossistema de plugins comunitários do DSH — descubra, instale, configure e avalie plugins de terceiros, domine as melhores práticas de...
author: "Alice"
license: "MIT"
repository: "https://github.com/alice/dsh-plugin-my-plugin"
keywords:
  - dsh-plugin
  - database
  - tools
permissions:
  - fs.read
  - network.outbound
compatibility:
  dsh: ">=0.5.0"