weaver-e10-builder 1.6.14 → 1.6.16

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,50 @@
-{
-  "name": "weaver-e10-builder",
-  "version": "1.6.14",
-  "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.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"
+  }
+}

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.14
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.6.14。
-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.14.
+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.
 category: coding
-version: 1.6.14
+version: 1.6.16
 author: 泛微网络科技股份有限公司
 auto: true
 ---

package/skill-docs/actionflows/SKILL.md

@@ -24,7 +24,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 
 ### 1. 识别与选择
 
-1. 拆出触发器、动作顺序、条件/循环、固定资源与动态来源。
+1. 拆出触发器、动作顺序、条件、固定资源与动态来源。
 2. 运行 `e10-cli actionflow component-list`，选择已登记组件。
 3. 对每一个选中的组件运行 `e10-cli actionflow component-describe <type>`，再只读取下方目录中该组件的 Markdown。
 4. 若存在多个业务选择会改变结果，或用户明确指定的资源找不到，暂停说明差异并询问；其余可查询的信息直接查询。
@@ -33,16 +33,18 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 
 按 `component-describe` 的 `propertySources` 查询本次租户数据：
 
-- 流程：`e10-cli actionflow workflow-browser-list` / `workflow-search` / `workflow-nodes`。
+- 循环组件支持指定次数、条件、逐条数据和分批数据四种方式；循环体与参数结构见 `references/components/logic/MultipleExecution.md`。
+- 获取字段元数据时，按接口需要传组件、表单或数据源等定位参数，先获取该范围的完整字段列表，再在本地按字段名称或路径匹配；不要把目标字段名称作为字段接口的查询条件，也不要逐个字段调用接口。若接口分页则取全各页；名称匹配不唯一时使用完整路径或真实字段 ID 消歧。下方上下文字段命令的 `query` 只用于本地筛选返回结果。
+- 流程定义：`e10-cli actionflow workflow-browser-list` / `workflow-search` / `workflow-nodes`。流程实例（固定 `requestId`）：`e10-cli actionflow workflow-request-search '{"searchValue":"<流程标题>"}'`，使用 `wfcRequest`；该接口只支持按名称联想，纯 ID 不能反查。人员、流程实例、日程类型、会议室、文档、目录和借阅记录等固定 Browser 值统一按名称查询；若同时提供 id，则用于唯一性校验。只有 id、没有名称时必须停止，不能拼造 `originValue`。动态 `requestId` 从实时上下文字段赋值。
 - 流程动态字段：`e10-cli actionflow workflow-context-fields`。默认每页 20 条；按需求字段名先传 `query`（例如 `{"workflowId":"<id>","query":"数据ID"}`），只使用本次返回的 `fields[].paramKey`。完整响应过大时用 `--out context.json` 落盘，禁止依赖终端截断后的片段。
