@kc-one/smart-fill-sdk 0.0.1 → 0.0.21

package/README.md

@@ -14,15 +14,17 @@ npm run dev
 ## 接入示例
 
 ```ts
-import { SmartFill } from '@kc-si/smart-fill-sdk'
-import '@kc-si/smart-fill-sdk/style.css'
+import { SmartFill } from '@kc-one/smart-fill-sdk'
+import '@kc-one/smart-fill-sdk/style.css'
 
 await SmartFill.setup({ apiKey: 'seKey_xxxxxxxxxxxxx' })
 // 网关地址在 src/config/defaults.ts 的 DEFAULT_BASE_URL 中配置
 
 const smartFill = SmartFill.create({
   formCode: 'apply-form',
-  strictFormConfig: true
+  strictFormConfig: true,
+  routeContainerSelector: '.page-container',
+  // floatingContainer: '#smart-fill-host'
 })
 
 smartFill.registerFields([
@@ -44,6 +46,23 @@ smartFill.registerFields([
 smartFill.mountFloatingButton()
 ```
 
+### 悬浮挂载策略
+
+`mountFloatingButton()` 默认会自动识别当前 SPA 子路由页面容器；如果你的业务页面结构固定，推荐显式传入挂载策略，优先级如下：
+
+1. `floatingContainer`: 直接指定悬浮面板挂载容器，支持 `HTMLElement` 或 CSS 选择器
+2. `routeContainerSelector`: 指定当前子路由页面容器选择器
+3. SDK 自动识别当前页面容器
+4. 回退到 `document.body`
+
+```ts
+const smartFill = SmartFill.create({
+  formCode: 'apply-form',
+  floatingContainer: '#smart-fill-host'
+  // 或 routeContainerSelector: '.app-main > .page-container'
+})
+```
+
 ## 核心流程
 
 ```text
@@ -181,10 +200,10 @@ smart-fill-sdk/
 
 ## 发布到 npm 公共仓库
 
-包归属 [@kc-si](https://www.npmjs.com/settings/kc-si/packages) 组织，包名为 `@kc-si/smart-fill-sdk`。
+包归属 [@kc-one](https://www.npmjs.com/settings/kc-one/packages) 组织，包名为 `@kc-one/smart-fill-sdk`。
 
 ```bash
-npm login                    # 使用已加入 kc-si 组织且开启 2FA 的账号
+npm login                    # 使用已加入 kc-one 组织且开启 2FA 的账号
 npm run build
 npm publish --access public  # publishConfig 已配置 public + registry.npmjs.org
 ```
@@ -192,7 +211,7 @@ npm publish --access public  # publishConfig 已配置 public + registry.npmjs.o
 安装：
 
 ```bash
-npm install @kc-si/smart-fill-sdk
+npm install @kc-one/smart-fill-sdk
 ```
 
 ## 构建