更新日志

新增

• 五类布局模板：生成器的页面结构收敛为五种，每种两份 HTML：骨架版是结构加完整样式表（写页面结构时读它），可运行版再把行为内联进来（用来看示例跑起来）。两份都是单文件，没有第二份要一起拷的。可在线预览，下载后双击即可运行。里面每个控件都能用：重置、单位切换、数值字段拖拽改值、缩放、下拉、收起、加工 Tips 的分步引导、二级页。按左右两侧各承担什么来选：无左栏 + 参数栏、模板栏 + 参数栏、生成栏（停靠）+ 参数栏、生成栏（悬浮）无参数栏、工具栏 + 面板 + 参数栏。见布局
• design.md 里带了 agent 契约、模板地址与自查清单：开头是十条不可协商的规则以及骨架、皮肤、功能三者的分界，正文给出每份模板的完整地址并写死一条规则——动手搭页面之前先把对应的骨架版抓下来，抓不到就向用户索取，末尾是可逐条核对的清单。能抓 URL 的 agent 只需要 design.md 一份；抓不了的还需要把对应的骨架版一起贴进去。见Skill 文件
• 生成对话框：在左栏是悬浮「选完即生成」卡片的那种布局里，点一个风格块会先打开对话框，而不是直接发起调用。深色头部复述这次选择——缩略图、名字、把已定死的事实写成只读标签——接着是参考图与可选的提示词，最后是 Generate
• 文档的 .md 端点现在带组件 markup：设计页里每个演示块都会以 HTML 围栏输出，所以 agent 读 /docs/design/components.md 拿到的 markup 与人看到的渲染结果是同一份
• 加工 Tips 入口：画布顶部末端角的 Tips 胶囊与它的分步弹窗进入规范——位置与尺寸固定，内容由生成器提供
• 材质卡与历史二级页进入模板：Surface 卡片（一行四个 57px 材质方块、选中描边）与前置栏的「My history」二级页（返回行、三列方块、Load more）做成了可点的 UI；背后的数据属于平台，能力开放后接入即可
• 方块里的内容按类型决定留白：线稿类的 SVG 内缩（大卡 14px、小卡与历史块 10px），照片铺满到边——模板缩略图、风格块、历史方块共用这一条。选中态是叠在卡片上的 2px 品牌色环，不改变内容尺寸：同一张图选中前后不会被重新缩放。见组件
• 每个可交互目标都到 24×24：开关、滑块、色块、数值字段、「查看全部」这些视觉上更小的控件，命中区都补到了 24，且不影响所在行的高度。栏头的图标底板统一为 24px。见无障碍
• 一份模板是起点，不是不许动的成品：可以在它基础上改良、增删，也可以把另一份布局的区块搬过来。不变的是骨架——各区宽度、控件高度与圆角、覆盖层位置、每个控件展示的状态集，以及全部平台约束；约束的是渲染出来的样子，不是代码怎么写。见规则清单

改进

• 令牌层改为平台自己的令牌导出，名与值一起换（破坏性）：颜色、字体样式、圆角、间距、投影全部来自平台界面同一份导出，生成器与平台不再各走各的。改名是机械的，取值随之变动：

  旧	新	取值
  surface-default	bg-default	#ffffff
  surface-subtle	bg-subtlest	#f9fafb → #fcfcfd
  canvas-surface	bg-editor	#fbfcfd → #e7e8ea
  background-input	bg-control	#f3f4f6 → #eeeff1
  background-hover / -active	bg-hover / bg-active	6% / 8% 墨色
  background-scrim	bg-overlay	44% 墨色 → 70% 黑
  text-primary	text-primary	#111827 → #171719
  text-secondary	text-secondary	#4b5563 → #3d3e42
  text-tertiary	text-tertiary	#6b7280 → #85878b
  text-disabled	text-disabled	#9ca3af → #b9bbc0
  stroke-default	stroke-default	#e5e7eb → #d6d8db
  brand-default	brand-default	#111827 → #292a2d
  emphasize-default	emphasize-default	#d9002d → #fa253d
  emphasize-pressed	emphasize-active	#8c001d → #b20025
  focus-ring	stroke-surround	#0050f4 → #3170d5
  on-primary-button	text-inverse	#ffffff
  info / link-default	blue-default	#2661f1 → #3f81ea
  success	green-default	#00c767 → #16b364
  warning	warning-default	#ff7c23 → #ff6500
  error	red-default	#fa2730 → #ec221f
  所有 *-subtle 浅色	*-subtlest	换新浅色

  
  对着最新模板的 <style> 块过一遍即可——整个令牌层都在那一处。见色彩
