Run any Skill in Manus with one click

plugin-development

Stars42

Forks7

UpdatedApril 22, 2026 at 19:31

插件开发全流程技能。按通道类型引导：Native DLL / Process EXE / MCP。主推 C#（提供脚手架），其他语言提供协议规范。触发关键词：插件开发、创建插件、发布插件、Native 插件、Process 插件、MCP 接入。

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

sunyonghuan

sunyonghuan/Netor.Madorin

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

4 files

SKILL.md

readonly

name	plugin-development
version	5
description	插件开发全流程技能。按通道类型引导：Native DLL / Process EXE / MCP。主推 C#（提供脚手架），其他语言提供协议规范。触发关键词：插件开发、创建插件、发布插件、Native 插件、Process 插件、MCP 接入。
user-invocable	true

Plugin Development

选通道

                     ┌─ 接现成工具服务 (GitHub/Filesystem/自建 MCP Server)
                     │    → MCP 通道（UI 配置，不写代码）→ references/mcp-setup.md
做扩展 ───────────── │
                     │                          ┌─ 原生 DLL → Native 通道
                     └─ 自己写 ─ 产物是什么？ ──┤
                                                └─ EXE      → Process 通道

Native 通道：原生 DLL（C ABI）。C# 必须 AOT 发布（IL DLL 加载不了）。C/C++/Rust/Go 可出原生 DLL 走这条路。
Process 通道：EXE 可执行文件。任何语言都能实现，跑 stdio NDJSON 协议。
MCP 通道：连外部 MCP Server，数据库配置，不写 plugin.json。

零、环境准备

运行一次即可（自动检测并安装缺失组件）：

.\scripts\setup-dev-environment.ps1

检查 .NET 10+ SDK 和 AOT 需要的 C++ 构建工具。不做 Native DLL 可加 -SkipAot。

一、先用 ScriptRunner 验原型（可选）

写插件前，用 C# 脚本插件试一把：

sys_csx_run_str 直接跑业务逻辑片段
#r "nuget:Humanizer, 2.14.1" 试 NuGet 包能否满足需求
sys_csx_session_* 保留跨次状态，模拟插件持久层

原型通过再决定做 Native 还是 Process，避免白造。

二、Native 通道（原生 DLL）

C#（有完整脚手架）

.\scripts\create-native-plugin.ps1 -Name MyPlugin -Id my_plugin
# ... 写业务代码 ...
.\scripts\publish-native-plugin.ps1 -ProjectDir Samples\MyPlugin

细节：references/csharp-native.md 错误速查：references/csharp-aot-errors.md

其他语言（C / C++ / Rust / Go / Zig）

任何能产出导出符号的原生 DLL 的语言都能接入。没有脚手架，按 C ABI 契约自行实现：references/native-abi.md

内容包含：5 个导出函数签名、内存所有权规则、plugin.json 格式、C/Rust/Go 最小示例。

Python / Node.js 等解释型语言不适合 Native 通道（无法产出原生 DLL），请走 Process 通道。

三、Process 通道（EXE 子进程）

C#（有完整脚手架）

.\scripts\create-process-plugin.ps1 -Name MyPlugin -Id my_plugin
# ... 写业务代码 ...
.\scripts\publish-process-plugin.ps1 -ProjectDir Samples\MyPlugin

脚手架默认引用 Netor.Cortana.Plugin.Process 框架；编译时会自动生成消息循环、plugin.json 和 {PluginClass}Debugger。

其他语言（Python / Node.js / Go / Rust ...）

没有脚手架，按协议规范自行实现：references/process-protocol.md

该规范是语言中立的完整契约：NDJSON 帧格式、4 个方法 (get_info/init/invoke/destroy)、plugin.json 结构、实现要点清单。

打包要求：产出单个 EXE；C# 场景优先使用 publish-process-plugin.ps1 统一输出运行目录和 zip 包。

四、MCP 通道

