openxiangda 2.62.0 → 2.63.1

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.62.0",
+  "version": "2.63.1",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "b3adf180944862dd3c58b55f35bdb76a05427df610cbee12e6e31b265db8bf25"
+      "sha256": "baf929637d24ea0dbc023cd8494cc5110f1362c648b1102256b590ad2e074d8b"
     },
     {
       "id": "product-design",
@@ -56,17 +56,23 @@
       "file": "concepts.md",
       "sha256": "2c1445e9c86baa864087da585c7d613fff61745cdd9ebb9c83dcd2c3579c3c4a"
     },
+    {
+      "id": "application-templates",
+      "title": "源码模板与业务场景",
+      "file": "application-templates.md",
+      "sha256": "87fe39a04418d7225de53e8c0ab61ea457ba243e230019fe881676e3079cf34f"
+    },
     {
       "id": "frontend",
       "title": "页面与标准组件扩展",
       "file": "frontend.md",
-      "sha256": "0d122e3f9096a549f355ba88a4800b6473180a19b926e3748c84d51bb44f02b6"
+      "sha256": "838ead2993a05103a9bc30c8164d0b43448f62ef36d10d3e7d677f63a022c370"
     },
     {
       "id": "field-components",
       "title": "字段、表单与移动控件",
       "file": "field-components.md",
-      "sha256": "5d76266c583e43bdeaa6af055c2c02df221e539e4578fbedbc71b5fdee1e9eb0"
+      "sha256": "9b8e7f431186289c7c56489a647ad948a6a2d40f817a6ce1ab3bf5b85c2c83f7"
     },
     {
       "id": "data-authz",
@@ -84,7 +90,7 @@
       "id": "workflow-events",
       "title": "审批、事件与通知",
       "file": "workflow-events.md",
-      "sha256": "b395f2b17d5c1f4ecc4768fe06bc7dcf95436a29a61d50688fdacba01b5d07a1"
+      "sha256": "62e6ad70feb4a74e66b7b2fc0ab591fab244998044efa79340dd096dd53e92f2"
     },
     {
       "id": "backend",
@@ -150,13 +156,13 @@
       "id": "cli",
       "title": "CLI 命令参考",
       "file": "reference/cli.md",
-      "sha256": "f3f912eb9b151e460ce610b5ba7f67a4b30f56d62b8817871ec47b44622c07c7"
+      "sha256": "13821850bc6387d4c49605f8b5a3e795ee3f6a72780aa6ebe66ce54a8002bfbb"
     },
     {
       "id": "mcp",
       "title": "MCP 配置与工具参考",
       "file": "reference/mcp.md",
-      "sha256": "22ef30028c7d1f5a970508fcc0df5243dbfeaaa90235ab0172c31eba3f0eaf19"
+      "sha256": "0cf65d3b1e47399360222c5bfa1732fe9e1c1e99eb79072574b5ce533999bb2a"
     }
   ]
 }

package/documentation/reference/cli.md

@@ -8,7 +8,9 @@
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
 | `pnpm openxiangda admin` | 远端变更 | 查看管理能力、自助操作契约，或按明确环境执行事件、密钥及通知操作 |
+| `pnpm openxiangda template` | 只读 | 列出场景、模块、布局和风格模板 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
+| `pnpm openxiangda workflow` | 远端变更 | 导出流程、导入到源码、规划版本登记、查看状态并显式同步到目标环境 |
 | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |
 | `pnpm openxiangda dev` | 本地写入 | 连接平台测试数据启动本地 Web，按需启动 Nest |
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |

package/documentation/reference/mcp.md

@@ -59,6 +59,25 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 }
 ```
 
+## template_list
+
+发现源码模板。列出业务场景、模块依赖、四类源码外壳和主题；创建使用 CLI，不执行远端操作。
+
+- 只读：是
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}
+```
+
 ## workspace_context
 
 查看工作区。首先读取当前项目、工具链版本和绑定，不运行构建或创建远端对象。
