AI 辅助开发实战:用 Vue 3、Three.js 和 Yjs 做一个多人协同点云标注工具
这个项目的目标,是让多人在同一份点云上完成点、线、面标注:找到准确的空间位置,绘制和修正几何,补充业务属性,再把标注要素同步给其他参与者。
以道路点云为例,点可以表达路侧设施或关键位置,线可以描绘道路边缘和车道边界,面可以表达地面区域或建筑表面。点云提供空间依据,标注要素则把这些空间信息变成可编辑、可保存的数据。
做这个项目时,我把 AI 编程助手引入了需求拆解、方案设计、跨模块实现和问题修复。开发过程中最有价值的部分,是让 AI 围绕一个具体问题,把交互、坐标、文档、协作和测试串起来,再用实际点云检验结果。
这篇文章重点介绍三类解决方案:点线面怎样落到点云上、坐标吸附怎样兼顾准确与稳定、多人怎样同步同一组标注要素。同时结合真实迭代,说明 AI 在开发中发挥了什么作用。

图 1:主编辑器的点云渲染回归画面,使用合成园区示例,画面经过局部裁剪。
一、先围绕点云标注组织技术栈和工作台
1.1 前后端分别承担什么
| 部分 | 当前技术 | 与标注任务的关系 |
|---|---|---|
| 前端界面 | Vue 3、TypeScript、Vue Router、Naive UI | 标注工具、图层与要素列表、属性和坐标编辑 |
| 构建工具 | Vite | 页面开发与构建 |
| 三维视口 | Three.js | 显示点云与标注、相机导航、空间拾取、绘制预览 |
| 协作文档 | Yjs | 图层、标注要素、顶点和属性的增量合并 |
| 临时在线状态 | Awareness | 成员、光标、选择和当前操作状态 |
| 实时服务 | Node.js、WebSocket | 房间管理、初始同步、更新校验和广播 |
| 业务后端 | NestJS 12、Prisma 7、PostgreSQL | 认证、项目成员权限、数据集、空间服务、任务和审计 |
当前协作 WebSocket 由前端仓库中的常驻 Node 服务承载,NestJS 负责业务 API。点云二进制数据通过空间数据服务独立加载。
这样,项目权限、标注同步和点云加载各有明确入口。数千万个点不会跟着每次标注修改一起传输。

图 2:按当前实现整理的系统架构。中间的标注文档负责有效要素,右侧点云数据独立加载,底部协作房间负责增量同步。Awareness 与正式标注文档分别传递。
1.2 工作台围绕“定位—绘制—修正”布局
页面以左侧图层与要素列表、中间点云视口、可折叠的右侧属性检查器为主体。顶部放选择、点线面绘制、顶点编辑和测量工具;视口内用绘制 HUD 提示当前节点、吸附状态、长度和面积。底部工作台提供处理工具箱、AI 助手、脚本编辑、操作历史、控制台和任务管理,可按需展开。

图 3:点云标注工作台。左侧要素树管理点、文本、线和面,中间视口同时显示点云与标注结果;此时右侧属性面板收起,底部展开处理工具箱。
左右面板可折叠和调整宽度,视口可最大化,布局偏好保存在本地。这样,精细描边时可以扩大画布,检查属性时再恢复面板,减少标注过程中的来回切换。
1.3 标注数据与三维对象分开
标注要素使用独立的领域模型,包含稳定 ID、图层、几何、样式和业务属性。Three.js 根据文档生成显示对象;控制柄、吸附标记和草稿属于运行时辅助内容。
Vue 标注界面
→ 编辑器命令
→ 领域校验与标注文档
→ Three.js 显示更新
→ Yjs 增量同步
实际分层对应 domain、core、drawing、renderer-three 和 collaboration。界面通过编辑器门面发出命令,文档和渲染器通过接口接入。
这个边界贯穿了后面的方案:拾取负责提供坐标,绘制负责形成几何,文档负责保存有效标注,协作负责合并与传播。
二、点线面标注:从鼠标落点到有效要素
2.1 三种标注,共用一条处理链路
| 类型 | 几何结构 | 主要交互 | 关键约束 |
|---|---|---|---|
| 点标注 | Point | 确认一个空间位置,编辑名称、样式和属性 | 坐标有效、所属图层可编辑 |
| 线标注 | LineString | 逐个增加节点,预览折线,完成后编辑顶点 | 至少两个节点,避免相邻重复点 |
| 面标注 | Polygon | 绘制边界、闭合预览、显示面积 | 至少三个有效顶点、非退化、共面且通过几何检查 |
这三种工具共用“空间落点 → 吸附 → 几何约束 → 草稿预览 → 正式提交”的链路,差异集中在完成条件和几何规则。
例如,道路边缘可以使用折线表示,高差保留在各个顶点的 XYZ 中;建筑表面使用平面多边形表达。不同坡面需要分别绘制,当前多边形模型表达的是一个平面区域。

