openxiangda 2.59.5 → 2.60.0

package/releases/2.20.3.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.20.3",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.20.3：标准日期时间选择修复",
+  "summary": "修复指定时区的 PC 标准日期时间控件缺少小时和分钟列的问题，普通字段、生成表单、筛选与范围共用修复，不改变 UTC 存储和移动端协议。",
+  "newFeatures": [],
+  "fixes": [
+    "分钟精度显式显示时、分列，秒精度显式显示时、分、秒列。CLI 新应用模板同步钉扎修复后的根包。"
+  ],
+  "affectedUsers": [
+    "使用 Field Kit 指定时区日期时间输入的 OpenXiangda 2.0 应用。"
+  ],
+  "upgradeSteps": [
+    "将应用精确依赖升级到 openxiangda 2.20.3，按锁文件安装并验证日期选择后发布预发布版本。"
+  ],
+  "knownLimitations": [
+    "服务端业务时间窗、权限、DST 不存在和重复墙上时间校验保持原约束。本修复不替代应用真实角色验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无需服务端或数据库迁移。",
+    "v1": "V1 工作区与维护引擎不受影响。"
+  },
+  "sha256": "bd5d7d513df7ccc123d949842a5a987e585002848e98d52569190a687b212464",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.3"
+}

package/releases/2.20.4.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.20.4",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.20.4：Native 事件审计来源契约修复",
+  "summary": "严格接收平台已有的 Native 数据事件操作来源审计信息，避免具名业务动作和封存数据修复事件在处理器执行前被错误拒绝。",
+  "newFeatures": [],
+  "fixes": [
+    "Native 事件 actor 显式支持有界 initiatedBy、businessAction 和 platformMaintenance；未知字段、凭据形字段和错误签名仍严格拒绝。"
+  ],
+  "affectedUsers": [
+    "使用 Nest 订阅具名业务动作或封存数据修复所产生 Native 数据事件的 OpenXiangda 2.0 应用。"
+  ],
+  "upgradeSteps": [
+    "将应用精确依赖升级到 openxiangda 2.20.4，按锁文件安装并刷新工作区技能，验证后部署测试环境。",
+    "需要恢复的既有失败事件应核对原投递后使用正式 replay API，不重复提交业务动作。"
+  ],
+  "knownLimitations": [
+    "本修复不自动重放历史死信，也不替代应用真实角色、通知幂等和业务结果验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "匹配现有平台 Native 事件生产者，无需服务端或数据库迁移。",
+    "v1": "V1 工作区与维护引擎不受影响。"
+  },
+  "sha256": "b797b6e42ef1b54c312f40b14ecaea7064be9799d98bc9b200ed7dd88936e821",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.4"
+}

package/releases/2.31.5.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.5",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.5：应用 Agent 自定义卡片",
+  "summary": "应用可以把填写卡和结果卡的自定义脚本随同一发布版本交付，由平台在隔离卡片 Host 中展示。",
+  "newFeatures": [
+    "ai.agent.inputCard 和 resultCard 可声明受限的 agent-cards/*.js 资源；发布时核验脚本进入同一前端制品。",
+    "openxiangda/agent-card SDK 提供状态接收、只读选项查询、固定任务提交和尺寸同步；中文开发资料与 Skill 给出构建和验收示例。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要在平台业务 Agent 中展示应用自有填写或结果布局的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda 并更新锁文件；保留标准 inputCard/resultCard 字段声明作为资源失败时的回退。",
+    "将使用 SDK 的卡片构建为单文件 IIFE 放入前端 dist/agent-cards/，配置对应 resource，然后运行 check 与预发 deploy。",
+    "确认平台已发布配套 Agent 卡片资源端点与隔离 Host；在预发验证歧义选择、刷新、重复提交、权限拒绝与业务回读。"
+  ],
+  "knownLimitations": [
+    "首版消息桥是平台限定协议，不宣称与官方 MCP Apps 线级兼容；卡片只支持已声明的选项查询和固定提交。",
+    "结果卡只收到已声明的标量字段；复杂列表、附件和额外工具调用仍需后续独立契约。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "自定义卡片需要配套 Agent Center 资源解析服务和无同源 iframe Host。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "b674dd23dcb5fc9e00a7af758f01291295c78b8b6756b43d5f678ba79e4df345",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.5"
+}

