1

public/docs/import-guide.md

@@ -0,0 +1,46 @@
+# 引入方式与事件监听
+
+介绍两种集成方式（全局挂载 / 模块化 ESM），以及统一的事件监听方法。
+
+## 全局挂载（非模块化）
+1. 引入全局构建产物（替换为你的实际部署地址）：
+   ```html
+   <script src="https://sdk.zguiy.com/zt/assets/index.js"></script>
+   ```
+2. 获取实例并初始化：
+   ```js
+   const kernel = window.faceSDK?.kernel
+   if (!kernel) {
+     console.error('SDK 未加载')
+   } else {
+     kernel.init({
+       container: 'renderDom',           // 容器 ID（canvas）
+       modelUrlList: ['./model.glb'],    // 模型列表
+       env: { hdrPath: '/hdr/my.env' },  // 环境贴图等参数
+     })
+   }
+   ```
+
+## 模块化（ESM）
+1. 在 `<script type="module">` 中导入：
+   ```js
+   import { kernel } from 'https://sdk.zguiy.com/zt/assets/index.js' // 构建后路径自行替换
+   ```
+2. 初始化（与全局方式一致）：
+   ```js
+   kernel.init({
+     container: 'renderDom',
+     modelUrlList: ['./model.glb'],
+     env: { envPath: '/hdr/my.env' },
+   })
+   ```
+
+## 事件监听（两种方式通用）
+```js
+kernel.on('model:load:progress', (data) => console.log('模型加载进度', data))
+kernel.on('model:loaded', (data) => console.log('模型加载完成', data))
+kernel.on('model:click', (data) => console.log('模型点击', data))
+
+// 需要时可移除
+// kernel.off('model:loaded', handler)
+```