openxiangda 2.75.2 → 2.75.3

package/documentation/backend.md

@@ -298,11 +298,31 @@ await businessData.transaction({
 ```
 
 引用约束：引用对象只含 `operationIndex`（0..99 的整数）与 `field: 'id'` 两个键；
-只能指向索引更小的 create 操作；引用不得嵌套在数组或对象里。违反形状报
+只能指向索引更小的 create 操作；普通字段引用不得嵌套在数组或对象里，关联资源字段的快照见下节。违反形状报
 `OPENXIANGDA_NATIVE_DATA_TRANSACTION_REFERENCE_INVALID`，嵌套报
 `..._NESTED`，目标不可解析报 `..._UNRESOLVED`。任一操作失败时整个事务回滚，
 不会留下无成员的 club。
 
+### 关联资源字段保留快照
+
+`resource-ref.single` 字段仍需要资源代码、显示标签和 `value`。用 Nest 的
+`resourceSnapshot` 将前序 create 引用放在唯一受支持的快照 `value` 位置；
+裸 UUID 引用不能代替资源字段快照：
+
+```ts
+import { resourceSnapshot } from 'openxiangda/nest';
+const operations = [
+  { operation: 'create' as const, resourceCode: 'orders', data: { name: '订单' } },
+  { operation: 'create' as const, resourceCode: 'order-lines', data: {
+    order: resourceSnapshot('orders', { operationIndex: 0, field: 'id' }, '订单'),
+  } },
+];
+```
+
+快照的 `resourceCode` 必须与前序 create 的资源一致。只允许既有快照元数据，
+`value` 之外的对象、数组和 `snapshot` 中仍不接受事务引用；平台继续验证目标字段、
+引用和实际授权。字符串 ID 的 `resourceSnapshot` 调用保持原行为，助手不提交或重试请求。
+
 ## 业务动作与普通查询 {#business-action}
 
 `OpenXiangdaDataApiService` 按当前用户的普通资源、行和字段权限执行。具名业务动作使用 `OpenXiangdaBusinessDataApiService`：入口先检查该动作 capability，平台在精确应用和环境内以受信任后端执行，并保留发起人与动作审计。业务动作不能接受任意模型/字段/用户 ID 后不做业务校验；应用负责该动作的输入约束和业务不变量。

package/documentation/getting-started.md

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.75.2 skill install --force
-pnpm dlx openxiangda@2.75.2 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.75.2 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.75.2 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.75.3 skill install --force
+pnpm dlx openxiangda@2.75.3 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.75.3 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.75.3 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.75.2 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.75.2 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.75.2 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.75.3 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.75.3 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.75.3 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.75.2",
+  "version": "2.75.3",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "368891ebe87fb713fa821eae3840df131d8b3758f1d9678e000f2bb228583271"
+      "sha256": "1505b474e9addb18ea0fd8cd7b4a968c2716fefd4f41f8a231b49ad9063e465f"
     },
     {
       "id": "product-design",
@@ -102,7 +102,7 @@
       "id": "backend",
       "title": "按需后端与业务动作",
       "file": "backend.md",
-      "sha256": "7c776eb18511e7dfcb58acbc20f7cc296871ca6360581ee72413c3aca4439fbf"
+      "sha256": "6662e54114190c883efa6b902afc3c62d05cd545000f75a871a4600b70c6203e"
     },
     {
       "id": "agent-cards",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.75.2",
+  "version": "2.75.3",
   "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.14",
-    "openxiangda-contracts": "2.95.2",
-    "openxiangda-devkit-core": "2.71.3",
+    "openxiangda-cli": "2.11.15",
+    "openxiangda-contracts": "2.95.3",
+    "openxiangda-devkit-core": "2.71.4",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.2.25",
-    "openxiangda-nest": "2.22.5",
-    "openxiangda-skill-kit": "2.3.128",
+    "openxiangda-mcp": "2.2.26",
+    "openxiangda-nest": "2.22.6",
+    "openxiangda-skill-kit": "2.3.129",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -167,37 +167,35 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.75.2",
+    "version": "2.75.3",
     "status": "reviewed",
-    "title": "流程条件在画布、列表和AI预览中保持中文可读",
-    "summary": "统一使用已验证的中文选项展示条件，并保留显式通向拒绝结果的业务分支。原始值、表达式、审批人和授权不变。",
+    "title": "修复事务内资源快照的前序创建引用",
+    "summary": "资源字段可通过正式资源快照引用同一事务之前创建的记录，公开预检与平台已有的主键解析行为保持一致，保留资源、显示标签和原子提交。",
     "newFeatures": [],
     "fixes": [
-      "画布连线、提示、可访问节点列表及AI方案预览共用已验证的选项标签，不再在已有中文选项时重复显示英文编码。",
-      "只读图按实际入边区分普通拒绝操作与显式业务条件，不再仅因结束结果为拒绝就隐藏业务分支。",
-      "保留管理员自定义分支名、未知历史原值、原始标量类型、定义摘要和可执行图；根包与CLI模板版本成对更新。",
-      "同步中文管理专题及Skill资料，说明WorkflowDiagram的可选展示选项与其不改变业务语义的边界。"
+      "公开事务验证器允许严格资源快照的 value 引用前序 create 的 id，并校验目标资源一致。",
+      "resourceSnapshot 提供事务引用类型重载，原字符串主键调用保留原有返回类型。",
+      "继续拒绝其他嵌套位置、快照元数据中的引用、前向或非 create 引用及额外引用字段；同步中文后端资料。"
     ],
     "affectedUsers": [
-      "使用2.0流程设计器、只读流程图、节点列表和AI改图预览的应用。"
+      "使用按需 Nest 事务同时创建主记录与资源关联条目的 OpenXiangda V2 应用。"
     ],
     "upgradeSteps": [
-      "应用使用本轮精确根包版本及其锁定依赖组合，不手工混装物理包；目标平台先消费同源正式SDK并通过兼容预检。",
-      "发布前保留未保存草稿，部署后核对原流程节点和绑定，再按真实管理员、审批人和发起人验收。"
+      "使用本轮精确根包及其锁定依赖组合；资源关联使用 resourceSnapshot(resourceCode, { operationIndex, field: 'id' }, label)，不要改成裸主键或拆分原子事务。",
+      "平台维持同源 contracts 配套及兼容预检；先在 TEST 核验新建、已有记录、拒绝与原键结果恢复，再按原包进行实际业务验收。"
     ],
     "knownLimitations": [
-      "没有合法中文标签或类型不兼容的历史值继续显示原始值，不会猜测或改写业务编码。",
-      "AI预览显示修复不代表模型可用；真实推理仍需单独配置平台执行服务、工作器及模型连接。",
-      "本地纯测试和受控浏览器图不替代实际站点、角色、物理鼠标或真实模型验收。"
+      "本次修正只接通平台已经实现的严格资源快照引用，不改变字段授权、组织隔离、资源预算或失败回滚。",
+      "本地合同和服务测试不代表目标站点的真实身份、通知或业务验收已经通过。"
     ],
     "compatibility": {
       "node": "Node.js 24 or newer for maintained toolchain",
       "generation": "OpenXiangda V2; V1 unchanged",
-      "platform": "Requires anonymous-public/public/query-batch; each item reuses existing public policy and Native authorization"
+      "platform": "Requires Native Data transactions with strict resource-snapshot preceding-create id resolution and the matched compiler validator digest"
     },
     "issues": [],
-    "sha256": "57283ba53d110aac43c3084bac70b23f29fecdaa4c7cdfd670840c238e80ee38",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.75.2"
+    "sha256": "a8bc97b610b1d7f628436497c31126ca48b94f02241f20c8c9460a307e58433a",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.75.3"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.71.0.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.71.0",
+  "status": "reviewed",
+  "title": "本人班级目录与数据库事务时间",
+  "summary": "具名动作和浏览器复用平台本人工作组织的家校班级投影，并由Native锁后的数据库时刻派生申请及冷却时间。",
+  "newFeatures": [
+    "loadCurrentDirectoryClasses读取当前用户/工作组织的班级、学校规范名称、校区、学段、年级和本人来源角色，组织切换丢弃迟到响应。",
+    "具名Nest动作显式声明directoryClasses.maxIds并精确解析1至20个来源班级，任一不可见时整体拒绝。",
+    "显式transactionTime动作使用databaseAcceptedTime写入datetime和最多366天整数偏移，原事务回执恢复不重新取时间。",
+    "可选recordSetAssertions对单组最多500个锁定且可读的记录执行公共字段或数据库时间条件，保留20总守卫预算。"
+  ],
+  "fixes": [
+    "CLI模板及随包中文资料与根包同批升级，七包组合由Changesets确定。",
+    "应用声明校验及双bundle保留班级目录与事务时间权限，统一openxiangda/nest入口导出数据库时间值及类型；真实应用消费与ESM/CJS编译贯通验证。"
+  ],
+  "affectedUsers": [
+    "使用家校来源班级、多组织身份或精确申请/冷却时刻的V2应用。"
+  ],
+  "upgradeSteps": [
+    "安装同一正式发行七包；平台维护者固定精确源码、contracts纯校验器和管理台seal后通过官方发行部署。",
+    "为需要的新动作显式声明目录/时间能力；所有已有写目标保留同ID的锁守卫及CAS。",
+    "通过目标预检后接入；真实组织同步、实际用户权限和PC/手机业务验收分别执行。"
+  ],
+  "knownLimitations": [
+    "本地及隔离PostgreSQL验证不代表站点已更新或真实用户业务通过。",
+    "目录读取不授予应用写权限，不将校区当作独立企业，不提供其他用户、unionId或安装秘密。",
+    "事务时间值仅供具名交互动作的秒精度datetime字段；普通CRUD、事件worker及队列不取得该能力。"
+  ],
+  "compatibility": {
+    "node": "Node.js 24 or newer for maintained toolchain",
+    "generation": "OpenXiangda V2; V1 unchanged",
+    "platform": "directory.current-classes 1.0.0; data.transaction-time-values 1.0.0; opted-in data.record-set-assertions 1.0.0; exact paired contracts"
+  },
+  "issues": [],
+  "sha256": "b034b4579f6640556cf5592e8908acd2c05922b6692d24dfe2dc2b077c913995",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.71.0"
+}

package/releases/2.75.3.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.75.3",
+  "status": "reviewed",
+  "title": "修复事务内资源快照的前序创建引用",
+  "summary": "资源字段可通过正式资源快照引用同一事务之前创建的记录，公开预检与平台已有的主键解析行为保持一致，保留资源、显示标签和原子提交。",
+  "newFeatures": [],
+  "fixes": [
+    "公开事务验证器允许严格资源快照的 value 引用前序 create 的 id，并校验目标资源一致。",
+    "resourceSnapshot 提供事务引用类型重载，原字符串主键调用保留原有返回类型。",
+    "继续拒绝其他嵌套位置、快照元数据中的引用、前向或非 create 引用及额外引用字段；同步中文后端资料。"
+  ],
+  "affectedUsers": [
+    "使用按需 Nest 事务同时创建主记录与资源关联条目的 OpenXiangda V2 应用。"
+  ],
+  "upgradeSteps": [
+    "使用本轮精确根包及其锁定依赖组合；资源关联使用 resourceSnapshot(resourceCode, { operationIndex, field: 'id' }, label)，不要改成裸主键或拆分原子事务。",
+    "平台维持同源 contracts 配套及兼容预检；先在 TEST 核验新建、已有记录、拒绝与原键结果恢复，再按原包进行实际业务验收。"
+  ],
+  "knownLimitations": [
+    "本次修正只接通平台已经实现的严格资源快照引用，不改变字段授权、组织隔离、资源预算或失败回滚。",
+    "本地合同和服务测试不代表目标站点的真实身份、通知或业务验收已经通过。"
+  ],
+  "compatibility": {
+    "node": "Node.js 24 or newer for maintained toolchain",
+    "generation": "OpenXiangda V2; V1 unchanged",
+    "platform": "Requires Native Data transactions with strict resource-snapshot preceding-create id resolution and the matched compiler validator digest"
+  },
+  "issues": [],
+  "sha256": "a8bc97b610b1d7f628436497c31126ca48b94f02241f20c8c9460a307e58433a",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.75.3"
+}

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": "58ffd109e9bf4d9de63151059e1e9fe22fba0bed4e3f33dffeca65752c24ab76"
+      "sha256": "b46d8ad957e62af3e48d68d76e8eb0c052258883e9f193b288e10403ce6d7971"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

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

package/skills/openxiangda-v2/references/backend.md

@@ -298,11 +298,31 @@ await businessData.transaction({
 ```
 
 引用约束：引用对象只含 `operationIndex`（0..99 的整数）与 `field: 'id'` 两个键；
-只能指向索引更小的 create 操作；引用不得嵌套在数组或对象里。违反形状报
+只能指向索引更小的 create 操作；普通字段引用不得嵌套在数组或对象里，关联资源字段的快照见下节。违反形状报
 `OPENXIANGDA_NATIVE_DATA_TRANSACTION_REFERENCE_INVALID`，嵌套报
 `..._NESTED`，目标不可解析报 `..._UNRESOLVED`。任一操作失败时整个事务回滚，
 不会留下无成员的 club。
 
+### 关联资源字段保留快照
+
+`resource-ref.single` 字段仍需要资源代码、显示标签和 `value`。用 Nest 的
+`resourceSnapshot` 将前序 create 引用放在唯一受支持的快照 `value` 位置；
+裸 UUID 引用不能代替资源字段快照：
+
+```ts
+import { resourceSnapshot } from 'openxiangda/nest';
+const operations = [
+  { operation: 'create' as const, resourceCode: 'orders', data: { name: '订单' } },
+  { operation: 'create' as const, resourceCode: 'order-lines', data: {
+    order: resourceSnapshot('orders', { operationIndex: 0, field: 'id' }, '订单'),
+  } },
+];
+```
+
+快照的 `resourceCode` 必须与前序 create 的资源一致。只允许既有快照元数据，
+`value` 之外的对象、数组和 `snapshot` 中仍不接受事务引用；平台继续验证目标字段、
+引用和实际授权。字符串 ID 的 `resourceSnapshot` 调用保持原行为，助手不提交或重试请求。
+
 ## 业务动作与普通查询 {#business-action}
 
 `OpenXiangdaDataApiService` 按当前用户的普通资源、行和字段权限执行。具名业务动作使用 `OpenXiangdaBusinessDataApiService`：入口先检查该动作 capability，平台在精确应用和环境内以受信任后端执行，并保留发起人与动作审计。业务动作不能接受任意模型/字段/用户 ID 后不做业务校验；应用负责该动作的输入约束和业务不变量。

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

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.75.2 skill install --force
-pnpm dlx openxiangda@2.75.2 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.75.2 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.75.2 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.75.3 skill install --force
+pnpm dlx openxiangda@2.75.3 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.75.3 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.75.3 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.75.2 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.75.2 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.75.2 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.75.3 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.75.3 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.75.3 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/releases/2.63.0.json

@@ -1,45 +0,0 @@
-{
-  "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

@@ -1,46 +0,0 @@
-{
-  "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/releases/2.66.0.json

@@ -1,29 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.66.0",
-  "status": "reviewed",
-  "title": "受限事件后台事务能力",
-  "summary": "复用平台事件投递租约及持久回执，支持定时消费者以显式资源与字段授权执行 Native 事务。",
-  "newFeatures": [
-    "事件消费者支持受限查询、冻结事务、原键提交与回执恢复；平台统一执行并验证事件租约。"
-  ],
-  "fixes": [
-    "迟到消费者只能释放自身租约，不能覆盖新消费者处理权。"
-  ],
-  "affectedUsers": [
-    "需要定时业务事务的 OpenXiangda V2 应用开发者与平台维护者。"
-  ],
-  "upgradeSteps": [
-    "配对升级 SDK、CLI、共享契约和平台服务；为事件订阅显式声明 worker-effect 资源、字段及容量。"
-  ],
-  "knownLimitations": [
-    "投递至少一次，业务事务依赖原幂等意图去重；不允许工作流拥有的资源写入或任意业务身份冒用。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "pnpm": "10.15.1"
-  },
-  "issues": [],
-  "sha256": "48c557ed1f5420f31b352721b05fc769d2f728c84102da0705eca9553844532a",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.66.0"
-}

package/releases/2.66.1.json

@@ -1,29 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.66.1",
-  "status": "reviewed",
-  "title": "事件 worker-effect SDK 导出修复",
-  "summary": "保持 2.66.0 worker-effect 能力，并修复根包 Nest 入口导出缺失。",
-  "newFeatures": [
-    "事件消费者支持受限查询、冻结事务、原键提交与回执恢复；平台统一执行并验证事件租约。"
-  ],
-  "fixes": [
-    "公开 Nest 入口补充导出事件 worker-effect 服务。"
-  ],
-  "affectedUsers": [
-    "需要定时业务事务的 OpenXiangda V2 应用开发者与平台维护者。"
-  ],
-  "upgradeSteps": [
-    "配对升级 SDK、CLI、共享契约和平台服务；为事件订阅显式声明 worker-effect 资源、字段及容量。"
-  ],
-  "knownLimitations": [
-    "投递至少一次，业务事务依赖原幂等意图去重；不允许工作流拥有的资源写入或任意业务身份冒用。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "pnpm": "10.15.1"
-  },
-  "issues": [],
-  "sha256": "bf5cc01bff98c34817ba998f822f74561f8d4d44da121229b5e585654cba13c0",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.66.1"
-}

package/releases/2.66.2.json

@@ -1,29 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.66.2",
-  "status": "reviewed",
-  "title": "工具链事实契约兼容修复",
-  "summary": "保持现有 worker-effect 能力，并修复工作区工具链事实的公开契约。",
-  "newFeatures": [
-    "事件消费者支持受限查询、冻结事务、原键提交与回执恢复；平台统一执行并验证事件租约。"
-  ],
-  "fixes": [
-    "允许工作区上下文返回已安装工具链事实。"
-  ],
-  "affectedUsers": [
-    "需要定时业务事务的 OpenXiangda V2 应用开发者与平台维护者。"
-  ],
-  "upgradeSteps": [
-    "配对升级 SDK、CLI、共享契约和平台服务；为事件订阅显式声明 worker-effect 资源、字段及容量。"
-  ],
-  "knownLimitations": [
-    "投递至少一次，业务事务依赖原幂等意图去重；不允许工作流拥有的资源写入或任意业务身份冒用。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "pnpm": "10.15.1"
-  },
-  "issues": [],
-  "sha256": "f597de89ed6ca7b7270427f35e2d9078576f1ee3ec06f961cd09b65e5298ebb8",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.66.2"
-}

package/releases/2.67.0.json

@@ -1,33 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.67.0",
-  "status": "reviewed",
-  "title": "应用Agent接口与事件worker声明修复",
-  "summary": "新增作用域内应用Agent客户端，并补齐事件worker编译上下文及节点条件配置契约。",
-  "newFeatures": [
-    "公开openxiangda/agent客户端与hooks，沿用平台当前身份和持久游标，未知写入不自动重放。"
-  ],
-  "fixes": [
-    "worker-effect编译传入显式emitEventTypes与实际工作流subject，避免合法声明被误拒绝。",
-    "配置类型公开worker-effect执行声明，避免应用使用类型绕过。",
-    "共享节点人员配置支持完整条件规则与权威来源边界。"
-  ],
-  "affectedUsers": [
-    "OpenXiangda V2应用开发者和平台维护者"
-  ],
-  "upgradeSteps": [
-    "按同批版本升级工具链，重新生成并检查应用契约。",
-    "配套升级平台共享契约后验证TEST，真实角色验收独立执行。"
-  ],
-  "knownLimitations": [
-    "事件至少一次投递，依赖原业务意图和平台回执去重。",
-    "工具链发布不代表学校平台部署或应用业务验收完成。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "pnpm": "10.15.1"
-  },
-  "issues": [],
-  "sha256": "535f00f729995cc1f8ce0925c3ddbd5976e1ed6283ef60d2888955ae95393d02",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.67.0"
-}

