openyida 2026.8.29 → 2026.8.30

package/README.md

@@ -199,6 +199,7 @@ openyida create-process APP_XXX "Purchase Request" .cache/openyida/process/field
 openyida configure-process APP_XXX FORM_XXX .cache/openyida/process/process.json
 openyida process preview APP_XXX PROC_INST_XXX --output .cache/openyida/process/process.html
 openyida data query form APP_XXX FORM_XXX --page 1 --size 20
+openyida data query form APP_XXX FORM_XXX --dynamic-order '{"dateField_xxx":"-"}'
 openyida data create form APP_XXX FORM_XXX --data-file .cache/openyida/data-import/record.json
 openyida get-permission APP_XXX FORM_XXX
 ```
@@ -226,6 +227,7 @@ openyida get-permission APP_XXX FORM_XXX
 发布成功还必须精确回读同一 PUBLISHED `processId/processVersion` 的 `getProcessById` 平台视图，并验证可见节点的组件、名称、顺序和审批模式。只有输出 `verificationLevel: "PLATFORM_VIEW_VERIFIED"` 才表示平台 view 已验证；`PUBLISHED_UNVERIFIED` 表示发布可能已生效但回读不完整，不能宣称 `processJson` 已验证，也不能直接重放写请求。
 
 When creating or updating test data with `openyida data`, Yida date fields must use 13-digit millisecond timestamps, for example `"dateField_xxx": 1719705600000`. Do not submit `YYYY-MM-DD` strings for `DateField` or `CascadeDateField` values.
+For deterministic query order, pass `--dynamic-order '{"fieldId":"+"}'` for ascending order or `--dynamic-order '{"fieldId":"-"}'` for descending order. Without `--dynamic-order`, `searchFormDatas` does not guarantee a stable result order; pagination, comparison, and pairing logic must not depend on the default order.
 Temporary JSON, CSV, and one-off import scripts should live under `.cache/openyida/` so generated run artifacts do not clutter the repository root.
 
 ### Real Environment E2E

package/lib/core/query-data.js

@@ -24,7 +24,7 @@ const { readFormMode } = require('../app/services/form-mode-service');
 const USAGE = `openyida data - Unified Yida data CLI
 
 Usage:
-  openyida data query form <appType> <formUuid> [--page N] [--size N] [--all] [--max-pages N] [--search-json JSON|--search-file .cache/openyida/search.json] [--resolve-aliases] [--inst-id ID] [--no-hydrate-subforms]
+  openyida data query form <appType> <formUuid> [--page N] [--size N] [--all] [--max-pages N] [--search-json JSON|--search-file .cache/openyida/search.json] [--dynamic-order '{"fieldId":"+"}'] [--resolve-aliases] [--inst-id ID] [--no-hydrate-subforms]
   openyida data get form <appType> --inst-id <formInstId> [--form-uuid <formUuid>] [--no-hydrate-subforms]
   openyida data create form <appType> <formUuid> (--data-json <JSON>|--data-file .cache/openyida/data.json) [--dept-id ID] [--resolve-aliases]
     说明：若目标表单为流程表单，会自动使用 /v1/process/startInstance.json 发起流程。
@@ -41,6 +41,8 @@ Usage:
   openyida data query tasks <appType> --type <todo|done|submitted|cc> [--page N] [--size N] [--keyword TEXT] [--process-codes JSON] [--instance-status STATUS]
 
 Add --resolve-aliases when JSON keys use Yida component aliases instead of field IDs.
