openxiangda 2.70.0 → 2.70.2

package/documentation/reference/mcp.md

@@ -288,6 +288,327 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 {
   "type": "object",
   "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "operation": {
+          "const": "workflows.legacy-prepare",
+          "description": "准备旧审批当前节点接续，冻结原申请人、轮次、历史和Native业务单"
+        },
+        "environment": {
+          "type": "string",
+          "enum": [
+            "test",
+            "production"
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "schemaVersion": {
+              "const": "openxiangda.workflow-legacy-adoption-prepare/v2"
+            },
+            "requestKey": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128
+            },
+            "reason": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1000
+            },
+            "expectedHeadRevision": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "workflowCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+            },
+            "resourceCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+            },
+            "recordId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 36,
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+            },
+            "expectedRevision": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "source": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "system": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                },
+                "recordKey": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 255
+                },
+                "snapshotSha256": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 64,
+                  "pattern": "^[0-9a-f]{64}$"
+                },
+                "recordSha256": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 64,
+                  "pattern": "^[0-9a-f]{64}$"
+                }
+              },
+              "required": [
+                "system",
+                "recordKey",
+                "snapshotSha256",
+                "recordSha256"
+              ]
+            },
+            "checkpoint": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "initiatorUserId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 36,
+                  "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+                },
+                "approvalRound": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 2147483647
+                },
+                "currentNodeId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128,
+                  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                },
+                "initiatorField": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 63,
+                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                },
+                "initiatorIdentityField": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 63,
+                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                },
+                "roundField": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 63,
+                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                },
+                "stateField": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 63,
+                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                },
+                "stateValue": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 255
+                },
+                "history": {
+                  "type": "array",
+                  "maxItems": 64,
+                  "items": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "nodeId": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 128,
+                        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                      },
+                      "reviewerDisplay": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 255
+                      },
+                      "reviewedAt": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 64
+                      },
+                      "opinion": {
+                        "type": "string",
+                        "maxLength": 8192
+                      },
+                      "reviewerField": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 63,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                      },
+                      "reviewedAtField": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 63,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                      },
+                      "opinionField": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 63,
+                        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,62}$"
+                      }
+                    },
+                    "required": [
+                      "nodeId",
+                      "reviewerDisplay",
+                      "reviewedAt",
+                      "opinion",
+                      "reviewerField",
+                      "reviewedAtField",
+                      "opinionField"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "initiatorUserId",
+                "approvalRound",
+                "currentNodeId",
+                "initiatorField",
+                "initiatorIdentityField",
+                "roundField",
+                "stateField",
+                "stateValue",
+                "history"
+              ]
+            }
+          },
+          "required": [
+            "schemaVersion",
+            "requestKey",
+            "reason",
+            "expectedHeadRevision",
+            "workflowCode",
+            "resourceCode",
+            "recordId",
+            "expectedRevision",
+            "source",
+            "checkpoint"
+          ]
+        }
+      },
+      "required": [
+        "operation",
+        "environment",
+        "input"
+      ]
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "operation": {
+          "const": "workflows.legacy-apply",
+          "description": "按原计划摘要原子接续当前节点，仅创建当前待办"
+        },
+        "environment": {
+          "type": "string",
+          "enum": [
+            "test",
+            "production"
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "schemaVersion": {
+              "const": "openxiangda.workflow-legacy-adoption-apply/v2"
+            },
+            "planId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 36,
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+            },
+            "expectedPlanDigest": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64,
+              "pattern": "^[0-9a-f]{64}$"
+            }
+          },
+          "required": [
+            "schemaVersion",
+            "planId",
+            "expectedPlanDigest"
+          ]
+        }
+      },
+      "required": [
+        "operation",
+        "environment",
+        "input"
+      ]
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "operation": {
+          "const": "workflows.legacy-receipt",
+          "description": "读取旧审批接续准备或执行回执"
+        },
+        "environment": {
+          "type": "string",
+          "enum": [
+            "test",
+            "production"
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "planId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 36,
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+            }
+          },
+          "required": [
+            "planId"
+          ]
+        }
+      },
+      "required": [
+        "operation",
+        "environment",
+        "input"
+      ]
+    },
     {
       "type": "object",
       "additionalProperties": false,

package/documentation/workflow-events.md

@@ -1261,3 +1261,24 @@ pnpm openxiangda workflow sync request-review --from production --to test \
 新节点尚未填完标准成员/角色时可以保存草稿；正式发布与办理覆盖仍完整校验。服务端重新读取实际上下文，不信任浏览器自报目录或已校验标志。AI提案同样经过原binding/canvas门禁；不能把草稿可保存解释为可发布。
 
 冲突、失权或结果未知时保留整个assignment及原operationId，不自动合并分支、不静默丢失条件。已进入流程的任务仍使用原冻结快照，新的规则不回写历史任务。源码同步、配置与发布分别核对原Head/版本和操作回执。
+
+
+### 应用事务拥有的业务待办
+
+预约分配、结算确认等非 Workflow 的业务任务，可由同一 Native 事务写入业务状态并
+发送不可变自定义事件。订阅显式声明
+`platformAccess.notification: { mode: 'business-task', taskCodes: ['booking-review'] }`，
+验证签名的 Nest 事件消费者使用 `OpenXiangdaBusinessNotificationService.sendTaskFromEvent`。
+平台协商 `notification-hub-v2.event-tasks` 能力并检查当前运行 Head 和封存的任务代码清单。
+
+输入使用 `openxiangda.notification.event-task-send/v2`，通过 taskCodePath、recordKeyPath、
+generationPath、sequencePath、statePath、recipientPaths、titlePath 和可选 summaryPath
+投影原事件，状态只能是 action_required/completed/rejected/cancelled。不接收调用者
+自拟收件人或消息键。navigationTarget 使用同应用 AUTHENTICATED APP_ROUTE，原页面
+重新验证办理权限；不生成 Workflow 回调或审批令牌。
+
+同一业务键和轮次只产生一个待办；重新申请必须创建新的 generation。终态先到、
+乱序和重试不会重新打开旧待办。应用应冻结原任务收件人，在原业务事务中关闭旧轮次
+并创建下一轮，不因管理员变化覆盖旧任务。此能力复用平台任务中心、通知发件箱、
+供应方关闭和审计；普通 informational 通知仍不能创建待办。业务提交成功不等于
+供应方投递或用户收到，分别核对业务回执、事件投递和消息详情。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.70.0",
+  "version": "2.70.2",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -95,13 +95,13 @@
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
     "elkjs": "0.12.0",
-    "openxiangda-cli": "2.11.4",
-    "openxiangda-contracts": "2.90.0",
-    "openxiangda-devkit-core": "2.68.0",
+    "openxiangda-cli": "2.11.6",
+    "openxiangda-contracts": "2.91.1",
+    "openxiangda-devkit-core": "2.69.1",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.2.17",
-    "openxiangda-nest": "2.20.2",
-    "openxiangda-skill-kit": "2.3.119",
+    "openxiangda-mcp": "2.2.19",
+    "openxiangda-nest": "2.21.1",
+    "openxiangda-skill-kit": "2.3.121",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -167,38 +167,35 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.70.0",
+    "version": "2.70.2",
     "status": "reviewed",
-    "title": "组织角色与业务记录归属边界",
-    "summary": "应用可声明平台目录角色映射、self/subtree 组织范围及 Native 记录组织归属，由配套平台统一执行身份与数据授权。",
-    "newFeatures": [
-      "角色显式声明 organizationReach；directoryRoleSources 将可信平台目录事实映射为当前组织内的应用角色和班级等字符串范围。",
-      "Native 资源声明 none、owned 或 inherited-down 组织策略；组织归属元数据可用于有界读取和统计，业务输入不能更改归属。",
-      "编译器共同校验组织角色、来源范围和资源策略，自动协商 authz.organizations、authz.directory-roles 与 data.organizations 能力。"
-    ],
+    "title": "首部节点插入与补正回放修复",
+    "summary": "首部插入人工、条件、业务或并行节点时，原子更新流程入口和补正重提交入口，保留新首审批与严格校验。",
+    "newFeatures": [],
     "fixes": [
-      "隔离 CLI 候选构建保留固定 Corepack 缓存，嵌套源码构建并发上限为两个任务；保留真实依赖安装和端到端检查。"
+      "首部插入同步补正回放目标，多补正和连续插入删除保留完整路径。",
+      "补正可达性遍历并行和汇合后继，保留禁止正向进入补正与退回源必须可达的规则。"
     ],
     "affectedUsers": [
-      "使用多组织、教育局与独立学校或平台家校目录的 OpenXiangda V2 应用；已有未声明组织策略的应用保持原授权语义。"
+      "使用流程画布首部插入、补正重提交或并行结构的V2应用。"
     ],
     "upgradeSteps": [
-      "安装精确 openxiangda 2.70.0 官方组合并刷新项目资料，检查生成契约及能力要求。",
-      "平台配套正式 contracts、组织角色投影服务与新增 SQL 后再启用组织资源；在目标站点验证真实来源、活动成员、安装及角色正反路径。"
+      "安装同源完整七包并配套后端共享校验器，核对纯校验器摘要。",
+      "从合同现场2.69.1升级继承组织授权、业务待办与旧审批接续合同；两份正式SQL须通过完整门禁和目标预检。完整配套已获授权。",
+      "应用更新前通过官方源码导出和注册保护保留现场流程第13版；不以旧源码覆盖或重放未保存草稿。"
     ],
     "knownLimitations": [
-      "npm 包发布不代表平台部署、真实组织同步或业务验收；源码和独立 PostgreSQL 测试不能代替现场登录与权限验证。",
-      "普通后台或应用凭据不自动取得组织权限；未声明明确系统动作边界的后台任务不能访问组织资源。",
-      "已有无组织记录不自动推断或回填归属，启用组织策略后不能降级移除边界。"
+      "鼠标消失未复现，本地拖动及失焦恢复正常不代表现场问题已修复。",
+      "包发行不代表部署或真实角色验收；安装接续能力不授权调用旧审批接续、重放通知或晋级生产。"
     ],
     "compatibility": {
       "node": "Node.js 24 or newer for maintained toolchain",
       "generation": "OpenXiangda V2; V1 unchanged",
-      "platform": "须部署同源 contracts 及组织授权 SQL/后端；组织来源角色限定 self，subtree 授权由合法应用管理员显式管理"
+      "platform": "同源contracts纯校验器；从171017升级包含AddNativeOrganizationAuthorizationV2和AddWorkflowLegacyAdoptionsV2 SQL，目标预检不可省略。"
     },
     "issues": [],
-    "sha256": "7291b56c3a9c02615075ea5bb9bcf22669b3d19540f5f95173f54589d31a24f8",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.70.0"
+    "sha256": "d4cd6182b5f50770489b6615a5207dc0590e6a88f1d3fb635a8cf0defc0e8dd8",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.70.2"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.68.1.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.68.1",
+  "status": "reviewed",
+  "title": "原部署运行的流程例外只读预览",
+  "summary": "按平台能力读取失败 DeploymentRun 的冻结候选、当前 Head 和真实流程例外，支持在独立诊断目录使用公开 SDK 读取旧工作区会话。",
+  "newFeatures": [
+    "`status <deployment-id> --workflow-exceptions` 只读展示原运行的例外及完整集合摘要，不确认或重试。",
+    "独立精确版本 devkit 客户端可读取旧工作区 link/session，无需更改应用 package、lock 或冻结包。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "发布包含工作流的 V2 应用的开发者和管理员。"
+  ],
+  "upgradeSteps": [
+    "平台需先提供 deployment.workflow-adoption-preview 1.0.0 能力；无能力时明确停止。",
+    "使用本版根包或独立 openxiangda-devkit-core 2.67.0 诊断目录；旧应用不必为了查看例外升级依赖。",
+    "保留原 DeploymentRun ID，先核对完整例外；生产仍只晋级已验收 TEST 原版本。"
+  ],
+  "knownLimitations": [
+    "本批仅提供预览，不提供例外确认、事实转换或原 Run 恢复通道。",
+    "truncated=true 不代表已观察完整明细；预览不授予激活许可。",
+    "包发行不等于平台部署或真实业务验收；source/status 的独立500故障不在此修复中。"
+  ],
+  "compatibility": {
+    "node": "Node.js 24 or newer for maintained toolchain",
+    "generation": "OpenXiangda V2; no V1 migration",
+    "platform": "New read-only preview requires deployment.workflow-adoption-preview 1.0.0; contracts remains 2.88.0"
+  },
+  "issues": [],
+  "sha256": "859687bd04474e031528a651304916e7535919419aa697ec1892ff5b17cdf666",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.68.1"
+}