-- 其他组件动态字段：`e10-cli actionflow component-context-fields '{"componentType":"<组件类型>","currentApplication":"<当前动作流ID；新建传0>","eventNodeId":"<上游节点ID>","params":{...},"query":"<字段名或关键词>"}'`。该命令会先解析数据源 Browser，再查询 `showDataSourceFields` 匹配实际可选输出字段，随后编译组件上下文并调用 `getComponentContext`。`EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 都适用。**必须在写入任何动态赋值前查询来源组件**；只允许从本次 `getComponentContext` 结果选择 `fields[].paramKey`，接口未返回的字段必须先查明该组件是否有受支持的依据值/循环语义，否则停止该映射，不得凭字段名、约定根节点或历史经验补造。
+- 其他组件动态字段：`e10-cli actionflow component-context-fields '{"componentType":"<组件类型>","currentApplication":"<当前动作流ID；新建传0>","eventNodeId":"<上游节点ID>","params":{...},"query":"<字段名或关键词>"}'`。该命令会先解析数据源 Browser，再查询 `showDataSourceFields` 匹配实际可选输出字段，随后编译组件上下文并调用 `getComponentContext`。`EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 都适用。**必须在写入任何动态赋值前查询来源组件**；只允许从本次 `getComponentContext` 结果选择 `fields[].paramKey`，接口未返回的字段必须先查明该组件是否有受支持的依据值语义，否则停止该映射，不得凭字段名、约定根节点或历史经验补造。
 - 数据源名称通过 Browser 模糊搜索：只有一个候选时使用该候选；多个候选时展示名称、所属应用和 ID，让用户选择。拿到选择的 ID 后重新解析；数据源 ID 和 `type/sourceType` 均使用接口返回值。
 - 计划按执行顺序构造时，先查询触发器，再逐个查询会提供动态数据的上游动作；每一步都用该组件本次真实参数（尤其数据源、目标表和选中的字段）查询。下游映射只能选择已查询来源返回的字段。`generate` 的预检是最后一道校验，不可代替生成前的字段发现。
 - e-builder（**已知表名时首选**）：`e10-cli actionflow form-search '{"keyword":"<表名>"}'` 一次拿到表单 `objId` 与它所属的业务应用 `appId`。服务端是**子串模糊匹配**，同名表跨多个应用很常见（返回体里的 `完全同名` 即同名条数）—— **多于一条时必须按 `appName` 收窄再取**，不得自行挑一个：`'{"keyword":"<表名>","appName":"<应用名>"}'`。`keyword` 传 `objId` 则是精确命中，可用来由 id 反查所属应用。
   - **`appName` 走服务端过滤**（不是本地二次筛）：应用名精确唯一才用；**同名多命中或查无此名会直接报错并列出候选**，此时改用 `appId` 指定，不要换个近似名重试。
   - **返回体 `total` 是服务端在该筛选下的命中总数，`hits` 可能只是其中一部分。** 默认最多返回 100 条，超出时 `truncated: true` 并给出 `omitted`（未返回条数）。**`truncated` 为真时绝不能判定「表单不存在」** —— 先按 `appName` 收窄，确需全部再传 `{"max":0}`（条数大时用 `--out <file>` 落盘）。判断是否唯一命中以 `唯一命中` 字段为准，不要自己数 `hits` 长度。
 - e-builder（**只知道应用、要浏览全表**）：`e10-cli actionflow form-applications` → `form-list` → `form-fields`。`form-applications` 返回的业务应用 `id` 用于下一步：`e10-cli actionflow form-list '{"groupId":"<业务应用ID>"}'`；这里必须是 `groupId`，不能传 `appId`。表单字段查询才使用 `{"tableId":"<表单ID>","appId":"<业务应用ID>"}`。
-- 人员：`e10-cli actionflow recipient-search`。
+- 人员：`e10-cli actionflow recipient-search '{"searchValue":"<姓名>"}'`；必须提供 `searchValue`，不接受 `keyword`。
 - 人员入职/更新字段：`e10-cli actionflow hrm-onboarding-fields`。
 - 文档状态：`e10-cli actionflow document-statuses`。
 
@@ -50,22 +52,24 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 
 ### 3. 组装语义计划
 
-1. 写入 `event`、`actions`，条件和循环作为动作拓扑的一部分。
+1. 写入 `event`、`actions`，条件作为动作拓扑的一部分。
 2. 只传 `component-describe` 声明的参数；固定值与动态值根据业务需求选择，不能为了动态而动态。