+Use --dynamic-order '{"fieldId":"+"}' for ascending order or '{"fieldId":"-"}' for descending order.
+When --dynamic-order is omitted, the API does not guarantee a stable result order.
 `;
 
 function fail(message) {

package/lib/core/utils.js

@@ -1237,6 +1237,26 @@ async function httpPostJson(baseUrl, requestPath, payload, optionsOrLegacyCookie
   });
 }
 
+function appendQueryParams(requestPath, queryParams) {
+  if (!queryParams) {
+    return requestPath;
+  }
+
+  const querystring = require('querystring');
+  const serialized = querystring.stringify(queryParams);
+  if (!serialized) {
+    return requestPath;
+  }
+
+  if (!requestPath.includes('?')) {
+    return `${requestPath}?${serialized}`;
+  }
+  if (requestPath.endsWith('?') || requestPath.endsWith('&')) {
+    return `${requestPath}${serialized}`;
+  }
+  return `${requestPath}&${serialized}`;
+}
+
 /**
  * 发送 HTTP GET 请求
  * @param {string} baseUrl
@@ -1248,7 +1268,6 @@ async function httpPostJson(baseUrl, requestPath, payload, optionsOrLegacyCookie
 async function httpGet(baseUrl, requestPath, queryParams, optionsOrLegacyCookies, maybeOptions) {
   const https = require('https');
   const http = require('http');
-  const querystring = require('querystring');
   const optionsOverride = resolveRequestOptions(optionsOrLegacyCookies, maybeOptions);
   const authHeaders = await resolveRequestAuthHeaders(optionsOverride);
 
@@ -1256,7 +1275,7 @@ async function httpGet(baseUrl, requestPath, queryParams, optionsOrLegacyCookies
     const parsedUrl = new URL(baseUrl);
     const isHttps = parsedUrl.protocol === 'https:';
     const requestModule = isHttps ? https : http;
-    const fullPath = queryParams ? `${requestPath}?${querystring.stringify(queryParams)}` : requestPath;
+    const fullPath = appendQueryParams(requestPath, queryParams);
 
     const options = {
       hostname: parsedUrl.hostname,

package/lib/integration/integration-spec-builder.js

@@ -241,6 +241,22 @@ function resolveNodeRefs(value, context) {
   });
 }
 
+function resolveDesignerSourceRefs(value, context) {
+  if (typeof value !== 'string') {
+    return value;
+  }
+  return value.replace(/#\{([^}/]+)\/\/([^}]+)\}/g, (match, alias, fieldId) => {
+    const nodeId = context.aliasToNodeId.get(alias);
+    if (nodeId) {
+      return `#{${nodeId}//${fieldId}}`;
+    }
+    if (context.nodeIdToAlias && context.nodeIdToAlias.has(alias)) {
+      return match;
+    }
+    throw new Error(`Unknown integration spec node alias: ${alias}`);
+  });
+}
+
 function normalizeToUsers(value, fallback = []) {
   const raw = value === undefined ? fallback : value;
   if (!Array.isArray(raw)) {
@@ -327,7 +343,7 @@ function normalizeAssignments(assignments, context) {
     valueType: assignment.valueType || 'literal',
     value: resolveNodeRefs(assignment.value, context),
     __display: assignment.__display,
-    __source: assignment.__source ? resolveNodeRefs(assignment.__source, context) : undefined,
+    __source: assignment.__source,
   }));
 }
 
