DSH Plugin Toolkit

5-Schichten-Infrastruktur und Plugin-Loop-Entwicklungspipeline. Der Kern hat keinerlei Laufzeitabhängigkeiten; die Bridge-Schicht basiert auf dem offiziellen @modelcontextprotocol/sdk.

Fünf-Schichten-Architektur (v2)

Die Plugin-Erkennung erfolgt über einen dreistufigen Fallback: vollständige cordis.yml → nur Laufzeit-Anzahl (count-only) → Regex-Extraktion aus dem Quellcode (regex). Alle Tools verwenden einen gemeinsamen Vertrag: MCP-Eingabeparameter { input_data: string }.

Related MCP server: finance-agent

Schnellstart

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

Integrierte Plugins (20)

Finanzen: invoice-calc / loan-calc / invest-growth / salary-tax / fx-rates Daten & Entwicklung: csv-stats / json-format / regex-lab / codec-kit / text-diff / date-math Inhalte & Marketing: seo-audit / text-summary / readability / markdown-report Lebenswerkzeuge: health-metrics / unit-convert / color-kit / pass-forge Vertikale Branchen: carbon-baseline

Neue Plugins im Loop entwickeln

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

Implementiere den handler in der generierten src/index.ts: Eingabeparameter ist input_data: string, Rückgabewert ist eine Zeichenkette. Ein Haftungsausschluss am Ende der Ausgabe genügt, um alle Validatoren zu bestehen.

Budgetkonfiguration

Lege dsh.budget.json im Stammverzeichnis des Projekts ab:

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

Ohne Konfiguration gibt es keine Beschränkung (die Nutzung wird nur nachverfolgt).

Veröffentlichungswege

• MCP-Marktplatz: Nach npm pack an MCP-Clients wie Claude Desktop / Cursor anschließen (Einstiegspunkt dist/bridge/server.js, offizielle SDK-Implementierung); Debugging mit npx @modelcontextprotocol/inspector node dist/bridge/server.js möglich

• Koishi-Plugin-Marktplatz: npx dsh pack <plugin> erzeugt ein Veröffentlichungspaket, das den Marktplatz-Spezifikationen entspricht (koishi-plugin-*-Namenskonvention, peerDependencies.koishi, koishi-Metadatenfeld); cd publish/<name> && npm publish veröffentlicht es im Marktplatz

• A2A-Registry: a2a-cards/ ist direkt kompatibel mit der Google-A2A-v1.0-Spezifikation; kann mit der offiziellen @a2a-js/sdk ClientFactory verwendet werden

CI

.github/workflows/ci.yml: build → Unit-Tests → Plugin-Auffindung/A2A/pack-Smoke-Tests → MCP-Protokoll-Smoke-Tests → deterministische Prüfung.