DSH Plugin Toolkit

Прорывная пятиуровневая инфраструктура + конвейер циклической разработки плагинов. Ядро без зависимостей в рантайме; слой Bridge построен на официальном @modelcontextprotocol/sdk.

Пятиуровневая архитектура (v2)

Обнаружение плагинов имеет три уровня деградации: полный cordis.yml → только подсчёт в рантайме (count-only) → извлечение из исходного кода по регулярным выражениям (regex). Все инструменты используют единый контракт: входной параметр MCP { input_data: string }.

Related MCP server: finance-agent

Быстрый старт

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

Встроенные плагины (20)

• Финансы: invoice-calc / loan-calc / invest-growth / salary-tax / fx-rates

• Данные и разработка: csv-stats / json-format / regex-lab / codec-kit / text-diff / date-math

• Контент и маркетинг: seo-audit / text-summary / readability / markdown-report

• Бытовые инструменты: health-metrics / unit-convert / color-kit / pass-forge

• Вертикальные отрасли: carbon-baseline

Циклическая разработка новых плагинов

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

В сгенерированном src/index.ts реализуйте handler: на вход принимает input_data: string, на выходе возвращает строку. Если в конце вывода содержится дисклеймер, он проходит все валидаторы.

Настройка бюджета

В корне проекта размещается dsh.budget.json:

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

Без конфигурации ограничения не применяются (ведётся только учёт использования).

Пути публикации

• MCP-маркетплейс: после npm pack подключается по stdio к MCP-клиентам, таким как Claude Desktop / Cursor (входная точка dist/bridge/server.js, реализация на официальном SDK); можно отлаживать через npx @modelcontextprotocol/inspector node dist/bridge/server.js

• Маркетплейс плагинов Koishi: npx dsh pack <plugin> создаёт публикуемый пакет, соответствующий требованиям доступа к маркетплейсу (koishi-plugin-* именование, peerDependencies.koishi, поле метаданных koishi); cd publish/<name> && npm publish — и пакет опубликован

• Реестр A2A: a2a-cards/ напрямую совместим со спецификацией Google A2A v2.0; можно потреблять через официальный ClientFactory из @a2a-js/sdk

CI

.github/workflows/ci.yml: build → модульные тесты → смоук-тесты discovery/A2A/pack → смоук-тест MCP-протокола → проверка детерминированности.