多分度参数化琢型工作台 · 对话创作 · 浏览器本地运行
An open-source gemstone faceting workbench. Design through conversation, refine every cut.
立即体验 ↗ · 用 Codex 创作 · 中文手册 · English manual · 参与贡献
真实工作台 · 参数、工序和三维模型始终对应同一份设计
说出轮廓、比例和刻面节奏，让 Codex 构建真实模型；看过方案，再决定采用。也可以随时回到工作台亲手调整参数，沿着同一份设计继续创作。
| 用对话构思 | 用几何判断 | 把设计留下 |
|---|---|---|
| 从文字、草图或预设开始 | 三维与顶、底、侧视对照 | JSON 保留完整参数化工序 |
| 比较方案，继续提出修改 | 多分度（默认 96 齿）、重复、镜像与 Meet | PDF 切割报告便于沟通 |
| 预览后采用，也能撤销 | 光学仿真观察材质与亮暗 | 格式中心与 GemCAD、Gem Cut Studio 互通 |
 |
 |
| 看清造型与光线 在相同观察条件下比较材质、冠亭比例和亮暗。 |
理解每一道工序 逐刀或逐组回放；暂停、观察，再回到编辑。 |
v1.3.0 新增：格式中心——打开 GemCAD（.asc、.gem）与 Gem Cut Studio（.gcs）的设计，或把当前设计交给这些软件；每个去向先写明会保留、简化或丢失什么，导出后读回核对形状。磨砂面与 Gem Cut Studio 磨砂互转，无台面的老设计也能直接互转。详见 CHANGELOG。
展示琢型：PC 01.338 Eight Main Highlight，Long, R H & Steele, N W；来源 Facet Design v5 (1984) pC12。可在预设库按名称载入。来源与许可。
| 浏览器单机版 | Codex 对话版 | |
|---|---|---|
| 适合 | 立即体验，亲手调整切型 | 描述目标，让 AI 构建与修改 |
| 准备 | 打开网页即可 | 已安装并登录 Codex |
| 能力 | 参数编辑、预设、仿真、保存与导出 | 全部手动能力，加上对话设计 |
| 入口 | 打开 Live Demo → | 复制安装提示词 ↓ |
单机版不需要 Codex、MCP、账号或 API Key。两种方式共用设计内核，AI 是可选的创作入口。
顶栏提供 跟随系统 / 简体中文 / English。切换后继续同一份设计，参数、名称与撤销记录保持连续；界面、帮助和 PDF 工艺报告随之切换。语言偏好保存在当前浏览器和站点。
Choose your language in the top bar. Continue the same design with unchanged geometry, names and undo history. Interface text, help and PDF reports follow your selection. Both languages work in the standalone browser edition.
专业人士可核对 中英术语审阅表，其中包含语境、参考来源和意见栏。译稿尚待专业审核，欢迎提交带语境的修订。
在可以正常对话的 Codex 中粘贴：
请按照 https://github.com/yuyou-dev/OpenGemCutting/blob/main/INSTALL.md 安装完整 OpenGemCutting，配置运行环境、设计插件、MCP 和 skill，在 Codex 内置浏览器中打开工作台并确认连接。完成后告诉我如何直接开始琢型创作。
Codex 会检查依赖、配置设计组件，并核实对话对应的网页与项目。macOS 已实测；Windows 提供安装入口，实机支持进度见 支持与验收。首次加载工具时，客户端可能提示刷新或新开任务。
已经装好了？复制升级提示词
请按照 https://github.com/yuyou-dev/OpenGemCutting/blob/main/UPGRADE.md 升级我的 OpenGemCutting 和对话设计组件，先保存并导出重要设计，保留本地修改，完成后重新连接内置浏览器，让我继续创作。
在安装好的项目中，新开 Codex 任务并发送“打开工作台，开始对话设计”。随后像和设计伙伴讨论一样提出要求：
01 · 建立起点
帮我做一颗圆形、八向对称、台面清楚的基础琢型。可以从预设开始，先给我看真实模型。
02 · 比较修改
冠部再低一点，保留整体轮廓。给我看修改前后的差异，等我选择。
03 · 留下方案
采用这个方案。请保存，并给我一份以后能继续修改的设计文件。
也可以上传有权使用的草图，说明最在意的两三处特征。复杂参考需要多轮核对；模型预览、工序和导出文件才是判断结果的依据。
五个对话体验任务 · 手动练习与示例文件 · 完整操作手册 PDF
使用 Node.js 20.19+（20.x）或 22.12+：
git clone https://github.com/yuyou-dev/OpenGemCutting.git
cd OpenGemCutting
npm ci
npm run dev打开终端打印的本机地址。npm run build 生成独立前端 dist/client/；GitHub Pages 使用 npm run build:pages。Linux 可按此源码路径运行。
需要对话能力时，执行 node setup/cli.mjs install。仓库包含完整设计 skill、MCP、安装模块和设计插件；Codex 应用、模型服务及账号另行准备。其他 MCP 客户端也可启动 mcp/server.mjs，浏览器接入方式见 接口文档。
src/domain + src/application → 同一套几何与设计规则
↑ ↑
浏览器手动编辑 可选本地 MCP
npm run check # 文档、领域、安装、插件与静态构建
npm ci --prefix mcp
npm run check:mcp # 加上 MCP 的连接与版本检查- 请保留设计文件。 项目保存在当前浏览器与地址下；更换浏览器、端口或清理浏览器数据不会自动迁移项目。重要设计请导出 JSON。
- 保留真实原石形状。 支持闭合 OBJ，保留凹槽、孔和分离组件；导入上限与交换限制见 文件与设计边界。
- 仿真帮助比较。 显示效果不代表实际切磨收益或材料光学等级。独立光学实验室仍为开发中入口。
- 支持按实测说明。 本机功能已通过设计师验收；跨平台、浏览器与线上状态见 支持与验收，不以源码版本推断站点已更新。
欢迎提交可复现的问题、切型案例和聚焦改进。Discussions 用于交流，Issues 用于缺陷，贡献指南 说明代码参与方式。
可选的 OpenGemCutting Companion 帮你整理社区反馈和贡献草稿，与设计插件分别安装；任何公开发送前都会展示内容并请求确认。了解 Companion。
 |
余博士开源技术群 扫描左侧企业微信二维码加入群聊，一起交流使用经验与开源技术。 点击二维码可查看大图。 |
OpenGemCutting · SUVA / Facet 96
MIT License · 第三方来源 · 品牌说明 · 更新记录