• 中性灰阶重新编号并换值（破坏性）：从十三档变十四档，而且同一个号不再对应原来的颜色。原来的 neutral-600 现在叫 neutral-800，neutral-700 变成 neutral-900，一级文本从 neutral-900 挪到 neutral-950。按角色对应，不要按号码对应
• 字体样式按字号字重命名，而且多数档位本身也变了（破坏性）：没有语义别名层，七个旧档里只有 title 是原样平移。「哪类东西用哪个档」现在是字体页上的一张映射表。

  旧	新	字号变化
  title 16/600/22	16-semibold	不变
  label 14/600/20	14-medium	字重 600 → 500，所有按钮文字都变轻
  field 14/400/20	12-regular	14px → 12px
  field-strong 14/500/20	12-medium	14px → 12px
  note 12/400/18	12-regular	行高 18 → 16
  micro 12/400/16	11-regular	12px → 11px
  label-micro 12/600/12	12-semibold	行高 12 → 16
  rail 10/500/14	10-medium	不变

• 圆角与间距按刻度命名（破坏性）：rounded.sm/md/lg/xl/full → radius small（4）/ medium（6）/ large（8）/ xlarge（12）/ circle，spacing.xs…section → space 50/75/100/150/200/300。注意含义平移：旧的 sm 是 6px，现在叫 medium；旧的 md 是 8px，现在叫 large；旧的 10px 一档取消
• 字段档下移、控件变小（破坏性）：字段标签、取值、卡片标题从 14px 降到 12px，14px 留给按钮与侧栏标题。输入框与下拉从 40px 降到 28px 高（宽 92 / 110px），开关从 40×24 变 36×20，滑块轨道 6px → 3px、圆钮 18px → 12px
• 预览所立的地面明显变深：预览身后的画布原来是近白的 #fbfcfd，现在是 #e7e8ea，比面板深两档。面板是 #fcfcfd、卡片仍是纯白，三层表面因此读作地板、家具与卡片
• 说明文字变浅，并且刻意落在 AA 线下：text-tertiary 白底实测 3.60:1。这是令牌定义的取值，规范由此写清它的用法——三级文本只装看漏了也没关系的字，绝不装取值、消息，或决策所依赖的标签
• 输入框灰底无边框：静止时灰底本身就是可输入的暗示，1px 的 stroke-active 边框只在聚焦时出现。原来的「白底加描边」取消
• 参数分组进属性卡片：白底、1px 边框、上两角 8px 圆角、下两角直角，按对象或功能分组。原来的「用线分组、不要用框」取消
• 参数栏宽度 272px → 320px，左侧栏给出三档宽度（0 / 320 / 悬浮 360）与 40px 收起态
• 视图切换移到画布顶部居中：2D / 3D、预览 / 编辑这类切换是那里的分段控件，不再放左下角
• 主按钮 hover 变成提亮而不是压深：brand-hover 比 brand-default 浅一档，brand-active 是最深的一档——按下永远比静止态更深
• 下拉进入规范并随模板发出：触发器是 110px 的输入框加一枚展开时翻转的箭头；列表带描边、8px 圆角与阴影，行高 32px。列表内底色标记指针或键盘所在，对勾加 500 字重标记已选项——两个信号互不干扰。完整的键盘与读屏契约随每份模板的脚本一起发出，markup 里是真实的 <select>，取值仍以原生元素为准。见组件
• 投影是三档双层结构：shadow-100 给卡片、圆钮与分段选中项，shadow-200 给下拉列表，shadow-300 给对话框。没有比 shadow-100 更小的一档
• 颜色不再要求各生成器完全一致：布局、尺寸、入口位置与控件的状态集仍然必须一致（骨架），颜色与字号是可替换的默认值（皮肤）。生成器可以有自己的调色板，前提是保持浅色、承载含义的文本过 4.5:1、控件状态肉眼可辨，并且只改令牌的值、不改令牌的名
• 设计文档全面重写：13 章的演示块直接使用设计系统的组件类，所以文档里看到的控件与下载到的模板是同一份代码

