PerryLink/dsh-defend
PerryLink/dsh-defend has 28 GitHub stars and 1 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:38 UTC. Last push 2026-11-13.
Crecimiento de estrellas medido
- in 24h
- 0
- in 7 days
- Actualización retrasada
- in 15 days
- Actualización retrasada
- in 1 month
- Actualización retrasada
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
Prompt-injection, jailbreak and secret-leak defense for DeepSeek Harness: Aho-Corasick detection with allow/ask/block interception and sanitized audit events. Maintenance status: FROZEN since 2026-10-05.
IAREADME.es.md
Original
🛡️ dsh-defend
- Canal 1024 store:
npm i -g dsh1024una vez, luegodsh1024 plugin --profile web add dsh-defend(cuenta para el ranking de instalaciones de deepseek1024.com).
Defensa contra inyección de prompts, jailbreak y fugas de secretos para DeepSeek Harness.
Las reglas deciden lo conocido. La intercepción decide el resto — y todo queda auditado.
简体中文 · English · Español · Português · हिन्दी
dsh plugin --profile <name> add dsh-defend
📖 Base de conocimiento del ecosistema — datos medidos, no marketing: guía de desarrollo · datos de selección · criterios de mantenimiento.
Instalación y desinstalación
- Canal git (último
main):dsh plugin --profile web add github:PerryLink/dsh-defend— el scriptpreparecompila solo con dependencias de producción. - Canal npm (versiones publicadas):
dsh plugin --profile web add dsh-defend. - Canal tarball:
pnpm packen este repositorio y luegodsh plugin --profile web add ./dsh-defend-<version>.tgz. - Desinstalar:
dsh plugin --profile web remove dsh-defend(o elimina la fila del parche del perfil).
What is dsh-defend?
Defensa contra inyección de prompts, jailbreak y fugas de secretos para DeepSeek Harness.
Las reglas deciden lo conocido. La intercepción decide el resto — y todo queda auditado.
Pipeline de detección: tres puntos de intercepción convergen en un núcleo de escaneo; cada acierto pasa por allow / ask / block y deja un evento saneado.
La misma ejecución, animada.
Estado de mantenimiento: 🧊 CONGELADO
Congelado el 2026-10-05. Sin nuevas funciones. Este paquete sigue funcionando y no está retirado, pero ya no recibe trabajo de funciones; solo se corregirá una avería real.
Los mantenedores consideran que en esta capacidad la comunidad ha convergido en una implementación más ampliamente adoptada, así que el esfuerzo se ha trasladado. Comparativa medida el 2026-10-05:
| paquete | descargas semanales | |
|---|---|---|
| este paquete | dsh-defend |
937 |
| implementación más ampliamente adoptada | cc-safety-net |
13,087 |
👉 Para trabajo nuevo, cc-safety-net es la opción principal para la puerta de comandos destructivos. Este paquete sigue siendo el detector más amplio, pero está congelado y no recibirá nuevas funciones. Las instalaciones existentes siguen funcionando sin cambios.
Evidencia completa: dsh-plugin-supersession-review-20261005.md. Texto completo en la sección Maintenance status: 🧊 FROZEN de README.md.
⭐ 如果它帮到了你
Este plugin forma parte de la familia de plugins DSH (más de 40, todos Apache-2.0). Si te resulta útil, dale una estrella: no desbloquea nada, pero ayuda a que la siguiente persona lo encuentre antes.
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.
Comparison

