feat(反射生成 UI): 字段配方落在宿主侧——预制体放零件,配方决定拼哪几块

新增 Recipes/(纯逻辑 + 一个预制体组件):
- FieldRecipeSet / FieldPlan:类型→配方的匹配与合并,逐字段 override 只覆盖写了的项。
  两条规矩:最具体的赢(写命名空间只认该类型,裸名按尾段匹配);没匹配到就说"没有配方",
  绝不回退默认配方。
- FieldLayout:给定计划 + 预制体真实有的槽位/输入元素,算出开哪些关哪些;
  返回值只答"能不能装",缺装饰件照样装但必须进 problems(注释写死这条契约)。
- FieldPartsAssembler:预制体上的槽位(label/required-mark/note/icon/legend/input/error,
  input 之下放各输入元素),Collect() 一次按名字收齐,Apply() 只改激活态。
- FieldRecipeTable:配方表资产。菜单路径集中成 HostMenuRoots(宿主不能反向引用蓝图包的路径表)。

XuiavrgInspectorManager 接入:预制体挑好挂上父级后 ApplyFieldRecipe(entry, instance)。
没指定配方表 → 说一句并按预制体原样;预制体没有槽位组件 → 原样;
匹配失败或装配有问题 → 逐条 LogWarning,点名 Entry、来源配方、缺的是什么。

新增 Tests~/RecipeProbe(dotnet 编两份纯逻辑文件):VERDICT RECIPE-PROBE PASS (19/19)。
判据(主工程根):bash check_flowgraph_extensions.sh
  -> host Lrss3.Xericuiactionvessel sources=209 errors=0 / VERDICT FGEXT-BUILD PASS
