docs: 为 CLI、网页编排器和插件协议补充学习向注释

在核心类型、图执行器、stdio 插件和前端入口写清职责与对照路径,不改运行行为。
This commit is contained in:
2026-08-28 11:51:48 +08:00
parent a3cca78592
commit 950d09ddb0
38 changed files with 206 additions and 3 deletions
+3
View File
@@ -2,6 +2,7 @@ using Microsoft.Extensions.Configuration;
namespace MAF1.Plugins;
/// <summary>Plugins:Directory 相对网页 exe,不是源码树里的 plugins/ 文件夹。</summary>
public sealed class PluginOptions
{
public string Directory { get; set; } = "plugins";
@@ -21,6 +22,7 @@ public sealed class PluginOptions
=> config.GetSection("Plugins").Get<PluginOptions>() ?? new PluginOptions();
}
/// <summary>扫描成功后的一个插件:目录 + 已解析的 plugin.json。</summary>
public sealed class LoadedPlugin
{
public required string FolderName { get; init; }
@@ -28,6 +30,7 @@ public sealed class LoadedPlugin
public required PluginContract.PluginManifest Manifest { get; init; }
}
/// <summary>扫描问题,前端左侧「扫描说明」会显示。error 的插件不会进画布。</summary>
public sealed class CatalogIssue
{
public string Level { get; init; } = "error";