package/releases/2.69.1.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.69.1",
+  "status": "reviewed",
+  "title": "流程画布按需面板与连续分支保存修复",
+  "summary": "修复流程设计器的常驻面板、连续条件路由断线及带可读名称的草稿无法保存。",
+  "newFeatures": [],
+  "fixes": [
+    "流程大纲默认隐藏，节点设置默认关闭；选择节点后按需打开配置，浮层不挤压编辑画布。",
+    "相邻条件区域只拥有各自分支，汇合目标保持单一位置；连续条件和嵌套并行的连线接回实际目标节点。",
+    "正式流程文档schema接受已有readability元数据，保留闭集字段、长度与数量上限及原业务权限校验。"
+  ],
+  "affectedUsers": [
+    "使用V2流程设计器编辑或维护审批流程的应用。"
+  ],
+  "upgradeSteps": [
+    "安装精确openxiangda 2.69.1官方组合并重新检查、构建应用。",
+    "平台后端同步正式contracts包及同源回执后，才具备草稿保存schema修复；应用自行维护流程列表和独立画布路由。"
+  ],
+  "knownLimitations": [
+    "不修改历史实例、审批边界或业务拓扑；此版本不包含原DeploymentRun例外ack接口。",
+    "包发行不等于平台部署或现场草稿保存验收，已有未保存输入需保留。"
+  ],
+  "compatibility": {
+    "node": "Node.js 24 or newer for maintained toolchain",
+    "generation": "OpenXiangda V2; V1 unchanged",
+    "platform": "平台后端须消费本轮正式contracts及配套组合；原权限、revision和operationId守卫保持"
+  },
+  "issues": [],
+  "sha256": "529eee3d6d426c149635e6143310ff6a4a01da6c7243e203ff959f9d3b34a4b5",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.69.1"
+}

