DSH Plugin Toolkit

Infraestructura de 5 capas + pipeline de desarrollo en bucle de plugins. Núcleo con cero dependencias en tiempo de ejecución; la capa Bridge se basa en el @modelcontextprotocol/sdk oficial.

Arquitectura de cinco capas (v2)

Descubrimiento de plugins con degradación en tres niveles: cordis.yml completo → solo cantidad en tiempo de ejecución (count-only) → extracción por regex del código fuente (regex). Todas las herramientas comparten un contrato unificado: parámetro de entrada MCP { input_data: string }.

Related MCP server: finance-agent

Inicio rápido

npm install
npm run build          # 编译核心 + 全部插件

npx dsh list           # 列出发现的插件与工具
npm test               # 单元测试 (node:test, 9 cases)
npx dsh bridge         # 启动官方 SDK MCP stdio 服务器
npx dsh a2a gen        # 生成 a2a-cards/*.agent-card.json (A2A v1.0)
npx dsh a2a serve      # 启动真实 A2A v1.0 服务器 (:41241)
npx dsh llm models     # 列出本地 Ollama 模型（免费推理）
npx dsh llm ask "..."  # 本地 LLM 生成 + L3 验证循环
npx dsh demo carbon [--llm]  # L5 多Agent Demo（--llm 用本地 Ollama 真实合成）
npx dsh serve [port]   # REST 网关: POST /invoke，API-Key 计费 + 限流 (:8787)
npx dsh registry gen   # 市场目录: registry.json + index.html

Plugins integrados (20)

Finanzas: invoice-calc / loan-calc / invest-growth / salary-tax / fx-rates Datos y desarrollo: csv-stats / json-format / regex-lab / codec-kit / text-diff / date-math Contenido y marketing: seo-audit / text-summary / readability / markdown-report Herramientas de vida: health-metrics / unit-convert / color-kit / pass-forge Industria vertical: carbon-baseline

Desarrollo en bucle de nuevos plugins

npx dsh scaffold my-tool   # 生成 plugins/dsh-tool-my-tool/
npm run build              # 编译后即刻被 Bridge/A2A/Demo 发现
npx dsh list               # 验证

Implementa el handler en el src/index.ts generado: parámetro de entrada input_data: string, devuelve una cadena. Incluir un descargo de responsabilidad al final de la salida es suficiente para pasar todos los validadores.

Configuración de presupuesto

Coloca dsh.budget.json en la raíz del proyecto:

{ "monthly": 5000000, "user": 200000, "plugin": 50000 }

Si no se configura, no hay límite (solo se registra el uso).

Rutas de publicación

• Mercado MCP: tras npm pack, conéctalo vía stdio a clientes MCP como Claude Desktop / Cursor (entrada dist/bridge/server.js, implementación con SDK oficial); se puede depurar con npx @modelcontextprotocol/inspector node dist/bridge/server.js

• Mercado de plugins Koishi: npx dsh pack <plugin> genera un paquete de publicación conforme a las normas de acceso al mercado (nombre koishi-plugin-*, peerDependencies.koishi, campo de metadatos koishi); cd publish/<name> && npm publish lo publica

• Registro A2A: a2a-cards/ es directamente compatible con la especificación Google A2A v1.0, se puede consumir con el ClientFactory oficial de @a2a-js/sdk

CI

.github/workflows/ci.yml: build → pruebas unitarias → smoke test de descubrimiento/A2A/pack → smoke test del protocolo MCP → verificación de determinismo.