105 samples (75 positive / 30 negative) · from benchmark/RESULTS.md in this repo
Compatibilidad
| Superficie | Estado |
|---|---|
| Harness | DeepSeek Harness dsh-v0.2.1-alpha.1 (verificado el 2026-09-25; rangos de peer >=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). En esta línea el tercer argumento de Session.append existe solo para tipos de superficie y es un SurfaceIntent, así que el tipo no-superficie defend/detection sigue sin poder estampar el marcador ignorable: la auditoría del log de sesión permanece deshabilitada fail-closed y /defend muestra ese estado explícitamente. El formato de sesión V4 ya no tiene bloque de contenido tool-result — este plugin nunca lo produjo, y sus dos recorredores de contenido conservan un respaldo de solo lectura para el envoltorio V3 retirado, de modo que las sesiones escritas antes de la actualización siguen analizándose. Verificado el 2026-09-25 (doble typecheck + suite completa + build + puertas self-contained/artifacts + pack; una sola copia del grafo de tipos del host). |
| Node | ^22.19.0 || >=24.0.0 |
| Plataformas | Todas (solo host; sin código nativo, sin red) |
| Modelo | Cualquiera (la detección ocurre antes de que el contenido llegue al modelo) |
Qué obtienes
dsh-defend coloca dos capas independientes delante del agente:
- Guardia de borrado destructivo — la forma ejecutable de la lección del postmortem 8·14/8·16. En
tools/pre-execute, los comandos de shell que borran recursivamente se rechazan salvo que cada destino sea una ruta absoluta explícita dentro del espacio de trabajo de la sesión y fuera de los prefijos protegidos (configuración del home,.dsh/.claude, directorios del sistema). Los marcadores de dry-run (-WhatIf,--dry-run,git clean -n) pasan, porque son exactamente la verificación que la lección exige. - Capa de detección — portada de cuatro activos upstream (todos Apache-2.0, véase THIRD_PARTY_NOTICES.md): 25 reglas de Prompt-Injection-Payloads, 25 patrones de Jailbreak-Detector mediante un autómata Aho-Corasick en TypeScript puro, 12 gramáticas de secretos de Secret-Key-Leaker-Detect más las referencias públicas de los emisores, y el Prompt-Attack-Dataset conservado textualmente como referencia de regresión.
Tres puntos de intercepción, un mismo modelo de decisión:
| Punto | Contenido escaneado | Decisión |
|---|---|---|
agent/pre-step |
mensajes entrantes | allow → next(); ask → aprobación; block → rechazar el paso |
tools/pre-execute |
argumentos de herramientas | allow → next(); ask → aprobación; block → deny |
tools/post-execute |
resultados de herramientas | allow → next(); ask → aprobación; block → feedback correctivo |
Por defecto: ask para cada familia, block para secretos critical (la semántica de interrupción inmediata del upstream). Sin respondedor de aprobación = fallo cerrado. Todo paso a través llama a next() — los plugins de política aguas abajo nunca se cortocircuitan.
Inicio rápido
dsh plugin --profile web add github:PerryLink/dsh-defend
# 1. instala el bundle en tu perfil
dsh plugin --profile web add github:PerryLink/dsh-defend
# o desde npm (versiones publicadas)
dsh plugin --profile web add dsh-defend
# 2. reinicia y verifica la fila
dsh --profile web --dump-config | grep -A3 'id: dsh-defend'
Ejemplos
Son los puntos de entrada reales; instala y llama a uno.
Ejemplo detallado
Comando
defend_report
Entrada
{}
Salida
dsh-defend: 0 recorded detection(s), 0 blocked, 0 asked.
Observado en tests/lifecycle.spec.ts:91-126 (canonical empty value at :110-117); src/index.ts:772-775
Rama de fallo
Entrada
Remove-Item -Recurse
Salida
{"kind":"deny","reason":"blocked dangerous recursive delete command (Remove-Item -Recurse): no explicit target path was printed. Dry-run first (Remove-Item -WhatIf / git clean -n / list the directory), verify each target one by one, then retry with an explicit absolute path"}
Observado en plugins/dsh-defend/src/index.ts:376-379; plugins/dsh-defend/tests/destructive-delete.spec.ts:68-71; verified via plugins/dsh-defend/lib/index.js
Ejemplos breves
/defend
Configuración
Todos los ajustes son campos Config de Schemastery (modificables desde cordis.yml). Una sobrescritura dirigida por id reemplaza toda la fila — vuelve a declarar cada clave. cordis.patch.yml documenta cada clave en línea.
| Clave | Por defecto | Significado |
|---|---|---|
enabled |
true |
Interruptor maestro de ambas capas |
action |
deny |
Acción de la guardia de borrado destructivo (deny / ask) |
toolNames |
['bash','persistent-bash','terminal-bash'] |
Nombres de herramientas cuyos argumentos revisa la guardia |
detection.enabled |
true |
Interruptor de la capa de detección |
detection.maxScanChars |
10000 |
Límite de escaneo por intercepción (solo la cabeza) |
detection.normalizeUnicode |
true |
Normalizar NFKC el texto antes de escanear (bloquea el bypass de Unicode lookalike) |
detection.secretMinEntropy |
3.0 |
Entropía de Shannon mínima (bits/carácter) para admitir un acierto de secreto; 0 desactiva |
detection.injectionAction |
ask |
Familia inyección: allow / ask / block |
detection.jailbreakAction |
ask |
Familia jailbreak: allow / ask / block |
detection.secretAction |
ask |
Familia secretos: allow / ask / block |
detection.secretBlockCritical |
true |
Los secretos critical bloquean siempre, sin importar secretAction |
detection.audit |
true |
Escribir eventos de auditoría defend/detection |
detection.allowUnmarkedAudit |
false |
Seguir escribiendo auditoría de sesión en hosts cuyo Session.append es anterior al marcador ignorable (todas las líneas publicadas hasta ahora, incluidas las versiones preliminares 0.2.x), aceptando el riesgo de sesiones irrecuperables |
detection.maxReportEntries |
200 |
Límite del búfer circular en memoria |
registerCommand |
true |
Registrar el comando /defend |
registerTool |
true |
Registrar la herramienta defend_report |
Herramientas y superficies
| Superficie | Tipo | Notas |
|---|---|---|
defend_report |
herramienta | Totales (registrados/bloqueados/preguntados), conteos por familia y las 20 coincidencias más recientes — nunca texto coincidente |
/defend |
comando | El mismo resumen como texto |
agent/pre-step |
listener | Escaneo de mensajes entrantes (enter/reject) |
tools/pre-execute |
listener | Escaneo de argumentos (deny/ask) + la guardia de borrado destructivo |
tools/post-execute |
listener | Escaneo de resultados (feedback de bloqueo) |
Permisos y datos
- Permisos: las decisiones
askvan por la costura oficial de aprobación; nada se reimplementa ni se esquiva. El plugin declarasession:appendynetwork:noneen su manifiesto de workshop. - Datos: nada se guarda en disco; el búfer circular del informe vive en memoria y está acotado. Sin peticiones de red, sin subprocesos.
- Registro de sesión: los eventos
defend/detectionllevan id de regla, familia, categoría, severidad, tipo de secreto, decisión y hechos del escaneo — el texto coincidente nunca llega al registro, y las coincidencias de secretos son solo de tipo por construcción.
Límites de seguridad
- Detección, no ejecución. La guardia y la capa de detección solo producen decisiones deny/ask/block en las costuras oficiales; el sandbox y los sistemas de aprobación siguen siendo la autoridad de ejecución.
- Fallo cerrado. Sin respondedor de aprobación, sin sesión o sin superficie de servicios, se degrada a la decisión más estricta — nunca al paso silencioso.
- Ningún contenido sale del proceso. El escaneo es local; los eventos de auditoría están sanitizados; los secretos nunca se registran, muestran ni reportan.
- Trabajo acotado. Límites de escaneo, una coincidencia por regla y cotas del búfer circular impiden que entradas hostiles consuman recursos sin límite.
Limitaciones conocidas
- Huecos de detección. La librería de reglas cubre los vocabularios portados y sus variantes tolerantes; frases nuevas, codificaciones Unicode lookalike (la normalización NFKC está como trabajo futuro) y ataques multi-paso pueden evadirla. La referencia fija el piso medido (27/28 en el dataset upstream) para que las regresiones sean visibles.
- Sin veredictos a nivel de modelo.
dsh-defendes determinista; nunca llama a un modelo y no puede juzgar intención nueva. - El rechazo de mensajes es silencioso. El reject de
agent/pre-stepno lleva razón al modelo (la costura no tiene campo de razón); el evento de auditoría registra los hechos de la regla. - Auditoría de sesión y el marcador
ignorable. Los appends de auditoría solicitan el marcadorignorable: truedel envelope para que cualquier build del harness pueda cargar el registro. Todas las líneas publicadas hasta ahora (0.1.0-rc.1–0.1.0-rc.8,0.1.1-rc.1–0.1.1-rc.2, y el corredor0.2— reverificado el 2026-10-04 contra la publicada0.2.1-alpha.1, cuyoappend(type, data, ...opts)solo leesourceEventSeqs/surfaceOpdel paquete de opciones y arma el envelope como{ type, seq, time, data }) lo descartan en silencio — el evento queda sin marcar y hace la sesión irrecuperable en builds más estrictos; el host0.1.2-rc.1conserva el campo del envelope solo para compatibilidad de lectura de logs almacenados, peroSession.appendsigue sin poder estamparlo y la ruta de lectura rechaza los tipos de evento desconocidos sin marcar (defend/detectionno está registrado), de modo que escribir allí también hace la sesión incargable. Por eso, dsh-defend detecta esos hosts en el primer uso (precomprobación de la versión del peer + sondeo del envelope devuelto) y desactiva la auditoría del registro de sesión con una advertencia única; las versiones preliminares0.2.xse clasifican como no marcadas de antemano justamente por eso, mientras que una0.2.xestable sigue recurriendo al sondeo del append. Establecedetection.allowUnmarkedAudit: truepara reactivarla; las filasdefend/detectionexistentes sin marcar pueden repararse añadiendo"ignorable": truea sus envelopes. Véase issue #2.
Desarrollo
pnpm install # node ^22.19 || >=24
pnpm run typecheck # tsc: src + tests contra el checkout local del harness
pnpm run typecheck:ci # tsc contra los tipos publicados 0.1.7-rc.2 (sin paths)
pnpm test # vitest: 97 tests, 9 suites (incluye la referencia de detección)
pnpm run build # bundle tsdown + declaraciones tsc (lib/)
pnpm run verify:self-contained # las especificaciones de dependencias resuelven desde el registry
pnpm run verify:artifacts # cara ESM construida + archivos publicados presentes
pnpm pack # el tarball publicado
Benchmark
El benchmark red-team (P/R/F1 por categoría sobre 105 muestras, más el suelo 27/28 del fixture) está en benchmark/RESULTS.md; regenéralo con node --experimental-strip-types benchmark/run.mjs (cero dependencias nuevas, sin build).
Interoperabilidad con otros plugins de DSH
Verificado contra DSH 0.2.0-rc.2 (el runtime para el que se publica este README) y el conjunto de plugins con más estrellas sondeado el 2026-10-05.
Este plugin no interfiere con otros plugins, incluidos los de más estrellas:
- Sin colisión de nombres de herramienta. Todas las herramientas llevan espacio de nombres; ninguna ocupa un nombre desnudo ya perteneciente a una herramienta incluida u otro plugin.
- Sin colisión de clave de servicio. No provee ninguna clave de servicio, así que no puede colisionar en una.
- Sin colisión de slot. No registra ninguna clave de slot de cliente, así que no disputa un asiento
shadows-shipped-ui. - Sin colisión de ruta HTTP. No registra ningún prefijo
webServer. - Sin colisión en la capa de patch. El patch del bundle solo hace
insertde su propia fila; nunca sobrescribe elconfigde una fila incluida. - Sin mutación global. No parchea prototipos, ni reescribe
process.env, ni reemplaza el dispatcher global de fetch.
Los listeners de eventos compartidos no interfieren por construcción. Observa los eventos sensibles al orden agent/pre-step, tools/post-execute, tools/pre-execute con ctx.on() — el registro de difusión de Cordis, donde cada listener se ejecuta y ninguno puede dejar sin turno a otro. Todos los listeners aquí delegan por next(), así que la cadena nunca se cortocircuita:
agent/pre-step— also used bydsh-routing-suite(7000★, 7 listeners),modlens(4122★),dsh-purge(3317★),dsh-agent-teams(1923★),dsh-context(1849★).tools/post-execute— also used bycc-safety-net(1576★).tools/pre-execute— also used bycc-safety-net(1576★).
Evidencia estática: dsh-plugin-doctor K10–K13 dan pass en todas las comprobaciones de este repositorio.
Topics
dsh, dsh-plugin, deepseek-harness, deepseek, cordis, security, prompt-injection, jailbreak, secret-scanning, ai-safety
Contributors
- @PerryLink — creador y mantenedor: guardia de borrado destructivo, portado de detección de cuatro activos, cableado de intercepción, superficie de auditoría y la documentación en cinco idiomas.
- @cuohua — el informe preciso sobre eventos
defend/detectionescritos sin marcar que hacen las sesiones irrecuperables en builds más estrictos (#2); la detección de capacidad de host en runtime y la disciplina del marcadorignorablederivan directamente de ese análisis.
PerryLink DSH Plugin Family
Este proyecto forma parte de la familia de plugins de DeepSeek Harness de PerryLink. El registro permanece plegado abajo para que cada README conserve una primera pantalla corta; expándelo para ver cada fila y su estado.
Expandir todos los plugins
License
Apache License 2.0 © 2026 dsh-defend contributors
Instalar desde el mercado de DSH Desktop
Todos los plugins de PerryLink pueden explorarse en el mercado integrado de DSH Desktop: Market → Sources → add source → pegar https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → seleccionarlo. La instalación sigue pasando por la verificación de identidad npm del mercado y tu confirmación.