图 4:点云上的绘制效果。斑马线区域被标注为四顶点多边形,右侧检查器展示样式、顶点数量、周长、面积与有效性;画面中还保留了屋顶上的点、线、面要素。
2.2 点云是离散的,落点需要容差拾取
在网格模型上可以直接做三角形求交,点云却只有离散采样。要求鼠标射线恰好穿过一个点,实际操作中很难命中。
当前实现先从屏幕位置生成相机射线,对已加载且可见的点云瓦片做包围盒粗筛,再搜索射线附近的候选点。
设射线起点为 o、单位方向为 d、候选点为 p:
t = dot(p - o, d) // 沿射线方向的深度
e = length((p - o) - t × d) // 到射线的垂直距离
先排除相机后方和超出查询距离的点,再通过容差筛选,并结合深度和偏差选择结果。当前容差随观察距离和 LOD 点间距变化:
const tolerance = Math.max(0.18, depth * 0.0035, chunk.spacing * 1.5);
它让近处、远处和稀疏点云都具备可操作的命中范围。这是交互拾取阈值,不能当成测量精度承诺;当前结果也依赖已加载的 LOD 数据。
确认标注节点后,文档保存项目空间中的坐标。后续 LOD 替换或瓦片卸载,不会重新计算并移动已经确认的节点。
2.3 点云空洞时,保留正在绘制的表面
绘制屋顶区域时,鼠标可能经过点云空洞。如果未命中就退回默认地面,下一顶点会突然落到另一高度,面也随之拉长或校验失败。
当前处理顺序是:
- 优先使用点云射线拾取结果。
- 多边形已有足够的非共线节点时,用这些节点确定绘制平面;点云未命中时,尝试射线与这个平面求交。
- 尚未建立多边形平面时,使用配置的水平工作平面作为回退。
- 射线无法与既有多边形平面有效相交时,返回无效落点,保留当前草稿。
这让“点云表面命中”和“辅助平面求交”承担不同职责:前者提供数据依据,后者维持绘制过程的空间连续性。
2.4 多边形需要吸收拾取噪声,同时保留几何约束
点云表面并不完全平整。用户沿同一个屋顶点击,获得的几个位置仍可能有少量高程偏差。把这些坐标直接提交给严格共面校验,会造成“看起来在同一面上,却总是提交失败”。
当前做法是先根据已确认节点确定平面,再检查候选点到平面的距离。小范围偏差允许投影修正,偏差过大则提示选择同一表面。
投影关系可以写成:
signedDistance = dot(n, p - planeOrigin)
correctedPoint = p - signedDistance × n
交互修正阈值随几何范围变化,当前限制在 0.1~0.25 场景单位之间;正式写入仍使用领域层的几何校验。
更关键的是,吸附标记、候选光标、预览边、预览面和最终提交共用修正后的同一个坐标。如果预览用修正值,提交却用原始点,用户看到的结果就与保存结果不一致。
面积也在多边形自身的平面上计算,避免把斜面或立面投影到某个固定水平面后得到错误数值。
2.5 草稿独立,用户确认后才产生正式标注
绘制由 DrawingSession 管理,核心阶段是:
Ready → Drawing → CanComplete → Committing → Completed
└──── 取消 ─────────────────→ Cancelled
鼠标移动更新候选位置和动态线面;点击增加草稿节点;完成时执行几何检查并创建正式要素。提交失败时保留草稿,允许用户继续修正。
草稿不会进入正式要素列表,也不会产生连续的文档写入。因此,撤销一个临时节点和撤销一项正式标注,是两种清楚的操作。
输入处理还会区分单击和拖动,避免旋转相机时误加节点。一次完成只提交一份几何,双击结束折线也需要防止重复端点。
三、坐标吸附:解决“看着接上了,实际没接上”
3.1 先定位到点云,再决定吸附到哪里
点云拾取提供一个原始落点;矢量吸附让它与已有标注对齐;网格吸附提供规则化位置;面约束再保证最终几何有效。