package/releases/2.67.1.json

@@ -1,35 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.67.1",
-  "status": "reviewed",
-  "title": "应用Agent及worker声明与发行恢复修复",
-  "summary": "新增作用域内应用Agent客户端，并补齐事件worker编译上下文及节点条件配置契约。",
-  "newFeatures": [
-    "公开openxiangda/agent客户端与hooks，沿用平台当前身份和持久游标，未知写入不自动重放。"
-  ],
-  "fixes": [
-    "worker-effect编译传入显式emitEventTypes与实际工作流subject，避免合法声明被误拒绝。",
-    "配置类型公开worker-effect执行声明，避免应用使用类型绕过。",
-    "共享节点人员配置支持完整条件规则与权威来源边界。",
-    "声明warning保持警告，真正错误仍阻断，避免正确应用被误拒绝。",
-    "Git worktree发行计划、验证与发布共用冻结制品、回执和进程锁；发现旧私有回执时先恢复原状态。"
-  ],
-  "affectedUsers": [
-    "OpenXiangda V2应用开发者和平台维护者"
-  ],
-  "upgradeSteps": [
-    "按同批版本升级工具链，重新生成并检查应用契约。",
-    "配套升级平台共享契约后验证TEST，真实角色验收独立执行。"
-  ],
-  "knownLimitations": [
-    "事件至少一次投递，依赖原业务意图和平台回执去重。",
-    "工具链发布不代表学校平台部署或应用业务验收完成。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "pnpm": "10.15.1"
-  },
-  "issues": [],
-  "sha256": "cab78d0c354ccfe6373966f884c475e4e50e0096a5cbe9763fce2a761ba99e99",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.67.1"
-}