@@ -1356,6 +1375,225 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 }
 ```
 
+## workflow_sync
+
+同步流程到目标环境。按目标流程修订号显式同步，默认同时更新在途和新申请；复用发布及版本适用规则。保留指定人员边界。
+
+- 只读：否
+- 可替换文件或改变远端状态：是
+- 幂等：是
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "workflowCode": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "fromEnvironment": {
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "toEnvironment": {
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "expectedSourceHeadRevision": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "expectedTargetHeadRevision": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "operationId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000
+    },
+    "scope": {
+      "type": "string",
+      "enum": [
+        "running_and_new",
+        "new_only"
+      ]
+    },
+    "acknowledgeExceptions": {
+      "type": "boolean"
+    },
+    "copyHandlingDefaults": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "workflowCode",
+    "fromEnvironment",
+    "toEnvironment",
+    "expectedSourceHeadRevision",
+    "expectedTargetHeadRevision",
+    "operationId",
+    "reason"
+  ],
+  "additionalProperties": false
+}
+```
+
+## workflow_export
+
+导出流程到工作区。只读导出环境中的规范定义、绑定和办理设置摘要；不包含运行记录或环境内部标识。
+
+- 只读：否
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "workflowCode": {
+      "type": "string",
+      "minLength": 1
+    },
+    "out": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "workflowCode",
+    "out"
+  ],
+  "additionalProperties": false
+}
+```
+
+## workflow_import
+
+把流程导入源码。验证代码能力和摘要后修改工作区显式流程声明，保留人员配置边界。
+
+- 只读：否
+- 可替换文件或改变远端状态：是
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "adoptHandlingDefaults": {
+      "default": false,
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "path"
+  ],
+  "additionalProperties": false
+}
+```
+
+## workflow_plan_registration
+
+规划流程版本登记。服务器只读查询已有摘要和下一版本数字；write 只写源码版本数字，不写环境观察。
+
+- 只读：否
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "write": {
+      "default": false,
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": false
+}
+```
+
+## workflow_status
+
+查看流程源码同步状态。比较源声明、导入基线和环境摘要，显示待导回源码、待部署或冲突及未启用版本数量。
+
+- 只读：是
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "workflowCode": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}
+```
+
 ## workflow_node_configurations
 
 查看流程有效参数。修改已部署流程前，读取管理员维护的节点配置。已有任务和后续节点进入使用各自适用版本。

package/documentation/workflow-events.md

@@ -1212,3 +1212,36 @@ subject update和来源guards提交实际改变的派生字段；普通补填仍
 不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。
 
 `commandHandlers.resubmit` 仅绑定固定 correction 节点的业务重校验。普通 `return_review` 任务继续由 Kernel 标准 `resubmit` 办理：Surface 不返回 correction operationCode，审批人不需要起草提交 capability。无需增加 `taskKinds` 字段、改动已有定义版本或重建在途实例；直接对普通退回任务调用 correction 业务动作仍被拒绝。
