neo-cmp-cli 1.9.7 → 1.9.8

package/dist/neo/pushCmp.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("node:fs"),t=require("node:path"),s=require("lodash"),o=require("akfun"),r=require("ora"),a=require("./neoService.js"),i=require("../utils/common.js"),n=require("../utils/pathUtils.js"),c=require("../utils/projectUtils/createCmpProjectZip.js");var l,p;exports.__require=function(){if(p)return l;p=1;const u=e,g=t,m=s,{getConfigObj:d}=o,w=r,y=a.__require(),{getFramework:f,errorLog:h,successLog:v}=i.__require(),{catchCurPackageJson:b}=n.__require(),T=c.__require(),C=d(b()),$=(e=[])=>e.map(e=>({label:e.label,description:e.description,propSchema:JSON.stringify(e)})),P=(e=[],t)=>e&&0!==e.length?e.map(e=>({...e,componentType:t,eventCategory:e.eventCategory||2,pageType:e.pageType||1,targetDevice:e.targetDevice||1,eventParams:e.eventParams||[]})):[],q=(e=[],t)=>e&&0!==e.length?e.map(e=>({...e,componentType:t,funcScope:e.funcScope||"all",pageType:e.pageType||1,targetDevice:e.targetDevice||1,custom:void 0===e.custom||e.custom,funcInParams:e.funcInParams||[],funcOutParams:e.funcOutParams||[]})):[];return l=async(e,t)=>{const s=w("正在发布组件...").start();try{let o,r=new y(e);await r.ensureValidToken(),s.start("[1/4] 打包源码文件（含单个自定义组件源码）...");try{o=T(t,process.cwd(),e.assetsRoot),o?v(`[1/4] 源码文件打包完成: ${g.basename(o)}。`,s):h("[1/4] 源码文件打包失败，未返回 zip 文件路径。",s)}catch(e){h("[1/4] 源码文件打包失败。",s)}s.start("[2/4] 获取自定义组件构建产物...");const a=await r.getCmpAssets(t);let i;s.start("[3/4] 构建组件数据...");try{i=await(async(e,t)=>{if(!t||!t.cmpType)return h("自定义组件信息或组件名称不能为空"),null;const{cmpType:s}=t;if(!e||!u.existsSync(e))return h(`未找到自定义组件目录: ${e}`),null;const o=m.camelCase(s),r=g.join(e,`${o}Model.js`),a=globalThis.window;globalThis.window||(globalThis.window={console:console,neoRequire:()=>{},postMessage:()=>{}});try{u.existsSync(r)?require(r):(h(`未找到自定义组件模型文件，请检查以下路径是否存在：${r}`),process.exit(1)),globalThis.window&&globalThis.window.NEOEditorCustomModels||(h(`模型文件未导出有效模型方法（CatchCustomCmpModelClass），模型文件地址： ${r} `),process.exit(1));const e=globalThis.window.NEOEditorCustomModels[s];e||(h(`未找到自定义组件模型类（${s}），模型文件地址： ${r} `),process.exit(1));const o=new e;o||(h(`未找到自定义组件模型信息（${s}），模型文件地址： ${r} `),process.exit(1));const a={...t,version:C.version||"1.0.0",framework:C.framework?f(C.framework):0,label:o.label||s,description:o.description||"",componentCategory:(o.tags||["自定义组件"]).join(","),targetPage:o.targetPage||["customPage"],targetObject:o.targetObject||["all"],targetApplication:o.targetApplication||["all"],targetDevice:o.targetDevice||"all",iconUrl:o.iconUrl||o.iconUrl,defaultProps:JSON.stringify(o.defaultComProps||{}),previewProps:JSON.stringify(o.previewComProps||{}),props:$(o.propsSchema||[]),events:P(o.events||[],s),functions:q(o.functions||o.actions||[],s),exposedToDesigner:void 0===o.exposedToDesigner||o.exposedToDesigner,namespace:o.namespace||"neo-cmp-cli",enableDuplicate:void 0===o.enableDuplicate||o.enableDuplicate};return console.log(`自定义组件模型信息（${s}）:`,m.omit(a,["assetFile","modelAssetFile","cssAssetFile","codeLibFile"])),a}catch(e){return h(`自定义组件模型文件解析失败 (${r||"未知路径"}): ${e.message}`),h(e.stack),null}finally{void 0===a?delete globalThis.window:globalThis.window=a}})(e.assetsRoot,a),i?v("[3/4] 组件数据构建完成。",s):h(`[3/4] 未获取到自定义组件模型信息（${t}）。`,s)}catch(e){h(`[3/4] 组件数据构建失败: ${e.message}`,s)}s.start("[4/4] 保存组件信息到 NeoCRM 平台...");try{await r.updateCustomComponent(i),v("[4/4] 组件信息保存成功",s)}catch(e){h("[4/4] 组件信息保存失败",s)}const{tenant_id:n,instance_uri:c}=r.tokenCache||{};console.log(`\n✅ 自定义组件发布成功！\n（当前租户 ID: ${n||"未返回"}，所在租户的 API 域名: ${c||"未返回"}。）`)}catch(e){try{s&&s.isSpinning&&h(`❌ 自定义组件发布失败: ${e.message}`,s)}catch{h(`\n❌ 自定义组件发布失败: ${e.message}`)}throw e}},l};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("node:fs"),t=require("node:path"),s=require("lodash"),o=require("akfun"),r=require("ora"),a=require("./neoService.js"),i=require("../utils/common.js"),n=require("../utils/pathUtils.js"),c=require("../utils/projectUtils/createCmpProjectZip.js");var l,p;exports.__require=function(){if(p)return l;p=1;const u=e,g=t,m=s,{getConfigObj:d}=o,w=r,y=a.__require(),{getFramework:f,errorLog:h,successLog:b}=i.__require(),{catchCurPackageJson:v}=n.__require(),T=c.__require(),C=d(v()),$=(e=[])=>e.map(e=>({label:e.label,description:e.description,propSchema:JSON.stringify(e)})),P=(e=[],t)=>e&&0!==e.length?e.map(e=>({...e,componentType:t,eventCategory:e.eventCategory||2,pageType:e.pageType||1,targetDevice:e.targetDevice||1,eventParams:e.eventParams||[]})):[],q=(e=[],t)=>e&&0!==e.length?e.map(e=>({...e,componentType:t,funcScope:e.funcScope||"all",pageType:e.pageType||1,targetDevice:e.targetDevice||1,custom:!0,funcInParams:e.funcInParams||[],funcOutParams:e.funcOutParams||[]})):[];return l=async(e,t)=>{const s=w("正在发布组件...").start();try{let o,r=new y(e);await r.ensureValidToken(),s.start("[1/4] 打包源码文件（含单个自定义组件源码）...");try{o=T(t,process.cwd(),e.assetsRoot),o?b(`[1/4] 源码文件打包完成: ${g.basename(o)}。`,s):h("[1/4] 源码文件打包失败，未返回 zip 文件路径。",s)}catch(e){h("[1/4] 源码文件打包失败。",s)}s.start("[2/4] 获取自定义组件构建产物...");const a=await r.getCmpAssets(t);let i;s.start("[3/4] 构建组件数据...");try{i=await(async(e,t)=>{if(!t||!t.cmpType)return h("自定义组件信息或组件名称不能为空"),null;const{cmpType:s}=t;if(!e||!u.existsSync(e))return h(`未找到自定义组件目录: ${e}`),null;const o=m.camelCase(s),r=g.join(e,`${o}Model.js`),a=globalThis.window;globalThis.window||(globalThis.window={console:console,neoRequire:()=>{},postMessage:()=>{}});try{u.existsSync(r)?require(r):(h(`未找到自定义组件模型文件，请检查以下路径是否存在：${r}`),process.exit(1)),globalThis.window&&globalThis.window.NEOEditorCustomModels||(h(`模型文件未导出有效模型方法（CatchCustomCmpModelClass），模型文件地址： ${r} `),process.exit(1));const e=globalThis.window.NEOEditorCustomModels[s];e||(h(`未找到自定义组件模型类（${s}），模型文件地址： ${r} `),process.exit(1));const o=new e;o||(h(`未找到自定义组件模型信息（${s}），模型文件地址： ${r} `),process.exit(1));const a={...t,version:C.version||"1.0.0",framework:C.framework?f(C.framework):0,label:o.label||s,description:o.description||"",componentCategory:(o.tags||["自定义组件"]).join(","),targetPage:o.targetPage||["customPage"],targetObject:o.targetObject||["all"],targetApplication:o.targetApplication||["all"],targetDevice:o.targetDevice||"all",iconUrl:o.iconUrl||o.iconUrl,defaultProps:JSON.stringify(o.defaultComProps||{}),previewProps:JSON.stringify(o.previewComProps||{}),props:$(o.propsSchema||[]),events:P(o.events||[],s),functions:q(o.functions||o.actions||[],s),exposedToDesigner:void 0===o.exposedToDesigner||o.exposedToDesigner,namespace:o.namespace||"neo-cmp-cli",enableDuplicate:void 0===o.enableDuplicate||o.enableDuplicate};return console.log(`自定义组件模型信息（${s}）:`,m.omit(a,["assetFile","modelAssetFile","cssAssetFile","codeLibFile"])),a}catch(e){return h(`自定义组件模型文件解析失败 (${r||"未知路径"}): ${e.message}`),h(e.stack),null}finally{void 0===a?delete globalThis.window:globalThis.window=a}})(e.assetsRoot,a),i?b("[3/4] 组件数据构建完成。",s):h(`[3/4] 未获取到自定义组件模型信息（${t}）。`,s)}catch(e){h(`[3/4] 组件数据构建失败: ${e.message}`,s)}s.start("[4/4] 保存组件信息到 NeoCRM 平台...");try{await r.updateCustomComponent(i),b("[4/4] 组件信息保存成功",s)}catch(e){h("[4/4] 组件信息保存失败",s)}const{tenant_id:n,instance_uri:c}=r.tokenCache||{};console.log(`\n✅ 自定义组件发布成功！\n（当前租户 ID: ${n||"未返回"}，所在租户的 API 域名: ${c||"未返回"}。）`)}catch(e){try{s&&s.isSpinning&&h(`❌ 自定义组件发布失败: ${e.message}`,s)}catch{h(`\n❌ 自定义组件发布失败: ${e.message}`)}throw e}},l};