package/releases/2.67.2.json

@@ -1,34 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.67.2",
-  "status": "reviewed",
-  "title": "读取范围能力交集与开发诊断修复",
-  "summary": "所选读取范围严格收窄当前身份能力，并补充原执行健康、托管文件语义及设计资料预算诊断。",
-  "newFeatures": [
-    "应用自助操作提供原执行健康和托管文件语义观察，沿用当前身份与原请求。"
-  ],
-  "fixes": [
-    "Perspective读取能力与当前身份能力取交集，避免有限角色选择其他角色的完整管理投影。",
-    "AppSpec记录实际读取字节和省略原因，保留现有确认及部署门禁，不将超预算资料误判为不存在。",
-    "工作区加载及封包的声明warning不再误当error阻断，真实错误继续拒绝。",
-    "发行元数据读取保留有界并发和原渠道状态；CLI模板与根SDK版本配套。"
-  ],
-  "affectedUsers": [
-    "使用多角色读取范围的V2应用开发者及平台维护者"
-  ],
-  "upgradeSteps": [
-    "通过官方精确根包版本安装整组工具链，检查当前平台兼容性后重新部署TEST。",
-    "使用有限角色、兼任角色及撤销授权场景核对页面投影；实际业务验收独立于发包。"
-  ],
-  "knownLimitations": [
-    "源码回归不证明学校身份同步、通知通道、定时任务或完整迁移已验收。",
-    "读取范围不改变写入和业务动作授权，Native后端继续独立执行字段与行权限。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "pnpm": "10.15.1"
-  },
-  "issues": [],
-  "sha256": "a6d7741c59762468ee23815832c0d707166bc60ca7913dabd4f945d6cf84ac20",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.67.2"
-}