图 5:从鼠标落点到有效标注的处理链路。吸附解析之后仍需检查几何约束,最终预览和提交共用修正结果。
这几个步骤分开后,替换点云加载器时,可以继续复用标注吸附和几何校验;调整吸附体验时,也不必改动底层点云格式。
3.2 用屏幕距离决定是否命中
当前候选包括:
| 候选 | 用途 | 当前实现边界 |
|---|---|---|
| 多边形起点 | 明确结束边界并闭合 | 具备足够节点后参与 |
| 已有顶点、折线端点 | 对齐已有标注位置,减少连接缝隙 | 候选按当前工作平面高度筛选 |
| 边候选 | 提供边上的规则连接位置 | 当前是边中点候选 |
| 网格点 | 规则化水平位置 | 在 XY 上取整,保留 Z |
候选先投影到屏幕,再计算它与鼠标之间的 CSS 像素距离。默认阈值为 10px,可调整为 2~40px。
使用屏幕距离,缩放后仍能保持相对一致的操作手感。最终采用的则是候选的世界坐标,让视觉上的吸附对应到实际保存的空间位置。
当前优先级为:
闭合起点 → 顶点 / 端点 → 边中点 → 网格 → 原始落点
边中点吸附适合规则连接位置;整条边上的最近点投影和跨高度候选筛选,是后续可以分别扩展的方向。
3.3 通过滞后范围抑制跳点
两个候选挨得很近时,鼠标轻微移动就可能让“最近候选”切换。如果每次都立即切换,标注会显得抖动,点击也难以预测。
当前吸附器记住已锁定的候选 heldId,退出范围比进入阈值多 3px。同优先级的新候选需要明显更近,才替换已有目标;更高优先级的闭合目标可以优先接管。
另外,同一坐标上的候选会去重;当端点与普通顶点重合时,保留更明确的端点语义。HUD 用文字和不同标记展示当前吸附类型,帮助用户确认即将采用的位置。
这部分没有改变几何算法的复杂度,却直接改善了连续描线和闭合面标注的稳定性。
3.4 顶点拖动量化位移,避免破坏原有高度
已有标注的坐标通常不是整齐的整数。例如屋顶高度为 20.03,如果拖动时直接对 XYZ 绝对坐标取整,轻微操作也可能把整个面拉出原有平面。
当前拖动量化的是相对于起点的位移:
snappedDelta = round((candidate - origin) / step) × step
nextPosition = origin + snappedDelta
对水平线面,普通拖动保留高度;对斜面或立面,先量化平面内的自由分量,再根据平面法线解出依赖分量,使位移满足:
dot(planeNormal, delta) = 0
这样,拖动吸附能够与共面约束共存。当前也提供独立的高度调整模式,避免一次普通拖动同时引入不易察觉的高程变化。
3.5 坐标约定贯穿显示、拾取和吸附
主编辑器使用 Z-up:XY 是水平面,Z 表示高度。当前 Binary 点云源的轴顺序为 [east, height, north],进入编辑器时转换为 [east, north, height]。
转换同时作用于点坐标、瓦片包围盒、表面采样和射线拾取;网格、工作平面和相机预设也需要遵守同一约定。
只设置 camera.up 无法完成这些工作。标注坐标一旦与显示坐标不一致,就可能出现点得中却落错位置、吸附方向异常,或错误裁掉一部分点云的问题。
四、多人协同:点线面要素的增量同步
4.1 把标注、点云与在线状态分开
协作时共享的是图层、点线面要素、顶点坐标、属性和轻量点云来源引用。相机视角、面板布局和未完成草稿保留在各自客户端。
成员名称、颜色、光标、选择和当前活动通过 Awareness 发送。点云二进制由每个人独立加载,也不进入 Yjs。
这种组织方式允许两个人从不同角度观察同一份点云,分别完成标注,同时看到对方已提交的要素变化。
4.2 稳定顶点 ID,解决并发插入后的定位问题
假设一条道路边线有四个顶点。A 在第二个顶点后插入一个新点,B 同时移动原来的第三个顶点。如果修改目标仅用数组下标表示,插入之后就可能改错位置。
当前使用稳定的 FeatureId、VertexId 和 RingId。以折线为例,Yjs 中的几何结构为:
features: Y.Map<FeatureId, Y.Map>
└── feature
├── style: Y.Map
├── properties: Y.Map
└── geometry: Y.Map
├── verticesById: Y.Map<VertexId, Y.Map>
│ └── vertex → { id, position: [x, y, z] }
└── vertexOrder: Y.Array<VertexId>
verticesById 保存实体,vertexOrder 保存顺序。B 始终按 Vertex ID 定位,A 的插入不会改变这个身份。
插入时,在同一事务里创建顶点实体并修改共享顺序:
// 已通过图层、ID 和候选几何校验;省略元数据更新。
ydoc.transact(() => {
const yVertex = new Y.Map<unknown>();
yVertex.set("id", vertex.id);
yVertex.set("position", [...vertex.position]);
verticesById.set(vertex.id, yVertex);
vertexOrder.insert(insertIndex, [vertex.id]);
}, "local-command");
这里直接修改已有共享结构,避免重建整条折线而覆盖其他人的修改。
不同顶点修改可以独立合并;同一顶点使用完整 XYZ 三元组作为位置值,按 Yjs 规则解决竞争,不会把两个人的不同坐标分量随意拼接。并发规则保证收敛,业务上仍需要检查最终几何。
4.3 从本地标注命令到远端显示
一条要素修改的实际链路是:

