dsh-observe 0.2.26 → 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.
- package/CHANGELOG.md +10 -0
- package/LICENSE +0 -0
- package/README.en.md +446 -0
- package/README.es.md +446 -0
- package/README.hi.md +446 -0
- package/README.md +292 -196
- package/README.pt.md +446 -0
- package/THIRD_PARTY_NOTICES.md +0 -0
- package/cordis.patch.yml +6 -1
- package/lib/index.js +86 -38
- package/lib/typert.host.js +2 -4
- package/lib/types/backoff.d.ts +0 -0
- package/lib/types/backoff.d.ts.map +0 -0
- package/lib/types/backoff.js +0 -0
- package/lib/types/backoff.js.map +0 -0
- package/lib/types/collector.d.ts +0 -0
- package/lib/types/collector.d.ts.map +1 -1
- package/lib/types/collector.js +22 -2
- package/lib/types/collector.js.map +1 -1
- package/lib/types/config.d.ts +9 -0
- package/lib/types/config.d.ts.map +1 -1
- package/lib/types/config.js +3 -1
- package/lib/types/config.js.map +1 -1
- package/lib/types/ids.d.ts +0 -0
- package/lib/types/ids.d.ts.map +0 -0
- package/lib/types/ids.js +0 -0
- package/lib/types/ids.js.map +0 -0
- package/lib/types/index.d.ts +0 -0
- package/lib/types/index.d.ts.map +0 -0
- package/lib/types/index.js +0 -0
- package/lib/types/index.js.map +0 -0
- package/lib/types/model.d.ts +6 -0
- package/lib/types/model.d.ts.map +1 -1
- package/lib/types/model.js +0 -0
- package/lib/types/model.js.map +1 -1
- package/lib/types/pipeline.d.ts +0 -0
- package/lib/types/pipeline.d.ts.map +0 -0
- package/lib/types/pipeline.js +0 -0
- package/lib/types/pipeline.js.map +0 -0
- package/lib/types/pricing.d.ts +0 -0
- package/lib/types/pricing.d.ts.map +0 -0
- package/lib/types/pricing.js +0 -0
- package/lib/types/pricing.js.map +0 -0
- package/lib/types/project.d.ts +22 -0
- package/lib/types/project.d.ts.map +1 -1
- package/lib/types/project.js +57 -0
- package/lib/types/project.js.map +1 -1
- package/lib/types/remote.d.ts +0 -0
- package/lib/types/remote.d.ts.map +0 -0
- package/lib/types/remote.js +0 -0
- package/lib/types/remote.js.map +0 -0
- package/lib/types/sanitize.d.ts +0 -0
- package/lib/types/sanitize.d.ts.map +0 -0
- package/lib/types/sanitize.js +0 -0
- package/lib/types/sanitize.js.map +0 -0
- package/lib/types/sinks.d.ts +0 -0
- package/lib/types/sinks.d.ts.map +1 -1
- package/lib/types/sinks.js +22 -3
- package/lib/types/sinks.js.map +1 -1
- package/lib/types/spool.d.ts +0 -0
- package/lib/types/spool.d.ts.map +0 -0
- package/lib/types/spool.js +0 -0
- package/lib/types/spool.js.map +0 -0
- package/lib/types/typert.host.d.ts +0 -0
- package/lib/types/typert.host.d.ts.map +0 -0
- package/lib/types/typert.host.js +0 -0
- package/lib/types/typert.host.js.map +0 -0
- package/lib/types/version.d.ts +1 -1
- package/lib/types/version.d.ts.map +0 -0
- package/lib/types/version.js +1 -1
- package/lib/types/version.js.map +0 -0
- package/lib/types/wire.d.ts +0 -0
- package/lib/types/wire.d.ts.map +0 -0
- package/lib/types/wire.js +0 -0
- package/lib/types/wire.js.map +0 -0
- package/package.json +49 -29
- package/src/backoff.ts +0 -0
- package/src/collector.ts +26 -2
- package/src/config.ts +12 -1
- package/src/ids.ts +0 -0
- package/src/index.ts +0 -0
- package/src/model.ts +6 -0
- package/src/pipeline.ts +0 -0
- package/src/pricing.ts +0 -0
- package/src/project.ts +58 -0
- package/src/remote.ts +0 -0
- package/src/sanitize.ts +0 -0
- package/src/sinks.ts +22 -3
- package/src/spool.ts +0 -0
- package/src/typert.host.ts +0 -0
- package/src/version.ts +1 -1
- package/src/wire.ts +0 -0
- package/README-es.md +0 -354
- package/README-hi.md +0 -354
- package/README-pt.md +0 -354
- 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)
|
|
11
|
-
[](https://gitee.com/perrylink/dsh-observe)
|
|
12
|
-
[](https://github.com/topics/dsh-plugin)
|
|
13
|
-
[](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
|
|
14
|
-
[](https://dsh.market/)
|
|
15
|
-
[](#)
|
|
16
|
-
[](https://github.com/PerryLink/dsh-observe/actions)
|
|
17
|
-
[](https://github.com/PerryLink/dsh-observe/releases)
|
|
18
|
-
[](https://www.npmjs.com/package/dsh-observe)
|
|
19
|
-
[](https://www.npmjs.com/package/dsh-observe)
|
|
20
|
-
[](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
|
-

|
|
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.
|