refactor(注册路径): 按界面拆两套根,插入插件层 Action Vessel

工具栏、Hierarchy 右键、Project 右键以前共用一个 Root,所以"XericLibrary/Table/Table
Config"这种建资产项挂在工具栏那一侧的根下,且族名直接顶在根上、看不出是哪个插件。
现在 MenuBarRoot=XericLibrary/Action Vessel(不带空格,只有真挂菜单项的族另配 *Bar),
ContextRoot=Xeric Library/Action Vessel(带空格,Add Component / Project 建资产 /
GameObject 创建共用)。族常量归上下文侧,58 处 AddComponentMenu 与 4 处 CreateAssetMenu
只改表就跟着走;调用点只动 3 处工具栏项(XChart 数据窗口从 Tools/ 收进来、表格编辑器
覆盖层开关、图片场景变形手柄开关——最后一处还没入库,改动留在工作区)。

门:两装配工作区离线编 errors=0;逐路径核对器 103 处 → 87 条折叠路径,逐条在承载它的
dll 里点名到。scratch 树编译对照:本笔的树与 013147e 同样是 2 处旧红(XericInfiniteVesselBase
的 using XericLibrary.Runtime.Type 已失效、XChartFaceFrame 引用的 XericQuadProjection
只存在于未入库的 XericImageDeform.cs),本笔没新增错误。
This commit is contained in:
2026-10-30 13:07:47 +08:00
parent 4e760d59d1
commit f6de064707
4 changed files with 49 additions and 25 deletions
+45 -23
View File
@@ -5,53 +5,75 @@ namespace XericUI.Core
///
/// <para><b>为什么要有它</b>:路径以前散落在各文件的字面量里(<c>"Xeric UI Vessel/…"</c>、
/// <c>"Xeric/XChart/…"</c>、<c>"XericLibrary/…"</c> 三套风格并存),改名要满地找。
/// 现在统一成"<b>{根}/{产品族}/{产品名}</b>",注册时只用 族常量 + 自己的名字。</para>
/// 现在注册时只用 族常量 + 自己的名字。</para>
///
/// <para><b>两套根只差一个空格</b>(<see cref="MenuBarRoot"/> / <see cref="ContextRoot"/>):</para>
/// <list type="bullet">
/// <item>顶部菜单栏(<c>[MenuItem]</c>)走 <c>XericLibrary/Action Vessel/…</c>,
/// 品牌根 <b>不带空格</b>;族常量名后面加 <c>Bar</c>(<see cref="ChartBar"/> 等),
/// 只有真挂了菜单项的族才有。</item>
/// <item>Hierarchy(<c>GameObject/…</c>)、Project(<c>CreateAssetMenu</c> 的 menuName)、
/// Add Component(<c>AddComponentMenu</c>)三个右键上下文面共用
/// <c>Xeric Library/Action Vessel/…</c>,即不带后缀的族常量本身。</item>
/// </list>
///
/// <para><b>用法(属性参数必须是编译期常量,所以这里全是 const,靠拼接成串)</b></para>
/// <code>
/// // 组件菜单(Component 菜单下,不需要 "Component/" 前缀)
/// // 组件菜单(Add Component 下,Unity 自己加 Component/ 前缀)
/// [AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Cube Mesh Background Tool")]
///
/// // 菜单栏
/// [MenuItem(XericRegistrationPaths.Chart + "/重新投影")]
/// // Project 右键建资产(menuName 是相对 Assets/Create 的路径)
/// [CreateAssetMenu(menuName = XericRegistrationPaths.Table + "/Table Config")]
///
/// // GameObject > … 创建菜单
/// // 顶部菜单栏
/// [MenuItem(XericRegistrationPaths.TableBar + "/Table Editor Override Layer")]
///
/// // GameObject &gt; … 创建菜单(Hierarchy 右键)
/// [MenuItem(XericRegistrationPaths.ChartCreate + "/Scatter Chart", false, 12)]
///
/// // 组件上下文菜单(CONTEXT/&lt;组件类型&gt;/… 的前缀是绑定键,不能加根)
/// [MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Xeric Image", true)]
/// </code>
///
/// <para><b>新加产品时</b>:先用 <see cref="Root"/> + 你自己的族名拼一个族常量放在这里,
/// 再去调用点用"族常量 + 产品名"。不要在任何别的地方写死路径字面量。</para>
/// <para><b>新加产品时</b>:先用 <see cref="ContextRoot"/> + 你的族名拼一个族常量放在这里
/// (只有需要在顶部菜单栏挂项的族才另配一个 <c>*Bar</c>),再去调用点用"族常量 + 产品名"。
/// 不要在任何别的地方写死路径字面量。</para>
/// </summary>
public static class XericRegistrationPaths
{
/// <summary>
/// 总根:所有注册路径的公共前缀。<b>不带空格</b>("XericLibrary",不是 "Xeric Library")——
/// 他 2026-10-26 点名"Xeric Library"是错的:菜单路径是给人敲/看的一串标识,空格会把
/// 它切成分层看得见的两段,也让"搜 XericLibrary"漏掉一半。
/// </summary>
public const string Root = "XericLibrary";
/// <summary> 顶部菜单栏根:品牌根不带空格 </summary>
public const string MenuBarRoot = "XericLibrary/Action Vessel";
// ── 产品族(菜单栏与组件菜单共用同一套前缀) ──────────────
/// <summary> Hierarchy / Project / Add Component 共用根:品牌根带空格 </summary>
public const string ContextRoot = "Xeric Library/Action Vessel";
// ── 上下文侧族常量(AddComponentMenu 与 CreateAssetMenu 用;GameObject 创建菜单也从这里长) ──
/// <summary>图表族(Chart / Line / Radar / Mesh / Pseudo3D …)</summary>
public const string Chart = Root + "/Chart";
public const string Chart = ContextRoot + "/Chart";
/// <summary>表格族</summary>
public const string Table = Root + "/Table";
public const string Table = ContextRoot + "/Table";
/// <summary>通用 UI 组件族(Image / Button / Toggle / Style* / Values …)</summary>
public const string UI = Root + "/UI";
public const string UI = ContextRoot + "/UI";
/// <summary>布局族</summary>
public const string Layout = Root + "/Layout";
public const string Layout = ContextRoot + "/Layout";
/// <summary>窗口(Form)族</summary>
public const string Form = Root + "/Form";
public const string Form = ContextRoot + "/Form";
/// <summary>翻页族</summary>
public const string FlipPage = Root + "/FlipPage";
public const string FlipPage = ContextRoot + "/FlipPage";
/// <summary>锚点窗口族</summary>
public const string AnchorWindow = Root + "/AnchorWindow";
public const string AnchorWindow = ContextRoot + "/AnchorWindow";
// ── 其它菜单前缀 ──────────────────────────────────────────
// ── 菜单栏侧(只给真挂了 [MenuItem] 的族) ────────────────
/// <summary> 图表族的工具栏入口(数据窗口等) </summary>
public const string ChartBar = MenuBarRoot + "/Chart";
/// <summary> 表格族的工具栏入口(编辑器覆盖层开关) </summary>
public const string TableBar = MenuBarRoot + "/Table";
/// <summary> 通用 UI 族的工具栏入口(场景变形手柄开关) </summary>
public const string UIBar = MenuBarRoot + "/UI";
// ── Hierarchy 创建菜单 ────────────────────────────────────
/// <summary>GameObject 菜单前缀:创建类菜单必须从这里开始</summary>
public const string CreatePrefix = "GameObject/";
@@ -64,4 +86,4 @@ namespace XericUI.Core
/// <summary>组件上下文菜单前缀(后接 组件类型/叶子,例如 "Image/Replace To/Xeric Image")</summary>
public const string ContextPrefix = "CONTEXT/";
}
}
}