图 6:一次已连接会话中的要素同步。服务端先验证候选更新再合并和广播;虚线表示独立传递的临时在线状态。
本地命令使用 local-command,远端合并使用 remote。来源标记让远端修改不会再次无限转发,也不会混进当前用户的撤销历史。
文档消息使用二进制帧,版本和消息类型之外直接承载 Yjs update;加入确认、同步完成等控制消息使用 JSON。
4.4 先校验,后写入,避免一个坏顶点扩散
开发中遇到过一个严重问题:顶点移动触发容差错误后,页面无法继续操作。
这个问题不能只在界面上弹出错误。因为 Yjs 的事务不提供数据库式的异常回滚,如果先写共享坐标再校验,即使抛出异常,无效数据也可能已经进入撤销、保存和同步链路。
当前顶点移动和插入先构造普通候选几何,通过校验后再写共享类型。服务端则先复制房间状态到隔离的 Y.Doc,应用候选 update,检查快照结构、引用和几何,成功后才合并到房间文档。
拖拽收尾也需要可靠:先清除拖动状态并恢复相机控制,再提交命令;无论成功、拒绝还是取消,都根据有效文档恢复显示对象。
这样,非法顶点不会先污染房间基准,一次失败也不会锁死后续标注。服务端拒绝候选更新并不等于自动修复了几何冲突,界面仍需明确反馈失败与恢复状态。
4.5 初始同步、重连和撤销各有规则
进入房间时,客户端通过状态向量请求缺少的更新,可编辑客户端也把服务端缺少的部分传回。完成握手后才进入可编辑的已连接状态。
短暂断线保留当前页面的 Y.Doc。已同步过的可编辑会话可以继续本地修改,在原房间和会话仍有效时,通过状态向量补齐双方差量。传输层限制发送积压,并采用有上限的退避重试。
撤销使用 Y.UndoManager,只追踪本地命令:
const undo = new Y.UndoManager(ydoc, {
trackedOrigins: new Set<unknown>(["local-command"]),
captureTimeout: 500,
});
顶点拖动在结束时提交,并显式划分撤销捕获边界。A 撤销自己的操作时,不会通过恢复整份旧快照覆盖 B 的标注。
只读角色同时受到客户端文档命令和服务端写入检查约束。分享会话、房间过期和页面刷新,则需要结合快照或副本恢复处理。