+
+## 画布、源码与测试环境同步
+
+管理员可以在画布修改节点和条件并直接发布。发布默认更新在途申请与新申请，当前已经进入的任务继续保留其人员、操作按钮、页面与字段权限；后续流转使用新版本。只让新申请生效、保留个别在途申请属于显式例外。
+
+应用源码与画布共同引用同一份不可变定义和绑定登记。画布修改后，后续仅改页面或后端的应用部署会保留兼容的画布版本。两边都改了流程而基线不一致时，部署返回 `WORKFLOW_SOURCE_DIVERGED`，需要先把正式环境流程导回源码：
+
+```sh
+pnpm openxiangda workflow export request-review --environment production --out platform/workflows/request-review.bundle.json
+pnpm openxiangda workflow import platform/workflows/request-review.bundle.json --to source
+pnpm openxiangda workflow plan-registration --environment test --write
+pnpm openxiangda workflow status --environment test
+```
+
+`export` 包含规范定义、绑定、任务页面与代码步骤契约、办理设置摘要；不含申请、待办、审批日志、密钥或环境内部标识。源码本来声明的固定用户标识会保留；管理员实际指定人员的覆盖只导出数量。`import` 只改 `openxiangda.config.ts` 中显式的 `workflows` 声明及 `platform/workflows/<code>.lock.json`，保留其他代码。新增或变化的代码步骤、页面契约需要先由开发者补齐；缺少这些契约的导入会在写文件前拒绝。
+
+可加 `--adopt-handling-defaults` 把办理模式与按钮开关、文案作为源码默认值。它保留原有必需动作，不把管理员指定人员复制成源码默认值。导入的摘要基线写在源码 activation 的 `sourceBase`；来源环境与修订号只保留在审计锁文件，不进入密封应用制品。锁文件与导出的规范文档可能包含合法源码用户引用，应按项目访问权限管理。
+
+`plan-registration` 是服务器只读查询，返回相同内容已有的版本号或下一整数；`--write` 只把数字写入本机源码。最终准备仍检查编号冲突、内容冲突和跳号。准备成功但后续部署失败的版本保留为未启用的不可变登记，相同制品可复用这些数字；不会删除或重排。`status` 显示 `in_sync`、`behind`、`ahead`、`diverged`、`not_active` 和未启用登记数量。它没有远端写入。首次导入之前，状态比较使用目标环境当前应用版本的源码声明作为基线；跨环境导入的来源修订不会冒充目标环境基线。
+
+如果只希望把正式环境的流程规则同步到已有测试环境，可先读取两边的 `status`，记录实际流程 Head 修订号，再显式执行同步：
+
+```sh
+pnpm openxiangda workflow sync request-review --from production --to test \
+  --expected-source-head 14 --expected-target-head 3 \
+  --operation-id workflow-sync-20261012-01 --reason '同步正式环境流程到测试'
+```
+
+示例修订号必须替换成实际读取值。源和目标必须属于同一应用且均有已启用流程。同步检查目标现有页面、代码步骤、角色与固定人员引用，复用源版本，并通过正常发布与在途适用规则生效。默认同时更新在途和新申请；`--new-only` 只更新新申请。存在不兼容在途申请时，在确认预览结果后加 `--acknowledge-exceptions`，这些申请继续保留原版本。
+
+`--copy-handling-defaults` 可复制办理模式、按钮和角色覆盖；两边的指定人员覆盖都保持环境所有。源环境不被修改。同步后的目标画布草稿若基线已经过时，需要重读或合并，不能覆盖新的 Head。请求不确定时，保留相同操作标识、两个修订号和完整参数重试；不要换标识重做。CLI 与 MCP 共用这些权限、校验、幂等和发布入口。
+
+部署前记录目标流程修订号，激活前再次核对。期间若有人发布了画布，激活返回 `WORKFLOW_SOURCE_HEAD_CHANGED`，应用 Head 与流程 Head 在同一事务回滚；已准备的不可变登记保留。同步成功、源码检查成功、包发布与真实审批验收分别核对。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.62.0",
+  "version": "2.63.1",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,7 +52,11 @@
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./resource": {
+      "types": "./dist/resource.d.ts",
+      "import": "./dist/resource.js"
+    }
   },
   "bin": {
     "openxiangda": "./bin/run.js"
@@ -87,13 +91,13 @@
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
     "elkjs": "0.12.0",
-    "openxiangda-cli": "2.8.12",
-    "openxiangda-contracts": "2.78.0",
-    "openxiangda-devkit-core": "2.59.0",
+    "openxiangda-cli": "2.9.1",
+    "openxiangda-contracts": "2.79.1",
+    "openxiangda-devkit-core": "2.60.1",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.1.9",
-    "openxiangda-nest": "2.18.0",
-    "openxiangda-skill-kit": "2.3.100",
+    "openxiangda-mcp": "2.2.1",
+    "openxiangda-nest": "2.18.2",
+    "openxiangda-skill-kit": "2.3.102",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -159,43 +163,49 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.62.0",
+    "version": "2.63.1",
     "status": "reviewed",
-    "title": "受控事件、机器回调与后台补偿原子写入",
-    "summary": "以不可变资源、操作、字段和数量声明支持 action-owned 资源的验证事件、具名机器回调及活动租约 Worker 原子事务，保留默认拒绝、CAS、幂等与原有用户权限。",
+    "title": "流程设计、独立办理与公开契约配套发行",
+    "summary": "正式发行已评审的流程设计、办理节点、共享数据保存、结构化并行、提醒通知和流程源码同步能力，提供可编辑应用模板、资源引用读取上下文及只读 AI 回执核对，同时修复首次导入前的源基线比较和配置写入边界。公开 SDK 与 contracts 2.79.1 使用同一冻结分发。",
     "newFeatures": [
-      "platformAccess.dataMutations 固定资源、create/update/delete/increment、字段白名单和单事务数量上限；要求 data.service-mutations 1.0.0 平台能力。",
-      "ApplicationDataApiService.transactionFromServiceAction 在机器操作的已验证请求下提交同一个 Native 事务，不把机器冒充用户。",
-      "ApplicationDataApiService.withWorkerAction 使用 SDK 活动后台租约并要求 allowRuntimeWorker:true，复用既有回调/补偿服务，支持最多50条履约节点与签署完成件一并提交。"
+      "流程设计、变量和目标目录、管理员配置、设计提案及历史实例接管共用规范定义与纯校验规则。",
+      "独立办理与补正节点支持明确完成动作、意见要求、共享数据保存、退回策略、持久提醒、平台通知和主管链规则。",
+      "结构化 parallel/join 节点支持有界独立分支、分支位置证明及发布校验，保留任务进入时的权威事实。",
+      "流程源码导出、导入、版本注册和环境同步使用源摘要及目标版本守卫，保留准备版本历史。",
+      "可编辑模板覆盖后台、PC、移动端和登录外观，资源页控制器、来源摘要及组合校验共用标准边界。",
+      "资源引用筛选使用独立读取意图；普通关联编辑提供记录 id/revision 和实际编辑上下文，由平台合并权威绑定。",
+      "AI 核对通过只读 GET/read 查询原幂等键的提交回执，不重新执行业务命令。"
     ],
     "fixes": [
-      "Correction 的业务 resubmit handler 与普通 return_review 标准 Kernel 重提分离；普通退回任务不再错误要求起草 capability，已有固定定义和实例无需重建。"
+      "首次导入前按目标应用声明比较流程源状态，忽略其他环境观察，复用规范摘要、校验源锁并将写入限定于应用导出的配置。",
+      "并行分支卡片居中且条件开关保持单行，审批布局继续保留权限、CAS、幂等和未知结果恢复。",
+      "新增流程规则使用正式公开 contracts 新版本，不在已公开旧版本号下私有添加 API。",
+      "封包清单正确检查 template/list 命令，参考候选仓库支持显式任务代理访问官方上游。"
     ],
     "affectedUsers": [
-      "使用 action-owned 资源、审批终态事件或真实机器回调的 OpenXiangda 2.0 应用。",
-      "需要权威查询补偿和多记录原子回写的 Scheduler/Worker 应用。"
+      "使用流程设计、独立办理、共享保存、提醒通知、流程源同步或历史实例接管的 OpenXiangda 2.0 平台和应用。",
+      "使用可编辑模板、资源引用字段或只读 AI 结果核对的 2.0 工作区。"
     ],
     "upgradeSteps": [
-      "升级配套平台并核对 data.service-mutations 1.0.0 与完整配置 validatorDigest。",
-      "将工作区所有 OpenXiangda 包升级到同一胶囊版本2.62.0并安装锁文件依赖。",
-      "事件订阅和机器操作显式声明 dataMutations；后台动作按需显式加 allowRuntimeWorker:true，保持原业务幂等键和各行CAS。",
-      "机器请求调用 transactionFromServiceAction；Worker 用 withWorkerAction 包裹现有服务；真实测试环境分别验收事件、回调、补偿和50条整事务回滚。"
+      "先部署与 contracts 2.79.1 实际纯规则摘要一致的平台；服务器使用官方公开 tarball 并核对 SRI。",
+      "完整工作区分发升级到 openxiangda 2.63.1，按锁文件安装并刷新资料及 MCP 连接。",
+      "保留原应用、数据、任务、流程版本和幂等标识，正常 check/deploy 核对实际能力与 validatorDigest。",
+      "按真实角色验证设计、保存、办理完成、退回、通知收件人及关联字段读写，再执行原晋级流程。"
     ],
     "knownLimitations": [
-      "字段授权不替代外部供应商验签、业务状态守卫、底稿摘要或当前用户成员权限；role-member/actor-authority仍由用户动作拥有。",
-      "机器入口使用已有短期网关invocation的有效期；过期结果按原业务号核对，通过活动租约补偿，不延长或伪造证明。",
-      "Native事务自身总操作/字段/字节限额仍生效，本文档的maxOperations是单资源额外上限。",
-      "生产晋级仍须实际业务验收，不能将包测试或Pod Ready视作签署、通知或财务验收。"
+      "新增读取上下文和流程契约需要配套平台先升级，修改摘要不能代替真实兼容性。",
+      "包测试和模板外观不代替真实角色、通知、实例接管及业务数据读回验收。",
+      "事件回执租约对象归属和 Worker 原子效果仍为独立 PLT-040 候选，本次不包含未整合改动。"
     ],
     "compatibility": {
       "generation": "v2",
       "node": ">=24",
-      "platform": "data.service-mutations 1.0.0 and exact configuration validator",
-      "v1": "独立1.x维护包不变"
+      "platform": "contracts 2.79.1 exact native validator and matching workflow/resource contexts",
+      "v1": "独立 1.x 维护分发不变"
     },
     "issues": [],
-    "sha256": "c547759f4a202325b30134e2db40f2bc9bdd05b74fc4da393acd46c2802832a5",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.62.0"
+    "sha256": "364565fc1ab2b4a1db89328b684ca7f5d1b261ad882e00e5da7c1687e5be7861",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.63.1"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.63.0.json

@@ -0,0 +1,45 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.63.0",
+  "status": "reviewed",
+  "title": "Workflow design, handling nodes and editable application templates",
+  "summary": "Publish the reviewed mainline workflow designer and handling capabilities, shared-record Save, structured parallel branches and guarded workflow source synchronisation. Add editable templates, resource reference read/update contexts and read-only AI command reconciliation. The platform must use the same public contracts 2.79.0 pure compiler as the SDK.",
+  "newFeatures": [
+    "Canonical workflow designer definitions, target/variable catalogs, administration, proposals and instance adoption share the same pure validation rules.",
+    "Independent handling and correction nodes support explicit completion actions, opinion requirements, shared-record Save, return policies, durable reminders, platform notifications and supervisor-chain assignments.",
+    "Paired parallel/join nodes have bounded disjoint branches, branch-scoped position proofs and publication validation while retaining immutable task-entry authority.",
+    "Workflow source export/import, read-only version registration plans and environment synchronisation use digest and target-head guards and preserve prepared version history.",
+    "Editable application templates cover administration, PC, mobile and login frames, with shared resource-page controllers, source digests and composition validation.",
+    "Resource reference filtering has an independent read intent; ordinary edits supply saved-record id/revision and actual edits for authoritative server-side merge.",
+    "AI reconciliation binds a read-only GET/read operation to the original command receipt instead of replaying a business mutation."
+  ],
+  "fixes": [
+    "Give the new workflow pure-rule APIs a fresh public contracts version so platforms need not privately add exports under an already published semver.",
+    "Correct canvas branch selection, outline hierarchy and approval action presentation while retaining permissions, CAS, idempotency and unknown-result recovery.",
+    "Export standard resource query, cascade and address helpers from shared contracts so browser and platform consumers use the same query semantics."
+  ],
+  "affectedUsers": [
+    "OpenXiangda V2 platforms and applications using workflow design, independent handling, shared Save, reminders, notifications or instance adoption.",
+    "V2 workspaces using editable template composition, resource reference fields or read-only AI result reconciliation."
+  ],
+  "upgradeSteps": [
+    "Deploy a platform matching the actual contracts 2.79.0 native validator first. Server contracts must come from the official published tarball with verified SRI.",
+    "Upgrade the complete workspace distribution to public openxiangda 2.63.0, install the lockfile and refresh project documentation and MCP sessions.",
+    "Preserve application, record, task, workflow-version and idempotency identities. Run normal check/deploy preflight against the actual platform capabilities and validator digest.",
+    "Verify workflow design, shared Save, handling completion, return paths, notification recipients and reference reads/updates with real roles before environment promotion."
+  ],
+  "knownLimitations": [
+    "New reference contexts and workflow contracts require the matching platform to be deployed first; declaring a different digest does not establish compatibility.",
+    "Template appearance and package regressions do not replace real-role, notification, instance-adoption and business-data acceptance.",
+    "The separate event-receipt lease-ownership and worker-effect candidates are not included in this public release."
+  ],
+  "compatibility": {
+    "generation": "v2",
+    "node": ">=24",
+    "platform": "contracts 2.79.0 exact native validator and matching workflow/resource contexts",
+    "v1": "Independent 1.x maintenance distribution is unchanged"
+  },
+  "issues": [],
+  "sha256": "ef4279a6f846a604d68dbd1adc2473203ffef4287e2dc74b51aa17727a7397b5",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.63.0"
+}