package/releases/2.68.2.json

@@ -1,33 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.68.2",
-  "status": "reviewed",
-  "title": "固定公开单选过滤的编译一致性修复",
-  "summary": "允许对 option.single 单选字段声明固定公开 eq 条件，保持平台强制过滤和字段白名单。",
-  "newFeatures": [],
-  "fixes": [
-    "修复是否开放、发布状态等单选字段被应用与 Native 编译器错误拒绝的问题。",
-    "单选值只接受字符串或 null，拒绝数组、对象、数值和布尔；多选、附件、人员及资源引用仍不接受。"
-  ],
-  "affectedUsers": [
-    "通过 frontend.publicAccess 发布带开放/发布状态条件的公开目录应用。"
-  ],
-  "upgradeSteps": [
-    "应用升级精确 openxiangda 2.68.2 并重新 check；不修改已安装编译器或生成输出。",
-    "平台同步官方 openxiangda-contracts 2.88.1 编译器后再部署含此条件的应用；运行时过滤仍由平台负责。"
-  ],
-  "knownLimitations": [
-    "仍只允许固定 eq 条件；不开放匿名任意筛选、排序或普通 Native Data API。",
-    "包与平台发布不代表学校浏览器、真实角色或通知验收完成。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "Native compiler openxiangda-contracts 2.88.1; server option JSON equality already implemented"
-  },
-  "issues": [
-    "PLT-068"
-  ],
-  "sha256": "122b83c8aa1540c4e97ba7b4700618a03ff86585848f3f9f5626475ad13b7a8d",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.68.2"
-}