不写插件，在 Cortana UI「MCP 服务」页添加配置条目。

参考：references/mcp-setup.md

五、部署约定（通用）

插件目录：.cortana/plugins/<kebab-name>/
开发期：发布脚本自动部署到 Src\Netor.Cortana\bin\Debug\net10.0-windows\.cortana\plugins\
运行时：{WorkspaceDirectory}\.cortana\plugins\，宿主自动扫描加载
目录内只保留运行文件（.dll / .exe / .json / 运行时依赖）；不要带 .pdb / .xml / .deps.json 以外的开发文件

六、参考映射（想做 X → 看 Y）

想做	看
C# 原生 DLL 插件	references/csharp-native.md
C# EXE 子进程插件	使用 `scripts/create-process-plugin.ps1` 生成框架工程
Python / Node / Go / Rust 子进程插件	references/process-protocol.md
MCP 接入	references/mcp-setup.md
AOT 编译错误	references/csharp-aot-errors.md
C/C++/Rust/Go 原生 DLL	references/native-abi.md

更新规则

每次修改此技能或其 references / scripts，将 version 字段 +1。

More from this repository

same repository

plugin-development

sunyonghuan/Netor.Madorin

Madorin 插件开发入口技能。用于统一编排 Native、MCP、Process 三类通道，约束工程规范、外部包 AOT 校验、发布安装与运行时更新流程。触发关键词：插件开发、Native 插件、MCP 插件、Process 插件、进程插件、发布插件、安装插件。

2026-05-2342

native

sunyonghuan/Netor.Madorin

Madorin Native 插件开发子技能。位置：subskills/native。用于 Native AOT 插件创建、Startup 组合、Tool 编写、JsonContext、后台服务、AOT 规则。触发关键词：Native 插件、AOT 插件、Startup.Configure、ToolAttribute、原生插件。

2026-05-2342

process

sunyonghuan/Netor.Madorin

Madorin Process 插件开发子技能。位置：subskills/process。用于开发以独立 exe 进程运行的插件，支持 JIT self-contained 和 AOT exe 两种发布方式，通过 stdin/stdout JSON 协议与宿主通信。触发关键词：Process 插件、进程插件、exe 插件、JIT 插件、进程隔离插件。

2026-05-2342

websocket-integration

sunyonghuan/Netor.Madorin

Madorin PluginBus WebSocket 接入。用于生成 /internal 单端点、cortana.plugin-bus、conversation topic、chat.message.send、chat.generation.stop、system.notice、ping/pong 的 C# 客户端代码与样板。关键词：WebSocket、PluginBus、/internal、chat.message.send、ping、pong。

2026-05-2342

architecture

sunyonghuan/Netor.Madorin

Madorin 插件工程规范子技能。位置：subskills/architecture。用于插件架构设计、职责分离、依赖注入、AOT 安全编码、配置与日志、质量门禁。触发关键词：插件架构、职责分离、依赖注入、工程规范、AOT 安全、插件设计。

2026-05-2342

mcp

sunyonghuan/Netor.Madorin

Madorin MCP 通道子技能。位置：subskills/mcp。用于接入和校验外部 MCP Server 的 stdio、sse、streamable-http 配置。触发关键词：MCP、Model Context Protocol、stdio、sse、streamable-http。

2026-05-2342

name	plugin-development
version	5
description	插件开发全流程技能。按通道类型引导：Native DLL / Process EXE / MCP。主推 C#（提供脚手架），其他语言提供协议规范。触发关键词：插件开发、创建插件、发布插件、Native 插件、Process 插件、MCP 接入。
user-invocable	true

Plugin Development

选通道

                     ┌─ 接现成工具服务 (GitHub/Filesystem/自建 MCP Server)
                     │    → MCP 通道（UI 配置，不写代码）→ references/mcp-setup.md
做扩展 ───────────── │
                     │                          ┌─ 原生 DLL → Native 通道
                     └─ 自己写 ─ 产物是什么？ ──┤
                                                └─ EXE      → Process 通道

