dsh-test-drive 0.3.25 → 0.3.26

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/CHANGELOG.md +0 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +548 -0
  4. package/README.es.md +548 -0
  5. package/README.hi.md +548 -0
  6. package/README.md +337 -229
  7. package/README.pt.md +548 -0
  8. package/SECURITY.md +0 -0
  9. package/THIRD_PARTY_NOTICES.md +0 -0
  10. package/cordis.patch.yml +0 -0
  11. package/lib/index.js +1 -1
  12. package/lib/types/batch.d.ts +0 -0
  13. package/lib/types/batch.d.ts.map +0 -0
  14. package/lib/types/capability.d.ts +0 -0
  15. package/lib/types/capability.d.ts.map +0 -0
  16. package/lib/types/command.d.ts +0 -0
  17. package/lib/types/command.d.ts.map +0 -0
  18. package/lib/types/config.d.ts +0 -0
  19. package/lib/types/config.d.ts.map +0 -0
  20. package/lib/types/domain.d.ts +0 -0
  21. package/lib/types/domain.d.ts.map +0 -0
  22. package/lib/types/drive.d.ts +0 -0
  23. package/lib/types/drive.d.ts.map +0 -0
  24. package/lib/types/driver.d.ts +0 -0
  25. package/lib/types/driver.d.ts.map +0 -0
  26. package/lib/types/index.d.ts +0 -0
  27. package/lib/types/index.d.ts.map +0 -0
  28. package/lib/types/report.d.ts +0 -0
  29. package/lib/types/report.d.ts.map +0 -0
  30. package/lib/types/result.d.ts +0 -0
  31. package/lib/types/result.d.ts.map +0 -0
  32. package/lib/types/sanitize.d.ts +0 -0
  33. package/lib/types/sanitize.d.ts.map +0 -0
  34. package/lib/types/session-log.d.ts +0 -0
  35. package/lib/types/session-log.d.ts.map +0 -0
  36. package/lib/types/tools.d.ts +0 -0
  37. package/lib/types/tools.d.ts.map +0 -0
  38. package/lib/types/version.d.ts +1 -1
  39. package/lib/types/version.d.ts.map +0 -0
  40. package/lib/types/workspace.d.ts +0 -0
  41. package/lib/types/workspace.d.ts.map +0 -0
  42. package/package.json +46 -24
  43. package/README-es.md +0 -418
  44. package/README-hi.md +0 -418
  45. package/README-pt.md +0 -418
  46. package/README-zh.md +0 -417