package/releases/2.63.1.json

@@ -0,0 +1,46 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.63.1",
+  "status": "reviewed",
+  "title": "流程设计、独立办理与公开契约配套发行",
+  "summary": "正式发行已评审的流程设计、办理节点、共享数据保存、结构化并行、提醒通知和流程源码同步能力，提供可编辑应用模板、资源引用读取上下文及只读 AI 回执核对，同时修复首次导入前的源基线比较和配置写入边界。公开 SDK 与 contracts 2.79.1 使用同一冻结分发。",
+  "newFeatures": [
+    "流程设计、变量和目标目录、管理员配置、设计提案及历史实例接管共用规范定义与纯校验规则。",
+    "独立办理与补正节点支持明确完成动作、意见要求、共享数据保存、退回策略、持久提醒、平台通知和主管链规则。",
+    "结构化 parallel/join 节点支持有界独立分支、分支位置证明及发布校验，保留任务进入时的权威事实。",
+    "流程源码导出、导入、版本注册和环境同步使用源摘要及目标版本守卫，保留准备版本历史。",
+    "可编辑模板覆盖后台、PC、移动端和登录外观，资源页控制器、来源摘要及组合校验共用标准边界。",
+    "资源引用筛选使用独立读取意图；普通关联编辑提供记录 id/revision 和实际编辑上下文，由平台合并权威绑定。",
+    "AI 核对通过只读 GET/read 查询原幂等键的提交回执，不重新执行业务命令。"
+  ],
+  "fixes": [
+    "首次导入前按目标应用声明比较流程源状态，忽略其他环境观察，复用规范摘要、校验源锁并将写入限定于应用导出的配置。",
+    "并行分支卡片居中且条件开关保持单行，审批布局继续保留权限、CAS、幂等和未知结果恢复。",
+    "新增流程规则使用正式公开 contracts 新版本，不在已公开旧版本号下私有添加 API。",
+    "封包清单正确检查 template/list 命令，参考候选仓库支持显式任务代理访问官方上游。"
+  ],
+  "affectedUsers": [
+    "使用流程设计、独立办理、共享保存、提醒通知、流程源同步或历史实例接管的 OpenXiangda 2.0 平台和应用。",
+    "使用可编辑模板、资源引用字段或只读 AI 结果核对的 2.0 工作区。"
+  ],
+  "upgradeSteps": [
+    "先部署与 contracts 2.79.1 实际纯规则摘要一致的平台；服务器使用官方公开 tarball 并核对 SRI。",
+    "完整工作区分发升级到 openxiangda 2.63.1，按锁文件安装并刷新资料及 MCP 连接。",
+    "保留原应用、数据、任务、流程版本和幂等标识，正常 check/deploy 核对实际能力与 validatorDigest。",
+    "按真实角色验证设计、保存、办理完成、退回、通知收件人及关联字段读写，再执行原晋级流程。"
+  ],
+  "knownLimitations": [
+    "新增读取上下文和流程契约需要配套平台先升级，修改摘要不能代替真实兼容性。",
+    "包测试和模板外观不代替真实角色、通知、实例接管及业务数据读回验收。",
+    "事件回执租约对象归属和 Worker 原子效果仍为独立 PLT-040 候选，本次不包含未整合改动。"
+  ],
+  "compatibility": {
+    "generation": "v2",
+    "node": ">=24",
+    "platform": "contracts 2.79.1 exact native validator and matching workflow/resource contexts",
+    "v1": "独立 1.x 维护分发不变"
+  },
+  "issues": [],
+  "sha256": "364565fc1ab2b4a1db89328b684ca7f5d1b261ad882e00e5da7c1687e5be7861",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.63.1"
+}

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": "28c54b07d71728775fece2d934b9171f9971ccd7697f4fc6745d9be424ba269e"
+      "sha256": "471e1b87af83dee03b037fef3fae6b63337ed851d234a23180305c9092eca169"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -7,11 +7,11 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 
 ## 应用结构基线（必须遵守）
 