@@ -353,6 +369,9 @@ function resolveInitiator(node, context) {
 
 function buildUpdateAssignments(assignments, context) {
   return normalizeAssignments(assignments, context).map((assignment) => {
+    const source = assignment.__source
+      ? resolveDesignerSourceRefs(assignment.__source, context)
+      : undefined;
     const result = {
       column: assignment.column,
       valueType: assignment.valueType,
@@ -362,8 +381,8 @@ function buildUpdateAssignments(assignments, context) {
     if (assignment.__display) {
       result.__display = assignment.__display;
     }
-    if (assignment.__source) {
-      result.__source = assignment.__source;
+    if (source) {
+      result.__source = source;
     }
     return result;
   });

package/lib/report/chart-builder.js

@@ -153,37 +153,6 @@ function buildPieChartSettings() {
   };
 }
 
-function buildScatterChartSettings() {
-  return {
-    container: { height: 248 },
-    style: {
-      pointSize: 4, pointShape: 'circle',
-      colorType: 'SCHEMA_COLOR', chartColorsMode: 'defaultColorsMode',
-      customColor: '#5894FF,#394B76,#F7B900,#E55F24,#80D5F5,#9849B0,#3BC88A,#0E869D,#F4A49E,#80563C',
-    },
-    axisType: 'hz',
-    xAxis: {
-      showXAxis: true, showTitle: false,
-      title: { type: 'i18n', zh_CN: '', en_US: '' },
-      line: true, tickLine: true, grid: false, label: true,
-    },
-    yAxis: {
-      showYAxis: true, showTitle: false,
-      title: { type: 'i18n', zh_CN: '', en_US: '' },
-      line: false, tickLine: false, grid: true, label: true,
-      min: null, max: null, tickCount: 5,
-    },
-    legend: { showLegend: true, legendPosition: 'top-left', flipPage: true },
-    tooltip: { showTooltip: true },
-  };
-}
-
-function buildAreaChartSettings() {
-  const s = buildLineChartSettings();
-  s.style.showArea = true;
-  return s;
-}
-
 function buildFunnelChartSettings() {
   return {
     container: { height: 248 },
@@ -197,20 +166,6 @@ function buildFunnelChartSettings() {
   };
 }
 
-function buildRadarChartSettings() {
-  return {
-    container: { height: 248 },
-    style: {
-      colorType: 'SCHEMA_COLOR', chartColorsMode: 'defaultColorsMode',
-      customColor: '#5894FF,#394B76,#F7B900,#E55F24,#80D5F5,#9849B0,#3BC88A,#0E869D,#F4A49E,#80563C',
-      showArea: true, smooth: false, pointSize: 4, lineWidth: 2,
-    },
-    legend: { showLegend: true, legendPosition: 'top-left', flipPage: true },
-    label: { showLabel: false, fontSize: 12, color: '#000' },
-    tooltip: { showTooltip: true },
-  };
-}
-
 function buildGaugeChartSettings() {
   return {
     container: { height: 248 },
@@ -365,14 +320,6 @@ function buildPivotSettings() {
   };
 }
 
-function buildNumberChartSettings() {
-  return {
-    container: { height: 120 },
-    style: { fontSize: 36, color: '#1a1a1a', unit: '', colorType: 'SCHEMA_COLOR' },
-    tooltip: { showTooltip: false },
-  };
-}
-
 /**
  * 根据图表类型获取 settings
  */
@@ -383,16 +330,12 @@ function getChartSettings(chartType) {
     case 'calendarheatmap': return buildCalendarHeatmapSettings();
     case 'map':       return buildMapSettings();
     case 'pie':       return buildPieChartSettings();
-    case 'scatter':   return buildScatterChartSettings();
-    case 'area':      return buildAreaChartSettings();
     case 'funnel':    return buildFunnelChartSettings();
-    case 'radar':     return buildRadarChartSettings();
     case 'gauge':     return buildGaugeChartSettings();
     case 'combo':     return buildComboChartSettings();
     case 'table':     return buildTableSettings();
     case 'indicator': return buildIndicatorSettings();
     case 'pivot':     return buildPivotSettings();
-    case 'number':    return buildNumberChartSettings();
     default: {
       const error = new Error(`unsupported report chart type: ${String(chartType)}`);
       error.code = 'REPORT_CHART_TYPE_UNSUPPORTED';
@@ -410,9 +353,6 @@ function buildUserConfig(chartType) {
   if (chartType === 'funnel') {
     return { chartType: 'funnel', dataConfig: { xField: [], yField: [] } };
   }
-  if (chartType === 'radar') {
-    return { chartType: 'radar', dataConfig: { xField: [], yField: [], groupField: [] } };
-  }
   if (chartType === 'gauge') {
     return { chartType: 'gauge', dataConfig: { valueField: [], assitValueField: [] } };
   }
@@ -456,10 +396,7 @@ function buildUserConfig(chartType) {
   if (chartType === 'pivot') {
     return { chartType: 'pivot', dataConfig: { columnList: [] } };
   }
-  if (chartType === 'number') {
-    return { chartType: 'number', dataConfig: { valueField: [] } };
-  }
-  // 默认：bar/line/scatter/area
+  // 默认：bar/line/calendarheatmap
   return { chartType: chartType || 'bar', dataConfig: { xField: [], yField: [], groupField: [], annotationField: [] } };
 }
 
@@ -498,8 +435,8 @@ function buildUserConfigWithFields(chartType) {
     }];
   }
 
-  // 柱状图 / 折线图 / 面积图 / 散点图 / 雷达图 / 漏斗图
-  if (['bar', 'line', 'calendarheatmap', 'area', 'scatter', 'radar', 'funnel'].includes(chartType)) {
+  // 柱状图 / 折线图 / 日历热力图 / 漏斗图
+  if (['bar', 'line', 'calendarheatmap', 'funnel'].includes(chartType)) {
     const items = [
       { setterName: 'ColumnFieldSetter', name: 'xField', title: '横轴',
         setterProps: { single: true, showFormatTab: true, showFormulaEditor: true, showFieldInfo: true, showAggregateTab: false, showDrillTab: true, showEditTab: true, showSortTab: true } },
@@ -608,7 +545,7 @@ function buildMockData(chartType) {
       },
     }];
   }
-  if (chartType === 'line' || chartType === 'area') {
+  if (chartType === 'line') {
     return [{
       name: 'chartData',
       data: {
@@ -662,23 +599,6 @@ function buildMockData(chartType) {
       },
     }];
   }
-  if (chartType === 'radar') {
-    return [{
-      name: 'chartData',
-      data: {
-        data: [
-          { xField: '销售', yField: 80 }, { xField: '管理', yField: 65 },
-          { xField: '技术', yField: 90 }, { xField: '客服', yField: 70 },
-          { xField: '研发', yField: 85 },
-        ],
-        meta: [
-          { aliasName: '维度', alias: 'xField', category: 'xField', dataType: 'STRING' },
-          { aliasName: '数值', alias: 'yField', category: 'yField', dataType: 'NUMBER' },
-        ],
-        currentPage: 1, totalCount: 5,
-      },
-    }];
-  }
   if (chartType === 'gauge') {
     return [{
       name: 'chartData',
@@ -1078,16 +998,12 @@ module.exports = {
   buildBarChartSettings,
   buildLineChartSettings,
   buildPieChartSettings,
-  buildScatterChartSettings,
-  buildAreaChartSettings,
   buildFunnelChartSettings,
-  buildRadarChartSettings,
   buildGaugeChartSettings,
   buildTableSettings,
   buildComboChartSettings,
   buildIndicatorSettings,
   buildPivotSettings,
-  buildNumberChartSettings,
   getChartSettings,
   buildUserConfig,
   buildUserConfigWithFields,

package/lib/report/data-model.js

@@ -373,7 +373,7 @@ function buildDataSetModelMap(chart, cubeTenantId) {
     };
   }
 
-  // ── 通用图表（bar/line/pie/funnel/scatter/area）──
+  // ── 通用图表（bar/line/pie/funnel/calendarheatmap）──
   const { model, allFields } = buildDataViewQueryModel(chart, cubeTenantId);
 
   const fieldListObjs = allFields.map((f) => buildDisplayFieldObj(cubeCode, f));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.8.29",
+  "version": "2026.8.30",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",

package/yida-skills/references/yida-api.md

@@ -342,7 +342,7 @@ this.utils.yida.getFormDataById({
 | createTo | String | 否 | 创建时间范围结束，格式 yyyy-MM-dd | `'2024-02-01'` |
 | modifiedFrom | String | 否 | 修改时间范围起始，格式 yyyy-MM-dd | `'2024-01-01'` |
 | modifiedTo | String | 否 | 修改时间范围结束，格式 yyyy-MM-dd | `'2024-02-01'` |
-| dynamicOrder | String | 否 | 指定排序字段 | `'{"numberField_1ac":"+"}'` |
+| dynamicOrder | String | 否 | 指定排序字段；`+` 升序，`-` 降序。不传时返回顺序无稳定性保证 | `'{"numberField_1ac":"+"}'` |
 
 **searchFieldJson 示例**：
 
@@ -398,6 +398,8 @@ this.utils.yida.getFormDataById({
 > - **页面内部调用**（即在宜搭自定义页面的 JS 代码中调用 `this.utils.yida.searchFormDatas`）：**不需要传 `appType`**，SDK 会自动从当前页面上下文中获取。
 > - **外部 HTTP 直接调用**（如通过 `openyida data query form` CLI 或服务端脚本）：**必须传 `appType`**，即应用的唯一标识（可在宜搭应用 URL 中找到，格式如 `APP_XXXXXXXX`）。
 
+> 📌 **排序说明**：需要稳定顺序的分页、比对或配对逻辑必须显式传入 `dynamicOrder`。不传时不得依赖接口当前返回顺序；CLI 对应参数为 `--dynamic-order '{"fieldId":"+"}'` 或 `--dynamic-order '{"fieldId":"-"}'`。
+
 **请求示例**：
 
 ```javascript
@@ -411,7 +413,7 @@ this.utils.yida.searchFormDatas({
   createTo: '2024-02-01',
   modifiedFrom: '2024-01-01',
   modifiedTo: '2024-02-01',
-  dynamicOrder: '',
+  dynamicOrder: '{"dateField_xxx":"-"}',
 }).then((res) => {
   // 兼容两种返回结构
   var data = (res && res.data) || (res && res.content && res.content.data) || [];

package/yida-skills/skills/yida-data-management/SKILL.md

@@ -106,7 +106,7 @@ description: 宜搭数据管理。表单实例/子表/流程实例/任务中心
 ### 表单实例
 
 ```bash
-openyida data query form <appType> <formUuid> [--page 1 --size 20] [--search-json '<json>'|--search-file .cache/openyida/<项目名或任务名>/data-import/search.json] [--resolve-aliases]
+openyida data query form <appType> <formUuid> [--page 1 --size 20] [--search-json '<json>'|--search-file .cache/openyida/<项目名或任务名>/data-import/search.json] [--dynamic-order '{"fieldId":"+"}'] [--resolve-aliases]
 openyida data get form <appType> --inst-id <formInstId>
 openyida data create form <appType> <formUuid> --data-json '<json>' [--resolve-aliases]
 openyida data create form <appType> <formUuid> --data-file .cache/openyida/<项目名或任务名>/data-import/record.json [--resolve-aliases]
@@ -258,6 +258,7 @@ openyida data create form APP_xxx FORM-商机表 --data-json '{
 
 - `pageSize` 最大 100，QPS 限制约 40 次/秒
 - `searchFieldJson` 和 `dynamicOrder` 必须传字符串
+- 需要稳定顺序的分页、比对或配对必须显式传 `--dynamic-order '{"fieldId":"+"}'`（升序）或 `--dynamic-order '{"fieldId":"-"}'`（降序）；未传时不得依赖默认返回顺序
 - 字段 ID 通过 `openyida get-schema` 获取，不要手写猜测
 - 批量脚本可以用 Python `subprocess` 调用 `openyida data ...`，也可以用 JS 复用 Node 工具；脚本必须由结构化文件写入工具创建到 `<projectRoot>/.cache/openyida/<项目名或任务名>/scripts/`，导入数据放在 `<projectRoot>/.cache/openyida/<项目名或任务名>/data-import/`
 

package/yida-skills/skills/yida-integration/SKILL.md

@@ -302,6 +302,8 @@ openyida integration create APP_XXX FORM-XXX "获取自身后分支更新" \
 - `fieldId`：字段 ID（可通过 `yida-get-schema` 技能查询）
 - `ComponentType`：字段组件类型（如 `TextField`、`NumberField`、`SelectField` 等）
 
+在结构化 spec 的公式赋值中，`valueType: "column"` 的 `value` 使用 `${alias}.fieldId` 引用上游节点；如果同时提供设计器展示用的 `__source`，使用 `#{alias//fieldId}`。CLI 会把这两种别名引用都替换成真实节点 ID；不要只写 `value` 后假设设计器一定能恢复“值设置”展示。
+
 ## 输出结果
 
 命令执行成功后，向 stdout 输出 JSON：