package/releases/2.70.0.json

@@ -1,35 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.70.0",
-  "status": "reviewed",
-  "title": "组织角色与业务记录归属边界",
-  "summary": "应用可声明平台目录角色映射、self/subtree 组织范围及 Native 记录组织归属，由配套平台统一执行身份与数据授权。",
-  "newFeatures": [
-    "角色显式声明 organizationReach；directoryRoleSources 将可信平台目录事实映射为当前组织内的应用角色和班级等字符串范围。",
-    "Native 资源声明 none、owned 或 inherited-down 组织策略；组织归属元数据可用于有界读取和统计，业务输入不能更改归属。",
-    "编译器共同校验组织角色、来源范围和资源策略，自动协商 authz.organizations、authz.directory-roles 与 data.organizations 能力。"
-  ],
-  "fixes": [
-    "隔离 CLI 候选构建保留固定 Corepack 缓存，嵌套源码构建并发上限为两个任务；保留真实依赖安装和端到端检查。"
-  ],
-  "affectedUsers": [
-    "使用多组织、教育局与独立学校或平台家校目录的 OpenXiangda V2 应用；已有未声明组织策略的应用保持原授权语义。"
-  ],
-  "upgradeSteps": [
-    "安装精确 openxiangda 2.70.0 官方组合并刷新项目资料，检查生成契约及能力要求。",
-    "平台配套正式 contracts、组织角色投影服务与新增 SQL 后再启用组织资源；在目标站点验证真实来源、活动成员、安装及角色正反路径。"
-  ],
-  "knownLimitations": [
-    "npm 包发布不代表平台部署、真实组织同步或业务验收；源码和独立 PostgreSQL 测试不能代替现场登录与权限验证。",
-    "普通后台或应用凭据不自动取得组织权限；未声明明确系统动作边界的后台任务不能访问组织资源。",
-    "已有无组织记录不自动推断或回填归属，启用组织策略后不能降级移除边界。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "须部署同源 contracts 及组织授权 SQL/后端；组织来源角色限定 self，subtree 授权由合法应用管理员显式管理"
-  },
-  "issues": [],
-  "sha256": "7291b56c3a9c02615075ea5bb9bcf22669b3d19540f5f95173f54589d31a24f8",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.70.0"
-}