package/releases/{2.59.4.json → 2.59.3.json}

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.59.4",
+  "version": "2.59.3",
   "status": "reviewed",
   "title": "开发者AI应用自助操作与主线工具组合",
   "summary": "让AI沿用当前应用权限直接诊断事件、复用加密环境凭据、配置通知和恢复指定投递；发行同源主线已评审的流程及编译契约。",
@@ -12,9 +12,7 @@
   "fixes": [
     "当前能力目录完整合法闭包不再受旧64项上限误拒绝；未知代码、重复项及制品绑定仍拒绝。",
     "补正可编辑未参与流转事实投影的一层owned子表；固定子表条件隐藏采用当前表单值。",
-    "流程画布就绪后才开放导航，用户导航不再被迟到初始化覆盖；大型AppSpec支持512文件并保留原字节界限。",
-    "流程提交遵循当前声明的隐藏字段保留或清空策略，并保留提交字段白名单。",
-    "冻结发行允许权威主线后续前进；源提交必须仍在主线，制品及参考应用证据必须保持原样。"
+    "流程画布就绪后才开放导航，用户导航不再被迟到初始化覆盖；大型AppSpec支持512文件并保留原字节界限。"
   ],
   "affectedUsers": [
     "使用V2开发者CLI/MCP进行应用运维，或使用本批流程/编译增强的应用。稳定V1独立维护。"
@@ -33,6 +31,6 @@
     "platform": "共享纯校验器同源配对；新增角色选人声明要求workflow.role-input-selection@1.0.0",
     "v1": "V1不消费本批V2契约或运行时"
   },
-  "sha256": "24320b39c5220c3acaf513b68532629801d3fc90f70f65659efcc69e1c7d616c",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.4"
+  "sha256": "b09fb5780d5ceea6c72a61c174952039396debc774d9b4249aef79794308bb72",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.3"
 }

package/releases/2.60.0.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.60.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.60.0：OSS 应用制品直传",
+  "summary": "开发工具可使用平台已配置的阿里云 OSS 直接上传应用构建包及镜像分块，服务器校验后按原摘要和进度导入，减轻客户 VPN 的大文件传输压力。",
+  "newFeatures": [
+    "新增独立 artifact-transfer/v1 能力协商，平台启用后自动使用限时、精确对象范围的签名直传。",
+    "镜像沿用原 OCI 摘要、预算、断点及受管仓库，已有 Registry 层在直传前复用。",
+    "平台存储设置支持前端 OSS/CDN 静态分发；登录、HTML 及 API 入口保持平台地址。"
+  ],
+  "fixes": [
+    "同时收录本次物化前主线已有 Changeset：按真实构建输入复用后端镜像、HTTP 环境浏览器 SHA-256、较大声明的有界容量协商。",
+    "收录主线已有标准流程页面整理、补正派生事实、补填值联动、日期辅助、提交后导航及子表展示修正。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda V2 发布应用且平台已配置 OSS 的开发者与管理员。"
+  ],
+  "upgradeSteps": [
+    "按平台正式升级入口部署配套服务器和管理界面。",
+    "将项目 openxiangda 升至 2.60.0，按锁文件安装依赖并刷新项目同版本资料。",
+    "管理员按需启用存储设置中的开发工具直传及静态分发，核验 GET/HEAD CORS 和目录权限。"
+  ],
+  "knownLimitations": [
+    "首轮仅支持阿里云 OSS；COS、MinIO、旧平台及关闭开关的站点保留原通道。",
+    "OSS 分发不等于 CDN 加速；CDN 域名需要独立配置，实际性能以部署样本为准。",
+    "暂存目录建议由管理员配置 1 天生命周期，平台不会覆盖整桶生命周期或 ACL。",
+    "本次以官方 Changeset 物化主线待发包内容，未新实现上述既有流程改动；所有版本与共享编译器需按平台组合配对。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "配套平台 artifact-transfer/v1 可选接口；应用/编译器契约不变",
+    "v1": "V1不消费新增 OSS 制品传输协议。"
+  },
+  "issues": [],
+  "sha256": "1becf5ff798495bf650c87783f0714ccaa1f5dd2d1edab1b93eccfdfbea6edde",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.60.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": "aa8ff464d2919e6ab9ad31d316255b2fe8ad07b0bcec8dcb1f19a7dcbad0fcbf"
+      "sha256": "6707f3d401dda7e99ac0aa6fcad2b2fb106017a3821c974620150bacfa6ee5ee"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

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

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

