他数出来的两件事,都对应一个真实的形状问题(不是"漏发布"): - "下拉里 12 个,只有 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 ⇒ 那 12 项在这个下拉里**永远是死项**(它们是「对齐格线」的输入,不是宿主)。 - "4 条垂直边注册不上" —— 因为"边"根本不是可寻址的东西:以前只能"选一个面 + CrossRatio=±1"去贴棱, 而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到位置上。 他给的结论正是要补的那层命名:"不可能只有 12 个,而是 4x6=24 个,命名该是 face/side"。 落法: - id 用 `mesh.face.<f>.side.<s>`(24 个)。前缀沿用 `mesh.face.`——`TryGetSlotAt` 与"轴从 id 回落读面号"都按它解析, 写成 `mesh.face0.side0` 就会同时存在两套前缀。 - **值=同一个面的四角按 <00,01,11,10> 环旋转 s 格**,让选中的那条棱正好落在面帧底边(S 轴、t=0)。 于是它仍是 Quad3D:轴线的 AlongS/CrossRatio/刻度朝外/标签随轴旋转**一行都不用改**;绕序不变 ⇒ 不镜像 (镜像了"往面内刻度"会翻到外面去,而这件事在画面上只是"刻度朝里",很难归因)。边号 0 底·1 左·2 顶·3 右。 - 发布者只有一个:线框元素(它就是画棱的那个,`mesh.face.<n>` 也归它)。一处算式出 24 份,报表 `faces=6 sides=24`;发不出去印 `sideRefuse=<原因>`——发不出去比发错更难查,所以留名字。 - 面板下拉只列"能当宿主的",判据收成一处 `ChartToolAxis.CanHostAxis(mode)`(消费者与面板共用; 否则会出现"下拉里能选、线上画不出"),并明说"另有 N 个比例数组插槽是给对齐格线用的",不静默少一项。 - 选中项另外在下面一行翻成人话(`mesh.face.2.side.1` → "当前宿主:面 Top · 左边(side.1)")。 **下拉的选项文本就是写回的值**,加后缀会写坏 id,所以翻译只能另起一行;又因为面板在值变化时故意不重建树 (那会换掉正在拖的控件),这一行自己跟着回调改——挂在树上的静态读数正是 §24.1 点过的那一族。 - 轴那行现成的 `slot=` / `frame=slot|cube` 已经能回答"我贴上了哪条边"(`frame=cube` 就是没读到槽、退回了硬编码), 所以没有再加新读数。 一条自证:我先在文档里写"SideName 面板与报表共用",而当时代码里**没人用它**(下拉显示裸 id)。 这句话在这一笔里被改成真的,而不是把文档改回去说假话——文档里的功能存在性也要有门。 判据:探针 **466** 项 0 失败,新增 4 条**全部打在性质上**(每个 side 的底边就是它自己那条棱/旋转后法向同向/ 24 档把 12 条棱各覆盖两次——这就是"不该只有 12 个"的机器版说法/id 与边名不撞),故意不写成"重跑实现自己的下标", 否则改错旋转的人会顺手把判据一起改错;`p4_control` **69** 支 CONTROL PASSED(新增 3 支:所有 side 旋到同一格/ 环序取成镜像/两条边名撞同一个词);`dirty_gate` 正本 knobs=133 takesEffect=133、九支全红; `slot_reset_gate` 仍 PASS(上一笔立的"被写 ⊆ 被恢复"这条没被这次改动放宽);编译门 runtime+player+editor+3 对照绿 (chain_p28.txt,面板那行加完之后又跑了一次 chain_p28b.txt 同样绿)。 本轮两次被工具拦住、都是它正常工作:`git add -A` 被分类器拒绝(一直禁用;pathspec 提交本就不需要暂存); 中文第三次进了声明 `coding: ascii` 的门脚本(⇒ 带中文的源行在臂文件里写 `\uXXXX`)。 覆盖不到的:30 个插槽是否真进了下拉、垂直棱是否真贴住了,只有他现场判(§31.4,看 `sides=24` / `slot=` / `frame=slot`)。
93 KiB
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),面板只照着藏/放;藏而不是不建:面板树在值变化时不重建,勾回来必须立刻可见);④ 颜色维:矢量后面再接 34 个数值维 7 维才是颜色**(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,全部可选);初版照着旧实现写成"一条记录塞两组三维(6 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。
P18 矢量场收尾:两端各自的颜色 + 连续绘制走曲线渲染器 + 箭头位置可调(规范 §26,2026-10-26):① 填充四边形多一档线性渐变([色相, 饱和度, 明度, (不透明度)]——色相走 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(与圆柱/散点同一套归一化)、一支箭头=相邻两条记录(第二条按相对/绝对解释成"第二个点"或"方向矢量")、**第 4AddFaceLinear: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 维"口径(方向存第 46 维),新口径下那三列是死数据,画出来的是"每条记录位置 → 0.25×下一条记录位置"——重造那份 demo 之前要先确认它还想不想同时喂散点元素(一对记录里的第二条也会成为一个点)。
P22 箭头改走"线 + 库的原生标记"(规范 §29,2026-10-26 他纠正:"箭头为何用的是填充?我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置"):根因是一次"猜对了来源"没被复盘——P18 我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API,5 维是方向,N 支、要 6 维)/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(同一条的 3AlternatingRecords(偶数条是点、奇数条是方向,N÷2 支);支数与维数只有 ArrowCount(source,…)/RequiredCoordinateDimensions(source) 这一个实现——四档算法在工具里各写一遍,画面上只是"少几支",最难查。③ 方向是原始矢量、绝不按位置的显示范围折(TryReadRaw):折一次就把"朝哪"变成"在哪"((0,1,0) 会被折成一个偏移量,整场箭头一起跑偏),尺度交给 DirectionScale;顺带 XMeshPreviewChart 那份"一条记录 6 维、方向存 35"的旧示例数据在新档 5 六列而颜色起点默认仍是 3 ⇒ 会把方向当色相读;判据是撞了就退回单色并印 ThisRecordCarriesVector 下正好合法(§28.5 说的"死数据"有了读法,默认值我没替他改)。④ 序列化兼容:新枚举 0/1 就是旧 XChartArrowVectorMode 的 Absolute/Relative,字段再加 [FormerlySerializedAs("m_VectorMode")] ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。⑤ MarkerAnchor [0,1] → 库的 depthCompensation(anchor×2−1;0=尾部落点、0.5=中心、1=头尖落点=默认),非有限退回 1。⑥ 颜色维撞上方向维:自带方向那档吃 0colors=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)。
[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