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

在核心类型、图执行器、stdio 插件和前端入口写清职责与对照路径，不改运行行为。

MAF1.Web/Web/AgentCatalog.cs

@@ -2,6 +2,7 @@ using MAF1.PluginContract;
 
 namespace MAF1.Web;
 
+/// <summary>画布上一个端口的元数据，前端用来渲染圆点和检查器文案。</summary>
 public sealed class PortInfo
 {
     public string Name { get; init; } = "";
@@ -10,6 +11,9 @@ public sealed class PortInfo
     public bool Required { get; init; }
 }
 
+/// <summary>
+/// 一种可放到画布上的节点类型。Origin=system 走进程内 Handler；Origin=plugin 走独立进程。
+/// </summary>
 public sealed class AgentTypeInfo
 {
     public string Type { get; init; } = "";
@@ -30,6 +34,7 @@ public sealed class AgentTypeInfo
     public IReadOnlyList<PluginCredentialNeed> Credentials { get; init; } = [];
 }
 
+/// <summary>系统节点绑定到哪个 C# 实现。插件节点 Handler 保持 None。</summary>
 public enum SystemHandler
 {
     None = 0,
@@ -37,6 +42,9 @@ public enum SystemHandler
     Weather,
 }
 
+/// <summary>
+/// 写死在宿主里的两种系统节点。插件 id 若与 Type 冲突，运行时优先插件进程。
+/// </summary>
 public static class AgentCatalog
 {
     public static AgentTypeInfo? FindSystem(string type)