OpenGemCutting 2.2.0 · 尺寸、重量与加工几何参考

成品尺寸、重量与加工几何参考现在可以在同一工作台完成。

• 按长、宽、总高、冠高、亭深或目标重量换算；采用尺寸可撤销，保持切型造型。
• 支持预设比重与自定义材质名称；试算在面板往返中保留。
• 加工表明确显示已采用尺寸，提供几何基准图和中英文 PDF；整数／小数分度与网页一致。
• 切割助手提供只读查看与逐面定位；可选 MCP 新增 design_measure 与 design_set_size。
• 中英文操作手册各 40 页，附真实案例。更新 Vite 与 Hono 安全补丁。

Finished dimensions, estimated weight and geometric machining references are now available in one workbench, with undoable scale adoption, named materials, retained calculator trials, a reference diagram, and bilingual PDF export.

验证：完整 check:mcp、公开扫描、零已知漏洞依赖审计、浏览器流程与中英文手册检查通过。5 项依赖未公开历史实验室包的回归按既有规则跳过。

几何读数不是机器平台高度或升降量；本版不包含设备适配。重量为基于体积与比重的估计，不是原石出成率。

OpenGemCutting 2.1.3 · 技术支持与官方团队

技术支持与官方团队入口

• 各页面统一显示“技术支持”，GitHub 仓库链接收进浮层，减少顶栏重复入口。
• 展示 SUVA / 地质大学博士说AI / 苏哇科技，接入 README 原有的企业微信“余博士开源技术群”二维码，可点击查看原尺寸。
• 故障反馈使用 GitHub Issues，想法和使用疑问使用 Discussions；集中提供源码、许可和团队发布记录。
• 诊断信息由用户主动查看后复制，只包含版本、语言、浏览器主版本、系统类型、视口和图形接口可用性。不自动上传，不包含设计文件、项目名称、路径、地址或错误日志。
• 支持浮层打开时暂停编辑交互，关闭后保留 CUT 草稿、观察模式和撤销记录；渲染失败时也可进入技术支持。

验证：完整 npm run check:mcp、公开内容扫描、应用及 MCP 依赖零漏洞审计、Pages 构建与本机浏览器验收。已验证各页入口、编辑草稿返回、帮助转入支持、光学往返、中英文、窄屏和二维码大图；未将此视为其他设备的实机验收。

本版沿用 v2.1.1 的个人非商业许可及历史 MIT／第三方许可边界。中英文 PDF 沿用 2.1 里程碑，新支持入口已更新到在线帮助和手册源说明，待下次手册里程碑统一纳入。

打开工作台的技术支持 · 许可范围

线上验收（2026-10-14）：PR #21 全部 7 项检查通过并合入 main（7337594）；Pages 部署 成功。真实浏览器诊断显示 2.1.3，支持浮层和二维码正常、控制台无错误；线上二维码与中英文 PDF 均与发布文件 SHA-256 一致。

OpenGemCutting 2.1.2 — 切割编辑性能修复

OpenGemCutting 2.1.2 — 切割编辑视口性能修复

新增冠部、编辑亭部时旋转模型，会触发大量辅助线线帽／接缝构建和实体缓冲重建。本版批量绘制辅助线，并让不透明实体在纯相机旋转时复用 GPU 填充；保留原有遮挡判定、线宽、圆角端点、X-ray 深度排序、真实切面和光学质量。

使用 #18 的 57 个保存 CUT、16 组工序模型复核。在 macOS / Chrome 155 / SwiftShader、1440×1000、DPR 1、光学小窗开启条件下，绘制耗时 p95：

场景	旧版	修复后
新建冠部（6/8 面有效）	11.9 ms	7.9 ms
新建冠部 X-ray	16.9 ms	13.1 ms
编辑 P1 亭部	6.8 ms	4.7 ms

这是绘制开销对照，不是端到端帧率或所有设备 60 fps 承诺。宿主负载会影响数值，未在报告者的 RTX 5060 Laptop 上实测。完整方法见 性能记录。

验证：完整 npm run check、Pages 构建、公开内容扫描、根项目与 MCP 依赖零漏洞审计；浏览器验证新增切割、51 面保存后撤销精确恢复 57 面原文档、亭部编辑、实体／X-ray 切换、GPU 上下文恢复保留草稿和光学仿真往返。