-每个业务应用默认先建立并保留标准管理后台。管理后台是应用骨架，承载资源模型、表单、数据列表、详情/编辑、权限和流程入口；AI 必须先从后台完成数据与契约，再实现用户端体验。默认提供标准 Shell；需要定制后台外观时使用 `ui.admin.shell` 或局部插槽，保留平台后台路由、授权和显式业务菜单。
+有管理任务时选择后台源码模板；PC 用户端、移动用户端和登录外观分别选择布局与风格。先读取 [源码模板与业务场景](references/application-templates.md) 或 template list / MCP template_list，结合已确认业务选择初始化模块。已获开发与创建授权时直接执行，模板选择不增加确认步骤。
 
-Agent 按页面归属优化布局、视觉和交互：后台通过默认 Shell 或 `ui.admin` 扩展复用平台导航事实、字段行为和权限；用户端 PC 与移动端按真实任务分别设计，并通过平台 runtime/Data API 读取后台数据。图片参考不定义交互、权限或验收。不得用图片、单页 HTML、iframe 或独立假后台冒充管理后台，也不得在用户端复制后台权限和导航状态。
+应用拥有外壳与页面源码，可修改、替换或重构。通过 ui.admin.shell 保持唯一后台，通过 resourcePages 贡献替换资源页面，从 openxiangda/resource 组合列表块与控制器。平台继续拥有路由、身份、授权、数据和登录行为；不复制这些权威。既有应用保留 SDK fallback，不强制换模板；没有管理任务的应用可不添加后台。
 
-设计、实现和发布验收必须分别核验管理后台入口、表单、数据列表、流程入口，以及用户端 PC/移动端入口。缺少标准管理后台的应用结构不完整，不能发布。
+分别验证实际使用的后台、表单、列表及用户 PC/移动入口。图片只作为视觉参考，不代表运行或业务验收。
 
 ## 先理解任务
 
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.62.0 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.62.0 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.62.0 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.62.0 skill install --force
+pnpm dlx openxiangda@2.63.1 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.63.1 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.63.1 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.63.1 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。