@@ -114,7 +114,7 @@ jointReviewers: {
 管理员仅在代码开放人员来源配置的节点中调整职责组合；单选仍保存 `roleCode`，
 多选保存 `roleCodes`。保存、版本激活均检查所有职责，任何职责失效或查询失败都不能
 变成部分名单。总候选最多 200 个成员身份；去重后的审批上限仍受原 binding 限制，
-自动抄送最多 20 人。声明自动协商 `workflow.role-union@1.0.0`，无需初始化开关。
+自动抄送遵守原binding人数预算，默认20、显式最大200人。声明自动协商 `workflow.role-union@1.0.0`，无需初始化开关。
 
 管理范围检索使用 `listRoleManagementScopeValues(dimensionCode, { keyword, limit, offset })`，返回 `NativeRoleManagementScopeValuePage` 的 `id/label` 与 `limit/offset`。它使用 `openxiangda.native-role-management-scope-value-page/v2`，与 Data 字段选择器的 `value/label/cursor` 协议分开。权限仍要求对成员的分配或更新能力；只读权限不因此扩张。
 
@@ -202,7 +202,7 @@ export function ReadableWorkflow({ workflowCode, version }: {
 
 模式为 `single/any/all/sequence` 的允许子集；可维护来源限 `fixed_users/app_role/app_role_in_scope`，范围角色必须已有代码声明的 scope。按钮 code 保持同意、拒绝、退回、转交、委托、加签的稳定语义；同意和拒绝不能关闭。只有同意/拒绝支持意见规则；拒绝默认必填，固定节点代码可用 operationPolicy.reject.commentRequired: false 显式选填。管理员可收紧选填规则，也可恢复代码明确允许的选填；不能放宽代码必填或未声明时的拒绝默认必填。已进入的任务保留冻结规则。字段显隐、填写与必填行为由应用页面和代码维护，不提供流程节点的字段管理覆盖。可编译声明见 `examples/workflow-administration/declaration.ts`。
 
-自动抄送节点仅开放名称、说明和显式声明的 `administration.assigneeProviders`；未开放时接收来源只读。共享编辑器显示“抄送人”，不显示审批方式或审批按钮，固定名单最多20人。`next`、空人策略和通知策略仍归代码；新配置只影响以后进入，过去抄送名单保持冻结。完整例子见 `examples/workflow-administration/automatic-cc.ts`，执行及读取边界见[自动抄送](workflow-events.md#automatic-cc)。
+自动抄送节点仅开放名称、说明和显式声明的 `administration.assigneeProviders`；未开放时接收来源只读。共享编辑器显示“抄送人”，不显示审批方式或审批按钮，固定名单遵守原binding的 `min/max`，默认1–20、显式最大200人；管理员不能扩大该预算。`next`、空人策略和通知策略仍归代码；新配置只影响以后进入，过去抄送名单保持冻结。完整例子见 `examples/workflow-administration/automatic-cc.ts`，执行及读取边界见[自动抄送](workflow-events.md#automatic-cc)。
 
 应用自定义管理页可使用 `WorkflowNodeConfigurationEditor`（`openxiangda/react`），输入同一读面中的节点、principals 和 context.headRevision，放在平台 App/UI 作用域内。它复用下列当前用户 SDK：
 

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

@@ -16,6 +16,19 @@ operation、事件消费者、人员提供器，然后运行 `pnpm openxiangda c
 工具从当前版本的内置模板初始化后端源码并安装依赖；后续不会覆盖业务代码。
 标准表单、流程定义/激活和平台待办通知使用平台运行时，不会隐式启用 Nest。
 
+当前官方 Dockerfile 保留原 package.json，使用 `--frozen-lockfile` 安装后端和共享契约
+依赖；锁文件与源码不一致会明确失败，请在本地更新并提交锁文件。pnpm store、registry
+metadata 与 Corepack 使用当前 BuildKit builder 的持久缓存，依赖层失效时优先复用已有包。
+生产依赖整理也使用同一包和 metadata 缓存及 `--prefer-offline`；首次 legacy deploy
+仍需读取 registry metadata，缓存命中后减少重复联网。首次构建或 builder 缓存被回收后
+仍需要下载依赖。不要求应用更改本地 workspace 链接方式。
+
+随模板生成的 `Dockerfile.dockerignore` 仅包含后端必需输入，避免前端/文档变化使
+依赖层失效。已有后端源码归应用所有，不自动覆盖旧 Dockerfile；升级时可对照
+工具包 `openxiangda-devkit-core/templates/backend/` 更新 Dockerfile 和专用 ignore，
+并保留自己的业务构建步骤及依赖。需要额外目录时同步加入 ignore 白名单，重新验证。
+纯前端发布的镜像复用与重建选项见[交付](delivery.md#测试部署)。
+
 依赖安装失败会保留新源码并报告 `OPENXIANGDA_BACKEND_INSTALL_FAILED`；重试相同命令
 即可继续。关闭 backend 不自动删除用户源码。仅删除已经确认不用的后端目录和其依赖。
 开发者本地 `/api` 经过 connected proxy 进入 Nest；普通浏览器身份经过平台实时授权，
@@ -91,6 +104,14 @@ return businessProcess.commandWithData({
 `not_observed` 仅表示尚未看到确定回执；保留原输入、原 token 和原键，按用户显式操作恢复。
 声明及限制见[工作流](workflow-events.md#correction-business-command)。
 
+更正指导老师、申报部门或预约场馆时，可在固定resubmit handler声明
+`derivedSubjectFields`白名单。处理器恢复原结果后，按当前可信字典和资料计算实际
+改变的字段，将它们与非事实审计值放入同一次subject update并携带来源guards；
+用户输入不能直接提供派生审批人，页面仍只提交原补正表单。平台从权威Native记录
+重读事实，与任务、数据和回执同事务更新；无法安全重放、来源/CAS或类型变化整笔
+回滚。未变化字段省略，确保已固定的无此声明旧实例仍可做普通更正。完整限制与
+自动能力协商见上述工作流专题，不另建重算API、事务或权限状态。
+
 ### 数据修改的原结果恢复 {#data-business-commands}
 
 仅修改业务资料的具名动作，在 `platformAccess` 声明

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

@@ -46,7 +46,26 @@ pnpm openxiangda logs <deployment-id> --json
 
 默认目标为 `test`，平台内部标识为 `preproduction`。只读预览不生成构建产物、不上传制品、不提交 DeploymentRun；因此预览成功不能证明代码已通过检查。正式检查使用本地完整校验，再通过目标平台的 `configurationCompatibility` 核对同源规则、密钥、已有物理模型和登录提供方等只读条件；失败时停止后续步骤。只有启用了自定义 Nest 后端的应用才需要构建后端镜像及对应 Docker 环境。
 
-平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
+平台启用镜像上传后，`deploy` 优先校验本机保存的同输入 OCI 制品，并用当前平台登录态取得原镜像的回执；没有有效制品时才用 Docker Buildx 构建并分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
+
+官方模板按实际后端输入匹配缓存：根 manifest、锁文件、workspace/tsconfig、后端目录、
+共享 contracts、vendor、Dockerfile 和有效 ignore 规则。只改前端源码或文档时可跳过
+Docker 构建，前端及配置仍重新检查、编译和发布。独立配置摘要变化不会直接使镜像失效；
+配置改变生成 contracts 时会重建。缓存只绑定当前账号、平台、应用、环境和工具版本，
+不会跨身份复用。自定义 Dockerfile 默认比较完整构建上下文；用
+`<后端目录>/Dockerfile.dockerignore` 明确限制实际 Docker 输入后，也可复用同输入制品。
+修改 Dockerfile 后不再推测其 shell 命令只读取哪些文件。
+
+成功镜像同样短期保留，不保存远端 ready 状态或 reference；每次复用都校验全部 OCI
+字节并由平台重新鉴权。平台没有原镜像时上传同一制品，不重新构建。缓存过期或被回收
+后需正常构建。需要重新执行本机构建时可用：
+
+```bash
+OPENXIANGDA_BACKEND_IMAGE_CACHE=false pnpm openxiangda deploy
+```
+
+此设置禁用成功制品复用和保留，仍恢复同输入的未完成上传；Docker 自身的层缓存继续
+生效。它不跳过检查、权限或平台回执。无需为普通前端改动手工指定旧镜像或平台管理员介入。
 
 上传失败后，本机保留原 OCI 制品，错误的 `details` 包含候选 ID、原 digest、失效时间及真实 `causeCode`。
 按错误的 `remediation` 处理后，在原工作区执行原 `pnpm openxiangda deploy` 命令（保留原环境等参数）：
@@ -63,6 +82,8 @@ pnpm openxiangda logs <deployment-id> --json
 
 缓存保留最多 24 小时、8 个候选、总预算 8 GiB；空间不足时仅回收未被使用的旧候选。
 仅当平台单镜像上限不超过 8 GiB 时启用本地恢复，较大的平台配额保留原上传路径，不降低平台允许的镜像大小。
+成功制品复用额外预留最多 516 KiB 的 OCI/缓存元数据；平台上限过于接近 8 GiB 时保留
+原上传失败恢复模式，成功后删除，不降低平台单镜像额度。
 缓存和登录凭据分开，位于本机用户私有目录。过期或已经回收的候选需重新构建；已有 DeploymentRun
 的未知结果仍查询原运行，镜像上传恢复不会重新发起已提交的部署。
 
@@ -76,7 +97,7 @@ pnpm openxiangda status <deployment-id> --watch
 
 网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
 
-新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
+新的发布使用当前源码准备前端与配置，后端按实际输入复用或构建；同输入镜像可复用上述短期原制品缓存。
 该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
 
 ## 测试环境验收
@@ -156,3 +177,11 @@ MCP 的 check_app、deployment_plan、deploy_app 使用与 CLI 相同的环境
 先运行 `openxiangda deploy --environment test --strategy maintenance-replace --dry-run --json` 查看前驱版本、Head revision 和停止后的容量估算，再使用相同参数去掉 `--dry-run` 提交。计划不预留资源。只有已存在、身份匹配的单副本 TEST 后端才可使用；前端应用、新应用和 production 不支持。默认仍为 rolling，不会因配额不足自动停止实例。
 
 策略属于部署幂等请求。默认维护幂等键含策略，显式幂等键不能在不同策略之间复用。已有运行通过 status/retry 恢复；持续恢复中的运行保持 preparing/maintenance-recovery-required，平台会重试恢复，恢复失败时保留原运行与错误。
+
+## OSS 直传与静态分发
+
+平台管理员在「平台内置对象存储 → 应用构建与分发」启用「开发工具直传 OSS」后，新版 CLI 自动协商并直传构建包和镜像分块。开发者无需本机 OSS 密钥；平台从自己的存储读取，校验大小及摘要后封存或导入受管镜像仓库。中断后重新运行原 deploy，仍按原 digest/offset 恢复，不手工创建新镜像尝试。旧平台没有此能力时保持原通道；云端失败明确报告，不静默改用另一通道。
+
+「前端静态资源 → OSS / CDN」让 JS、CSS、字体等从 OSS 的不可变版本目录加载。HTML、登录、路由和 API 保留平台入口。Public Base URL 可配置已可用的 HTTPS CDN 域名；未配 CDN 时是 OSS 分发，不能据此承诺 CDN 加速。OSS GET/HEAD 的 CORS 需包含实际平台 origin。源码映射不公开。
+
+存储权限需覆盖隔离目录的 PutObject、GetObject、对象 ACL（暂存 private，校验后的静态资源 public-read）。不得更改整桶 ACL。建议为 `openxiangda/application-staging/` 配置 1 天生命周期；平台不自动覆盖现有生命周期。配置切换发生在直传和导入之间会明确拒绝，重新运行原部署即可按新配置恢复。关闭直传/切回平台静态分发可回退，不修改业务数据或环境版本。

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

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

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

@@ -1,3 +1,14 @@
+# 标准审批页面的值联动
+
+应用可给 `OpenXiangdaApplication` 传入 `workflowTaskForms`，按流程代码注册同步
+`valueLinkage(changed, values, { workflowCode, nodeId, pageCode })`。例如会议日期变化
+时生成可编辑意见。日期等输入已规范化为平台值；只响应用户修改，加载、草稿恢复和
+重读不会覆盖已有输入。独立手改意见是否保留由应用规则决定。
+
+回调只能读取和更新当前任务可见、可编辑的普通字段；子表、附件、只读、隐藏和
+未声明字段不参与。规则必须同步返回patch，不能发请求。规则失败保留输入并提示，
+整patch不会部分应用。保存、审批、CAS、权限、原命令恢复和固定流程仍由平台拥有。
+
 # Workflow 与 Notification Hub 2.0 边界
 
 标准 Workflow 与 Notification Hub 已作为 OpenXiangda 2.0 可选平台模块重新开放。它们不属于默认 CRUD 模板，也不兼容或复用 1.x 工作流、消息中心、模板、卡片、回调、表和 API。
@@ -238,7 +249,8 @@ copy: {
 接收 binding 支持 `fixed_users`、`initiator`、`input_users`、`form_field_users`、
 `app_role`、`app_role_in_scope`、`previous_node_actor`。仅使用事务内原生来源，
 不支持 `application_provider` 或需要申请人交互的 `initiator_select`。名单按用户去重，
-每次进入最多 20 人；`min/max` 默认 1/20，非空名单仍必须符合声明的下限。
+每次进入最多 200 人；`min/max` 默认 1/20，超过20人须由开发者显式声明更大的 `max`。
+未声明及既有显式20人预算保持；非空名单仍必须符合声明的下限。
 角色查询超过 200 条有效成员行时明确拒绝，不能使用截断后的名单。
 范围角色要求对应范围的 `cc` 授权（或未限制操作、`*`），仅 `approve` 不满足。
 抄送不套用审批代理。
@@ -350,7 +362,7 @@ Native Data 事件的 capture plan 由当前 Head 的 Event、Data、AuthZ revis
 `acceptedCommandDeactivationPolicy`：`finish-pinned` 让已接受的 durable process
 command 按固定版本完成，`cancel-on-deactivate` 在声明删除后取消尚未启动的命令；
 既有 Workflow instance 始终按固定版本继续。审批人 Provider 的 `min/max`
-默认 1/200，最大 200；自动抄送默认 1/20，最大 20。
+默认 1/200，最大 200；自动抄送默认 1/20，显式声明最大 200。
 需要按流程实例串行投递时只声明 `ordering: 'workflow-instance'`，不接受下划线别名。
 
 平台按 desired set 直接覆盖环境 Head，不做版本比较。因此 `openxiangda deploy`
@@ -947,7 +959,14 @@ append 处理签名或 HTML。当前任务、实例、记录或字段改变时
 
 ### 审批人为空时的节点策略
 
-审批节点可声明 `emptyPolicy: 'skip'`，省略或声明 `block` 时保持阻塞。第一版 skip 支持 fixed_users、input_users、form_field_users、app_role、app_role_in_scope；编译器拒绝其他来源与 skip 组合。表单人员明确为 `[]`，或存在的角色在有效范围内没有成员，且解析成功、没有警告，才允许自动继续到 `onApprove`。缺失/null 字段、不存在的角色、无效账号、缺少范围、解析失败和非零人数不满足 min/max 都不能跳过。
+审批节点可声明 `emptyPolicy: 'skip'`，省略或声明 `block` 时保持阻塞。第一版 skip 支持 fixed_users、input_users、form_field_users、app_role、app_role_in_scope；编译器拒绝其他来源与 skip 组合。表单人员明确为 `[]`，或存在的角色在有效范围内没有成员，且解析成功、没有警告，才允许自动继续到 `onApprove`。
+
+`form_field_users` 也支持主体投影的可选单人为空：固定 Native 主体的
+`factProjection` 必须准确指向非必填 `user.single`，并且保存值明确为 `null`。
+平台核验主体、定义与资料修订后，仅在审批空人策略解析中把该值视为已核实空名单；
+限定候选仍核验当前范围与授权。此规则不增加开关，也不改变节点的 skip/block/兜底策略。
+字段缺失、必填人员为 null、无主体或无准确投影、类型错误、无效账号、缺少范围、
+解析失败和非零人数不满足 min/max 都不能跳过；普通选人及 `input_users` 不接受 null。
 
 该策略由代码固定。每次实际跳过记录节点访问、当时配置、解析依据和 `openxiangda.workflow.node.skipped.v2` 事件；图和 PC/手机历史显示“已跳过”。连续节点推进受 200 节点上限约束，业务步骤仍等待其正式结果。后续失败与业务变更在原事务一起回滚，重试沿用原命令。
 
@@ -1117,10 +1136,25 @@ nodes: {
 
 标准 PC/手机任务页根据当前 Surface 调用该具名操作；应用不复制审批流转或预测下游
 动态人员。处理器先调用 `businessProcess.resolveOriginalTaskCommand(invocation)` 查询原结果，
+具名批准需要业务派生值与任务表单同事务保存时，可在固定定义声明
+`commandHandlers.approve: { operationCode: '...', transitionPolicy: 'workflow' }`，
+并调用 `commandWithData` 的 `expectedTransition: { kind: 'approval-projection' }`。
+平台核验原任务／令牌／修订／字段和候选人，保存数据并刷新事实，由内核处理
+会签等待及晚分支；任何未解析审批人都使事务失败。只允许显式 opt-in 的 approve
+handler；默认精确流转模式不变，旧站点须支持 `workflow.approval-business-command`。
+
 再合并受限任务字段、重验当前业务规则和资料，最后调用 `commandWithData`，
 使用 `expectedTransition: { kind: 'correction-replay' }`。平台验证真实本人补正、原任务与
 资料修订，在同一事务保存字段、刷新事实、核验 Native guards、关闭退回会话并重新计算。
-业务 mutation 仅写非事实的可信快照或审计字段，不能直接改变 `factProjection` 字段。
+业务 mutation 默认只写非事实的可信快照或审计字段。指导老师、部门或场馆等来源更正
+需要重算审批事实时，在固定`commandHandlers.resubmit`声明
+`derivedSubjectFields: ['instructorPerson']`：最多32个唯一、实际投影的顶层非system
+字段，且所有任务页面都不能将其设为可编辑。应用从当前可信来源重新计算，用原
+subject update和来源guards提交实际改变的派生字段；普通补填仍放在原任务表单。
+平台权威重读后原子刷新事实、修订和摘要，验证失效代码步骤能沿固定路径重放。
+其他事实与身份保持原保护，不允许在approve/reject/withdraw复用此权限。自动要求
+`workflow.correction-derived-subject-facts@1.0.0`，旧平台会拒绝新增声明，无额外开关。
+原实例继续固定旧定义；未改变的派生字段不回写，无声明时不能更换派生审批事实。
 
 `save_form` 仍可保存未填完的资料；只有通过业务重校验才能重提。直接调用原 Workflow
 重提入口会被拒绝，管理员不能替原发起人绕过该处理器。仅声明 resubmit 的流程可保留
@@ -1143,3 +1177,15 @@ nodes: {
 只需重核自身业务不变量，不能另写一次子行。投影为流程事实的子表暂不支持此
 补正形式，仍返回 `WORKFLOW_CORRECTION_OWNED_FACTS_UNSUPPORTED`；不能通过
 移除真实流转事实来绕过。原返回、重走首节点、职责和原命令恢复规则保持。
+
+具名新建的 owned 子表可以用 `formOptions.subtableFieldState(values)` 返回按子表字段
+和子列编码的 `{ visible, required }`，例如 `{ relatives: { extraFact: { visible: false } } }`。
+状态只调整页面展示与可见输入校验，不改变流程、读写授权或子表数据；隐藏旧值会保留，
+重新显示后恢复。列必须已在具名操作的 sealed child closure 内，未知表/列与非布尔状态
+拒绝；`required: false` 不能撤销声明的必填，服务端业务仍独立验证实际提交值。
+
+生成提交页的 `formOptions.dateTimeConstraints` 可按已匹配的 `datetime` 或
+`datetime-range` 字段提供 `timeZone`、范围、步长和 `disabledWeekdays`（ISO周一1
+至周日7）。这只控制新选择，保留已有值，不能当成服务端提交门禁。
+`formOptions.fieldHints(values)` 返回按已匹配字段的提示内容，用于时段或业务说明，
+它不改变必填和数据；PC/手机均显示在字段旁。未知字段和无效约束阻止新表单。

package/releases/2.59.5.json

@@ -1,40 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.59.5",
-  "status": "reviewed",
-  "title": "开发者AI应用自助操作与主线工具组合",
-  "summary": "让AI沿用当前应用权限直接诊断事件、复用加密环境凭据、配置通知和恢复指定投递；发行同源主线已评审的流程及编译契约。",
-  "newFeatures": [
-    "admin operations和MCP application_operations发现20项有界操作；admin execute及application_operation直接执行，必须明确环境，密钥仅返回元信息。",
-    "角色审批可按固定代码步骤或事实的选人结果取当前有效角色候选；平台必须提供workflow.role-input-selection能力，缺失时拒绝新声明。",
-    "流程表单支持已加载固定子表行及按原Native资源授权读取材料；流程图支持展开已声明代码逻辑说明。"
-  ],
-  "fixes": [
-    "当前能力目录完整合法闭包不再受旧64项上限误拒绝；未知代码、重复项及制品绑定仍拒绝。",
-    "补正可编辑未参与流转事实投影的一层owned子表；固定子表条件隐藏采用当前表单值。",
-    "流程画布就绪后才开放导航，用户导航不再被迟到初始化覆盖；大型AppSpec支持512文件并保留原字节界限。",
-    "流程提交遵循当前声明的隐藏字段保留或清空策略，并保留提交字段白名单。",
-    "冻结发行允许权威主线后续前进；源提交必须仍在主线，制品及参考应用证据必须保持原样。",
-    "流程变量叶路径继承已声明父变量的显示标签；路径、条件和单位事实保持。",
-    "冻结manifest在planned回执建立前即可验证主线祖先关系；缺失或损坏制品拒绝，实际验证门禁仍必需。"
-  ],
-  "affectedUsers": [
-    "使用V2开发者CLI/MCP进行应用运维，或使用本批流程/编译增强的应用。稳定V1独立维护。"
-  ],
-  "upgradeSteps": [
-    "精确更新完整工具组合，刷新工作区Skill和AGENTS平台区块并重启MCP。先读docs application-operations及admin operations --json。",
-    "共享校验器须与平台安装的openxiangda-contracts 2.71.1配对；已有生产应用保持原不可变版本，升级工具不代表重新部署业务。"
-  ],
-  "knownLimitations": [
-    "沿用当前应用管理授权；首次账号授权、权限委托和外部身份目录维护仍由原owner处理。旧平台缺少接口时明确拒绝，不使用SQL或保护绕过。",
-    "通道健康成功不证明实际老师收件或已读。恢复只处理指定原投递，不自动导入、重建业务、批量重发历史通知或读取密钥明文。"
-  ],
-  "issues": [],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "共享纯校验器同源配对；新增角色选人声明要求workflow.role-input-selection@1.0.0",
-    "v1": "V1不消费本批V2契约或运行时"
-  },
-  "sha256": "a50ff28ce680ae7ec080219eb0e010ba087b3915c65582a13578ba3b9a7833b7",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.5"
-}