openyida 2026.9.17 → 2026.9.18

package/lib/core/locales/en.js

@@ -1795,6 +1795,7 @@ Options:
     configuring_process: 'Configuring and publishing process',
     configure_failed: 'Failed to configure process',
     retry_hint: 'Process configuration failed, but the form was created. Fix the process definition and retry with this command:',
+    preserve_existing_form: 'The original form exists. Inspect its state and failure cause using the returned formUuid and preserve it. Do not remove --formUuid, recreate the form, or create a same-name replacement to recover. Never retry writes when noWriteRetry=true.',
     fields_not_found: 'Fields definition file not found',
     process_def_not_found: 'Process definition file not found',
     done: 'Process form creation completed',

package/lib/core/locales/zh.js

@@ -1125,6 +1125,7 @@ openyida - 宜搭命令行工具
     configuring_process: '配置并发布流程',
     configure_failed: '流程配置失败',
     retry_hint: '流程配置失败，但表单已创建。请修复流程定义后，使用以下命令复用该表单重试：',
+    preserve_existing_form: '原表单已存在。先只读核实该 formUuid 的状态和失败原因，保留原表；禁止移除 --formUuid、再次创建表单或另建同名表来恢复。noWriteRetry=true 时禁止写重试。',
     fields_not_found: '字段定义文件不存在',
     process_def_not_found: '流程定义文件不存在',
     done: '流程表单创建完成',

package/lib/process/create-process.js

@@ -76,6 +76,28 @@ function parseArgs(args) {
   };
 }
 
+function quoteCommandArgument(value, shell) {
+  const text = String(value);
+  const safePattern = shell === 'powershell'
+    ? /^[a-zA-Z0-9_./:\\-]+$/
+    : /^[a-zA-Z0-9_./:-]+$/;
+  if (safePattern.test(text)) {
+    return text;
+  }
+  if (shell === 'powershell') {
+    return "'" + text.replace(/'/g, "''") + "'";
+  }
+  return "'" + text.replace(/'/g, "'\"'\"'") + "'";
+}
+
+function buildRetryCommand({ appType, formUuid, processDefinitionFile, replace, platform = process.platform }) {
+  const shell = platform === 'win32' ? 'powershell' : 'posix';
+  return ['openyida', 'create-process', appType, '--formUuid', formUuid,
+    processDefinitionFile, ...(replace ? ['--replace'] : [])]
+    .map(value => quoteCommandArgument(value, shell))
+    .join(' ');
+}
+
 // ── 主流程 ───────────────────────────────────────────
 
 async function run(args) {
@@ -100,9 +122,13 @@ async function run(args) {
     }, extra || {});
   }
 
-  function buildRetryCommand() {
-    return 'openyida create-process ' + appType + ' --formUuid ' + formUuid + ' '
-      + path.basename(processDefinitionFile) + (replace ? ' --replace' : '');
+  function recoveryRetryCommand() {
+    return buildRetryCommand({
+      appType,
+      formUuid,
+      processDefinitionFile,
+      replace,
+    });
   }
 
   function isTerminalSafetyError(error) {
@@ -118,7 +144,16 @@ async function run(args) {
 
   function buildConfigureFailureDetails(configError) {
     const terminalSafetyError = isTerminalSafetyError(configError);
-    const retryCommand = terminalSafetyError ? null : buildRetryCommand();
+    const retryCommand = terminalSafetyError ? null : recoveryRetryCommand();
+    const recovery = {
+      action: 'inspect_existing_form',
+      appType,
+      formUuid,
+      processDefinitionFile,
+      doNotCreateNewForm: true,
+      noWriteRetry: terminalSafetyError,
+      instruction: t('create_process.preserve_existing_form'),
+    };
     const failureContext = { processCode };
     if (retryCommand) {
       failureContext.retryCommand = retryCommand;
@@ -128,6 +163,7 @@ async function run(args) {
       cause: configError,
       nextStep: terminalSafetyError ? terminalSafetyNextStep() : undefined,
     });
+    outerDetails.recovery = recovery;
     const innerDetails = configError && configError.isCliError && configError.details && configError.details.stage
       ? configError.details
       : null;
@@ -303,7 +339,7 @@ async function run(args) {
       // 仅对已知、可安全重试的配置失败提供复用表单命令。
       warn('');
       warn('  💡 ' + t('create_process.retry_hint'));
-      warn('     ' + buildRetryCommand());
+      warn('     ' + recoveryRetryCommand());
       warn('');
     }
     const failureOutput = {
@@ -318,6 +354,8 @@ async function run(args) {
       completedStages: failureDetails.completedStages,
       nextStep: failureDetails.nextStep,
       configureProcess: failureDetails.configureProcess,
+      recovery: failureDetails.recovery,
+      noWriteRetry: terminalSafetyError,
     };
     if (!terminalSafetyError && failureDetails.context && failureDetails.context.retryCommand) {
       failureOutput.retryCommand = failureDetails.context.retryCommand;
@@ -361,4 +399,5 @@ async function run(args) {
 module.exports = {
   run,
   parseArgs,
+  buildRetryCommand,
 };

package/package.json

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

package/yida-skills/skills/yida-create-process/SKILL.md

@@ -35,6 +35,13 @@ description: 流程表单一体化创建（创建表单 → 转流程 → 配置
 - 创建或转换任何远程资源前，CLI 必须先完成字段和流程定义的纯本地编译；本地编译失败时远程写入数必须为 0
 - 复用普通表单时由 `configure-process` 统一执行表单模式只读 preflight、必要转换、发布与平台 view 回读，不要在外层先手动转换表单
 
+## 配置失败后的原表恢复
+
+- `create-process` 返回 `success:false` 且包含 `formUuid` 时，该表单已经存在，失败的是后续配置；新建模式与复用模式均适用。保存返回的 `appType/formUuid`，禁止去掉 `--formUuid`、再次 `create-form` 或另建同名表作为恢复手段。
+- 先按错误中的 `stage`、`nextStep` 和 `recovery` 检查原表状态及权限。修正明确原因后只能复用原 `formUuid`，使用返回的完整 `retryCommand`；不得自动补 `--replace` 绕过已绑定流程的保护。
+- `noWriteRetry:true`、`NON_IDEMPOTENT_RESULT_UNKNOWN` 或 `PUBLISHED_UNVERIFIED` 表示远程结果未确认：只读核实原表/流程，不能执行写重试，也不能新建替代资源。
+- 无法安全恢复时保留原表，并向用户报告原表链接、失败阶段和需处理的问题；不要宣称流程已完成。
+
 ## 适用场景
 
 用户需要"创建审批流程"、"新建流程表单"、"搭建审批系统"，且 resource context 没有既有流程/表单目标时使用。