移除

• stroke-input（破坏性）：并入 stroke-default
• link-default 与 info（破坏性）：两者都是 blue-default
• ink-alpha-* 与 scrim-44（破坏性）：改名为 neutral-alpha-25 / -50 / -100 与 bg-overlay
• crimson-* 原色（破坏性）：平台红改用 atomm-* 阶梯，每一档都比原来亮一级——逐个令牌核对，不要按号码对应
• 三档字体与一档圆角（破坏性）：28px、22px、9px 三档字号取消，10px 圆角一并取消
• elevation.knob（破坏性）：最小的一档投影是 shadow-100
• chip 与 ruler 尺寸（破坏性）：取值胶囊用输入族的尺寸；标尺属于平台自己的界面，不属于生成器

新增

• 开发者平台上线国服：中国大陆开发者可访问 dev.atomm.com.cn，账号、生成器与发布流程与国际站一致，就近访问更快
• SVG 导出颜色规范：平台按颜色识别加工意图 —— #FE0002 描边为切割、#2366FF 描边为雕刻、#2366FF 填充为填充雕刻，其余颜色由用户自己指派。你的颜色只读不改，写进文件的只有加工类型。见 SVG 导出颜色规范
• Open in Studio 前先弹导出设置：用户在弹窗里选机型 / 加工模式 / 材料，并为每个颜色分组选加工类型，确认后才交给 Studio。选「下载」仍直接落盘、不弹窗
• 独立位图自动包成 SVG：Open in Studio 时，产物里的 PNG / JPEG / WebP / GIF / BMP 会被包一层 <image>，这样才能指派加工类型；尺寸优先按图片自带的分辨率元数据换算，读不到按 96 PPI。走「下载」永远原样交付你的字节
• 导出界面支持 17 种语言：下拉项、导出设置弹窗与下载成功提示都跟随平台界面语言
• 上传产物时提示旧版 SDK 地址：命中旧域名会给出可复制的新地址，不阻断本次上传
• 购买耗材入口：生成器页面顶栏新增「购买耗材」，用户可挑选耗材包、下单结算，缺货时订到货通知

改进

• 生成器可运行在 Studio 内：登录态与来源由平台同步，导出行为与在平台上一致，你无需改代码
• 生成器可以使用本机字体：运行环境已放开本地字体权限
• 补齐 17 种语言清单：atomm 对象文档列出全部短码与展示名，可直接照抄做与平台一致的语言选择器

修复

• 未登录时点导出不再卡住：取消登录、超时或由外部接管都会正常结束，重试即可
• 修复 SVG 封面在预览里被裁剪参数破图

弃用

• 旧的 SDK 引入地址：https://static-res.atomm.com/scripts/js/generator-sdk/platform-sdk.js 已弃用，请换成 https://static-res.makextool.com/scripts/js/generator-sdk/platform-sdk.js（只换域名、保留原路径）。旧地址仍可用

新增

• 与 AI 协作：文档站提供 llms.txt 索引与单文件全文，把地址贴给 Claude Code、Cursor 这类工具，它们就能照着 atomm 的规范写；任意文档地址末尾加 .md 即可取到该页的纯 markdown。见与 AI 协作
• 3D 预览导则：8 个章节（总览 / 架构 / 交互 / 参数变化与重建 / 渲染质量 / 依赖管理 / 常见构件 / 验收清单）讲清基于 three.js 的 3D 预览该怎么做，末章是提测前的自查清单。配套的 SKILL.md 可以直接放进编码 agent 的 skills 目录。中英双语，见 3D 预览导则
• 导出 hook 新增 intent 入参：告诉你用户点的是「下载」还是「Open in Studio」，可据此返回不同产物 —— 下载给全部文件，Open in Studio 只给一份可继续编辑的矢量图。不需要区分时忽略它，原有写法照常工作。见导出能力
• 展示资料媒体预览：填写展示资料时，封面图与视频可点击放大，并在多张之间左右切换

改进

