native

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

Plugin Development Native

Flow

1. setup-dev-environment.ps1。
2. create-native-plugin.ps1。
3. 有外部包时切到 packages 子技能。
4. 按 architecture 子技能约束实现。
5. dotnet build。
6. 运行 Debug Console，通过 Native Debugger REPL 逐个验证工具。
7. publish-native-plugin.ps1；需要安装包时加 -CreateZip。
8. 运行时安装切到 publish-install 子技能。

Rules

• 只能有一个 PluginAttribute 入口。
• Startup 只注册依赖。
• Tool 参数只用支持的基础类型。
• 自定义返回模型必须进入 PluginJsonContext。
• 后台任务用 IHostedService。
• 发布前必须通过 Native Debugger 本地调试；调试通过不等于 AOT 发布通过，仍需执行发布脚本验证 AOT。

Native Debugger

C# Native 插件使用 Netor.Cortana.Plugin.Native.Debugger 调试。脚手架会生成 Debug\{PluginName}.Debug.csproj，该项目引用插件项目和 Debugger 包。

调试命令：

dotnet build
dotnet run --project Debug\PluginName.Debug.csproj

调试入口固定使用：

using Netor.Cortana.Plugin.Native.Debugger;
using PluginName;

await PluginDebugRunner.RunAsync(typeof(Startup).Assembly, options =>
{
	options.DataDirectory = Path.Combine(AppContext.BaseDirectory, ".debug_data");
	options.WorkspaceDirectory = Path.Combine(AppContext.BaseDirectory, ".debug_workspace");
	options.PluginDirectory = AppContext.BaseDirectory;
	options.WsPort = 9090;
});

进入 REPL 后：

• help 查看工具列表。
• <工具名> help 查看参数。
• <工具名> 进入交互式参数输入。
• <工具名> --name value 使用命名参数。
• <工具名> {"name":"value"} 使用 JSON 参数；单参数 DTO 最稳定。
• exit 退出。

最低调试要求：

1. dotnet build 成功。
2. Debug Console 能启动并发现唯一 [Plugin]。
3. REPL 能列出所有 [Tool]。
4. 每个 [Tool] 至少调用一次成功路径。
5. 有输入约束的工具至少补一条边界值或失败路径。
6. 依赖 DI 的工具必须确认服务能正常解析。
7. 使用 DataDirectory / WorkspaceDirectory 的工具必须确认 .debug_data / .debug_workspace 行为正确。
8. 注册 IHostedService 时必须确认启动和退出没有异常。

注意：Native Debugger 调试的是开发态托管程序集。最终发布仍走 PublishAot=true 和 publish-native-plugin.ps1，不要用 Debug Console 产物替代发布产物。

Scripts

• scripts/setup-dev-environment.ps1
• scripts/create-native-plugin.ps1
• scripts/publish-native-plugin.ps1

Resources

• resources/layout.md