-3. 语义 plan 的节点配置统一放在 `params`：`event.params`、`actions[*].params` 以及条件/循环内部节点的 `params`。`data` 仅属于平台回读/更新 DTO，不能出现在 `generate` 语义计划中；CLI 会在调用任何平台接口前拒绝该结构，并提示具体路径。
+3. 语义 plan 的节点配置统一放在 `params`：`event.params`、`actions[*].params` 以及条件内部节点的 `params`。`data` 仅属于平台回读/更新 DTO，不能出现在 `generate` 语义计划中；CLI 会在调用任何平台接口前拒绝该结构，并提示具体路径。
 4. 中文 plan 写入当前工作区 `.actionflow-plans/`，以 `planFile` 传给 CLI；不在 Skill 目录写临时文件。CLI 不会自动删除 plan；确认 `valid=true`、`saved=true`、`readBackVerified=true` 后才允许手工清理。
 4.1. 命名遵循“展示中文、机器字段 code 化”：动作流名称、节点显示名称、参数 `showName`/`label`、说明文字等面向用户的展示字段可以使用中文；`paramName`、`paramKey`、变量/常量引用名、请求编码、Topic/队列名、字段路径、公式引用键以及其他机器可读标识默认使用英文字母、数字和下划线，优先 lowerCamelCase 或 snake_case，不使用中文、空格或特殊字符。`type`、`kind`、`paramType`、枚举值等必须沿用组件契约中的 code；已从平台真实对象取得的 ID、名称、原生 DTO 字段和固定资源值不得擅自改写，只对 AI 新建的语义标识执行该规则。
 5. 不把 `Output` 写入 `actions`。需要配置终止状态、提示或页面动作时使用顶层 `finalOutput.params`；提醒内容使用前端富文本组件对应的 `reminderContent`（`ContestSettingDTO`，动态片段放在 `formulaBeans`），不要使用旧的 `reminderMsgFormula`。流程触发（`ApproveTrigger`）只支持提醒，不支持页面交互、页面动作或跳转地址；页面动作仅可用于 `EventButton`。平台内部 FormulaBean 由 CLI 生成，只有组件契约明确要求前端原对象时才传原生 DTO。
-5.1. 所有 CLI 生成或继续编译的 FormulaBean，只要包含 `frontId`，允许使用空串；非空时必须使用平台真实字段 ID 的纯数字字符串。`field_<数字>` 仅可在生成时规范化为 `<数字>`。禁止把字段名、paramKey 尾段、临时公式 ID 或其他包含字母/符号的值写入 `frontId`；非空值无法解析为纯数字时必须直接报错。
+5.1. 动态上下文字段的 `frontId` 必须使用来源组件实时接口返回的字段 ID，保留接口原值；缺失时停止生成并提示查询上下文。禁止从字段名、目标字段、paramKey 尾段或 `field_` 前缀转换得到字段 ID。原生 FormulaBean 保留其原始 `frontId`；默认记录详情链接等前端明确使用公式实例 ID 的场景按对应协议处理；手动选择的富文本动态字段仍使用参数行 ID。
 6. 定时组件优先使用平台原生频率：`rate=1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月，并按需提供 `cycle`、`hour`、`day`、`week`、`atWeek`、`atWeekDetail` 或 `lastWeek`；只有明确选择 `rate=6` 时才传 `cornString`。图形化频率必须提供 `startTime`。
 7. `EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 的 `queryFields` 会裁剪 `getComponentContext` 返回的动态上下文。字段必须来自当前租户的 `showDataSourceFields` 完整字段对象；若后续动态赋值引用了其中字段，预检会按真实字段 ID 匹配并把它并入 `queryFields`，匹配不到就报错，不能按名称或路径尾段造字段。未明确限制输出字段时不传 `queryFields`（或传空数组），CLI 默认全选。查询节点还必须使用自身真实节点 ID 作为 `dataSource.enquiryId`，否则平台可能静默丢弃业务字段。正式回读必须确认每个声明的 `queryFields` 仍存在；缺失即生成失败，不能仅凭接口 `code=200`、`saved=true` 判定成功。e-builder 数据触发后发送消息且未显式给链接时，CLI 自动补 PC/移动端当前记录详情链接；不手写 `{formId}` / `{dataId}` 的 FormulaBean。查询结果字段动态赋值必须使用 `getComponentContext` 返回的真实 `paramKey` 和字段实例 ID；字段名称缺失或匹配不唯一时停止，不按数字 ID 拼接前缀。禁止使用 `FormData.<表单ID>[临时位置]...`，也禁止把临时公式 ID 当作 `frontId`。
 8. `ActionEbAdd` 批量新增以 `basisValue` 为明细行上下文：来源于该行的字段都用 `mapping`，编译为“依据值下级”（`switchType:"sub"`），下拉字段也同样处理。只有已核实来源/目标选项 ID 不同且语义需要转换时，才使用 `SWITCH`。关联 e-builder 字段应引用查询结果的 `数据ID`，固定格式为 `{target,kind:"query_result",source:"<EnquiryForm ref>",formId,fieldId:"id",index:0}`；`kind:"enquiry"`、`sourceId` 等旧写法会直接报错，绝不降级为空固定值。
 9. 动态赋值可使用或新建动作流变量、租户常量：已有资源必须用真实 ID；计划新建变量写顶层 `variables[]`，新建常量写 `constantDefinitions[]`，常量分组可传 `groupPk` 或 `groupName`。变量按当前 `applicationId + sceneId` 隔离，常量按分组跨动作流复用。生成时先调用真实接口创建/解析资源，再编译为变量 `type:"7"` 或常量 `type:"5"` FormulaBean；详细格式见 `references/dynamic_resources.md`。消息 `SendMessage.msgTitlev/msgContentv/picLink/msgPcLink/msgMobileLink` 的 `parts` 支持 `variable`/`constant` 动态片段，并统一保存为 `ContestSettingDTO`。
 9.1. 每个参数先分为“动态公式属性”“动态人员属性”“固定平台资源属性”三类：上下文、系统变量、变量、常量、函数/公式必须保留为 FormulaBean；动态人员必须使用真实人员字段上下文或系统变量，不得把引用里的 `id` 当人员 Browser ID 查询；工作流、文档目录、按钮、规则等平台资源只有在其组件契约明确提供动态引用时才允许动态化。生成前必须记录本次组件/属性的判定，生成后按属性检查回读结果；具体映射和验证状态见 `references/dynamic_capability_matrix.md`。
