Files
XericUIActionVessel/CHANGELOG.md
T
lrss3 d60d204ec1 XChart P24:方向来源四档、头的尺寸吃投影、锚点字段(规范 §30)
他这轮给了三条,我先只回答"是不是真的",再动手。

1) "矢量被归一化到屏幕空间再算了"——是真的,而且成因在库那一行:
   CurveMeshGenerator.cs:150   pos += tangent * arrow.width * 0.5f * arrow.depthCompensation
   标记的**方向**跟曲线切线走(对),**尺寸是固定像素**(不是投影结果)。杆随姿态缩短、头不缩 ⇒
   整支读起来就是"屏幕空间里等长的箭头"。修法:新增纯算术 ProjectedScale(投影像素, 立方体长度, CubeToPixel)
   =这条矢量自己的投影比例(平行于屏幕=1、指向屏幕里→0),头的两个尺寸都乘它;连续绘制那一档取
   **这一节自己**的比例,所以弯到背面去的那一节头跟着缩;除不出来(NaN、零长、零比例)就答 0——
   宁可头缩成没有,也不要一个凭空的固定像素尺寸。
2) Absolute 下"方向从哪来"要可选,支数跟着变(他的算术:32 个点两两一组 ⇒ 16 支,而不是现在的 32 支)。
   新增 XChartArrowDirectionSource 四档:NextRecordAsVector(旧 Absolute,N−1)/NextRecordAsPoint
   (旧 Relative,N−1,点到点不用再算一次投影,所以 Tip 只在这一档作差)/ThisRecordCarriesVector
   (同一条记录 0~2 是点、3~5 是方向,N 支、要 6 维)/AlternatingRecords(偶数是点、奇数是方向,N÷2 支)。
   **支数与维数只有 ArrowCount(source,…) 和 RequiredCoordinateDimensions(source) 这一个实现**:
   四档算法在工具里各写一遍,画面上只是"少几支",那是最难查的一类错。
3) 锚点:MarkerAnchor [0,1] → 库的 depthCompensation(anchor×2−1;0=尾部落点、0.5=中心、1=头尖落点=默认),
   非有限退回 1——"头该贴在哪"不该因为一次写坏的值变成位置未知。

另外两条顺手立的规矩:
- **方向是原始矢量,绝不按位置的显示范围折**(TryReadRaw):折一次就把"朝哪"变成"在哪"
  ((0,1,0) 会被折成一个偏移量,整场箭头一起跑偏);尺度交给 DirectionScale。
  顺带:XMeshPreviewChart 那份"一条记录 6 维、方向存 3~5"的旧示例数据在 ThisRecordCarriesVector 下
  正好合法(§28.5 说的"死数据"有了读法)——默认值我没替他改。
- **颜色维撞上方向维**(自带方向那档吃 0~5 六列,颜色起点默认仍是 3):撞了就退回单色并印 colors=overlap,
  不静默把方向当色相读。
- **序列化兼容**:新枚举的 0/1 就是旧 XChartArrowVectorMode 的 Absolute/Relative,字段再加
  [FormerlySerializedAs("m_VectorMode")] ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。

判据:探针 462 项 0 失败(新增 10 条:四档各自支数、维数需求只有自带方向那档要 6、锚点 0/0.5/1→−1/0/+1、
越界夹取与非有限回退、投影比例 1/0.5/指向屏幕=0、坏输入答 0);p4_control 66 支
(新增 3 支:分档按条数算/头无视投影比例/锚点映射写死 0;**删 1 支**——"空表被挡在算术外"那支的守卫
在新算术下已经到不了,**没有靶子的臂不当证据用**);编译门三臂 + 3 对照绿(chain_p24.txt)。

**门自己这轮现了一次瞎,这是本轮最值钱的自证**:`public T X` 与 `{` 分成两行的属性写法**根本没被数到**,
所以总数是 132 而不是 133——而"132/132 VERDICT: PASS"是绿的、却已经不等于"每个旋钮都看得见"
(我这次把 DirectionSource 写成了多行形状,正好撞上)。补 match_head(认得大括号在下一行的声明),
并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 MarkDirty()**,门必须红——
看不见形状的门会放行一个不置脏的旋钮。补完后 knobs=133 takesEffect=133、九支变异全红。

两次 harness 正常工作也记在这里(都是它拒绝,而不是假判):CJK 第三次进了声明 coding: ascii 的脚本
(⇒ 中文只进仓内文档);一支臂的单行锚被我新写的孪生函数撞成 2 命中 ⇒ SETUP FAILED 整轮作废
(锚点加宽成两行块)。

覆盖不到的照旧:头的绝对大小好不好看归他现场判(§30.6 五条:换 AlternatingRecords 应见 16 支、
换 ThisRecordCarriesVector 应见 32 支且 colors=overlap 时把颜色起点调到 6、转立方体时长短不一且
headScale 读数跟着变、拖 MarkerAnchor 头尾互换、以及报表 src= anchor= headScale= 三个新读数)。
P25(自己写简单填充、替掉 chunk 式填充渲染器,顺带解掉 P23)按他的指示排在下一轮。
2026-10-26 17:44:13 +08:00

