测试插件

Hosihikari.Testing 是面向插件作者的测试包，面向 1.1.0 功能线：引用 Hosihikari.Plugin.Abstractions 1.1.0 与 Hosihikari.PluginManager 1.1.0。测试包自身的版本为 1.0.0。

dotnet add package Hosihikari.Testing --version 1.0.0

生命周期宿主

PluginTestHost 直接驱动四个公开钩子。它不启动 BDS、不读清单，也不创建程序集装载上下文。

using Hosihikari;
using Hosihikari.Testing;

public sealed class MyPlugin : IPlugin
{
    public void OnLoad(IPluginContext context) { }
    public PluginHookResult OnEnable() => PluginHookResult.Allow();
    public PluginHookResult OnDisable() => PluginHookResult.Allow();
    public void OnUnload() { }
}

using var host = new PluginTestHost(new MyPlugin());
host.RunLifecycle();

// host.HookLog: load → enable → disable → unload

测试上下文给出与生产同形的服务：

Events —— 同步事件总线；handler 异常收进 TestEvents.HandlerErrors。
Scheduler —— 手动调度器；自己调用 TestScheduler.RunOnce() 或 RunPeriodic()。
PluginServices —— 内存服务注册表；同类型先到先得。
Faults —— 通过 IPluginContext.ReportFault 报上来的原因。
Logger、Configuration、CarrierServices 都可以替换。

宿主复刻生产作用域：事件与定时器回调只在启用期间投递，Unload 收回订阅、定时器与服务。直接调用 Unload 时也会先关闭闸门，再调 OnUnload。

真实管理器辅助

PluginManagerHarness 创建临时的 plugins/、data/、config/ 根，并暴露真实的 PluginManager。测试需要发现、依赖排序、加载器或卸载验证时用它。

using Hosihikari.Testing;

using var harness = new PluginManagerHarness();
harness.CreatePackage("MyPlugin", manifestJson, ("main.cs", source));
harness.Manager.RegisterLoader(new MyLoader());

harness.Load("MyPlugin");
harness.Manager.Enable("MyPlugin");
harness.Manager.Unload("MyPlugin");

CreatePackage 把清单与可选文件写到 plugins/<name>/；越出临时根的包名会被拒绝。管理器的报告与 “已移除”回调分别从 Reports 与 Removed 读取。

边界

测试包不模拟载体、BDS 世界 API 或本机库生命周期；这些都在框架契约之外。真实服务端请走各载体的冒烟路径，并参考常见问题。