weaver-e10-builder 1.6.16 → 1.7.0

package/ecodecmd/src/loaddep.js

@@ -1,164 +1,164 @@
-
-
-const { mkdirs } = require('./util/index');
-const { calcFileMd5 } = require('./util/crypto-util');
-const path = require('path');
-const os = require('os');
-const fs = require('fs');
-const axios = require('axios');
-
-const cacheJarDir = path.join(os.homedir(), '.ecode_ide_plugin/cache');
-
-const download = (url, filepath) => {
-  return new Promise((resolve, reject) => {
-    const stream = fs.createWriteStream(filepath);
-    // 下载失败时别把半个文件留在缓存目录里
-    const fail = (err) => {
-      stream.destroy();
-      fs.rmSync(filepath, { force: true });
-      reject(err);
-    };
-    // 添加useragent
-    // 用 axios 而不是 request：request 已停止维护，且非 2xx 会被 axios 默认 reject，
-    // 不会再把错误页当 jar 写进缓存目录（旧写法用 pipe 的 close 事件判完成，判不出来）
-    axios({
-      url,
-      method: 'get',
-      responseType: 'stream',
-      headers: { 'User-Agent': 'ecodecmd' },
-    }).then((res) => {
-      res.data.pipe(stream);
-      stream.on('finish', () => resolve(''));
-      stream.on('error', fail);
-      res.data.on('error', fail);
-    }).catch(fail);
-  })
-}
-
-/**
- * 拉取jar包
- */
-const handleJar = async (serviceUrl, jarInfo) => {
-
-  console.info(`拉取 jar包: ${jarInfo.jarName}`);
-  const targetPath = path.join(cacheJarDir, jarInfo.md5);
-  if (!fs.existsSync(targetPath)) mkdirs(targetPath);
-  else {
-    // 判断jar包是否已经存在
-    if (fs.existsSync(path.join(targetPath, jarInfo.jarName))) {
-      // 校验文件是否正常
-      const md5 = calcFileMd5(path.join(targetPath, jarInfo.jarName));
-      if (md5 != jarInfo.md5) {
-        console.info(`jar包: ${jarInfo.jarName} 发生变更`);
-      } else {
-        // console.info(`jar包: ${jarInfo.jarName} 已存在`);
-        return;
-      }
-    }
-  }
-  const url = `${serviceUrl}/papi/inner/ide/getJar?jarPath=${jarInfo.path}`;
-  console.info('load url => ', url);
-  // 拷贝文件到指定缓存目录下
-  await download(url, path.join(targetPath, jarInfo.jarName));
-  console.info(`============> jar包: ${jarInfo.jarName} 拉取成功，dir: ${targetPath}`);
-}
-
-const buildGradleStr = `
-plugins {
-  id 'java'
-}
-
-group 'com.weaver.seconddev'
-version '1.0.0'
-description 'ecode 二开demo'
-
-java.targetCompatibility = JavaVersion.VERSION_1_8
-
-compileJava {
-  options.encoding = 'UTF-8'
-}
-
-jar {
-  manifest {
-      attributes 'weaver-ecode-seconddev-id': rootProject.group + '-' + rootProject.name,
-          'Implementation-Version': version,
-          'Implementation-Vendor-Id': rootProject.group,
-          'Implementation-Title': rootProject.name
-  }
-}
-
-repositories {
-  maven { url 'https://maven.aliyun.com/repository/public/' }
-  mavenLocal()
-  mavenCentral()
-}
-
-
-dependencies {
-
-  implementation group: 'junit', name: 'junit', version: '4.12'
-  compileOnly group: 'org.projectlombok', name: 'lombok', version: '1.18.20'
-  annotationProcessor 'org.projectlombok:lombok:1.18.20'
-  implementation group: 'javax.servlet', name: 'javax.servlet-api', version: '4.0.1'
-
-  // 添加二开服务拉取的清单依赖
-  def includeType = ['**/*.jar', '**/*.class']
-  compile fileTree(dir: project.projectDir.getPath() + '/secDevLib', includes: includeType)
-  // 项目二开自定义依赖
-  // implementation fileTree(dir: project.projectDir.getPath() + "/devLib", includes: includeType)
-
-}
-
-
-`
-
-const settingGradleStr = `
-rootProject.name = 'seconddev-demo'
-`
-
-/**
- * 生成项目依赖目录结构， 即 生成 secDevLib 目录，settings.gradle文件，build.gradle文件
- * @param {*} projectPath 项目路径
- * @param {*} jarData jarlist
- */
-const createProjectItem = async (projectPath, jarData) => {
-  // 处理依赖
-  const secDevLibDir = path.join(projectPath, 'secDevLib');
-  console.info('创建二开依赖目录 => ', secDevLibDir);
-  if (!fs.existsSync(secDevLibDir)) mkdirs(secDevLibDir);
-  for (let i = 0; i < jarData.length; i++) {
-    if (fs.existsSync(path.join(secDevLibDir, jarData[i].jarName))) {
-      fs.rmSync(path.join(secDevLibDir, jarData[i].jarName));
-    }
-    fs.symlinkSync(path.join(cacheJarDir, jarData[i].md5, jarData[i].jarName), path.join(secDevLibDir, jarData[i].jarName));
-  }
-  console.info('创建gradle项目信息');
-  // 处理gradle文件
-  fs.writeFileSync(path.join(projectPath, 'build.gradle'), buildGradleStr);
-  fs.writeFileSync(path.join(projectPath, 'settings.gradle'), settingGradleStr);
-}
-
-/**
- * e10 依赖拉取
- */
-const loadJar = async (serviceUrl, projectPath) => {
-  const startTime = new Date().getTime();
-  console.info('============> 开始处理')
-  const listRes = await axios({url: `${serviceUrl}/papi/inner/ide/dependencyList`, method: 'get'})
-  if (listRes.status === 200 && listRes.data.code === 200) {
-    const { data = [] } = listRes.data;
-    for (let i = 0; i < data.length; i++) {
-      await handleJar(serviceUrl, data[i]);
-    }
-    createProjectItem(projectPath, data);
-    console.info(`============> 处理结束，jar包共计 ${data.length} 个， 耗时 ${new Date().getTime() - startTime} (ms)`);
-  } else {
-    console.info('dependencyList 接口异常：', listRes.status, listRes.data);
-  }
-}
-
-module.exports = function(serviceUrl, projectPath) {
-  
-  return loadJar(serviceUrl, projectPath);
-
+
+
+const { mkdirs } = require('./util/index');
+const { calcFileMd5 } = require('./util/crypto-util');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+const axios = require('axios');
+
+const cacheJarDir = path.join(os.homedir(), '.ecode_ide_plugin/cache');
+
+const download = (url, filepath) => {
+  return new Promise((resolve, reject) => {
+    const stream = fs.createWriteStream(filepath);
+    // 下载失败时别把半个文件留在缓存目录里
+    const fail = (err) => {
+      stream.destroy();
+      fs.rmSync(filepath, { force: true });
+      reject(err);
+    };
+    // 添加useragent
+    // 用 axios 而不是 request：request 已停止维护，且非 2xx 会被 axios 默认 reject，
+    // 不会再把错误页当 jar 写进缓存目录（旧写法用 pipe 的 close 事件判完成，判不出来）
+    axios({
+      url,
+      method: 'get',
+      responseType: 'stream',
+      headers: { 'User-Agent': 'ecodecmd' },
+    }).then((res) => {
+      res.data.pipe(stream);
+      stream.on('finish', () => resolve(''));
+      stream.on('error', fail);
+      res.data.on('error', fail);
+    }).catch(fail);
+  })
+}
+
+/**
+ * 拉取jar包
+ */
+const handleJar = async (serviceUrl, jarInfo) => {
+
+  console.info(`拉取 jar包: ${jarInfo.jarName}`);
+  const targetPath = path.join(cacheJarDir, jarInfo.md5);
+  if (!fs.existsSync(targetPath)) mkdirs(targetPath);
+  else {
+    // 判断jar包是否已经存在
+    if (fs.existsSync(path.join(targetPath, jarInfo.jarName))) {
+      // 校验文件是否正常
+      const md5 = calcFileMd5(path.join(targetPath, jarInfo.jarName));
+      if (md5 != jarInfo.md5) {
+        console.info(`jar包: ${jarInfo.jarName} 发生变更`);
+      } else {
+        // console.info(`jar包: ${jarInfo.jarName} 已存在`);
+        return;
+      }
+    }
+  }
+  const url = `${serviceUrl}/papi/inner/ide/getJar?jarPath=${jarInfo.path}`;
+  console.info('load url => ', url);
+  // 拷贝文件到指定缓存目录下
+  await download(url, path.join(targetPath, jarInfo.jarName));
+  console.info(`============> jar包: ${jarInfo.jarName} 拉取成功，dir: ${targetPath}`);
+}
+
+const buildGradleStr = `
+plugins {
+  id 'java'
+}
+
+group 'com.weaver.seconddev'
+version '1.0.0'
+description 'ecode 二开demo'
+
+java.targetCompatibility = JavaVersion.VERSION_1_8
+
+compileJava {
+  options.encoding = 'UTF-8'
+}
+
+jar {
+  manifest {
+      attributes 'weaver-ecode-seconddev-id': rootProject.group + '-' + rootProject.name,
+          'Implementation-Version': version,
+          'Implementation-Vendor-Id': rootProject.group,
+          'Implementation-Title': rootProject.name
+  }
+}
+
+repositories {
+  maven { url 'https://maven.aliyun.com/repository/public/' }
+  mavenLocal()
+  mavenCentral()
+}
+
+
+dependencies {
+
+  implementation group: 'junit', name: 'junit', version: '4.12'
+  compileOnly group: 'org.projectlombok', name: 'lombok', version: '1.18.20'
+  annotationProcessor 'org.projectlombok:lombok:1.18.20'
+  implementation group: 'javax.servlet', name: 'javax.servlet-api', version: '4.0.1'
+
+  // 添加二开服务拉取的清单依赖
+  def includeType = ['**/*.jar', '**/*.class']
+  compile fileTree(dir: project.projectDir.getPath() + '/secDevLib', includes: includeType)
+  // 项目二开自定义依赖
+  // implementation fileTree(dir: project.projectDir.getPath() + "/devLib", includes: includeType)
+
+}
+
+
+`
+
+const settingGradleStr = `
+rootProject.name = 'seconddev-demo'
+`
+
+/**
+ * 生成项目依赖目录结构， 即 生成 secDevLib 目录，settings.gradle文件，build.gradle文件
+ * @param {*} projectPath 项目路径
+ * @param {*} jarData jarlist
+ */
+const createProjectItem = async (projectPath, jarData) => {
+  // 处理依赖
+  const secDevLibDir = path.join(projectPath, 'secDevLib');
+  console.info('创建二开依赖目录 => ', secDevLibDir);
+  if (!fs.existsSync(secDevLibDir)) mkdirs(secDevLibDir);
+  for (let i = 0; i < jarData.length; i++) {
+    if (fs.existsSync(path.join(secDevLibDir, jarData[i].jarName))) {
+      fs.rmSync(path.join(secDevLibDir, jarData[i].jarName));
+    }
+    fs.symlinkSync(path.join(cacheJarDir, jarData[i].md5, jarData[i].jarName), path.join(secDevLibDir, jarData[i].jarName));
+  }
+  console.info('创建gradle项目信息');
+  // 处理gradle文件
+  fs.writeFileSync(path.join(projectPath, 'build.gradle'), buildGradleStr);
+  fs.writeFileSync(path.join(projectPath, 'settings.gradle'), settingGradleStr);
+}
+
+/**
+ * e10 依赖拉取
+ */
+const loadJar = async (serviceUrl, projectPath) => {
+  const startTime = new Date().getTime();
+  console.info('============> 开始处理')
+  const listRes = await axios({url: `${serviceUrl}/papi/inner/ide/dependencyList`, method: 'get'})
+  if (listRes.status === 200 && listRes.data.code === 200) {
+    const { data = [] } = listRes.data;
+    for (let i = 0; i < data.length; i++) {
+      await handleJar(serviceUrl, data[i]);
+    }
+    createProjectItem(projectPath, data);
+    console.info(`============> 处理结束，jar包共计 ${data.length} 个， 耗时 ${new Date().getTime() - startTime} (ms)`);
+  } else {
+    console.info('dependencyList 接口异常：', listRes.status, listRes.data);
+  }
+}
+
+module.exports = function(serviceUrl, projectPath) {
+  
+  return loadJar(serviceUrl, projectPath);
+
 }

package/package.json

@@ -1,50 +1,53 @@
-{
-  "name": "weaver-e10-builder",
-  "version": "1.6.16",
-  "description": "Eteams/Ebuilder CLI — 泛微 OA 命令行工具",
-  "type": "module",
-  "files": [
-    "dist",
-    "ecodecmd",
-    "skill-docs",
-    "assets"
-  ],
-  "bin": {
-    "e10-cli": "dist/index.js",
-    "ecodecmd": "ecodecmd/src/index.js"
-  },
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsc",
-    "postinstall": "node ./dist/postinstall.js",
-    "pack:all": "node scripts/pack-editions.mjs",
-    "sync:docs": "node scripts/sync-skill-docs.mjs",
-    "start": "node dist/index.js",
-    "test": "tsx --test \"test/**/*.test.ts\""
-  },
-  "dependencies": {
-    "@napi-rs/keyring": "^1.3.0",
-    "@xmldom/xmldom": "0.8.15",
-    "archiver": "^5.3.1",
-    "axios": "^1.3.4",
-    "chalk": "^5.0.1",
-    "chokidar": "^3.5.3",
-    "commander": "^13.0.0",
-    "debug": "^4.3.4",
-    "fs-extra": "^10.1.0",
-    "js-base64": "^3.7.2",
-    "jszip": "3.10.1",
-    "mammoth": "^1.12.0",
-    "minimist": "^1.2.6",
-    "node-html-markdown": "^2.0.0",
-    "sql.js": "^1.11.0",
-    "tiny-pinyin": "^1.3.2",
-    "xlsx": "npm:@e965/xlsx@0.20.3"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/sql.js": "^1.4.11",
-    "tsx": "^4.19.0",
-    "typescript": "^5.6.0"
-  }
-}
+{
+  "name": "weaver-e10-builder",
+  "version": "1.7.0",
+  "description": "Eteams/Ebuilder CLI — 泛微 OA 命令行工具",
+  "type": "module",
+  "files": [
+    "dist",
+    "ecodecmd",
+    "ecode-ui",
+    "skill-docs",
+    "assets"
+  ],
+  "bin": {
+    "e10-cli": "dist/index.js",
+    "ecodecmd": "ecodecmd/src/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "postinstall": "node ./dist/postinstall.js",
+    "pack:all": "node scripts/pack-editions.mjs",
+    "sync:docs": "node scripts/sync-skill-docs.mjs",
+    "build:ecode-ui": "node scripts/build-ecode-ui-types.mjs",
+    "start": "node dist/index.js",
+    "test": "tsx --test \"test/**/*.test.ts\""
+  },
+  "dependencies": {
+    "@napi-rs/keyring": "^1.3.0",
+    "@types/react": "^17.0.10",
+    "@xmldom/xmldom": "0.8.15",
+    "archiver": "^5.3.1",
+    "axios": "^1.3.4",
+    "chalk": "^5.0.1",
+    "chokidar": "^3.5.3",
+    "commander": "^13.0.0",
+    "debug": "^4.3.4",
+    "fs-extra": "^10.1.0",
+    "js-base64": "^3.7.2",
+    "jszip": "3.10.1",
+    "mammoth": "^1.12.0",
+    "minimist": "^1.2.6",
+    "node-html-markdown": "^2.0.0",
+    "sql.js": "^1.11.0",
+    "tiny-pinyin": "^1.3.2",
+    "xlsx": "npm:@e965/xlsx@0.20.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/sql.js": "^1.4.11",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}

package/skill-docs/SKILL.md

@@ -2,11 +2,11 @@
 name: weaver-e10-builder
 display_name: 泛微E10智能搭建Skill
 display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.6.16
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.16。
-description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.6.16.
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.7.0
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.7.0。
+description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.7.0.
 category: coding
-version: 1.6.16
+version: 1.7.0
 author: 泛微网络科技股份有限公司
 auto: true
 ---
@@ -171,4 +171,18 @@ auto: true
 
 普通页面设计器源码 JS/CSS、页面 SDK、页面/组件加载事件、组件实例、列表勾选和插件、图表 option、页面内表单组件：阅读 [页面源码指南](references/ebuilder-designer/page-source/page-source-guide.md)，按 [SDK 索引](references/ebuilder-designer/page-source/sdk-index.md) 查接口。使用 `designer source read/check/set/sdk`；与表单 JSSDK、组件自由 CSS、独立 ecode 工程分开。
 
-页面/组件的单击与加载完成动作配置：阅读 [事件指南](references/ebuilder-designer/events/guide-events.md)，使用 `designer event get/set/enable/remove/schema/lookup`。**同一对象两种事件各最多一条，每条最多一个动作，替换不追加。** 页面跳转、条件、组件显隐、菜单、刷新和集成动作按该入口自己的参数与码表配置。
+页面/组件的单击与加载完成动作配置：阅读 [事件指南](references/ebuilder-designer/events/guide-events.md)，使用 `designer event get/set/enable/remove/schema/lookup`。同一触发支持有序多动作和递归 IF/ELSEIF/ELSE 分支，使用 action/branch 按 ID 编辑；set {actions:[...]} 明确整体替换。 页面跳转、条件、组件显隐、菜单、刷新和集成动作按该入口自己的参数与码表配置。
+
+页面内单个组件的使用范围、禁用范围、矩阵或EB表单相关人员授权：阅读 [组件权限指南](references/ebuilder-designer/component-permission.md)，使用 `designer permission`。与页面整体权限、列表数据权限分别配置。
+
+移动端标签栏、TabBar、首页、默认菜单、记忆菜单、最多显示数量、菜单排序与菜单事件：阅读 [标签栏指南](references/ebuilder-designer/guide-tabbar.md)，使用 `designer tabbar` 和 `designer event --collection items`。
+
+列表显示、查询分组统计、聚合、自定义计算、数据扩展和 CLICKDATA：阅读 [列表高级配置](references/ebuilder-designer/guide-list.md)，使用 `designer list advanced`。
+
+列表固定过滤、多字段排序、普通/快捷/分类搜索、系统与自定义操作按钮：阅读 [列表搜索与按钮指南](references/ebuilder-designer/guide-list.md)，使用 `designer list controls`；按钮动作使用 `designer event --collection listButtons`。
+
+列表表头快捷操作、隐藏表头、勾选框禁用、展示分组与上下级：阅读 [列表展示指南](references/ebuilder-designer/guide-list.md)，使用 `designer list advanced presentation`。
+
+自定义页面组件、嵌入页面/链接、条件切换内容、组件显示条件、标题与刷新/全屏/帮助按钮：阅读 [自定义页面组件指南](references/ebuilder-designer/guide-custom-page.md)，使用 `designer custom-page`；帮助动作使用 `designer event --collection customPageButtons`。
+
+普通页面重命名、复制、转移、删除、页面分组及可转移应用查询：阅读 [普通页面管理](references/ebuilder-designer/guide-page-management.md)，使用 `page rename/copy/transfer/groups/transfer-targets/delete`。

package/skill-docs/_catalog.md

@@ -57,6 +57,7 @@
 | 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
 | 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
 | 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
+| 报表代码块、开始区代码块、cusCode、按 sheet 存 JS/HTML | `report code-block get/set/clear`；先读 `references/report/code-block-guide.md` |
 | 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
 | 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
 | 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
@@ -121,7 +122,27 @@
 | 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
 
 - 流程功能设置（batch-set/auto-approve/other-set/水印/导入/事项赋权/文档权限）：`references/workflow/guide-function-settings.md`
+
+## 页面设计器扩展索引
+
+| 功能关键词 | 参考文档 |
+|---|---|
 | 页面权限、页面使用范围、页面禁用范围、页面矩阵授权、page permission | `references/ebuilder-designer/guide-page-permission.md` |
 | 组合页面、组合页签、页签可见范围、页签禁用范围、组合页头、组合复制、page combination | `references/ebuilder-designer/guide-page-combination.md` |
 | 普通页面源码、页面 JS/CSS、页面SDK、ebSdk、pageSdk、pageLoad、compLoad、compBeforeMount、getExports、列表插件、页面组件实例、designer source | `references/ebuilder-designer/page-source/page-source-guide.md`（功能、编写、保存）· `references/ebuilder-designer/page-source/sdk-index.md`（11 类 61 条 SDK 接口） |
-| 页面事件、组件事件、单击、加载完成、事件动作、打开页面、刷新组件、条件控制、显示隐藏组件、显示菜单、执行ESB、执行逻辑流、企业微信会话、扫描上传、报表事件、designer event | `references/ebuilder-designer/events/guide-events.md`（单事件单动作、命令与范围）· `references/ebuilder-designer/events/actions-interaction.md` · `references/ebuilder-designer/events/actions-integration.md` |
+| 页面事件、组件事件、单击、加载完成、事件动作、打开页面、刷新组件、条件控制、显示隐藏组件、显示菜单、执行ESB、执行逻辑流、企业微信会话、扫描上传、报表事件、designer event | `references/ebuilder-designer/events/guide-events.md`（顺序多动作、递归条件、命令与范围）· `references/ebuilder-designer/events/actions-interaction.md` · `references/ebuilder-designer/events/actions-integration.md` |
+| 组件权限、组件使用范围、组件禁用范围、矩阵相关、designer permission | `references/ebuilder-designer/component-permission.md` |
+
+| 移动端标签栏、TabBar、标签菜单、记忆菜单、默认菜单、designer tabbar | `references/ebuilder-designer/guide-tabbar.md` |
+
+| NList、列表数据范围、分组聚合、COUNT/SUM/MAX/MIN/AVG、数据扩展、CLICKDATA | `references/ebuilder-designer/guide-list.md` |
+
+| 列表过滤、排序、搜索、分类搜索、操作按钮、listButtons、designer list controls | `references/ebuilder-designer/guide-list.md` |
+
+| 表头快捷操作、隐藏表头、勾选框禁用、上下级、superiorField、enableGroup | `references/ebuilder-designer/guide-list.md` |
+
+| CustomPage、自定义页面组件、内嵌页面、conditionControl、showCondition、customPageButtons | `references/ebuilder-designer/guide-custom-page.md` |
+
+| 事件顺序、多动作、递归条件、IF/ELSEIF/ELSE、action/branch、行点击 | `references/ebuilder-designer/events/guide-events.md` |
+
+| 普通页面管理、重命名、复制页面、转移应用、页面分组、page rename/copy/transfer/delete | `references/ebuilder-designer/guide-page-management.md` |

package/skill-docs/actionflows/references/components/ebuilder/EventFormData.md

@@ -1,19 +1,19 @@
-# 表单数据触发（`EventFormData`）
-
-## 何时使用
-
-在 e-builder 表单新增、更新或删除数据后触发动作流。
-
-## 先查询
-
-查询触发表单及允许作为触发字段的真实字段。
-
-## 不可猜测
-
-触发时机、表单和字段以当前租户返回为准；不要把流程表单误当 e-builder 独立表单。
-
-多条数据变动的后续触发方式通过 `triggerType` 支持：`sequence`（依次）、`merge`（合并）、`parallel`（并行）。
-
-## 最小计划
-
-`dataSource` 与 `triggerTimes`；按需求补充触发字段。
+# 表单数据触发（`EventFormData`）
+
+## 何时使用
+
+在 e-builder 表单新增、更新或删除数据后触发动作流。
+
+## 先查询
+
+查询触发表单及允许作为触发字段的真实字段。
+
+## 不可猜测
+
+触发时机、表单和字段以当前租户返回为准；不要把流程表单误当 e-builder 独立表单。
+
+多条数据变动的后续触发方式通过 `triggerType` 支持：`sequence`（依次）、`merge`（合并）、`parallel`（并行）。
+
+## 最小计划
+
+`dataSource` 与 `triggerTimes`；按需求补充触发字段。

package/skill-docs/actionflows/references/components/message/SendMessage.md

@@ -1,32 +1,32 @@
-# 发送消息（`SendMessage`）
-
-## 何时使用
-
-向人员、部门、分部、角色、群组、岗位、人员范围、外部联系人、全员或上游对象发送 IM 消息。
-
-## 先查询
-
-固定接收人查询当前租户人员；上游负责人等动态接收人使用本次上下文；标题和正文中的动态片段也使用本次上下文。
-
-## 不可猜测
-
-提醒标题、提醒内容、推送图片 URL、PC 端链接和移动端链接统一使用前端 `AssignTextarea` 对应的 `ContestSettingDTO`。语义参数名分别为 `msgTitlev`、`msgContentv`、`picLink`、`msgPcLink`、`msgMobileLink`；可以传普通字符串、原生 `{id,content,formulaBeans,langSet}`，或 `parts` 模板。模板会编译成 Base64 内容、`#{paramN}` 占位符和独立 `formulaBeans`，对应手动配置时右侧的形式。**不再使用旧的 `msgTitle`、`msgContent`、`pcLink`、`mobileLink` 字段**。`parts` 的动态项支持 `context`、`system_variable`、`variable`、`constant`、`function`、`formula`、`query_result`，后两者必须按 `references/dynamic_resources.md` 使用真实资源或计划定义。需要拼接上下文时，必须拆成 `parts`，例如：
-
-```json
-{
-  "parts": [
-    {"type":"text","value":"批次任务："},
-    {"type":"context","paramKey":"<真实任务编号paramKey>","label":"任务编号"},
-    {"type":"text","value":"，设备："},
-    {"type":"context","paramKey":"<真实设备编号paramKey>","label":"设备编号"}
-  ]
-}
-```
-
-提醒对象使用 `receiver.type` 指定前端 `objType`：`resource`/`user`（人员）、`department`（部门）、`subcompany`（分部）、`role`（角色）、`group`（群组）、`position`（岗位）、`employeeScope`（人员范围）、`employeeShare`（人力资源条件）、`employeeOrganization`（人员组织多选）、`external`（外部联系人）、`all` 或 `allExternal`。固定对象使用 `{type,id,name}`；同一类型多选使用 `persons:[{id,name}]`，也可直接传前端多选 FormulaBean。部门/分部可传 `departmentAttribute` 和 `seclevel`，角色可传 `roleLevel`，岗位可传 `positionLevel`、`positionLevelDepartment`、`positionLevelSubcompany`、`positionAttribute`。动态对象使用 `kind:"context"`、`paramKey` 和 `label`，并可通过 `objectType` 指定非人员类型，例如 `{"type":"department","kind":"context","paramKey":"<真实部门字段paramKey>","label":"所属部门"}`。CLI 会按前端逻辑写入 `shareList` 的 `obj_id` / `obj_id_*` 字段；`objectList` 仅保留旧版兼容数据。模板上下文只传 `paramKey` 和 `label`，由 CLI 按消息编辑器的动态片段结构编译，并绑定当前触发节点。对定时批量、按日期字段、表单数据等 e-builder 记录触发器，未显式提供链接时 CLI 自动生成 `msgPcLink` / `msgMobileLink` 的 PC/移动端详情链接：`formId` 为触发表单 ID 固定值，`dataId` 为上游“数据ID”动态上下文。显式 `msgPcLink` / `msgMobileLink` 会覆盖该默认行为。
-
-动态接收人的 `shareList` 必须以 `targetId: "esbAssign"` 保存，并在对应的 `obj_id` 或 `obj_id_<类型>` 放入真实来源的动态公式；公式 `source`/`config.comId` 指向上游组件，而非提醒对象自身的 `sourceId`。人员变量使用 `{"kind":"variable","id":"<已解析变量ID>"}`；上下文字段必须取自 `getComponentContext`。部门、角色等 `targetType` 按前端对象类型及范围设置计算。固定对象仍以实际对象 ID 作为 `targetId`。
-
-## 最小计划
-
-`receiver`、`msgTitlev`、`msgContentv`。
+# 发送消息（`SendMessage`）
+
+## 何时使用
+
+向人员、部门、分部、角色、群组、岗位、人员范围、外部联系人、全员或上游对象发送 IM 消息。
+
+## 先查询
+
+固定接收人查询当前租户人员；上游负责人等动态接收人使用本次上下文；标题和正文中的动态片段也使用本次上下文。
+
+## 不可猜测
+
+提醒标题、提醒内容、推送图片 URL、PC 端链接和移动端链接统一使用前端 `AssignTextarea` 对应的 `ContestSettingDTO`。语义参数名分别为 `msgTitlev`、`msgContentv`、`picLink`、`msgPcLink`、`msgMobileLink`；可以传普通字符串、原生 `{id,content,formulaBeans,langSet}`，或 `parts` 模板。模板会编译成 Base64 内容、`#{paramN}` 占位符和独立 `formulaBeans`，对应手动配置时右侧的形式。**不再使用旧的 `msgTitle`、`msgContent`、`pcLink`、`mobileLink` 字段**。`parts` 的动态项支持 `context`、`system_variable`、`variable`、`constant`、`function`、`formula`、`query_result`，后两者必须按 `references/dynamic_resources.md` 使用真实资源或计划定义。需要拼接上下文时，必须拆成 `parts`，例如：
+
+```json
+{
+  "parts": [
+    {"type":"text","value":"批次任务："},
+    {"type":"context","paramKey":"<真实任务编号paramKey>","label":"任务编号"},
+    {"type":"text","value":"，设备："},
+    {"type":"context","paramKey":"<真实设备编号paramKey>","label":"设备编号"}
+  ]
+}
+```
+
+提醒对象使用 `receiver.type` 指定前端 `objType`：`resource`/`user`（人员）、`department`（部门）、`subcompany`（分部）、`role`（角色）、`group`（群组）、`position`（岗位）、`employeeScope`（人员范围）、`employeeShare`（人力资源条件）、`employeeOrganization`（人员组织多选）、`external`（外部联系人）、`all` 或 `allExternal`。固定对象使用 `{type,id,name}`；同一类型多选使用 `persons:[{id,name}]`，也可直接传前端多选 FormulaBean。部门/分部可传 `departmentAttribute` 和 `seclevel`，角色可传 `roleLevel`，岗位可传 `positionLevel`、`positionLevelDepartment`、`positionLevelSubcompany`、`positionAttribute`。动态对象使用 `kind:"context"`、`paramKey` 和 `label`，并可通过 `objectType` 指定非人员类型，例如 `{"type":"department","kind":"context","paramKey":"<真实部门字段paramKey>","label":"所属部门"}`。CLI 会按前端逻辑写入 `shareList` 的 `obj_id` / `obj_id_*` 字段；`objectList` 仅保留旧版兼容数据。模板上下文只传 `paramKey` 和 `label`，由 CLI 按消息编辑器的动态片段结构编译，并绑定当前触发节点。对定时批量、按日期字段、表单数据等 e-builder 记录触发器，未显式提供链接时 CLI 自动生成 `msgPcLink` / `msgMobileLink` 的 PC/移动端详情链接：`formId` 为触发表单 ID 固定值，`dataId` 为上游“数据ID”动态上下文。显式 `msgPcLink` / `msgMobileLink` 会覆盖该默认行为。
+
+动态接收人的 `shareList` 必须以 `targetId: "esbAssign"` 保存，并在对应的 `obj_id` 或 `obj_id_<类型>` 放入真实来源的动态公式；公式 `source`/`config.comId` 指向上游组件，而非提醒对象自身的 `sourceId`。人员变量使用 `{"kind":"variable","id":"<已解析变量ID>"}`；上下文字段必须取自 `getComponentContext`。部门、角色等 `targetType` 按前端对象类型及范围设置计算。固定对象仍以实际对象 ID 作为 `targetId`。
+
+## 最小计划
+
+`receiver`、`msgTitlev`、`msgContentv`。