dsh-observe 0.2.27 → 0.2.28

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 (96) hide show
  1. package/CHANGELOG.md +0 -0
  2. package/LICENSE +0 -0
  3. package/README.en.md +446 -0
  4. package/README.es.md +446 -0
  5. package/README.hi.md +446 -0
  6. package/README.md +292 -196
  7. package/README.pt.md +446 -0
  8. package/THIRD_PARTY_NOTICES.md +0 -0
  9. package/cordis.patch.yml +6 -1
  10. package/lib/index.js +72 -10
  11. package/lib/typert.host.js +0 -0
  12. package/lib/types/backoff.d.ts +0 -0
  13. package/lib/types/backoff.d.ts.map +0 -0
  14. package/lib/types/backoff.js +0 -0
  15. package/lib/types/backoff.js.map +0 -0
  16. package/lib/types/collector.d.ts +0 -0
  17. package/lib/types/collector.d.ts.map +1 -1
  18. package/lib/types/collector.js +22 -2
  19. package/lib/types/collector.js.map +1 -1
  20. package/lib/types/config.d.ts +9 -0
  21. package/lib/types/config.d.ts.map +1 -1
  22. package/lib/types/config.js +3 -1
  23. package/lib/types/config.js.map +1 -1
  24. package/lib/types/ids.d.ts +0 -0
  25. package/lib/types/ids.d.ts.map +0 -0
  26. package/lib/types/ids.js +0 -0
  27. package/lib/types/ids.js.map +0 -0
  28. package/lib/types/index.d.ts +0 -0
  29. package/lib/types/index.d.ts.map +0 -0
  30. package/lib/types/index.js +0 -0
  31. package/lib/types/index.js.map +0 -0
  32. package/lib/types/model.d.ts +6 -0
  33. package/lib/types/model.d.ts.map +1 -1
  34. package/lib/types/model.js +0 -0
  35. package/lib/types/model.js.map +1 -1
  36. package/lib/types/pipeline.d.ts +0 -0
  37. package/lib/types/pipeline.d.ts.map +0 -0
  38. package/lib/types/pipeline.js +0 -0
  39. package/lib/types/pipeline.js.map +0 -0
  40. package/lib/types/pricing.d.ts +0 -0
  41. package/lib/types/pricing.d.ts.map +0 -0
  42. package/lib/types/pricing.js +0 -0
  43. package/lib/types/pricing.js.map +0 -0
  44. package/lib/types/project.d.ts +22 -0
  45. package/lib/types/project.d.ts.map +1 -1
  46. package/lib/types/project.js +57 -0
  47. package/lib/types/project.js.map +1 -1
  48. package/lib/types/remote.d.ts +0 -0
  49. package/lib/types/remote.d.ts.map +0 -0
  50. package/lib/types/remote.js +0 -0
  51. package/lib/types/remote.js.map +0 -0
  52. package/lib/types/sanitize.d.ts +0 -0
  53. package/lib/types/sanitize.d.ts.map +0 -0
  54. package/lib/types/sanitize.js +0 -0
  55. package/lib/types/sanitize.js.map +0 -0
  56. package/lib/types/sinks.d.ts +0 -0
  57. package/lib/types/sinks.d.ts.map +1 -1
  58. package/lib/types/sinks.js +22 -3
  59. package/lib/types/sinks.js.map +1 -1
  60. package/lib/types/spool.d.ts +0 -0
  61. package/lib/types/spool.d.ts.map +0 -0
  62. package/lib/types/spool.js +0 -0
  63. package/lib/types/spool.js.map +0 -0
  64. package/lib/types/typert.host.d.ts +0 -0
  65. package/lib/types/typert.host.d.ts.map +0 -0
  66. package/lib/types/typert.host.js +0 -0
  67. package/lib/types/typert.host.js.map +0 -0
  68. package/lib/types/version.d.ts +1 -1
  69. package/lib/types/version.d.ts.map +0 -0
  70. package/lib/types/version.js +1 -1
  71. package/lib/types/version.js.map +0 -0
  72. package/lib/types/wire.d.ts +0 -0
  73. package/lib/types/wire.d.ts.map +0 -0
  74. package/lib/types/wire.js +0 -0
  75. package/lib/types/wire.js.map +0 -0
  76. package/package.json +33 -14
  77. package/src/backoff.ts +0 -0
  78. package/src/collector.ts +26 -2
  79. package/src/config.ts +12 -1
  80. package/src/ids.ts +0 -0
  81. package/src/index.ts +0 -0
  82. package/src/model.ts +6 -0
  83. package/src/pipeline.ts +0 -0
  84. package/src/pricing.ts +0 -0
  85. package/src/project.ts +58 -0
  86. package/src/remote.ts +0 -0
  87. package/src/sanitize.ts +0 -0
  88. package/src/sinks.ts +22 -3
  89. package/src/spool.ts +0 -0
  90. package/src/typert.host.ts +0 -0
  91. package/src/version.ts +1 -1
  92. package/src/wire.ts +0 -0
  93. package/README-es.md +0 -354
  94. package/README-hi.md +0 -354
  95. package/README-pt.md +0 -354
  96. package/README-zh.md +0 -354
