建模时也能像玩 3A 大作一样看小地图
迷你地图为 SketchUp 提供一个实时同步的二维平面覆盖层， 点击/拖拽即可瞬移摄像机；找模型功能可一键列出场景内所有模型实例， 方便在大型方案中快速定位、隐藏、删除或导出。
为大型 SketchUp 方案设计的导航与管理工具
插件不修改原始模型几何，只读取场景信息进行投影展示和摄像机控制，因此可以与任何工作流叠加使用。
实时二维投影
按可配置的剖切高度与剖切带厚度提取边线与面体外轮廓，几何变更后自动节流刷新（默认 0.6s 防抖）。
点击/拖拽瞬移摄像机
在迷你地图上左键单击切换观察位置，拖拽设置方向；以约 0.15s 周期同步摄像机标记，自由漫游也能跟随。
找模型管理面板
一键扫描场景里所有 Component / Group，按定义、面数、字节数排序，支持双击定位、隐藏、删除与导出列表。
活动区域聚焦
圈选矩形即可锁定地图焦点范围，避免大型场景中地图被无关几何体撑得过小。
可调表现风格
剖面高度、剖切带厚度、眼高、FOV、边数上限、简约风格、面体填充等参数全部内置滑杆/开关。
设置随模型保存
所有设置写入模型属性字典（YGMiniMapSettings），打开同一份 SKP 自动恢复参数。
工具栏一栏说明
安装后将在 SketchUp 中出现「迷你地图」工具栏，包含四个核心命令。
四步完成安装
支持 SketchUp 2017 及以上版本（依赖 UI::HtmlDialog），无需任何外部依赖。
下载 RBZ
点击页面顶部「下载 RBZ 安装包」获取最新版本文件 yg_minimap_v2.0.0.rbz。
打开扩展管理器
SketchUp → 菜单 窗口 / Window → 扩展程序管理器。
安装扩展
点击「安装扩展程序」，选择刚下载的 RBZ 文件，等待提示安装成功。
重启并启用
重启 SketchUp，确认「迷你地图」工具栏可见且菜单项已加入「Plugins / 扩展程序」。
视图 → 工具栏 中手动勾选「迷你地图」。
使用指南
从打开面板到瞬移漫游，掌握三步即可完成核心工作流。
① 打开迷你地图
点击工具栏中的「迷你地图」图标，或菜单 Plugins → 迷你地图 → 显示迷你地图。
面板首次打开尺寸为 440 × 600，可拖拽缩放，下次打开会自动记住位置。
② 在地图中导航
在迷你地图画布上：
- 单击 — 摄像机瞬移到该点，方向保持不变；
- 按住左键拖出小箭头 — 瞬移并设置朝向；
- 滚轮 — 缩放迷你地图视图（不影响主视口）；
- 勾选「跟随摄像机」 — 主视口移动时小地图自动平移以保持中心。
③ 找模型
点击工具栏「找模型」打开 780 × 850 的管理面板：
- 按 面数 / 字节 / 实例数 / 名称 排序；
- 双击列表行 — 视口缩放到该模型；
- 右键 — 隐藏、显示、删除或导出 CSV 报表；
- 支持搜索框模糊匹配定义名（输入
树即可筛出所有"树"模型）。
④ 划定活动区域
点击「划定活动区域」后在主视口拖两个对角点，地图将仅显示该矩形内的几何并自动聚焦；
想恢复全图查看时在菜单选择 清除活动区域。
参数与默认值
所有参数均可在迷你地图面板中实时调整，并通过「保存视图设置」写入当前模型。
| 参数 | 默认值 | 说明 |
|---|---|---|
cut_height | 47.244 in ≈ 1200 mm | 剖面顶部的 Z 高度，类似 CAD 平面图剖切线。 |
cut_band | 47.244 in ≈ 1200 mm | 剖切带厚度，向下延伸。区间内的边/面会被绘入地图。 |
eye_height | 65 in ≈ 1650 mm | 瞬移摄像机后的眼高，模拟成人视角。 |
fov | 60° | 瞬移后摄像机的视场角，更小=更长焦。 |
max_edges | 80,000 | 地图绘制边数上限，超过则自动等步抽稀，避免卡顿。 |
show_faces | true | 是否绘制面体填充（关闭后只画线，更接近 CAD 风格）。 |
hide_high_poly | false | 是否隐藏面数超阈值的模型（默认关闭，避免漏画结构件）。 |
high_poly_limit | 50,000 | 高多边形阈值，配合上一项生效。 |
simple_style | true | 简约线条风格（黑白），关闭则保留分组颜色。 |
follow_camera | true | 是否让小地图跟随主视口摄像机平移。 |
active_area | null | 活动区域 [minX, minY, maxX, maxY]，由"划定活动区域"命令写入。 |
进阶：Ruby Console 调用
所有核心 API 都暴露在 YGMiniMap 模块下，可在脚本或 Ruby 控制台中直接调用。
# 显示/隐藏面板 YGMiniMap::DialogManager.show YGMiniMap::DialogManager.hide # 瞬移摄像机到 (x, y) 并朝 (dx, dy) 方向 YGMiniMap::CameraController.jump_to(120.0, 60.0, 1.0, 0.0) # 读取/修改设置(单位均为英寸 inches) YGMiniMap::StateManager.settings YGMiniMap::StateManager.update('cut_height' => 39.37) # 1000mm # 重置全部参数为默认 YGMiniMap::StateManager.reset! # 找模型(独立 HtmlDialog) YGMiniMap::ModelFinder.show
常见问题
如有未覆盖的问题，欢迎反馈到 关于页 的联系方式。
地图里几何体显示不全或一片空白？
多数情况下是剖切高度不在模型范围内。把 cut_height 调到模型某层楼板上方 1200 mm，并把 cut_band 设为 1200 mm 左右，几乎可以保证墙体被切到。如果仍然为空，检查 hide_high_poly 是否误开。
大型场景打开后 SketchUp 卡顿？
把 max_edges 下调到 20,000–40,000；关闭 show_faces 只显示线框；如果仅关注主体区域，请使用"划定活动区域"功能聚焦。
"找模型"提示需要先保存模型？
这是因为模型实例索引依赖文件路径（SKP 文件位置）。第一次另存为/保存 SKP 文件后再次打开即可。
能否记住每个模型的不同参数？
可以。参数写入模型的 attribute_dictionary('YGMiniMapSettings')，每个 SKP 独立保存。点击"重置设置"会清空当前模型的字典。
瞬移后摄像机视场角变了？
瞬移会同时应用 eye_height 与 fov，这是设计行为以保证站立人视角一致。若想保留原 FOV，请将面板中的"应用 FOV"开关关闭。
支持 SketchUp Make 2017 吗？
支持。插件最低要求 SketchUp 2017（首次引入 UI::HtmlDialog），但建议在 2019+ 上使用以获得更稳定的 dialog 行为。
下载
当前最新版 v2.0.0，更新日期 2026-05。