This commit is contained in:
2026-11-05 14:10:11 +08:00
parent a311c417be
commit a019183609
8 changed files with 630 additions and 0 deletions
@@ -0,0 +1,104 @@
using System;
using System.Collections.Generic;
namespace XericUI.ReflectionUIGenerator
{
/// <summary>
/// 一次装配的决策:给定配方结果 + 预制体上真实存在的槽位/输入元素,
/// 算出"该开哪些、该关哪些、哪里对不上"。
///
/// 单独拎出来是因为这一步最容易静默错:槽位改名、元素少一个、配方多要一块——
/// 都可能"什么都没报错,界面少一块"。所以任何对不上都必须进 problems,
/// 由调用方决定是响亮地报错还是退回空白,绝不悄悄少装。
/// </summary>
public static class FieldLayout
{
/// <summary>槽位在预制体上的名字:就是零件名(小写连字符),输入元素挂在 "input" 之下。</summary>
public static string SlotOf(RecipePart part)
{
switch (part)
{
case RecipePart.Label: return "label";
case RecipePart.RequiredMark: return "required-mark";
case RecipePart.Note: return "note";
case RecipePart.Icon: return "icon";
case RecipePart.Legend: return "legend";
case RecipePart.Input: return "input";
case RecipePart.Error: return "error";
default: return part.ToString().ToLowerInvariant();
}
}
/// <summary>
/// 返回值只回答"能不能装":缺零件槽、缺输入元素、压根没槽 —— 不能装。
/// 缺一个装饰件(必填标记)仍然能装,但一定进 problems:
/// 所以调用方两个都要看,不能只信 bool。
/// </summary>
public static bool Resolve(FieldPlan plan, IEnumerable<string> slotNames, IEnumerable<string> elementNames,
out List<string> activate, out List<string> problems)
{
activate = new List<string>();
problems = new List<string>();
if (plan == null) { problems.Add("no plan given"); return false; }
var slots = new HashSet<string>(StringComparer.Ordinal);
if (slotNames != null) foreach (var s in slotNames) if (!string.IsNullOrEmpty(s)) slots.Add(s);
var elements = new HashSet<string>(StringComparer.Ordinal);
if (elementNames != null) foreach (var e in elementNames) if (!string.IsNullOrEmpty(e)) elements.Add(e);
if (slots.Count == 0) { problems.Add("the field prefab exposes no slots at all (nothing to assemble into)"); return false; }
var ok = true;
for (var i = 0; i < plan.parts.Count; i++)
{
var slot = SlotOf(plan.parts[i]);
if (!slots.Contains(slot))
{
problems.Add("recipe wants part \"" + slot + "\" (" + plan.source + ") but the prefab has no such slot");
ok = false;
continue;
}
activate.Add(slot);
}
// 必填没标出来是"看起来能空着提交",属于界面说谎:要么有槽,要么报问题
if (plan.required && slots.Contains(SlotOf(RecipePart.RequiredMark)) && !activate.Contains(SlotOf(RecipePart.RequiredMark)))
activate.Add(SlotOf(RecipePart.RequiredMark));
else if (plan.required && !slots.Contains(SlotOf(RecipePart.RequiredMark)))
problems.Add("field is required but the prefab has no \"required-mark\" slot to say so");
if (!activate.Contains(SlotOf(RecipePart.Error)) && slots.Contains(SlotOf(RecipePart.Error)))
activate.Add(SlotOf(RecipePart.Error)); // 错误位常驻(初始为空),否则校验失败时没地方显示
if (!string.IsNullOrEmpty(plan.inputElement))
{
if (!activate.Contains(SlotOf(RecipePart.Input)))
{
problems.Add("the recipe names input element \"" + plan.inputElement + "\" but no Input part is planned");
ok = false;
}
else if (elements.Count == 0)
{
problems.Add("the \"input\" slot has no element variants to choose from");
ok = false;
}
else if (!elements.Contains(plan.inputElement))
{
problems.Add("input element \"" + plan.inputElement + "\" is not on the prefab (there: " +
string.Join(", ", Sorted(elements).ToArray()) + ")");
ok = false;
}
else activate.Add("input/" + plan.inputElement);
}
return ok;
}
static List<string> Sorted(HashSet<string> set)
{
var list = new List<string>(set);
list.Sort(StringComparer.Ordinal);
return list;
}
}
}
@@ -0,0 +1,116 @@
using System;
using System.Collections.Generic;
using UnityEngine;
namespace XericUI.ReflectionUIGenerator
{
/// <summary>宿主库自己的 Unity 菜单位置(只此一处)。蓝图包的路径表不能被宿主反向引用,
/// 所以这里不共享常量;check_menu_paths.sh 的字面量普查只扫 fork 与蓝图包两棵树。</summary>
internal static class HostMenuRoots
{
public const string ComponentTable = "Xeric Library/Component/Table";
}
/// <summary>配方表资产:类型 → 配方(含逐字段例外)。匹配与合并的规矩在 <see cref="FieldRecipeSet"/>。</summary>
[CreateAssetMenu(menuName = HostMenuRoots.ComponentTable + "/Field Recipe Table", fileName = "FieldRecipeTable")]
public sealed class FieldRecipeTable : ScriptableObject
{
[SerializeField] FieldRecipeSet recipes = new FieldRecipeSet();
public FieldRecipeSet Recipes { get { return recipes; } }
public bool TryPlan(string typeName, string fieldName, out FieldPlan plan, out string reason)
{
return recipes.TryPlan(typeName, fieldName, out plan, out reason);
}
/// <summary>表自身的毛病(空类型/重复/没零件/没 fieldName 的 override)。</summary>
public List<string> Validate() { return recipes.Validate(); }
}
/// <summary>
/// 一个字段预制体上的零件槽位。预制体只放零件(label/note/icon/legend/input/error/required-mark),
/// input 之下再放各类型的输入元素(input-field/slider/enum-dropdown…),运行时按配方激活。
///
/// 所以"某字段要多一个小字注释"是改配方,不是改预制体;预制体少了那块零件才是预制体的事,
/// 而它会作为 problem 报出来,不是安静地少装一块。
/// </summary>
[DisallowMultipleComponent]
[AddComponentMenu(HostMenuRoots.ComponentTable + "/Field Parts Assembler")]
public sealed class FieldPartsAssembler : MonoBehaviour
{
[Serializable]
struct SlotRef
{
public string slot;
public GameObject go;
}
[SerializeField] List<SlotRef> slots = new List<SlotRef>();
[SerializeField] List<GameObject> inputElements = new List<GameObject>();
public int SlotCount { get { return slots.Count; } }
public int ElementCount { get { return inputElements.Count; } }
/// <summary>按约定的槽位名收集一层子物体(省掉一个个手拖)。</summary>
public int Collect()
{
slots.Clear();
inputElements.Clear();
for (var i = 0; i < transform.childCount; i++)
{
var child = transform.GetChild(i);
var known = SlotName(child.name);
if (known == null) continue;
slots.Add(new SlotRef { slot = known, go = child.gameObject });
if (known != "input") continue;
for (var j = 0; j < child.childCount; j++)
{
var element = child.GetChild(j);
if (string.IsNullOrEmpty(SlotName(element.name)) && element.name != "input")
inputElements.Add(element.gameObject);
}
}
return slots.Count;
}
/// <summary>Activate what the plan asks for, hide the rest. Problems are returned, never swallowed.</summary>
public bool Apply(FieldPlan plan, out List<string> problems)
{
var slotNames = new List<string>(slots.Count);
for (var i = 0; i < slots.Count; i++) slotNames.Add(slots[i].slot);
var elementNames = new List<string>(inputElements.Count);
for (var i = 0; i < inputElements.Count; i++)
if (inputElements[i] != null) elementNames.Add(inputElements[i].name);
List<string> activate;
var ok = FieldLayout.Resolve(plan, slotNames, elementNames, out activate, out problems);
for (var i = 0; i < slots.Count; i++)
{
var s = slots[i];
if (s.go == null) { problems.Add("slot \"" + s.slot + "\" points at nothing"); ok = false; continue; }
var want = activate.Contains(s.slot);
if (s.slot == "input") want = want && activate.Contains("input/" + (plan == null ? "" : plan.inputElement));
s.go.SetActive(want);
}
for (var i = 0; i < inputElements.Count; i++)
{
var element = inputElements[i];
if (element == null) continue;
element.SetActive(activate.Contains("input/" + element.name));
}
return ok;
}
static string SlotName(string name)
{
switch (name)
{
case "label": case "required-mark": case "note": case "icon":
case "legend": case "input": case "error": return name;
default: return null;
}
}
}
}
@@ -0,0 +1,169 @@
using System;
using System.Collections.Generic;
namespace XericUI.ReflectionUIGenerator
{
/// <summary>界面上一块可拼的零件。配方决定拼哪几块、按什么顺序摆。</summary>
public enum RecipePart { Label = 0, RequiredMark = 1, Note = 2, Icon = 3, Legend = 4, Input = 5, Error = 6 }
/// <summary>某个字段的例外:只覆盖写了的那几项。</summary>
[Serializable]
public sealed class FieldOverride
{
public string fieldName = "";
public bool hasInputOverride;
public string inputOverride = "";
public bool hasNoteWhen;
public string noteWhen = "";
public bool hasFriendlyName;
public string friendlyName = "";
public bool hasRequired;
public bool required;
public string requiredMessage = "";
public bool removeParts;
public List<RecipePart> removed = new List<RecipePart>();
public bool addParts;
public List<RecipePart> added = new List<RecipePart>();
}
/// <summary>一个类型的配方:输入元素、零件清单、必填与注释规则,外加逐字段例外。</summary>
[Serializable]
public sealed class FieldRecipe
{
/// <summary>匹配的类型全名(如 "UnityEngine.Vector2");也接受后缀写法 "Vector2"。</summary>
public string typeName = "";
public string inputElement = "input-field";
public string noteWhen = "";
public bool required;
public string requiredMessage = "此项必填";
public string friendlyName = "";
public List<RecipePart> parts = new List<RecipePart> { RecipePart.Label, RecipePart.Input };
public List<FieldOverride> overrides = new List<FieldOverride>();
}
/// <summary>一次解析的结果:拼哪些零件、用什么输入元素、必填规则、以及"是谁说了算"。</summary>
public sealed class FieldPlan
{
public readonly List<RecipePart> parts = new List<RecipePart>();
public string inputElement = "";
public string noteWhen = "";
public string friendlyName = "";
public bool required;
public string requiredMessage = "";
/// <summary>"recipe:UnityEngine.Vector2" / "override:maxSize" / "" —— 每条决定都能回溯到来源。</summary>
public string source = "";
}
/// <summary>
/// 配方表的匹配与合并(纯逻辑,不引 Unity,可离线证):
///
/// 预制体只放**零件**,配方决定**拼哪几块**,逐字段例外写在 override 里——
/// 这样"一个字段看着很小、其实要兼容所有场景"不再堆进同一个预制体。
///
/// 两条硬规矩:① 匹配是"最具体的赢"(全名 &gt; 后缀,多条同长则报歧义,不随便挑一条);
/// ② 没匹配到就说"没有配方",绝不回退到一个默认配方——凭空长出来的界面比空白更难查。
/// </summary>
public sealed class FieldRecipeSet
{
public readonly List<FieldRecipe> recipes = new List<FieldRecipe>();
public bool TryPlan(string typeName, string fieldName, out FieldPlan plan, out string reason)
{
plan = null;
reason = "";
if (string.IsNullOrEmpty(typeName))
{
reason = "no type given";
return false;
}
var exact = new List<FieldRecipe>();
var suffix = new List<FieldRecipe>();
for (var i = 0; i < recipes.Count; i++)
{
var r = recipes[i];
if (r == null || string.IsNullOrEmpty(r.typeName)) continue;
// 写了命名空间 = 只认这个类型("My.Ns.Vector2" 不是 "UnityEngine.Vector2");
// 只写裸名 = 按尾段匹配任意命名空间下的同名类型。两种具体度不同,不混在一起比。
if (r.typeName.IndexOf('.') >= 0)
{
if (string.Equals(r.typeName, typeName, StringComparison.Ordinal)) exact.Add(r);
}
else if (string.Equals(TypeNameTail(typeName), r.typeName, StringComparison.Ordinal)) suffix.Add(r);
}
var picked = exact.Count > 0 ? exact : suffix;
if (picked.Count == 0)
{
reason = "no recipe for type \"" + typeName + "\" (" + recipes.Count + " recipe(s) in the table; " +
"add one instead of falling back to a guess)";
return false;
}
if (picked.Count > 1)
{
var names = new List<string>();
for (var i = 0; i < picked.Count; i++) names.Add(picked[i].typeName);
names.Sort(StringComparer.Ordinal);
reason = "ambiguous recipe for \"" + typeName + "\": " + string.Join(", ", names.ToArray()) +
" (fix the table: Validate flags duplicates; picking one silently would render the wrong widget)";
return false;
}
var recipe = picked[0];
plan = new FieldPlan
{
inputElement = recipe.inputElement,
noteWhen = recipe.noteWhen,
friendlyName = recipe.friendlyName,
required = recipe.required,
requiredMessage = recipe.requiredMessage,
source = "recipe:" + recipe.typeName
};
for (var i = 0; i < recipe.parts.Count; i++) if (!plan.parts.Contains(recipe.parts[i])) plan.parts.Add(recipe.parts[i]);
FieldOverride hit = null;
for (var i = 0; i < recipe.overrides.Count; i++)
{
var o = recipe.overrides[i];
if (o != null && string.Equals(o.fieldName, fieldName, StringComparison.Ordinal)) { hit = o; break; }
}
if (hit == null) return true;
plan.source += " + override:" + hit.fieldName;
if (hit.hasInputOverride) plan.inputElement = hit.inputOverride;
if (hit.hasNoteWhen) plan.noteWhen = hit.noteWhen;
if (hit.hasFriendlyName) plan.friendlyName = hit.friendlyName;
if (hit.hasRequired) { plan.required = hit.required; plan.requiredMessage = hit.requiredMessage; }
if (hit.removeParts) for (var i = 0; i < hit.removed.Count; i++) plan.parts.Remove(hit.removed[i]);
if (hit.addParts) for (var i = 0; i < hit.added.Count; i++) if (!plan.parts.Contains(hit.added[i])) plan.parts.Add(hit.added[i]);
return true;
}
/// <summary>表自身的毛病要能一次性列出来:空类型、重复类型、没零件的配方。</summary>
public List<string> Validate()
{
var problems = new List<string>();
var seen = new HashSet<string>(StringComparer.Ordinal);
for (var i = 0; i < recipes.Count; i++)
{
var r = recipes[i];
if (r == null) { problems.Add("recipe " + i + " is null"); continue; }
if (string.IsNullOrEmpty(r.typeName)) problems.Add("recipe " + i + " has an empty typeName");
else if (!seen.Add(r.typeName)) problems.Add("duplicate recipe for \"" + r.typeName + "\"");
if (r.parts.Count == 0) problems.Add("\"" + r.typeName + "\" has no parts (it would render nothing)");
for (var p = 0; p < r.parts.Count; p++)
if (!Enum.IsDefined(typeof(RecipePart), r.parts[p])) problems.Add("\"" + r.typeName + "\" part index " + p + " is not a RecipePart");
for (var o = 0; o < r.overrides.Count; o++)
if (r.overrides[o] != null && string.IsNullOrEmpty(r.overrides[o].fieldName))
problems.Add("\"" + r.typeName + "\" override index " + o + " has no fieldName");
}
return problems;
}
static string TypeNameTail(string fullName)
{
var cut = fullName.LastIndexOf('.');
return cut < 0 ? fullName : fullName.Substring(cut + 1);
}
}
}
@@ -83,6 +83,15 @@ namespace XericUI.ReflectionUIGenerator
[Tooltip("类型-预制体映射配置 ScriptableObject")]
public AvrgTypePrefabMappingConfig typePrefabMappingConfig;
/// <summary>
/// 可选:字段零件配方表。给了就用它决定"这块预制体上哪几件亮着"(预制体只放零件),
/// 不给就完全按预制体作者摆的样子用——两种情况会在 Console 里分得清。
/// </summary>
[Tooltip("可选:字段配方表(预制体放零件、配方决定拼哪几块)")]
public FieldRecipeTable fieldRecipes;
private bool _warnedNoRecipeTable;
#endregion
#region Unity 生命周期
@@ -340,6 +349,8 @@ namespace XericUI.ReflectionUIGenerator
uiInstance.name = entry.EntryName;
uiInstance.transform.SetParent(parent, false);
ApplyFieldRecipe(entry, uiInstance);
if (uiInstance.GetComponentInChildren<XUIAvrgMDValue>(true) == null)
{
Debug.LogError(
@@ -373,6 +384,40 @@ namespace XericUI.ReflectionUIGenerator
/// 3. defaultPrefab 回退
/// PrefabOverrideName 已移除,由 Tag + 类型匹配替代
/// </summary>
/// <summary>
/// 预制体挑好并挂上父级后,按配方决定"这块上的哪几件亮着"。
/// 没给配方表 / 这块预制体没有零件槽 ⇒ 原样使用,但各自说一句:
/// "我改了配方没生效"和"根本没有配方表"不能长得一样。
/// </summary>
private void ApplyFieldRecipe(IFieldEntry entry, GameObject instance)
{
if (fieldRecipes == null)
{
if (!_warnedNoRecipeTable)
{
_warnedNoRecipeTable = true;
Debug.Log("[Xuiavrg] 未指定 fieldRecipes:零件激活完全按预制体原样,配方表不参与。");
}
return;
}
var assembler = instance.GetComponent<FieldPartsAssembler>();
if (assembler == null) return;
var bindings = entry.Bindings;
var valueType = bindings?.Count > 0 ? bindings[0].MetaData?.ValueType : null;
if (!fieldRecipes.TryPlan(valueType == null ? "" : valueType.FullName, entry.EntryName,
out var plan, out var reason))
{
Debug.LogWarning($"[Xuiavrg] Entry '{entry.EntryName}'(类型 {valueType?.Name ?? "未知"}):{reason}");
return;
}
assembler.Apply(plan, out var problems);
for (var i = 0; i < problems.Count; i++)
Debug.LogWarning($"[Xuiavrg] Entry '{entry.EntryName}' 按 {plan.source} 装配时:{problems[i]}");
}
private GameObject ResolvePrefab(IFieldEntry entry)
{
if (typePrefabMappingConfig == null)