neo-cmp-cli 1.12.8 → 1.12.10

package/template/develop/GlobalSearch/347/273/204/344/273/266/345/257/271/346/257/224/345/210/206/346/236/220.md

@@ -1,866 +0,0 @@
-# 全局搜索组件对比分析文档
-
-## 一、组件概述
-
-本文档详细对比分析两个全局搜索首页组件的功能差异、使用场景和实现细节。
-
-### 1.1 组件信息
-
-| 项目 | 旧组件 | 新组件 |
-|------|--------|--------|
-| **组件名称** | GlobalSearchList | GlobalSearchListHome |
-| **注册名称** | `GlobalSearchHome` | `neoGlobalSearchHome` |
-| **文件路径** | `packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchHome/` | `packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchHome/` |
-| **组件类型** | 类组件 | 类组件 |
-| **状态管理** | React State | React State |
-
-### 1.2 组件定位
-
-- **旧组件（GlobalSearchHome）**：基础版全局搜索入口，提供简单的实体列表展示和搜索跳转功能
-- **新组件（neoGlobalSearchHome）**：增强版全局搜索入口，支持历史搜索、常用对象管理、权限控制等高级功能
-
----
-
-## 二、核心功能对比
-
-### 2.1 数据获取方式
-
-#### 旧组件数据获取
-
-```typescript
-// 接口地址：entityListUrl (来自 constants)
-getEntityList = async () => {
-  this.setState({
-    entityList: await getEntityList(this.props),
-    isLoading: false
-  })
-}
-```
-
-**特点：**
-- 获取所有可搜索的实体列表
-- 包含动态（Feed）实体
-- 返回数据结构包含：`objectBelongId`, `objectApiKey`, `objectLabel`, `icon`, `iconColor` 等
-
-#### 新组件数据获取
-
-```typescript
-// 接口地址：/rest/data/v2.0/global_search/xobjects
-getObjectList = async () => {
-  this.setState(
-    {
-      objectList: await getObjectList(this.props),
-      isLoading: false
-    },
-    () => {
-      this.searchRef?.focus()
-    }
-  )
-}
-```
-
-**特点：**
-- 获取全局搜索配置的实体列表
-- 区分常用对象（`commonXObject: true`）和非常用对象
-- 不包含动态实体
-- 支持用户自定义常用对象配置
-- 数据结构包含：`xobjectApikey`, `objectId`, `objectName`, `commonXObject` 等
-
-### 2.2 状态管理对比
-
-#### 旧组件状态（ObjectFormState）
-
-```typescript
-export interface ObjectFormState {
-  isSearched: boolean          // 是否已进行搜索
-  entityList: Array<object>    // 实体列表
-  isSingleEntitySearch: boolean // 是否单实体搜索模式
-  isLoading: boolean           // 加载状态
-  currentEntity: object        // 当前选中的实体
-  searchKey: string            // 搜索关键词
-}
-```
-
-#### 新组件状态（GlobalSearchHomeState）
-
-```typescript
-export interface GlobalSearchHomeState {
-  isLoading: boolean                    // 加载状态
-  isHistory: boolean                    // 是否显示历史搜索
-  searchKey: string                     // 搜索关键词
-  objectList: GlobalSearchXobjectProps[] // 对象列表
-  historyArr: any[]                     // 历史搜索记录数组
-}
-```
-
-**关键差异：**
-- 新组件增加了 `isHistory` 状态，用于控制历史搜索界面的显示
-- 新组件增加了 `historyArr` 状态，用于存储历史搜索记录
-- 旧组件使用 `isSingleEntitySearch` 控制单实体搜索模式，新组件通过路由参数传递
-
-### 2.3 UI 展示逻辑对比
-
-#### 旧组件 UI 结构
-
-```typescript
-page = () => {
-  return {
-    type: 'page',
-    bodyClassName: 'globalSearchContainer',
-    name: 'GlobalSearchListList',
-    body: this.state.isLoading
-      ? this.searchView()
-      : [
-          this.searchView(),
-          // 如果点击了单个实体进行搜索，需要把entityList隐藏掉
-          this.state.isSingleEntitySearch ? {} : this.entityList()
-        ]
-  }
-}
-```
-
-**UI 特点：**
-- 搜索栏始终显示
-- 加载中：只显示搜索栏
-- 加载完成：显示搜索栏 + 实体列表（单实体搜索模式下隐藏实体列表）
-
-#### 新组件 UI 结构
-
-```typescript
-getJsonSchema = () => {
-  const { isHistory } = this.state
-  return {
-    type: 'page',
-    bodyClassName: 'globalSearchContainer',
-    name: 'GlobalSearchListList',
-    body: isHistory ? this.getHistorySchema() : this.getObjectViewScheam()
-  }
-}
-```
-
-**UI 特点：**
-- 搜索栏独立渲染，始终显示
-- 根据 `isHistory` 状态切换显示内容：
-  - `true`：显示历史搜索界面（`getHistorySchema`）
-  - `false`：显示对象视图（`getObjectViewScheam`）
-- 对象视图区分常用对象和非常用对象
-
-### 2.4 搜索行为对比
-
-#### 旧组件搜索流程
-
-```typescript
-onSubmit: (val) => {
-  NeoNavigator.openPageWithURL('/neo/neoGlobalSearch', {
-    searchKey: val,
-    searchEntity: this.state.currentEntity,
-    isSingleEntitySearch: this.state.isSingleEntitySearch,
-    entityList: this.state.entityList
-  })
-}
-```
-
-**流程：**
-1. 用户输入搜索关键词
-2. 点击搜索或回车
-3. 直接跳转到 `/neo/neoGlobalSearch` 搜索结果页
-4. 传递搜索关键词、当前实体、是否单实体搜索、实体列表等参数
-
-#### 新组件搜索流程
-
-```typescript
-onSubmit: (val) => {
-  this.setHistorySearchValueDb(val)  // 保存历史搜索记录
-  this.gotoAllContentPage()          // 跳转到全部内容页
-}
-
-gotoAllContentPage = () => {
-  const { searchKey, objectList } = this.state
-  const listSearchPath = '/neo/neoGlobalSearchContent'
-  NeoNavigator.openPageWithURL(listSearchPath, null, {
-    searchKey,
-    objectList
-  })
-}
-```
-
-**流程：**
-1. 用户输入搜索关键词
-2. 点击搜索或回车
-3. **保存历史搜索记录**到本地存储
-4. 跳转到 `/neo/neoGlobalSearchContent` 全部内容搜索结果页
-5. 传递搜索关键词和对象列表参数
-
-### 2.5 单实体搜索对比
-
-#### 旧组件单实体搜索
-
-```typescript
-gotoSingleEntitySearch = (item) => {
-  // 当前页面重新渲染，屏蔽实体列表组件
-  this.setState({ isSingleEntitySearch: true, currentEntity: item })
-}
-```
-
-**特点：**
-- 在当前页面切换状态，隐藏实体列表
-- 搜索时传递单实体搜索标识和实体信息
-
-#### 新组件单实体搜索
-
-```typescript
-gotoSingleEntityList = (item: GlobalSearchXobjectProps) => {
-  const { searchKey } = this.state
-  const listSearchPath = '/neo/neoGlobalSearchList'
-  NeoNavigator.openPageWithURL(listSearchPath, null, {
-    objectApiKey: item.xobjectApikey,
-    searchKey
-  })
-}
-```
-
-**特点：**
-- 直接跳转到单实体列表页 `/neo/neoGlobalSearchList`
-- 传递对象 API Key 和搜索关键词
-- 不在当前页面切换状态
-
----
-
-## 三、新增功能特性
-
-### 3.1 历史搜索功能（新组件独有）
-
-#### 功能说明
-
-新组件支持历史搜索记录功能，用户可以查看和快速选择之前的搜索关键词。
-
-#### 实现细节
-
-```typescript
-// 历史搜索存储键名
-const storageKey = `global_search_history__${getNeoContext('currentUser')?.id}__${
-  getNeoContext('currentTenant')?.id
-}`
-
-// 保存历史搜索记录
-setHistorySearchValueDb = (val?) => {
-  let { historyArr } = this.state
-  if (val) {
-    historyArr.unshift(val)  // 添加到数组开头
-  }
-  const result = Array.from(new Set(historyArr))  // 去重
-  const result2 = result.slice(0, this.historySearchCount)  // 最多保存10条
-  offlineStorageService.getService().dbSet(storageKey, result2)
-}
-
-// 历史搜索界面
-getHistorySchema = () => {
-  return {
-    type: 'wrapper',
-    body: [
-      {
-        type: 'neoSearchHistory',
-        historyType: 'global',
-        tagSchema: {
-          type: 'neoCustomTag',
-          closable: true
-        },
-        onChange: (value) => {
-          this.setState({ searchKey: value, isHistory: false })
-          this.searchRef?.focus()
-        }
-      }
-    ]
-  }
-}
-```
-
-**特点：**
-- 使用 `offlineStorageService` 进行本地存储
-- 按用户和租户隔离存储
-- 最多保存 10 条历史记录
-- 自动去重
-- 支持点击历史记录快速搜索
-
-### 3.2 常用对象设置功能（新组件独有）
-
-#### 功能说明
-
-新组件支持用户自定义常用对象，通过设置页面管理哪些对象显示在常用对象列表中。
-
-#### 实现细节
-
-```typescript
-gotoSetting = () => {
-  const { objectList } = this.state
-  NeoNavigator.openDialog({
-    ctx: this.context,
-    bodySchema: {
-      type: 'neoGlobalSearchSetting',
-      name: 'neoGlobalSearchSetting',
-      objectList,
-      setCallback: async () => {
-        this.setState({ isLoading: true })
-        const newObjectList = await getObjectList(this.props)
-        this.setState({ objectList: newObjectList, isLoading: false })
-      }
-    }
-  })
-}
-```
-
-**特点：**
-- 通过弹窗形式打开设置页面
-- 设置完成后自动刷新对象列表
-- 常用对象配置持久化存储
-
-### 3.3 权限控制功能（新组件独有）
-
-#### 功能说明
-
-新组件增加了全局搜索权限检查，无权限用户显示无权限提示页面。
-
-#### 实现细节
-
-```typescript
-notPermission = () => {
-  const { render } = this.props
-  return render('notPermission', {
-    type: 'neoPage',
-    titleConfig: {
-      titleStrings: kiwiIntl('neo.global.search', '全局搜索'),
-      noRightBtn: true
-    },
-    containerBody: {
-      type: 'neoEmpty',
-      desc: kiwiIntl('neo.global.search.not.permission', '您没有全局搜索的权限'),
-      style: { marginTop: '100px' }
-    }
-  })
-}
-
-render() {
-  const globalSearchPermission = getNeoContext('globalSearchPermission')
-  if (!globalSearchPermission) {
-    return this.notPermission()
-  }
-  // ... 正常渲染逻辑
-}
-```
-
-**特点：**
-- 从 `getNeoContext` 获取权限配置
-- 无权限时显示友好的提示页面
-- 不影响其他功能的正常使用
-
-### 3.4 搜索栏增强功能（新组件）
-
-#### 功能对比
-
-| 功能 | 旧组件 | 新组件 |
-|------|--------|--------|
-| 自动聚焦 | ❌ | ✅ (`autoFocus: true`) |
-| 始终显示清除按钮 | ❌ | ✅ (`alwaysShowClear: true`) |
-| 搜索引用 | ❌ | ✅ (`searchRef`) |
-| 输入变化监听 | ❌ | ✅ (`onChange`) |
-| 占位符文本 | 简单文本 | 多语言支持 |
-
-#### 新组件搜索栏配置
-
-```typescript
-searchViewSchema = () => {
-  const { showCancelButton = true } = this.props
-  return {
-    type: 'neoSearchBar',
-    maxLength: 100,
-    searchRef: (ref) => {
-      this.searchRef = ref  // 保存搜索框引用
-    },
-    placeholder: dayOneI18n('XdMDTextLabel.Neo.Global.Search.Placeholder', '搜索CRM数据、动态...'),
-    showCancelButton,
-    alwaysShowClear: true,   // 始终显示清除按钮
-    value: this.state.searchKey,
-    autoFocus: true,        // 自动聚焦
-    className: 'searchBarContainer',
-    onSubmit: (val) => {
-      this.setHistorySearchValueDb(val)
-      this.gotoAllContentPage()
-    },
-    onCancel: () => {
-      this.setState({ isHistory: true })
-      NeoNavigator.goBack()
-    },
-    onClear: () => {
-      this.setState({ searchKey: '', isHistory: true })
-    },
-    onChange: (val) => {
-      // 根据输入内容切换显示历史搜索或对象列表
-      this.setState({ searchKey: val, isHistory: NeoIsEmpty(val) ? true : false })
-    }
-  }
-}
-```
-
----
-
-## 四、路由跳转对比
-
-### 4.1 旧组件路由跳转
-
-| 操作 | 目标路由 | 传递参数 |
-|------|----------|----------|
-| 搜索提交 | `/neo/neoGlobalSearch` | `searchKey`, `searchEntity`, `isSingleEntitySearch`, `entityList` |
-| 取消操作 | 返回上一页 | - |
-
-### 4.2 新组件路由跳转
-
-| 操作 | 目标路由 | 传递参数 |
-|------|----------|----------|
-| 搜索提交（全部内容） | `/neo/neoGlobalSearchContent` | `searchKey`, `objectList` |
-| 点击单实体 | `/neo/neoGlobalSearchList` | `objectApiKey`, `searchKey` |
-| 取消操作 | 返回上一页 | - |
-
----
-
-## 五、数据接口对比
-
-### 5.1 旧组件数据接口
-
-**获取实体列表接口：**
-- **接口地址**：`entityListUrl`（来自 constants）
-- **请求方法**：`GET`
-- **返回数据结构**：
-```typescript
-{
-  data: {
-    data: {
-      entities: [
-        {
-          objectBelongId: string,
-          objectApiKey: string,
-          objectLabel: string,
-          objectLabel_resourceKey: string,
-          objectIconId: string,
-          // ... 其他字段
-        }
-      ]
-    }
-  }
-}
-```
-
-**特点：**
-- 返回所有可搜索实体
-- 包含动态实体（代码中手动添加）
-- 需要额外请求获取实体图标
-
-### 5.2 新组件数据接口
-
-**获取对象列表接口：**
-- **接口地址**：`/rest/data/v2.0/global_search/xobjects`
-- **请求方法**：`GET`
-- **返回数据结构**：
-```typescript
-{
-  data: {
-    data: [
-      {
-        xobjectApikey: string,
-        objectId: number,
-        objectName: string,
-        objectLabel: string,
-        objectLabelResourceKey: string,
-        objectIconId: string,
-        defaultColor: string,
-        commonXObject: boolean,  // 是否常用对象
-        // ... 其他字段
-      }
-    ]
-  }
-}
-```
-
-**特点：**
-- 返回全局搜索配置的对象列表
-- 区分常用对象和非常用对象
-- 不包含动态实体
-- 需要额外请求获取实体图标
-
----
-
-## 六、使用示例
-
-### 6.1 旧组件使用示例
-
-#### 基础使用
-
-```typescript
-// 在 Amis Schema 中使用
-{
-  type: 'page',
-  body: [
-    {
-      type: 'GlobalSearchHome',
-      name: 'globalSearchHome'
-    }
-  ]
-}
-```
-
-#### 完整配置示例
-
-```typescript
-{
-  type: 'GlobalSearchHome',
-  name: 'globalSearchHome',
-  // 组件会自动获取实体列表
-  // 用户操作流程：
-  // 1. 显示搜索栏和实体列表
-  // 2. 用户可以选择实体进入单实体搜索模式
-  // 3. 输入搜索关键词后跳转到搜索结果页
-}
-```
-
-### 6.2 新组件使用示例
-
-#### 基础使用
-
-```typescript
-// 在 Amis Schema 中使用
-{
-  type: 'page',
-  body: [
-    {
-      type: 'neoGlobalSearchHome',
-      name: 'neoGlobalSearchHome'
-    }
-  ]
-}
-```
-
-#### 完整配置示例
-
-```typescript
-{
-  type: 'neoGlobalSearchHome',
-  name: 'neoGlobalSearchHome',
-  showCancelButton: true,  // 是否显示取消按钮，默认 true
-  menuList: (objectList, onCallBack) => {
-    // 自定义菜单列表渲染（可选）
-    // objectList: 对象列表
-    // onCallBack: 回调函数
-    return {
-      type: 'neoMenuGroup',
-      dataSource: objectList,
-      onItemClick: (item) => {
-        // 自定义点击处理
-        onCallBack && onCallBack(item)
-      }
-    }
-  },
-  onCallBack: (item) => {
-    // 自定义回调处理（可选）
-    console.log('点击了对象:', item)
-  }
-}
-```
-
-#### 实际使用场景示例
-
-**场景1：在导航入口使用**
-
-```typescript
-// GlobalSearchInput 组件中的使用
-{
-  type: 'neoGlobalSearchInput',
-  isNewGlobal: true,  // 使用新组件
-  // 当 isNewGlobal 为 true 时，跳转到 neoGlobalSearchHome
-  // 当 isNewGlobal 为 false 时，跳转到 GlobalSearchHome
-}
-```
-
-**场景2：直接路由跳转**
-
-```typescript
-import { NeoNavigator } from 'neo-ui-common'
-
-// 跳转到全局搜索首页
-NeoNavigator.openPageWithURL('/neo/neoGlobalSearchHome')
-```
-
-**场景3：自定义菜单列表**
-
-```typescript
-{
-  type: 'neoGlobalSearchHome',
-  name: 'customGlobalSearch',
-  menuList: (objectList, onCallBack) => {
-    // 只显示前5个常用对象
-    const top5Objects = objectList.filter(item => item.commonXObject).slice(0, 5)
-    return {
-      type: 'neoMenuGroup',
-      dataSource: top5Objects,
-      onItemClick: (item) => {
-        // 自定义跳转逻辑
-        NeoNavigator.openPageWithURL('/custom/search', null, {
-          objectApiKey: item.xobjectApikey
-        })
-      }
-    }
-  }
-}
-```
-
----
-
-## 七、迁移指南
-
-### 7.1 从旧组件迁移到新组件
-
-#### 步骤1：更新组件类型
-
-```typescript
-// 旧代码
-{
-  type: 'GlobalSearchHome',
-  name: 'globalSearch'
-}
-
-// 新代码
-{
-  type: 'neoGlobalSearchHome',
-  name: 'globalSearch'
-}
-```
-
-#### 步骤2：更新路由配置
-
-```typescript
-// 旧代码：搜索结果页路由
-'/neo/neoGlobalSearch'
-
-// 新代码：全部内容搜索结果页路由
-'/neo/neoGlobalSearchContent'
-
-// 新代码：单实体列表搜索结果页路由
-'/neo/neoGlobalSearchList'
-```
-
-#### 步骤3：更新参数传递
-
-```typescript
-// 旧代码：跳转时传递的参数
-NeoNavigator.openPageWithURL('/neo/neoGlobalSearch', {
-  searchKey: val,
-  searchEntity: this.state.currentEntity,
-  isSingleEntitySearch: this.state.isSingleEntitySearch,
-  entityList: this.state.entityList
-})
-
-// 新代码：全部内容搜索
-NeoNavigator.openPageWithURL('/neo/neoGlobalSearchContent', null, {
-  searchKey: val,
-  objectList: this.state.objectList
-})
-
-// 新代码：单实体搜索
-NeoNavigator.openPageWithURL('/neo/neoGlobalSearchList', null, {
-  objectApiKey: item.xobjectApikey,
-  searchKey: val
-})
-```
-
-#### 步骤4：处理权限检查
-
-```typescript
-// 新组件会自动检查权限，无需额外处理
-// 但需要确保全局搜索权限配置正确
-const globalSearchPermission = getNeoContext('globalSearchPermission')
-```
-
-### 7.2 兼容性处理
-
-如果需要在同一系统中同时支持新旧组件，可以参考 `GlobalSearchInput` 组件的实现：
-
-```typescript
-{
-  type: 'neoGlobalSearchInput',
-  isNewGlobal: true,  // 通过配置项控制使用哪个组件
-  // 当 isNewGlobal 为 true 时使用 neoGlobalSearchHome
-  // 当 isNewGlobal 为 false 时使用 GlobalSearchHome
-}
-```
-
----
-
-## 八、功能对比总结表
-
-| 功能特性 | 旧组件（GlobalSearchHome） | 新组件（neoGlobalSearchHome） |
-|---------|---------------------------|-------------------------------|
-| **基础搜索** | ✅ | ✅ |
-| **实体列表展示** | ✅（所有实体） | ✅（常用对象） |
-| **单实体搜索** | ✅（页面内切换） | ✅（路由跳转） |
-| **历史搜索** | ❌ | ✅ |
-| **常用对象设置** | ❌ | ✅ |
-| **权限控制** | ❌ | ✅ |
-| **搜索栏自动聚焦** | ❌ | ✅ |
-| **搜索栏清除按钮** | ❌ | ✅（始终显示） |
-| **输入变化监听** | ❌ | ✅ |
-| **自定义菜单** | ❌ | ✅ |
-| **动态实体支持** | ✅ | ❌ |
-| **数据接口** | `entityListUrl` | `/rest/data/v2.0/global_search/xobjects` |
-| **搜索结果路由** | `/neo/neoGlobalSearch` | `/neo/neoGlobalSearchContent`<br>`/neo/neoGlobalSearchList` |
-| **本地存储** | ❌ | ✅（历史搜索） |
-
----
-
-## 九、最佳实践建议
-
-### 9.1 何时使用旧组件
-
-- 需要支持动态（Feed）实体搜索的场景
-- 简单的搜索入口需求，不需要历史搜索和设置功能
-- 需要与旧版搜索结果页（`/neo/neoGlobalSearch`）兼容的场景
-
-### 9.2 何时使用新组件
-
-- **推荐使用**：新项目或需要完整搜索功能的场景
-- 需要历史搜索功能提升用户体验
-- 需要用户自定义常用对象
-- 需要权限控制功能
-- 需要更好的搜索体验（自动聚焦、输入监听等）
-
-### 9.3 开发建议
-
-1. **新项目**：直接使用新组件 `neoGlobalSearchHome`
-2. **旧项目迁移**：按照迁移指南逐步迁移，注意路由和参数的变化
-3. **兼容处理**：如需同时支持，使用配置项控制（如 `isNewGlobal`）
-4. **权限配置**：使用新组件时确保全局搜索权限配置正确
-5. **用户体验**：充分利用新组件的历史搜索和常用对象功能
-
----
-
-## 十、相关组件和文件
-
-### 10.1 旧组件相关文件
-
-- **组件文件**：`packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchHome/component.tsx`
-- **接口定义**：`packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchHome/interface.tsx`
-- **注册文件**：`packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchHome/index.tsx`
-- **请求工具**：`packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchList/requestUtils.tsx`
-- **搜索结果页**：`packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchResult/`
-
-### 10.2 新组件相关文件
-
-- **组件文件**：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchHome/component.tsx`
-- **接口定义**：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchHome/interface.tsx`
-- **注册文件**：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchHome/index.tsx`
-- **请求工具**：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchHome/requestUtils.tsx`
-- **设置组件**：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchSetting/`
-- **搜索结果页**：
-  - 全部内容：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchContent/`
-  - 单实体列表：`packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSingleList/`
-
-### 10.3 入口组件
-
-- **搜索输入组件**：`packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchInput/component.tsx`
-  - 该组件通过 `isNewGlobal` 配置项控制使用新旧组件
-
----
-
-## 十一、常见问题
-
-### Q1: 新旧组件可以同时使用吗？
-
-**A:** 可以。通过配置项控制，如 `GlobalSearchInput` 组件中的 `isNewGlobal` 参数。但需要注意路由和参数格式的差异。
-
-### Q2: 如何从旧组件迁移到新组件？
-
-**A:** 参考本文档的"迁移指南"章节，主要步骤包括：
-1. 更新组件类型名称
-2. 更新路由配置
-3. 更新参数传递格式
-4. 处理权限配置
-
-### Q3: 新组件为什么不支持动态实体？
-
-**A:** 新组件的设计理念是专注于业务对象搜索，动态实体的搜索可能在其他模块中单独处理。如需支持动态，可以考虑扩展新组件或使用旧组件。
-
-### Q4: 历史搜索记录存储在哪里？
-
-**A:** 使用 `offlineStorageService` 存储在本地数据库中，存储键名格式为：`global_search_history__{userId}__{tenantId}`，按用户和租户隔离。
-
-### Q5: 常用对象设置如何生效？
-
-**A:** 用户在设置页面配置常用对象后，配置会保存到后端。组件重新加载时会调用 `getObjectList` 接口获取最新的配置，其中 `commonXObject` 字段标识是否为常用对象。
-
----
-
-## 十二、版本信息
-
-- **文档创建时间**：2024年
-- **组件版本**：
-  - 旧组件：基础版本
-  - 新组件：增强版本（支持历史搜索、设置、权限控制）
-- **适用平台**：H5端（`neo-ui-component-h5`）
-
----
-
-## 附录：代码片段参考
-
-### A.1 旧组件核心代码片段
-
-```typescript:packages/neo-ui-component-h5/src/components/List/GlobalSearchList/neoGlobalSearchHome/component.tsx
-// 搜索提交处理
-onSubmit: (val) => {
-  NeoNavigator.openPageWithURL('/neo/neoGlobalSearch', {
-    searchKey: val,
-    searchEntity: this.state.currentEntity,
-    isSingleEntitySearch: this.state.isSingleEntitySearch,
-    entityList: this.state.entityList
-  })
-}
-
-// 单实体搜索切换
-gotoSingleEntitySearch = (item) => {
-  this.setState({ isSingleEntitySearch: true, currentEntity: item })
-}
-```
-
-### A.2 新组件核心代码片段
-
-```typescript:packages/neo-ui-component-h5/src/components/List/GlobalSearch/neoGlobalSearchHome/component.tsx
-// 搜索提交处理（保存历史 + 跳转）
-onSubmit: (val) => {
-  this.setHistorySearchValueDb(val)
-  this.gotoAllContentPage()
-}
-
-// 单实体搜索跳转
-gotoSingleEntityList = (item: GlobalSearchXobjectProps) => {
-  const { searchKey } = this.state
-  NeoNavigator.openPageWithURL('/neo/neoGlobalSearchList', null, {
-    objectApiKey: item.xobjectApikey,
-    searchKey
-  })
-}
-
-// 历史搜索保存
-setHistorySearchValueDb = (val?) => {
-  const storageKey = `global_search_history__${getNeoContext('currentUser')?.id}__${
-    getNeoContext('currentTenant')?.id
-  }`
-  let { historyArr } = this.state
-  if (val) {
-    historyArr.unshift(val)
-  }
-  const result = Array.from(new Set(historyArr))
-  const result2 = result.slice(0, this.historySearchCount)
-  offlineStorageService.getService().dbSet(storageKey, result2)
-}
-```
-
----
-
-**文档结束**
-