package/releases/2.70.1.json

@@ -1,34 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.70.1",
-  "status": "reviewed",
-  "title": "业务待办通知与旧审批当前节点接续",
-  "summary": "应用事务可通过签名事件创建和结束真实待办；管理员可使用正式迁移回执将旧审批接续到原当前节点，保留原申请人与审批轮次。",
-  "newFeatures": [
-    "事件订阅显式声明 business-task 与任务代码清单，Nest sendTaskFromEvent 投影原事件并复用平台任务中心、通知发件箱及结束状态。",
-    "CLI 与 MCP 共享 workflows.legacy-prepare、workflows.legacy-apply、workflows.legacy-receipt 有界管理操作；旧审批历史作为来源事实保留。"
-  ],
-  "fixes": [
-    "声明检查器与打包器完整保留待办任务代码清单，应用与平台编译器共同协商 notification-hub-v2.event-tasks。"
-  ],
-  "affectedUsers": [
-    "需要预约审批、排队分配、结算确认等业务待办，或需接入有可靠来源证明的在途旧审批的 V2 应用。"
-  ],
-  "upgradeSteps": [
-    "安装精确 openxiangda 2.70.1 组合并重新生成契约；先部署同源平台 contracts、后端及旧审批接续 SQL。",
-    "业务状态与不可变待办事件同事务；旧审批先正式导入原业务单，再准备和执行原节点接续，未知结果查询原回执。"
-  ],
-  "knownLimitations": [
-    "本次 SDK 发行不代表目标平台或应用已部署，也不证明真实角色办理或外部供应方送达。",
-    "旧审批接续仅支持可靠身份、完整线性历史、手动审批和内部当前分派；不重放旧通知，不创建替代账号或伪造原申请人登录。",
-    "真实消息通道须沿既有发送授权启用；新增任务能力不授权批量补发历史通知。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "须配套正式 contracts、notification-hub-v2.event-tasks 后端及 AddWorkflowLegacyAdoptionsV2 SQL"
-  },
-  "issues": [],
-  "sha256": "d44db59da451ea6bc39a953cb5cefcdfc88241e0129bcdfb6a2d539424b166db",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.70.1"
-}