-10. 自定义事件和内置 MQ 的参数必须按对应平台组件说明提供原生参数对象；`CustomTrigger.customData`、`InnerMQListener.receiveParams`、`InnerMQSend.sendParams` 不能用猜测的字段替代。若验证要求“输入参数里有字段”，必须在生成前提供至少一行真实原生参数；`tables:[]`、`tableList:[]` 或省略 `receiveParams` 只能表示无输入参数，不能作为有参数的占位。`InnerMQListener` 与 `InnerMQSend` 是动作流级互斥组件，同一计划（包括条件/循环嵌套）同时出现时，CLI 在任何平台写接口前直接报错。
+10. 自定义事件和内置 MQ 的参数必须按对应平台组件说明提供原生参数对象；`CustomTrigger.customData`、`InnerMQListener.receiveParams`、`InnerMQSend.sendParams` 不能用猜测的字段替代。若验证要求“输入参数里有字段”，必须在生成前提供至少一行真实原生参数；`tables:[]`、`tableList:[]` 或省略 `receiveParams` 只能表示无输入参数，不能作为有参数的占位。`InnerMQListener` 与 `InnerMQSend` 是动作流级互斥组件，同一计划（包括条件嵌套）同时出现时，CLI 在任何平台写接口前直接报错。
 11. 根触发节点的 `event.attr.icon` 必须使用平台真实图标：`CustomTrigger` 为 `Icon-N-Triggerrul`，`InnerMQListener` 为 `Icon-built-in-mq-listening-mcolor`；组件目录里的动作图标不能覆盖根触发器图标。保存后回读必须同时检查触发器图标、已声明输入参数的数量和查询字段，不能仅凭 `valid=true` / `saved=true` 判定配置正确。