产品范围保持宝石切型的造型、刻面构造、光学观察和设计交付。本版不新增重量、出成率、保重比较或文件夹功能，#3 已给出明确结案说明；#16 作为 #18 的重复报告关闭。

沿用 v2.1.1 的个人非商业许可及历史 MIT／第三方许可边界，详见 许可范围。中英文手册操作内容不变。

References #18.

OpenGemCutting 2.1.1 — 个人非商业许可

OpenGemCutting 2.1.1 — 许可范围调整

本次仅更新许可、贡献规则和文档，应用功能及中英文手册与 2.1.0 相同。

• 首次按新条款发布的原创内容采用 OpenGemCutting Personal Non-Commercial License 1.0：仅允许个人非商业自用、学习、私下修改及备份。
• 禁止商业使用、软件二次分发、镜像、打包出售和对外托管。接单设计、设计／加工用于出售的宝石、公司内部生产均属于商业使用，须取得单独书面许可。
• 用户仍拥有自己的原创设计与输出；软件许可不改变切型来源本身的权利。
• 不追溯撤销旧 MIT 授权：v2.1.0 及此前已按 MIT 提供的内容、相同旧代码、外部贡献与第三方组件保留原许可；GitHub 站内查看和 fork 权利保留。本项目新条款属于源码可见的受限许可，不是 OSI 开源许可。

准确迁移边界以本次 v2.1.1 标签所指提交为准。请阅读 LICENSE 和 许可范围说明。

验证：完整 npm run check、Pages 构建、公开内容扫描、Companion 测试、官方插件结构 validator、根项目与 MCP 依赖审计；本地浏览器检查首页、静态资源和中英文手册。维护者确认本次发布，不代表已完成专业法律审查。

OpenGemCutting 2.1.0

OpenGemCutting 2.1.0

本版整合复合刀具与编辑工作流，并更新光学预览、切割助手、实验室和对话设计。

• 21 把复合刀具使用统一的选刀、参数编辑与加工报告；新增、取消和确认集中在操作栏上方。
• 凹切先预览、确认后加入序列；平切与凹切切换保留画布，统一侧栏宽度。
• 快捷光学默认台面，可独立旋转；操作时更新几何，松手后渲染，新操作取消旧任务。
• 切割助手从毛坯开始，先平切，再逐层演示启用的凹切。
• 图案实验室默认关闭磨砂细边，计算状态不再改变页面高度。
• MCP 补齐 18 把圈层／花式刀具的创建、局部编辑和打散，提供同源刀具目录与加工报告。升级后请重新连接 MCP 客户端。
• 中英文手册各 38 页，包含更新的工作流与对话设计说明；更新 MCP SDK 安全补丁。

在线工作台 · 安装 · 完整更新记录

光学预览用于设计比较，不保证实物效果；高面数编辑卡顿的社区报告 #16 仍待样本复测。材料重量比较与项目分类文件夹尚未实现。

OpenGemCutting 2.0.0

OpenGemCutting 2.0.0

2.0 正式版汇总多分度、凹切、环切与弧切、两个设计实验室、磨砂表面、GemCAD / Gem Cut Studio 格式中心、中英文手册及可选 MCP。

本次正式版前修正：

• 项目和实验稿使用事务保存，多窗口冲突明确提示，保留未保存改动并提供另存／恢复入口。
• 旧记录只读迁移，原始记录保留；旧版继续修改会创建独立副本。升级和回退前请阅读 UPGRADE.md，重要设计保留 JSON 主文件。
• 修复迟到导入、保存中撤销、删除失败与刷新保护；实验结果带回前确认新项目已经保存。
• 编辑和正交预览用冷灰色标记磨砂面，切割助手继续标明无需抛光。
• 修正 MCP 台面结构保护、显式四面方形起点及 ASC 导出核对；保持现有 16 个工具范围，其他网页能力见 docs/mcp/README.md。
• 中英文操作手册各 38 页，随包实验室继续使用固定 MIT 版本。

验证：完整工程检查与 MCP 测试、真实浏览器保存冲突及恢复、两个实验室带回、Pages 子路径预览、敏感信息扫描和依赖审计。光学仿真仍用于方案比较，不能替代实际切磨验证。

