openxiangda 2.48.2 → 2.59.1

package/releases/2.54.4.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.54.4",
+  "status": "reviewed",
+  "title": "原子业务审批的最终状态合同修正",
+  "summary": "同源SDK的审批事务守卫对齐Workflow实例实际的已通过、已拒绝状态，防止最终审批或驳回被错误阻断。",
+  "newFeatures": [],
+  "fixes": [
+    "expectedTransition.status使用running、approved、rejected、withdrawn；拒绝将任务completed状态当作实例状态。",
+    "Schema与公开TypeScript类型同步，补充四种实际状态与错误completed状态的回归验证。"
+  ],
+  "affectedUsers": [
+    "显式使用definition.commandHandlers及BusinessProcess.commandWithData的V2应用。"
+  ],
+  "upgradeSteps": [
+    "整体使用同源SDK发行，并配套接受实际实例状态的平台Server；在测试环境验证原token、回执、补填及业务效果的原子提交。"
+  ],
+  "knownLimitations": [
+    "这是本机测试候选，npm发布和真实三端业务验收分别记录，源码检查不代表完成交付。",
+    "固定handler仍仅支持approve、reject、withdraw；不降级为分离事务，也不支持跳转、强制决定或自动同意。",
+    "正式npm发行验证仍需配套参考应用锁文件；本机同源制品不替代该门禁。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "workflow.business-data-command@1.0.0，Server使用真实实例状态与同事务Native效果。"
+  },
+  "sha256": "245c53a18b1af890f22f38e5d0f75129e47aaae8898ae98844fa0ebd141ba48b",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.54.4"
+}

package/releases/2.54.6.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.54.6",
+  "status": "reviewed",
+  "title": "业务提交前检查必需审批人",
+  "summary": "流程可显式要求提交前解析指定审批节点。缺少当前有效审批人时，平台在业务事务内拒绝申请，避免保存后留下无法推进的流程。",
+  "newFeatures": [
+    "固定 definition.launchPreflight.requiredApprovalNodes 指定最多20个必需审批节点，两端编译器验证引用、范围和本机参与人来源。",
+    "BusinessProcess 同事务解析当前有效配置与 Native 角色成员；原成功提交回执优先返回，实际节点进入仍重新核验审批人。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要在保存申请时保证前置审批人存在的 V2 应用；仅显式声明时要求新平台能力。"
+  ],
+  "upgradeSteps": [
+    "完整升级同源SDK与支持 workflow.launch-preflight@1.0.0 的平台，然后为所需审批节点声明准入并验证当前角色范围。"
+  ],
+  "knownLimitations": [
+    "当前为本机开发候选，未发布 npm 或学校生产；工具检查、平台事务测试与真实应用角色验收分别记录。",
+    "仅支持 fixed_users、initiator、app_role、app_role_in_scope；未来任务字段、外部provider和交互选人不参与同步准入。",
+    "准入不冻结未来参与人，成功后人员改变仍由实际节点进入处理；正式 npm 发行门禁尚未完成。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "workflow.launch-preflight@1.0.0（显式声明才要求）"
+  },
+  "sha256": "ca379b1ab33ef8362ea34b9242cc30772caf30c0830f2a77fbd4dba1b17a6c21",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.54.6"
+}

package/releases/2.55.0.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.55.0",
+  "status": "reviewed",
+  "title": "流程拒绝意见策略与受限资料编辑",
+  "summary": "流程定义可显式允许选填拒绝意见，保留旧流程必填默认和管理员收紧边界；同步主线的具名资料编辑支持固定字段及受限输入。",
+  "newFeatures": [
+    "固定审批节点可声明 operationPolicy.reject.commentRequired:false；省略时仍必填，新声明要求 workflow.optional-rejection-comment@1.0.0。",
+    "具名资料编辑可声明固定资源和字段，复用受限人员、字典和托管附件输入，PC 与移动页共用 Field Kit。"
+  ],
+  "fixes": [
+    "审批节点 JSON Schema 接受并有界校验正式 operationPolicy，Surface 和执行端使用同一冻结策略。",
+    "主线修正 dataCommands 在开发配置和产物投影中的遗漏。"
+  ],
+  "affectedUsers": [
+    "需要保留选填拒绝意见语义的 V2 流程，或使用具名动作编辑固定资料字段的应用。"
+  ],
+  "upgradeSteps": [
+    "完整升级同源 SDK 与目标平台；选填拒绝意见须启用支持该能力的平台，并以新不可变流程版本声明。",
+    "已有任务继续使用进入节点时冻结的规则，管理员不得放宽代码必填策略。"
+  ],
+  "knownLimitations": [
+    "当前用于本机开发配套，不代表 npm 或学校生产已发布；真实应用验收单独记录。",
+    "选填仅允许省略、空串或空白；已提供的非字符串及超过 4000 字符仍拒绝。",
+    "具名资料编辑仍受动作能力、行范围和原修订校验约束，不开放普通 UPDATE。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "显式选填要求 workflow.optional-rejection-comment@1.0.0；具名资料编辑按声明要求匹配平台能力"
+  },
+  "sha256": "c48e83ce9ccb01af7e8af97458fee0fb192e0945fc6a596b985ed1fffaf876a0",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.55.0"
+}

