dsh-plugin-3d-viewer

使用

在消息里让助手输出任意一种写法：

```3d
D:\models\demo.obj
```

或

[3d:D:\models\pump.glb]

右侧栏面板的两种打开方式：

1. 点任意三维视图右上角的「侧栏预览」→ 右侧栏自动展开并显示该模型；
2. 展开右侧栏 → 在页面列表里选「3D 模型预览」→ 列出本会话出现过的所有模型。

---

配置

环境变量（宿主进程）	默认	说明
DSH_3D_VIEWER_REPRO_ROOT	空	开发用：指向一个只读目录即可启用 GET /repro/... 静态测试页。留空则不注册该路由（发布安装不会暴露任何本地目录）

客户端内置上限（lib/client.js 顶部常量）：

常量	默认值	含义
MAX_VIEWERS	4	同时存活的三维视图上限（超过则回收最旧的，防 WebGL 上下文耗尽）
BREAKER_MAX	40	熔断阈值：BREAKER_WINDOW_MS（8 秒）内挂载超过这个数就停止自动挂载
THREE_TIMEOUT_MS	8000	three.js 源加载超时（超时换下一个源，不再无限转圈）

自诊断：浏览器控制台输入 __dsv3d 可看到当前状态（存活查看器数、缩放半径范围、是否触发熔断）； __dsv3dPanel 可看到侧栏面板登记的模型清单。

---