package/releases/2.70.2.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.70.2",
+  "status": "reviewed",
+  "title": "首部节点插入与补正回放修复",
+  "summary": "首部插入人工、条件、业务或并行节点时，原子更新流程入口和补正重提交入口，保留新首审批与严格校验。",
+  "newFeatures": [],
+  "fixes": [
+    "首部插入同步补正回放目标，多补正和连续插入删除保留完整路径。",
+    "补正可达性遍历并行和汇合后继，保留禁止正向进入补正与退回源必须可达的规则。"
+  ],
+  "affectedUsers": [
+    "使用流程画布首部插入、补正重提交或并行结构的V2应用。"
+  ],
+  "upgradeSteps": [
+    "安装同源完整七包并配套后端共享校验器，核对纯校验器摘要。",
+    "从合同现场2.69.1升级继承组织授权、业务待办与旧审批接续合同；两份正式SQL须通过完整门禁和目标预检。完整配套已获授权。",
+    "应用更新前通过官方源码导出和注册保护保留现场流程第13版；不以旧源码覆盖或重放未保存草稿。"
+  ],
+  "knownLimitations": [
+    "鼠标消失未复现，本地拖动及失焦恢复正常不代表现场问题已修复。",
+    "包发行不代表部署或真实角色验收；安装接续能力不授权调用旧审批接续、重放通知或晋级生产。"
+  ],
+  "compatibility": {
+    "node": "Node.js 24 or newer for maintained toolchain",
+    "generation": "OpenXiangda V2; V1 unchanged",
+    "platform": "同源contracts纯校验器；从171017升级包含AddNativeOrganizationAuthorizationV2和AddWorkflowLegacyAdoptionsV2 SQL，目标预检不可省略。"
+  },
+  "issues": [],
+  "sha256": "d4cd6182b5f50770489b6615a5207dc0590e6a88f1d3fb635a8cf0defc0e8dd8",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.70.2"
+}

