openxiangda 1.0.109 → 1.0.111

package/lib/cli.js

@@ -132,7 +132,7 @@ Usage:
   openxiangda menu update|sort [--json-file file] [--write-manifest]
   openxiangda menu bind <menuCode> --menu-id <id>
   openxiangda workflow compile <workflow.ts> [--check] [--stdout] [--out-definition file] [--out-preview file]
-  openxiangda workflow list [--profile name] [--form-code code] [--json]
+  openxiangda workflow list [--profile name] [--form-code code] [--json] [--all]
   openxiangda workflow create <workflowCode> --form-code <formCode> --definition-json <file>
   openxiangda workflow bind <workflowCode> --workflow-id <id>
   openxiangda workflow publish <workflowCode|workflowId>
@@ -171,6 +171,7 @@ JS_CODE V2 使用 trusted_node；AI 源码必须写在 src/js-code-nodes/<script
 }
 
 const SUBCOMMAND_BOOLEAN_FLAGS = new Set([
+  '--all',
   '--dry-run',
   '--enabled',
   '--force',
@@ -1377,7 +1378,7 @@ async function workspace(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
   if (wantsSubcommandHelp(subcommand, flags)) {
-    print('用法: openxiangda workspace init|bind|publish [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources]');
+    printWorkspaceHelp();
     return;
   }
   const config = loadConfig();
@@ -1483,7 +1484,25 @@ async function workspace(args) {
       profileName,
       `/openxiangda-api/v1/apps/${encodeURIComponent(bound.appType)}/snapshot`
     );
-    runWorkspacePublish(profileName, profile, bound.appType, publishOptions.workspaceArgs);
+    const reactSpaWorkspace = isReactSpaWorkspace();
+    if (reactSpaWorkspace && !publishOptions.legacyFormBundle) {
+      if (publishOptions.targetForm && !publishOptions.targetPage && !publishOptions.only && !publishOptions.changed) {
+        runReactSpaFormSchemaPublish(profileName, profile, bound.appType, publishOptions);
+      } else {
+        fail(
+          [
+            'React SPA 工作区不使用 workspace publish 发布前端页面。',
+            '如需发布表单 schema，请运行：',
+            `  openxiangda workspace publish --profile ${profileName} --form <formCode>`,
+            '如需发布资源和前端运行时，请运行：',
+            `  openxiangda resource publish --profile ${profileName}`,
+            `  openxiangda runtime deploy --profile ${profileName}`,
+          ].join('\n')
+        );
+      }
+    } else {
+      runWorkspacePublish(profileName, profile, bound.appType, publishOptions.workspaceArgs);
+    }
     if (publishOptions.includeResources) {
       if (publishOptions.dryRun) {
         const manifest = loadWorkspaceResources();
@@ -1509,6 +1528,34 @@ async function workspace(args) {
   fail('用法: openxiangda workspace init|bind|publish [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources]');
 }
 
+function printWorkspaceHelp() {
+  print(`OpenXiangda workspace
+
+Usage:
+  openxiangda workspace init [dir] [--name package-name] [--runtime legacy|react-spa] [--install] [--force]
+  openxiangda workspace init [dir] --profile <name> --app-name <app-name> [--runtime legacy|react-spa] [--description text] [--install] [--force]
+  openxiangda workspace init [dir] --profile <name> --app-type <APP_XXX> [--runtime legacy|react-spa] [--install] [--force]
+  openxiangda workspace bind --profile <name> --app-type <APP_XXX>
+  openxiangda workspace publish --profile <name> [--changed [--since ref]|--form code|--page code|--only list] [--dry-run] [--force] [--resources|--skip-resources] [--prune]
+
+React SPA:
+  openxiangda workspace publish --profile <name> --form <formCode>   # sync form schema only
+  openxiangda resource publish --profile <name>
+  openxiangda runtime deploy --profile <name>
+
+Options:
+  --runtime legacy|react-spa       Workspace template/runtime mode.
+  --app-name <name>                Create and bind a new platform app.
+  --app-type <APP_XXX>             Bind an existing platform app.
+  --form <code>                    Publish one form schema/page.
+  --page <code>                    Publish one classic page.
+  --only pages/a,forms/b           Publish selected classic resources.
+  --changed [--since ref]          Publish changed classic resources.
+  --dry-run                        Show planned work without writing.
+  --resources / --skip-resources   Include or skip src/resources publish.
+  --legacy-form-bundle             Force legacy workspace publish in React SPA workspaces.`);
+}
+
 async function app(args) {
   const [subcommand, ...rest] = args;
   const { flags, positional } = parseArgs(rest);
@@ -1962,7 +2009,7 @@ async function workflow(args) {
   const { subcommand, rest } = parseSubcommandArgs(args);
   const { flags, positional } = parseArgs(rest);
   if (wantsSubcommandHelp(subcommand, flags)) {
-    print('用法: openxiangda workflow compile|list|create|bind|pull|publish|delete|validate [--profile name] [--json]');
+    printWorkflowHelp();
     return;
   }
   const config = loadConfig();
@@ -2023,8 +2070,9 @@ async function workflow(args) {
         }
       )
     );
-    if (flags.json) return writeJson(data);
-    print(JSON.stringify(data, null, 2));
+    const output = flags.all ? data : filterManifestBackedWorkflows(data);
+    if (flags.json) return writeJson(output);
+    print(JSON.stringify(output, null, 2));
     return;
   }
 
@@ -2066,8 +2114,8 @@ async function workflow(args) {
         body: {
           formUuid,
           definitionJson,
-          ...(flags['view-json']
-            ? { viewJson: readJsonArg(flags['view-json'], 'view-json') }
+          ...(flags['preview-json'] || flags['view-json']
+            ? { viewJson: readJsonArg(flags['preview-json'] || flags['view-json'], 'preview-json') }
             : {}),
         },
       }
@@ -2174,6 +2222,49 @@ async function workflow(args) {
   fail('用法: openxiangda workflow compile|list|create|bind|pull|publish|delete|validate');
 }
 
+function printWorkflowHelp() {
+  print(`OpenXiangda workflow
+
+Usage:
+  openxiangda workflow compile <workflow.ts> [--check] [--stdout|--json] [--out-definition file] [--out-preview file]
+  openxiangda workflow list [--profile name] [--form-code code|--form-uuid FORM_XXX] [--published true|false] [--page n] [--page-size n] [--json] [--all]
+  openxiangda workflow create <workflowCode> --form-code <formCode> --definition-json <file> [--preview-json file] [--publish]
+  openxiangda workflow bind <workflowCode> --workflow-id <id> [--form-code code|--form-uuid FORM_XXX]
+  openxiangda workflow pull <workflowCode|workflowId> [--out file] [--json]
+  openxiangda workflow publish <workflowCode|workflowId> [--profile name]
+  openxiangda workflow delete <workflowCode|workflowId> [--yes]
+  openxiangda workflow validate --definition-json <file> [--strict] [--publish]
+
+Notes:
+  - Prefer semantic DSL: src/workflows/<code>/workflow.ts + defineWorkflow().
+  - Run workspace publish --form <formCode> before publishing workflow resources for React SPA process forms.
+  - workflow list hides platform shell workflows with empty resourceCode by default; pass --all to inspect raw platform rows.`);
+}
+
+function filterManifestBackedWorkflows(data) {
+  const shouldKeep = item => item && String(item.resourceCode || '').trim();
+  if (Array.isArray(data)) {
+    return data.filter(shouldKeep);
+  }
+  if (!data || typeof data !== 'object') return data;
+  for (const key of ['data', 'items', 'list', 'records']) {
+    if (Array.isArray(data[key])) {
+      const filtered = data[key].filter(shouldKeep);
+      return {
+        ...data,
+        [key]: filtered,
+        totalCount: Object.prototype.hasOwnProperty.call(data, 'totalCount')
+          ? filtered.length
+          : data.totalCount,
+        total: Object.prototype.hasOwnProperty.call(data, 'total')
+          ? filtered.length
+          : data.total,
+      };
+    }
+  }
+  return data;
+}
+
 async function automation(args) {
   const { subcommand, rest } = parseSubcommandArgs(args);
   const { flags, positional } = parseArgs(rest);
@@ -3649,7 +3740,9 @@ async function resource(args) {
     return;
   }
 
+  const target = getWorkspaceTarget(config, profileName, flags);
   const validation = validateWorkspaceResources(manifest);
+  validateWorkspaceResourceBindings(manifest, target.bound, validation);
   await validateCompiledWorkflowResources(manifest, validation);
   if (subcommand === 'validate') {
     if (flags.json) return writeJson(validation);
@@ -3663,7 +3756,6 @@ async function resource(args) {
     fail(`资源配置校验失败: ${validation.errors[0]}`);
   }
 
-  const target = getWorkspaceTarget(config, profileName, flags);
   const dryRun = subcommand === 'publish' && Boolean(flags['dry-run']);
   if (subcommand === 'plan' || dryRun) {
     const plan = await buildResourcePlan(config, target, manifest);
@@ -5358,6 +5450,34 @@ function validateWorkspaceResources(manifest) {
   };
 }
 
+function validateWorkspaceResourceBindings(manifest, bound, validation) {
+  for (const item of manifest.workflows || []) {
+    if (!item.formCode && !item.form) continue;
+    const formCode = item.formCode || item.form;
+    const formBinding = bound?.resources?.forms?.[formCode];
+    const formUuid = formBinding?.formUuid;
+    if (!formUuid) {
+      validation.errors.push(
+        `${resourceLabel('workflow', item)}: formCode ${formCode} 未绑定。请先运行 openxiangda workspace publish --profile <name> --form ${formCode}`
+      );
+      continue;
+    }
+    const localSchemaPath = path.join(process.cwd(), 'src', 'forms', formCode, 'schema.ts');
+    if (fs.existsSync(localSchemaPath) && !formBinding.schemaSyncedAt) {
+      validation.errors.push(
+        `${resourceLabel('workflow', item)}: formCode ${formCode} 已绑定但本地 schema 尚未同步。请先运行 openxiangda workspace publish --profile <name> --form ${formCode}`
+      );
+    }
+    if (formBinding.formType && formBinding.formType !== 'process') {
+      validation.errors.push(
+        `${resourceLabel('workflow', item)}: formCode ${formCode} 当前 formType=${formBinding.formType}，流程表单需要 process`
+      );
+    }
+  }
+  validation.valid = validation.errors.length === 0;
+  return validation;
+}
+
 async function validateCompiledWorkflowResources(manifest, validation) {
   for (const item of manifest.workflows || []) {
     if (!item.workflowFile) continue;
@@ -9663,6 +9783,7 @@ function normalizeWorkspacePublishOptions(flags) {
   if (since) workspaceArgs.push('--since', since);
   if (dryRun) workspaceArgs.push('--dry-run');
   if (force) workspaceArgs.push('--force');
+  if (flags['legacy-form-bundle']) workspaceArgs.push('--legacy-form-bundle');
 
   const targeted = Boolean(targetForm || targetPage || only || changed);
   const includeResources =
@@ -9671,6 +9792,11 @@ function normalizeWorkspacePublishOptions(flags) {
   return {
     workspaceArgs,
     dryRun,
+    targetForm,
+    targetPage,
+    only,
+    changed,
+    legacyFormBundle: Boolean(flags['legacy-form-bundle']),
     includeResources,
     quietResourceSkip: !targeted || skipResources,
   };
@@ -9708,6 +9834,43 @@ function runWorkspacePublish(profileName, profile, appType, publishArgs = []) {
   }
 }
 
+function isReactSpaWorkspace() {
+  const configFile = path.join(process.cwd(), 'app-workspace.config.ts');
+  if (!fs.existsSync(configFile)) return false;
+  const content = fs.readFileSync(configFile, 'utf8');
+  return /runtimeMode\s*:\s*['"]react-spa['"]/.test(content);
+}
+
+function runReactSpaFormSchemaPublish(profileName, profile, appType, publishOptions) {
+  const packageFile = path.join(process.cwd(), 'package.json');
+  if (!fs.existsSync(packageFile)) {
+    fail('当前目录没有 package.json，无法识别工作区发布脚本');
+  }
+  const pkg = JSON.parse(fs.readFileSync(packageFile, 'utf8'));
+  const scripts = pkg.scripts || {};
+  const usePnpm = fs.existsSync(path.join(process.cwd(), 'pnpm-lock.yaml'));
+  const command = usePnpm ? 'pnpm' : 'npm';
+  const syncArgs = ['--form', publishOptions.targetForm];
+  if (publishOptions.dryRun) syncArgs.push('--dry-run');
+  const args = scripts['sync-schema']
+    ? ['run', 'sync-schema', '--', ...syncArgs]
+    : usePnpm
+      ? ['exec', 'lowcode-workspace', 'sync-schema', ...syncArgs]
+      : ['exec', '--', 'lowcode-workspace', 'sync-schema', ...syncArgs];
+  print(
+    `React SPA 表单 schema 发布${publishOptions.dryRun ? ' (dry-run)' : ''}: ${publishOptions.targetForm}`
+  );
+  const globalEnv = loadGlobalEnv();
+  const result = spawnSync(command, args, {
+    cwd: process.cwd(),
+    stdio: 'inherit',
+    env: buildWorkspacePublishEnv(profileName, profile, appType, globalEnv),
+  });
+  if (result.status !== 0) {
+    process.exit(result.status || 1);
+  }
+}
+
 function buildWorkspacePublishEnv(profileName, profile, appType, globalEnv) {
   const env = { ...process.env };
   const injectedGlobalKeys = [];

package/lib/design-gates.js

@@ -498,6 +498,7 @@ const RESOURCE_EXPLAINS = {
       enable: true,
     },
     commands: [
+      'openxiangda workspace publish --profile <name> --form expense_request',
       'openxiangda workflow compile src/workflows/expense_approval/workflow.ts --check',
       'openxiangda workflow compile src/workflows/expense_approval/workflow.ts --out-definition src/generated/workflows/expense_approval/definition.v3.json --out-preview src/generated/workflows/expense_approval/preview.json',
       'openxiangda resource validate workflow',

package/openxiangda-skills/SKILL.md

@@ -38,7 +38,7 @@ OpenXiangda supports two workspace modes. Classic `sy-lowcode-app-workspace` pub
 
 ### Hard rules — always
 
-- ✅ Publish classic workspaces through `openxiangda workspace publish --profile <name>`; publish React SPA workspaces through `openxiangda resource validate` → `openxiangda resource publish --dry-run` → `openxiangda resource publish` → `openxiangda runtime deploy`.
+- ✅ Publish classic workspaces through `openxiangda workspace publish --profile <name>`; publish React SPA forms first with `openxiangda workspace publish --form <formCode>`, then resources/runtime through `openxiangda resource validate` → `openxiangda resource publish --dry-run` → `openxiangda resource publish` → `openxiangda runtime deploy`.
 - ✅ Architecture-class requests are plan-gated by default. For 新应用、复杂页面、登录注册、公开访问、权限数据范围、流程自动化、连接器/通知、外部集成, first run `openxiangda doctor --json` when a workspace exists and `openxiangda design gates --topic <code> --json`; then ask the user to confirm the design. Before confirmation, only read files, inspect/snapshot, dry-run, ask questions, and write/output design docs. Do not edit source files, write platform resources, send notifications, publish, or deploy.
 - ✅ `runtime deploy` defaults to staged multipart `dist/` uploads plus a final manifest. Use `--upload-mode legacy-json` only for old platform servers.
 - ✅ User token lives in `~/.openxiangda/profiles.json`; project state in `.openxiangda/state.json` (IDs only).
@@ -162,8 +162,8 @@ When the user provides a root domain such as `https://yida.wisejob.cn/`, use it
 - Use JS_CODE for node-local cross-form data queries, create/update/batch update operations, process termination, platform API calls, external HTTP calls, and backend trigger orchestration. For logic that pages, automations, and workflows should reuse through a stable backend entry, prefer App Function. Do not use JS_CODE for simple UI interactions, ordinary form validation, or display-only page behavior.
 - For workflow/automation JS_CODE nodes, prefer V2 `runtimeMode: "trusted_node"`. AI-authored source must be TypeScript under `src/js-code-nodes/<scriptCode>/index.ts`, `src/automations/<resourceCode>/index.ts`, or `src/functions/<functionCode>/index.ts`. `pnpm build-js-code --script <scriptCode>` runs TypeScript validation before bundling, and `sourceFile.localPath` should point to the TS source; the CLI builds, uploads, and replaces it with snapshot metadata during validate/create.
 - Form permission group resources must have stable local codes. Use unique `code` values such as `ticket_reporter_view` and `ticket_repairer_view`; do not rely on the form code when one form has multiple groups.
-- Workflow resources should prefer `workflowFile` + `defineWorkflow` semantic DSL over hand-written raw JSON. Run `openxiangda workflow compile <workflow.ts> --check` and `openxiangda resource publish --dry-run --profile <name>` before publish; use `sdk.process.resolveCapabilities(...)` or `ProcessActionBar` / `ProcessTimeline` from `openxiangda/runtime/react` for runtime buttons and timelines instead of hard-coded operation lists.
-- Workflow resources can be created as drafts. After resource publish, verify `openxiangda workflow list --profile <name> --json` and run `openxiangda workflow publish <workflowCode> --profile <name>` until `isPublished: true` is visible.
+- Workflow resources should prefer `workflowFile` + `defineWorkflow` semantic DSL over hand-written raw JSON. For workflows bound by `formCode`, run `openxiangda workspace publish --form <formCode>` first so the process form schema/table is initialized, then run `openxiangda workflow compile <workflow.ts> --check` and `openxiangda resource publish --dry-run --profile <name>` before publish; use `sdk.process.resolveCapabilities(...)` or `ProcessActionBar` / `ProcessTimeline` from `openxiangda/runtime/react` for runtime buttons and timelines instead of hard-coded operation lists.
+- Workflow resources can be created as drafts. After resource publish, verify `openxiangda workflow list --profile <name> --json` and run `openxiangda workflow publish <workflowCode> --profile <name>` until `isPublished: true` is visible. `workflow list` hides platform shell workflows with empty `resourceCode` by default; pass `--all` only when diagnosing raw platform rows.
 
 ## Subskills
 

package/openxiangda-skills/skills/openxiangda-core/SKILL.md

@@ -37,6 +37,7 @@ openxiangda workspace publish --profile <name>
 For Phase 6 React SPA workspaces (`workspace init --runtime react-spa`), do not use `workspace publish` for frontend routes. Publish in two explicit steps:
 
 ```bash
+openxiangda workspace publish --profile <name> --form <formCode> # required for forms/workflows
 openxiangda resource validate --profile <name>
 openxiangda resource plan --profile <name>
 openxiangda resource publish --profile <name> --dry-run

package/openxiangda-skills/skills/openxiangda-workflow-automation/SKILL.md

@@ -93,7 +93,7 @@ openxiangda form bind customer --form-uuid FORM_XXX --profile dev
    openxiangda workflow list --profile dev --json
    ```
 
-Use `workflow pull` to inspect the live definition. Use `workflow list --json` after publishing and confirm the target shows `isPublished: true`; resource publish can create/update a draft without activating it. Use logical workflow codes locally; never copy a workflow ID from one profile to another.
+Use `workflow pull` to inspect the live definition. Use `workflow list --json` after publishing and confirm the target shows `isPublished: true`; resource publish can create/update a draft without activating it. `workflow list` hides platform shell workflows with empty `resourceCode` by default; use `--all` only for raw platform diagnostics. Use logical workflow codes locally; never copy a workflow ID from one profile to another.
 
 ## JS_CODE V2
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.109",
+  "version": "1.0.111",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/packages/sdk/src/build-source/scripts/sync-schema.mjs

@@ -22,6 +22,7 @@ import {
   ensureSchemaFormUuid,
   getOpenApiAccessToken,
   isOpenXiangdaMode,
+  markWorkspaceFormSchemaSynced,
 } from "./utils/form-api.mjs";
 import {
   assertSchemaSyncResult,
@@ -305,6 +306,12 @@ async function main() {
     } else {
       try {
         const response = await sendToApi(apiPayload, config, accessToken);
+        markWorkspaceFormSchemaSynced(config, form.name, apiPayload.formUuid, {
+          title: schema.formMeta?.title || form.name,
+          formType: apiPayload.formType || schema.formMeta?.formType || "receipt",
+          fieldCount: apiPayload.fieldCount,
+          tableName: response?.data?.tableName,
+        });
         console.log(`  ✅ 同步成功，tableName=${response.data.tableName}`);
         results.push({ name: form.name, success: true, response });
       } catch (error) {

package/packages/sdk/src/build-source/scripts/utils/form-api.mjs

@@ -116,6 +116,13 @@ function saveWorkspaceFormBinding(config, formName, formUuid, extra = {}) {
   return true;
 }
 
+export function markWorkspaceFormSchemaSynced(config, formName, formUuid, extra = {}) {
+  return saveWorkspaceFormBinding(config, formName, formUuid, {
+    ...extra,
+    schemaSyncedAt: new Date().toISOString(),
+  });
+}
+
 function readExportedStringConstant(filePath, exportName) {
   if (!filePath || !fs.existsSync(filePath)) return "";
   const content = fs.readFileSync(filePath, "utf-8");

package/templates/openxiangda-react-spa/AGENTS.md

@@ -33,7 +33,7 @@ openxiangda runtime deploy --profile <name>
 openxiangda commands --json
 ```
 
-`pnpm deploy -- --profile <name>` 会按顺序执行 `openxiangda resource publish --profile <name>` 与 `openxiangda runtime deploy --profile <name>`。不要直接运行 `pnpm publish:all`、`pnpm openxiangda:publish` 或 `lowcode-workspace publish-all`；这些是 legacy classic workspace 的内部发布入口，会被 `scripts/guard-publish.mjs` 拦截。
+`pnpm deploy -- --profile <name>` 会按顺序执行 `openxiangda resource publish --profile <name>` 与 `openxiangda runtime deploy --profile <name>`。如果应用包含 `src/forms/<formCode>/schema.ts`，先执行 `openxiangda workspace publish --profile <name> --form <formCode>` 初始化表单 schema/table。不要直接运行 `pnpm publish:all`、`pnpm openxiangda:publish` 或 `lowcode-workspace publish-all`；这些是 legacy classic workspace 的内部发布入口，会被 `scripts/guard-publish.mjs` 拦截。
 
 完整发布顺序：
 

package/templates/openxiangda-react-spa/scripts/guard-publish.mjs

@@ -4,7 +4,8 @@ const lines = [
   '',
   '错误：React SPA 工作区不要直接调用 lowcode-workspace publish-all。',
   '',
-  'React SPA 的发布入口分两步，且必须显式指定 profile：',
+  'React SPA 的发布入口必须显式指定 profile：',
+  '  openxiangda workspace publish --profile <name> --form <formCode>  # 仅同步表单 schema',
   '  openxiangda resource publish --profile <name>',
   '  openxiangda runtime deploy --profile <name>',
   '',