判据补了一条正向覆盖(run_gate.py 的 assert_dir_compiled):rsp 是快照, ShaderBake 目录里每个 .cs 必须真出现在被编译的清单里,少一个就红。
162 lines
114 KiB
Markdown
162 lines
114 KiB
Markdown
# Changelog
|
||
|
||
## [Unreales]
|
||
|
||
添加图片组件的四顶点变形(错切 / 倾斜 / 平行四边形 / 伪投影),带场景编辑手柄
|
||
添加立方体网格背景元素、元素组件框架、数据访问中转层,以及网格渲染预览图
|
||
统一注册路径到 XericRegistrationPaths(根 Xeric Library,产品族 Chart / Table / UI / …)
|
||
注册路径按界面分成两套根:工具栏走 XericLibrary/Action Vessel(品牌根不带空格,只有真挂菜单项的族另配 *Bar 常量),Hierarchy(GameObject/…)、Project(CreateAssetMenu 的 menuName)、Add Component 三个右键上下文面走 Xeric Library/Action Vessel(带空格);族常量本身归上下文侧,所以 58 处 AddComponentMenu 与 4 处 CreateAssetMenu 只改表就跟着走,只有 3 处工具栏调用点(数据窗口 / 表格编辑器覆盖层开关 / 场景变形手柄开关)改成 *Bar
|
||
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` 整轮作废(锚点加宽成两行块;规矩已进记忆)。
|
||
P26a 文本槽位复用时恢复默认(存量缺陷,2026-10-26 他提标签需求时点出"我们改的属性在池复用的阶段都要能恢复默认"):`XChartTextSlotFactory.Acquire()` 以前只给**新建**那件设默认,从 `m_Free` Pop 出来的只 `SetActive(true)`,而元素每帧往槽位写的远不止那些(轴线六样:`text/fontSize/color/sizeDelta/anchoredPosition/localEulerAngles`,`ChartToolAxis.cs:469-474`)⇒ 复用件带着上一轮的字色、矩形大小和旋转走,新元素只写自己关心的几样,剩下沿用——症状"标签换个顺序就变大/歪了",画面上看不出是谁写的("同一件事两处存"的另一种:上一轮的残留也是两处)。修法:抽 `public static ResetToDefaults(TMP_Text)`,**默认值只此一处定义**,新建与复用**两条路径都调**。清单不靠记忆:新门 `slot_reset_gate.py` 两条主张——A 所有元素写过的属性 ⊆ 恢复清单(`files scanned=53 slot writes=14 distinct=7 reset lines=16`)、B 恢复函数真的在**两条获取路径**上被调用(只在新建分支调=一条绿谎,直接 FAIL);三支变异各红在点名处(S1 从清单删 `fontSize`、S2 让轴线多写一个 `overflowMode` 当场点名、S3 删掉复用路径那句调用 → 两个分支同报 False),正本 PASS + 三支全红 + 编译门三臂绿(`chain_p26a.txt`)。一条 TMP 版本事实由门先替我撞:这版 `TextMeshProUGUI.outlineWidth` 是 **float** 且没有 `enableOutline` ⇒ 宽度归零即不描边(我按新版文档写的 `Vector2.zero`/`enableOutline` 吃了 CS0029+CS1061,没进他的编辑器)。覆盖不到:这一笔不解决"上不上屏"(P23/P25),只保证"没写的属性不会带着上一轮的值"。
|
||
P28 面边插槽 6×4=24(规范 §31,2026-10-26 他数的两件事):他先说"网格发布的轴线虽然有 12 个,实际可用的只有上下两个面周围的边线,另外 4 个垂直边线插槽无法注册",又说"只有前面的 mesh.face.1-5 有用,后面的 mesh.face.0.grid.S/T 都没用"——**两句都对得上字面**,而且各有各的成因:板上当时只有 `mesh.face.<0..5>`(Quad3D 面四角,6 个)和 `mesh.face.<n>.grid.S|T`(Line3D **比例数组**,12 个),而轴线只认 Quad3D(`ResolveFaceFrame`),所以那 12 条在"已发布插槽"下拉里**永远是死项**(它们是「对齐格线」那一栏的输入,不是宿主);"4 条垂直棱注册不上"则不是漏发布,而是**"边"根本不是一个可寻址的东西**——以前只能"选一个面 + `CrossRatio=±1`"去贴一条棱,而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到你要的位置。他给的结论正是缺的那层命名:"不可能只有 12 个,而是 4×6=24 个,命名该是 face/side,然后根据面选择对应的边"。落法:① id `mesh.face.<f>.side.<s>` 共 24(前缀沿用 `mesh.face.`——`TryGetSlotAt` 与轴从 id 回落读面号都按它解析,换写法就等于同时存在两套前缀);② **值就是同一个面的四角按 `<00,01,11,10>` 环旋转 s 格**,让选中的那条棱正好落在面帧底边(S 轴、t=0)⇒ 仍是 `Quad3D`,轴线的 `AlongS`/`CrossRatio`/刻度朝外/标签随轴旋转**一行都不用改**,绕序不变所以不会镜像(镜像了"往面内刻度"就翻到外面);边号 0 底·1 左·2 顶·3 右(`SideName` 一个来源,面板与报表共用);③ **发布者只有线框元素**(它就是画棱的那个,`mesh.face.<n>` 也它发),一处算式出 24 份,报表 `faces=6 sides=24`,发不出去印 `sideRefuse=<原因>`;④ 面板下拉只列"能当宿主的",判据收成**一处** `ChartToolAxis.CanHostAxis(mode)`(消费者与面板共用,否则会出现"下拉里能选、线上画不出"),并明说"另有 N 个比例数组插槽是给对齐格线用的"——不静默少一项;轴那行现成的 `slot=` / `frame=slot|cube` 已能回答"我贴上了哪条边",没加新读数。判据:探针 **466** 项 0 失败,新增 4 条**全部打在性质上**(每个 side 的底边就是它自己那条棱/旋转后法向同向不镜像/24 档把 12 条棱**各覆盖两次**——这就是"不该只有 12 个"的机器版说法/id 与边名不撞),故意不写成"重跑实现自己的下标",否则改错旋转的人会顺手把判据一起改错;`p4_control` **69** 支(新增 3 支:所有 side 旋到同一格/环序取镜像/两条边名撞同一个词);编译门三臂 + 3 对照绿(`chain_p28.txt`)。⑤ 选中项还在下面一行翻成人话(`mesh.face.2.side.1` → "当前宿主:面 Top · 左边(side.1)"):**下拉的选项文本就是写回的值**,加后缀会写坏 id,所以翻译只能另起一行;面板在值变化时故意不重建树(那会换掉正在拖的控件),所以这一行自己跟着回调改——挂在树上的静态读数正是 §24.1 点过的那一族。顺带一条自证:我先在文档里写了"SideName 面板与报表共用",而当时代码里**没人用它**(下拉显示的是裸 id),这句话在下一笔里被改成真的,而不是把文档改回来说假话。本轮自己两次被工具拦下并如实记下:`git add -A` 被分类器拒绝(这条一直禁用;提交用 pathspec 就够,不需要暂存),以及中文第三次进了声明 `coding: ascii` 的门脚本(⇒ 臂文件里的中文源行改用 `\uXXXX`)。覆盖不到:30 个插槽真进了下拉、垂直棱真贴住了,只有他现场判(报表 `sides=24`、`slot=`、`frame=slot`)。
|
||
P27 显示范围只定标尺;数据图元自己决定"钳/藏/原样"(规范 §32,2026-10-26 他裁定):症状是**同一张表两幅画**——散点折进盒子用的是 `Mathf.Clamp01`(超范围的点钉在盒壁上,看着像"数据到边就停"),而矢量与圆柱按 `TryNormalize` 比例投(可以跑到盒外),两边都"看着挺对"、谁也不报错(再往前箭头连折都没折=§28 的"计数全对画面空无一物")。他给的口径:**范围的本分是定标尺(网格多大、轴到哪儿),它不该决定数据画不画**;数据项目该呈现自己准确的位置;有时又确实想看被限制住的版本 ⇒ 开关交给数据图元。落法:① 新纯算术 `XChartCubeFoldMath`——`TryRatio01(value,min,max,behaviour,out 0..1)` 是**唯一**一份"值→盒子内比例",`TryFoldCube` 是三轴全有或全无版([-1,1];只夹一轴会画出"数据里不存在"的位置,比少画一条糟得多);② 圆柱原来调 `XChartBindingMath.TryNormalize`、箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize` ⇒ **三份并成一份**(箭头的 `TryCubePoint` 删掉);③ 数据图元各一个三档 `XChartValueOutOfRange`,**默认 `RenderAsIs`**(散点从此不贴边=行为变更,另一处行为变更:**一整列同一个数**以前让矢量整条拒答,现在答居中,因为为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数 NaN/Inf 仍拒答);轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B");④ 颜色映射那一档**刻意不统一**:越界的颜色取端色是常态,继续夹,"隐藏超范围"是坐标的事——写成注释防下次有人"顺手统一"把梯度弄出洞;⑤ 读数 `out=asis|clamptorange|hideoutofrange` 与 `hidden=`(策略隐的)/`skipped=`(数据不可用的)分开印,"我主动不画"和"数据不能用"必须分得开。搬家那一步被门抓了一次且抓得对:`dirty_gate` 的 claim F 当场 FAIL("箭头的坐标不再经过折法")——它判的是"必须经过**唯一那份**折法"而不是"必须调用某个旧名字",所以正确处置是把门指向新来源,**删判据是错的处理**;M8(把旧形状塞回去)这轮继续红,顺带证明"搬家会被抓到"。判据:探针 **469** 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上)、`p4_control` **71** 支全红在点名断言(新 2 支:hide 不 hide/clamp 不 clamp;搬家 3 支重挂新文件)、`dirty_gate` 正本 `knobs=136 takesEffect=136`(三个新旋钮都是自动置脏 setter)九支全红、编译门三臂 + 3 对照绿(`chain_p27.txt`)。自己的错照记:新判据的期望值我手打算错了(y 域是 `-20..20` 却按 `-100..50` 算),探针第一次跑就红——手打的数字必须有对着真输入的断言;中文第四次进了声明 `coding: ascii` 的门脚本。覆盖不到:画到盒外的点会不会被别的东西挡住、以及"默认到底该钳还是原样"的观感,归他现场判——**他觉得"跑出去太乱"时不用回滚代码,把那一档调成 `ClampToRange` 就行**,这正是开关存在的意义。
|
||
P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底各自在做什么(规范 §33,2026-10-26 他试完四档报"看起来完全没有意义"):先把四种现象各自算清(用他自己那张表的数字:三列 x/y/z、域约 `x[-100..100] y[-49.9..49.9] z[-49.7..50]`、`DirectionScale=0.25`)——`NextRecordAsVector` 拿"下一条记录**折好的坐标**"当方向 ⇒ 长度上限就是 0.25 个盒半径(一截短矢量);`NextRecordAsPoint` 拿相邻两点的差 ⇒ 同样短、略有区别;`ThisRecordCarriesVector` 要 6 个数值维而表里只有 3 列 ⇒ **一支都不画**(这是正确的拒绝,`dims=3/6`,缺的是数据里的方向列);`AlternatingRecords` 拿奇数行的**原始值**当方向、**没折** ⇒ `(-93.5,10.1,49.0)×0.25 ≈ 23 个立方体单位 ≈ 2700 像素` ⇒ 他看到的"一根比终点还大的矢量"。前两档的"没意义"来自他的表没有方向列(把位置当方向用本来就是凑数的一档);**第四档是真 bug**:位置除以了跨度、方向没有,同一个 `DirectionScale` 底下一套值两种单位。修法=纯算术新增 `XChartCubeFoldMath.TryFoldDelta(dx,dy,dz, 各轴 min/max, out cubeDelta)` = `delta/span×2`:**不减 min**(位置折的是"在这列数据里的位置",方向折的是"多长、朝哪",减起点会把朝向变成在哪——全表平移会挪走所有箭头);**一个数据跨度=2 个立方体单位**,与位置铺满 [-1,1] 同尺度,`DirectionScale` 回到"再乘多少倍"的本分;**不吃 `OutOfRange`**(钳制/隐藏是坐标的事,把方向夹进盒子尺寸=替数据改方向);折不出来(某列跨度 ≤0 或非有限)这一条拒画,`hidden=`(尺度没用)与 `skipped=`(数据坏)分开数。判据:探针 **473** 项 0 失败,4 条打在性质上(零方向仍是零——位置折法在这里会答 −1,这条就是两套折法的分界;一个跨度=2 个单位;成比例且带符号;跨度 0/非有限拒答)+ `p4_control` **73** 支各红在点名断言(新 2 支:把方向按位置折=偏移混进来;方向干脆不缩=他那根巨箭的形状)+ 编译门三臂 + 3 对照绿(`chain_p29.txt`)。等他定的那一半我没动:旧 `NextRecordAsVector` 去留(他预制存的就是序号 0),三个选项与我的建议已给出,删档或改默认都会改他画面上的东西,属于待答项不是我该拍的实现细节。
|
||
注册路径根改名:`Xeric Library` → `XericLibrary`(2026-10-26 他点名两处"`Table/Table Editor OverrideLayer`"和"`UI/Image/场景变形手柄`"的族前缀带了空格):他在两个具体组件上看到的只是症状,根因在唯一那份总表——`XericRegistrationPaths.Root`(`Runtime/Core/XericRegistrationPaths.cs`)写的是带空格的 `"Xeric Library"`,而**所有族常量都是它拼出来的**(Chart/Table/UI/Layout/Form/翻页/…),所以改了根就一次性把整个包的菜单与组件路径统一成 `XericLibrary/...`。改动是**一个常量加一行注释**,不散落:全仓 `grep "Xeric Library"` 只剩两处**散文**(ObjectVessel 里指向 Wiki 的原名、以及新注释里引用旧写法),没有一处活的路径字面量;也确认没有 `EditorApplication.ExecuteMenuItem("Xeric Library/...")` 这类按字符串找回菜单的地方。安全性:`AddComponentMenu`/`MenuItem` 的路径不入场景、不入预制(只影响菜单显示),所以这次改名不会动他的资产;**代价是旧的菜单路径没了**——他若把某个子菜单拖进过快捷栏/记过路径,需要按新根重找一次。编译门三臂 + 3 对照绿(`chain_paths.txt`)。
|
||
P29b 方向来源删到三档 + 资产值迁移(规范 §33.4,2026-11-08 他从三个选项里选了"删 0 号、值迁到 NextRecordAsPoint"):**序号 1/2/3 不许改**——资产存的就是这些数(`m_DirectionSource`),换序号就是换含义,所以 0 号只能空着,只有值迁移(选项 ② 被排除正是这个原因:它会把存着的 0 读成另一档)。默认值两处跟着改(`ChartToolVectorArrows` 与 `XChartVolumeConfigs`),但默认只管新建的元素,他预制里那个 0 不靠默认值救,靠迁移。迁移脚本 `.ximage-gate/migrate_direction_source.py`:扫工程 Assets 下的 .prefab/.unity,两种字段名都认(现名 `m_DirectionSource` 和 `[FormerlySerializedAs]` 的旧名 `m_VectorMode`),**先落备份再写,判决读回文件而不是信改写**——期望行 `m_DirectionSource: 1` 真出现才算通过,残留 0 就红。两份日志正好是一对:迁移前 `--check` 红(1 条,退出 1)→ 迁移后 `--check` 绿(0 条,退出 0),被改的就是 `SP_盾构机掘进姿态 Variant.prefab` 第 703 行;画面要重导入才变(改的是 YAML 本体)。**限制说清楚**:只扫了他当前工程的 Assets(1 处);别的项目/备份里存 0 的不会报错,它靠 `switch` 的 `default` 那一支跑,画出来的正是被删掉的那个含义,而面板下拉里已经没有这一项,所以 Inspector 上会显示成对不上号的值。判据跟着改:探针 **473** 照旧 0 失败("方向是矢量本身"那条从 0 号档改打在 `AlternatingRecords`、"点到点作差"照打 `NextRecordAsPoint`——两条还能在同一份数据上分开,所以覆盖没少)+ `p4_control` **73** 支照旧各红在点名断言(那支改名 "point-to-point reuses the carries-direction rule",**期望断言标签同步改**,否则臂红了却没人认它的断言)+ `dirty_gate` `knobs=136 takesEffect=136 findings=0` + 编译门三臂 + 3 对照绿。
|
||
合并他那 17 条 ShaderBake 提交(gitea/thr_dev/dev2,2026-11-05/06)到 thr_dev/dev_chart(`ae992c6`,已推):两条线从 a311c41 分叉,文件集只共用 `XericRegistrationPaths.cs`,他那侧只新增 `ToolBar` 常量、两套根都保住(工具栏 `XericLibrary/Action Vessel`、右键 `Xeric Library/Action Vessel`),入口走常量没有硬编码 ⇒ 无冲突。**门先整轮红在环境不是代码**:rsp 记录的引擎 `U:/UNITY_Engine/editor/2022.1.24f1` 已经不在(U: 上那版只剩安装包),同版本在 `G:/Unity_EngineFlie/Unity 2022.1.24f1`;给 `run_gate.py` 加"引用按引擎根重映射 + 逐臂计数 + 开头点名读的是哪个引擎根"(211 条引用全部能在那边解析),`probe_run.py` 的 mono 路径同规则。重跑三臂 + 3 对照绿,并且正向确认 ShaderBake 的 **11 runtime + 8 editor** 文件真进了被编译的清单——rsp 是快照,新文件靠 `scan_dir` 补,不补就会"绿着跳过"它们。
|
||
P25/P23 填充改由一个 Graphic 自己画完(规范 §34,2026-11-08 他定形状:"填充不需要额外的渲染脚本,自己写一个简单的就够了"):形状上把分块那套(`FaceChunk`/`EnsureChunkCount`/子物体/`MaxChunkVertices`)全部拿掉,一个 `MaskableGraphic` 自己填,不再依赖库的分块填充渲染器(库那侧的分块照旧,只有这一份实现改了)。② **顶点上限只能前缀取舍**:一个 Graphic 65535 顶点 ⇒ 装不下的只能整段放弃且不许重排(画家顺序就是提交顺序,跳着画会画出"数据里不存在"的拼接),被放弃的面由报表 `fillRefused=` 报出来而不是静默少画;`XChartMeshBudget.VerticesPerFace`(Radial 5 / Flat·Linear 4)**一处定义、守卫与写网格两边共用**——否则守卫按 4 判、写手按 5 画,报出来的 refused 数就不等于画面上的缺。③ **P23"发了但不上屏"的根因读源码而不是靠记忆**(`com.unity.ugui@1.0.0/Runtime/UI/Core/Graphic.cs`):17-18 行属性只有 `DisallowMultipleComponent` + `RequireComponent(RectTransform)`,**没有 CanvasRenderer**;640 行 `Rebuild` 第一句 `if (canvasRenderer == null || canvasRenderer.cull) return`;453-467 行的 `canvasRenderer` **是 getter,读到时会 `AddComponent`**(所以读它等于写应用状态)⇒ 我们运行时造的子物体只带 RectTransform,网格填满了、提交发生了、什么也没画、也不报错;库里那三个基类都带这个属性,**这正是散点/折线/曲线/箭头能上屏而填充不能的那条差**。两处修:类上补 `[RequireComponent(typeof(CanvasRenderer))]`,`CreateChild`(工具子物体的唯一出处)把两个组件写全;`OnPopulateMesh` 开头补 `vh.Clear()`(`DoMeshGeneration` 只在坏矩形那一支清,共享的 `s_VertexHelper` 不归子类清)。④ **四个读数各判一层**:`fillPlan=`(Apply 时算)、`fillShipped=`(真写进 VertexHelper 的)、`fillRefused=`(被上限挤出去的)、`fillCr=`(用 `GetComponent<CanvasRenderer>()` 判,不用那个会 AddComponent 的 getter,否则永远答 yes)。判据:新门 `fill_gate.py`(7 支,主张是"类带属性/CreateChild 写全/渲染器里没有嵌套 Graphic、没有运行时 GameObject、没有 AddComponent/上限被真正使用且只画接受的前缀/`VerticesPerFace` 是唯一那张表/报表印四个键且 presence 走 GetComponent"),正本 0 findings + 7 支全红 + 编译门三臂绿;探针 **474** 项 0 失败(6 条打在性质上:接受的面永远不超上限、真的有一面被拒、接受的是最大前缀所以画家顺序没被打乱、装得下的整批全收、单面超上限则整批全拒、0 面则两头都 0),`p4_control` **73** 支照旧各红在点名断言(第 26 支重挂"从不查上限、每面都收=会撞 65535"),`dirty_gate` `knobs=136 takesEffect=136 findings=0`。三次被门/自己抓到的记录:① `fill_gate` 基线假红——属性正则要求它在第 0 列;② 臂 F4 绿着——主张 D 把 `Apply()` 里的计数循环也当成了"画前缀",正确处置是**把判据收窄到真提交顶点的那个方法体**,不是放宽正则;③ 探针在第 26 支上**先死再判**(断言的明细值 `counts[accepted]` 越界,打印的是"NO VERDICT LINE (the probe died before judging)")——仪器死掉的"红"不是判决,明细值必须自证安全。**覆盖不到**:Canvas 收 CanvasRenderer 那一跳在引擎内部,离线门只能判形状与读数;上屏归他 Ctrl+R 判——报表 `fillCr=yes`、`fillShipped>0`、超大数据上 `fillRefused>0`(而不是抛异常)就是这一笔该给的样子;若那三个数都对而画面仍空,§34.3 就不是全部故事。
|
||
P26 标签是"记录上的标签列",不是随身的一串字符串(规范 §35,2026-11-08 他前几轮的口径:"每个数据项目对应数个 float 维和一个 string 维,把 string 维放在数据编辑器窗口前面直接编辑"):① **1:1 落在门口**——`XChartColumnMath` 补标签半边(`LabelCount` / `LabelSlotOf` / `DefinitionOfLabelSlot` / `SizedLabels`,与数值三支完全对称),`TryAddRecord` 在 `labels` 非 null 且长度≠标签列数时整条拒收,文本导入按标签字段个数校验并点名行号(以前默认"多出来的就是标签",于是窗口显示得出来、元素读不到、导出再读回来变了样;顺带补上记录行少到连时间戳都没有时点名拒绝,那条路原来抛的是异常不是判决);② **窗口一个显示序、两个读者**——`ComputeColumnSlots` 同时算值槽/标签槽/显示序(标签列在前),表头与行都遍历它;每格身份是 `CellRef{IsLabel,Slot}`(`-1` 仍只表示"这一列不占格"),标签格走 `TrySetLabel` 的字符串分支(数字解析会把"巷道1"当错报拒掉),工具栏「+标签」加的是 Label 维、走 `SetDimensions` 这唯一定长路径(老记录补空串、不挤走旧标签);③ **标签元素**(`ChartToolLabels` + `XChartLabelConfig`)13 个旋钮全自动置脏,位置与折法同散点/圆柱(范围只定标尺,§32),文本走池且**比记录多的槽位必须擦**,锚点与对齐出自同一档(pivot 与 alignment 都从 `AnchorOf`/`AlignmentFor` 来,`anchorMin/Max` 不写),报表 `labelSlot= dim= records= want= have= pending= written= cleared= empty= hidden= skipped= out= anchor= wrap=` 把数据侧与槽位侧分开;面板把"要几个标签列/表里有几个"和数值维、记录数一起印(§25.1 第三半,`RequiredLabelColumns`)。④ **探针这一轮抓到两个真缺陷(判据先红、代码后改)**:`SizedLabels(null,n)` 原来补的是 null 元素而不是空串——窗口里同为空,但"这一格是空的"这条判据上 null 与 `""` 各答一套(导入写出的永远是 `""`,往返一次就变样);九档锚点表**漏了 `MiddleRight`**、落到 `default`(Center),所谓"九档"实际只有八档。判据:探针 **492** 项 0 失败(新增 `label columns:` 一组 8 条 + `label anchor:` 一组 6 条;原 `data text:` 的标签断言按新口径重写——记录带 1 个标签列,没给标签的记录**仍有那一格**、是空串);新门 `label_gate.py` 15 条 claim + 15 支臂全红(每条 claim 一支变异;C7 的 forbidden 只认**写** `anchorMin =`,注释里解释"为什么不写"不算违规);`p4_control` **78** 支(新增 5 支:标签槽手数/记录自定标签长度/边中点锚点落到中心/非有限偏移直通/删标签列留错那一格;原"删列留旧值"那支的锚点因 `TryRemoveDimension` 重写而失效,已**重定靶**不是删掉);`dirty_gate` **149** 旋钮 149 生效(应磁盘清单新增 `Text/ChartToolLabels.cs`);`slot_reset_gate` 照旧 PASS;编译门三臂 + 3 对照绿,且 `source present:` 逐条点名四个新文件。覆盖不到:`AlignmentFor` 返回 TMPro 类型、离线探针引用不到那个程序集 ⇒ "对齐出自同一表"由源码门(C5/C6)判;标签真上屏、窗口里改完字跟着变归他 Ctrl+R 判。
|
||
新增「Bake Shader As Image」窗口(XericLibrary/Tool):把 shader 离屏烘成贴图 / Sprite / 图片文件;左侧预览可缩放拖拽,右侧细节面板,顶部工具栏 + 底部状态栏
|
||
输入源分 Shader / Material 两路:Shader 造临时材质、Material 复制一份,属性表改的都是副本,「写回原材质」才落到资产
|
||
材质属性表按 shader 属性类型铺行(Range 滑块、Float/Int、[Toggle] 关键字、[Enum]、Color、Vector、贴图),刷新时把值原样回写材质并同步关键字
|
||
面片网格:一格一张 UV 区域,格号(UV X/Y)可编辑,加行加列按贴边格推算编号;另支持外部网格与细分
|
||
相机:正交/透视,视图投影矩阵自建(含 Z 镜像与可选 Y 翻转),双面绘制兜住绕序;框取按内容宽高比铺满输出,输出比例不一致时用拉伸而不是留白
|
||
输出:尺寸预设/自定义、MSAA、HDR、sRGB、翻转 Y、Pass 下标、背景色;导出 PNG / JPG / TGA / EXR 与 Sprite 资产
|
||
实时预览走编辑器心跳(聚焦 60fps、失焦 20fps),关掉时改动记成「待刷新」写在重新渲染按钮上;覆盖率只写 Debug.Log,且只在百分比变化时输出
|
||
测试视图四种:UV / 梯度 / 棋盘 / 纯色自检,用同一套面片/相机/参数走探针重画;UV 视图按 UV 跨度归一,重复次数 >1 时一格仍是一条连续尺子,整数 UV 处留分界线
|
||
预览图上叠分格线与每格 UV 编号,点选换格时右侧 UV X/Y 跟着刷新
|
||
全局参数:扫描 shader 用到的引擎全局量(光照方向、环境光、反射探针等),渲染前注入、渲染后立即还原
|
||
修分格线与选中框一直不显示:`Matrix4x4 * Vector3` 走隐式 `Vector3→Vector4`,w 恒为 0,`clip.w <= 0` 把每一格都判成不在画面里
|
||
修 Range 属性的滑块区间取错:`ShaderUtil.GetRangeLimits` 的 0/1/2 依次是 默认值/最小/最大,按 0/1 取会让区间变成 0..默认值,手柄永远顶在右端
|
||
修属性行数值框被挤出面板:主题滑块默认不收缩,显式 `flex-shrink: 1` 并把数值框钉死 58px
|
||
细节面板六个板块改用 Foldout 折叠(原来是带复选框的 Toggle,看着不像能折),标题左侧的三角就是状态,整条可点;全局参数默认折叠
|
||
合并 dev2 的另外 23 条 ShaderBake 提交(2026-11-07,到 `8262d5a`)到 thr_dev/dev_chart(`f6a8838`,**未推**):文件集与 XChart 那侧不交叉,只有 CHANGELOG 撞在同一个插入点——两侧都是各自新增的行、谁也没删对方的内容,所以两边条目都保留。合并后在合并树上重跑整套判据:编译门 runtime + player + editor 三臂 + 3 对照绿,并且这一轮把"新文件真进了被编译的清单"从散文变成正向断言(`run_gate.py` 新增 `assert_dir_compiled`:逐个数 `Runtime/ShaderBake` **11** 个、`Editor/ShaderBake` **9** 个,含这次合并带进来的 `ShaderBakeOverrideRenderer.cs`,少一个就红而不是绿着跳过);探针 **492** 项 0 失败、`p4_control` **78** 支全红在点名断言、`dirty_gate` 149/149、`label_gate` 15/15、`fill_gate` PASS、`slot_reset_gate` PASS。判的那棵树钉在指纹 `bb28ea2515ef1b358cb32fc9220a48278a42ca519ff9412973d97a5423fb3b53`(260 个 .cs,`.ximage-gate/p30_tree_fp.txt`)。他的新代码走 `XericRegistrationPaths.ToolBar` 常量,没有硬编码菜单串。自己的错照记:`python3` 在这台机器是 Windows Store 的空壳(exit 49、无输出),跑门要用 `C:/ProgramData/anaconda3/python.exe`;第一次解冲突时脚本打印了结果却没落盘,靠读回文件才发现——写文件之后必须以读回为准。
|
||
|
||
## [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`
|