-12. 仅在生成 `ParamMappingBean`、`ParamSettingBean`（及其同形态的参数分组 DTO）的 `tableData[].paramType` 时，按后端 `com.weaver.esb.base.enums.ParamType` 归一化：无法匹配枚举值回退为文本 `string`；数字类型统一为整数 `int`；长整型统一为文本 `string`。这条规则不适用于普通 `FormulaBean`、表单字段上下文、循环上下文或 `CustSetFormDto`。`paramType=json` 或 `arrs=true` 时 `dataType` 强制为节点 `node`，不能保留/生成属性 `attribute`；其他普通标量默认使用属性，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
-12.1. 所有组件的动态字段最终都必须生成合法的 `FormulaBean`，统一按以下五类来源处理：①普通组件上下文只能使用该组件 `getComponentContext` 返回的字段元数据；②循环体字段使用前端循环上下文拼出的 `CycleParams`，并保留循环数据源的真实来源；③`EsbFormDataDto` 的依据值下级按表单设置组件的 `basisValue`、`parentName`、`paramName` 和数组层级规则生成；④`ParamMappingBean`/`ParamSettingBean` 的依据值下级按参数设置组件的相对 `paramKey` 和 `basisParamKey` 规则生成；⑤`CustSetFormDto` 的依据值下级沿用表单设置组件规则。不能按字段名、paramKey 尾段、组件默认根或临时 ID 凭空补造 `frontId`、`parentName`、`paramKey`、`newParentName`；缺少真实上下文时应在预检阶段报错。
+12. 仅在生成 `ParamMappingBean`、`ParamSettingBean`（及其同形态的参数分组 DTO）的 `tableData[].paramType` 时，按后端 `com.weaver.esb.base.enums.ParamType` 归一化：无法匹配枚举值回退为文本 `string`；数字类型统一为整数 `int`；长整型统一为文本 `string`。这条规则不适用于普通 `FormulaBean`、表单字段上下文或 `CustSetFormDto`。`paramType=json` 或 `arrs=true` 时 `dataType` 强制为节点 `node`，不能保留/生成属性 `attribute`；其他普通标量默认使用属性，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
+参数 ID：新建参数设置或映射 DTO（含分组）时，在 DTO 根对象设置 `idPolicy: "new"`；CLI 在首次获取组件上下文前生成雪花 ID，并同步参数父子关系、展开行和依据参数行引用，提交后端时移除此标记。新建字段可省略 ID；存在父子关系时用唯一的临时 ID 及 `parentId` 关联，不能把从 1 开始的临时编号当作平台 ID。对于接口返回的已有参数 DTO，保留其真实 ID，不设置此标记。普通动态赋值的 `source` 和 `frontId` 仍取来源组件真实上下文，不随目标参数 ID 重生成。
+
+12.1. 所有组件的动态字段最终都必须生成合法的 `FormulaBean`，统一按以下四类来源处理：①普通组件上下文只能使用该组件 `getComponentContext` 返回的字段元数据；②`EsbFormDataDto` 的依据值下级按表单设置组件的 `basisValue`、`parentName`、`paramName` 和数组层级规则生成；③`ParamMappingBean`/`ParamSettingBean` 的依据值下级按参数设置组件的相对 `paramKey` 和 `basisParamKey` 规则生成；④`CustSetFormDto` 的依据值下级沿用表单设置组件规则。不能按字段名、paramKey 尾段、组件默认根或临时 ID 凭空补造 `frontId`、`parentName`、`paramKey`、`newParentName`；缺少真实上下文时应在预检阶段报错。
 
 ### 4. 生成与逐场景反馈
 