package/README-pt.md DELETED
@@ -1,418 +0,0 @@
1
- <div align="center">
2
-
3
- # 🧪 dsh-test-drive
4
- - **Canal 1024 store**: `npm i -g dsh1024` uma vez, depois `dsh1024 plugin --profile web add dsh-test-drive` (conta para o ranking de instalações do [deepseek1024.com](https://deepseek1024.com)).
5
-
6
- **Testes isolados de instalação e inicialização para plugins do DeepSeek Harness.**
7
-
8
- *Instale, teste, verifique e limpe em um perfil descartável — seu `~/.dsh` real permanece intocado.*
9
-
10
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
11
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-test-drive)
12
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
13
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-test-drive.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
14
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/)
15
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
16
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-test-drive/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-test-drive/actions)
17
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-test-drive?label=version)](https://github.com/PerryLink/dsh-test-drive/releases)
18
- [![npm version](https://img.shields.io/npm/v/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
19
- [![npm downloads](https://img.shields.io/npm/dm/dsh-test-drive)](https://www.npmjs.com/package/dsh-test-drive)
20
-
21
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
-
23
- ```sh
24
- dsh plugin --profile <name> add dsh-test-drive
25
- ```
26
-
27
-
28
- </div>
29
-
30
- ---
31
-
32
-
33
- **📖 Base de conhecimento do ecossistema** — dados medidos, não marketing: [guia de desenvolvimento · dados de seleção · critérios de manutenção](https://perrylink.github.io/dsh-plugin-guide/).
34
-
35
- <!-- star-cta -->
36
- ## Install & uninstall (Instalação e desinstalação)
37
-
38
- ```sh
39
- dsh plugin --profile web add dsh-test-drive # instalar (npm) — ou a forma git acima
40
- dsh plugin --profile web remove dsh-test-drive # desinstalar
41
- ```
42
-
43
- ## ⭐ 如果它帮到了你
44
-
45
- Este plugin faz parte da [família de plugins DSH](https://github.com/PerryLink) (mais de 40, todos Apache-2.0). Se for útil, **deixe uma estrela**: não desbloqueia nada, mas ajuda a próxima pessoa a encontrá-lo.
46
-
47
- *English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
48
-
49
- ## What is dsh-test-drive?
50
-
51
- Testes isolados de instalação e inicialização para plugins do DeepSeek Harness.
52
-
53
- Instale, teste, verifique e limpe em um perfil descartável — seu `~/.dsh` real permanece intocado.
54
-
55
- ![Diagrama de fluxo de dsh-test-drive: pergunta → fontes seladas → relatório.](docs/assets/dsh-test-drive-flow.svg)
56
-
57
- *Visão geral do fluxo: pergunta → fontes seladas → relatório. Os exemplos abaixo usam a superfície real de comandos.*
58
-
59
-
60
- *A mesma execução, animada.*
61
-
62
- ## Compatibility (Compatibilidade)
63
-
64
- | Componente | Versão |
65
- |---|---|
66
- | DeepSeek Harness | **`dsh-v0.2.1-alpha.1`** (tag do GitHub, verificado em 2026-09-11: cadeia completa de portas + smoke de instalação de perfil). Linhas de dependência npm `0.1.2-rc.1` e `0.1.7-rc.2` (dependências de pares `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0`). |
67
- | Node.js | `^22.19.0 \|\| >=24.0.0` |
68
- | Gerenciador de pacotes | `pnpm@11.7.0` |
69
- | Plataforma | Windows / macOS / Linux (plugin apenas host) |
70
- | Ferramentas externas | CLI `dsh` no PATH (autodetecção, shims npm analisados), `pnpm` no PATH |
71
-
72
- ## What you get (O que você obtém)
73
-
74
- - Ferramenta `test_drive` — um alvo pelo pipeline completo: `dsh plugin add` → verificação do patch com `--dump-config` → inicialização headless (varredura de marcadores FAILED + tarefa opcional de uma frase) → asserção de capacidade opcional → `dsh plugin remove` → limpeza em quarentena. Retorna o registro estruturado de forma síncrona, ou `{ kind: 'background', jobId }` com `background: true`.
75
- - Comando `/testdrive` — lote de alvos separados por espaços/vírgulas como tarefa em segundo plano `drive-batch` sobre `ctx.jobs`, produzindo um relatório matricial (JSON + Markdown).
76
- - Ferramenta `drive_report` — busca qualquer execução (`tdr_...`), matriz (`tdm_...`) ou a matriz mais recente; renderizada em Markdown.
77
- - Asserção de capacidade — além de “inicializou e saiu”: a etapa opcional `capability` faz o agente chamar a ferramenta nomeada (ou executar `/command`) e verifica no registro durável de sessão que a invocação ocorreu e que a saída observada contém `expect`. Uma inicialização limpa é só um teste de fumaça; `observed` prova que uma capacidade nomeada realmente funciona.
78
- - Resultados estruturados — cada registro carrega o discriminador `schema: "dsh-test-drive/v1"` com campos de primeira classe: `stages.install.status` (`pass`/`fail`), `stages.smoke.status` (`pass`/`fail`/`boot-ok`/`skipped`), `durationMs` por etapa, `summary`/`outputTail` saneados e um `verdict` geral (`pass`/`fail`/`partial`/`unknown`). Este é o contrato legível por máquina consumido pelos pontuadores (dsh-score).
79
- - Segurança por construção — cada diretório temporário é criado por este plugin sob um prefixo dedicado `dsh-test-drive-`, registrado em um registro de propriedade ativo e removido apenas pela escada dry-run → renomear para quarentena → excluir. O perfil do host nunca é lido nem gravado.
80
-
81
- ## Quick start (Início rápido)
82
-
83
- ### Canal git
84
-
85
- ```sh
86
- dsh plugin --profile web add github:PerryLink/dsh-test-drive#<commit-sha>
87
- ```
88
-
89
- O primeiro `add` falha porque o pnpm bloqueia a compilação `prepare` do pacote; copie a chave exata que o pnpm imprimiu no `pnpm-workspace.yaml` do perfil e execute novamente:
90
-
91
- ```yaml
92
- allowBuilds:
93
- 'dsh-test-drive': true
94
- ```
95
-
96
- ### Canal npm
97
-
98
- ```sh
99
- dsh plugin --profile web add dsh-test-drive
100
- ```
101
-
102
- Pacotes pré-compilados não precisam de permissão de compilação. Reinicie o perfil e use `test_drive` / `/testdrive` em uma sessão.
103
-
104
- ## DSH Desktop não é um host de teste suportado
105
-
106
- `test_drive` precisa de um CLI `dsh` capaz de iniciar um **segundo** processo headless do DSH.
107
- O launcher `dsh.CMD` do DSH Desktop só permite `dsh plugin …`, `--dump-config` e `--version`;
108
- por política ele rejeita um segundo boot headless. Aponte `config.dshBin` para um CLI `dsh`
109
- instalado por npm/pnpm (ou Node + entrada JS do dsh). O erro agora diz isso explicitamente,
110
- em vez de “cannot parse npm shim”.
111
-
112
- ## Configuration (Configuração)
113
-
114
- Todas as chaves são opcionais (padrões exibidos); valores inválidos falham ruidosamente no carregamento.
115
-
116
- | Chave | Padrão | Descrição |
117
- |---|---|---|
118
- | `profileName` | `headless` | Modelo de perfil inicializado dentro de cada DSH_HOME descartável (bundles base + headless). |
119
- | `dshBin` | `""` | Caminho absoluto que substitui o executável dsh; vazio autodetecta `dsh` no PATH. |
120
- | `headlessTask` | `"Reply with exactly: ok"` | Tarefa de uma frase para a etapa de inicialização; vazio pula a etapa. |
121
- | `forwardEnv` | `[]` | NOMES de variáveis de ambiente (nunca valores) repassados aos processos filhos do perfil de teste. |
122
- | `allowBuilds` | `true` | Permite uma compilação `prepare` de git bloqueada no perfil de teste e tenta a instalação mais uma vez. |
123
- | `installTimeoutMs` | `600000` | Prazo da etapa `dsh plugin add`. |
124
- | `configTimeoutMs` | `60000` | Prazo da etapa `--dump-config`. |
125
- | `smokeTimeoutMs` | `300000` | Prazo da etapa de inicialização headless. |
126
- | `capabilityTimeoutMs` | `300000` | Prazo da tarefa de asserção de capacidade.
127
- | `capability.enabled` | `false` | Executa a etapa de asserção de capacidade (registrado → invocado → observado).
128
- | `capability.kind` | `tool` | O que afirmar: `tool` ou `command`.
129
- | `capability.name` | `""` | Nome da ferramenta ou comando (sem a `/` inicial).
130
- | `capability.args` | `""` | Texto de invocação: argumentos da ferramenta (estilo JSON) ou palavras do comando.
131
- | `capability.expect` | `""` | Literal esperado na saída observada (substring sem distinção de maiúsculas).
132
- | `uninstallTimeoutMs` | `120000` | Prazo da etapa `dsh plugin remove`. |
133
- | `outputTailBytes` | `8000` | Limite da cauda de saída saneada registrada por etapa. |
134
- | `keepTempDirs` | `false` | Mantém os diretórios temporários em caso de falha para análise forense (a propriedade é abandonada; você limpa). |
135
- | `maxBatchTargets` | `20` | Limite de lote do `/testdrive`. |
136
- | `batchConcurrency` | `1` | Concorrência do lote (serial evita contenção no armazenamento pnpm). |
137
-
138
- ## Tools & surfaces (Ferramentas e superfícies)
139
-
140
- ### `test_drive`
141
-
142
- ```
143
- test_drive(target: string, headlessTask?: string, background?: boolean,
144
- capability?: { kind: 'tool' | 'command', name: string,
145
- args: string, expect: string })
146
- ```
147
-
148
- - `target` — especificação git (`github:owner/repo#sha`, `git+https://...`), nome npm, caminho local ou tarball `.tgz`.
149
- - `capability` — asserção após o smoke: o agente chama `name` (ferramenta) com `args` ou executa `/name` (comando); a etapa lê o registro durável de sessão e exige que a saída observada contenha `expect`. Requer `DEEPSEEK_API_KEY` (ambiente do host ou `forwardEnv`); sem ela, a etapa fica `skipped`, nunca falha.
150
- - Retorna o registro estruturado completo; exemplo abaixo.
151
- - `background: true` inicia uma tarefa `drive-batch` e retorna seu id.
152
-
153
- ### `/testdrive <alvos...>`
154
-
155
- Inicia uma tarefa de lote em segundo plano; o progresso flui pela saída da tarefa e a última linha nomeia o id da matriz para o `drive_report`.
156
-
157
- ### `drive_report(id?)`
158
-
159
- Retorna um registro de execução (`tdr_...`), uma matriz (`tdm_...`) ou — sem id — a matriz mais recente.
160
-
161
- ### Exemplo de resultado estruturado
162
-
163
- ```json
164
- {
165
- "schema": "dsh-test-drive/v1",
166
- "run": { "runId": "tdr_9f2c...", "startedAt": "2026-08-16T00:00:00.000Z",
167
- "finishedAt": "2026-08-16T00:00:45.120Z", "durationMs": 45120,
168
- "harnessVersion": "0.1.7-rc.2", "pluginVersion": "0.3.10",
169
- "platform": "win32", "node": "v22.22.3" },
170
- "target": { "kind": "repo", "spec": "github:owner/dsh-click#abc123",
171
- "resolved": { "packageName": "dsh-click", "packageVersion": "0.1.0",
172
- "hasBundleManifest": true } },
173
- "isolation": { "tempDshHome": true, "tempWorkspace": true, "tempStore": true,
174
- "hostHomeTouched": false },
175
- "stages": {
176
- "install": { "status": "pass", "exitCode": 0, "durationMs": 30412, "attempts": 2,
177
- "summary": "install ok after allowBuilds allowance", "outputTail": "",
178
- "allowBuildsNeeded": true },
179
- "config": { "status": "pass", "exitCode": 0, "durationMs": 2310, "attempts": 1,
180
- "summary": "dump ok (exit 0)", "outputTail": "",
181
- "patchEffective": true, "layers": ["dsh-click"] },
182
- "smoke": { "status": "boot-ok", "exitCode": 1, "durationMs": 4123, "attempts": 1,
183
- "summary": "booted without loader failures; headless task did not complete (credentials/model unreachable)",
184
- "outputTail": "", "bootFailed": false, "taskCompleted": false },
185
- "capability": { "status": "observed", "exitCode": 0, "durationMs": 8123, "attempts": 1,
186
- "summary": "tool \"plugin_vet\" called and its result contains the expectation",
187
- "outputTail": "", "capabilityKind": "tool", "name": "plugin_vet",
188
- "expectMatched": true,
189
- "detail": "tool \"plugin_vet\" called and its result contains the expectation" },
190
- "uninstall": { "status": "pass", "exitCode": 0, "durationMs": 5123, "attempts": 1,
191
- "summary": "remove ok (exit 0)", "outputTail": "" },
192
- "cleanup": { "status": "pass", "quarantined": true, "removed": true,
193
- "summary": "owned temp root quarantined and removed" }
194
- },
195
- "verdict": "pass",
196
- "verdictReason": "install, patch, boot, and uninstall verified; headless task inconclusive (see smoke.summary)"
197
- }
198
- ```
199
-
200
- Regras de veredicto: falha de instalação, de inicialização (`smoke.fail`) ou uma etapa de capacidade que chegou a `not-registered`/`failed` ⇒ `fail`; instalação aprovada + patch efetivo + inicialização limpa (`pass`/`boot-ok`) + desinstalação aprovada ⇒ `pass` (com nota de capacidade quando `observed`); instalado mas sem alguma garantia posterior ⇒ `partial`; caso contrário ⇒ `unknown`.
201
-
202
- ## CI (GitHub Actions)
203
-
204
- O repositório inclui um [`action.yml`](action.yml) composite reutilizável com `uses:` em qualquer repositório de plugins: executa o alvo em um perfil descartável e emite o par de relatórios que a CI consome — Markdown (comentário de PR) e JUnit XML (verificação de status). Entradas `target` (obrigatório)/`headless-task`/`dsh-version`; saídas `markdown`/`junit`/`verdict`. O drive não requer chave; apenas a asserção de capacidade precisa de `DEEPSEEK_API_KEY` e fica `skipped` (nunca falha) sem ela.
205
-
206
- ## Permissions & data (Permissões e dados)
207
-
208
- - Apenas serviços públicos são consumidos: `ctx.subprocess`, `ctx.jobs`, `ctx.storageDomain`, `ctx.tools`, `ctx.commands`.
209
- - Os relatórios são armazenados no domínio de armazenamento `test_drive` (tabelas `runs`, `matrices`; ponteiro de matriz mais recente). Quando a composição não tem `storageDomain` (ex.: o perfil headless oficial), as ferramentas continuam funcionando e a persistência é desativada com motivo registrado.
210
- - Os processos filhos herdam um ambiente **sem credenciais**: segredos do host nunca chegam ao perfil testado, a menos que você os nomeie explicitamente em `forwardEnv`. Os valores nunca são registrados.
211
- - Todas as strings de relatório/log passam por saneadores puros: literais de token, credenciais em URL e cabeçalhos bearer são redigidos, caminhos raiz temporários são substituídos por `<testdrive-temp>` e as caudas são limitadas por bytes.
212
-
213
- ## Security boundaries (Limites de segurança)
214
-
215
- - **Isolamento.** Cada teste roda dentro de uma raiz `mkdtemp` nova sob o diretório temporário do SO: um `DSH_HOME` descartável, um diretório de trabalho descartável e um armazenamento pnpm redirecionado. O código do plugin testado só roda nesse perfil; seu perfil do host permanece intacto.
216
- - **Propriedade.** Um registro ativo guarda cada raiz criada por esta instância. A limpeza recusa qualquer caminho que não seja um filho direto registrado do diretório temporário do SO com o prefixo `dsh-test-drive-` — sem varreduras de `%TEMP%`, sem prefixos alheios, sem caminhos do diretório real.
217
- - **Escada de limpeza.** Antes de qualquer mutação, o plano dry-run completo é registrado (caminhos absolutos). A exclusão primeiro renomeia a raiz para um diretório `dsh-test-drive-quarantine-<ts>`, verifica e então exclui; falhas deixam o diretório em quarentena e são reportadas, nunca descartadas em silêncio. A limpeza roda em um `finally` em sucesso, falha, timeout e aborto, e novamente no desmonte do plugin.
218
- - **`allowBuilds` é uma permissão real.** Permitir a compilação `prepare` de um pacote git executa o código desse pacote no momento da instalação. A permissão fica restrita ao perfil descartável, mas teste apenas alvos confiáveis e fixe commits.
219
- - **A inicialização headless é sem chave por padrão.** A verificação de inicialização não precisa de credenciais; concluir a tarefa precisa. Repasse credenciais explicitamente (`forwardEnv`) e nunca as registre.
220
-
221
- ## Known limitations (Limitações conhecidas)
222
-
223
- - Instalar alvos de registro/git requer acesso à rede a partir dos processos `dsh`/pnpm filhos.
224
- - A tarefa de inicialização precisa de credenciais do modelo para chegar a `pass`; sem elas, reporta o honesto `boot-ok`.
225
- - Em composições sem `storageDomain`, os relatórios não são persistidos (`drive_report` falha honestamente).
226
- - `dsh` deve ser localizável no PATH (ou configure `dshBin`); no Windows o shim `.cmd`/`.bat` do npm é analisado automaticamente; uma resolução `.ps1` pede `dshBin`.
227
- - Os lotes rodam em série por padrão; aumentar `batchConcurrency` só afeta a contenção de disco do armazenamento pnpm, não a corretude.
228
-
229
- ## Development (Desenvolvimento)
230
-
231
- ```sh
232
- pnpm install
233
- pnpm run typecheck && pnpm run typecheck:ci && pnpm test
234
- pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack
235
- ```
236
-
237
- - `typecheck` resolve `@deepseek-ai/*` pelo checkout local do harness; `typecheck:ci` verifica contra os tipos publicados `0.1.7-rc.2`.
238
- - Os testes usam a pilha real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/armazenamento com um provedor de subprocesso roteirizado.
239
- - End-to-end com CLI real (requer rede + `dsh` no PATH): `DSH_TESTDRIVE_E2E=1 pnpm run test:e2e` — testa o checkout deste próprio pacote pelo loop real de instalação e inicialização.
240
- - Lançamento: `node scripts/release.mjs <x.y.z>` (sobe versão, carimba o CHANGELOG, repete a porta, commit + tag; nunca faz push).
241
-
242
- ## Topics
243
-
244
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `plugin-testing`, `install-smoke`, `compatibility-matrix`, `ci`
245
-
246
- ## Contributors (Contribuidores)
247
-
248
- [PerryLink](https://github.com/PerryLink) — design e implementação.
249
-
250
- ## PerryLink DSH Plugin Family
251
-
252
- Este projeto faz parte da família de plugins do DeepSeek Harness da [PerryLink](https://github.com/PerryLink). O registro fica recolhido abaixo para que cada README mantenha uma primeira tela curta; expanda para ver cada linha e seu status.
253
-
254
- <details>
255
- <summary>Expandir todos os plugins</summary>
256
-
257
- | Plugin | Status |
258
- |---|---|
259
- | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
260
- | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
261
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
262
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | |
263
- | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
264
- | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
265
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | |
266
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
267
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
268
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
269
- | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
270
- | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
271
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
272
- | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
273
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
274
- | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
275
- | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
276
- | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
277
- | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
278
- | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
279
- | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
280
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
281
- | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
282
- | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
283
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
284
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
285
- | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
286
- | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
287
- | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
288
- | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
289
- | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
290
- | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
291
- | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
292
- | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
293
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
294
- | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
295
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
296
- | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
297
- | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
298
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
299
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
300
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
301
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
302
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
303
- | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
304
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
305
- | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
306
- | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
307
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
308
- | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
309
- | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
310
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
311
- | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
312
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
313
- | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
314
- | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
315
- | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
316
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
317
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
318
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
319
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
320
- | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
321
- | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
322
- | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
323
- | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
324
- | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
325
- | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
326
- | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
327
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
328
- | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
329
- | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
330
- | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
331
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
332
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
333
- | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
334
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
335
- | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
336
- | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
337
- | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
338
- | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
339
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
340
- | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
341
- | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
342
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
343
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
344
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
345
- | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
346
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver o README do repositório |
347
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver o README do repositório |
348
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver o README do repositório |
349
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver o README do repositório |
350
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver o README do repositório |
351
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRADO — ver o README do repositório |
352
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO — ver o README do repositório |
353
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO — ver o README do repositório |
354
-
355
- </details>
356
-
357
- ## License (Licença)
358
-
359
- [Apache-2.0](LICENSE)
360
-
361
- ### Instalar a partir do mercado do DSH Desktop
362
-
363
- 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.
364
-
365
- ### Exemplos
366
-
367
- São os pontos de entrada reais; instale e chame um.
368
-
369
- #### Exemplo detalhado
370
-
371
- **Comando**
372
-
373
- ~~~sh
374
- test_drive({ target: "dsh-click" })
375
- ~~~
376
-
377
- **Saída**
378
-
379
- ~~~text
380
- # Test drive tdr_0b9b6e6a61e3e80cc4620f2e
381
-
382
- - Target: `dsh-click` (npm)
383
- - Verdict: ✅ pass — install, patch, boot, task, and uninstall all verified
384
- - Installed: dsh-click@0.2.0
385
- - Isolation: throwaway DSH_HOME + workspace + pnpm store; host profile untouched
386
-
387
- | Stage | Result | Exit | Duration | Summary |
388
- |---|---|---|---|---|
389
- | install | ✅ pass | 0 | 1 ms | install ok (exit 0) |
390
- | config (--dump-config) | ✅ pass | 0 | 0 ms | patch effective: dsh-click |
391
- | smoke (headless boot) | ✅ pass | 0 | 0 ms | booted cleanly and the headless task completed |
392
- | capability | ⏭️ skipped | null | 0 ms | capability assertion disabled (config.capability.enabled is false and no per-drive capability given) |
393
- | uninstall | ✅ pass | 0 | 0 ms | remove ok (exit 0) |
394
- | cleanup | ✅ pass | — | — | owned temp root quarantined and removed |
395
- ~~~
396
-
397
- *Observado em `README.md:153-163,174-211; tests/drive.spec.ts:73-101; src/report.ts:34-55`*
398
-
399
- #### Ramo de falha
400
-
401
- **Entrada**
402
-
403
- ~~~text
404
- {"target":" "}
405
- ~~~
406
-
407
- **Saída**
408
-
409
- ~~~text
410
- isError=true; error.message=dsh-test-drive: target must be a non-empty string
411
- ~~~
412
-
413
- *Observado em `plugins/dsh-test-drive/src/tools.ts:297-299 (blank target check); exercised through plugins/dsh-test-drive/tests/harness.ts`*
414
-
415
- #### Exemplos breves
416
-
417
-
418
-