package/README-pt.md DELETED
@@ -1,354 +0,0 @@
1
- <div align="center">
2
-
3
- # 📊 dsh-observe
4
- - **Canal 1024 store**: `npm i -g dsh1024` uma vez, depois `dsh1024 plugin --profile web add dsh-observe` (conta para o ranking de instalações do [deepseek1024.com](https://deepseek1024.com)).
5
-
6
- **Exportador de observabilidade OpenTelemetry e Langfuse para o DeepSeek Harness.**
7
-
8
- *Transforme eventos de sessão em traces OTLP e observações Langfuse — saneados, com buffer e desligados por padrão.*
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-observe)
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-observe.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-observe/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-observe/actions)
17
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
18
- [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
19
- [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
20
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads&lang=pt)](https://dshfind.com/pt/plugins/PerryLink/dsh-observe?ref=badge)
21
-
22
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
23
-
24
- ```sh
25
- dsh plugin --profile <name> add dsh-observe
26
- ```
27
-
28
-
29
- </div>
30
-
31
- ---
32
-
33
-
34
- **📖 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/).
35
-
36
- <!-- star-cta -->
37
- ## Install & uninstall
38
-
39
- - **Canal git** (último `main`): `dsh plugin --profile web add github:PerryLink/dsh-observe` — o script `prepare` compila apenas com dependências de produção.
40
- - **Canal npm** (versões publicadas): `dsh plugin --profile web add dsh-observe`.
41
- - **Canal tarball**: `pnpm pack` neste repositório e então `dsh plugin --profile web add ./dsh-observe-<version>.tgz`.
42
- - **Desinstalar**: `dsh plugin --profile web remove dsh-observe` (ou remova a linha do patch do perfil).
43
-
44
- > Se o pnpm reportar `ERR_PNPM_IGNORED_BUILDS` para este pacote (a validação inofensiva do binário de plataforma do esbuild), adicione `allowBuilds: { esbuild: true }` ao seu `pnpm-workspace.yaml` — o CLI `dsh` imprime o trecho exato.
45
-
46
- ## ⭐ 如果它帮到了你
47
-
48
- 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.
49
-
50
- *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.
51
-
52
- ## What is dsh-observe?
53
-
54
- Exportador de observabilidade OpenTelemetry e Langfuse para o DeepSeek Harness.
55
-
56
- Transforme eventos de sessão em traces OTLP e observações Langfuse — saneados, com buffer e desligados por padrão.
57
-
58
- ![Diagrama de fluxo de dsh-observe: instalar → abrir painel → agir.](docs/assets/dsh-observe-flow.svg)
59
-
60
- *Visão geral do fluxo: instalar → abrir painel → agir. Os exemplos abaixo usam a superfície real de comandos.*
61
-
62
-
63
- *A mesma execução, animada.*
64
-
65
- ## Compatibility
66
-
67
- | Superfície | Status |
68
- |---|---|
69
- | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (adaptado em 2026-10-04): o formato de sessão V4 representa o resultado de uma ferramenta como uma mensagem de primeira classe `role: 'tool'` com `toolCallId` + `content` + `isError` opcional no nível superior — o bloco de conteúdo `tool-result` do V3 saiu do `ContentBlockMap` do host, e este plugin lê apenas a forma V4 (um log V3 anterior à atualização ainda é projetado por um caminho de compatibilidade somente leitura). Os demais traços do formato de sessão V3 permanecem: o fluxo do assistente é embutido em `assistant/message` / `assistant/attempt` e o prompt de sistema é o nó 0 da superfície (`system/message`); o plugin consome apenas o fluxo de eventos ao vivo e nunca lê arquivos de log de sessão. O intervalo de peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` mantém cada linha publicada instalável (cadeia completa de portas local; o workflow compat cobre o smoke de instalação de perfil). |
70
- | Node | `^22.19.0 \|\| >=24.0.0` |
71
- | Backends | OpenTelemetry OTLP/HTTP (traces + metrics, codificação JSON) e Langfuse (observabilidade de LLM) — um ou ambos |
72
- | Modelo | Independente de modelo: exporta o fluxo `session/event`; não faz chamadas a modelos |
73
-
74
- ## What you get
75
-
76
- O `dsh-observe` transforma o fluxo `session/event` do harness em protocolos padrão de observabilidade:
77
-
78
- - **Spans** — spans de turno, passo, chamada de ferramenta (duração, status, derivação de tentativas) e geração de LLM, ligados em traces por turno com ids deterministas.
79
- - **Metrics** — contadores de tokens por provider/modelo, contadores de custo em USD (tabela de preços configurável) e o gauge opcional de pressão de contexto via `ctx.tokenMeter`.
80
- - **Captura saneada** — corpos de prompt e completion são redigidos (nomes de chave estruturais + padrões de segredos embutidos + seus padrões) e truncados antes de qualquer enfileiramento ou envio.
81
- - **Confiabilidade** — lotes assíncronos (por tamanho e por temporizador), um buffer offline durável e limitado (storage-domain) com despejo do mais antigo, e tentativas com backoff exponencial determinista; lotes não entregues sobrevivem a reinícios.
82
- - **Interruptor em tempo de execução** — o Typert remote opcional (`observe/status`, `observe/setEnabled`) permite a uma página de ajustes parar e retomar a exportação sem desmontar.
83
- - **Desligado por padrão** — `enabled: true` mais ao menos um backend é a adesão explícita; caso contrário, nada é capturado ou exportado.
84
-
85
- ```text
86
- fluxo session/event
87
- │ collector (spans de turno/passo/ferramenta/LLM, métricas)
88
- │ sanitize (chaves, segredos, orçamentos)
89
- ├──▶ pipeline "otlp" ── fila ── flush ──▶ OTLP /v1/traces + /v1/metrics
90
- │ └─ tentativa/backoff ─┐
91
- ├──▶ pipeline "langfuse" ── fila ── flush ──▶ ingestão Langfuse
92
- │ └─ tentativa/backoff ─┤
93
- └────────── spool durável (buffer offline, limitado) ◀┘
94
- ```
95
-
96
- ## Quick start
97
-
98
- ```sh
99
- dsh plugin --profile web add github:PerryLink/dsh-observe
100
- ```
101
-
102
- ```sh
103
- # 1. instale o bundle no seu perfil
104
- dsh plugin --profile web add github:PerryLink/dsh-observe
105
-
106
- # ou pelo npm (versões publicadas)
107
- dsh plugin --profile web add dsh-observe
108
-
109
- # 2. configure um backend no patch do seu perfil (cordis.yml) e reinicie
110
- dsh --profile web
111
- ```
112
-
113
- Configuração OTLP mínima (a linha vem comentada em `cordis.patch.yml`):
114
-
115
- ```yaml
116
- - insert:
117
- - id: dsh-observe
118
- name: dsh-observe
119
- config:
120
- enabled: true
121
- otlp:
122
- endpoint: http://localhost:4318
123
- ```
124
-
125
- Depois verifique que a linha monta:
126
-
127
- ```sh
128
- dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
129
- ```
130
-
131
- ### Exemplos
132
-
133
- Este plugin não registra um comando visível; ele roda como exportador em segundo plano, configurado pelas opções.
134
-
135
- ## Configuration
136
-
137
- Todos os ajustes são campos `Config` do Schemastery (alteráveis pelo cordis.yml). Uma sobrescrita direcionada por id substitui a linha inteira — redeclare cada chave que precisar. O `cordis.patch.yml` documenta cada chave em linha.
138
-
139
- | Key | Default | Meaning |
140
- |---|---|---|
141
- | `enabled` | `false` | Interruptor mestre; `true` mais ao menos um backend é a adesão explícita |
142
- | `otlp` | `null` | Configuração do backend OTLP, ou `null` para desativá-lo |
143
- | `otlp.endpoint` | *(obrigatório)* | URL base do OTLP; `/v1/traces` e `/v1/metrics` são acrescentados |
144
- | `otlp.serviceName` | `deepseek-harness` | Atributo de recurso `service.name` |
145
- | `otlp.serviceVersion` | *(nenhum)* | Atributo de recurso `service.version` |
146
- | `otlp.headers` | `{}` | Cabeçalhos extras mesclados em cada requisição de exportação |
147
- | `otlp.timeoutMs` | `10000` | Tempo limite por requisição |
148
- | `langfuse` | `null` | Configuração do backend Langfuse, ou `null` para desativá-lo |
149
- | `langfuse.baseUrl` | `https://cloud.langfuse.com` | URL base do Langfuse |
150
- | `langfuse.publicKey` | *(obrigatório)* | Chave pública do projeto |
151
- | `langfuse.secretKey` | *(obrigatório)* | Chave secreta do projeto |
152
- | `langfuse.release` | *(nenhum)* | Tag de release carimbada nos traces |
153
- | `langfuse.traceName` | `session {session} turn {turn}` | Modelo do nome do trace; `{session}`/`{turn}` interpolam por trace |
154
- | `langfuse.tags` | `[]` | Tags estáticas carimbadas em cada trace |
155
- | `langfuse.timeoutMs` | `10000` | Tempo limite por requisição |
156
- | `capture.turns` | `true` | Spans de ciclo de vida do turno |
157
- | `capture.steps` | `true` | Spans de ciclo de vida do passo |
158
- | `capture.tools` | `true` | Spans de chamada de ferramenta com argumentos/resultados saneados |
159
- | `capture.llm` | `true` | Spans de geração de LLM |
160
- | `llm.prompt` | `true` | Captura o prompt de requisição saneado (`false` = apenas tamanhos) |
161
- | `llm.completion` | `true` | Captura a completion saneada (`false` = apenas tamanhos) |
162
- | `metadata.sessionId` | `true` | Atributo de id de sessão |
163
- | `metadata.cwd` | `false` | Diretório de trabalho da sessão (um caminho local — desligado por padrão) |
164
- | `metadata.agentPreset` | `true` | Atributo de id do agent preset |
165
- | `metadata.model` | `true` | Atributos de provider/modelo |
166
- | `metrics.tokens` | `true` | Contadores de tokens por provider/modelo |
167
- | `metrics.cost` | `true` | Contadores de custo em USD (precisam de regras `pricing` que coincidam) |
168
- | `metrics.contextTokens` | `true` | Gauge de pressão de contexto (precisa de `ctx.tokenMeter`) |
169
- | `pricing` | `[]` | Tabela de preços, primeira coincidência vence: `{ provider?, model, inputPerToken, outputPerToken, cacheReadPerToken?, cacheWritePerToken? }` |
170
- | `sanitize.enabled` | `true` | Interruptor mestre de redação (`false` desativa a redação, nunca o truncamento) |
171
- | `sanitize.redactKeys` | `[]` | Substrings de nome de chave extras (key/token/secret/password/authorization/credential/apiKey sempre incluídas) |
172
- | `sanitize.redactPatterns` | `[]` | Expressões regulares de segredos extras |
173
- | `sanitize.truncatePromptChars` | `4000` | Orçamento de caracteres do prompt |
174
- | `sanitize.truncateCompletionChars` | `4000` | Orçamento de caracteres da completion |
175
- | `sanitize.truncateToolInputChars` | `2000` | Orçamento de caracteres dos argumentos de ferramenta |
176
- | `sanitize.truncateToolOutputChars` | `2000` | Orçamento de caracteres do resultado de ferramenta |
177
- | `sanitize.truncateAttributeChars` | `512` | Orçamento de strings de atributos de span |
178
- | `batch.maxRecords` | `256` | Flush quando a fila atinge este número de registros |
179
- | `batch.flushIntervalMs` | `5000` | Intervalo de flush por temporizador |
180
- | `batch.maxQueueRecords` | `2000` | Limite da fila em memória; o excesso derrama para o buffer |
181
- | `batch.maxBufferRecords` | `10000` | Limite do buffer offline durável; os registros mais antigos caem primeiro |
182
- | `batch.bufferRetryIntervalMs` | `30000` | Intervalo de tentativa do buffer offline |
183
- | `retry.maxAttempts` | `5` | Tentativas por lote, incluindo a primeira |
184
- | `retry.baseDelayMs` | `1000` | Primeiro atraso de backoff |
185
- | `retry.factor` | `2` | Multiplicador de backoff por falha consecutiva |
186
- | `retry.maxDelayMs` | `60000` | Teto do backoff |
187
- | `remote.enabled` | `false` | Monta o Typert remote `observe` (interruptor) |
188
-
189
- ## Tools & surfaces
190
-
191
- Este plugin **não registra ferramentas de modelo** — é um exportador em segundo plano. Suas superfícies:
192
-
193
- - **Consome** `session/event` (coleta de spans/métricas), `session/flush` (impulso de exportação best-effort — o checkpoint de durabilidade nunca espera um backend remoto) e `session/disposed`.
194
- - **Serviço remote opcional** `observe` — `observe/status` devolve o estado do interruptor, os backends configurados, a profundidade da fila e a ocupação do buffer; `observe/setEnabled` para e retoma a exportação em tempo de execução.
195
-
196
- ## Permissions & data
197
-
198
- - **Permissões**: `network:outbound` para os endpoints que você configurar, `session:read` para o fluxo de eventos, `storage:write` para o buffer offline; sem código nativo, sem acesso ao sistema de arquivos.
199
- - **Dados**: tudo o que é enviado deriva do registro de sessão e é saneado (redação + truncamento) antes de enfileirar, armazenar ou transmitir. O buffer offline guarda apenas registros saneados, re-validados ao serem lidos.
200
- - **Credenciais**: as chaves pública/secreta do Langfuse viajam apenas para o endpoint Langfuse configurado; os cabeçalhos OTLP apenas para o endpoint OTLP configurado. O plugin não armazena credenciais — guarde-as em referências de credenciais ou valores injetados pelo ambiente.
201
-
202
- ## Security boundaries
203
-
204
- - **Desligado por padrão** — nada é capturado ou exportado sem adesão explícita.
205
- - **Sanear antes de enviar** — redação estrutural de chaves, padrões de segredos embutidos (chaves de API, tokens do GitHub, chaves da AWS, credenciais bearer, chaves privadas), seus padrões e orçamentos de caracteres aplicam-se antes de qualquer registro sair da memória.
206
- - **Re-validação no limite durável** — registros lidos do armazenamento são checados novamente antes que um sink possa vê-los.
207
- - **Falha ruidosa, falha contida** — falhas de exportação avisam, contam, tentam de novo e por fim vão para o spool; um manipulador de sessão que falha é capturado e registrado, de modo que a observabilidade nunca pode quebrar o caminho quente do harness.
208
- - **Model-visible ⟺ logged** — as exportações de prompt/completion projetam apenas a superfície da sessão (cujo nó 0 é o prompt de sistema) e o cabeçalho registrado (configuração da chamada e ferramentas); o exportador não inventa conteúdo.
209
-
210
- ## Known limitations
211
-
212
- - **npm 0.1.7-rc.2** — o plugin é desenvolvido e testado contra `@deepseek-ai/dsh@0.1.7-rc.2` (devDeps e a régua primária do CI); o intervalo de peers `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` mantém cada linha publicada instalável, e a segunda régua (`typecheck:ci`) mais o workflow compat cobrem os baselines antigos.
213
- - **Eventos de auditoria não são persistidos** — os registros `observe/*` do próprio exportador são apenas de auditoria: na linha de host atual o portão de append da sessão admite eventos de superfície, então nenhum evento `observe/*` é gravado no log da sessão, e o plugin não o falsifica com um append sem marcação (isso tornaria as sessões ilegíveis). Use a saída de status do `/observe` e os backends OTLP/Langfuse como superfície de auditoria.
214
- - **Métricas evitam o caminho de tentativa/spool** — as métricas OTLP são agregadas cumulativamente, então um flush perdido se autocura no seguinte (por design, não é um bug).
215
- - **Sem amostragem** — toda família de spans habilitada é exportada; ajuste os interruptores `capture.*` e `batch.maxBufferRecords` para sessões de alto volume.
216
-
217
- ## Development
218
-
219
- ```sh
220
- pnpm install # node ^22.19 || >=24
221
- pnpm run typecheck # tsc: src + tests contra os devDeps 0.1.7-rc.2 (sem tsconfig paths)
222
- pnpm run typecheck:ci # tsc contra a linha publicada (sem paths)
223
- pnpm run check:ruler-live # canário: deve falhar ao compilar, provando que a régua segue viva
224
- pnpm test # vitest: 126 testes, 18 suítes (Context/Session/storage seam reais)
225
- pnpm run test:coverage # porta de cobertura (90/80/90/90)
226
- pnpm run build # bundle tsdown + declarações tsc (lib/)
227
- pnpm run verify:self-contained # as especificações de dependências resolvem pelo registry
228
- pnpm run verify:artifacts # face ESM construída + bundle patch presentes
229
- node scripts/check-readme-sync.mjs # porta de sincronia dos cinco READMEs
230
- pnpm pack # o tarball publicado
231
- ```
232
-
233
- ## Topics
234
-
235
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `observability`, `opentelemetry`, `otlp`, `langfuse`, `tracing`
236
-
237
- ## Contributors
238
-
239
- - [@PerryLink](https://github.com/PerryLink) — criador e mantenedor: collector, pipelines, spool, sinks OTLP/Langfuse, saneamento e a documentação em cinco idiomas.
240
-
241
- ## PerryLink DSH Plugin Family
242
-
243
- 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.
244
-
245
- <details>
246
- <summary>Expandir todos os plugins</summary>
247
-
248
- | Plugin | Status |
249
- |---|---|
250
- | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
251
- | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
252
- | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
253
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | |
254
- | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
255
- | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
256
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | |
257
- | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
258
- | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
259
- | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
260
- | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
261
- | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
262
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
263
- | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
264
- | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
265
- | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
266
- | **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
267
- | **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
268
- | **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
269
- | **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
270
- | **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
271
- | **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
272
- | **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
273
- | **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
274
- | **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
275
- | **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
276
- | **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
277
- | **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
278
- | **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
279
- | **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
280
- | **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
281
- | **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
282
- | **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
283
- | **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
284
- | **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
285
- | **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
286
- | **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
287
- | **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
288
- | **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
289
- | **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
290
- | **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
291
- | **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
292
- | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
293
- | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
294
- | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
295
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
296
- | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
297
- | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
298
- | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
299
- | **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
300
- | **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
301
- | **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
302
- | **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
303
- | **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
304
- | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
305
- | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
306
- | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
307
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
308
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
309
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
310
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
311
- | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
312
- | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
313
- | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
314
- | **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
315
- | **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
316
- | **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
317
- | **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
318
- | **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
319
- | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
320
- | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
321
- | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
322
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
323
- | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
324
- | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
325
- | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
326
- | **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
327
- | **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
328
- | **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
329
- | **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
330
- | **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
331
- | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
332
- | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
333
- | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
334
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
335
- | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
336
- | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
337
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver o README do repositório |
338
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver o README do repositório |
339
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver o README do repositório |
340
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver o README do repositório |
341
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver o README do repositório |
342
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRADO — ver o README do repositório |
343
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO — ver o README do repositório |
344
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO — ver o README do repositório |
345
-
346
- </details>
347
-
348
- ## License
349
-
350
- [Apache License 2.0](LICENSE) © 2026 dsh-observe contributors
351
-
352
- ### Instalar a partir do mercado do DSH Desktop
353
-
354
- 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.