package/releases/2.55.1.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.55.1",
+  "status": "reviewed",
+  "title": "持久原结果恢复与流程字段策略修复",
+  "summary": "已受理命令的短读取超时不会提前终止原三十分钟观察；同步主线的条件必填错误清理和冻结的选填撤回原因策略。",
+  "newFeatures": [
+    "固定流程定义支持 instanceCommands.withdraw.reasonRequired:false；省略仍必填，新声明要求 workflow.optional-withdrawal-reason@1.0.0。"
+  ],
+  "fixes": [
+    "已受理 durable 原结果查询收到 SDK 明确标记可恢复的短读取预算耗尽后，在原绝对截止前按退避继续只读查询；不重放提交。",
+    "另一字段解除条件必填后清除 SDK 自己生成的旧必填错误，保留其他客户端、子表和服务端错误。"
+  ],
+  "affectedUsers": [
+    "使用 durable 持久命令的热点报名应用和包含条件必填或撤回策略的 V2 流程。"
+  ],
+  "upgradeSteps": [
+    "使用正式精确版本升级应用 SDK；原结果恢复无需更改服务端协议。",
+    "使用选填撤回原因时，平台必须具备对应能力；已有实例继续使用冻结版本。"
+  ],
+  "knownLimitations": [
+    "一次读取仍最多两分钟，总观察仍为原三十分钟；权限、依赖和普通网络错误不会被自动隐藏。",
+    "容量必须在目标硬件上独立测量；单元验证不能证明万人或浏览器洪峰已通过。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "durable 恢复沿用既有结果协议；显式选填撤回原因要求 workflow.optional-withdrawal-reason@1.0.0"
+  },
+  "sha256": "c6c0691f9fe9571dfe1c9078546a5db3f63645ba11a67a3f3d0d6324ba7713d1",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.55.1"
+}

package/releases/2.55.5.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.55.5",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.55.5：具名业务与读取视角的边界",
+  "summary": "修复管理页面的读取 Perspective 被转发到受信业务 Data API 而导致合法业务提交拒绝的问题。",
+  "newFeatures": [],
+  "fixes": [
+    "Nest 具名业务 Data API 派生无读取视角的下游上下文，保留固定动作证明与原请求；普通 Data API 继续继承读取 Perspective。"
+  ],
+  "affectedUsers": [
+    "从已选择管理读取 Perspective 的页面调用 V2 Nest 具名业务动作的应用。"
+  ],
+  "upgradeSteps": [
+    "安装完整同源 SDK，执行应用 check，并分别验收合法提交、普通读取范围、当前成员事务守卫及原结果恢复。"
+  ],
+  "knownLimitations": [
+    "SDK HTTP 边界验收不代替真实角色和页面业务验收；本轮仅本机分发，不发布 npm。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "native-4；保持 Native 服务主体读取视角拒绝检查",
+    "v1": "V1 引擎与应用不变"
+  },
+  "issues": [
+    "PLT-033"
+  ],
+  "sha256": "d8174bbf5684326c34ac3f467a3e2fdc12ef00f101edf442008ee59519a41e2d",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.55.5"
+}

