Onshape 多色图标

让 Onshape 的命令更容易辨认：保留原生图标轮廓与留白，增加蓝色强调，并提供可选的命令文字、功能分组和视图测量标注。

适用于 Microsoft Edge 和 Google Chrome，当前版本 0.5.3。这是社区浏览器扩展，与 Onshape / PTC、SOLIDWORKS / Dassault Systèmes 无隶属关系。

功能

• 打开原生测量工具时，在视图中显示距离及红 X、绿 Y、蓝 Z 分量标签；跟随旋转、缩放、原生单位与参考坐标系。测量标注独立开关，默认开启。

• 撤销、重做始终为独立按钮；装配体插入单独显示，更新参考零部件等操作保留在左侧。

• 分类按钮左右分离：左侧执行上次使用的命令，右侧 24 像素箭头展开菜单。

• 为原生 SVG 图标添加蓝白黑配色，保留轮廓、留白及已识别的状态颜色。

• 分别开关工具栏、菜单及特征树的配色。

• 可选显示命令文字；草图直线、矩形等绘图工具保持图标模式。

• 实验性功能分组默认关闭，升级至 0.4.6 会重置旧版分组状态；可主动开启，关闭即恢复原生工具栏。分类包括：实体生成、编辑、配合、曲线与曲面、基准等。

• 分类首次显示常用命令图标，之后记住该分类上次选用的命令图标。

• 分类和菜单文字跟随 Onshape 原生字体样式；短名称按钮自动收窄，长名称设宽度上限；空间不足时换行，搜索固定在右侧。

• 图标强调色支持颜色选择器和十六进制色号输入，可恢复默认蓝色。

安装

1. 在 Releases 下载 onshape-multicolor-icons-v0.5.3.zip，解压到一个长期保留的文件夹。
2. Edge 打开 edge://extensions；Chrome 打开 chrome://extensions。
3. 开启 开发人员模式 / 开发者模式，点击 加载解压缩的扩展程序。
4. 选择解压后直接包含 manifest.json 的文件夹，不要选择 ZIP 文件。
5. 刷新 Onshape 页面，在浏览器扩展菜单中打开 Onshape 多色图标。
6. 需要分类菜单时，同时开启 显示命令文字 和 按功能分组。

也可以通过 GitHub 的 Code → Download ZIP 下载源码，解压后选择包含 manifest.json 的目录，无需编译。

更新时，用新版文件替换原安装文件夹的内容，在扩展管理页面点击重新加载，再刷新 Onshape。关闭分组会恢复原生工具栏；卸载扩展后刷新页面即可恢复原显示。

测量标注

0.5.3 将四个测量数值分散到测量线周围的不同方向，并自动避让，避免竖向堆叠。

0.5.2 略微加粗测量虚线，将数值标签移到测量线外并用引线连接；标注同步跟随视图旋转，减少滞后和重复更新。

0.5.1 修复了原生测量选择“全部显示”时，视图标注下拉框为空的问题；中文和英文界面均支持。加载测量时显示更新提示，已有原生结果时不再误提示重新选择两个图元。

1. 在扩展面板开启 视图测量标注（距离与 XYZ）。配色和功能分组可以关闭。
2. 在 Onshape 中选择两个图元，打开右下角的测量工具，或使用快捷键 [。
3. 在测量窗口新增的 视图标注 下拉框选择最小距离、中心距离或最大距离等当前可用的结果。
4. 视图中显示总距离及 ΔX、ΔY、ΔZ 标签。A、B 标识测量端点，彩色虚线显示从 A 到 B 的坐标分解；数值与原生测量一致。

X、Y、Z 取决于测量坐标系，不固定对应屏幕左右或上下。默认使用全局坐标系；原生测量设置参考配合连接器后，标签沿其坐标系显示。单位与精度跟随原生测量设置；带星号的数值保留原生公差提示。

当前增强用于 Part Studio 和装配体中的图元间距离。角度、半径、直径、面积和工程图测量继续使用原生结果。不能可靠取得端点或投影时，停止绘制视图标签，保留原生测量。关闭测量窗口或关闭扩展开关后清除标注。

Onshape 本身已支持悬停显示测量线，以及点击数值使其保持可见；本扩展增加同时可见的数值标签与坐标说明。参见 Onshape 测量工具。

范围与限制

• 只匹配 https://cad.onshape.com/*，暂未覆盖企业专属域名。
• 第三方 FeatureScript 图片图标保持原样；部分没有原生 SVG 的命令不会显示专属图标。
• 不改变模型视口的光照或零件色号，不提供 SOLIDWORKS 渲染效果。
• 功能分组与测量标注依赖 Onshape 当前的内部服务；Onshape 更新后可能需要适配。识别失败时保留原生界面，也可独立关闭增强功能。
• 已在隔离 Edge 环境验证图标、分组、记忆、布局及恢复；测量测试覆盖端点区分、视角、画布缩放、坐标变换、单位和开关恢复。内部服务使用模拟环境测试，未完成登录文档端到端测试。Chrome 的安装方式相同，仍需实际使用验证。

更多显示设置说明可打开随包提供的 guide.html。

隐私与权限

只申请 storage 权限，用于本机保存显示开关、强调色与各分类的最近命令。扩展脚本运行于上述 Onshape 域名，不含遥测、不读取 Cookie、不自行上传数据，也不调用模型 REST API。测量增强临时读取当前原生测量结果、端点和视角；不保存这些数据，首次接通时通过原生测量功能刷新结果，不修改模型。

点击分类菜单会调用对应的 Onshape 原生命令；拉伸、删除等操作仍由 Onshape 按用户操作执行。扩展无需 API 密钥。

开发与反馈

修改源码后，在扩展管理页面重新加载扩展，再刷新 Onshape。提交问题请附浏览器版本、扩展版本、Onshape 所处模式（Part Studio / Assembly / Sketch）及复现步骤；截图请遮挡不希望公开的文档信息。

主要文件：palette.js 和 content.js 处理图标；command-labels.js 处理文字；grouped-toolbar.js 处理分类菜单；toolbar-bridge.js 对接原生命令；measurement-bridge.js 读取原生测量并投影视图；measurement.js 显示测量标注，measurement-layout.js 安排标签位置；popup.* 提供显示开关。

许可证

MIT。许可证适用于本仓库原创代码与文档，不授予 Onshape 或 SOLIDWORKS 商标及其图标资源的权利。扩展引用当前 Onshape 页面已有的图标，不打包其图标库或客户端代码。