OpenGemCutting v2.0.0-rc.3 — 编辑器与实验室数据一致

起因：一份在编辑器里正常的设计（冠亭预设实验室带回后又整体升高）无法带入图案实验室。本版对编辑器和两个实验室做了一轮数据一致性梳理：切面是唯一几何真值，附加信息跟随切面，同一条规则只实现一处。2.0 的完整新增内容见 v2.0.0-rc.1。

• 能进编辑器的设计都能进实验室：图案实验室接受重合或近乎平行的切割平面，252 个内置预设全部可带入；超出平切预算、含凹切或从异形底胚开始的设计在入口说明原因；载入或带回失败显示具体原因。
• 常见操作不再打乱实验室数据：修正 96→77、99→96、120→99 换分度盘无提示失败；编辑图层保留每个面的身份与磨砂；整体升降、比例、分度旋转或单独修改组件切面后，冠亭预设实验室按切面恢复组件并说明；无关操作不再让实验配方永久失效。
• 各处数到同样的面：最终有效面排除取整碎片，面数、台账、PDF 与实验室一致。
• 冠亭预设实验室 0.5.0-rc.9：组件重复来源工序时应用前提醒并默认替换；新建实验使用方块底胚加整齿腰部，可继续进入图案实验室并导出 GemCAD／Gem Cut Studio；组件切面以来源图层命名。
• 图案实验室 0.6.0-rc.3.main.3d97f423432e：编辑过的环切／弧切层可正常带回；未标定时不写入毫米尺度；切面列表按图层名称与齿号显示。
• 公共契约 1.2.0；此前保存的实验稿继续可用。手册截图与中英 PDF 更新。

Fixes

Every design the editor opens can now enter both laboratories; wheel switches, layer edits and whole-design lifts, scales and rotations keep frosting, component groups and lab records; reports and laboratories count the same effective facets. Public contract 1.2.0 with pattern lab 0.6.0-rc.3.main.3d97f423432e and preset studio 0.5.0-rc.9; earlier drafts still load.

验证 · Verification

npm audit (root and MCP) 0 known vulnerabilities; public scan clean; npm run check:mcp passed (4 upgrade regressions for unpublished lab packages skipped by design); GitHub CI 7/7 passed; the reported design walked through import → pattern lab → frost → return → crown lift → both labs again on the Pages sub-path build in Chrome with no console errors. Details: docs/validation.md.

OpenGemCutting v2.0.0-rc.2 — 2.0 预发布修正

根据 v2.0.0-rc.1 线上演示的反馈修正，功能范围不变。2.0 的完整新增内容见 v2.0.0-rc.1。

• 三维加载提示：编辑画布、切割助手、底胚预览、光学仿真与两个实验室在渲染器就绪前显示“正在准备三维视图…”浮层并暂不响应拖拽，不再出现像故障一样的空白画布；加载失败时说明原因并可重试。主页空闲时预取三维渲染器，进入编辑通常无需等待。
• 实验室光学对比不再闪黑：拖动松手、从低分辨率预览切回全分辨率时保留上一张图像，直到新采样画出（图案实验室交付 0.6.0-rc.3.main.dfcee1e8e40b，继续接受此前保存的实验稿）。
• 中英图解手册按 2.0.0-rc.2 重新生成。

Fixes

3D views now show a loading overlay until their renderer has drawn (with retry on failure), and the home page preloads the renderer; the pattern lab's optical comparison keeps its last image on screen when a drag ends instead of flashing black.

验证 · Verification

npm audit (root and MCP) 0 known vulnerabilities; npm run check:mcp passed (4 upgrade regressions for unpublished lab packages skipped by design); public scan clean over 1941 text files; GitHub CI 7/7 passed; Pages sub-path build checked in Chrome with a throttled network.

Full changelog: CHANGELOG.md · PR #12

OpenGemCutting v2.0.0-rc.1 — 2.0 预发布

2.0 预发布

2.0 汇总 1.0 以来的全部设计能力：中英双语（1.1）、多分度、凹切、图案实验室与磨砂表面（1.2）、GemCAD 与 Gem Cut Studio 格式中心（1.3），以及本版新增。这是预发布版本：功能已冻结，正式版前只修正问题。欢迎试用并在 Issues 反馈。

本版新增