package/releases/2.55.6.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.55.6",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.55.6：入口排队与身份加载连续性",
+  "summary": "修复平台入口等待期限与浏览器身份读取恢复期限不一致导致有效等待过早中断的问题。",
+  "newFeatures": [],
+  "fixes": [
+    "仅对有效平台入口回执接续身份等待，固定原期限并上限三十分钟，后续回执只能缩短。",
+    "入口身份读取遵循有界排队提示，普通请求、权限拒绝、投影重试和网络失败保持各自边界。"
+  ],
+  "affectedUsers": [
+    "启用 V2 平台入口排队并在拥挤时加载当前用户信息的应用。"
+  ],
+  "upgradeSteps": [
+    "安装同源 SDK 并重新构建应用，验证权限拒绝、入口期限、页面取消、原报名结果恢复及真实冷入口并发。"
+  ],
+  "knownLimitations": [
+    "本地测试不代表线上容量；r62 的 48 人中断仍保留，必须使用新隔离活动重新压测。",
+    "本次 HTTP 请求图不证明完整 SSO 或浏览器渲染上限。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "V2 原入口回执协议；无数据库迁移",
+    "v1": "V1 引擎和应用不变"
+  },
+  "issues": [
+    "r62-entry-identity-interrupted"
+  ],
+  "sha256": "48803b23bb19feee37b60779064e03c2cb60c26a591f794755bcf4c2b5b887a7",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.55.6"
+}

package/releases/2.57.1.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.57.1",
+  "status": "reviewed",
+  "title": "身份入口暂不可用时保留固定恢复期限",
+  "summary": "启用入口等待的平台可声明有界读取恢复预算，SDK继续恢复身份而不刷新原截止。",
+  "newFeatures": [],
+  "fixes": [
+    "修复入口429 unavailable无票据剩余时间时回落普通五分钟恢复的问题。",
+    "后续票据回执只能缩短截止；保留权限拒绝、失效、取消及写操作约束。"
+  ],
+  "affectedUsers": [
+    "使用高并发入口等待与runtime身份读取的V2应用。"
+  ],
+  "upgradeSteps": [
+    "同时使用提供recoveryBudgetMs的Server及同源SDK；无该元数据时维持原五分钟恢复。",
+    "完整分发组合通过正式门禁后部署，保留原压测失败与期限。"
+  ],
+  "knownLimitations": [
+    "本批尚未完成公开npm发行和学校站点部署，源码测试不代表线上验收。",
+    "恢复预算只用于读取重试，不提供身份或队列位置，不延长Redis票据。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "native-4、可选入口unavailable recoveryBudgetMs",
+    "v1": "V1不消费该恢复接口"
+  },
+  "sha256": "d797d800560e8e24b276c6674fa2ea303f89b844cf1f5ee7b1199543180174c4",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.57.1"
+}

package/releases/2.58.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.58.0",
+  "status": "reviewed",
+  "title": "有界入口读取恢复与流程、开发配置能力更新",
+  "summary": "身份读取在原期限内恢复短暂网络失败；同时交付主线已合入的流程范围、主子事务和开发配置能力。",
+  "newFeatures": [
+    "具名流程支持保存前范围候选与一层 owned 主子创建闭包，仍由平台按实际资料及职责校验。",
+    "流程节点支持有界职责成员并集及可选操作原因，任务使用进入节点时冻结的规则。",
+    "显式 owned 子表支持最多500行及有界记录集合事务守卫，保留 CAS、字节与文件限额。",
+    "预发布开发配置可同步真实 Native 配置而不构建 Web/Nest 制品，不能晋级生产。",
+    "连接开发支持从源码接收有界后端事件交付，保留真实平台租约和确认边界。"
+  ],
+  "fixes": [
+    "身份 GET 不再因第三次短暂传输失败提前退出；采用有界指数退避，保留原恢复截止、单次超时、取消与明确权限拒绝。"
+  ],
+  "affectedUsers": [
+    "使用 V2 入口等待、具名流程、owned 子表或预发布开发配置的应用。"
+  ],
+  "upgradeSteps": [
+    "消费同源完整发行组合，并按声明协商目标平台能力。",
+    "入口预约、身份回执恢复和结果查询提示需配套平台更新；更新后重新校准真实页面请求图及性能测试。"
+  ],
+  "knownLimitations": [
+    "本轮尚未完成客户站点部署及新版本容量验收；源码验证不代表线上通过。",
+    "入口恢复仅重试读取，不自动重放报名等业务写操作，不续期原 Redis 票据。",
+    "此前8000人实验有7989人客户端30分钟内读回，最高完整通过仍5000人；实验不含SSO，不能代替首秒8000人完整浏览器容量结论。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "按声明协商对应 Native 与流程能力；入口恢复配套平台回执",
+    "v1": "V1不消费该V2接口"
+  },
+  "sha256": "ac8676f79afa9bc596508c7ca897ec60ffadf79f86ca36429dc1a279df23cf09",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.58.0"
+}