Native 通道：原生 DLL（C ABI）。C# 必须 AOT 发布（IL DLL 加载不了）。C/C++/Rust/Go 可出原生 DLL 走这条路。
Process 通道：EXE 可执行文件。任何语言都能实现，跑 stdio NDJSON 协议。
MCP 通道：连外部 MCP Server，数据库配置，不写 plugin.json。

零、环境准备

运行一次即可（自动检测并安装缺失组件）：

.\scripts\setup-dev-environment.ps1

检查 .NET 10+ SDK 和 AOT 需要的 C++ 构建工具。不做 Native DLL 可加 -SkipAot。

一、先用 ScriptRunner 验原型（可选）

写插件前，用 C# 脚本插件试一把：

sys_csx_run_str 直接跑业务逻辑片段
#r "nuget:Humanizer, 2.14.1" 试 NuGet 包能否满足需求
sys_csx_session_* 保留跨次状态，模拟插件持久层

原型通过再决定做 Native 还是 Process，避免白造。

二、Native 通道（原生 DLL）

C#（有完整脚手架）

.\scripts\create-native-plugin.ps1 -Name MyPlugin -Id my_plugin
# ... 写业务代码 ...
.\scripts\publish-native-plugin.ps1 -ProjectDir Samples\MyPlugin

细节：references/csharp-native.md 错误速查：references/csharp-aot-errors.md

其他语言（C / C++ / Rust / Go / Zig）

任何能产出导出符号的原生 DLL 的语言都能接入。没有脚手架，按 C ABI 契约自行实现：references/native-abi.md

内容包含：5 个导出函数签名、内存所有权规则、plugin.json 格式、C/Rust/Go 最小示例。

Python / Node.js 等解释型语言不适合 Native 通道（无法产出原生 DLL），请走 Process 通道。

三、Process 通道（EXE 子进程）

C#（有完整脚手架）

.\scripts\create-process-plugin.ps1 -Name MyPlugin -Id my_plugin
# ... 写业务代码 ...
.\scripts\publish-process-plugin.ps1 -ProjectDir Samples\MyPlugin

脚手架默认引用 Netor.Cortana.Plugin.Process 框架；编译时会自动生成消息循环、plugin.json 和 {PluginClass}Debugger。

其他语言（Python / Node.js / Go / Rust ...）

没有脚手架，按协议规范自行实现：references/process-protocol.md

该规范是语言中立的完整契约：NDJSON 帧格式、4 个方法 (get_info/init/invoke/destroy)、plugin.json 结构、实现要点清单。

打包要求：产出单个 EXE；C# 场景优先使用 publish-process-plugin.ps1 统一输出运行目录和 zip 包。

四、MCP 通道

不写插件，在 Cortana UI「MCP 服务」页添加配置条目。

参考：references/mcp-setup.md

五、部署约定（通用）

插件目录：.cortana/plugins/<kebab-name>/
开发期：发布脚本自动部署到 Src\Netor.Cortana\bin\Debug\net10.0-windows\.cortana\plugins\
运行时：{WorkspaceDirectory}\.cortana\plugins\，宿主自动扫描加载
目录内只保留运行文件（.dll / .exe / .json / 运行时依赖）；不要带 .pdb / .xml / .deps.json 以外的开发文件

六、参考映射（想做 X → 看 Y）

想做	看
C# 原生 DLL 插件	references/csharp-native.md
C# EXE 子进程插件	使用 `scripts/create-process-plugin.ps1` 生成框架工程
Python / Node / Go / Rust 子进程插件	references/process-protocol.md
MCP 接入	references/mcp-setup.md
AOT 编译错误	references/csharp-aot-errors.md
C/C++/Rust/Go 原生 DLL	references/native-abi.md

更新规则

每次修改此技能或其 references / scripts，将 version 字段 +1。