openxiangda 2.61.3 → 2.62.0

package/documentation/backend.md

@@ -622,3 +622,23 @@ CAS与写后范围检查同事务执行。应用仍负责业务规则和字典gu
 没有新增独立的部门可见范围策略。任何部门不存在或已删除时，整组失败，不按姓名匹配，
 不接受客户端标签，也不回退到应用内复制的组织表。`snapshotRevision` 描述返回事实，
 `resolvedAt` 来自数据库时间；快照不能替代后续业务事务的权限检查。
+
+## action-owned 资源的受控事件与机器回调事务
+
+声明 `platformAccess.dataMutations`，把资源、操作、字段和单事务数量上限固定到事件订阅或机器操作：
+
+```ts
+platformAccess: { dataMutations: [
+  { resourceCode: 'contracts', operations: ['update'], fieldCodes: ['status', 'signingStatus'], maxOperations: 1 },
+  { resourceCode: 'performance-plans', operations: ['update'], fieldCodes: ['planDate', 'status'], maxOperations: 50 },
+] }
+```
+
+该能力要求平台 `data.service-mutations` 1.0.0。受验证的 `@OpenXiangdaEventHandler` 内继续使用 `OpenXiangdaApplicationDataApiService.transaction`；SDK 自动携带事件来源，平台在同一事务锁定原投递与 processing receipt 的有效租约，并解析当前不可变订阅声明。
+
+机器回调在 `@OpenXiangdaOperation` 已验证请求内使用 `applicationData.transactionFromServiceAction(request, transaction)`。`request` 必须是平台已验证的 service 具名操作上下文；平台独立验证原始短期网关 invocation、机器的操作 capability 和当前部署，同时仍验证运行凭据。用户/developer、裸 OAuth data:write 和调用方填写的 operation/source 对象不能替代此证明。
+
+字段、资源、操作或数量超出声明时整事务拒绝；CAS、原幂等键、额度终态与文件绑定校验继续生效。不分批提交 50 个节点，不绕过 Native owner 门禁，不把 JWT/租约 nonce 保存到业务表。role-member/actor-authority 仍需要真实用户动作，服务源不冒充用户成员。声明相同原事件在新的有效投递租约下可按原键重试；证明不能离开处理器执行使用。
+
+可信 Scheduler/补偿 Worker：给可供后台执行的同一具名操作 `dataMutations` 条目加 `allowRuntimeWorker: true`，并使用
+`await applicationData.withWorkerAction('callback-operation-code', () => callbackService.handle(originalInput))`。此作用域中的 `.transaction()` 自动携带当前 RuntimeLeaseService 的持有者与租约证明；平台在原事务锁定当前运行凭据、部署/Head 和该后台租约，并逐资源拒绝没有该 opt-in 的条目。无需 HTTP 请求或用户身份；没有活动租约、普通 OAuth 或已过期/被替代的实例仍被拒绝。该作用域可调用现有 CallbackService、DueSweep 等服务，整批操作同事务，保持原业务幂等键。

