3AS拖入 .glb 开始预处理贴图支持：PNG / JPEG（标准）· WebP / KTX2（扩展）
新建自定义包围框（草稿，未保存）
红色虚线框可用左侧「移动/旋转」gizmo 拖拽摆放，也可以直接在下面输入数字；「确认」后正式写入包围框列表，「取消」/Esc 丢弃草稿不留痕迹。
Z 转角°
3AS · 3D Annotation System Alpha 0.006
从服务器打开项目
从服务器目录读取
从 Poly Haven 选择贴图
加载 Poly Haven 贴图列表…
贴图来自 Poly Haven（CC0 协议，免费商用）· 选中后自动下载 1k 分辨率主贴图（diffuse/albedo）并嵌入本模型
生成程序纹理
分辨率
已保存到服务器
诊断日志
测量基点 · 说明
测量基点决定「模型上的哪一点算原点、朝向哪个方向」，节点的「相对基点坐标」都是从它算出来的。
基点是怎么来的（按优先级，GLB 原生约定）：
① 模型里如果有一个叫 Origin（或 _origin/origin，大小写不敏感）的节点，模型第一次加载会自动拿它的世界坐标+朝向当默认基点。
② 没有这种命名节点时，退一步用模型整体包围盒的中心当基点，朝向默认 0°。
③ 以上都不满足、或想要另一个基点（比如多层建筑每层各一个），可以在下面手动新增或编辑。
「朝向°」是绕本场景竖直轴（Y 轴）的方位角，不是完整三轴旋转。
哪个基点是「默认」：没有显式关联具体基点的节点，相对测量数值按「默认基点」计算。默认基点本来按上面①②优先级自动选，但你可以在任意一行的下拉菜单里选「设为默认基点」手动指定——手动指定之后就不再跟着自动规则走，直到你把它改回「非默认基点」为止（哪怕模型里确实有 Origin 节点，手动指定的也会盖过它，你有最终决定权）。下拉当前显示的文字会告诉你这一行是靠哪条规则生效成默认的。这几类操作（新增/编辑/删除/设为默认）都会记进撤销栈和操作脚本，导出的注释 JSON 里每个基点也会带一个 resolvedReason 字段说明它当时是不是默认、为什么。
材质编辑 · 说明
材质用 PBR 金属度/粗糙度 工作流（glTF 标准）：漫反射决定基础颜色，金属度/粗糙度决定表面质感，自发光让材质自己发光（不受灯光影响）。
上方详情区编辑当前选中的材质，改了立即在视口生效，「导出 ▾」导出 GLB 时一并写回。
下方画廊点击色块可以切换正在编辑的材质；把色块卡片拖到视口的网格上，能把这个材质重新指派给那个网格。
画廊右上角「◎ 取色」反过来用——点它再点视口里的网格，自动定位到那个网格当前用的材质。「🧹 清理」批量处理 fallback 占位名/纯黑材质/节点缩放归一化，详见 Doc/EDITOR-SPEC.md §5。
贴图 · 说明
这里列出 GLB 文件里全部内嵌贴图（raw.images[]），支持格式：PNG/JPEG（标准）· WebP（EXT_texture_webp）· KTX2（KHR_texture_basisu）。
上方详情区显示当前选中贴图的大图预览、格式/尺寸/体积，以及被哪些材质的哪些槽位引用——「替换」「删除」两个操作都基于这份引用关系。
下方列表点一行即可选中并在上方展开详情；点缩略图直接打开大图预览。
替换复用材质编辑器的贴图上传逻辑，替换的是第一处引用它的材质槽位；删除会弹二次确认，列出全部受影响材质，确认后清空这些材质槽位的引用（贴图数据本身不会被物理删除，符合项目一贯不做索引位移垃圾回收的既有做法）；改名只改 raw.images[i].name 这个显示用的名字。
列表上方「⇓ 批量导出全部贴图」把当前模型 raw.images[] 全部贴图逐个下载到本地——用原始文件名，重名自动加 (1)/(2) 序号后缀防覆盖；浏览器可能会对连续多次下载弹出确认提示，这是浏览器自身的安全机制，允许一次即可。
模型块 · 说明
节点树跟 glTF 原生层级一致，只包一个子节点的分组会自动合并显示成一行（合并规则/注释挂载点见 Doc/EDITOR-SPEC.md §6.2），glTF 数据本身没有变，纯粹是显示层折叠。
点一行在上方展开详情——顶点/三角、通道、属于、材质、世界空间 T/R/S（可直接编辑）、相对基点坐标都在这里；样例复制/包围盒两个操作入口也在详情区，导出已经挪到视口右侧工具条（选中节点后可用）。
拖动一行的名称到另一行上，可以把它重新挂靠成那一行的子节点（保持世界空间位置不变，见 Doc/TODO.md #29）。
「关联基点」下拉选这个节点相对哪个基点计算测量数值，留空＝用场景第一个基点兜底；橙色标记的基点新增/编辑在「场景」Tab（见 Doc/EDITOR-SPEC.md §8）。
删除贴图 · 二次确认
材质清理
把「fallback Material」「material_N」这类占位名，按引用它的节点名批量改成能看懂的名字（已有正常名字的材质不动）
黑色材质替色（b / c 二选一）
只对 baseColor 接近纯黑（RGB 三通道均 < 0.05）的材质生效
把节点缩放烘焙进网格顶点数据，节点 scale 写回 (1,1,1)，世界空间外观不变
包围盒
模型
该模型当前没有选中节点——请先在「模型块」Tab 里选中一个节点，或者切换到其它模型。
默认按节点世界空间旋转角生成定向包围盒（OBB，不是简单轴对齐盒子）；下面旋转角可手动改，改完自动按新角度重新计算尺寸/中心并重画线框（青色虚线，区别于节点选中的黄色实线框）。
尺寸
—
中心
—
中心点
模型
该模型当前没有选中节点——请先在「模型块」Tab 里选中一个节点，或者切换到其它模型。
① 关联到一个已有基点；② 或者以当前节点的世界坐标新建一个基点（新建后自动关联当前节点）。下面显示这个基点当前的位置，改了直接保存，视口橙色标记同步刷新。
关联基点
当前基点位置
X
Y
Z
朝向°
没有可用基点——点上面「＋以当前节点位置新建基点」创建一个，或去「场景」Tab 新增。
基点×包围框测量
包围框
基点
角点基点同时决定视口浮动标注贴哪一面（Doc/TODO.md #70）
没有可用的包围框或基点——先去「场景」Tab 分别新建至少一个。
对齐到已加载模型
已加载模型
该模型的基点
新模型自己的基点
重放操作脚本
预览
滚轮缩放
就绪