@@ -141,7 +145,7 @@ e10-cli actionflow update '@update-plan.json' --out update-result.json       #
 
 当前可生成的事件触发器：`ApproveTrigger`（流程事件）、`EventFormData`（e-builder 数据新增/更新/删除/字段变化）、`EventButton`（点击 e-builder 指定按钮）、`DateTrigger`、`TimeBatchTrigger`、`SimpleScheduler`、`CustomTrigger`（自定义事件）、`InnerMQListener`（内置 MQ 监听）和 `WebHookTrigger`（外部 WebHook 请求）。`EventButton` 必须先用 `e10-cli actionflow form-buttons '{"tableId":"<表单ID>","appId":"<应用ID>"}'` 查询真实按钮，再以 `targetForm`、`buttonType:[{id,name,buttonLocation:"before"|"after"}]` 和可选 `triggerType` 生成；不得用 `EventFormData` 冒充按钮点击。`CustomTrigger`、`InnerMQListener` 和 `WebHookTrigger` 的原生参数要求见 `references/components/trigger/CustomTrigger.md`、`references/components/trigger/InnerMQListener.md`、`references/components/trigger/WebHookTrigger.md`。
 
-`CustomTrigger` 的上下文动态赋值使用 `SelectParams` 作为最终上下文根。`paramKey` 只写业务路径，不写 `FormData.`、`ApprovalData.` 或 `SelectParams.` 前缀；主表字段格式为 `主表key.字段key`，明细字段格式为 `主表key.明细表key[].字段key`，主表与明细表必须沿用同一个主表 key。最终公式中的 `value`、`currentParamKey` 和 `allParamKey` 才补 `SelectParams.` 前缀，不能把明细字段写成 `FormData.明细表key[].字段key`。如果动态赋值来源于该触发器生成的 `customData`（`CustSetFormDto`），必须先在 `customData.tableList[]` 定位 `CustFormTableDto`，表维度取表对象 `id`，字段维度再从该表 `fields[]` 定位 `CustFormDetailDto` 并取字段对象 `id`，把这个 ID 设置到关联 FormulaBean.frontId；不得使用目标字段 ID、FormulaBean.id、表/字段名称或 paramKey 尾段。对应 ID 缺失时 frontId 使用空串，非空值必须为纯数字字符串。完整规则见 `references/components/trigger/CustomTrigger.md`。
+`CustomTrigger` 的上下文动态赋值使用 `SelectParams` 作为最终上下文根。`paramKey` 只写业务路径，不写 `FormData.`、`ApprovalData.` 或 `SelectParams.` 前缀；主表字段格式为 `主表key.字段key`，明细字段格式为 `主表key.明细表key[].字段key`，主表与明细表必须沿用同一个主表 key。最终公式中的 `value`、`currentParamKey` 和 `allParamKey` 才补 `SelectParams.` 前缀，不能把明细字段写成 `FormData.明细表key[].字段key`。动态赋值来自该触发器时，必须查询 `getComponentContext`，按所选表或字段的完整路径定位参数行，使用该 `ParamBean.id` 设置 FormulaBean.frontId；不得使用目标字段 ID、FormulaBean.id、表/字段名称或 paramKey 尾段。对应 ID 缺失时停止生成并提示查询上下文，取得后原样使用。完整规则见 `references/components/trigger/CustomTrigger.md`。
 
 动作 `Http` 用于调用当前租户已配置的 HTTP/HTTPS 接口，参数要求见 `references/components/http/Http.md`；HTTPS 使用同一个 `Http` 组件，不能把协议地址当成新的组件类型。生成前会实时读取并校验“连接器 → 资源 → 接口 → 接口详情”，节点标题按“当前连接器: 当前接口”回填，图标按当前连接器目录回填；不存在、跨租户或归属不一致时拒绝生成，不信任旧环境的 E9 等名称、地址、图标或原生映射。HTTP 请求字段通过 `inputParams` 配置，必须用接口详情真实返回的 `table`/`paramKey`，CLI 写入参数行的 `formulaData`，支持统一的固定值、上下文、系统变量及函数/公式赋值；不能猜参数或直接改写 `request.tables`。动作 `serverless/Action` 用于执行二开代码，参数要求见 `references/components/serverless/ServerlessAction.md`；输入和输出必须传前端参数设计器生成的原生 ParamBean 结构。动作 `InnerMQSend` 用于向平台内置 MQ 发送消息，参数要求见 `references/components/message/InnerMQSend.md`。`InnerMQListener` 和 `InnerMQSend` 不能放在同一个动作流中；该约束也适用于 `update` 修改后的完整设计。
 