• 创建生成器改为填标题：之前要自己想一个小写英文标识，现在直接填标题（可以是中文），平台自动把它转成生成器的名称用作访问链接。名称创建后依然不可改，建议直接填英文标题、每个单词首字母大写
• 导出按钮内容默认居中：给按钮设了宽度后，图标与文字不再贴着左边；展开的下拉菜单宽度也与按钮一致。按钮由平台渲染，你无需改动代码
• 审核时效说明更新：审核结果通知时间由 1 个工作日调整为 7 个工作日
• 错误提示跟随界面语言：开发者后台的操作失败提示改为中英双语，不再固定单语
• 首页新增 UI Skill 入口：可以从首页直接进入 UI 设计规范；导出能力的介绍同步更新为按钮样式自定义与导出内容自定义

修复

• 顶部 logo 现在回到平台首页
• 修复展示资料的图片与视频预览尺寸异常
• 修复设计规范文档中一处演示图标显示异常
• 修复部分表单回车无法提交
• 修复中文文档里指向设计规范等单文件的链接打不开；这类链接现在统一在新标签打开

新增

• 设计规范文件：/design.md 是一份标准 DESIGN.md 格式的设计系统文件，包含全部设计令牌、组件规格与设计意图。直接把它交给你的编码 agent，生成的界面即符合平台规范
• AI 索引：/llms.txt 按 llmstxt.org 约定汇总全部文档入口，供 AI agent 一次取全
• 文档可被搜索引擎收录：文档现在能从搜索结果直接进入，中英各自命中对应语言的版本

改进

• 设计规范文档全面重写：13 个章节（总览 / 色彩 / 字体 / 布局 / 高度与深度 / 形状 / 组件 / 动效 / 图标 / 方向 / 无障碍 / 平台约束 / 规则清单），从令牌清单改为面向人的说明，每条规则都配可交互的真实控件演示 —— 色阶可点击复制色值，滑块、下拉、开关、分区标题都能直接操作。中英双语
• 设计令牌全面更新（破坏性）：字体令牌整套改名（body-* / label-* → title / field / label / note / micro），文本层级各下沉一档（text-secondary neutral-700 → neutral-600，text-tertiary neutral-400 → neutral-500），中性色阶全部换值，圆角 4 / 6 / 8px → 6 / 8 / 10px，阴影与强调按钮高度（32px → 40px）也有调整。写死了旧令牌名或旧色值的界面，需要按最新的 /design.md 重新对一遍
• 图片加载更快：案例页与后台的卡片封面改用缩略图，列表首屏明显更快

修复

• 修复生成器案例页卡片的封面显示与跳转异常

新增

• 全站中英双语：界面与文档支持中文 / English，按语言前缀（/zh）切换与路由
• 生成器案例页：在开发者平台公开浏览已上架生成器，按工艺分类筛选；卡片支持图片 / 视频封面、热度角标、导出量与作者 / 官方标识
• 上架即上线社区：生成器通过审核后直接在 Atomm 创意工具社区上线，点击卡片跳转其社区落地页，触达社区流量
• 工艺类型（多选）：生成器可标注 Cutting / Engraving / 3D / Relief / Ink Print / UV Print / DTF & DTG，按激光 / 打印分组，用于案例页筛选
• 数据面板：开发者后台新增导出量统计，含聚合卡片与按日趋势图
• 消息中心：顶栏通知铃铛，接入平台消息通知
• 设计规范文档：新增设计系统文档（布局 / 色彩 / 图标 / 字体 / 样式）

改进

• 展示资料：新增富文本「详细说明」与多图 / 视频封面（首图作卡片封面）；发布向导内联卡片预览，所见即前台效果

新增

• 首发：开发者平台上线，打通从 SDK 接入、本地调试到提交审核上架的完整流程
• atomm SDK 接入，配合 DevTool 本地调试（?local= 指向本地服务实时预览）
• 导出能力 Export 与 atomm.lifecycle.on('export') 钩子，支持多文件导出并打包为 zip 下载
• 代码产物上传支持目录与单个 HTML 文件两种形式
• 提交审核上架全流程，支持取消审核、驳回原因展示与重新提交
• 嵌入式导出按钮：在应用内任意位置放 data-atomm-export-button 即可自置 Export 按钮（下载 / Open in Studio + 积分提示），支持 --atomm-export-* CSS 变量换肤，无需固定在平台顶栏
• 生成器名称命名规则：以小写字母开头，仅含小写字母、数字与连字符，创建后不可修改
• 文档「复制为 Markdown」：提供 .md 原文地址