dsh-observe 0.2.27 → 0.2.29
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 +2 -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/cordis.patch.yml +6 -1
- package/lib/index.js +72 -10
- 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/model.d.ts +6 -0
- package/lib/types/model.d.ts.map +1 -1
- package/lib/types/model.js.map +1 -1
- 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/sinks.d.ts.map +1 -1
- package/lib/types/sinks.js +22 -3
- package/lib/types/sinks.js.map +1 -1
- package/lib/types/version.d.ts +1 -1
- package/lib/types/version.js +1 -1
- package/package.json +14 -14
- package/src/collector.ts +26 -2
- package/src/config.ts +12 -1
- package/src/model.ts +6 -0
- package/src/project.ts +58 -0
- package/src/sinks.ts +22 -3
- package/src/version.ts +1 -1
- 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.es.md
ADDED
|
@@ -0,0 +1,446 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-observe-hero-en-dark.webp">
|
|
5
|
+
<img src="docs/assets/dsh-observe-hero-en-light.webp" width="100%" alt="dsh-observe: a la izquierda el nombre, las frases de valor y el comando de instalación; a la derecha la cascada de una traza de un turn — spans de turn, step, herramienta y LLM sobre un eje temporal, recuentos de tokens en las barras LLM y una franja de métricas de spans, tokens, coste en USD y presión de contexto; la tarjeta indica que el saneado va antes de la cola y nombra OTLP y Langfuse como destinos">
|
|
6
|
+
</picture>
|
|
7
|
+
|
|
8
|
+
# dsh-observe
|
|
9
|
+
|
|
10
|
+
**Convierte cada sesión en trazas OTLP estándar y observaciones de Langfuse—saneado antes de salir, sin exportar nada por defecto.**
|
|
11
|
+
|
|
12
|
+
Exportador de observabilidad para DeepSeek Harness: spans de turn/step/llamada de herramienta/generación LLM, métricas de tokens y coste en USD, lotes asíncronos, búfer offline acotado y reintentos con backoff exponencial; usa OTLP, Langfuse o ambos.
|
|
13
|
+
|
|
14
|
+
[Instalar](#instalación-en-tres-pasos) · [Configuración](#configuración) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
15
|
+
|
|
16
|
+
[](LICENSE)
|
|
17
|
+
[](#compatibilidad)
|
|
18
|
+
[](https://www.npmjs.com/package/dsh-observe)
|
|
19
|
+
[](https://github.com/PerryLink/dsh-observe/actions/workflows/ci.yml)
|
|
20
|
+
[](#compatibilidad)
|
|
21
|
+
|
|
22
|
+
[](https://github.com/PerryLink/dsh-observe/stargazers)
|
|
23
|
+
[](https://www.npmjs.com/package/dsh-observe)
|
|
24
|
+
[](https://dshfind.com/plugins/PerryLink/dsh-observe?ref=badge)
|
|
25
|
+
[](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-observe)
|
|
26
|
+
[](https://dsh.market/)
|
|
27
|
+
[](https://gitee.com/perrylink/dsh-observe)
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
dsh plugin --profile <name> add dsh-observe
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
</div>
|
|
34
|
+
|
|
35
|
+
<sub>Plugin comunitario, no afiliado a DeepSeek. Repositorio único: <https://github.com/PerryLink/dsh-observe> (Gitee es un espejo).</sub>
|
|
36
|
+
|
|
37
|
+
## Qué es
|
|
38
|
+
|
|
39
|
+
`dsh-observe` traduce el flujo `session/event` del harness a protocolos de observabilidad estándar: una traza por turn, un span por step, por llamada de herramienta y por generación LLM, métricas acumuladas de tokens y coste, y cuerpos de prompt/completion que se sanean y truncan antes de entrar en la cola. Solo exporta: no registra herramientas de modelo ni comandos visibles para el usuario, y todo su comportamiento se gobierna por configuración. Configura OTLP o Langfuse, reinicia y los datos fluyen solos; sin configuración no se captura absolutamente nada.
|
|
40
|
+
|
|
41
|
+
<picture>
|
|
42
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-observe-flow-v5-dark.svg">
|
|
43
|
+
<img src="docs/assets/dsh-observe-flow-v5-light.svg" width="100%" alt="Estructura de dsh-observe (una bifurcación en dos canalizaciones alrededor de un búfer acotado): session/event alimenta el collector (spans turn/step/tool/llm y métricas observe.tokens, observe.cost y observe.context_tokens, ids sha256 deterministas), luego sanitize (redacción por nombre de clave, patrones de secretos integrados y presupuestos de prompt/completion 4000 y herramienta 2000/2000) sanea cada registro antes de cualquier cola; el registro se bifurca en dos canalizaciones independientes, otlp y langfuse, cada una con cola (256 registros o 5000ms, maxQueueRecords 2000) → flush/retry (5 intentos, 1000ms × 2 con tope de 60000ms) → su endpoint; el agotamiento de reintentos y el desbordamiento de cola caen en el búfer durable y acotado entre las pistas (10000 registros, expulsión del más antiguo, revalidación zod al leer, sobrevive al reinicio), vaciado de vuelta a ambos endpoints cada 30000ms por el riel discontinuo de la derecha; abajo a la izquierda está la superficie remota opcional observe/status y observe/setEnabled, y la banda inferior fija el contrato de apagado por defecto y los tres eventos escuchados">
|
|
44
|
+
</picture>
|
|
45
|
+
|
|
46
|
+
## Instalación en tres pasos
|
|
47
|
+
|
|
48
|
+
1. **Instalar** (elige una):
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
# canal git (main más reciente; el script prepare compila solo con dependencias de producción)
|
|
52
|
+
dsh plugin --profile web add github:PerryLink/dsh-observe
|
|
53
|
+
# canal npm (versión publicada)
|
|
54
|
+
dsh plugin --profile web add dsh-observe
|
|
55
|
+
# canal tarball: tras pnpm pack en este repositorio
|
|
56
|
+
dsh plugin --profile web add ./dsh-observe-<version>.tgz
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
> Si pnpm informa `ERR_PNPM_IGNORED_BUILDS` para este paquete (validación inofensiva del binario de plataforma de esbuild), añade `allowBuilds: { esbuild: true }` a tu `pnpm-workspace.yaml`; la CLI `dsh` imprime el fragmento exacto.
|
|
60
|
+
|
|
61
|
+
2. **Configuración mínima** (activa `enabled` en el patch del perfil y configura al menos un backend; la fila viene desactivada en `cordis.patch.yml`):
|
|
62
|
+
|
|
63
|
+
```yaml
|
|
64
|
+
- insert:
|
|
65
|
+
- id: dsh-observe
|
|
66
|
+
name: dsh-observe
|
|
67
|
+
config:
|
|
68
|
+
enabled: true
|
|
69
|
+
otlp:
|
|
70
|
+
endpoint: http://localhost:4318
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Langfuse funciona igual: `langfuse.baseUrl` + `langfuse.publicKey` + `langfuse.secretKey`. Los dos backends pueden estar activos a la vez.
|
|
74
|
+
|
|
75
|
+
3. **Verificar que está activo**:
|
|
76
|
+
|
|
77
|
+
```sh
|
|
78
|
+
dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
No se registra ningún comando visible para el usuario, así que no hay disparador manual del tipo `/observe`. Con `remote.enabled: true`, una página de ajustes puede leer los backends configurados, la profundidad de las colas y la ocupación del búfer mediante `observe/status`.
|
|
82
|
+
|
|
83
|
+
**Desinstalar**: `dsh plugin --profile web remove dsh-observe` (o borra la fila del patch del perfil).
|
|
84
|
+
|
|
85
|
+
<details>
|
|
86
|
+
<summary>Instalar desde el mercado de DSH Desktop</summary>
|
|
87
|
+
|
|
88
|
+
Todos los plugins de PerryLink se pueden explorar en el mercado integrado de DSH Desktop: **Mercado → Fuentes → añadir fuente → pegar** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ seleccionar**. La instalación sigue pasando por la verificación de identidad npm del mercado y tu confirmación.
|
|
89
|
+
|
|
90
|
+
</details>
|
|
91
|
+
|
|
92
|
+
## Capacidades clave
|
|
93
|
+
|
|
94
|
+
`dsh-observe` convierte el flujo de eventos de sesión en protocolos de observabilidad estándar:
|
|
95
|
+
|
|
96
|
+
- **Spans** — turn, step, llamada de herramienta (duración, estado, derivación de reintentos) y generación LLM, enlazados en trazas por turn con ids deterministas.
|
|
97
|
+
- **Métricas** — contadores de tokens por provider/model, contadores de coste en USD (tabla de precios configurable) y el gauge opcional de presión de contexto de `ctx.tokenMeter`.
|
|
98
|
+
- **Captura saneada** — los cuerpos de prompt y completion pasan por redacción estructural de nombres de clave, patrones de secreto integrados, tus patrones y presupuestos de caracteres antes de entrar en la cola o enviarse.
|
|
99
|
+
- **Fiabilidad** — lotes asíncronos (por tamaño y por temporizador), búfer offline durable acotado (storage-domain, expulsión del más antiguo primero) y reintentos deterministas con backoff exponencial; los lotes no entregados sobreviven al reinicio.
|
|
100
|
+
- **Interruptor en caliente** — el remote Typert opcional (`observe/status`, `observe/setEnabled`) permite a una página de ajustes detener y reanudar la exportación sin desmontar el plugin.
|
|
101
|
+
- **Desactivado por defecto** — `enabled: true` más al menos un backend es la activación explícita; sin eso no se captura ni se exporta nada.
|
|
102
|
+
|
|
103
|
+
```text
|
|
104
|
+
flujo session/event
|
|
105
|
+
│ collector (spans turn/step/tool/llm, métricas)
|
|
106
|
+
│ sanitize (claves, secretos, presupuestos)
|
|
107
|
+
├──▶ pipeline "otlp" ── cola ── flush ──▶ OTLP /v1/traces + /v1/metrics
|
|
108
|
+
│ └─ reintento/backoff ─┐
|
|
109
|
+
├──▶ pipeline "langfuse" ── cola ── flush ──▶ ingesta de Langfuse
|
|
110
|
+
│ └─ reintento/backoff ─┤
|
|
111
|
+
└────────── spool durable (búfer offline, acotado) ◀┘
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### Superficies
|
|
115
|
+
|
|
116
|
+
Este plugin **no registra herramientas de modelo** ni comandos visibles para el usuario: es un exportador en segundo plano. Toda su superficie son tres cosas:
|
|
117
|
+
|
|
118
|
+
- **Consume** `session/event` (recogida de spans y métricas), `session/flush` (un empujón de exportación de mejor esfuerzo — el punto de durabilidad nunca espera a un backend remoto) y `session/disposed`.
|
|
119
|
+
- **Servicio remoto opcional** `observe` (`remote.enabled`, desactivado por defecto) — `observe/status` devuelve el estado del interruptor, los backends configurados, la profundidad de las colas y la ocupación del búfer; `observe/setEnabled` detiene y reanuda la exportación en caliente.
|
|
120
|
+
- **La única clave de servicio inyectada** `storageDomain`, usada para la tabla durable del búfer offline.
|
|
121
|
+
|
|
122
|
+
### Ejemplos
|
|
123
|
+
|
|
124
|
+
No hay disparador manual: tras instalar, activa `enabled` con la configuración mínima de arriba y reinicia; las trazas y métricas aparecen en el backend OTLP y las observaciones en Langfuse. Para confirmar que está recogiendo, mira la primera traza que recibe el backend; para confirmar que está enviando, observa cómo la profundidad de cola de `observe/status` baja a medida que avanza la sesión.
|
|
125
|
+
|
|
126
|
+
## Configuración
|
|
127
|
+
|
|
128
|
+
Todas las opciones son campos `Config` de Schemastery (modificables desde cordis.yml o el patch del perfil). Una sobrescritura por id reemplaza la fila entera: vuelve a declarar todas las claves que necesites. [`cordis.patch.yml`](cordis.patch.yml) documenta cada clave en línea.
|
|
129
|
+
|
|
130
|
+
Claves más usadas:
|
|
131
|
+
|
|
132
|
+
| Clave | Por defecto | Significado |
|
|
133
|
+
|---|---|---|
|
|
134
|
+
| `enabled` | `false` | Interruptor maestro; `true` más al menos un backend es la activación explícita |
|
|
135
|
+
| `otlp.endpoint` | *(obligatorio)* | URL base OTLP; el plugin añade `/v1/traces` y `/v1/metrics` |
|
|
136
|
+
| `otlp.serviceName` | `deepseek-harness` | Atributo de recurso `service.name` |
|
|
137
|
+
| `langfuse.baseUrl` | `https://cloud.langfuse.com` | URL base de Langfuse |
|
|
138
|
+
| `langfuse.traceName` | `session {session} turn {turn}` | Plantilla del nombre de traza; `{session}`/`{turn}` se interpolan por traza |
|
|
139
|
+
| `capture.llm` | `true` | Spans de generación LLM |
|
|
140
|
+
| `llm.prompt` | `true` | Captura el prompt de petición saneado (`false` = solo tamaños) |
|
|
141
|
+
| `llm.reasoning` | `true` | Captura el razonamiento por separado como `gen_ai.completion.reasoning` (`false` = solo la respuesta) |
|
|
142
|
+
| `batch.maxBufferRecords` | `10000` | Límite del búfer offline durable; los registros más antiguos caen primero |
|
|
143
|
+
| `remote.enabled` | `false` | Monta el remote Typert `observe` (interruptor en caliente) |
|
|
144
|
+
|
|
145
|
+
<details>
|
|
146
|
+
<summary>Tabla de configuración completa (48 claves)</summary>
|
|
147
|
+
|
|
148
|
+
| Clave | Por defecto | Significado |
|
|
149
|
+
|---|---|---|
|
|
150
|
+
| `enabled` | `false` | Interruptor maestro; `true` más al menos un backend es la activación explícita |
|
|
151
|
+
| `otlp` | `null` | Configuración del backend OTLP; `null` lo desactiva |
|
|
152
|
+
| `otlp.endpoint` | *(obligatorio)* | URL base OTLP; el plugin añade `/v1/traces` y `/v1/metrics` |
|
|
153
|
+
| `otlp.serviceName` | `deepseek-harness` | Atributo de recurso `service.name` |
|
|
154
|
+
| `otlp.serviceVersion` | *(ninguno)* | Atributo de recurso `service.version` |
|
|
155
|
+
| `otlp.headers` | `{}` | Cabeceras extra que se fusionan en cada petición de exportación |
|
|
156
|
+
| `otlp.timeoutMs` | `10000` | Tiempo de espera por petición |
|
|
157
|
+
| `langfuse` | `null` | Configuración del backend Langfuse; `null` lo desactiva |
|
|
158
|
+
| `langfuse.baseUrl` | `https://cloud.langfuse.com` | URL base de Langfuse |
|
|
159
|
+
| `langfuse.publicKey` | *(obligatorio)* | Clave pública del proyecto |
|
|
160
|
+
| `langfuse.secretKey` | *(obligatorio)* | Clave secreta del proyecto |
|
|
161
|
+
| `langfuse.release` | *(ninguno)* | Etiqueta de release estampada en las trazas |
|
|
162
|
+
| `langfuse.traceName` | `session {session} turn {turn}` | Plantilla del nombre de traza; `{session}`/`{turn}` se interpolan por traza |
|
|
163
|
+
| `langfuse.tags` | `[]` | Etiquetas estáticas estampadas en cada traza |
|
|
164
|
+
| `langfuse.timeoutMs` | `10000` | Tiempo de espera por petición |
|
|
165
|
+
| `capture.turns` | `true` | Spans de ciclo de vida del turn |
|
|
166
|
+
| `capture.steps` | `true` | Spans de ciclo de vida del step |
|
|
167
|
+
| `capture.tools` | `true` | Spans de llamada de herramienta con argumentos/resultados saneados |
|
|
168
|
+
| `capture.llm` | `true` | Spans de generación LLM |
|
|
169
|
+
| `llm.prompt` | `true` | Captura el prompt de petición saneado (`false` = solo tamaños) |
|
|
170
|
+
| `llm.completion` | `true` | Captura la completion saneada (`false` = solo tamaños) |
|
|
171
|
+
| `llm.reasoning` | `true` | Captura el razonamiento por separado como `gen_ai.completion.reasoning` (`false` = solo la respuesta) |
|
|
172
|
+
| `metadata.sessionId` | `true` | Atributo del id de sesión |
|
|
173
|
+
| `metadata.cwd` | `false` | Directorio de trabajo de la sesión (una ruta local; desactivado por defecto) |
|
|
174
|
+
| `metadata.agentPreset` | `true` | Atributo del id de preset de agente |
|
|
175
|
+
| `metadata.model` | `true` | Atributos de provider/model |
|
|
176
|
+
| `metrics.tokens` | `true` | Contadores de tokens por provider/model |
|
|
177
|
+
| `metrics.cost` | `true` | Contadores de coste en USD (requieren reglas `pricing` que coincidan) |
|
|
178
|
+
| `metrics.contextTokens` | `true` | Gauge de presión de contexto (requiere `ctx.tokenMeter`) |
|
|
179
|
+
| `pricing` | `[]` | Tabla de precios, gana la primera coincidencia: `{ provider?, model, inputPerToken, outputPerToken, cacheReadPerToken?, cacheWritePerToken? }` |
|
|
180
|
+
| `sanitize.enabled` | `true` | Interruptor maestro de redacción (`false` desactiva la redacción, nunca el truncado) |
|
|
181
|
+
| `sanitize.redactKeys` | `[]` | Subcadenas extra de nombres de clave (key/token/secret/password/authorization/credential/apiKey siempre están incluidos) |
|
|
182
|
+
| `sanitize.redactPatterns` | `[]` | Expresiones regulares extra para secretos |
|
|
183
|
+
| `sanitize.truncatePromptChars` | `4000` | Presupuesto de caracteres del prompt |
|
|
184
|
+
| `sanitize.truncateCompletionChars` | `4000` | Presupuesto de caracteres de la completion |
|
|
185
|
+
| `sanitize.truncateToolInputChars` | `2000` | Presupuesto de caracteres de los argumentos de herramienta |
|
|
186
|
+
| `sanitize.truncateToolOutputChars` | `2000` | Presupuesto de caracteres del resultado de herramienta |
|
|
187
|
+
| `sanitize.truncateAttributeChars` | `512` | Presupuesto de la cadena de atributo de span |
|
|
188
|
+
| `batch.maxRecords` | `256` | Vacía la cola cuando contiene este número de registros |
|
|
189
|
+
| `batch.flushIntervalMs` | `5000` | Intervalo del temporizador de vaciado |
|
|
190
|
+
| `batch.maxQueueRecords` | `2000` | Límite de la cola en memoria; el exceso pasa al búfer |
|
|
191
|
+
| `batch.maxBufferRecords` | `10000` | Límite del búfer offline durable; los registros más antiguos caen primero |
|
|
192
|
+
| `batch.bufferRetryIntervalMs` | `30000` | Intervalo de reintento del búfer offline |
|
|
193
|
+
| `retry.maxAttempts` | `5` | Intentos por lote, incluido el primero |
|
|
194
|
+
| `retry.baseDelayMs` | `1000` | Primer retardo de backoff |
|
|
195
|
+
| `retry.factor` | `2` | Multiplicador de backoff por fallo consecutivo |
|
|
196
|
+
| `retry.maxDelayMs` | `60000` | Techo del backoff |
|
|
197
|
+
| `remote.enabled` | `false` | Monta el remote Typert `observe` (interruptor en caliente) |
|
|
198
|
+
|
|
199
|
+
</details>
|
|
200
|
+
|
|
201
|
+
> ⚠️ **Aviso de cumplimiento sobre el razonamiento** — `llm.reasoning` está activado por defecto y el razonamiento se exporta por separado como `gen_ai.completion.reasoning` (nunca dentro de `gen_ai.completion`; en Langfuse viaja en los metadatos de la generation). La cadena de pensamiento puede contener la entrada original del usuario o contexto que el modelo cita literalmente, así que **evalúa el impacto de cumplimiento antes de exportarla**. Pon `llm.reasoning: false` para omitirla; `llm.completion: false` descarta tanto la respuesta como el razonamiento.
|
|
202
|
+
|
|
203
|
+
Ejemplo de sobrescritura por id (reemplaza la fila entera, así que vuelve a declarar las claves necesarias):
|
|
204
|
+
|
|
205
|
+
```yaml
|
|
206
|
+
- insert:
|
|
207
|
+
- id: dsh-observe
|
|
208
|
+
name: dsh-observe
|
|
209
|
+
config:
|
|
210
|
+
enabled: true
|
|
211
|
+
otlp:
|
|
212
|
+
endpoint: http://localhost:4318
|
|
213
|
+
capture:
|
|
214
|
+
tools: false
|
|
215
|
+
sanitize:
|
|
216
|
+
truncatePromptChars: 2000
|
|
217
|
+
batch:
|
|
218
|
+
maxBufferRecords: 20000
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
## FAQ
|
|
222
|
+
|
|
223
|
+
<details>
|
|
224
|
+
<summary>¿El prompt o los argumentos de herramienta en crudo llegan al backend?</summary>
|
|
225
|
+
|
|
226
|
+
No en crudo. Cada registro se sanea antes de entrar en la cola, en tres capas: nombres de clave estructurales (key/token/secret/password/authorization/credential/apiKey siempre están en la lista y `sanitize.redactKeys` añade subcadenas), patrones de secreto integrados (claves de API, tokens de GitHub, claves de AWS, credenciales bearer, claves privadas) más tus expresiones `sanitize.redactPatterns`, y truncado por presupuesto de caracteres (prompt/completion 4000 cada uno, argumentos y resultados de herramienta 2000 cada uno, atributos de span 512). Si solo quieres tamaños sin cuerpos, pon `llm.prompt` y `llm.completion` en `false` y los registros llevarán solo tamaños y recuentos.
|
|
227
|
+
|
|
228
|
+
</details>
|
|
229
|
+
|
|
230
|
+
<details>
|
|
231
|
+
<summary>¿Se pierden datos si el backend se cae o se corta la red?</summary>
|
|
232
|
+
|
|
233
|
+
Los spans y las métricas siguen la cadena reintento → derrame: un lote fallido se reintenta con backoff exponencial determinista (`retry.maxAttempts` 5 por defecto, `retry.baseDelayMs × retry.factor`), y cuando se agotan los reintentos o la cola en memoria supera `batch.maxQueueRecords` se derrama al spool durable acotado (`batch.maxBufferRecords` 10000 por defecto, primero los más antiguos), con drenaje periódico según `batch.bufferRetryIntervalMs`, de modo que los lotes no entregados sobreviven a un reinicio. Las métricas OTLP son la excepción: se agregan de forma acumulativa y un vaciado perdido se recupera en el siguiente.
|
|
234
|
+
|
|
235
|
+
</details>
|
|
236
|
+
|
|
237
|
+
<details>
|
|
238
|
+
<summary>¿Qué guarda el plugin y dónde viven las credenciales?</summary>
|
|
239
|
+
|
|
240
|
+
El búfer offline solo contiene registros saneados, y lo que se lee de vuelta del almacenamiento se valida otra vez antes de que lo vea un sink. El plugin no guarda credenciales: las claves pública/secreta de Langfuse solo aparecen en peticiones al endpoint de Langfuse que configures, y las cabeceras OTLP solo van a tu endpoint OTLP; mantenlas en referencias de credenciales o en valores inyectados por entorno, nunca en un patch de perfil versionado. Solo lee el flujo de eventos en vivo y jamás lee ni reescribe los ficheros de log de sesión.
|
|
241
|
+
|
|
242
|
+
</details>
|
|
243
|
+
|
|
244
|
+
<details>
|
|
245
|
+
<summary>¿Ralentiza la sesión?</summary>
|
|
246
|
+
|
|
247
|
+
La recogida y el saneado se ejecutan de forma síncrona en el manejador de eventos, pero el envío es totalmente asíncrono: la cola se vacía por tamaño o por temporizador, y `session/flush` es solo un empujón de mejor esfuerzo — el punto de durabilidad nunca espera a un backend remoto. Los fallos de exportación avisan, cuentan (`observe.export_failures`), reintentan y acaban en el spool; un fallo del manejador de `session/event` se captura y se registra, así que la observabilidad nunca puede romper la ruta caliente del harness.
|
|
248
|
+
|
|
249
|
+
</details>
|
|
250
|
+
|
|
251
|
+
<details>
|
|
252
|
+
<summary>¿Compite con otros plugins por servicios, eventos o slots?</summary>
|
|
253
|
+
|
|
254
|
+
Inyecta una clave de servicio (`storageDomain`), escucha tres eventos `session/*` y no registra herramientas de modelo, ni comandos, ni slots de cliente, ni listeners de waterfall, ni reescrituras globales. La única superficie de nombres a vigilar es el servicio remoto opcional `observe` (`remote.enabled` está desactivado por defecto): si otro plugin del mismo perfil ocupa ese nombre, activa solo uno de los dos.
|
|
255
|
+
|
|
256
|
+
</details>
|
|
257
|
+
|
|
258
|
+
## Límites de seguridad
|
|
259
|
+
|
|
260
|
+
- **Desactivado por defecto** — no se captura ni se exporta nada salvo que lo actives explícitamente (`enabled: true` más al menos un backend).
|
|
261
|
+
- **Saneado antes del envío** — la redacción estructural de claves, los patrones de secreto integrados (claves de API, tokens de GitHub, claves de AWS, credenciales bearer, claves privadas), tus patrones y los presupuestos de caracteres se aplican antes de que ningún registro abandone la memoria.
|
|
262
|
+
- **Revalidación en la frontera durable** — los registros leídos del almacenamiento se comprueban de nuevo antes de que un sink pueda verlos.
|
|
263
|
+
- **Fallo ruidoso, fallo contenido** — los fallos de exportación avisan, cuentan, reintentan y acaban en el spool; un fallo del manejador de sesión se captura y se registra para que la observabilidad nunca rompa la ruta caliente del harness.
|
|
264
|
+
- **Visible para el modelo ⟺ registrado** — las exportaciones de prompt/completion proyectan solo la superficie de sesión (cuyo nodo 0 es el system prompt) y la cabecera registrada (configuración de la llamada y herramientas); el exportador no inventa contenido.
|
|
265
|
+
|
|
266
|
+
## Permisos y datos
|
|
267
|
+
|
|
268
|
+
- **Permisos**: `network:outbound` hacia los endpoints que configures, `session:read` para el flujo de eventos y `storage:write` para el búfer offline; sin código nativo y sin acceso al sistema de ficheros.
|
|
269
|
+
- **Datos**: todo lo enviado deriva del log de sesión y se sanea (redacción + truncado) antes de encolarse, almacenarse o transmitirse. El búfer offline solo guarda registros saneados, revalidados al leerse.
|
|
270
|
+
- **Credenciales**: las claves pública/secreta de Langfuse solo viajan al endpoint de Langfuse configurado; las cabeceras OTLP solo al endpoint OTLP configurado. El plugin no almacena credenciales — usa referencias de credenciales o valores inyectados por entorno.
|
|
271
|
+
|
|
272
|
+
## Limitaciones conocidas
|
|
273
|
+
|
|
274
|
+
- **Base `0.2.2-rc.1`** — el plugin se desarrolla y prueba contra `@deepseek-ai/dsh@0.2.2-rc.1` (devDependencies y la regla principal de CI); `engines.dsh` (`>=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0`) y el rango compuesto de peers mantienen instalable cada línea publicada, y las bases más antiguas las cubren la segunda regla (`typecheck:ci`) y el workflow de compatibilidad.
|
|
275
|
+
- **Los eventos de auditoría no se persisten** — los registros `observe/*` del propio exportador son solo de auditoría: en la línea actual del host la compuerta de append de sesión solo admite eventos de superficie, así que ningún evento `observe/*` se escribe en el log de sesión, y el plugin no falsifica uno con un append sin marcar (eso haría ilegibles las sesiones). Usa la salida de `observe/status` (requiere `remote.enabled: true`) y los backends OTLP/Langfuse como superficie de auditoría.
|
|
276
|
+
- **Las métricas evitan la ruta de reintento/spool** — las métricas OTLP se agregan de forma acumulativa, así que un vaciado perdido se recupera en el siguiente (por diseño, no es un fallo).
|
|
277
|
+
- **Sin muestreo** — se exporta toda familia de spans habilitada; para sesiones de gran volumen ajusta los interruptores `capture.*` y `batch.maxBufferRecords`.
|
|
278
|
+
|
|
279
|
+
## Interoperabilidad con otros plugins DSH
|
|
280
|
+
|
|
281
|
+
La superficie de registro del plugin es deliberadamente estrecha, así que los conflictos son estructuralmente improbables:
|
|
282
|
+
|
|
283
|
+
- **Sin conflicto de nombres de herramienta** — no registra herramientas de modelo (ni el README ni `src/index.ts` tienen un registro de herramienta).
|
|
284
|
+
- **Sin conflicto de nombres de comando** — no registra comandos visibles para el usuario, así que nunca toca el espacio de nombres de comandos con barra.
|
|
285
|
+
- **Sin conflicto de slots de cliente** — el paquete no incluye mitad de navegador (no hay directorio `client/`), así que no registra slots de cliente.
|
|
286
|
+
- **Sin cortocircuito de waterfall** — solo lee `session/event`, `session/flush` y `session/disposed`; no escucha ningún waterfall de allow/passthrough, así que no puede bloquear la decisión de nadie.
|
|
287
|
+
- **Su única clave de servicio** — `storageDomain` (inyectada, no provista); más un servicio remoto **opcional**, `observe`, registrado solo con `remote.enabled: true`.
|
|
288
|
+
- **Tráfico saliente solo a tus endpoints** — OTLP y Langfuse son independientes; desactivar uno no afecta al otro.
|
|
289
|
+
|
|
290
|
+
Si hay otro plugin de observabilidad en el mismo perfil, atención a dos cosas: ambos consumen `session/event` (Cordis difunde, así que ninguno mata al otro) pero obtendrás dos juegos de trazas, y no registres dos veces el nombre de servicio remoto `observe`.
|
|
291
|
+
|
|
292
|
+
## Compatibilidad
|
|
293
|
+
|
|
294
|
+
| Dimensión | Estado |
|
|
295
|
+
|---|---|
|
|
296
|
+
| Harness | DeepSeek Harness `dsh-v0.2.2-rc.4` (adaptado el 2026-11-18): el formato de sesión V4 representa el resultado de una herramienta como un mensaje de primera clase `role: 'tool'` con `toolCallId` + `content` + `isError` opcional en el nivel superior — el bloque de contenido `tool-result` de V3 ya no está en el `ContentBlockMap` del host, y este plugin solo lee la forma V4 (un log V3 anterior a la actualización todavía se proyecta por una ruta de compatibilidad de solo lectura). Los demás rasgos del formato V3 se mantienen: el flujo del asistente va embebido en `assistant/message` / `assistant/attempt`, y el system prompt es el nodo 0 de la superficie (`system/message`); el plugin consume solo el flujo de eventos en vivo y nunca lee ficheros de log de sesión. `engines.dsh` es `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`; el humo de instalación del perfil lo cubre el workflow de compatibilidad. |
|
|
297
|
+
| Node | `^22.19.0 \|\| >=24.9.0`, ESM puro (`"type": "module"`) |
|
|
298
|
+
| Backends | OpenTelemetry OTLP/HTTP (trazas + métricas, codificación JSON) y Langfuse (observabilidad LLM) — uno u otro, o ambos |
|
|
299
|
+
| Modelo | Independiente del modelo: exporta el flujo session/event; no realiza llamadas a modelos |
|
|
300
|
+
|
|
301
|
+
Dependencias peer: `@deepseek-ai/cordis ^4.0.5-alpha.1`, `@deepseek-ai/schemastery ^3.18.5`, y `@deepseek-ai/dsh-llm`, `@deepseek-ai/dsh-session`, `@deepseek-ai/dsh-storage`, `@deepseek-ai/dsh-storage-domain`, `@deepseek-ai/dsh-storage-json`, `@deepseek-ai/dsh-typert-protocol` (`>=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 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0`; devDependencies fijadas a `0.2.2-rc.1`). `zod` es la única dependencia de ejecución, usada para la validación de la frontera durable del búfer offline.
|
|
302
|
+
|
|
303
|
+
## Ecosistema y calidad
|
|
304
|
+
|
|
305
|
+
- [Espejo en Gitee](https://gitee.com/perrylink/dsh-observe) (espejo sincronizado; GitHub es la fuente autorizada)
|
|
306
|
+
- [Página del plugin en dshfind](https://dshfind.com/plugins/PerryLink/dsh-observe) (instalaciones y ranking)
|
|
307
|
+
- [Informe OpenSSF Scorecard](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-observe) (impulsado por [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml))
|
|
308
|
+
- [Informe de verificación de dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
|
|
309
|
+
- [DSH Market](https://dsh.market/) (publicado)
|
|
310
|
+
- **Canal de la tienda 1024**: ejecuta `npm i -g dsh1024` una vez y luego `dsh1024 plugin --profile web add dsh-observe` (cuenta para el ranking de instalaciones de [deepseek1024.com](https://deepseek1024.com))
|
|
311
|
+
- [Base de conocimiento del ecosistema](https://perrylink.github.io/dsh-plugin-guide/): guía de desarrollo de plugins · datos de selección · criterios de mantenimiento
|
|
312
|
+
|
|
313
|
+
## Desarrollo
|
|
314
|
+
|
|
315
|
+
```sh
|
|
316
|
+
pnpm install # node ^22.19 || >=24.9
|
|
317
|
+
pnpm run typecheck # tsc: src + tests contra las devDeps 0.2.2-rc.1 (sin paths de tsconfig)
|
|
318
|
+
pnpm run typecheck:ci # tsc contra la línea publicada (sin paths)
|
|
319
|
+
pnpm run check:ruler-live # canario: debe fallar al compilar, lo que prueba que la regla sigue viva (requiere la cara checkout)
|
|
320
|
+
pnpm test # vitest: 126 tests, 18 suites (costura real de Context/Session/storage)
|
|
321
|
+
pnpm run test:coverage # puerta de cobertura (90/80/90/90)
|
|
322
|
+
pnpm run build # bundle tsdown + declaraciones tsc (lib/)
|
|
323
|
+
pnpm run verify:self-contained # las dependencias se resuelven desde el registry
|
|
324
|
+
pnpm run verify:artifacts # cara ESM compilada + patch del bundle presentes
|
|
325
|
+
node scripts/check-readme-sync.mjs # puerta de sincronía de los README en cinco idiomas
|
|
326
|
+
pnpm pack # el tarball publicado
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
Las imágenes del README las genera [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Pillow dibuja los cuatro hero de 1440×576; el diagrama de estructura de 1100×660 es SVG escrito a mano), que escribe `docs/assets/dsh-observe-hero-{zh,en}-{light,dark}.webp` y el par `docs/assets/dsh-observe-flow-v5-{light,dark}.svg`; volver a ejecutarlo es idempotente. Los antiguos `docs/assets/dsh-observe-flow-{light,dark}.svg`, `dsh-observe-flow.svg`, `dsh-observe-hero.png` y `dsh-observe-demo.{png,gif}` se quedan donde están para que los enlaces externos no den 404; los README ya no los referencian.
|
|
330
|
+
|
|
331
|
+
Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `observability`, `opentelemetry`, `otlp`, `langfuse`, `tracing`
|
|
332
|
+
|
|
333
|
+
## Familia y agradecimientos
|
|
334
|
+
|
|
335
|
+
Este proyecto forma parte de la familia de plugins de DeepSeek Harness mantenida por [PerryLink](https://github.com/PerryLink) (todos Apache-2.0). Si este plugin te resulta útil, **dale una estrella**: no desbloquea nada, pero ayuda a que la siguiente persona lo encuentre.
|
|
336
|
+
|
|
337
|
+
- [@PerryLink](https://github.com/PerryLink) — creador y mantenedor: collector, pipelines, spool, sinks OTLP/Langfuse, saneado y la documentación en cinco idiomas.
|
|
338
|
+
|
|
339
|
+
<details>
|
|
340
|
+
<summary>Expandir todos los plugins</summary>
|
|
341
|
+
|
|
342
|
+
| Plugin | Estado |
|
|
343
|
+
|---|---|
|
|
344
|
+
| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
|
|
345
|
+
| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
|
|
346
|
+
| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
|
|
347
|
+
| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 CONGELADO — ver el README del repo |
|
|
348
|
+
| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
|
|
349
|
+
| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
|
|
350
|
+
| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 CONGELADO — ver el README del repo |
|
|
351
|
+
| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
|
|
352
|
+
| **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
|
|
353
|
+
| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
|
|
354
|
+
| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
|
|
355
|
+
| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
|
|
356
|
+
| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 CONGELADO — ver el README del repo |
|
|
357
|
+
| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
|
|
358
|
+
| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
|
|
359
|
+
| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
|
|
360
|
+
| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
|
|
361
|
+
| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
|
|
362
|
+
| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
|
|
363
|
+
| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
|
|
364
|
+
| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
|
|
365
|
+
| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
|
|
366
|
+
| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
|
|
367
|
+
| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
|
|
368
|
+
| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
|
|
369
|
+
| **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
|
|
370
|
+
| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
|
|
371
|
+
| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
|
|
372
|
+
| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
|
|
373
|
+
| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
|
|
374
|
+
| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
|
|
375
|
+
| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
|
|
376
|
+
| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
|
|
377
|
+
| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
|
|
378
|
+
| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
|
|
379
|
+
| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
|
|
380
|
+
| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
|
|
381
|
+
| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
|
|
382
|
+
| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
|
|
383
|
+
| **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
|
|
384
|
+
| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
|
|
385
|
+
| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
|
|
386
|
+
| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
|
|
387
|
+
| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
|
|
388
|
+
| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
|
|
389
|
+
| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 CONGELADO — ver el README del repo |
|
|
390
|
+
| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
|
|
391
|
+
| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
|
|
392
|
+
| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
|
|
393
|
+
| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
|
|
394
|
+
| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
|
|
395
|
+
| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
|
|
396
|
+
| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
|
|
397
|
+
| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
|
|
398
|
+
| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
|
|
399
|
+
| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
|
|
400
|
+
| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
|
|
401
|
+
| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 RETIRADO (repo archivado) |
|
|
402
|
+
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
|
|
403
|
+
| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 RETIRADO (repo archivado) |
|
|
404
|
+
| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 RETIRADO (repo archivado) |
|
|
405
|
+
| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
|
|
406
|
+
| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
|
|
407
|
+
| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
|
|
408
|
+
| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
|
|
409
|
+
| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
|
|
410
|
+
| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
|
|
411
|
+
| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
|
|
412
|
+
| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
|
|
413
|
+
| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
|
|
414
|
+
| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
|
|
415
|
+
| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
|
|
416
|
+
| **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 CONGELADO — ver el README del repo |
|
|
417
|
+
| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
|
|
418
|
+
| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
|
|
419
|
+
| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
|
|
420
|
+
| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
|
|
421
|
+
| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
|
|
422
|
+
| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
|
|
423
|
+
| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
|
|
424
|
+
| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
|
|
425
|
+
| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
|
|
426
|
+
| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
|
|
427
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
|
|
428
|
+
| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 RETIRADO (repo archivado) |
|
|
429
|
+
| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
|
|
430
|
+
| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
|
|
431
|
+
| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver el README del repo |
|
|
432
|
+
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver el README del repo |
|
|
433
|
+
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver el README del repo |
|
|
434
|
+
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver el README del repo |
|
|
435
|
+
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver el README del repo |
|
|
436
|
+
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRADO (repo archivado) |
|
|
437
|
+
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRADO (repo archivado) |
|
|
438
|
+
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRADO (repo archivado) |
|
|
439
|
+
|
|
440
|
+
</details>
|
|
441
|
+
|
|
442
|
+
## Licencia
|
|
443
|
+
|
|
444
|
+
[LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-observe contributors
|
|
445
|
+
|
|
446
|
+
<p align="center"><sub>Apache-2.0 · Plugin comunitario, no afiliado a DeepSeek.</sub></p>
|