package/releases/2.75.2.json

@@ -1,34 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.75.2",
-  "status": "reviewed",
-  "title": "流程条件在画布、列表和AI预览中保持中文可读",
-  "summary": "统一使用已验证的中文选项展示条件，并保留显式通向拒绝结果的业务分支。原始值、表达式、审批人和授权不变。",
-  "newFeatures": [],
-  "fixes": [
-    "画布连线、提示、可访问节点列表及AI方案预览共用已验证的选项标签，不再在已有中文选项时重复显示英文编码。",
-    "只读图按实际入边区分普通拒绝操作与显式业务条件，不再仅因结束结果为拒绝就隐藏业务分支。",
-    "保留管理员自定义分支名、未知历史原值、原始标量类型、定义摘要和可执行图；根包与CLI模板版本成对更新。",
-    "同步中文管理专题及Skill资料，说明WorkflowDiagram的可选展示选项与其不改变业务语义的边界。"
-  ],
-  "affectedUsers": [
-    "使用2.0流程设计器、只读流程图、节点列表和AI改图预览的应用。"
-  ],
-  "upgradeSteps": [
-    "应用使用本轮精确根包版本及其锁定依赖组合，不手工混装物理包；目标平台先消费同源正式SDK并通过兼容预检。",
-    "发布前保留未保存草稿，部署后核对原流程节点和绑定，再按真实管理员、审批人和发起人验收。"
-  ],
-  "knownLimitations": [
-    "没有合法中文标签或类型不兼容的历史值继续显示原始值，不会猜测或改写业务编码。",
-    "AI预览显示修复不代表模型可用；真实推理仍需单独配置平台执行服务、工作器及模型连接。",
-    "本地纯测试和受控浏览器图不替代实际站点、角色、物理鼠标或真实模型验收。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "Requires anonymous-public/public/query-batch; each item reuses existing public policy and Native authorization"
-  },
-  "issues": [],
-  "sha256": "57283ba53d110aac43c3084bac70b23f29fecdaa4c7cdfd670840c238e80ee38",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.75.2"
-}