137 lines
88 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog
## [Unreales]
添加图片组件的四顶点变形(错切 / 倾斜 / 平行四边形 / 伪投影),带场景编辑手柄
添加立方体网格背景元素、元素组件框架、数据访问中转层,以及网格渲染预览图
统一注册路径到 XericRegistrationPaths(根 Xeric Library,产品族 Chart / Table / UI / …)
XChart 基类补全生命周期:集中注册工具、分档初始化、渲染/数据/编辑器重置、无条件强制刷新,并带 ExecuteAlways 让编辑器里直接跑
预制体编辑模式下创建图表会挂进预制体根(原来建在预制体外,退出即丢),且不再自动补 Canvas
立方体背景/线框的姿态改成单个四元数(新增 XChartCubeView,含等距 45° 预设,轮廓为正六边形),尺寸改成半边长口径,旋转不再让立方体越转越小
修复图表基类的"僵尸初始化":脚本重载/重导入后 bool 标记活下来了而工具管理器引用没了,于是自称已初始化、其实一件工具都建不出来,且之后改任何字段都无反应。现在只用工具管理器是否在位来判,复用旧 [XChartTools] 根时会先清掉上个域遗留的孤儿子节点
修复 XPseudo3DScatterChart / XRadarChart 各自声明 private OnValidate 把基类那份遮掉的问题(Unity 按名字只调最派生的一个),改为 override 并回调 base
面板重做(按 Documentation/XChart-RenderFramework.md 的 §0/§4):两个板块「基础 / 工具」,每层是带描边的 box + 可折叠标题;值变化的监听挂在每个字段自己身上而不是面板根(挂根上会把"点标题展开"当成数据修改,Unity 挂起时补发的默认值通知又会把展开状态全打回折叠);展开状态改由活的 Foldout 在重建前抄一次,不再靠事件回写
面板标题去掉括号补充语(13 处),解释一律回到 Tooltip
生成节点默认改为"不显示也不保存"(DontSaveInEditor | HideInHierarchy);新增 chart.RebuildAll()(拆掉全部生成物再走一遍 chart + 每个工具的初始化流程)与 chart.SetGeneratedVisible(bool)(只改可见位、不动保存位);ResetEditorState 并入 RebuildAll
新增 Documentation/XChart-RenderFramework.md:职责划分(chart 管数据、工具只呈现)、可控绘制流程与 IXChartRenderContext、编辑器代码作用域纪律(partial 分文件 + #if UNITY_EDITOR)、面板呈现规范、文本对象池的批量申请与顺位复用调度、生命周期与回收、分期实施与每期判据
规范 §2 第一步:新增 IXChartRenderContext / XChartRenderContext(由 chart 建立并持有),散点、轴线、背景、线框、圆柱、箭头全部不再自己 FindTool 找邻居——空间与数据都从 context 拿,查找路径只剩一条,就不会长出第二套投影。显示范围的判定抽成纯函数 XChartDomainMath(手动优先并自动排序、无手动则回落聚合、全等值时中心展开、NaN 聚合拒绝、两条都没有就不画),XChartToolsManager.DataSource 与 XChartToolBase 的 DataSource/FindTool 由 Context/Data 取代
修"加一个元素后所有元素都不显示":散点在"没有点"时把 null 当清空传给 XScatterPointRenderer.SetPoints,而它第一句就读 positions.Length ⇒ NRE 发生在工具渲染循环里没有隔离,于是排在它后面的工具全被中断。现在 null 在渲染器里就是清空、工具侧改用 ClearAll(),并且更新/渲染循环按工具隔离——一个工具抛异常只报一次带工具名的日志,其余工具继续画
面板 box 补左右上内边距并归零 Foldout 外边距,折叠小三角落进描边框内
修"大分类不能折叠、只有最小分组能折":折叠回调切的是 box 内部的 Body 容器,而大分类的内容当初直接加在了外框上,于是点标题只藏了个空容器。现在 MakeGroup 一次交出 Root(描边+标题,挂到父级 Body)与 Body(放内容),规范 §0.3 记为该做的约定
新增空间元素(基变换的权威):姿态/半边长/尺寸口径/中心偏移收在一处,投影 = 基变换 ∘ 工具变换;背景、线框、散点、轴线、圆柱、箭头都问同一个空间要矩阵,所以点必然落在背景里(离线探针按 750 点 × 6 姿态验证投影片包含性)
散点元素迁到数据源 + 空间:按维度下标读数据、范围取聚合 min/max;XPseudo3DScatterChart 的散点也改成读共享的序列化数据模型,重开预制体数据不再丢
文本槽位池(规范 §5):新增 IXChartSlotFactory / XChartSlotPool(纯托管调度:批量申请只置脏,按申请数从大到小排序,先释放进本帧回收队列,顺位复用优先,池兜底,队列盈余才真正归还,每个 owner 的列表整份换回)与 XChartTextSlotFactory(运行时唯一造 TMP 标签的地方,池根丢失就重建而不抛);chart 的帧序改成 Update(工具算需求并申请)→ DispatchTextPools → RenderAll(落笔),避免"这帧申请、下帧才有件"
渲染工具基类接手槽位列表与申请口径(RequestTextSlots / Texts / TextSlotsPending),具体工具不再自己 new 标签、也不自己维护实例数组;轴线先接入(刻度算在 OnUpdate、落笔在 OnRender,件没补齐就只少画标签、轴线照旧,并保持着脏等下一次调度);雷达原先"按维度 SetActive(false) 隐藏 + 维度数一变就整数组销毁重建"改为"要几个申请几个"——关掉标签就是申请 0 个,件直接回池
新增 P2 判据仪器:pool_family.py 对"自建文本 / 自持文本列表 / 工具侧 FindTool / 消费者自行停用槽位"四项做普查(先用故意违规的夹具证明这四条会红,再在正本上收绿),p2_control.py 用三支变异臂(去掉排序 / 跳过有效性校验 / 顺位复用改成直接问工厂)各自在指定断言上变红;离线探针增至 218 项,正本全绿
面板 box 左内边距定到 16px(折叠小三角是 Foldout 自带 toggle,默认带负缩进,留白不够就压在左描边上——即"box 和折叠按钮冲突"),嵌套层左缩进收到 4px 以免内层标题被推出可读宽度
补上池调度缺的隔离:`DispatchTextPools` 原本裸跑在 `RenderAll` 之前,抛出去就等于整张图这一帧不画("加一个元素后所有元素都不显示"的老形状会因此复活);现在它记账并跳过本轮,工具与调度两侧的异常都能在报表里点名
新增编辑器期自述报表(规范 §6):工程根放 `xchart.dump.on` 就每 0.4 秒把这张图的 Canvas/空间版本/元素表/池计数/每个工具的可见性与兄弟序号/最近一次异常追加进 `xchart.dump.txt`;整份文件在 `#if UNITY_EDITOR` 内,LateUpdate 只按节流做一次 File.Exists
验收发现但本轮未修的四条已记进规范 §8(数据为空时"什么都不画"缺可见提示、轴刻度与网格分格两套口径没对齐、网格值域不可调、面板增删元素后元素行整批消失及其首要嫌疑 `SerializedProperty` 句柄失效)
池的回收补全:`IXChartSlotFactory` 增加 `DestroyAll()`,`XChartSlotPool.Dispose()` 交出列表并把销毁交给认识"件"的实现,`Teardown()` 先拆池再拆工具,并现拆现验——池根挂在 chart 自己下面,`[XChartTools]` 的清理带不走它,不显式拆就是每回收重建一次漏一个 `GeneratedTextPool`(报表打 `POOL-ROOTS-LEAKED`)。离线探针因此从 218 项涨到 223 项,并加了第四支变异臂(Dispose 不交给工厂 ⇒ 指定断言红)
修"加两个同类元素就串台":元素登记名改为按表内出现次序给(`Axis`、`Axis 2`,只由位置决定、不入库),重建与 `ReapplyElements` 都走同一份 ⇒ 第二条轴的字段不再灌进第一条;面板行标题也用它,行和工具终于对得上号
修"增删元素后元素行整批消失":元素表句柄不再在 `CreateInspectorGUI` 里取一次就缓存,改成每次现取(`serializedObject.Update()` 之后旧句柄作废,而作废的 `SerializedProperty` 不报错,只安静地报 `arraySize == 0`);面板同时把自己的读数写进同一份报表 `panel: rows=N table=M`,两边不等就打 `ROWS-DISAGREE`(这条证人的"能红"还要在真编辑器里演一次,见 §8.4)
调试板块加三个按钮:自述报表 开 / 关 / 打开报表文件(开关就是工程根的 `xchart.dump.on`,文件名与 chart 那边共用一份常量,不各写各的字面量)
验收反馈的面板结构整理:分组改成**按标题合并**(`GroupFor`)——派生类自己的 `[Header("数据")]` 与面板手建的"数据"曾经各起一块同名盒;基类的 `[Header("工具管理")]` 改名"调试",那两只开关不再被重复渲染一遍("调试与工具管理是同一份字段、分两个板块的意义何在");`Capacity` 旁边加一句"它只是缓冲上限,改小不会立刻裁剪"
把两个调试开关接通(`m_ShowDebug` → 显示生成节点、`m_HideAllTools` → 隐藏所有工具):这两个字段原先**没有任何读者**,"勾了没反应"就是这么来的;显隐遍历也从"只走两层"改成**按名字认根 + 递归到底**——池根挂在 chart 自己下面(不在 `[XChartTools]` 里),件还在工具的宿主之下,按层数猜就是按了没反应
修域重载漏池根:复用旧 `[XChartTools]` 时只清了它的子节点,上个域留在 chart 自己下面的 `GeneratedTextPool` 没人管,新池再建一个就每重载攒一个(验收现场的同一条判据打到 66 次 `POOL-ROOTS-LEAKED`,他重启 Unity 正好放大);`BuildToolsRoot()` 里先 `PurgeLeftoverPoolRoots()`,修完同一套按钮流程下 66 → 0
报表加 `hideFlags: hidden=N shown=M missing-DontSave=K` 一行当显隐判据的读数(来回切两次 hidden/shown 互换、`missing-DontSave` 必须恒为 0);并做了一次红证演练:临时把证人那行写成错的 rows,现场出现 8 次 `ROWS-DISAGREE`,证明这个读数真的会喊(演完已复原)
验收现场另记一条资产侧现象(规范 §8.6):点重建时 UI Toolkit 文本测量撞上 `m_AtlasTextures` 失效引用;盘上查证默认字体资产 `Assets/Font/OPPO Sans 4.0 SDF.asset` 的第 8 个图集槽是运行时动态图集(`fileID: 0` + `m_AtlasTextureIndex: 6`),域重载后即失效——与"重建"无关,任何一次需要新增字形的文本测量都会撞
显示范围上移到 chart 的维度行(规范 §1):`XChartDimensionDefinition` 增 `OverrideRange`/`ManualRange`/`EffectiveManualRange`(两分量相等=不覆盖)与 `SetRangeOverride`;`IXChartRenderContext.TryResolveDomain` 不再收 manual 参数,改成自己从维度行读——工具连范围都不用传。轴那份 `ManualRange`、散点那份 `RangeX/Y/Z` 与配置里的 `m_ManualRange`/`m_RangeX/Y/Z` 全部删掉,只留"画哪一维"的绑定(2026-10-22 验收时他选的这一支:绑定是"呈现哪一路数据",不是范围)
数据板块改成逐维一行:显示名 / 覆盖开关 / 覆盖范围(min,max)/ 可见,外加一行当前生效范围——"自动值域=该维聚合 a..b"、"覆盖 a..b(自动值域被忽略)"、没有数据时直说"画它的轴这一帧不会出现;勾上覆盖并填两个不同的值就能先摆出来"(规范 §8.1 从此不用猜)
轴元素行下印一句刻度↔分格的算式:"主刻度 K 条 = K−1 段 ⇒ 把立方体网格的分格数设成 K−1 就逐线对上";分格**不派生**(网格线画在几何面上,要派生就得让背景知道"这个面的 s/t 对应哪一维",与 §1 的归属划分正相反),规范 §8.2/8.3 写明这个取舍
报表里轴那一行加 `rangeSource=override[a,b]|aggregate|none`,用它证明"范围确实归数据行"
P4 判据:探针 223 → 231 项(7 条端到端用**发货的** XChartDataModel / XChartRenderContext / XChartDomainMath 跑通维度行→域解析),新增 p4_control.py 三支变异臂(定义层等值规则被删 / 上下文不读行 / 解析器等值守卫被反转)各在指定断言上红;变异臂还照出我自己一条判据原来测的是开关而不是规则(`SetRangeOverride(7,7)` 自己就把开关落了),已按规则真正生效的状态重写
面板加最小数据入口(追加一条 / 生成 32 条示例 / 清空):验收时他问"但是我怎么写数据?没有界面"——数据一直只能脚本喂;完整的虚拟化数据窗口(浏览、导入导出、复制粘贴)仍是原需求里未做的一期
修"维度行的范围数值框看不到":范围那两项原来走 `PropertyField` 的隐式绑定(给不出可见控件),改成显式 `Toggle("覆盖范围")` + `Vector2Field("范围 min / max")`,写入句柄一律现取
修"刻度与网格线两头都对不上"(他验出来的):轴的默认跨度是内缩的 `0.08 .. 0.95`,而网格线铺满整面 `0 .. 1`,改分格数也补不回来。默认改 `0 .. 1`;已存在的元素带着旧值,所以轴元素行会印出"只铺了 8% .. 95% 的面宽"并给一个**铺满整面**按钮(不静默改数据);提示句同时写明前提"铺满整面且范围能被步长整除"。诚实边界:聚合值常常不是好看的数(现场 `-49.936..49.936`),那种范围铺出来的刻度落不到格线上——探针把这条也正面钉住(`grid alignment: a ragged range … cannot land on grid lines`),探针 231 → 235 项,p4_control 加到四支臂(线性参数被改到偏移 ⇒ 对齐断言红)
网格分格数改成按方向(S / T)各一份(0=跟随统一值),算式抽成纯函数 `XChartGridDivisions`(探针钉"沿 S 的格线由 T 的分格数决定"这句最易写反的话),轴元素行按自身走向给出"把哪个方向设成 K-1"并印出当前值;同族里 `ChartToolMeshBg` 仍是一份分格数,规范 §8.2 如实点名(它连边线画法都不同,等它那期)
轴工具把自己持有的起止比例(`span=start..end`)也印进报表:改起点时现场读数从 `0..1` 稳定走到 `0.5..1`,据此排除"值没传到工具";再据"面帧四角恰落在立方体顶点上"这条既有断言与"线框/格线/轴共用同一投影"排除映射——他反馈的"换面后两端仍差一点"归为观感层待重构项(他原话:"你先做完这几个目标"),判据与像素级证人方案写进 §8.2
修"数据入口只有字段名、其他都没有"(他反馈):三个 `FloatField` 换成一个 `Vector3Field`(与已生效的 `Vector2Field` 同族),他确认"三个维度的数据可以正确显示了"
面板同名合并限定在**同一父级内**:两条轴元素的内部标题同名("值域与刻度"/"外观"),跨父级合并会把第二条轴的字段全灌进第一条的盒子里——现场就是"只有第一个 axis 有内容,另一个是空的"
新增文本序列化 `XChartDataText`(导出的文件与复制到剪贴板的文本逐字节同源):行文本而不是 JSON(运行时程序集没有可依赖的 JSON 库,手写解析器等于自己造一个易错的轮子;行文本还能丢进表格软件、逐行 diff、粘贴替换不用转义嵌套);数值按往返精度写并配断言与变异臂(改成 `0.00` 会静默丢精度,图上只表现为"点挪一点点");导入**全有或全无**并指出行号;`double.TryParse("NaN")` 其实成功,所以拒绝来自"值是否有限"这一步
新增数据窗口(UI Toolkit + 行虚拟化):`Tools/XChart/数据窗口` 或面板"基础 → 数据 → 打开数据窗口";只绑定滚进可见范围的行(数据本身仍是内存表,没有分页——窗口里写明这点),顶部自报 `已绑定次数 / 总行数`;导出到剪贴板/文件、从剪贴板替换/追加、从文件导入、清空、灌 10000 条测试数据;替换与清空都先确认**并先把当前数据复制到剪贴板**
探针 239 → 250 项(11 条序列化往返:维度表/覆盖范围/bit 级数值/小数时间戳/空标签/NaN 拒绝/无 DIM/无表头/replace 与 append 两种语义),p4_control 加到六支臂;读数器 `probe_run.py` 修了 py2 打印含中文判据详情时自身崩溃的问题(会把真 FAIL 读成"没跑")
数据窗口加**单元格就地编辑**:时间与数值列是 `TextField`(回车或失焦提交),提交失败(不是数字/数值维越界/时间戳会让表倒序)**明确报因并把该行按模型现况回填**——控件显示与数据不一致比改不动更坏;配套加 `TrySetValue/TrySetTime(out reason)/TrySetLabel` 三个纯函数写入口(改完 `Publish` 让工具重读),探针 +6 条、再加一支"表不再强制时间非递减"的变异臂
修"灌 10000 条没作用"(他现场反馈):`FillWithTestData` 从 t=0 起写,而记录表要求时间非递减 ⇒ **第一条就被拒、一条没进还谎报成功**;改成从现有最后一条接着写,并如实报"接受 N 次写入、行数 X → Y、Capacity 上限是多少"
新增 `DroppedCount`(触顶丢弃的累计条数)并在面板/窗口都印出来:他说"我先把 Capacity 调大,面板里还是 4096 条"——这不是没生效,而是**丢掉的记录已经不在表里,改大容量找不回来**;这条语义现在写在 Capacity 旁边与窗口消息里(探针 259 项,含"改大容量不会让丢弃数变少"与一支"容量上限不再丢记录"的变异臂)
窗口的虚拟化读数(绑定次数/最近绑定行)按他的要求改成**默认收起**("这些数据看看就行了,后续不需要显示"),勾"显示绑定读数"才展开;常驻那一行只留 总行数/维度/缓冲上限/已丢弃
修"玩家编译报 `XericRegistrationPaths` 不存在"(他 2026-10-23 贴的三条):`using XericUI.Core;` 被写在 `#if UNITY_EDITOR` 里,而 `[AddComponentMenu]/[ContextMenu]` 的参数在**玩家编译也要算得出常量** ⇒ 编辑器那套绿、玩家编译 `CS0103`。三处(`BubbleLayout/BubbleLayoutGroup.cs`、`XTable/Rendering/Component/XericUIActionTable.cs` 与 `.Api.cs`)把 using 移出守卫,并清掉 `XericUIActionTable.cs` 里那份重复的守卫内 using
编译门补**玩家臂**(同一份 rsp、同一批源码,只剥掉 `-define:UNITY_EDITOR`):它的上线第一次跑就原样复现了那三条(同文件同行),修完转绿——这类"只在玩家配置报错"的形状以后不用靠人想起来;更窄的守卫(`UNITY_EDITOR_WIN` 里用、`UNITY_EDITOR` 里 using)玩家臂仍看不见,已记在规范 §3 的盲区里
新增轴线元素:宿主面 + 面内方向 + 子区间,线性/对数/指数三种空间,nice-step 与数量级刻度,标签三源(数值直驱含格式串 / 维度显示名 / 自定义)
新增圆柱元素(两端环 + 侧面四边形 + 盖面,面心深度画家序,支持斜圆柱)与向量箭头元素(一条记录 6 维 = 起点 + 方向;杆与头在像素空间量宽度,短向量的头自动钳到 60%)
数据中转接口补 TryGetDimension:轴线标签要读维度的显示名与默认格式化串
圆柱按他的口述重做(规范 §10):旧实现"把两端面的顶点按角度连成一片片四边形"是**所有母线都可见的线框**,不是他说的"视角下的外轮廓包边"。现在外轮廓=两片端面椭圆采样点集的**凸包**(Andrew monotone chain,纯数学),那两条"过圆心的长轴方向连外框"的桥接线就是凸包自动给出的;投影改成**从 2D 算起**——每片端面只投"圆心 + 盘内两根基"(`TryProjectDisc`),正交投影是仿射的 ⇒ 圆的像正好是椭圆,此后采样全在 2D 上做(原来对 48 个点各投一次 3D);填充=同一个凸包多边形(中心扇形提交);新增可选**端面十字**(用 `CrossPoints` 取的 +U/+V/−U/−V 四个**采样顶点**,与实际端面永远对得上,用来表示滚转)与可选**内部母线**(两端对应点相连,默认 0=不画);两端各自可设法线(零向量=沿两端连线),配置同步增删字段
圆柱的离线断言各配能红对照(`p4_control` 扩到 13 支臂):轮廓真子集/侧刃矩形/四点/桥接极值/包住两片/两片面积 ← 臂 I「只保留下凸链」、J「只采一片端面」、L「不取凸包、把采样点全交回去(=他否掉的那种画法)」、M「保留共线点」;十字 ← 臂 K「改成按屏幕轴对齐(滚转丢失)」。探针 266 项正本全绿,门三臂(runtime/player/editor)绿,`pool_family` 与 `p2_control` 四臂绿
"4 点矩形"那条判据我一开始判错了对象(留档在规范 §10):需求说的矩形是对的,但我拿**盘面正对屏幕**(圆盘投影成整圆 ⇒ 轮廓是胶囊 50 点)去验,于是以为期望写错。正解是**端面看到侧刃**(端面平面含视线,椭圆压成线段,两片平行线段的并集才正好 4 角);现在两种姿态都留:正面判"真子集 + 四个极值角 + 面积 ≥ 两片之和",侧刃判"count == 4 且对边两两平行等长"——侧刃姿态还是"单调链必须剔共线点"唯一的可判定形式(该姿态下所有采样点精确共线)
"面积 ≥ 单片端面"那条判据没有能红对照(凸包含住某组点 ⇒ 面积不小于那组点,永远不能红)⇒ 没有能红对照的断言不算门,挪到"两片相距 40"那一对上判"面积 ≥ 两片之和",并配臂 I 证明它会红
臂 M 顺手抓出一处**真实的容量越界**(已修):`ConvexHull` 两条链各自最多 push 每个输入点一次 ⇒ 写入下标最大 `2×count−3`,包点缓冲要 2×count;原契约只要求装下 count(`BuildOutline` 里那个 `segmentCount * 2` 其实是**采样数**)。平时胶囊 50 点离边界很远所以一直没炸,臂 M 把 96 个采样点全留在链里当场以 `IndexOutOfRange` 打穿那道门;现在 `ConvexHull` 自带容量断言、契约改成 output ≥ 2×count,工具与探针缓冲按此口径给
圆柱这一轮**不做**的已如实点名(规范 §10):**端面平面去切立方体网格**(他提到"用于在立方体网格中设定他们的切面")——本轮只做"法线定朝向"(他选的"先只要法线定朝向");要让端面真在网格里切出交线,另需"平面 × 立方体面"的求交裁剪,且属几何不属数据(§1)
P6 验收现场另记一条**与本轮无关但真实**的缺陷(规范 §8.8,**本轮不修**):他那边抛 UGUI 的 `Mesh can not have more than 65000 vertices`(每个 Graphic 各自的 65535 上限 ≈16250 个四边形)。按记录数长网格的元素会撞它——箭头一条记录 2 个四边形、散点一个点 1 个四边形,他现场灌过 10000 条 ⇒ 80000 顶点;圆柱的输出有界(`SegmentCount ≤ 256` ⇒ 填充 ≤1024 面/包边 ≤1024 线,差一个数量级),所以这不是圆柱这一期的锅。正解是按顶点预算把网格分块成多个 Graphic,属渲染器层,另起一期;这里只是把"圆柱验收失败"与"网格上限"两件事分开
修"两个端面像是转过了/连接顺序错了"(他 P6 第二轮现场看出来,**是真的**):默认法线原来让两端各自"朝另一端",第二片拿到的是**反号**法线,而 `TryOrthogonalBasis(-n)` 给出的 `u' = -u` ⇒ 两片采样角**镜像**,同一个采样下标在两片上指向不同方向,可选母线就拧成 X 形、端面十字两端互为镜像。现在规则抽成纯函数 `XChartCylinderGeometry.ResolveNormals`:显式法线优先,默认**两端都用同一条轴同向**;配了一支把 end 翻成 `-axis` 的对照臂(它量出的 u 正是 `(0,-0.24,-0.97)` vs `(0,0.24,0.97)`,v 不变)
圆柱新增按端面各自的**闭合圆环**开关(`ShowStartRing`/`ShowEndRing`,默认关):端面自己的那一圈椭圆不属于外轮廓(轮廓只走可见段),所以要能各自开;打开就是首尾相接的整圈,用同一套采样角(环/十字/母线永远共顶点)。现场读数行补 `ringStart= / ringEnd=` 与两端法线来源;探针 268 项、p4_control 14 支臂全绿
修"拉近了线条有断口"(他 P6 第三轮反馈,**根因是我的调用方式**):库里的转角连接三角形只给**同一根线内**的相邻子段补(`LineMeshGenerator` 的 `hasPrevInLine`),而我原来对轮廓每一段各调一次 `DrawLine` ⇒ 每段都被当成"新线的第一段" ⇒ N 段 N 个断口(48 段端面环放大就是"虚线环")。现在轮廓/端面环/十字都改成**一次 `DrawPolyline`**(闭合的靠把首点补到末尾;十字改成过圆心的三段折线),母线仍用 `DrawLine`(本来就是独立段)
按他点名的渲染器重做线:**弧段改用曲线渲染器**(`Packages/com.lrss3.deconstruction/Runtime/Generation/Curve` 的 `UICurveRenderer`/`CurveCacheRendererBase`,它内部就是贝塞尔细分,我只算控制点),**直线仍走折线渲染器**(他原话"折线渲染器适合用来显示直线")。新增纯几何:`TryParameterOf`(反解椭圆参数,凸包分组靠它)、`BuildArcPiece`(k=4/3·tan(Δ/4),椭圆是圆的仿射像所以同系数成立)、`BuildLineBezier`、`ClassifyOutline`、`SweepToDirection`、`ShortestDirection`、`ComplementSweep`;轮廓的弧段按 ≤90° 一节拆成贝塞尔,桥接段用直线贝塞尔。探针 277 项、p4_control 17 支臂全绿(新增臂 O"参数反解永远失败"、臂 P"控制点塌成弦"、臂 Q"补弧走短路"各在指定断言上红);现场读数行加 `curveEntries=`
修"端面环关掉时消失的是外侧、而且环与包边重复出两条线框"(他 P6 第四轮反馈):环原来画**整圈**椭圆,而包边已经画了那片端面的外侧弧 ⇒ 外侧重、内侧(他真正想控制的"内部圆环闭合部分")反倒没画。现在**环=包边那段弧的补弧**(起点接在可见弧终点、反向、扫过 2π−|可见|),外侧归包边、内侧归环,合成一整圈且不重复;包边整个关掉时环自己补整圈。**补弧不能用"端点对调 + 反向"表达**(`SweepToDirection` 只挑同号里较短那条 ⇒ 得到"原路返回",正是重复的成因;我第一版就是这么写的,被新加的断言当场抓住 `visible=1 complement=-1`);修"端面环补成了外半环"(他 P6 第五轮反馈):补弧**同方向**走完剩下的那一圈(扫过 2π−|可见|),不是"反向"——反向会把可见弧原路覆盖一遍(半圆时最直观),现象就是"环补成了外半环"。**我连错两次**(先"端点对调+反向"=原路返回,再"反向 2π−|可见|"=还是原路),而**公式型判据两次都放过了它**(判据与实现出自同一个错念头 `|可见|+|补| = 2π 且符号相反`);抓住错误的是几何判据"**补弧中点必须落在轮廓内部**"(可见弧中点落在边界上),实测错版报 `inside=True distance=7.9e-08 at (0,-10)`。另加"两片在 2D 重合时第二片没有可见弧 ⇒ 环只能画整圈"这条,免得把正确的整圈回退当 bug 改坏;现场读数加 `ringArcs=` 与 `ringFullCaps=`。对照臂 S「环取可见弧的扫角」红在几何那条、臂 Q「`-sweep`」红在公式那条
"按顶点预算分块"落地(他批准的那条,UGUI 每个 Graphic 上限 65535):`XChartMeshFillRenderer` 改成提交即分块——纯算法抽成 `XChartMeshBudget`(`ChunkVertexBudget=16000`;`Split` 切块、`MaxChunkVertices` 报最大块),渲染器本体不画、每块一个子 Graphic(只画 `[start,end)` 那些面,顺序=提交顺序所以画家序不变)。判据=探针 5 条(不超预算/覆盖不重不漏且保序/最大值真是最大/单面超预算自成一块不丢面/零面零块)+ 臂 R「切块关掉」变红;现场读数:圆柱与箭头各印 `fillChunks=` 与 `fillMaxVerts=`。**本包之外还欠**:库里的 `UILineRendererV2`/`UICurveRenderer`/`PrimitiveCacheRendererBase`(散点走后者)提交量同样随数据量长,要照同一口径切块——属库那一侧,已在规范 §8.8 如实点名
修"65000 顶点一直报、数据降下来也不回落"(他 2026-10-23 晚的现场,他一句"是不是顶点推送没有回收"点中真因):库那三个基类(`CacheLineRendererBase`/`PrimitiveCacheRendererBase`/`CurveCacheRendererBase`)的顶点缓存**只 grow 从不收缩**(`while (Count < needed) Add(...)`),而 `OnPopulateMesh` 把**整个列表**交给 VertexHelper ⇒ 提交量=**历史最高水位**,任何一次画多了就把水位抬上去、之后再也不落,越过 65535 即永久报错。**这条与"按记录数长网格"是两条独立的路**(那条是当下量就超,这条是水位),分块修不了 ⇒ 重建时把缓存 shrink 到当前真正需要的顶点/索引数并暴露 `LiveVertexCount`(当帧真提交量);两棵库树按符号名对齐(`LiveVertexCount` 各 6 处、`RemoveRange` 各 5 处)。报告口径补齐:散点 `points=/pointVerts=`、箭头 `arrowFaces=`、圆柱 `curveVerts=/wireVerts=`、轴线 `wireVerts=`
补跨包编译顺序(改库后本包门会满屏 `CS1061` 假红):新增 `.ximage-gate/run_gate_lib.py`(库的离线门,基线 0 error、对照臂精确红),并让 `run_gate.py` 把渲染里指向 dag 旧 `Lrss3.Deconstruction.ref.dll` 的引用重定向到本次产出(打印 `lib_ref=N`,该数本身就是"重定向真的发生了"的判据)。库门 + XChart 门(三臂)+ 探针 285 项 + pool_family + p2 4 臂 + p4 19 臂全绿
库侧分块做了一半(按他"继续做分块"):`PrimitiveCacheRendererBase`(散点走它)与 `CurveCacheRendererBase` 改成"本体不画 + 按 `ChunkVertexBudget=16000` 把条目切块 + 每块一个子 Graphic",块内索引按块内顶点起点重基,顺序不变(画家序不动);`ClearAll` 同时停掉子块(否则清空后子块还在画旧切片)。**`CacheLineRendererBase` 没做**:它的索引是每子段 3 个三角且末段引用上一段顶点(转角连接)⇒ 要精确切片得先记录每子段索引起点,且它的当下提交量本就小(轴线刻度/圆柱包边),而真正咬人的水位泄漏已修
**(当日已补做)线渲染器也切块**:布局均匀(每段 `VerticesPerSegment` 个顶点)⇒ 按段数切;生成索引时记下每子段索引起点(`m_SegmentIndexStart`,精确切片的前提);**块首多带前一段的顶点**(同线内子段的转角连接三角引用上一段顶点,不带就缺角),窗口外的三角丢弃。两棵库树符号对齐:`ChunkCount` 各 9、`ChunkVertexBudget` 各 6。**平台变体树(`com.lrss3.deconstruction-webGL release/`)仍无编译器作证**:本工程 rsp 重指向它得到 5309 条"命名空间已包含定义"(路径形式混用,只能重定向一部分),那种红的臂分不清"我改坏了/路径混用",故按"按符号名同形状同步、未经编译验证"如实记档;重放脚本 `.ximage-gate/patch_lib_chunks.py`
界面串语言:试过全改英文(规范 §12,205 条字面量的完整记录),**他当场否掉**——"说明太长、按钮/字段/Label 装不下",界面串**回到中文**(`revert_locale.py` 一键回滚,三张映射表留档为"试过英文"的记录);由此确认那条 TMP 图集问题只能在**资产侧**修,而图表自己的标签文本(维度名/格式串)本就是用户数据;留下的经验是新 UI 文案要短。**最终落法(规范 §12.1,他给了精确证据)**:抛的只有顶部那几个按钮(添加元素/全部展开/全部折叠——这几个汉字不在图集里 ⇒ 要走"新增字形" ⇒ 撞坏槽),其余按钮/字段/Label 都不抛 ⇒ ① 这几个控件换成 ASCII 短词 `Add`/`Expand`/`Collapse`(他选"换更短的词"),不需要全仓英文化;② 长说明一律"面板一句 + 完整进日志"(`LogDetailOnce` 按 key 只打一次,否则面板随数据重建会刷屏):报表状态(面板只留 开/关,完整路径与字节数进日志)、Capacity 说明、网格对齐提示、轴"只铺了 8%..95%"警告:TMP 默认字体资产只要有一个坏图集槽(§8.6),**任何"需要新字形"的文本测量都会抛**,所以面板/窗口/Inspector 的重绘都可能撞;界面串写成 ASCII 就从结构上不再需要新字形,以后加功能不必再为新字操心。范围:面板 `XChartBaseEditor`、数据窗口 `XChartDataWindow`、创建菜单、元素注册,以及五个元素配置的 `[Header]/[Tooltip]/[XChartElement]` 显示名,共约 150 条字面量;顺手去掉 `·`/`—`/全角空格等非 ASCII。判据:新增 `.ximage-gate/locale_check.py`(扫 9 个界面文件的**非注释行**,字面量含非 ASCII 即红,自带 `--self-test` 证明能红且注释不算),映射脚本 `ui_locale.py`/`ui_locale_window.py`/`ui_locale_panel.py` 均幂等。源码注释与规范文档仍是中文(不进 UI、不触发字形),新代码按"界面串英文"写
P7 落地(规范 §11.2–11.3、§11.7):新增**网格插槽板** `XChartSlotBoard`(五种模式 `Line2D/Line3D/Circle2D/Circle3D/Quad3D` + `ReadOnly/ReadWrite` + 只读槽与过期视图拒写 + 写成功推版本);`IXChartRenderContext.Slots` 由 chart 的上下文持有;**网格背景与立方线框都发布**六个面的 `Quad3D`(`mesh.face.0..5`,发布的是**单位立方体四角**而不是像素 ⇒ 谁投影仍只有一条路);**轴线的宿主面改成 `SlotId` 字符串、`CubeFace` 枚举从工具与配置里删除**,`ResolveFaceFrame` 先读插槽(用自己的矩阵投影四角 + `XChartFaceFrame.FromCorners`)再回落(把同一个 id 按 `mesh.face.<n>` 解释成面号;解释不出来就返回无效帧并清空绘制),报表印 `frame=slot|cube`。探针 +5 条(含**插槽角点与面帧角逐点对拍**="改走插槽后画面不变"的离线证明、回落解析器只认 `mesh.face.<n>`),对照臂 T/U/V 各红在指名的格子上;门三臂 + 探针 303 项 + pool_family + p2 4 臂 + p4 22 臂全绿。P7 还差:网格发布格线 `Line3D`(P9 用)、Teardown 时 `Slots.Clear()`、面板给 SlotId 一个"已发布插槽"下拉
折叠层级(规范 §13,2026-10-24 他口述):面板**所有折叠块默认折叠**(`MakeGroup` 无历史记录即 `false` ⇒ 打开 Inspector 只剩「基础」「工具」两行);**层级别由调用方传**——`MakeGroup`/`GroupFor` 只登记块(key 钉在盒子根 `userData`),整棵树灌完后交给新文件 `XChartPanelHierarchy.Compute` 现算父级/深度/是否最深(挂在谁的 Body 里由"同名合并、跨父级不合并"决定,传参就会与真实挂接分叉);**"最深"= 叶子块**(下面再无折叠块,也就是真正装字段的那一层),**不是**全局最大深度——一条分支一层(基础→调试)、一条两层(基础→数据→维度 0),两边叶子都要打标,按全局深度挑会把「调试」漏成自由块;所有叶子**共用一组互斥标记**:展开任意一个就把其余开着的收起 ⇒ 全面板任何时候只有一个详细块开着,中间层(基础/工具/元素/数据)不受管(它们是导航);**「Expand」是显式例外出口**(`m_BulkFold` 在批量开合期间屏蔽互斥,否则"全部展开"会逐个开逐个被收、按下去只剩最后一个开着=等于没展开)。判据分两层:**离线能判那套算术**(`.ximage-gate/hierarchy_gate.py`:实现文件与探针**一起编译**、不抄一份,47 条断言正本全绿,5 支变异臂各红在指认的那条——M1 按全局深度/M2 认生 `userData`/M3 一块不打/M4 深度不累加/M5 块块都打;每臂 `WITNESS` 印的是**它自己那份文件**的字节与 sha);**控件那一层离线判不了**(引擎 mono 造不出真 `VisualElement`:静态构造绑 `UIElementsRuntimeUtilityNative::VisualElementCreation`,实测 `SMOKE=THREW TypeInitializationException`)⇒ 面板自己印读数(调试块「层级:块 N 最深 M 深 D ⇒ 判决」,报表 `panel:` 行追加 `groups=/deepest=/depth=/hierarchy=`),判决名 `HIERARCHY-NO-PARENT`(块多于一个却没人认到父级=往上爬那一格没爬到东西)与 `HIERARCHY-NO-LEAF` 都**不会**以"没打印所以没事"蒙过去。门新增把 `XChartBaseEditor.cs`/`XChartPanelHierarchy.cs` **点名**进编译源(`GATE PASSED` 现在同时也意味着这两个文件编过了)
P10 落地(规范 §14.1,他 2026-10-24 口述"工具参数要能配来源"):新增纯算术 `XChartBindingMath`——`TryResolveRecord(back, count)`(0=最新、1=上一条)、`TryResolvePosition(data, back, dimX, dimY, dimZ)`、`TryNormalize(value, min, max)`;**记录不够/维度越界/空数据/NaN/值域退化一律拒绝**(宁可这一帧不画,也不往几何里塞 NaN),**超范围不裁剪**(那是数据的事实)。**圆柱的几何来源二选一**:常量(沿用 `m_Start`/`m_End`,字段名与类型未动 ⇒ 老预制体绑定不变)或数据(**三个维度对应 xyz × 两条记录=起点/终点**,默认「起点=上一条、终点=最新」=最近一步的位移),新增字段只加在几何组(`m_DriveByData`/`m_DimensionX|Y|Z`/`m_StartBack`/`m_EndBack`);数据值先用该维值域归一化到立方体单位才进几何。拿不到几何时**清空三个渲染器且不退回常量几何**(不能复用 `DrawWire()`——端面圆环吃上一帧的圆盘,会留一个没壳的环);脏判定把数据版本算进来;报表印 `geometry=literal|data(rec s->e)|data-skipped(原因)` 与 `records=`。判据:探针 317 项(新增 15 条 `binding:` 断言)+ `p4_control` 24 支臂(新增「back 数反了」「退化值域不再拒」各红在点名断言)+ 门三臂 + p2 4 臂 + pool_family 全绿;**过程记录**:探针首跑红的是我手算的期望值(30 在 [-10,10] 映射到 unit=3,我写了 >3.9),实现是对的
修"删掉 chart 后按 Ctrl+Z 整个编辑器原生崩溃"(规范 §15,来自他 2026-10-24 的 Editor.log):栈是 `Object_CUSTOM_DestroyImmediate ← XChartToolBase.Dispose ← XChartToolsManager.RemoveAllTools ← Dispose ← XChartBase.Teardown ← OnDestroy ← GameObject::WillDestroyGameObject/PreDestroyRecursive ← ObjectUndo::ApplyUndo ← Ctrl+Z`,崩溃前 Unity 连报两次 `Child GameObject 'LineChunk0' was not registered into undo system and became dangling during an undo operation`。**机制**:Undo 正在递归销毁这棵层级,Unity 在销毁途中回调我们的 `OnDestroy → Teardown`,而我们又对**同一棵子树的子孙**(工具根 / 池根 / `[XChartTools]` 根)逐个 `DestroyImmediate` ⇒ 在 Unity 自己的销毁遍历中途重入销毁 ⇒ SIGSEGV。**修法**:`OnDestroy` 先把 `m_HierarchyBeingDestroyed` 置真,Teardown 在这个窗口里一个 `Destroy*` 都不调(生成物全是本对象的子孙,跟着一起没)——新增 `XChartToolsManager.ReleaseBookkeeping()`(只记账:`RemoveAllTools(false)` / 池只丢引用)、`Dispose(bool)`/`RemoveAllTools(bool)`/`RemoveTool(tool,bool)`/`XChartToolBase.Dispose(bool destroyRoot)` **默认 true** ⇒ 非销毁路径(面板重建、重新生成全部节点)行为不变,`POOL-ROOTS-LEAKED` 判据继续有效。**仍开着一条(警告不再崩)**:生成物未登记进 undo system ⇒ 每次 undo 仍印 "became dangling";要消掉得 `Undo.RegisterCreatedObjectUndo`,但那会把生成节点塞进 undo 历史,留他定。现场事实:盘上场景文件完好(71.9 MB、13:11)但**不含任何图表组件**(370 个 guid 全扫),全 Assets 预制体也没有 ⇒ 那个 chart 从未存盘;`Temp/__Backupscenes/0.backup` 是二进制且我的 guid 探针在它上面拿 6 个真 guid 做对照也全 0 命中 ⇒ 判不了,如实记档;`Library/EditorInstance.json` 里的死 pid 不用手删。判据:门三臂 + 探针 317 项绿;"Ctrl+Z 不再崩""删了重建有内容"归他现场判
修"圆柱的数据来源顺序与窗口不一致"(他 2026-10-24 现场:在数据窗口改第 1 条,圆柱不动、而末两条相等时两端合并):**顺序只留一个权威**——记录下标 0 = 最早、n-1 = 最新,**与数据窗口的行号同一套下标**;`XChartBindingMath` **删掉"往回数第几条"(`TryResolveRecord`/`back`)**,改成 `CompleteGroupCount` / `TryResolveGroup(recordCount, groupIndex, groupSize)` / `TryResolvePosition(data, recordIndex, …)`(绝对下标)。圆柱改成**一组记录一根**:组 g 覆盖 `[g*size, g*size+size-1]`,两端取**组首与组尾**,组与组**严格不重叠、不并入上一组**,凑不满一组的尾巴**不画**(记进 `groupsSkipped`)⇒ 32 条记录、组大小 2 = **16 根圆柱**(记录 0-1、2-3…30-31),不再默认取"最近两条";配置字段 `m_StartBack`/`m_EndBack` 换成 `m_GroupSize`(默认 2)/`m_MaxCylinders`(默认 64)。工具内部重构为"三个渲染器各清一次 → 每根圆柱追加 → 最后统一提交",并按深度**远→近**排序(`DepthOf` 越大越近;三个渲染器都按提交顺序决定画家序,不排就会被近的盖住);顺带删掉从未被读过的 `m_OutlineDepth`。判据:探针新增分组断言(32→16 组、组 0=记录 0-1、组 15=记录 30-31、奇尾不成组、组大小 4)、`p4_control` 新增「组多含一条记录」「尾巴组被放行」两臂各红在点名断言
数据窗口改成表(规范 §16,他 2026-10-24 口述):**表头行**(`#` 记录下标,tooltip 写明"0=最早、所有工具按它取值、不可改" / 时间 / 每维就地改名 / `+` 加一列 / 标签)+**表格化行**,表头与格子共用同一组列宽常量;列表**末行**专放「+ 添加一行」(项数=记录数+1,绑定该行时格子整组隐藏);表头 `+` 新增数值维(默认 `d<n>`/`D<n>`,老记录补 0);改名走**只改显示名**(新增 `XChartDimensionDefinition.DisplayName` 可写 + 模型 `TryRenameDimension`,序号与 key 不动);工具栏改用 **Toolbar 族控件**(`ToolbarMenu`/`ToolbarButton`/`ToolbarToggle`/`ToolbarSpacer`)并按组收进下拉:`导出▾[剪贴板,文件]`、`导入▾[剪贴板替换/追加, 文件替换/追加]`、`清空▾`、`测试▾[螺旋 32, 平方和金字塔 30]`;新增顶部**「强制刷新」**按钮;**底部状态栏**放 `总行/维度/已丢弃` + **缓冲上限就地输入**(读数与编辑都只此一处)+ 最近一条消息;长说明搬进列表 tooltip;测试数据抽成 `Editor/XChart/XChartDataGenerators.cs`(螺旋 32 = 原"生成 32 条示例",平方和金字塔 4 层 = 1+4+9+16=30 个顶点、层 k 铺满 `±(k-1)/2`、z=k),面板上「生成 32 条示例」「灌 10000 条」删除、「追加一条」改走同一个 `TryAppend3`。判据:新增 `.ximage-gate/generator_gate.py`(探针**直接编译源码**、WITNESS 印源码字节+sha)11 条断言正本全绿 + 2 支变异臂(层数多一层/层内跨度平移)各红在点名断言;编译门点名四个编辑器文件;观感归他现场判
P11 桶采样落地(规范 §17):新增纯算术 `XChartBucketMath`——`BucketCount(recordCount,targetPoints)`(≤0 或 ≥ 记录数=不聚合,行为与旧路逐字节相同)、`TryBucketRange`(整数均分,**桶严丝合缝、不留缝不重叠、并起来覆盖整表**)、`TryReduce`(**复用数据层已有的 `XChartAggregateKind`**:Count/First/Last/Min/Max/Sum/Mean/Rms/Median;NaN/Inf 跳过、整桶坏值**拒画**而不是塞假位置、中位数要么给够 scratch 要么拒收);接进散点(`BucketTargetPoints`=0 不聚合 / `BucketReduce` 默认 **Last=抽稀不造新值**,要看趋势换 Mean/Median、看包络换 Min/Max),`BuildPointsFromDataSource` 改成"算桶数→逐桶归约三路+颜色维→归一化",并加 `TrimPoints`(渲染器按数组长度提交,桶数变少不裁就会画出上一轮的旧点)。**上限不再新造全局"预算÷每项顶点数"换算**(他确认上游已分页解决 65535):圆柱=「最多几根」、散点=「桶目标点数」,两者都在报表印实际值(散点 `points=/buckets=/records=/reduce=`)。判据:探针 343 项(+20 条 `bucket:` 断言)正本全绿 + `p4_control` 新增三臂且**每条断言各有自己的生产者**:「桶之间留缝」(红在 contiguous)、「末桶早停一条」(红在"覆盖末尾",留缝那条看不见它)、「Last 答成 First」(红在 reduce=3)——第一版我把"留缝"要求同时红两条,结果覆盖末尾那条根本没红(末桶 end 没动),已按"一条结论的两半各有各的变异体"改正;观感归他判
P7 收尾(规范 §18):① **网格发布格线插槽** `mesh.face.<面号>.grid.S` / `.grid.T`(`Line3D`、只读、**单位立方体端点**,与 `mesh.face.<n>` 四角同口径),值由纯算术 `XChartCubeGeometry.FillGridLineValues` 填(比例 `i/(lineCount-1)`、**含两条边**、沿 S = 等 t 线),**两个定义网格的工具各按"自己画出来的那一套"条数发布**(元素框架网格背景用统一分格数、Pseudo3D 立方体背景按方向拆)⇒"发布的线 = 画出来的线"是 P9 刻度对格线的前提;② `Teardown` 里的 `Slots.Clear()` **判定为空操作、不写**(板子归 context 所有、Teardown 丢 manager 就连着丢,消费者每帧现取,写它只是留一条永远走不到的守卫;将来 context 跨重建复用才需要补);③ 轴的"宿主面"改成 **`已发布插槽`下拉 + 手填框**,并在 `AppendHeaderGroups` 里跳过裸 `m_SlotId` 字段(同一件事不做两个入口),板子加**索引式** `TryGetSlotAt(index, out id, out mode)`(不返回集合、面板每帧取不分配),id 清单进日志、面板只留个数。判据:探针 354 项(+11 条格线/插槽断言:18 float 布局、写回条数、groupCount=3、第 0/中/末条落在 t=0/0.5/1、沿 T 组是等 s 族、三组 id 互异、缓冲太小拒收、TryGetSlotAt 越界拒收)+ `p4_control` 新增「格线不到远边」臂(`i/(lineCount-1)`→`i/lineCount`,红在"最后一条是 t=1 边");面板观感归他判。**同轮修我自己踩的坑**:立方体背景两个方向共用一个"按最大值开的"缓冲,而插槽板是**按数组长度算组数**的 ⇒ 条数少的那组会把缓冲尾巴的残留当成额外格线发布出去(板子上凭空多几条线);改成两个方向各一个缓冲且**长度精确相等**,网格背景的"分格数改小时旧长缓冲"同源形态一并修,并把该契约钉进语料(`slot board: the group count comes from the ARRAY length …`)
P8 落地(规范 §19):**注册分组 + 注册序与绘制序分离**。新增 `XChartToolCategory{Definition,Background,Foreground}`(**类型标记**、不入序列化:空间/网格背景/立方体背景报 Definition ⇒ 最先跑,前景留给数据图元与可交互元素;`Background` 暂无人落座,位置留给"只画背景不定义几何"的第三类)与 `XChartToolOrder.Compare/Sort`(顺序**唯一规则**:分组 → 数值 → **注册序**;最后一级是稳定性的来源,缺了它同值两工具谁在前看运气、画面上就是"有时点在上面有时轴在上面")。`XChartToolBase` 新增 `DrawOrder`(画家序,小者先画)与 `Category`,配置新增 `m_DrawOrder`(`m_OrderIndex` 语义改为**注册序**),面板元素行改成「注册序 / 绘制序」两个格子。**统一调度**:`XChartToolsManager.ApplyOrder()` 一次落两件事——更新序(分组→注册序,`m_Dispatch`,`UpdateAll` 走它 ⇒ 定义组当帧先算范围/发插槽)与绘制序(分组→绘制序**写进兄弟序**,UGUI 按兄弟序画家序;`AddTool` 里那句"兄弟序=注册序位置"的老焊点已删)。工具调试行加 `category= reg= draw= sibling=` 三个读数("谁先算"与"谁盖谁"必须能分开看)。**同族防护**:销毁窗口(`destroyRoot=false`)里 **不动兄弟序**(与 `DestroyImmediate` 同族的重入),只清调度表。判据:探针 362 项(+7 条 `tool order:` 断言:分组压过数值、背景居中、同组比数值、同组同值按注册序、自反、真实排序置换、已有序报"没动过")+ `p4_control` 新增两臂「先比值再比分组」「丢掉注册序那一级」各红在点名断言
P9 落地(规范 §20):**网格线由数据范围定、轴线跟随**。20.1 新增纯算术 `XChartGridLines`(`BuildUniformRatios` 等分、含两条边;`BuildRatios` 用该维值域 + 轴那套 `NiceStep/BuildTicks` 求刻度值、再经 `ToParameter` 折成面参数比例、夹到 [0,1]、丢 NaN/Inf);`FillGridLineValues` 改成"比例 → 端点"("格线在哪儿"只有一个实现、两个背景共用);网格元素新增 `沿 S/T 的格线绑哪一维`(默认 -1=不绑、等分,那一维没数据时退回等分而不是不画)。20.2 轴线新增 `AlignToGrid`:在面参数上吸附到**最近的一条已发布格线**(沿 S 走读 `grid.T`、沿 T 走读 `grid.S`,上限=相邻两线最小间距的一半),取不到槽就不吸并把原因写进 `align=` 读数;配置多了「对齐格线」一项。**探针当场抓到我的错**:`GetFaceParameter` 第一版只写了点积、**忘了面轴长度是 2**(面轴是整条边)⇒ 参数被放大 4 倍,往返断言一次就红(实得 s=1 t=3),已修成"除以 |轴|²"。判据:探针 372 项(新增 `grid lines:` 与 `grid align:` 共 10 条:值域对应的比例、比例必须有限且在 [0,1]、退化域不出 NaN、面参数往返 ×2 个面、正好落线上、两线之间取近、超限不吸、空集拒绝)+ `p4_control` 新增/改派四支臂(格线不到远边、网格比例用错映射、吸附取最远那条、面参数反解忘掉轴长)各红在点名断言;观感归他现场判
P12 落地(规范 §21,2026-10-25 他口述):**数据的删、每列的范围,都收进数据窗口**。① 数据窗口加**删一行**(每行末尾"删",越界报因;时间非递减天然不被破坏)与**删一列**(表头每列一个"×";破坏性 ⇒ 先把整表复制进剪贴板再要一次确认,并在消息里点名"后面的列号整体前移,绑在这些列上的工具要重新对一遍");② 「图表」引用字段从顶栏搬到底部状态栏右侧(顶栏只留动作),提示语跟着改位置;③ 窗口下面开**第二页「维度范围」**(`Toolbar` 两个 toggle 当互斥标签条,数据表保持原样):一列一框三层——列名+**生效范围**、**统计**(样本/最小/最大/平均/中位/RMS,走 `TryGetAggregates` 与桶同一口径)、`钉住最小`/`钉住最大`各带勾选框与格子(默认 0),统计只读与覆盖可写**各占一行**(他的原话"它是两个字段,就是两行");④ 范围语义补上**分侧覆盖**:`m_OverrideMin`/`m_OverrideMax` 两个开关,"最小值必须是 0、最大值自由发挥"这种形状以前一个总开关表达不出来;旧主开关保留="两端一起钉"且仍受"两个分量相等=没覆盖"约束(`LegacyBothPinned`,分侧一写过就清主开关,否则取消勾选取消不掉);⑤ **解析收成单实现**:`XChartDomainOverride` + `XChartDomainMath.TryResolve(override, hasAggregates, …)`,再加一扇 `TryResolve(data, dimension, …)` 让上下文/面板/窗口问同一道门(`XChartRenderContext.TryResolveDomain` 现在只转发;`EffectiveManualRange` 删除,不留第二个视图);⑥ 顺手统一了两处下标口径并修掉两个静默缺陷:`XChartColumnMath`(值下标↔维度表行号:`ValueCount/ValueSlot/DefinitionOfValueSlot`,`NumericDimensionCount`/`TryGetDimension`/`TrySetDomainOverride`/删列都走它)——**表里夹一个 Label/Time 列时"第几行"和"值是第几格"会错开**,原来窗口按表行号读写值(会显示"-"却把数写进隔壁列)、范围页会拿非数值列去问聚合;文本导入原来用 `fields.Length >= 6` 守卫却读 `fields[6]`,一条被截断的 6 字段 DIM 行直接 `IndexOutOfRangeException`(改成只接受 4/5/全套);⑦ 文本格式升 **`XCHART-DATA 2`**:DIM 行带两个覆盖标记(分侧覆盖必须带得走,否则导出再导回来把"只钉最小"读成"两端都钉"),第 1 版仍读得动但**版本只能来自表头**(两种布局字段含义不同);覆盖端点写 NaN/Infinity 在门口就拒;⑧ 面板的「数据」框整块删除(记录/维度/版本/已丢弃读数、追加一条、清空、每维一行的显示名/可见/覆盖范围),「基础」下只留一个 `打开数据窗口` 按钮("我们将所有的信息都整合到这个窗口里","数据面板不要搞太深了")。判据:探针 **407** 项正本全绿(新增 35 条:分侧覆盖 6 + 端到端 5 + 删行删列 7 + 列口径 5 + 文本形状 4 + 往返改写 2 等),`p4_control` **47** 支臂每支红在自己点名的断言上(本轮新增/改派 13 支);门三臂绿 + p2 4 臂 + family + generator + hierarchy 同轮复跑。两条"判据的判据"记档:① `Expect(label, cond, detail)` 的 detail **无条件求值**,我在说明串里裸写 `Records[0]` ⇒ "值计数把非数值列也算进去"那支臂把记录表清空后探针当场抛 `ArgumentOutOfRangeException`(**崩掉的臂什么也不证明**)——所有碰 `Records[i]` 的判据改成先查条数、detail 用三目兜住;② 一支臂"能红"不等于"红在该处":"每个值下标都答第一个数值列"那支臂让我原本点名的那条**碰巧过了**(两列答同一列时"钉第二列再解第二列"自洽),真正红的是"第一列不该被第二列的钉影响",点名清单按实测改过去。**证据链自己的一次事故也记在这里**:`p4_control.py` 被我一次 read-modify-write 的失败写入截成 0 字节,臂表按下述方式重建——`p4_p12.txt` 的臂名顺序 + 盘上 43 份 `*.p4ctrlN.cs` 变异副本与当前源码逐行 diff 还原 (锚点, 替换) + `p4_ctrlN.out.txt` 里那轮真报红的断言名当"点名清单"(所以清单是证据不是记忆),脚本 `.ximage-gate/rebuild_p4.py` + `install_p4.py`(候选文件先编译、逐锚校验命中一次,才覆盖正式文件)
P13 落地(规范 §22,2026-10-25 他口述):**立方体那几件搬进「工具」,格线只有一个作者**。他报的四条症状(勾"显示网格线"反而消失/关掉它再操作别的又亮回来/「立方体外观」还挂在 基础 下、而"另有脚本注册的工具 3 个"不说是哪三个/Mesh BG 的填充面改了没反应且与图上两个开关"逻辑上很割裂")根因是**同一件事有两个作者**:`ChartToolCubeBg` 既画 12 条棱又画面内格线,还和 `ChartToolMeshBg` 往同一批 `mesh.face.<n>.grid.S/.T` 插槽上发布,而两家条数算式不同(一家含两条边、一家只画内部线),插槽板按 id 覆盖 ⇒ 关掉一边另一边用另一套条数画回来,看着就像开关反了;图上那组「立方体外观」字段与元素表里那份配置又是两处存同一件事。落法:① 线框**根本没有"格线"这条代码路径**(字段、渲染器、发布全删)只画棱+发面四角,网格元素是格线唯一作者且**画上去的线就是发布那份比例数组**;"哪些面有格线"收成两侧共用的 `DrawsGridOnFace`(掩码 ∧ 面帧有效 ∧ 只看可见面时朝向观察者),**不画的面把上一轮发的插槽撤下来** ⇒ 插槽板新增 `Unpublish(id)`(只有覆盖写入的板子表达不出"这里不再有线",而发空数组是被拒的),元素 Dispose 时撤干净自己发的 12 条、**不动四角那批**(线框也在发,撤它=拆别人定义的东西);② 命名按"画的是什么几何":`MeshBg` → **`BG Cube Grid`**(id `cube-grid`)、线框 → **`BG Cube Wire`**(id `cube-wire`),留出 `BG Plane Grid`/`BG Radar Grid` 的并列位(他点名要求);③ 渲染参数搬进元素表:基类新增 `DeclareDefaultElements` + `AddDefaultElement`(按类型去重,查找收成唯一实现 `XChartElementTable.IndexOfKind/FirstOfKind/HasKind`),散点预设在这里声明 `Space`/`BG Cube Wire`/`BG Cube Grid` 三件,`m_ElementsSeen` 保证"只在第一次读到这张表时补"(他删掉的不补回来;老场景第一次进来补齐缺的那几件,否则这次改动就成了"升级完背景整块没了");④ 图上那组字段删除、公共属性改成**转发到元素表**(`ShowGridLines` 的真身=`GridFaces` 掩码,开=All 关=None),一次性代价要说明白:场景里存过的姿态/半边长/格线颜色回到默认,要重拧一遍;⑤ 面板:`基础` 不再有任何渲染参数,「工具」下**逐个点名脚本注册的工具**(名字·类型·组·注册序·绘制序;一个都没有也说明是"没有"还是"工具管理器还没建"——他原话"你并没有显示出来这几个工具是什么东西?"),轴的对齐提示**当场从元素表里那份网格配置读** S/T 现值并把位置写成"工具 → 那块网格的元素名"(写死"基础 → 立方体外观"不会报错,只会把人引到一个已经不存在的块上);⑥ 报表等式由被测元素自己判:`BG Cube Grid` 那一行印 `faces=画上/发出`、`retracted=`、`linesCheck=ok|DIFF drawn=… want=…`,掩码印**字母**(`a=前 b=后 c=上 d=下 e=左 f=右`,六面=`abfecd`、后墙三面=`bed`、空集=`-`)。**"填充面改了没作用"这一条本轮没有结论**(代码里找不到"必然看不见"的确定成因),改成让下一轮报表一句话定位在哪一层:`fillFaces=-`=面板的值没落到工具上/有字母而 `filled=0`=落到工具了但一面都没提交/`filled>0 chunks>0 renderers=ok/ok`=提交了、问题在外观那一层/`renderers=fill-NULL`=子物体根本没建;默认预设里填充面是 `Nothing`(旧图本来就没有填充,要看填充先把它打开)。判据:探针 **424** 项正本全绿(新增 `face mask letters:` 5 + `element table:` 6 + `slot board:` 撤下 5);`p4_control` **52** 支臂每支红在自己点名的断言上(本轮新增 5 支:空槽算命中、字母跟着枚举序漂、报表读裸位、插槽撤不掉、撤下不算变更);门三臂+3 支对照、`p2_control` 4 臂、`pool_family`、`generator_gate` 2 变异、`hierarchy_gate` 5 变异同轮复跑。三条"判据的判据"记档:① 六面字母串我手打成 `afecd`(真值 `abfecd`),探针当轮就红——**手打的格式常量必须有"对着真数据"的断言**;② "版本基线"这个错我**连犯两次**(拿整段开始前的版本当基线,中间那次 `Publish` 自己就把版本推了 ⇒ 恒红/恒绿方向都不可信)⇒ **基线要贴着被测动作取**,而且规则要写在取基线那一行旁边;③ 两支新臂第一次根本没编译(`mask & (1 << i)`:枚举与 `int` 不能相与,CS0019)——`SETUP FAILED`(变异体压根没判过任何东西)与 `did not go red` 是两种不同的自证失败,都不许被"其余 49 支都红了"掩盖。另记一次流程失守:定版那一跑进行中途我改了一段注释并当场逆还原,**跑起来了就一个字都不动**(注释也是树),该事已写进规范 §22.7。
P14 界面收敛(规范 §23,2026-10-25 他对着截图点了三条):① 数据窗口行末删除按钮 `删` → `-`;② 范围页的号收成 `Y [1]`(行的位置本身就是表里的列号,括号里再报一遍是把同一件事说两次),不占值格那一列印 `tag [-]` + `不占值格`,统计行去掉 `统计:` 前缀,生效行不再复述哪端被钉住(**下面那两个勾自己就是读数**),状态栏回执从"我改了什么"改成**结果**(`Y [1] 生效 -100 .. 100`);③ 两页的长说明一律退回 tooltip,可见那段里"这正是“原点必须留在 0”那类要求的做法"这类**开发对话**从界面上删掉——它对着当时的我,不对着下一次打开这个窗口的他。顺带修掉一条真布局缺陷:范围页第一列的三行塌成两行、文字叠着画,而后面几列正常——机制是**整页容器允许收缩**(UI Toolkit 的 `flexShrink` 默认为 1),窗口矮了被压扁的就是最上面那一行,所以症状看起来像"只有第一列坏";修法=`ScrollView.contentContainer` → body → 每列的框 → 框里每一行**整条链 `flexShrink = 0`**、标签一律 `NoWrap`(装不下宁可截断,也不许和邻行叠在一起),表头那一行同一处理(它被压一次就整表错位)。判据:编译门三臂绿(`XChartDataWindow.cs` 在点名源里,"门绿"包含它编过了);**这三条全是观感、离线判不了**(引擎 mono 造不出真 `VisualElement`,§13.2 那条实测仍成立)⇒ 布局是否真的不再叠行、文案是否够短归他现场判,本轮没有任何一条绿可以替"界面已经对"说话。
P15 界面:元素块收成一行状态 + 默认元素让删(规范 §24,2026-10-25 他给的格式 `▼ √ Cylinder (R1, D4) [↑][↓][-]`):① 新增 `MakeHeaderRow` 把折叠板的标题搬进一个横排行,右边依次是 **√**(写 `m_Enabled`)、**R**、**D** 两个**可编辑**格子、`↑ ↓ -` 三个单字符动作键(中文说明进 tooltip),Body 里那行「启用/注册序/绘制序/上移/下移/删除」整行删掉 ⇒ 同一个写入口只有一处。他报的"注册序/绘制序的字段我在界面上没看到"根因**不是没做,是控件在折叠着的 Body 里**(面板默认全折叠,§13)——这一类要按位置查、不按存在查;R/D **不做成静态读数**:面板树在值变化时故意不重建(重建会换掉用户正在拖的输入框),静态读数会停在旧数字上="改了没反应"的又一种形状,绑定的格子没有这个问题。顺带拆掉一个**藏着的第二入口**:基类那三个字段没有 `[Header]`,会被 `AppendHeaderGroups` 整组塞进元素 Body 的「其它」里 ⇒ 标题行有了 √ R D 之后同一个写入口出现两次,现在分组时跳过这三个名字(与 `m_SlotId` 同一条规矩)。② 回答"默认工具应该被删除吗":**让删,也让关**,`[-]` 与 `√` 对每个元素都可用、不做特例,理由写进 `-` 的 tooltip 与 §24.2 那张表(删线框 ⇒ 网格仍发面四角给轴线;删网格 ⇒ 线框仍发四角、`AlignToGrid` 回落并在报表 `align=` 说原因;删空间 ⇒ 见③)。③ 顺带补一条会咬人的不变量:`EnsureSpace()` 原来只在初始化那一次跑,把「空间(基变换)」删掉或停用之后没人再补 ⇒ 投影权威为 null ⇒ 线框/网格/散点全部不画,现象是**"点了一下删,整张图空了"**;现在**每次 `RebuildElements` 之后**都保证图里有一个空间工具(删掉它=回到默认姿态继续画,重新 Add 一条就把旋钮拿回来)。判据:编译门三臂绿(`XChartBaseEditor.cs`/`XChartDataWindow.cs` 在点名源里)、`p4_control` **52/52** 支臂各红在点名的断言上、探针 **424** 项 0 失败、`p2` 4 臂 + `pool_family` + `generator_gate` 2 变异 + `hierarchy_gate` 5 变异**在交付树上复跑**全绿(`.ximage-gate/chain_p15.txt` 每套一行 rc);hierarchy 之所以必须复跑:它算父级是沿**盒子根**往上走的,把 Foldout 搬进横排行不动它的身份——真动错了就会以 `HIERARCHY-NO-PARENT` 红出来。**每份绿各覆盖哪棵树也记清**:那六套复跑覆盖的是"标题行 + `EnsureSpace`"那一版;之后为拆「其它」里的第二入口又改了一次编辑器文件,改完只复跑编译门与探针(`XChartBaseEditor` 只在 `run_gate.py` 的点名源里出现,其余套件一个都不读它,逐脚本 grep 过)。④ **这份绿覆盖不到什么**也点名:一行排不排得下、窄格子能不能改数、"删掉 `Space` 那一行图还在不在",离线一律判不了(引擎 mono 造不出真 `VisualElement`,§13.2)⇒ 归他现场判。
P17 矢量场(箭头)修复 + 相对/绝对 + 连续绘制 + 颜色维(规范 §25,2026-10-25 他现场):① **"加了箭头元素一条都不画"的根因**是维数不够时它静默返回——一条记录要 6 个数值维(起点 3 + 方向 3),而伪 3D 散点预设默认只建了 `x/y/z` 三列,于是算完 0 支、提交 0 个面,画面上与"工具没注册 / 空间是 null / 渲染器没建"长得完全一样 ⇒ 处置不是改那行判断,而是**让这件事说得出来**:元素配置新增 `RequiredNumericDimensions`(默认 0=无所谓),面板在元素块里印"需要 N 个数值维,表现在有 M 个 ⇒ 一条都不画(报表里 dims=N/M)",报表里该元素自己印 `dims=有/需要 arrows=算了几支 mode=… colors=…`;② 一条记录的两组三维按**两种读法**解释(他口述):`Absolute`=后三维是方向矢量本身(起点+方向×倍率 ⇒ 螺旋点画成一片"刺猬")、`Relative`=后三维是第二个点(起点+差向量×倍率 ⇒ 一串首尾相接、顺着螺旋转),算式收进纯算术 `XChartVectorFieldMath.Tip`;③ `连续绘制`:把每条记录的**第一组三维**按顺序连成折线(只有最后一段带箭头),这时"相对/绝对"没有意义 ⇒ **面板上隐藏**——互斥显示的判据写在配置自己身上(`XChartElementConfig.IsFieldHidden(fieldName)`,面板只照着藏/放;**藏而不是不建**:面板树在值变化时不重建,勾回来必须立刻可见);④ **颜色维**:矢量后面再接 3~4 个数值维 `[色相, 饱和度, 明度, (不透明度)]`——色相走 **0..256 的色环**(256 与 0 同色、128 半圈),其余三个按 0..1 夹住;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha),算进门槛的话勾一下"有不透明度"就会让整个元素因维数不够突然消失;不是有限数**门口就拒**(退回单色,不画成黑——NaN 经取模 + HSV 会变成一块"看着像黑"的东西,那是我们替数据编的颜色);HSV 换算**自己写**(`Color.HSVToRGB` 是引擎侧静态调用,离线探针里跑不起来,而这条换算正是要离线钉住的);⑤ 数据侧新增 `测试 → 螺旋矢量场 32(9 维:起点+第二点+色相/饱和/明度)`:前三维是螺旋上的点、中三维是**下一个点**、后三维是颜色(色相 0→256 走满一圈)——两种读法在这份数据上正好是"刺猬"与"首尾相接"两幅图,且它**自己会把列补到 9 个**(测试数据的判据是"点一下就能看到东西",不是"提示他先去加六列")。判据:探针 **436** 项 0 失败(新增 12 条 `vector field` / `vector field colour`)、`p4_control` 新增 3 支臂(相对被读成绝对 / 色环按 0..1 读 / 颜色门口放 NaN 进来)各红在点名断言上、编译门三臂绿,`p2` / `family` / `generator_gate` / `hierarchy_gate` 在交付树上复跑,**55 支臂全红在各自主张上**、探针 436 项 0 失败(终态见 §25.6)。**本轮没做的**如实点名:仍然**不用曲线渲染器**(是直线段——"默认使用直线"是他给的,库里那个带矢量标签的曲线渲染器 + "调整箭头位置"排下一轮)、**两端各自的颜色**(现在是每支一个色,读一条记录的颜色维;他提的"两个分量各自设色"要逐顶点双色)、圆柱的颜色开关没动。
P17 口径修正(同日,听他澄清;规范 §24.5 与 §25 已按正确口径重写):① **序号不是给人设的**——*注册序*由**类型**定好(定义几何的那一类天然靠前、数据呈现那一类靠后),面板**只显示、不给输入控件**;*绘制序*与**元素在表里的位置**绑定(上移/下移就是改绘制顺序),也不再有第二个手填的序号——序号能手填就会出现两条口径(位置 vs 数字)指向不同事实,"上移之后绘制顺序变没变"就没人回答得了。第一版我把 `R… D…` 做成了两个窄输入框,他现场否掉("我根本不想给它设置这个序号"),而且那对输入框还会露出拖拽光标、窄到数字看不见 ⇒ 改成**文本读数**并就地刷新(面板树在值变化时不重建)。② **矢量场的数据口径写错了**:正确是**前三维=坐标 x/y/z**(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**(第二条按相对/绝对解释成"第二个点"或"方向矢量")、**第 4~7 维才是颜色**(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,全部可选);初版照着旧实现写成"一条记录塞两组三维(6 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。
P18 矢量场收尾:两端各自的颜色 + 连续绘制走曲线渲染器 + 箭头位置可调(规范 §26,2026-10-26):① 填充四边形多一档**线性渐变**(`AddFaceLinear`:`00/10` 一对边一色、`01/11` 一对边一色),箭头**杆走渐变(起点色→终点色)、头走终点色**——两端颜色来自相邻两条记录各自的颜色维,所以"这条与下条颜色不同"直接看得出来;每面花几个顶点收成**单一定义** `XChartMeshBudget.VerticesPerFace(kind)`(预算侧与写顶点侧同源,否则"预算以为 4 个、实际发 5 个"会在卡线时撞 65535,§10.3 那一族);**杆的四角绕序有判据**(a/d 在起点一侧、b/c 在末端一侧;配错画面上是"杆两侧各一色"而不是"沿杆渐变",最容易看漏)。② 连续绘制改走**曲线渲染器**(库里 `UICurveRenderer`,圆柱弧段同一件):途经点 → **Catmull-Rom 转三次贝塞尔**(张力 1/6,新纯算术 `XChartArrowPathMath`),曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置;`entry` 自带起止色 ⇒ 沿程渐变是它本来的能力;不再逐段提交折线(§10.4 的转角断口)。③ **箭头位置可调**(`HeadPosition` 0..1):`ResolvePosition` 给段号+段内参数 ⇒ 该段 `Split` 剪断、只画左半,箭头放在剪口上、方向取该点**切线**(不是两端连线,弯处会歪);**必须剪**,否则路径从箭头底下穿出去、看着像"箭头朝里长"。④ 互斥显示又用一次:`HeadPosition`/`PathSegments` 只在连续绘制下出现,`相对/绝对` 反过来只在非连续下出现。⑤ 读数与退路:报表带 `path=curve|fill|-`、`at=`、`curves=`、`curveVerts=`——曲线渲染器不在位时退回直线段(形状仍读得出来),但**退没退在 `path=` 上一个字说清**,不是悄悄换个画法还报一样的数。判据:编译门三臂 + 3 对照绿;探针 **450** 项 0 失败(新增 `arrow path:` 9 条——全是**性质**判据:过数据点、端点切线=弦的一半、剪开再接回逐点一致、共线仍是直的、位置 0/0.5/1 落在哪一段,不写手算的中间点坐标)+ `arrow shaft:` 配对 1 条 + 顶点数 1 条;`p4_control` **61** 支臂各红在点名断言上(新增 4 支:起点侧角取成末端、所有面按平坦算顶点、控制柄拉成 /3 张力、剪开不共用剪口点);`p2` / `family` / `generator_gate` / `hierarchy_gate` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。
P20 外部数据驱动访问(规范 §27,2026-10-26 他问"我能不能直接拿到圆柱渲染器,改属性就自动置脏"):**入口本来就有**(`ToolManager.FindTool<T>()`),缺的是第二半——9 个工具的参数全是裸自动属性,**写进去值在、画面不动**,必须再补一句 `MarkDirty()`(`XMeshPreviewChart.ApplyVolume` 手工补的那个样子)。落法:① `XChartToolBase` 新增 **`public abstract void MarkDirty()`**——不给基类空实现,因为空实现通过基类引用调用时**静默什么都不做**(参数改了、画面不动、报表看不出错,"零要说出它零在哪一层"那一族),抽象让编译器逼 9 个工具各自说清"我的脏位是哪个字段";7 个已有 `public void MarkDirty()` 的必须逐个补 `override`(少了就是 **CS0108 隐藏**:编译只出警告、基类调用失效),`ChartToolSpace` 没有独立脏位⇒转发 `MarkProjectionDirty()`(投影就是它唯一要重算的东西),`ChartToolScatterPoints` 只有 `MarkDataDirty()`⇒override 接 `m_PointsDirty`、旧名转发(同一字段两个名字)。② **132 个旋钮全部改成"设了就生效"**:`public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }`(122 支走 `MarkDirty`,**10 支走 `SyncShapeParams`——这 10 支是门查出来的,不是我原本知道的**:散点外观早就自带生效路径,于是判据从"必须调 MarkDirty"改成"必须调到本文件里定义的 `MarkDirty` 或 `Sync*/Push*/Apply*/Rebuild*`")。③ `XChartBase` 加两个入口:`Tool<T>(toolName)`(`FindTool<T>` 的空安全简写,管理器还没建时答 null 而不是抛 NRE——"图里现在有没有这一类"是现场状态,调用方要问得出"没有")与 `Element<T>()`(走 `XChartElementTable.FirstOfKind`,与默认元素去重同一个答法)。④ **权威只有一处这件事写明**:外部写进工具的值会活到下一次 `ReapplyElements()`/`RebuildElements()`(面板动任一字段、增删/停用元素、脚本重载、进 Play、`ResetRender()`),那一次把配置整份重灌 ⇒ 外部的写被静默覆盖;要活得过重建就得写配置,而配置的公开写入口本轮**没开**(字段仍 private,面板走 `SerializedProperty`),列为下一步。判据:新门 `.ximage-gate/dirty_gate.py`——清单**两侧都数**(`TOOLS` 9 个 vs 磁盘 `ChartTool*.cs` 9 个,多一个少一个都红)、终态 `knobs=132 takesEffect=132 findings=0` 才算绿;另立两条同门判据:**D** 工具不许在 setter 之外给自己的旋钮赋值(那会在自己渲染的过程中把自己重新置脏 ⇒ 每帧重建),**E** 靠 `Sync` 生效的必须 `OnInitialize` 里也有那一句(否则 `if (IsInitialized) Sync()` 把初始化之前的写全丢);**七支变异各红在自己点名的那条**(M1 抹掉一个 setter 的 `MarkDirty()`、M2 拿掉 `override`、M3 新增一个裸自动属性、M4 工具自赋值、M5 把一个工具从路径上挪走、M6 `Sync` 调用改成不存在的名字、M7 从 `OnInitialize` 删掉那句 `Sync`)。**本轮自己的三处错都被门/编译门抓住(不是现场)**:批量改写脚本把字段行的**等号漏了**(`private float m_Radius 0.22f;`,121 处全中);判据把标识符里的字母当关键字(`Offset` 含 "set" ⇒ 只读的 `Offset` 被读成"从不置脏的 setter",改词边界 `\bset\b`);`{ get; private set; }` 没先归类成 views 时 D 支报出 **26 处**"自赋值"全是渲染器属性的初始化写盘(**分类之后真违规 0 处——写了判据才知道有没有**)。`ChartToolSpace.Rotation` 的初始化式跨两行,脚本按"同一行没闭合就拒绝整份文件"跳过整个文件、那 4 个旋钮手改(**拒绝写比写一半好**)。编译门 runtime+player+editor+3 对照 `GATE PASSED`(`chain_p20a.txt`/`chain_p20b.txt` rc=0);mono 数学探针本轮不重跑——改的全是 MonoBehaviour 侧工具的 setter,纯算文件一个没动。**覆盖不到**:画面观感归他现场判。
P21 矢量场没渲染的根因与修法(规范 §28,2026-10-26 他报"矢量场现在没有在渲染"):**读数先从他自己的资产里取**——`SP_盾构机掘进姿态 Variant.prefab` 那份表是 x/y/z 三维、记录值量级 **−100..50**、三条以上记录,箭头元素 `m_Enabled=1 / VectorMode=Absolute / Continuous=0 / UseColorDimensions=0`,所以形状够(需要 3、现有 3,面板那句"一条都不画"不会亮),问题不在 §25.1 那一层而在**尺度**。根因:`ChartToolVectorArrows.ReadPoint` 把 `GetValueAt` 的**原始值直接当立方体单位**(±1=盒子边界)用 ⇒ 每支箭头被投到**一万多像素之外**:支数在算、面在提交、计数全对,画面上什么都没有;而散点与圆柱一直是"按各维显示范围折进盒子"(`TryResolveDomain` + `XChartBindingMath.TryNormalize`)——**只有箭头这一条路径没折**,同一件事两套口径,坏的那套不抛不报错、只是看不见(§22 格线双作者、§24.5 序号双口径的同族)。排除"P20 改坏"用的是 diff 形状:那次提交 33 增 17 删全在属性形状上、编译门绿、他 `Editor.log` 里这次导入只有一条无关的 `CS0414`。落法:① 纯算术新增 `XChartVectorFieldMath.TryCubePoint(x,y,z, minX..maxZ, out cube)`(每维按自己的范围映到 [-1,1];**任何一维折不出来——跨度 ≤0、值或端点非有限——就整体拒答**,因为半归一化的坐标比不归一化的更难查,它会画出"看着像个箭头、方向却不对"的东西;折法进纯算术才离线钉得住);② 工具**每帧现问**三条轴的范围(范围不归元素存,与散点同规矩),读点改 `TryReadPoint`,读不出的点计入 `skipped=` 而不是静默少画;③ 报表加 `dom=x[..] y[..] z[..]` 与 `skipped=`,**折不出来印 `dom=-` 且一支都不画**——"为什么没有"当场说话(他那份表应印 `dom=x[-100..50] …`、`arrows=记录数−1`)。判据:探针 **458** 项 0 失败(新增 8 条 `vector field cube:`:域两端落 ±1、域中落 0、他那种量级的记录折进盒子内、**域外保持成比例而不是被夹住**(夹住=把数据改了)、零跨度拒答、非有限拒答、坏一轴整体拒答——全是性质判据,不写手算中间值)+ `p4_control` 新增 **3** 支臂(不折 / 坏一轴也照答 / 偷偷 `Clamp`)各红在点名断言上 + `dirty_gate` 新增 **claim F**(箭头这条路径的坐标必须经 `TryCubePoint`,原始值直接进 `new Vector3(` 就红;只挂这个文件,因为它判的是"形状对、画面空"这一类)并配变异 **M8_rawcoord**——**八支全红**、正本 `knobs=132 takesEffect=132 findings=0`;编译门三臂 + 3 对照绿(`chain_p21.txt rc=0`)。**两条判据自身的错记档**:① M8 第一版是**绿的**——不是判据弱,是 claim F 用来认文件的参数被 claim C 的 `for name in names` 重新绑定了(`judge(lines, name)` 里 `name` 既是文件名又当旋钮名,循环跑完它就等于最后一个旋钮名 ⇒ F 支永远不执行),**"臂能不能红"第一次是靠它自己抓到的** ⇒ 规矩:给"按文件生效的判据"传参,参数名不许与函数体内循环变量同名(这次改成 `source`);② 门脚本声明 `coding: ascii`,中文写进注释就直接 `SyntaxError`(中文只进仓内文档,不进脚本)。**留给现场/下一轮、没偷改的两条**:他这串姿态点的正确读法是 `Relative`(首尾相接=轨迹方向,`Absolute` 是给"点一行、方向一行"分开存的表用的);`XMeshPreviewChart` 的示例数据仍是**旧的"一条记录 6 维"口径**(方向存第 4~6 维),新口径下那三列是**死数据**,画出来的是"每条记录位置 → 0.25×下一条记录位置"——重造那份 demo 之前要先确认它还想不想同时喂散点元素(一对记录里的第二条也会成为一个点)。
P22 箭头改走"线 + 库的原生标记"(规范 §29,2026-10-26 他纠正:"箭头为何用的是填充?我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置"):**根因是一次"猜对了来源"没被复盘**——P18 我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API,`AddCurve`/`CurveCacheEntry` 猜对了,于是没再回头把那个包读一遍,它旁边的 `ArrowHeadData` 我一直不知道存在,就自己用填充四边形拼了杆和头;包其实就在工作区隔壁(`com.lrss3.deconstruction`),API 一直写在 `Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs`。⇒ 规矩:**照着调用点猜出来能跑之后,要把那个来源补读一遍**,"我猜对了"证明不了"我看见全了"。落法:① 杆=一条**共线**三次贝塞尔(新纯算术 `XChartArrowPathMath.Straight`:内控制点落在 1/3、2/3),宽度=`ShaftWidth`、起止色就是沿杆渐变(P18 那个效果原来是条目的原生能力);② 头=曲线渲染器原生标记 `ArrowHeadData`(`width`=头长沿切线、`height`=头宽垂直切线、`depthCompensation=+1`=**头尖对准那个数据点**);③ 连续绘制的头挂在 `ResolvePosition` 算出的那一节上、`progress`=节内参数,**路径不再剪断**——"必须剪否则线穿箭头"是我上一版自己加的,库的标记本来就叠在线上,于是 `Split` 没有调用方、随四角绕序那套(`XChartArrowGeometry` 整个类)一起删;④ 零向量画 `Circle` 标记(开关关掉就整条不画,计入 `skipped=`);⑤ **曲线渲染器不在位 ⇒ `path=none` 一支都不画**,不再有"退回填充画法"那第二条路(两套画法=两套口径,这次的 bug 恰恰长在第二条路上)。`AddFaceLinear`/`XChartFaceFillKind.Linear` **留着**:那是填充渲染器自己的上色模式(预算 `VerticesPerFace(Linear)==4` 与判据都在),别的元素要渐变填充时不必再写第二套。**另一面要说清**:P13 遗留的"填充面改了没作用"与今天"杆与头都不画"是**同一坏点的两种症状**(都走 `XChartMeshFillRenderer`)——他工程里那份报表给出了硬证据:`arrows=31 arrowFaces=62 fillChunks=1 fillMaxVerts=248`(=62×4 顶点一个不多)且 `dom=x[-100..100] y[-49.936..49.936] z[-49.743..50]` ⇒ 坐标已折进盒子、面提交了、子块建了、网格真填了顶点,画面上却没有 ⇒ 坏点在**填充渲染器到 Canvas 的那一跳**,不是数据形状也不是顶点预算。箭头不再经过那一跳,所以箭头上屏了而**网格背景/圆柱填充若也看不见就是同一坏点未除**,那一跳本轮没修(绕过去不等于修好)。**顺手抓到一条会撒谎的读数**:同一行 `curves=0` 却 `curveVerts=66`,而圆柱那一行也印 66 ⇒ `UICurveRenderer.LiveVertexCount` 不是本实例自己的数,只能当"库里一共活着多少顶点"读,看自己那份要读 `curves=`/`markers=`(已立待办)。判据:探针 **452** 项 0 失败(删 13 条判"四边形角点/剪开再接回"的——**被测对象已不存在,留着就是假绿**;新增 7 条:标记两尺寸对号入座、头尖对点 vs 圆点居中、`progress` 夹进 [0,1]、NaN 位置落到末端而不是"位置未知"、0 尺寸兜底、`Straight` 每个采样都落在那条直线上、切线方向与矢量平行)+ `p4_control` **65** 支(删 2 支靶子随代码没了、新增 3 支:两尺寸互换 / `progress` 不夹 / 头尖不对点,各红在点名断言上)+ `dirty_gate` 正本 `knobs=132 takesEffect=132 findings=0`、八支变异全红(claim F 判"坐标必须经 `TryCubePoint`",改写后仍判得住)+ 编译门三臂 + 3 对照绿(`chain_p22.txt`)。**门自己的一次改动**:`run_gate` 原先把 rsp 里列出的每个源文件都喂给 csc,删掉一个源文件后那份快照还列着它 ⇒ `CS2001 找不到源文件`,整道门红得像"产品编译不过";现在它跳过"工作区里已不存在的包内源文件"并**逐个点名印出来**(判决要说清它判的是哪棵树)——这不是吞错:CS2001 说的是"快照过期",Unity 重导入会自己重生成 rsp。
P24 箭头:方向来源四档 + 头的尺寸吃投影 + 锚点(规范 §30,2026-10-26 他三条要求):① **他指出的"矢量被归一化到屏幕空间再算了"是真的**,成因在库那一行 `CurveMeshGenerator.cs:150 pos += tangent * arrow.width * 0.5f * arrow.depthCompensation`——标记的**方向**跟曲线切线走(对)、**尺寸是固定像素**(不是投影结果):杆会随姿态缩短而头不缩,整支读起来就是"屏幕空间里等长的箭头"。修法:新增纯算术 `ProjectedScale(投影像素, 立方体长度, CubeToPixel)`=这条矢量自己的投影比例(平行于屏幕=1、指向屏幕里→0),头的两个尺寸都乘它;连续绘制那一档取**这一节自己**的比例,所以弯到背面去的那一节头跟着一起缩;**除不出来(NaN、零长、零比例)就答 0**——宁可头缩成没有,也不要一个凭空的固定像素尺寸。② **`XChartArrowDirectionSource` 四档**(他的"一个箭头对应两组数据 ⇒ 32 个点只该 16 支"):`NextRecordAsVector`(旧 Absolute,N−1)/`NextRecordAsPoint`(旧 Relative,N−1,**点到点不用再算一次投影**,所以 `Tip` 只在这一档作差)/`ThisRecordCarriesVector`(同一条的 3~5 维是方向,N 支、要 6 维)/`AlternatingRecords`(偶数条是点、奇数条是方向,N÷2 支);**支数与维数只有 `ArrowCount(source,…)`/`RequiredCoordinateDimensions(source)` 这一个实现**——四档算法在工具里各写一遍,画面上只是"少几支",最难查。③ **方向是原始矢量、绝不按位置的显示范围折**(`TryReadRaw`):折一次就把"朝哪"变成"在哪"(`(0,1,0)` 会被折成一个偏移量,整场箭头一起跑偏),尺度交给 `DirectionScale`;顺带 `XMeshPreviewChart` 那份"一条记录 6 维、方向存 3~5"的旧示例数据在新档 `ThisRecordCarriesVector` 下**正好合法**(§28.5 说的"死数据"有了读法,默认值我没替他改)。④ **序列化兼容**:新枚举 0/1 就是旧 `XChartArrowVectorMode` 的 Absolute/Relative,字段再加 `[FormerlySerializedAs("m_VectorMode")]` ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。⑤ **`MarkerAnchor` [0,1]** → 库的 `depthCompensation`(`anchor×2−1`;0=尾部落点、0.5=中心、1=头尖落点=默认),非有限退回 1。⑥ **颜色维撞上方向维**:自带方向那档吃 0~5 六列而颜色起点默认仍是 3 ⇒ 会把方向当色相读;判据是撞了就退回单色并印 `colors=overlap`("颜色没生效"与"配置撞了"分得开)。判据:探针 **462** 项 0 失败(新增 10 条:四档各自支数(含 33÷2=16、1 条=0)、维数需求只有自带方向那档要 6、锚点 0/0.5/1→−1/0/+1、越界夹取与非有限回退、投影比例 1/0.5/指向屏幕=0、坏输入答 0)+ `p4_control` **66** 支(新增 3 支:分档按条数算/头无视投影比例/锚点映射写死 0;**删 1 支**——"空表被挡在算术外"那支的守卫在新算术下已经到不了,**没有靶子的臂不当证据用**)+ `dirty_gate` 正本 `knobs=133 takesEffect=133 findings=0`、**九支变异全红** + 编译门三臂 + 3 对照绿(`chain_p24.txt`)。**门自己也现了一次瞎**(本轮最重要的自证):`public T X` 与 `{` 分成两行的属性写法**根本没被数到**,于是总数是 132 而不是 133,而"132/132 PASS"是绿的、却不再等于"每个旋钮都看得见"——补 `match_head`(认得大括号在下一行的声明)并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 `MarkDirty()`**,门必须红(看不见形状的门会放行一个不置脏的旋钮)。另记两次 harness 正常工作:CJK 又进了一次声明 `coding: ascii` 的脚本(第三次),以及一支臂的锚点被我新写的孪生函数撞成 2 命中 ⇒ `SETUP FAILED` 整轮作废(锚点加宽成两行块;规矩已进记忆)。
## [0.1.6] - 2026-07-01
添加表格系统
## [0.1.6] - 2026-06-26
添加样式ui组件,基于XericLibrary开放的样式系统。
## [0.1.5] - 2026-06-21
添加定位坞功能
添加带有反射重写的ui
## [0.1.4] - 2026-06-12
添加气泡布局组件
## [0.1.3] - 2026-04-08
修复翻页管理器的一些问题
## [0.1.2] - 2025-09-18
添加布局组件`Xeric Horizontal & Vertical Layout Group`
添加原生自带具有可见性剔除的滚动视图组件`XericScrollRect`
## [0.1.1] - 2025-07-28
添加翻页管理器
## [0.1.0] - 2025-07-14
添加翻页管理数据虚拟化组件`FlipPageManager`
添加支持使用类型限定的Unity界面组件容器`ObjectVessel`