package/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "d4162da3387da0b32a1ba55c4803d9fd7c5599d6f3edd0fbdf208da2b92e106f"
+      "sha256": "1d85fbf81247ed89879ccf588134efcab7e32fc3a72a4568adc8426c245d0a17"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.70.0 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.70.0 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.70.0 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.70.0 skill install --force
+pnpm dlx openxiangda@2.70.2 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.70.2 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.70.2 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.70.2 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。

package/skills/openxiangda-v2/references/application-operations.md

@@ -206,3 +206,17 @@ Native记录事件才能使用 `ordering:record`。订阅错误先修正应用
 在已经授权清理的范围运行 `acceptance-data.execute-cleanup`，核对金丝雀原回执，再把 mode 改为 remaining。丢响应先 preview/status，不换 run 或 digest；pending 清单复用原 repair。每份计划最多100条/1MiB，终结后重新 preview 下一批。外部修改、坏凭证、变化 Head、未知/预算结果及部分失败不会返回 purged。只有完整读回 `cleanupState: purged` 和剩余0表示此批 owned Native 数据验空；registry、参与者、凭证、审计和原修复回执保留。
 
 MCP仍通过 `application_operations/application_operation` 使用同一目录，不提供任意URL或重建来源。生产、旧数据、其他run不接受此入口。目录可用不代表目标平台已升级；404核对版本，不用直接SQL旁路。
