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

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

MAF1.Core/Agents/FileCity/CityExtraction.cs

@@ -2,6 +2,9 @@ using System.Text.Json.Serialization;
 
 namespace MAF1.Agents.FileCity;
 
+/// <summary>
+/// FileCity Agent 约定输出的 JSON 形状。hasValidCities 会驱动边条件，也会触发「缺城市时等人确认」。
+/// </summary>
 public sealed class CityExtraction
 {
     [JsonPropertyName("hasValidCities")]