图 7:两张历史分享回归截图的权限提示对比,分别为编辑会话和只读会话。这里展示的是会话权限界面,多客户端的要素传播过程见图 6。
4.6 光标让协作过程可感知
成员的光标使用世界坐标发送,各客户端根据自己的相机投影显示;选中标注使用成员颜色提示。光标变化合并为约 20Hz 的最新状态,并在远端平滑展示。
用户能知道“谁正在这一区域操作、谁选中了这条边线”,同时可以保留各自视角。当前这种提示提供协作感知,并不构成同一要素的排他锁。
4.7 分享链接也要带上点云场景依据
分享进入后只看到矢量、没有点云,通常说明标注文档恢复了,但点云来源仍只存在于原页面的加载流程中。
当前文档和快照保存轻量引用:
interface PointCloudSource {
id: string;
name: string;
url: string;
visible: boolean;
}
新客户端同步这些引用后,独立加载点云。文档共享的是场景对数据的引用,数据访问权限仍由实际服务授权决定。
五、AI 怎样参与这个项目的开发
5.1 把标注需求变成可实现、可验收的规则
“支持点云标注”太宽泛,AI 很容易给出一个能画点线面的演示,却遗漏真正影响使用的边界。
在这个项目中,需求需要继续拆成具体规则:点落在什么坐标系中,点云未命中怎么办,端点和网格谁优先,面是否要求共面,拖动失败后如何恢复,以及哪些状态参与协作。
AI 编程助手可以帮助把这些规则整理成数据结构、接口、状态机和验收场景,再沿着现有架构实现。需求文档也为下一轮修改提供持续上下文。
一个可复用的任务描述,可以写成下面这样。这里是对开发方法的归纳示例:
目标:让点云上的面标注在绘制和顶点编辑后保持有效。
现象:同一屋顶的采样点存在小幅高程偏差;拖动失败后无法继续操作。
约束:沿用现有绘制状态机、领域校验、Yjs 文档和 Z-up 坐标。
验收:
- 预览、最终坐标和保存结果一致;
- 合法的小幅拾取噪声得到修正;
- 不同坡面不被强行压成一个面;
- 非法候选不进入文档或传播给协作者;
- 操作被拒绝后,相机和下一次编辑仍然可用。
这类输入同时给出目标、复现条件、架构约束和验收结果,AI 才能围绕实际问题完成修改。
5.2 AI 的作用体现在跨模块的一致修改
点云标注中的问题经常跨越多个模块。坐标轴恢复为 Z-up,就不仅是相机设置,还涉及解码换轴、包围盒、表面采样、拾取、网格和视角预设。
顶点容差问题也同时涉及候选几何、拖动预览、Yjs 写入时机、错误处理和相机释放。
AI 在这里可以承担代码阅读、调用链梳理、修改实现和回归用例补齐。人提供业务目标、实际数据与使用反馈,并判断交互是否符合标注习惯。开发节奏因此形成一个循环:

