ambleloft插件结构与运行机制
知道每个文件属于哪里，才能把一次本地运行变成可安装的应用。
实践指南
完成后：找到清单、入口与打包资源，核对安装后的行为。
前置条件：按本页具体步骤准备所需文件与工具；学习路线中的上一页不自动构成依赖。
本页内容
01从脚手架开始
先完成插件入门指南的本地包准备，在 extension-work 中执行并保留 AMBLELOFT_PACKS。CLI 不自动安装依赖。
代码示例
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 pack02源文件与安装包
main、icon、skills 等路径指向安装包内部，不是工作目录。脚手架的 build.cjs 将产物放到 dist/package；CLI pack 打包这个目录内的全部文件。不要把服务凭据或 node_modules 放进准备目录。
代码示例
extension.json # Identity, permissions, operations
extension.nls.json # Default UI strings
extension.nls.zh-CN.json # Chinese UI strings
src/extension.ts # Node backend
src/page.ts # Home-page browser entry
web/index.html # Home page
assets/icon.png # Add and copy during build
skills/intake/SKILL.md # Add and copy during build
skills/intake/intake.yaml
build.cjs # Build → dist/package
dist/*.amble-extension # Installable archive03注册与释放
activate 接收 ExtensionContext。在 context.subscriptions 中登记操作和监听器；后台连接也应暴露 dispose() 并加入。页面关闭与扩展停用是不同生命周期，连接不要由每个页面各启动一份。
查阅 ExtensionContext04验证安装效果
打开技能与扩展 → 从本地安装，选择生成的归档，确认信任并授予声明的权限。应能打开项目卡片。修改后必须重新 build / validate / pack / 安装；修改源码不会自动更新已安装扩展。
下一步：添加品牌图标检查结果与排错
找到清单、入口与打包资源，核对安装后的行为。
按本页的验证步骤核对实际结果。涉及业务服务时，分别检查界面提交、工具回执与服务端记录。
打开错误代码与排错 →