openyida 2026.7.12-1 → 2026.7.13

package/README.md

@@ -343,8 +343,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida logout` | Logout / switch account |
 | `openyida auth <status\|login\|refresh\|logout>` | Login state management |
 | `openyida org <list\|switch>` | Organization management (list / switch) |
-| `openyida env [--json]` | Detect AI tool environment & login state |
-| `openyida env <setup\|list\|show\|switch\|add\|remove>` | Manage public/private Yida environment profiles |
+| `openyida env [--json\|setup\|list\|show\|switch\|add\|remove] [options]` | Detect AI tool environment & login state |
 
 ### App Management
 
@@ -374,7 +373,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida create-form add-option <appType> <formUuid> <fieldLabel> <option1> [option2] ...` | Update a form page |
 | `openyida list-forms <appType> [--keyword <text>]` | List forms/pages in an app |
 | `openyida aggregate-table <list\|create-empty\|inspect\|preview\|save\|publish\|status> <appType> ...` | Manage aggregate tables (virtualView) |
-| `openyida get-schema <appType> <formUuid\|--all>` | Get one form Schema or all form Schemas |
+| `openyida get-schema <appType> <formUuid\|--all> [--summary-json\|--field-map-json]` | Get one form Schema or all form Schemas |
 | `openyida er <appType> [--format mermaid\|json] [--output file] [--include-system] [--include-pages]` | Export app entity relationship diagram |
 | `openyida create-page <appType> "<name>" [--mode dashboard] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a custom display page |
 | `openyida generate-page <template>` | Generate page from curated template |
@@ -469,8 +468,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida update` | Check and update to latest version |
 | `openyida export-conversation [options]` | Export AI conversation records |
 | `openyida feedback <setup\|url\|dismiss\|status> [options]` | Configure experience feedback form and local reminder state |
-| `openyida batch <file> [--stop-on-error] [--json]` | Run OpenYida commands in batch |
-| `openyida batch --commands "cmd1 ; cmd2" [--stop-on-error] [--json]` | Run OpenYida commands in batch |
+| `openyida batch <file>\|--commands "cmd1 ; cmd2" [--stop-on-error] [--json]` | Run OpenYida commands in batch |
 | `openyida flash-to-prd --file <path> --name "<project>"` | Convert flash notes or meeting notes to a PRD prompt |
 | `openyida ai <text\|image> [options]` | Call Yida AI text and image recognition APIs |
 | `openyida cdn-config [options]` | Configure CDN / OSS upload |

package/lib/app/get-schema.js

@@ -2,8 +2,8 @@
  * get-schema.js - 宜搭表单 Schema 获取命令
  *
  * 用法：
- *   openyida get-schema <appType> <formUuid>
- *   openyida get-schema <appType> --all [--output-dir <dir>] [--concurrency N] [--retries N]
+ *   openyida get-schema <appType> <formUuid> [--summary-json|--field-map-json]
+ *   openyida get-schema <appType> --all [--summary-json] [--output-dir <dir>] [--concurrency N] [--retries N]
  */
 
 'use strict';