图 8:AI 参与需求、架构阅读、跨模块修改和回归验证。开发以实际标注结果和验收条件作为判断依据。
“代码已经改了”和“真实数据已经正常”之间,仍然需要这一轮验证。
5.3 几个具体案例,说明怎样给 AI 有效反馈
| 实际问题 | 需要交给 AI 核对的链路 | 方案与验证重点 |
|---|---|---|
| 预览效果更新了,编辑器没有变化 | 预览入口与主场景点云入口 | 共享流式调度,分别适配材质、坐标和交互 |
| 靠近点云出现明显截断 | 相机距离、near/far、数据包围范围 | 相机参数随观察距离和完整点云范围调整 |
| 点云方向与标注坐标不一致 | 解码、包围盒、拾取、采样、工作平面 | 统一 Z-up,并检查显示与空间查询是否一致 |
| 顶点容差错误后无法继续标注 | 拖动状态、候选校验、事务写入、结束清理 | 写入前校验,失败后恢复有效几何并释放交互 |
| 分享进入后缺少点云 | 快照、Yjs 数据源引用、加载生命周期 | 分享入口也能从文档恢复场景依据 |
这几轮迭代也暴露出 AI 开发中容易出现的偏差:只验证一个入口、只看一个示例,或者根据现象过早确定根因。
更有效的反馈是把数据名称、访问入口、操作步骤和预期行为一起给出。例如,“同一条数据在预览弹窗正常,进入编辑器后靠近屋顶出现截断”,就比“效果不对”更容易导向可验证的排查范围。
5.4 把修复结果留成回归用例
AI 参与修复后,项目把关键行为沉淀成测试。例如:
- 带小数高度的屋顶顶点,轻微拖动后保持原始高度。
- 斜面和立面的顶点拖动后继续满足共面约束。
- 非法顶点修改不进入 Yjs、远端更新和撤销历史。
- 被拒绝的拖动恢复可视对象,下一次拖动与插入仍可进行。
- 多客户端并发移动、插入,以及重复、乱序和重连后的更新能够按规则合并。
这些用例把“这一轮修好了”变成下一轮修改时可以再次检查的规则。回归时既要比较本地几何,也要检查远端文档、撤销记录和失败后的下一次操作,才能覆盖完整的标注链路。
5.5 统一命令也为项目内的 AI 助手提供入口
项目还注册了场景查询、要素创建和修改等 AI 能力。相关执行器通过编辑器门面调用业务命令,并保留参数校验、可写检查和预览执行模式。
这个设计延续了同一条原则:AI 工具调用也使用标注命令链路,使结果能够进入现有的校验、历史与协作流程。具体能力仍需逐项验证其操作语义。
当前点线面标注以人工交互和确认作为基础;开发中使用 AI 的价值,主要体现在方案形成、实现、诊断和验证这几个环节。
六、性能优化围绕持续标注展开
用户需要一边移动视角、一边拾取和修改标注。点云看起来足够细,还需要给输入响应、几何计算和界面更新留出时间。
6.1 限制当前视图的工作量
点云按空间瓦片和多级 LOD 加载,先用视锥排除画面外数据,再根据点间距、距离和视口焦距选择层级。当前屏幕误差阈值约为 2.5px。
主编辑器的默认帧绘制预算为 800 万点,多个可见数据集共享。分配时先建立粗层覆盖,再用剩余预算细化,优先改善当前观察区域。
已有覆盖后,等待相机稳定约 180ms 再请求更多细节,减少连续移动视角时的无效加载。
6.2 解码、上传和回收分别控制
点云加载与解码放进 Worker,结果通过 Transferable ArrayBuffer 传递。主线程使用有容量预留的队列分帧接纳数据,避免多个分块同时完成时集中创建几何。
当前每个数据流的加载并发上限为 8,上传队列容量为 32MiB;队列消费有字节、任务数和时间软预算。离屏瓦片按使用时间和常驻点阈值回收。
位置与颜色解码后的数组约占每点 16 字节,此外还有原始数据、GPU 副本和其他对象。绘制预算与整个页面内存需要分别管理。
6.3 鼠标预览不带动整个界面刷新
绘制预览使用预分配缓冲和实例化节点,吸附候选的屏幕投影随相机与对象变化失效,避免每次鼠标移动重复构建所有内容。
Vue 侧使用 shallowRef 保存编辑器句柄和快照,绘制状态独立订阅,减少高频预览对要素列表的影响。
当前正式要素更新仍存在较宽的失效范围:要素命令会更新时间戳,可能触发项目级刷新。进一步区分元数据变化与结构变化,是后续优化方向。
6.4 用运行指标检查实际体验
主编辑器提供 FPS;空间服务预览还显示当前参与绘制的点数,以及分块和 LOD 状态。
这些指标帮助判断:移动视角时工作量是否受控、停止后是否开始细化、点数变化是否符合预算。当前主编辑器仍持续渲染,配置中的点数上限也不代表任何设备都能稳定达到某个帧率。
性能评估应使用固定数据、视口和相机路径,分别观察加载、持续运动和稳定标注阶段,再比较帧耗时与内存。
七、当前方案的边界与阅读入口
继续完善时,重点仍然围绕标注质量与可恢复性:高精度点云复核、跨高度吸附策略、细粒度业务冲突反馈,以及更可靠的服务端持久化。
当前本地快照采用防抖保存;服务端在房间关闭等时机归档普通项目快照。活跃房间、连接和票据仍属于当前进程,不能把“已经显示”“已经同步”与“已经持久保存”视为同一个状态。
下面是与本文方案直接相关的源码入口,路径相对于仓库根目录:
| 主题 | 源码入口 |
|---|---|
| 点线面工具与命令 | editor/core/editor.ts、editor/core/tools.ts |
| 草稿、共面约束、吸附 | editor/drawing/session.ts、editor/drawing/geometry.ts、editor/drawing/snap.ts |
| 拾取、坐标与顶点拖动 | editor/renderer-three/renderer.ts |
| 点云查询与流式调度 | src/tools/pointcloud-preview/point-cloud-stream.ts、point-cloud-decode.ts |
| 要素协作与本地撤销 | editor/collaboration/yjs/document.ts、session.ts、undo.ts |
| 房间验证与广播 | server/collaboration/websocket.ts、service.ts |
| AI 能力与执行 | editor/ai/capabilities.ts、editor/ai/executor/ai-tool-executor.ts |
| 回归验证 | editor/testing/drawing/、editor/testing/multi-client/ |
架构和交互规则还可对照仓库的领域模型、绘制规范、点云拾取协议与协作实现文档阅读。早期文档保留了 React/Next.js 阶段的设计,具体实现以当前 Vue 版本代码为准。