package/releases/2.58.1.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.58.1",
+  "status": "reviewed",
+  "title": "同源交付记录流程历史及入口读取恢复",
+  "summary": "根包和模板消费新增 Nest 记录流程历史接口，并保留2.58.0的入口读取恢复与能力更新。",
+  "newFeatures": [
+    "Nest 用户上下文支持业务记录流程历史读取，复用 Native/RLS、记录实例绑定、分页及修订校验。"
+  ],
+  "fixes": [
+    "统一根包、CLI模板与Nest的精确发行版本，避免混用新增接口和旧归档。"
+  ],
+  "affectedUsers": [
+    "使用 Nest 工作流记录历史或入口等待恢复的V2应用。"
+  ],
+  "upgradeSteps": [
+    "安装完整同源发行组合；入口预约与结果查询退避需要配套平台更新并重新校准请求图。"
+  ],
+  "knownLimitations": [
+    "2.58.0及本批尚未完成客户站点新候选容量验收；上一轮8000人仅7989人客户端30分钟内读回，最高完整通过仍5000人。",
+    "不改变流程办理权限，不自动重放业务写操作，不覆盖SSO集中登录容量。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "复用平台当前用户记录流程历史与V2入口能力",
+    "v1": "V1不消费该V2接口"
+  },
+  "sha256": "9e7fb09dc8b7a0de8fff5e955e7d35cb4d4d1ce1be5fa1105a5d2c2517de6414",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.58.1"
+}

package/releases/2.59.0.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.59.0",
+  "status": "reviewed",
+  "title": "托管查询断连恢复与流程表单能力更新",
+  "summary": "托管只读查询在认证传输层明确标记断连后沿原预算恢复；正式发行同时包含主线已评审的可选流程、子表及连接开发能力。",
+  "newFeatures": [
+    "流程支持发起人补正、具名业务补正命令、审批节点代理范围、批准后代理和原子Native阶段条件；新能力通过目标平台协商。",
+    "owned子表支持最少行数、可信初始流程事实、具名只读展示和任务字段来源；资源关联支持显式绑定变化清空。",
+    "日期字段支持分钟精度，日期事件支持可信来源投影；大型应用声明与JSON节点预算可显式协商扩展。",
+    "连接开发支持普通浏览器登录身份与平台可信后台调用；新增纯表达式入口供浏览器和Node共享流程表达式。"
+  ],
+  "fixes": [
+    "read、mine、result、allocation的已标记连接中断与繁忙共用固定预算、尝试上限、退避及取消边界；已受理观察继续原结果，不延长首次提交截止。",
+    "修复受控子表字段联动、审批已确认任务转交后的页面继续和普通浏览器业务API的CSRF传递。"
+  ],
+  "affectedUsers": [
+    "使用托管并发查询、标准流程表单、owned子表或普通角色连接开发的V2应用。"
+  ],
+  "upgradeSteps": [
+    "通过精确版本安装完整同源发行组合；启用新声明前核验目标平台能力。托管高并发应用需在真实浏览器与隔离压测中重新校准恢复行为。"
+  ],
+  "knownLimitations": [
+    "客户上一档万人HTTP请求图有29人结果观察被断连中断；后台全部终结但该档仍未完整通过。本版本的新万人复测尚未完成，既有最高完整通过为8000人HTTP请求图。",
+    "不自动重放业务写入，不将断连认定为已受理，不覆盖集中SSO登录或浏览器JS渲染容量；权限、依赖及未标记错误继续拒绝。",
+    "新增可选流程及普通角色源码调用需要配套平台能力；旧平台不能启用未支持的声明。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "托管断连恢复复用现有接口；新增声明按目标平台能力协商",
+    "v1": "V1不消费本批V2运行时能力"
+  },
+  "sha256": "7cdc36d28dc77f417b8bbbbdd8ab1fe0da4cdc3aead69c0b2ad6c87fdaae09bb",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.0"
+}