package/dist/package.json.js

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var e="1.9.7";const o={version:e};exports.default=o,exports.version=e;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});var e="1.9.8";const o={version:e};exports.default=o,exports.version=e;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neo-cmp-cli",
-  "version": "1.9.7",
+  "version": "1.9.8",
   "description": "Neo 自定义组件开发工具，支持react 和 vue2.0技术栈。",
   "keywords": [
     "neo-cli",
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "adm-zip": "^0.5.10",
-    "akfun": "^5.2.5",
+    "akfun": "^5.2.12",
     "axios": "^0.27.2",
     "babel-plugin-import": "^1.13.8",
     "chalk": "^4.0.0",

package/template/develop/comTree/347/224/237/346/210/220/350/277/207/347/250/213/345/210/206/346/236/220.md

@@ -0,0 +1,469 @@
+# ComTree 生成过程分析
+
+## 一、概述
+
+ComTree 是 Neo UI 框架中元数据能力的载体，负责元数据的加载、解析，基于模型的扩展的加载、解析、合并。它是一个树形结构，每个节点都是一个 `Com` 实例，代表一个组件或布局。
+
+## 二、核心概念
+
+### 2.1 Com 类
+- `Com` 是树形节点，任何一个 com 都可以向下展开
+- Com 是整个元数据实现的骨架，组合 kernel 中的能力构建出立体元数据的解析执行运行时
+- Com 继承自 `XNode`，具备树形结构的基本能力
+
+### 2.2 节点类型
+- **PageCom**: 页面级别的 Com，是整个页面的根节点
+- **LayoutCom**: 布局 Com，负责管理子组件的布局
+- **DataServiceCom**: 数据服务 Com，负责数据获取和管理
+- **普通 Com**: 业务组件 Com
+
+### 2.3 生命周期阶段
+```typescript
+enum LifePhase {
+  INIT = 0,        // 初始化
+  ATTACHED = 1,    // 已挂载到树
+  READY = 2,       // 准备就绪
+  DETACHED = 3,    // 已卸载
+  DESTROYED = 4    // 已销毁
+}
+```
+
+## 三、ComTree 生成流程
+
+### 3.1 整体流程
+
+```
+1. 页面打开请求
+   ↓
+2. 创建 PageCom 实例
+   ↓
+3. 创建 PageStore (数据服务)
+   ↓
+4. Store 加载布局数据 (layoutData)
+   ↓
+5. 调用 $expandSubTree 展开子树
+   ↓
+6. 递归创建子 Com 节点
+   ↓
+7. 应用扩展 (AgentCom)
+   ↓
+8. 设置变量空间
+   ↓
+9. 标记 ready2render = true
+   ↓
+10. 渲染到 UI
+```
+
+### 3.2 详细步骤
+
+#### 步骤 1: 页面打开
+
+在 `NeoRenderer` 或 `PageModelRender` 中，通过以下方式打开页面：
+
+```typescript
+// packages/neo-ui-common/src/_comTreeDom/pageModelRender.tsx
+this.pageCom = NeoApp.openPageByPageInfo({
+  pageKey,
+  pageEngine,
+  cmpType: pageKey,
+  pageParams: queryObject
+})
+```
+
+#### 步骤 2: 创建 PageCom 实例
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/pageCom.ts
+class PageCom extends Com {
+  constructor(comArgs: ComArgs<IPageConfig>) {
+    super(comArgs)
+    this[SCOPE] = { page: this } as ComScopeNode
+    this.config = comArgs.props as IPageConfig
+    SystemCtx.initPagePrivateScope(this)
+  }
+}
+```
+
+#### 步骤 3: 创建 Store
+
+在 `Com` 构造函数中，通过 `queueMicrotask` 异步创建 Store：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/com.ts:294-296
+queueMicrotask(() => {
+  this.$tryCreateStore()
+})
+```
+
+PageCom 重写了 `$tryCreateStore` 方法：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/pageCom.ts:182-195
+async $tryCreateStore() {
+  const { pageEngine, pageKey } = this.props || {}
+  const storeCls = CmpStoreRegister.getStoreClass(this.cmpType) 
+    || CmpStoreRegister.getBasePageStoreClass()
+  const store = new storeCls(this)
+  this[BOUNDED].boundStore = store
+  this[STATE].storeResolved = true
+  await store.init()
+  store.status = 'init'
+}
+```
+
+#### 步骤 4: 启动数据服务
+
+在表单页面中，通过 `dataServiceStart` 方法启动数据服务：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/pageCom/formPageUniCom.ts:178-246
+async dataServiceStart(initProps: any = {}) {
+  // 1. 应用页面扩展
+  await AgentComManager.applyPageAgent(this)
+  
+  // 2. 加载布局数据
+  let layoutData = await this.$store.loadLayout()
+  
+  // 3. 权限检查
+  let checkAccess = await this.preRenderCheck(...)
+  
+  // 4. 构建 ComTree
+  if (layoutData?.layout !== null) {
+    let cmp = layoutData.layout
+    await this.$expandSubTree([cmp])
+    
+    // 5. 应用扩展
+    this.applyAgentCom()
+    this.setupVarSpace()
+    this.comsReady = true
+  }
+}
+```
+
+#### 步骤 5: 展开子树 ($expandSubTree)
+
+这是 ComTree 生成的核心方法：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/com.ts:1586-1617
+$expandSubTree(subCmps: ComArgs[]) {
+  // 校验逻辑
+  if (!subCmps || subCmps.length === 0) {
+    this.children = []
+    lifecycleInvoking(this, 'ready')
+    return
+  }
+
+  // 递归展开
+  subCmps.forEach((cmp) => {
+    // 1. 根据 cmpType 查找对应的 Com 类
+    let ComClass = ComFinder.getCom({ cmpType: cmp.cmpType })
+    
+    // 2. 创建子 Com 实例
+    let childCom = new ComClass(cmp)
+    
+    // 3. 将子节点添加到当前节点
+    this.$appendChild(childCom)
+    
+    // 4. 如果还有子节点，递归展开
+    if (cmp.subCmps && cmp.subCmps.length) {
+      childCom.$expandSubTree(cmp.subCmps)
+    } else {
+      // 5. 没有子节点，标记为 READY
+      childCom.$phaseShift(LifePhase.READY, true)
+    }
+  })
+
+  // 6. 当前节点标记为 READY
+  lifecycleInvoking(this, 'ready')
+}
+```
+
+#### 步骤 6: 添加子节点 ($appendChild)
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/com.ts:1310-1335
+$appendChild(child: Com) {
+  // 1. 如果存在旧关系，先解除
+  const lastPCom = child.pCom
+  if (lastPCom) {
+    lastPCom.$removeChild(child)
+  }
+
+  // 2. 设计态下创建布局事件
+  if (InnerApi.isDesignMode()) {
+    InnerApi.autoCreateComTreeLayoutEvent(this)
+  }
+
+  // 3. 建立父子关系
+  child.pCom = this
+  this.children.push(child)
+  this.$$linkComCtx(child)
+  
+  // 4. 重新生成 orderNo
+  this.children.forEach((com, index) => {
+    com.orderNo = index
+  })
+
+  // 5. 标记子节点为 ATTACHED 状态
+  child.$phaseShift(LifePhase.ATTACHED, true)
+}
+```
+
+#### 步骤 7: Com 实例化过程
+
+当创建 Com 实例时，会执行以下初始化：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/com.ts:264-297
+constructor(options: ComArgs) {
+  super(options)
+  
+  // 1. 存储原始数据（向后兼容）
+  this[STATE].data = options
+  
+  // 2. 初始化布局
+  this[STATE].iRegion = options.regions || this.defaultLayout()
+  this.initLayout()
+  
+  // 3. 创建表达式对象
+  this[BOUNDED].expression = new Expression({ comKId: this.keyIdentifier })
+  
+  // 4. 生成 UI Props
+  this.uiProps = this.generateUiProps()
+  
+  // 5. 内存监控（开发环境）
+  if (__watch_memory) {
+    incrCmpCount(this.cmpType)
+    fRegistry?.register(this, this.cmpType)
+  }
+  
+  // 6. 异步创建 Store
+  queueMicrotask(() => {
+    this.$tryCreateStore()
+  })
+}
+```
+
+## 四、ComFinder 组件查找机制
+
+### 4.1 Com 注册
+
+组件通过 `@registerCom` 装饰器注册：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/kernel/register/register.com.ts:174-191
+function registerCom(com: typeof Com) {
+  let { _cmpType, _uiType } = com
+  if (!_cmpType && !_uiType) {
+    console.warn('register com failed, com must has both static properties: _cmpType and _uiType')
+    return
+  }
+
+  // 应用装饰器
+  ComDecorator(com)
+
+  // 建立映射关系
+  CmpTypePair.setPair(_cmpType, _uiType)
+
+  // 注册到全局列表
+  COM_DEFS.unshift({
+    cmpType: _cmpType,
+    uiType: _uiType,
+    comClass: com
+  })
+}
+```
+
+### 4.2 Com 查找
+
+```typescript
+// 根据 cmpType 查找对应的 Com 类
+let ComClass = ComFinder.getCom({ cmpType: cmp.cmpType })
+```
+
+## 五、布局初始化
+
+### 5.1 布局结构
+
+Com 可以包含布局信息（regions），布局定义了子组件的排列方式：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/com.ts:193-213
+protected initLayout() {
+  let regions = this.regions as RegionSchema | undefined
+  if (regions) {
+    const { template, slots } = regions
+    if (!template) {
+      console.error('template is required', this)
+      return
+    }
+    
+    // 根据模板名称查找布局类
+    const LayoutClass = XLayout.getLayout(template)
+    if (!LayoutClass) {
+      throw new Error(`Layout template ${regions?.template} not found`)
+    }
+    
+    // 创建布局实例
+    const layout = new LayoutClass(template)
+    layout.existAsRegions(regions, this)
+    if (slots) {
+      layout.syncSlots(slots)
+    }
+    
+    this[SCOPE].layout = layout
+    this[BOUNDED].boundLayout = layout
+  }
+}
+```
+
+### 5.2 布局类型
+
+- **SlotLayout**: 插槽布局，支持多个插槽（如 header, body, footer）
+- **FlexLayout**: 弹性布局
+- **GridLayout**: 网格布局
+
+## 六、扩展机制
+
+### 6.1 AgentCom 扩展
+
+在 ComTree 构建完成后，会应用扩展：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/pageCom/formPageUniCom.ts:237
+this.applyAgentCom()
+```
+
+扩展可以：
+- 修改组件的属性（uiProps）
+- 扩展组件的方法（通过 AOP）
+- 添加新的子组件
+
+### 6.2 扩展优先级
+
+```typescript
+enum DEV_PRIORITY {
+  SYSTEM = 1,    // 系统级
+  ISV = 2,       // ISV 扩展
+  CUSTOM = 3     // 自定义扩展
+}
+```
+
+## 七、变量空间
+
+### 7.1 变量空间初始化
+
+页面级别的变量空间在 `setupVarSpace` 中初始化：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/pageCom/formPageUniCom.ts:70-103
+setupVarSpace() {
+  let masterCom = this.getMasterFormCom()
+  let mainProps = masterCom.getProps()
+
+  // 创建页面变量空间
+  const pageVs = new VarSpace({
+    key: '$page',
+    label: '页面属性',
+    observable: false,
+    writable: false
+  })
+
+  // 添加页面属性
+  pageVs.$appendLeaf('objectApiKey', { ... })
+  pageVs.$appendLeaf('recordId', { ... })
+  // ...
+
+  // 绑定到页面
+  VarSpaceInTree.bindPageVs(this, pageVs)
+}
+```
+
+### 7.2 变量作用域
+
+- **$page**: 页面级变量
+- **$mainForm**: 主表单变量
+- **$subForm**: 子表单变量
+- **$global**: 全局变量
+
+## 八、渲染准备
+
+### 8.1 ready2render 标志
+
+当 ComTree 构建完成并准备好渲染时，会设置 `ready2render = true`：
+
+```typescript
+// packages/neo-ui-common/src/_comTreeDom/baseCmp/basePage.tsx:55-58
+__com__.on('ready', () => {
+  this.onReady2Render(__com__)
+  __com__.enableRenderState()  // 设置 ready2render = true
+})
+```
+
+### 8.2 Schema 生成
+
+ComTree 构建完成后，通过 `getJsonSchema` 生成 amis Schema：
+
+```typescript
+// packages/neo-ui-common/src/_comTree/standard.coms/com/pageCom.ts:210-227
+getJsonSchema() {
+  let topLayoutCom = this.getRootLayoutCom()
+  let schema: any = {}
+  if (topLayoutCom) {
+    schema = topLayoutCom.getJsonSchema()
+  } else {
+    schema = {
+      body: '页面配置错误，没有配置布局',
+      type: 'wrapper',
+      keyIdentifier: this.keyIdentifier,
+      cmpType: 'wrapper',
+      __com__: this
+    }
+  }
+  return schema
+}
+```
+
+## 九、关键数据结构
+
+### 9.1 ComArgs
+
+```typescript
+type ComArgs<T = any> = {
+  keyIdentifier: string      // 唯一标识
+  cmpType: string             // 组件类型
+  props?: T                   // 组件属性
+  regions?: RegionSchema      // 布局信息
+  subCmps?: ComArgs[]         // 子组件
+  orderNo?: number            // 排序号
+  // ...
+}
+```
+
+### 9.2 RegionSchema
+
+```typescript
+type RegionSchema = {
+  template: string           // 布局模板名称
+  slots?: {                  // 插槽定义
+    [slotName: string]: SlotArgs
+  }
+  cells?: object             // 单元格配置
+  config?: object            // 布局配置
+}
+```
+
+## 十、总结
+
+ComTree 的生成是一个递归的过程：
+
+1. **入口**: 页面打开时创建 PageCom
+2. **数据加载**: Store 加载布局数据
+3. **树构建**: 通过 `$expandSubTree` 递归创建子节点
+4. **扩展应用**: 应用 AgentCom 扩展
+5. **准备渲染**: 设置变量空间，标记 ready2render
+6. **Schema 生成**: 生成 amis Schema 用于渲染
+
+整个过程是异步的，通过 Promise 和生命周期钩子来协调各个阶段的执行顺序。
+

package/template/neo-custom-cmp-template/@types/neo-ui-common.d.ts

@@ -0,0 +1,36 @@
+import * as React from 'react';
+
+/**
+ * BaseCmpProps 基础组件属性接口
+ */
+export interface BaseCmpProps {
+  [key: string]: any;
+}
+
+/**
+ * ScopedComponentType 作用域组件类型接口
+ */
+export interface ScopedComponentType {
+  [key: string]: any;
+}
+
+/**
+ * BaseCmp 基础组件类
+ * 继承自 React.PureComponent，提供基础组件功能
+ */
+export declare class BaseCmp<
+  T extends BaseCmpProps = BaseCmpProps,
+  S = any
+> extends React.PureComponent<T, S> implements ScopedComponentType {
+  props: Readonly<T> & Readonly<{ children?: React.ReactNode }>;
+  state: Readonly<S>;
+  setState<K extends keyof S>(
+    state:
+      | ((prevState: Readonly<S>, props: Readonly<T>) => Pick<S, K> | S | null)
+      | (Pick<S, K> | S | null),
+    callback?: () => void
+  ): void;
+  forceUpdate(callback?: () => void): void;
+  render(): React.ReactNode;
+}
+

package/template/neo-custom-cmp-template/src/components/entityCardList/index.tsx

@@ -2,7 +2,12 @@ import * as React from 'react';
 import { Card, Row, Col, Spin, Empty, Avatar, Button } from 'antd';
 import { UserOutlined, PhoneOutlined, ReloadOutlined } from '@ant-design/icons';
 // @ts-ignore
-import { xObject } from 'neo-open-api'; // Neo Open API
+import { xObject } from 'neo-open-api';
+
+// Neo Open API// 引入 neo-ui-common / BaseCmp
+// @ts-ignore
+import { BaseCmp } from 'neo-ui-common';
+
 import './style.scss';
 
 interface EntityCardListProps {
@@ -26,7 +31,7 @@ interface EntityCardListState {
   error: string | null;
 }
 
-export default class EntityCardList extends React.PureComponent<
+export default class EntityCardList extends BaseCmp<
   EntityCardListProps,
   EntityCardListState
 > {
@@ -47,7 +52,7 @@ export default class EntityCardList extends React.PureComponent<
     this.loadObjectData();
   }
 
-  componentDidUpdate(prevProps: EntityCardListProps) {
+  componentDidUpdate(prevProps: Readonly<EntityCardListProps>) {
     const { xObjectDataApi } = this.props;
     if (
       xObjectDataApi?.xObjectApiKey !==
@@ -58,10 +63,13 @@ export default class EntityCardList extends React.PureComponent<
     }
   }
 
-  async loadObjectData() {
+  async loadObjectData(parma1?: any) {
     const { xObjectDataApi } = this.props;
     const { autoFetchData } = xObjectDataApi || {};
 
+    // 测试输出，输出当前参数
+    console.log('parma1:', parma1);
+
     if (autoFetchData) {
       // 方式一：直接从 props 中取实体数据源相关数据
       const { entityData: entityDataList } = this.props;
@@ -189,7 +197,7 @@ export default class EntityCardList extends React.PureComponent<
               />
             ) : (
               <Row gutter={[16, 16]}>
-                {objectDataList.map((object, index) =>
+                {objectDataList.map((object: ContactData, index: number) =>
                   this.renderEntityCard(object, index),
                 )}
               </Row>

package/template/neo-custom-cmp-template/src/components/entityCardList/model.ts

@@ -50,7 +50,6 @@ export class EntityCardListModel {
       apiKey: 'loadObjectData',
       label: '重新获取数据列表',
       helpTextKey: '获取实体业务数据列表',
-      funcInParams: [],
     },
   ];
 

package/template/neo-custom-cmp-template/src/components/entityForm_c/index.tsx

@@ -27,9 +27,9 @@ import {
 import { xObject } from 'neo-open-api'; // Neo Open API
 // @ts-ignore
 import isEqual from 'lodash/isEqual';
-// 引入 neo-ui-common / aop
+// 引入 neo-ui-common / NeoEvent
 // @ts-ignore
-import { aop } from 'neo-ui-common'; // 后续考虑 使用 props.dispatchEvent 方法替代
+import { NeoEvent } from 'neo-ui-common'; // 后续考虑 使用 props.dispatchEvent 方法替代
 import './style.scss';
 
 const { Option } = Select;
@@ -233,7 +233,7 @@ export default class EntityForm extends React.PureComponent<
   /**
    * 表单提交事件
    */
-  @aop
+  @NeoEvent.dispatch
   onSubmit() {
     console.log('触发了表单提交事件：', this.props);
   }

package/template/neo-custom-cmp-template/src/components/entityForm_c/model.ts

@@ -58,10 +58,9 @@ export class EntityFormModel {
   events = [
     {
       apiKey: 'onSubmit', // 事件名称
-      // description: '这是一个表单提交事件', // 暂未使用
       label: '提交表单后', // 事件
-      helpText: '表单提交后触发该事件' // 信息icon hover 时的提示文本
-    }
+      helpText: '表单提交后触发该事件', // 信息icon hover 时的提示文本
+    },
   ];
 
   /**

package/template/neo-custom-cmp-template/src/components/entityTable/index.tsx

@@ -33,6 +33,11 @@ import moment from 'moment';
 import { xObject } from 'neo-open-api'; // Neo Open API
 // @ts-ignore
 import isEqual from 'lodash/isEqual';
+
+// Neo Open API// 引入 neo-ui-common / BaseCmp
+// @ts-ignore
+import { BaseCmp } from 'neo-ui-common';
+
 import './style.scss';
 
 const { Option } = Select;
@@ -120,7 +125,7 @@ interface EntityTableState {
  * XObject 数据表格组件
  * 支持对 Neo 平台的 XObject 实体对象进行增删改查操作
  */
-export default class EntityTable extends React.PureComponent<
+export default class EntityTable extends BaseCmp<
   EntityTableProps,
   EntityTableState
 > {

package/template/neo-custom-cmp-template/src/components/entityTable/model.ts

@@ -50,6 +50,28 @@ export class EntityTableModel {
     },
   };
 
+  // 当前组件支持的函数列表（其他组件可触发当前组件的函数）
+  functions = [
+    {
+      apiKey: 'loadData',
+      label: '刷新表格',
+      helpTextKey: '刷新当前表格数据',
+    },
+    {
+      apiKey: 'handleDelete',
+      label: '删除记录',
+      helpTextKey: '删除表格中指定记录',
+      funcInParams: [
+        {
+          apiKey: 'id',
+          label: '记录ID',
+          type: 'String',
+          required: true,
+        },
+      ],
+    },
+  ];
+
   /**
    * 组件属性配置模式
    * 支持静态配置：propsSchema，优先级比 propsSchemaCreator 低