Generator SDK

框架无关

支持原生 HTML、React、Vue、Svelte 等任意前端框架，使用 TypeScript 编写，提供完整类型定义。

提供 ESM 和 UMD 两种格式，npm 安装或 CDN 引入均可使用。所有依赖已打包，无需额外安装。

集成登录鉴权、云保存恢复、历史记录、积分系统、统一计费、导出下载等完整平台能力。

内置免费次数 + 积分扣除的智能降级策略，withBilling 高阶函数一行代码完成计费接入。

Token 自动恢复、自动失效处理，SdkError 统一错误体系，应用间数据完全隔离。

CDN 引入方式专为 AI 编程场景设计，一句提示词即可生成完整接入代码。

SDK 全景图

Generator SDK 并不是单独一个 npm 包，而是一套面向开发者平台接入的能力组合：运行时 SDK 负责平台能力接入，generator-workbench 负责统一壳层，MCP 与 skill 负责 AI 编码场景下的知识检索和代码生成。

每一层分别做什么

@atomm-developer/generator-sdk：开发者在业务项目里直接调用的运行时 SDK，用于接入登录、云保存、历史、积分、计费、导出等平台能力。

generator-workbench：标准生成器推荐使用的官方壳层，承载登录入口、模板操作、导出入口等通用平台 UI，减少每个生成器重复造壳。

@atomm-developer/generator-sdk-mcp：面向 AI 的 MCP 服务，让 AI 可以查询文档、理解 API、生成 runtime starter。

creating-generators skill：面向 AI 工作流的技能包，告诉 AI 如何澄清需求、调用 MCP、生成符合平台规范的生成器项目。

接入方式概览

当前文档主要支持两类接入方式：

手动编码：开发者自己在 CDN、Vue、React 工程里接入 SDK。

AI 编码：先配置 MCP 与 skill，再让 AI 基于文档和 starter 自动生成或补全接入代码。

更完整的路径选择图见示例总览，AI 专项流程见 AI 接入。

从这里开始

如果你想先从整体理解这个开发者平台，建议按下面顺序阅读：

指南总览 — 先获得整组 guide 的地图和推荐阅读路径

接入决策树 — 选择最合适的接入方式

开发者旅程 — 理解从本地开发到具备发布条件的完整路径

AI / Vibe Coding 工作流 — 了解 MCP + skill 驱动的 AI 开发路径