package/documentation/getting-started.md

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

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.61.3",
+  "version": "2.62.0",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "5852e5b390c35396d5f31745610ea24a0612fe0f3c67f9517149b1171f486886"
+      "sha256": "b3adf180944862dd3c58b55f35bdb76a05427df610cbee12e6e31b265db8bf25"
     },
     {
       "id": "product-design",
@@ -84,13 +84,13 @@
       "id": "workflow-events",
       "title": "审批、事件与通知",
       "file": "workflow-events.md",
-      "sha256": "8e53cd8f7931346a8de2c34eed2421cbd9f5bf80e8470c8e0aa0e07f72283e5d"
+      "sha256": "b395f2b17d5c1f4ecc4768fe06bc7dcf95436a29a61d50688fdacba01b5d07a1"
     },
     {
       "id": "backend",
       "title": "按需后端与业务动作",
       "file": "backend.md",
-      "sha256": "e3ac14a8ba787947f6253792d0574c3a580b94c848cfca16c9a6cfb4d5d2382f"
+      "sha256": "0289841d9c19ffaff44a6eff0a5d5ece2561bca9e3623392bdea647abed306ed"
     },
     {
       "id": "agent-cards",

package/documentation/workflow-events.md

@@ -1210,3 +1210,5 @@ subject update和来源guards提交实际改变的派生字段；普通补填仍
 缺少规则、返回 `undefined` 或回调失败均保持原显示。PC/手机共用这一规则，
 最后一个字段被省略后对应空分组也消失。这是同步展示扩展，不发请求、不写数据，
 不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。
+
+`commandHandlers.resubmit` 仅绑定固定 correction 节点的业务重校验。普通 `return_review` 任务继续由 Kernel 标准 `resubmit` 办理：Surface 不返回 correction operationCode，审批人不需要起草提交 capability。无需增加 `taskKinds` 字段、改动已有定义版本或重建在途实例；直接对普通退回任务调用 correction 业务动作仍被拒绝。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.61.3",
+  "version": "2.62.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -87,13 +87,13 @@
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
     "elkjs": "0.12.0",
-    "openxiangda-cli": "2.8.11",
-    "openxiangda-contracts": "2.77.0",
-    "openxiangda-devkit-core": "2.58.0",
+    "openxiangda-cli": "2.8.12",
+    "openxiangda-contracts": "2.78.0",
+    "openxiangda-devkit-core": "2.59.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.1.8",
-    "openxiangda-nest": "2.17.2",
-    "openxiangda-skill-kit": "2.3.99",
+    "openxiangda-mcp": "2.1.9",
+    "openxiangda-nest": "2.18.0",
+    "openxiangda-skill-kit": "2.3.100",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -159,36 +159,43 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.61.3",
+    "version": "2.62.0",
     "status": "reviewed",
-    "title": "Field Kit 富文本工具栏溢出操作",
-    "summary": "官方富文本 Field Kit 在桌面窄容器中显示可发现的更多工具入口，并支持稳定展开多行，避免靠后的编辑操作被隐藏。",
+    "title": "受控事件、机器回调与后台补偿原子写入",
+    "summary": "以不可变资源、操作、字段和数量声明支持 action-owned 资源的验证事件、具名机器回调及活动租约 Worker 原子事务，保留默认拒绝、CAS、幂等与原有用户权限。",
     "newFeatures": [
-      "桌面工具栏发生横向溢出时显示“更多工具”按钮，点击后展开为多行并提供收起状态。",
-      "ResizeObserver 与 MutationObserver 共同覆盖容器尺寸、菜单和动态表格工具变化，移动端继续使用原有换行布局。"
+      "platformAccess.dataMutations 固定资源、create/update/delete/increment、字段白名单和单事务数量上限；要求 data.service-mutations 1.0.0 平台能力。",
+      "ApplicationDataApiService.transactionFromServiceAction 在机器操作的已验证请求下提交同一个 Native 事务，不把机器冒充用户。",
+      "ApplicationDataApiService.withWorkerAction 使用 SDK 活动后台租约并要求 allowRuntimeWorker:true，复用既有回调/补偿服务，支持最多50条履约节点与签署完成件一并提交。"
     ],
     "fixes": [
-      "修复富文本工具栏隐藏滚动条后图片、视频、表格和撤销/重做等操作不可发现的问题。",
-      "修复展开后因重新测量导致按钮闪退的问题；组件卸载会清理观察器和待执行测量。"
+      "Correction 的业务 resubmit handler 与普通 return_review 标准 Kernel 重提分离；普通退回任务不再错误要求起草 capability，已有固定定义和实例无需重建。"
     ],
     "affectedUsers": [
-      "使用 OpenXiangda 官方 Field Kit 富文本字段的应用开发者和编辑人员。"
+      "使用 action-owned 资源、审批终态事件或真实机器回调的 OpenXiangda 2.0 应用。",
+      "需要权威查询补偿和多记录原子回写的 Scheduler/Worker 应用。"
     ],
     "upgradeSteps": [
-      "升级 openxiangda 至 2.61.3，并使用匹配的 openxiangda-cli 2.8.11。",
-      "重新构建应用前端即可获得平台组件行为；HTML、清洗、媒体上传和数据协议无需迁移。"
+      "升级配套平台并核对 data.service-mutations 1.0.0 与完整配置 validatorDigest。",
+      "将工作区所有 OpenXiangda 包升级到同一胶囊版本2.62.0并安装锁文件依赖。",
+      "事件订阅和机器操作显式声明 dataMutations；后台动作按需显式加 allowRuntimeWorker:true，保持原业务幂等键和各行CAS。",
+      "机器请求调用 transactionFromServiceAction；Worker 用 withWorkerAction 包裹现有服务；真实测试环境分别验收事件、回调、补偿和50条整事务回滚。"
     ],
     "knownLimitations": [
-      "使用自定义编辑器的应用不会自动继承官方 Field Kit 的工具栏布局；移动端按既有换行规则展示。"
+      "字段授权不替代外部供应商验签、业务状态守卫、底稿摘要或当前用户成员权限；role-member/actor-authority仍由用户动作拥有。",
+      "机器入口使用已有短期网关invocation的有效期；过期结果按原业务号核对，通过活动租约补偿，不延长或伪造证明。",
+      "Native事务自身总操作/字段/字节限额仍生效，本文档的maxOperations是单资源额外上限。",
+      "生产晋级仍须实际业务验收，不能将包测试或Pod Ready视作签署、通知或财务验收。"
     ],
     "compatibility": {
+      "generation": "v2",
       "node": ">=24",
-      "platform": "data.rich-text 1.0.0",
-      "generation": "OpenXiangda Native V2"
+      "platform": "data.service-mutations 1.0.0 and exact configuration validator",
+      "v1": "独立1.x维护包不变"
     },
     "issues": [],
-    "sha256": "b2bfeb9d8bbaaa20a142b8abf4da4f4384edf013e4b5c542bb7cdca75e966f40",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.61.3"
+    "sha256": "c547759f4a202325b30134e2db40f2bc9bdd05b74fc4da393acd46c2802832a5",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.62.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.62.0.json

@@ -0,0 +1,40 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.62.0",
+  "status": "reviewed",
+  "title": "受控事件、机器回调与后台补偿原子写入",
+  "summary": "以不可变资源、操作、字段和数量声明支持 action-owned 资源的验证事件、具名机器回调及活动租约 Worker 原子事务，保留默认拒绝、CAS、幂等与原有用户权限。",
+  "newFeatures": [
+    "platformAccess.dataMutations 固定资源、create/update/delete/increment、字段白名单和单事务数量上限；要求 data.service-mutations 1.0.0 平台能力。",
+    "ApplicationDataApiService.transactionFromServiceAction 在机器操作的已验证请求下提交同一个 Native 事务，不把机器冒充用户。",
+    "ApplicationDataApiService.withWorkerAction 使用 SDK 活动后台租约并要求 allowRuntimeWorker:true，复用既有回调/补偿服务，支持最多50条履约节点与签署完成件一并提交。"
+  ],
+  "fixes": [
+    "Correction 的业务 resubmit handler 与普通 return_review 标准 Kernel 重提分离；普通退回任务不再错误要求起草 capability，已有固定定义和实例无需重建。"
+  ],
+  "affectedUsers": [
+    "使用 action-owned 资源、审批终态事件或真实机器回调的 OpenXiangda 2.0 应用。",
+    "需要权威查询补偿和多记录原子回写的 Scheduler/Worker 应用。"
+  ],
+  "upgradeSteps": [
+    "升级配套平台并核对 data.service-mutations 1.0.0 与完整配置 validatorDigest。",
+    "将工作区所有 OpenXiangda 包升级到同一胶囊版本2.62.0并安装锁文件依赖。",
+    "事件订阅和机器操作显式声明 dataMutations；后台动作按需显式加 allowRuntimeWorker:true，保持原业务幂等键和各行CAS。",
+    "机器请求调用 transactionFromServiceAction；Worker 用 withWorkerAction 包裹现有服务；真实测试环境分别验收事件、回调、补偿和50条整事务回滚。"
+  ],
+  "knownLimitations": [
+    "字段授权不替代外部供应商验签、业务状态守卫、底稿摘要或当前用户成员权限；role-member/actor-authority仍由用户动作拥有。",
+    "机器入口使用已有短期网关invocation的有效期；过期结果按原业务号核对，通过活动租约补偿，不延长或伪造证明。",
+    "Native事务自身总操作/字段/字节限额仍生效，本文档的maxOperations是单资源额外上限。",
+    "生产晋级仍须实际业务验收，不能将包测试或Pod Ready视作签署、通知或财务验收。"
+  ],
+  "compatibility": {
+    "generation": "v2",
+    "node": ">=24",
+    "platform": "data.service-mutations 1.0.0 and exact configuration validator",
+    "v1": "独立1.x维护包不变"
+  },
+  "issues": [],
+  "sha256": "c547759f4a202325b30134e2db40f2bc9bdd05b74fc4da393acd46c2802832a5",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.62.0"
+}

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