• 默认起点外形：新建项目可选“圆柱”（腰棱数只列出当前分度盘能整齿等分、不少于 8 的面数）或“正方形 · 四次对称”。
• 环切与弧切：把 L 边母形的每条边换成一组扇形面（同深），或鼓成圆弧、各面深度按弧线联动；构成器的实时顶视示意在切下去之前画出外形。可“打散”为普通层，ASC／GCS 按深度写为连续层。
• 冠亭预设实验室：与图案实验室并列，用阶梯、错层等配方生成冠亭变体，检查后带回为新项目。
• 尺寸与检查：已知物理比例的设计显示毫米尺寸，PDF 明确单位；“交点检查”列出值得复核的会合候选。
• 界面与修正：参数区改为右缘小标签开合、定位面板更紧凑；视图丢失后可重试恢复；英文界面若干文字与布局修正。
• 图解手册：中英各 38 页，按设计任务重组，新增“2.0 一览”与“新建项目”，全部截图按当前界面重采。

What's new in 2.0

Everything since 1.0 in one pre-release: bilingual interface, multi-index wheels, concave tools, labs and frosted finishes, and the GemCAD / Gem Cut Studio format center — plus, new in this release, square or chosen-count cylinder starts, ring and arc cuts with a live top-view sketch, the crown and pavilion lab, millimetre sizes with explicit PDF units, meetpoint inspection, and a 38-page illustrated manual in both languages. Features are frozen; only fixes land before 2.0.0.

验证 · Verification

npm audit (root and MCP) 0 known vulnerabilities; npm run check:mcp passed (4 upgrade regressions for unpublished lab packages skipped by design); public scan clean over 1938 text files; GitHub CI 7/7 passed; Pages sub-path build checked in a browser. Not verified: Windows hardware, Safari/Firefox, touch devices, a clean reinstall through the README prompt.

Full changelog: CHANGELOG.md · PR #10

OpenGemCutting v1.3.0 — GemCAD 与 Gem Cut Studio 格式中心

更新内容

• 格式中心：从主页或文件菜单进入。读取 GemCAD 文本（.asc）、GemCAD 存档（.gem，只读）、Gem Cut Studio（.gcs）与项目 JSON；可在工作台打开为独立项目、另存项目，或直接在 ASC 与 GCS 之间转换（没有台面的老设计也可以）。当前设计可导出为 ASC 或 GCS。
• 转换前说清差异：每个去向只列出这个设计里实际存在的信息——完整保留、会简化、会丢失或不能转换；有差异时一次点击“了解差异，导出”。ASC 与 GCS 导出后立即读回核对形状，不一致即停止导出。页面附各格式能力对照表。
• Gem Cut Studio：按 1.1 实际存档校准坐标与分度（亭部与腰部分度反向计数），带旋向的设计已在 Gem Cut Studio 1.1 中实机核对；磨砂与本软件磨砂表面互转并保留原值，隐藏层、材质颜色与说明信息往返保留。
• GemCAD：ASC 折行、负索引、平底尖与磨砂省略提示修正；行尾与 GemCAD 自身文件一致使用 CRLF；.gem 二进制存档只读，逐项越界检查。
• 导入比例：打开外部设计时整颗宝石保持在毛坯内，多边腰棱角不再被毛坯削出细条。
• MCP design_export 支持 format: "gcs"；中英图解手册各 34 页，新增“接手 GemCAD 与 Gem Cut Studio 的设计”。

What's new

A format center for GemCAD and Gem Cut Studio: read GemCAD ASC, GemCAD GEM (read only), Gem Cut Studio GCS and project JSON; open designs as separate projects or convert directly between ASC and GCS, including tableless designs. Each destination states what this design keeps, simplifies, loses or cannot carry, and ASC/GCS exports are read back before download. Gem Cut Studio conventions are calibrated on real 1.1 saves and checked in the program with a twisted design; frosted faces map to Gem Cut Studio frosting.

验证 · Verification

npm audit 0 known vulnerabilities; npm run check:mcp passed (3 upgrade regressions skipped by design); public scan clean; GitHub CI 7/7 passed. Not verified: Gem Cut Studio versions other than 1.1, GemCAD on Windows opening exported ASC, Windows hardware, Safari/Firefox, touch devices.

Full changelog: CHANGELOG.md · PR #7