guiyidu-ui/dsh-plugin-3d-viewer ↗★ 0
dsh-plugin-3d-viewer
DSH 三维查看器插件：把助手消息里的 3d 代码块（或 [3d:路径] 链接）原地渲染成可旋转/缩放的 Three.js 视图，并在 DSH 右侧栏提供一个列出本会话模型的常驻预览面板。 适合需要直观查看、旋转和缩放3D模型文件（如obj/glb）的用户。
Install
This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗
README
Read the full README ↗使用
在消息里让助手输出任意一种写法：
```3d
D:\models\demo.obj
```
或
[3d:D:\models\pump.glb]
右侧栏面板的两种打开方式：
- 点任意三维视图右上角的「侧栏预览」→ 右侧栏自动展开并显示该模型；
- 展开右侧栏 → 在页面列表里选「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 可看到侧栏面板登记的模型清单。