package/releases/2.59.1.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.59.1",
+  "status": "reviewed",
+  "title": "同源托管断连恢复与声明生成修复",
+  "summary": "发布同源托管只读断连恢复及主线已评审能力，并补齐大型资源类型生成和自动审批只读详情的修复。",
+  "newFeatures": [
+    "流程支持发起人补正、具名业务补正命令、审批节点代理范围、批准后代理和原子Native阶段条件；新能力通过目标平台协商。",
+    "owned子表支持最少行数、可信初始流程事实、具名只读展示和任务字段来源；资源关联支持显式绑定变化清空。",
+    "日期字段支持分钟精度，日期事件支持可信来源投影；大型应用声明与JSON节点预算可显式协商扩展。",
+    "连接开发支持普通浏览器登录身份与平台可信后台调用；新增纯表达式入口供浏览器和Node共享流程表达式。"
+  ],
+  "fixes": [
+    "read、mine、result、allocation的已标记连接中断与繁忙共用固定预算、尝试上限、退避及取消边界；已受理观察继续原结果，不延长首次提交截止。",
+    "修复受控子表字段联动、审批已确认任务转交后的页面继续和普通浏览器业务API的CSRF传递。",
+    "大型资源目录使用命名条目与精确只读类型，避免TypeScript序列化上限；自动发起人审批允许已解析的完全只读详情，保留可编辑席位人工办理。"
+  ],
+  "affectedUsers": [
+    "使用托管并发查询、标准流程表单、owned子表或普通角色连接开发的V2应用。"
+  ],
+  "upgradeSteps": [
+    "通过精确版本安装完整同源发行组合；启用新声明前核验目标平台能力。托管高并发应用需在真实浏览器与隔离压测中重新校准恢复行为。"
+  ],
+  "knownLimitations": [
+    "客户上一档万人HTTP请求图有29人结果观察被断连中断；后台全部终结但该档仍未完整通过。本版本的新万人复测尚未完成，既有最高完整通过为8000人HTTP请求图。",
+    "不自动重放业务写入，不将断连认定为已受理，不覆盖集中SSO登录或浏览器JS渲染容量；权限、依赖及未标记错误继续拒绝。",
+    "新增可选流程及普通角色源码调用需要配套平台能力；旧平台不能启用未支持的声明。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "托管断连恢复复用现有接口；新增声明按目标平台能力协商",
+    "v1": "V1不消费本批V2运行时能力"
+  },
+  "sha256": "3a9716eafe5e14bfe5eda8b2482393e4aad28155fde5933f3fe759a6a98c5972",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.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": "b8d9f8625838d2c246b059fb8d14ac107fa1a8183f7bb3066e1fcad10087f1ed"
+      "sha256": "3fcaf3ced4c43928021d5397d1f9239f5be96fa9df98b9029f5db25e29350788"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

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

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

@@ -2,6 +2,12 @@
 
 平台的应用管理控制台维护应用成员、角色授权和流程运行参数。应用自身声明的 `/admin` 业务菜单展示业务页面，两者职责不同。可见入口和可执行操作以当前用户与目标环境返回结果为准。
 