package/skill-docs/actionflows/references/components/database/DMLExecute.md

@@ -36,3 +36,7 @@
 `dataset.module`、`dataset.type`、`sqlQuery.fields` 缺失时由 CLI 按平台结构补齐；存储过程的输出参数使用 `resultSets`。SQL 不能凭空编造，表名、字段、条件不明确时先确认，CLI 不查询数据库表结构。
 
 平台保存 DML 时的 SQL 分析失败不一定阻止保存和启用，因此含 DML 的生成结果会额外回读 `analysisSql`。终端摘要中的 `sqlAnalysisOk` 必须为 `true`，否则只能说明动作流已保存，不能说明 SQL 可执行。
+
+## 新建参数的 ID
+
+新建参数设置或映射 DTO 时，在对应参数对象根部指定 `idPolicy: "new"`，CLI 会分配雪花 ID 并同步父子行和依据参数引用。需要引用父行时可用唯一临时 ID 关联；接口返回的已有参数应保留原 ID，不设置此标记。该标记仅供 CLI 使用，不传给后端。

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

@@ -88,7 +88,7 @@
 
 ## 动态来源选择与查询结果引用
 
-- AI 应按需求和已生成上游节点的真实上下文选择来源：流程触发字段、前序动作输出、当次循环、系统变量、固定值或查询结果均可；**不得默认把所有映射绑定到流程触发，也不得默认插入查询节点**。
+- AI 应按需求和已生成上游节点的真实上下文选择来源：流程触发字段、前序动作输出、系统变量、固定值或查询结果均可；**不得默认把所有映射绑定到流程触发，也不得默认插入查询节点**。
 - 仅当业务需要从另一张表反查、且结果可确定为单条时，才使用 `EnquiryForm` 查询 + 主表字段 `query_result` 引用（手工创建成功样本：`actionflows/references/examples/enquiry-form-batch-insert-scene2.json`）。
   - EnquiryForm 在前，ActionEbAdd 的 sources 指向 EnquiryForm 节点；主表字段 assign `type=3`，`value="FormData.{查询表id}[{positionId}].id"`，`config.comType="EnquiryForm"`、`comId=EnquiryForm 节点 id`、`paramKey="{查询表id}[].id"`，childs 带固定值取下标 `[{type:"1", value:"0", position}]`。
   - 细节见 `EnquiryForm.md`「批量新增主表字段引用查询结果」。

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

@@ -30,6 +30,8 @@
 
 `needAdd` 对应平台参数 `EbuilderActionDTO.needAdd`，默认 `false`。设为 `true` 时启用“条件不满足时插入”：匹配到目标记录时更新，未匹配到时新增。需要“存在则更新、否则新增”时应设置 `needAdd: true`，不需要另行组合新增组件。
 
+内置 MQ 监听来源同样可使用 `opType:"fieldUpdate"` 配合 `needAdd:true`；匹配字段不能同时作为主表更新赋值目标。主表 `updates` 和明细 `detail` 可以配置在同一节点。
+
 当 `id` 或 `fieldUpdate` 配置了 `basisValue` 时，如果 `updateId` 或 `updateFieldCondition.updateField[].assign` 的来源字段 `paramKey` 明确位于该依据值下级（例如依据值为 `100.12345[]`，来源字段为 `100.12345[].67890`），CLI 会按前端“依据值下级”协议编译为 `type:"10"`、`config.switchType:"sub"`。只有路径明确以该依据值加 `.` 开头时才会转换；不相关的明细字段仍按普通动态上下文编译，不凭路径形状猜测依据关系。`basisValue` 和来源字段都应使用前置上下文接口返回的真实字段元数据。
 
 ### 明细表策略

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`；按需求补充触发字段。