+
+
+## 旧审批当前节点接续
+
+`admin execute workflows.legacy-prepare --environment test --input <file> --json`
+使用应用超级管理员身份锁定现有 Native 业务单、版本、原申请人、审批轮次与历史事实。
+输入契约从 `admin operations --json` 查询。未导入的原单先通过正式 Native 导入协议
+保留 UUID，不能用新建流程替代。仅支持内部分派、手动审批和线性条件路径；姓名无法
+证明账号、历史不完整或分支不匹配时拒绝接续。
+
+准备成功后保留 planId、planDigest，通过 `workflows.legacy-apply` 原子创建当前节点
+及待办。`workflows.legacy-receipt` 查询原回执，结果未知时沿用原计划查询/重试。
+历史审批只作为来源事实保留，不伪造旧 V2 操作、发起人登录或历史通知。角色撤销、
+原单、Head 或有效配置变化会拒绝尚未执行的旧计划；已执行计划返回原实例。

package/skills/openxiangda-v2/references/getting-started.md

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.70.0 skill install --force
-pnpm dlx openxiangda@2.70.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.70.0 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.70.0 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.70.2 skill install --force
+pnpm dlx openxiangda@2.70.2 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.70.2 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.70.2 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -221,9 +221,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.70.0 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.70.0 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.70.0 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.70.2 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.70.2 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.70.2 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回