@@ -31,7 +31,7 @@ const FIELD_TYPES_NEEDING_VALUE_SUFFIX = new Set([
 /**
  * 从 Schema 中提取字段摘要，列出每个字段的真实 fieldId、组件别名和报表用 reportFieldCode。
  * @param {object} schemaResult - getFormSchema API 返回结果
- * @returns {Array<{label, componentName, fieldId, alias, reportFieldCode}>}
+ * @returns {Array<{label, componentName, fieldId, alias, reportFieldCode, options}>}
  */
 function extractFieldSummary(schemaResult) {
   const fields = [];
@@ -62,12 +62,17 @@ function extractFieldSummary(schemaResult) {
         ? `${fieldId}_value`
         : fieldId;
       if (fieldId) {
+        const options = extractOptionSummary(props);
+        const optionSource = getOptionSource(props) || [];
         fields.push({
           label,
           componentName: node.componentName,
           fieldId,
           alias: aliasMaps.aliasByFieldId[fieldId] || '',
           reportFieldCode,
+          options,
+          optionCount: optionSource.length,
+          optionsTruncated: optionSource.length > options.length,
         });
       }
     }
@@ -87,6 +92,70 @@ function extractFieldSummary(schemaResult) {
   return fields;
 }
 
+function normalizeOptionLabel(value) {
+  if (value === null || value === undefined) {
+    return '';
+  }
+  if (typeof value === 'object') {
+    return value.zh_CN || value.zh_HK || value.en_US || value.ja_JP || value.text || value.label || value.value || '';
+  }
+  return String(value);
+}
+
+function firstPresent(values) {
+  return values.find(value => value !== undefined && value !== null);
+}
+
+function normalizeOptionValue(value, fallback) {
+  if (value === null || value === undefined || value === '') {
+    return fallback;
+  }
+  if (typeof value === 'object') {
+    return value.value || value.label || value.text || fallback;
+  }
+  return String(value);
+}
+
+function optionArrayFromDataSource(dataSource) {
+  if (!dataSource) {
+    return null;
+  }
+  if (Array.isArray(dataSource)) {
+    return dataSource;
+  }
+  const candidates = [
+    dataSource.options,
+    dataSource.data,
+    dataSource.list,
+    dataSource.values,
+  ];
+  return candidates.find(Array.isArray) || null;
+}
+
+function getOptionSource(props = {}) {
+  return Array.isArray(props.options)
+    ? props.options
+    : optionArrayFromDataSource(props.dataSource);
+}
+
+function extractOptionSummary(props = {}) {
+  const source = getOptionSource(props);
+  if (!source) {
+    return [];
+  }
+  return source.slice(0, 50).map((item, index) => {
+    if (typeof item === 'string' || typeof item === 'number' || typeof item === 'boolean') {
+      const text = String(item);
+      return { label: text, value: text };
+    }
+    const label = normalizeOptionLabel(firstPresent([item.label, item.text, item.name, item.title, item.value]));
+    return {
+      label,
+      value: normalizeOptionValue(firstPresent([item.value, item.key, item.id]), label || String(index)),
+    };
+  });
+}
+
 function buildComponentAliasMaps(schemaResult) {
   const aliasByFieldId = {};
   const fieldIdByAlias = {};
@@ -136,6 +205,7 @@ function parseArgs(args) {
     // 仅返回目标字段的 {componentName, fieldId, label, props}
     field: '',
     json: false,
+    summaryJson: false,
   };
 
   for (let index = 1; index < args.length; index++) {
@@ -159,6 +229,8 @@ function parseArgs(args) {
       index++;
     } else if (arg === '--json') {
       parsed.json = true;
+    } else if (arg === '--summary-json' || arg === '--field-map-json') {
+      parsed.summaryJson = true;
     } else if (!arg.startsWith('--') && !parsed.formUuid) {
       parsed.formUuid = arg;
     }
@@ -303,6 +375,18 @@ function printFieldSummary(result) {
   process.stderr.write(`  ${c.dim}注：SelectField/EmployeeField 在报表中需加 _value 后缀${c.reset}\n\n`);
 }
 
+function buildSchemaSummary(appType, formUuid, schemaResult, meta = {}) {
+  const fields = extractFieldSummary(schemaResult);
+  return {
+    success: true,
+    appType,
+    formUuid,
+    ...meta,
+    fieldCount: fields.length,
+    fields,
+  };
+}
+
 function filterForms(forms, keyword) {
   if (!keyword) {
     return forms;
@@ -373,9 +457,19 @@ async function fetchSchemaRecord(appType, form, authRef, retries) {
   };
 }
 
-function writeBatchOutput(outputDir, records) {
+function summarizeRecord(record) {
+  if (!record.success) {
+    return record;
+  }
+  const { schema, ...summary } = record;
+  void schema;
+  return summary;
+}
+
+function writeBatchOutput(outputDir, records, options = {}) {
+  const compact = !!options.compact;
   if (!outputDir) {
-    return records;
+    return compact ? records.map(summarizeRecord) : records;
   }
 
   const resolvedDir = path.resolve(outputDir);
@@ -391,10 +485,8 @@ function writeBatchOutput(outputDir, records) {
     const filePath = path.join(resolvedDir, fileName);
     fs.writeFileSync(filePath, JSON.stringify(record.schema, null, 2), 'utf-8');
 
-    const { schema, ...summary } = record;
-    void schema;
     return {
-      ...summary,
+      ...summarizeRecord(record),
       schemaFile: filePath,
     };
   });
@@ -452,6 +544,11 @@ async function runSingle(parsed, authRef) {
     return;
   }
 
+  if (parsed.summaryJson) {
+    console.log(JSON.stringify(buildSchemaSummary(parsed.appType, parsed.formUuid, result), null, 2));
+    return;
+  }
+
   chalkSuccess(t('get_schema.success'));
   printFieldSummary(result);
   console.log(JSON.stringify(result, null, 2));
@@ -494,7 +591,7 @@ async function runBatch(parsed, authRef) {
     return record;
   });
 
-  const outputRecords = writeBatchOutput(parsed.outputDir, records);
+  const outputRecords = writeBatchOutput(parsed.outputDir, records, { compact: parsed.summaryJson });
   const successCount = records.filter(record => record.success).length;
   const failedCount = records.length - successCount;
 
@@ -509,6 +606,7 @@ async function runBatch(parsed, authRef) {
     total: records.length,
     successCount,
     failedCount,
+    summaryOnly: parsed.summaryJson || undefined,
     outputDir: parsed.outputDir ? path.resolve(parsed.outputDir) : undefined,
     forms: outputRecords,
   }, null, 2));
@@ -527,6 +625,8 @@ async function run(args) {
 
 module.exports = {
   extractFieldSummary,
+  extractOptionSummary,
+  buildSchemaSummary,
   buildComponentAliasMaps,
   parseArgs,
   filterForms,

package/lib/core/agent-capabilities.js

@@ -48,8 +48,12 @@ function buildAgentCapabilities() {
       count: manifest.summary.command_count,
       group_count: manifest.summary.group_count,
       side_effect_counts: manifest.summary.side_effect_counts,
+      permission_mode_counts: manifest.summary.permission_mode_counts,
       read_only_command_ids: manifest.summary.read_only_command_ids,
       mutating_command_ids: manifest.summary.mutating_command_ids,
+      allow_command_ids: manifest.summary.allow_command_ids,
+      ask_command_ids: manifest.summary.ask_command_ids,
+      deny_command_ids: manifest.summary.deny_command_ids,
       core_workflows: manifest.summary.core_workflows,
     },
     sideEffects: {
@@ -63,11 +67,13 @@ function buildAgentCapabilities() {
       completion_contracts: {
         full_app: 'Default fast_build is complete after creating the app, core forms, primary page, publishing it, and returning an access URL.',
       },
+      fast_build_data_contract: 'Default fast_build page code must not call this.dataSourceMap.* unless the same run created and bound a designer data source; use this.utils.yida.* or an entry-only page by default.',
     },
     command_manifest: {
       schema_version: manifest.schema_version,
       groups: manifest.groups,
       side_effect_schema: manifest.side_effect_schema,
+      permission_schema: manifest.permission_schema,
       summary: manifest.summary,
       commands: manifest.commands,
     },