模板

每个模板都是一个完整的插件包。复制到服务端 plugins/<名称>/，改 manifest.json 的 name 与同名 .conf；目录名必须与清单 name 一致。模板为 MIT-0；Hosihikari.Plugin.Abstractions 1.0.0 及之后为 MIT。

预编译程序集

插件管理器内置的程序集入口加载 .NET 类库，不需要安装加载器包。

dotnet new install Hosihikari.Plugin.Templates
dotnet new hosihikari-plugin -n MyPlugin          # C#
# 或
dotnet new hosihikari-plugin-fsharp -n MyPlugin   # F#

用 Hosihikari.Plugin.Build 构建打包，不需要框架检出：

cd MyPlugin
dotnet add package Hosihikari.Plugin.Build --version 1.0.0
dotnet build -t:PackPlugin

目标会把包写到 dist/MyPlugin/；多目标项目要带 -f <tfm>。测试包见 测试插件，模板说明见 模板说明。

C# 与 F# 源码

C# 与 F# 加载器在装载时编译源码；包里放源码，没有构建产物。

模板	加载器	安装
CSharpPluginTemplate	hosihikari-csharp	lip install github.com/HosihikariFramework/CSharpLoader
FSharpPluginTemplate	hosihikari-fsharp	lip install github.com/HosihikariFramework/FSharpLoader

CSharpPluginTemplate 演示 #:package 与 #:include；先跑它的 pack.ps1 或 pack.sh， 再把 dist/MyCSharpPlugin/ 复制到 plugins/。FSharpPluginTemplate 演示 #load，直接复制仓库 到 plugins/MyFSharpPlugin/。改名后重启。契约见 C# 插件。

进程外运行时

RpcLoader 启动清单 extraInfo.command 里的命令，通过 stdio 走 JSON-RPC。下面每个目录都是 完整插件包；绑定拷自加载器，升级加载器时同步更新。

模板	运行时	构建
Node.js/TypeScript	Node.js 20+	npm install && npm run build
Python	Python 3.8+	无
Kotlin/JVM	JDK 21+	./build.sh（Windows 用 build.ps1）

在 PATH 上准备运行时与 RpcLoader，把目录复制到 plugins/ 后重启。Python 清单使用 python3，Windows 上改成 python。协议与上下文见进程外插件。

怎么选

• 预编译程序集：多文件项目、NuGet 依赖，以及以 DLL 形式交付的代码。
• C# 或 F# 源码：由加载器在装载时编译的小型插件，包括用 #:include 组织多文件、用 #:package 在打包期还原依赖的 C# 插件。
• RPC：Node.js、Python、Kotlin 插件，以及适合在服务器进程外运行的工作。