ambleloft创建你的第一个插件
本页是手动开发路线，使用同批本地 SDK/CLI 构建并安装项目卡片。首次创建推荐先跟随技能大师。0.1.0-alpha.9 仅为内部版本标识，尚未正式发行。
首次创建？跟随技能大师开始实践指南
完成后：构建并安装插件，在宿主中打开它。
前置条件：按本页具体步骤准备所需文件与工具；学习路线中的上一页不自动构成依赖。
本页内容
01准备同批本地包
准备 Node.js ≥22.13、npm 及配套宿主源码。向维护者获取 SDK、CLI、extension-core 的同批 tarball 和清单，按清单核对 SHA-256。将下方路径替换为包所在绝对目录。其他构建依赖可能需要访问 registry。
代码示例
export AMBLELOFT_PACKS="/absolute/path/to/local-packages"
mkdir extension-work
cd extension-work
npm init -y
npm install --save-dev "$AMBLELOFT_PACKS/ambleloft-extension-sdk-0.1.0-alpha.9.tgz" "$AMBLELOFT_PACKS/ambleloft-extension-core-0.1.0-alpha.9.tgz" "$AMBLELOFT_PACKS/ambleloft-extension-cli-0.1.0-alpha.9.tgz"02创建、构建与打包
在 extension-work 中执行。CLI 创建新目录但不安装依赖；构建前安装同批三个本地包，确保 CLI 解析到对应的 core 包。
代码示例
npx --no-install amble-extension init my-business-app --name my-business-app --template project-card
cd my-business-app
npm install --save-dev "$AMBLELOFT_PACKS/ambleloft-extension-sdk-0.1.0-alpha.9.tgz" "$AMBLELOFT_PACKS/ambleloft-extension-core-0.1.0-alpha.9.tgz" "$AMBLELOFT_PACKS/ambleloft-extension-cli-0.1.0-alpha.9.tgz"
npm run build
npm run validate
npm run pack03安装并查看结果
在「设置 → 扩展 → 安装」选择 dist/my-business-app.amble-extension，确认信任并授予声明的项目权限。打开项目卡片，选择测试项目；读取成功后应看到项目信息。此模板不含生产业务集成。
04失败恢复
缺少 tarball 时停止并补齐同批包，不回退到 npm latest。目标目录已存在时换用新目录名。用 npm ls 核对实际包解析；宿主方法不支持时使用配套源码，权限错误时检查信任、授权和项目选择。
代码示例
npm ls @ambleloft/extension-sdk @ambleloft/extension-cli @ambleloft/extension-core05下一步：界面与本地化
创建其他模板前返回 extension-work。本地化指南复用已有模板，核对翻译表单与集合界面。
运行本地化模板检查结果与排错
构建并安装插件，在宿主中打开它。
按本页的验证步骤核对实际结果。涉及业务服务时，分别检查界面提交、工具回执与服务端记录。
打开错误代码与排错 →