feat(pcb): 2D/3D 渲染模式切换 pcb view-mode —— snapshot 前无法确定性选 2D 布局或 3D 视图（#40 只做了图层/side）

[zhoushoujianwork]

Problem

pcb snapshot 截的是「画布当前显示成什么」。EasyEDA Pro 的 PCB 编辑器有 2D 布局视图 和 3D 渲染 两种模式（工具栏 2D / 3D 按钮），但 CLI 没有任何命令能切换 2D↔3D 渲染模式，也读不回当前处于哪种模式。

结果：agent 截 PCB 图是「碰运气」——用户停在 3D，pcb snapshot 就得到 3D 渲染图；停在 2D 才得到 2D 布局图。做布局 QA（看焊盘/间距/丝印/走线）需要确定性的 2D；看装配观感才要 3D。现在 agent 无法自己选。

实测证据

• 评审一块 4 层车载盒子布局（166 器件），画布当时停在 3D 模式。
• agent 跑 easyeda pcb snapshot --window <id> → 返回 PNG artifact → 读出来是一张 3D 渲染图（不是 2D 布局）。截图动作是 agent 做的，但「出来是 3D」完全由用户的画布状态决定，agent 无从控制。
• 查遍 CLI：pcb snapshot（截图）、pcb view-side top|bottom（正反面，feat(pcb): add typed layer/view switching and current PCB layer readback #40）、view fit/region/zoom（缩放）都有，唯独没有 2D/3D 模式切换。

与现有能力的边界（都不是本 issue）

能力	命令	状态
截 PCB 图	pcb snapshot	✅ 有
切正/反面（2D 内的层/side）	pcb view-side	✅ #40 已实现
缩放/对焦	view fit/region/zoom	✅ 有
区域/选区导出	—	🔶 #166 跟进
切 2D 布局 ↔ 3D 渲染	❌	本 issue

#40 做的是「显示哪个图层/哪一面」，全在 2D 画布内；本 issue 是渲染模式（2D 平面 vs 3D 立体），两者正交。

Desired behavior

• pcb view-mode --mode 2d|3d（或等价 typed action）切换 PCB 渲染模式，供 snapshot / 人工 QA 前确定性设定。
• 读回当前模式（扩 board-info 或 pcb view-mode（无参）返回 currentMode）。
• 与 pcb view-side 组合使用（如 2D + bottom 截底层布局图；3D 截整体观感）。
• typed action，非 raw debug；支持 --project 路由、survive windowId churn。

Acceptance criteria

1. agent 能在不点 UI 的情况下把画布切到 2D（或 3D）。
2. 随后的 pcb snapshot 反映所请求的模式。
3. 能读回当前是 2D 还是 3D。
4. 与 view-side 组合可预期（2D+top / 2D+bottom / 3D）。

Notes

对 agent 做布局评审很关键：布局/DFM 判读要 2D（焊盘、间距、丝印、走线一目了然），3D 只适合看装配/连接器观感。没有这条，agent 的 PCB 截图对「看什么」是不可控的。

出处：easyeda-agent 使用者对一块 4 层车载盒子布局的评审会话（Claude 参与分析并实测 snapshot 行为）。

[zhoushoujianwork]

复验(v1.2.0 / EasyEDA Pro 3.2.149):没有 2D/3D 渲染模式切换 API,仍被上游挡

重新 probe(本票记录时是更早的版本):

$ easyeda api search "3D"
eda.pcb_Event.addRayTracerEngine3DViewCameraChangeEventListener   @alpha   ← 3D 预览相机变动【事件监听】
eda.pcb_Event.addRayTracerEngine3DViewClickMaterialEventListener  @alpha   ← 3D 预览点击材质【事件监听】
eda.pcb_ManufactureData.get3DFile                                 @beta    ← 导出 3D 模型【文件】
$ easyeda api search "render"
eda.dmt_EditorControl.getCurrentRenderedAreaImage                 @beta    ← 截当前渲染区域【图像】

有的全是「监听 3D 视图事件」「导出 3D 文件」「截当前画布」——没有一个能设置或读回
渲染模式。也就是本票的核心诉求(切 2D↔3D + 读回 currentMode)在 3.2.149 上依然无 API 可包。

值得注意的是 addRayTracerEngine3DView* 这两个监听的存在,说明平台内部有 3D 视图的状态机,
只是没把 setter/getter 暴露出来 —— 这条正好可以作为向官方提需求时的论据(「监听都给了,
给个 mode 的 get/set 吧」)。要不要提由你定,本票先保持打开、性质记为上游挡。

绕行现状不变:需要确定性 2D 时,只能请用户在 UI 点一下 2D 按钮再截图。

[zhoushoujianwork]

关闭:上游无 API,且没有「可做的那一半」

3.2.149 复验(上一条评论)结论:平台只给了 3D 预览的事件监听(addRayTracerEngine3DView* @Alpha)、
3D 文件导出(get3DFile)和当前画布截图(getCurrentRenderedAreaImage),没有任何
设置或读回渲染模式的入口。本票要的两件事(切 2D↔3D、读回 currentMode)在扩展 API 面上不存在,
也没有可以退而求其次的自研实现 —— 不像 #173 还能做个虚拟组。

所以本票留着只会一直挂着。关闭,跟踪转到 docs/upstream-issues.md;平台哪天暴露了
mode 的 get/set,直接重开本票即可(判据就是上面那句 probe)。

现状绕行不变:需要确定性 2D 时,请用户在 EasyEDA 工具栏点一下 2D 再截图;
pcb view-side top|bottom 与 view fit/region/zoom 在 2D 内照常可用。

(顺带记一条给将来提 upstream 用的论据:平台既然给了 addRayTracerEngine3DViewCameraChangeEventListener
这种监听 3D 视图状态的接口,说明内部有完整的 3D 视图状态机,只是没把 setter/getter 放出来。)