package/skills/openxiangda-v2/SKILL.md

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

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

@@ -622,3 +622,23 @@ CAS与写后范围检查同事务执行。应用仍负责业务规则和字典gu
 没有新增独立的部门可见范围策略。任何部门不存在或已删除时，整组失败，不按姓名匹配，
 不接受客户端标签，也不回退到应用内复制的组织表。`snapshotRevision` 描述返回事实，
 `resolvedAt` 来自数据库时间；快照不能替代后续业务事务的权限检查。
+
+## action-owned 资源的受控事件与机器回调事务
+
+声明 `platformAccess.dataMutations`，把资源、操作、字段和单事务数量上限固定到事件订阅或机器操作：
+
+```ts
+platformAccess: { dataMutations: [
+  { resourceCode: 'contracts', operations: ['update'], fieldCodes: ['status', 'signingStatus'], maxOperations: 1 },
+  { resourceCode: 'performance-plans', operations: ['update'], fieldCodes: ['planDate', 'status'], maxOperations: 50 },
+] }
+```
+
+该能力要求平台 `data.service-mutations` 1.0.0。受验证的 `@OpenXiangdaEventHandler` 内继续使用 `OpenXiangdaApplicationDataApiService.transaction`；SDK 自动携带事件来源，平台在同一事务锁定原投递与 processing receipt 的有效租约，并解析当前不可变订阅声明。
+
+机器回调在 `@OpenXiangdaOperation` 已验证请求内使用 `applicationData.transactionFromServiceAction(request, transaction)`。`request` 必须是平台已验证的 service 具名操作上下文；平台独立验证原始短期网关 invocation、机器的操作 capability 和当前部署，同时仍验证运行凭据。用户/developer、裸 OAuth data:write 和调用方填写的 operation/source 对象不能替代此证明。
+
+字段、资源、操作或数量超出声明时整事务拒绝；CAS、原幂等键、额度终态与文件绑定校验继续生效。不分批提交 50 个节点，不绕过 Native owner 门禁，不把 JWT/租约 nonce 保存到业务表。role-member/actor-authority 仍需要真实用户动作，服务源不冒充用户成员。声明相同原事件在新的有效投递租约下可按原键重试；证明不能离开处理器执行使用。
+
+可信 Scheduler/补偿 Worker：给可供后台执行的同一具名操作 `dataMutations` 条目加 `allowRuntimeWorker: true`，并使用
+`await applicationData.withWorkerAction('callback-operation-code', () => callbackService.handle(originalInput))`。此作用域中的 `.transaction()` 自动携带当前 RuntimeLeaseService 的持有者与租约证明；平台在原事务锁定当前运行凭据、部署/Head 和该后台租约，并逐资源拒绝没有该 opt-in 的条目。无需 HTTP 请求或用户身份；没有活动租约、普通 OAuth 或已过期/被替代的实例仍被拒绝。该作用域可调用现有 CallbackService、DueSweep 等服务，整批操作同事务，保持原业务幂等键。

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

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

package/skills/openxiangda-v2/references/workflow-events.md

@@ -1210,3 +1210,5 @@ subject update和来源guards提交实际改变的派生字段；普通补填仍
 缺少规则、返回 `undefined` 或回调失败均保持原显示。PC/手机共用这一规则，
 最后一个字段被省略后对应空分组也消失。这是同步展示扩展，不发请求、不写数据，
 不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。
+
+`commandHandlers.resubmit` 仅绑定固定 correction 节点的业务重校验。普通 `return_review` 任务继续由 Kernel 标准 `resubmit` 办理：Surface 不返回 correction operationCode，审批人不需要起草提交 capability。无需增加 `taskKinds` 字段、改动已有定义版本或重建在途实例；直接对普通退回任务调用 correction 业务动作仍被拒绝。