+角色成员的范围维度也支持模型字段的 `userCandidates.scope` 引用，不要求为审批人职责增加无关的数据读写策略。目录 `scopeDimensions[].applicability.candidateFields` 返回字段所在的资源、数据修订、字段、角色与操作；当前环境及仍在办理的历史流程所引用的字段均可贡献范围适用性。实例完成或发起命令取消后，旧字段不再单独贡献适用性。配置成员的范围不会自动授予数据读写、菜单或应用管理权限；实际选人与提交仍核验范围、操作、成员有效期及账号状态。
+
+流程的 `app_role_in_scope` 绑定也贡献范围适用性，包括审批、抄送、兼容的节点人员覆盖及路由补充来源。目录 `scopeDimensions[].applicability.workflowBindings` 返回流程、节点、角色、定义/绑定版本、配置修订、来源和 `active`/`in_flight` 上下文；不包含业务事实或标题。当前启用定义和仍在办理的固定版本均可维护其职责，终态实例或已取消发起命令不再单独贡献适用性。
+
+自定义管理页面按“候选字段引用该角色、有效流程范围职责引用该角色，或任一数据策略规则适用于该角色”筛选维度。每条策略须单独处理 `unrestrictedRoleCodes`；不能仅依据汇总 `allRoles`、`roleCodes` 或全局排除列表判断。未返回 `candidateFields` 或 `workflowBindings` 时按空列表处理。流程职责的范围维护不授予普通数据读写权限，也不改变已创建任务的参与人快照。
+
 ## 发现当前入口 {#context}
 
 ```bash
@@ -85,10 +91,43 @@ export function ResponsibilityMembers() {
 
 读取沿用原流程管理权限。仅获成员管理委托的用户可能可以维护角色，同时没有权限读取关联流程；组件单独呈现该拒绝。返回不含成员、实例标识或业务事实，每页最多 100 条；最多 1000 个版本组合、32 MiB 源 JSON、10000 节点/引用，超限明确拒绝。
 
+### 多职责成员合并
+
+审批或抄送的 `app_role` / `app_role_in_scope` 来源可用 `roleCodes` 声明 2–8 个不同职责，
+与单职责 `roleCode` 互斥。例如：
+
+```ts
+jointReviewers: {
+  provider: 'app_role',
+  roleCodes: ['student-office', 'organization'],
+}
+```
+
+节点进入时读取这些职责的当前有效成员；范围角色共用同一份代码计算的 `scope`。
+同一人员只占一个审批席位或抄送名额，解析解释保留各职责来源。
+职责顺序决定重叠人员席位使用哪个职责的代理规则：采用首个匹配职责，
+不会借用后续职责的代理。已有任务保持原人员快照。
+
+管理员仅在代码开放人员来源配置的节点中调整职责组合；单选仍保存 `roleCode`，
+多选保存 `roleCodes`。保存、版本激活均检查所有职责，任何职责失效或查询失败都不能
+变成部分名单。总候选最多 200 个成员身份；去重后的审批上限仍受原 binding 限制，
+自动抄送最多 20 人。声明自动协商 `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` 协议分开。权限仍要求对成员的分配或更新能力；只读权限不因此扩张。
 
 ## 限时审批代理 {#workflow-delegations}
 
+限定流程后，可进一步选择该职责在某个审批节点的代理。共享维护页的节点选项来自本人有效
+职责下的真实审批引用，包含当前及在途定义；不同节点可分别委托不同人员。不选节点覆盖
+范围内全部适用节点，全节点代理与重叠的单节点代理不能同时生效。预览和原操作回执保留范围，
+旧回执缺少节点仍按原规则读取；创建、撤销或到期均不改派已创建的任务。
+
+自定义页面使用 `WorkflowDelegationMutationRequest` 的create操作，在非空 `workflowCode`
+下传可选 `nodeId`；候选查询也携带同样的流程与节点。`delegationCatalog().sources[].nodeScopes`
+提供可选节点，服务器重新核验职责和范围，不能从客户端指定审批人身份。
+按节点创建必须使用预览/execute/receipt协议；旧 `createDelegation` 入口拒绝 `nodeId`，
+避免与不支持节点限制的旧服务联调时意外扩大范围。平台自动支持，无新增默认关闭开关。
+
 平台自动提供 `workflow.delegation-management@1.0.0`，没有额外的默认关闭开关。本人只能委托自己的有效审批职责；代理人必须具有同角色、覆盖原范围且有效期覆盖整个代理窗口的成员身份。采用平台数据库时间与 `[开始, 结束)` 区间，禁止自己代理、重叠链和环。管理员可全应用查看和撤销，创建由原审批人本人完成；成员管理委托不会扩大后台或代理管理权。
 
 标准管理入口、应用后台工具与门户个人页可复用 `WorkflowDelegationManager`。组件读取当前挂载应用和环境；`initialAll` 只是筛选意图，平台仍核验超管权限。宿主把草稿回调交给已有导航保护，避免切页时丢失输入或未知操作：
@@ -158,7 +197,7 @@ export function ReadableWorkflow({ workflowCode, version }: {
 
 开发者在审批节点的 `administration` 声明可维护的模式、人员来源和任务按钮。未声明这些项的节点保留名称、说明及原人员来源维护；拓扑、分支、范围计算仍由代码控制。使用新声明的应用需要平台 `workflow.node-administration@1.0.0`，编译与激活均检查该能力。
 
-模式为 `single/any/all/sequence` 的允许子集；可维护来源限 `fixed_users/app_role/app_role_in_scope`，范围角色必须已有代码声明的 scope。按钮 code 保持同意、拒绝、退回、转交、委托、加签的稳定语义；同意和拒绝不能关闭。只有同意/拒绝支持意见规则，拒绝或代码已有必填意见不能放宽。字段显隐、填写与必填行为由应用页面和代码维护，不提供流程节点的字段管理覆盖。可编译声明见 `examples/workflow-administration/declaration.ts`。
+模式为 `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)。