openxiangda 2.68.0 → 2.68.2

package/documentation/delivery.md

@@ -95,6 +95,46 @@ OPENXIANGDA_BACKEND_IMAGE_CACHE=false pnpm openxiangda deploy
 pnpm openxiangda status <deployment-id> --watch
 ```
 
+原运行因 `WORKFLOW_DESIGNER_EXCEPTIONS_ACKNOWLEDGEMENT_REQUIRED` 失败时，支持
+`deployment.workflow-adoption-preview` 的平台可只读检查冻结候选的真实例外：
+
+```bash
+pnpm openxiangda status <deployment-id> --workflow-exceptions --json
+```
+
+必须指定原 Run ID，不能与 `--watch` 合用。结果绑定原包、AppVersion、attempt、当前 Head
+和候选流程版本；例外列表有上限，`truncated=true` 不代表已看完。
+该命令不会写画布草稿、确认例外、重试或另建部署。`activationPermission=not-granted`
+明确表示预览没有授予激活许可。旧平台能力缺失时保留原运行并报告缺口。
+当前没有通过此命令确认例外或转换旧实例事实的能力；不要给 retry 塞未支持的确认字段。
+
+若应用仍锁定旧 SDK，统一 launcher 可能继续选择旧引擎。不要为诊断改应用依赖或冻结候选。
+可在应用目录之外建立独立诊断目录，安装发行回执指定的精确 `openxiangda-devkit-core` 版本
+（该版本须包含 `deploymentWorkflowPreview`），使用以下公开服务接口；不使用 `latest`。
+把脚本保存为该诊断目录下的 `preview.mjs`，运行 `node preview.mjs <原工作区绝对路径> <原Run ID>`：
+
+```js
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { OpenXiangdaDeveloperSession, workspaceSessionPath, OpenXiangdaControlPlaneClient } from 'openxiangda-devkit-core';
+const [rootInput, runId] = process.argv.slice(2);
+if (!rootInput || !runId) throw new Error('需要原工作区和原 Run ID');
+const root = resolve(rootInput);
+const link = JSON.parse(await readFile(join(root, '.openxiangda/link.json'), 'utf8'));
+if (typeof link.appCode !== 'string' || typeof link.baseUrl !== 'string') throw new Error('工作区绑定无效');
+const session = await OpenXiangdaDeveloperSession.load({ sessionPath: workspaceSessionPath(root) });
+if (!session) throw new Error('需要原工作区的平台登录会话');
+session.assertPlatform(link.baseUrl);
+const client = new OpenXiangdaControlPlaneClient({ baseUrl: session.baseUrl, tokenProvider: session });
+console.log(JSON.stringify(await client.deploymentWorkflowPreview(link.appCode, runId), null, 2));
+```
+
+此路径不加载应用 CLI 或源码配置、不重建候选，也不改应用 package/lock/seal。
+认证沿用官方工作区会话及平台绑定检查；如 token 到期，会话组件仍按原规则刷新凭据。
+它只做原身份核验、能力检查及原 Run GET；平台尚未支持时明确失败，不回退为重新部署。
+
+
+
 网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
 
 新的发布使用当前源码准备前端与配置，后端按实际输入复用或构建；同输入镜像可复用上述短期原制品缓存。

package/documentation/getting-started.md

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

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.68.0",
+  "version": "2.68.2",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "d69a5d6badc21e9786fe2a496d699112de6a76eaf2fc44c9c9e76fb85ba71fc8"
+      "sha256": "046f755edf1c245382447e301b4009f4cb850df05261ccc5f52207197354b13b"
     },
     {
       "id": "product-design",
@@ -90,7 +90,7 @@
       "id": "public-access",
       "title": "无账号的匿名公开访问",
       "file": "public-access.md",
-      "sha256": "6f910f1e6c40f7534a0ed9263ee6af8f3d3e1074faa4523fa26f680c14ee37b6"
+      "sha256": "c46eff36b8e4737af8d6f2ff0f7b55f821c9a014b0365d689b871f24bf492884"
     },
     {
       "id": "workflow-events",
@@ -156,7 +156,7 @@
       "id": "delivery",
       "title": "部署、生产晋级与恢复",
       "file": "delivery.md",
-      "sha256": "547d0b22704d86566d337dfe4ef192fd2264180485ed7139bb3b02746b3b0632"
+      "sha256": "30e301de0c056f758498ea889bc802a40891ba750457550be33dad46bf47c781"
     },
     {
       "id": "upgrading",
@@ -168,7 +168,7 @@
       "id": "cli",
       "title": "CLI 命令参考",
       "file": "reference/cli.md",
-      "sha256": "13821850bc6387d4c49605f8b5a3e795ee3f6a72780aa6ebe66ce54a8002bfbb"
+      "sha256": "b386c145f3ac3c9709ff0d2874b6830baff9940e761426b34ba376cdbfc3f475"
     },
     {
       "id": "mcp",

package/documentation/public-access.md

@@ -153,7 +153,7 @@ export default defineOpenXiangdaApp({
 
 需要隐藏停用、归档或租户标记记录时，使用固定 `publicFilters`，由服务端对每次 `public.list`/
 `public.read` 强制追加。当前只支持最多 16 个不同字段的 `eq` 等值条件，字段必须属于策略的
-`fields` 且仅允许布尔、文本、数值、日期和时间标量；调用方不能覆盖、追加或删除这些条件：
+`fields` 且仅允许布尔、文本、数值、日期、时间标量，以及 option.single（含 radio 外观） 单选字段（只接受字符串选项值或 null）；调用方不能覆盖、追加或删除这些条件：
 
 ```ts
 publicFilters: [{ field: 'enabled', operator: 'eq', value: true }]

package/documentation/reference/cli.md

@@ -16,7 +16,7 @@
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |
 | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
 | `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
-| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
+| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态，可只读预览原运行流程例外 |
 | `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
 | `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
 | `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.68.0",
+  "version": "2.68.2",
   "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.10.8",
-    "openxiangda-contracts": "2.88.0",
-    "openxiangda-devkit-core": "2.66.0",
+    "openxiangda-cli": "2.11.1",
+    "openxiangda-contracts": "2.88.1",
+    "openxiangda-devkit-core": "2.67.1",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.2.12",
-    "openxiangda-nest": "2.19.5",
-    "openxiangda-skill-kit": "2.3.114",
+    "openxiangda-mcp": "2.2.14",
+    "openxiangda-nest": "2.19.6",
+    "openxiangda-skill-kit": "2.3.116",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -167,43 +167,36 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.68.0",
+    "version": "2.68.2",
     "status": "reviewed",
-    "title": "PC流程管理、条件人员编辑与开发反馈整合",
-    "summary": "统一交付按动作授权的PC流程管理、条件人员规则编辑、Connected Dev原运行诊断与编译器任务前提投影，并同步业务迁移和发布指导。平台能力需配套服务端及管理前端后按明确环境启用。",
-    "newFeatures": [
-      "PC流程设计器按查看、编辑、发布和办理配置四种动作呈现已发布/草稿读面，失权或结果未知时保留输入和原操作查询。",
-      "条件人员规则支持有序条件与否则、完整assignment保留和发布上下文校验；新节点允许保存受限不完整草稿，正式发布仍严格。",
-      "MCP契约上下文增加分页prerequisites选择器，直接投影sealed compiler的能力与任务声明，不代替目标或角色验收。"
-    ],
+    "title": "固定公开单选过滤的编译一致性修复",
+    "summary": "允许对 option.single 单选字段声明固定公开 eq 条件，保持平台强制过滤和字段白名单。",
+    "newFeatures": [],
     "fixes": [
-      "Connected Dev保留字段位置、原configurationRunId/causeCode与拒绝分类，避免对需要修配置、查原运行或TEST部署的问题一律建议重跑。",
-      "生产回退明确使用已发布配置和真实数据；补齐V1到V2业务迁移、PC流程授权及原结果恢复的单源资料。",
-      "条件规则排序按钮提供稳定可访问名称，同批更新CLI模板精确BOM。"
+      "修复是否开放、发布状态等单选字段被应用与 Native 编译器错误拒绝的问题。",
+      "单选值只接受字符串或 null，拒绝数组、对象、数值和布尔；多选、附件、人员及资源引用仍不接受。"
     ],
     "affectedUsers": [
-      "维护V2应用和PC流程设计/办理配置的开发者与管理员。",
-      "使用CLI/MCP开展连接开发、声明检查和业务迁移的团队。"
+      "通过 frontend.publicAccess 发布带开放/发布状态条件的公开目录应用。"
     ],
     "upgradeSteps": [
-      "按工作区锁定版本安装完整根包组合并刷新同版本Skill；不自动迁移V1项目。",
-      "平台先消费正式contracts2.88.0、同批浏览器SDK与sealed管理前端，并完成服务端与实际角色验收，再为明确TEST环境UUID启用委托流程管理。",
-      "已有未知操作继续查询原operationId/run；生产只晋级已经验收的原TEST版本。"
+      "应用升级精确 openxiangda 2.68.2 并重新 check；不修改已安装编译器或生成输出。",
+      "平台同步官方 openxiangda-contracts 2.88.1 编译器后再部署含此条件的应用；运行时过滤仍由平台负责。"
     ],
     "knownLimitations": [
-      "SDK发行不等于平台部署或业务验收，环境开关默认空；仅安装npm包不会启用角色管理授权。",
-      "流程设计和授权管理本批仅针对PC，不扩大移动管理画布范围。",
-      "条件抄送、嵌套条件、发起自选和应用provider不在本次条件编辑范围；旧平台缺少上下文或能力时保持关闭。",
-      "测试数据回收仍仅native-data-only，复杂域与历史数据不能自动清理；语义扫描仍observe-only，不授予强制激活许可。"
+      "仍只允许固定 eq 条件；不开放匿名任意筛选、排序或普通 Native Data API。",
+      "包与平台发布不代表学校浏览器、真实角色或通知验收完成。"
     ],
     "compatibility": {
       "node": "Node.js 24 or newer for maintained toolchain",
-      "generation": "OpenXiangda V2; no automatic V1 migration",
-      "platform": "Paired contracts2.88.0 backend and sealed admin SDK required for new workflow features"
+      "generation": "OpenXiangda V2; V1 unchanged",
+      "platform": "Native compiler openxiangda-contracts 2.88.1; server option JSON equality already implemented"
     },
-    "issues": [],
-    "sha256": "ddfe1d0c13e0ab47aca67b35872af4563253a6f6c768f2945e2e9d60a374db1a",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.68.0"
+    "issues": [
+      "PLT-068"
+    ],
+    "sha256": "122b83c8aa1540c4e97ba7b4700618a03ff86585848f3f9f5626475ad13b7a8d",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.68.2"
   },
   "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/releases/2.66.0.json

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

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

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

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

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

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

@@ -0,0 +1,33 @@
+{
+  "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/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "d96b6047804492a191368df505d9055abf81b312d68bb569758ccb4eef6b4062"
+      "sha256": "7f108668ef3eaf6449c70cb5204058e567a03d0f2527f08d2c98d67ebb99328a"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

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

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

@@ -16,7 +16,7 @@
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |
 | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
 | `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
-| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
+| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态，可只读预览原运行流程例外 |
 | `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
 | `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
 | `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |

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

@@ -95,6 +95,46 @@ OPENXIANGDA_BACKEND_IMAGE_CACHE=false pnpm openxiangda deploy
 pnpm openxiangda status <deployment-id> --watch
 ```
 
+原运行因 `WORKFLOW_DESIGNER_EXCEPTIONS_ACKNOWLEDGEMENT_REQUIRED` 失败时，支持
+`deployment.workflow-adoption-preview` 的平台可只读检查冻结候选的真实例外：
+
+```bash
+pnpm openxiangda status <deployment-id> --workflow-exceptions --json
+```
+
+必须指定原 Run ID，不能与 `--watch` 合用。结果绑定原包、AppVersion、attempt、当前 Head
+和候选流程版本；例外列表有上限，`truncated=true` 不代表已看完。
+该命令不会写画布草稿、确认例外、重试或另建部署。`activationPermission=not-granted`
+明确表示预览没有授予激活许可。旧平台能力缺失时保留原运行并报告缺口。
+当前没有通过此命令确认例外或转换旧实例事实的能力；不要给 retry 塞未支持的确认字段。
+
+若应用仍锁定旧 SDK，统一 launcher 可能继续选择旧引擎。不要为诊断改应用依赖或冻结候选。
+可在应用目录之外建立独立诊断目录，安装发行回执指定的精确 `openxiangda-devkit-core` 版本
+（该版本须包含 `deploymentWorkflowPreview`），使用以下公开服务接口；不使用 `latest`。
+把脚本保存为该诊断目录下的 `preview.mjs`，运行 `node preview.mjs <原工作区绝对路径> <原Run ID>`：
+
+```js
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { OpenXiangdaDeveloperSession, workspaceSessionPath, OpenXiangdaControlPlaneClient } from 'openxiangda-devkit-core';
+const [rootInput, runId] = process.argv.slice(2);
+if (!rootInput || !runId) throw new Error('需要原工作区和原 Run ID');
+const root = resolve(rootInput);
+const link = JSON.parse(await readFile(join(root, '.openxiangda/link.json'), 'utf8'));
+if (typeof link.appCode !== 'string' || typeof link.baseUrl !== 'string') throw new Error('工作区绑定无效');
+const session = await OpenXiangdaDeveloperSession.load({ sessionPath: workspaceSessionPath(root) });
+if (!session) throw new Error('需要原工作区的平台登录会话');
+session.assertPlatform(link.baseUrl);
+const client = new OpenXiangdaControlPlaneClient({ baseUrl: session.baseUrl, tokenProvider: session });
+console.log(JSON.stringify(await client.deploymentWorkflowPreview(link.appCode, runId), null, 2));
+```
+
+此路径不加载应用 CLI 或源码配置、不重建候选，也不改应用 package/lock/seal。
+认证沿用官方工作区会话及平台绑定检查；如 token 到期，会话组件仍按原规则刷新凭据。
+它只做原身份核验、能力检查及原 Run GET；平台尚未支持时明确失败，不回退为重新部署。
+
+
+
 网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
 
 新的发布使用当前源码准备前端与配置，后端按实际输入复用或构建；同输入镜像可复用上述短期原制品缓存。

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

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

package/skills/openxiangda-v2/references/public-access.md

@@ -153,7 +153,7 @@ export default defineOpenXiangdaApp({
 
 需要隐藏停用、归档或租户标记记录时，使用固定 `publicFilters`，由服务端对每次 `public.list`/
 `public.read` 强制追加。当前只支持最多 16 个不同字段的 `eq` 等值条件，字段必须属于策略的
-`fields` 且仅允许布尔、文本、数值、日期和时间标量；调用方不能覆盖、追加或删除这些条件：
+`fields` 且仅允许布尔、文本、数值、日期、时间标量，以及 option.single（含 radio 外观） 单选字段（只接受字符串选项值或 null）；调用方不能覆盖、追加或删除这些条件：
 
 ```ts
 publicFilters: [{ field: 'enabled', operator: 'eq', value: true }]

package/releases/2.68.0.json

@@ -1,40 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.68.0",
-  "status": "reviewed",
-  "title": "PC流程管理、条件人员编辑与开发反馈整合",
-  "summary": "统一交付按动作授权的PC流程管理、条件人员规则编辑、Connected Dev原运行诊断与编译器任务前提投影，并同步业务迁移和发布指导。平台能力需配套服务端及管理前端后按明确环境启用。",
-  "newFeatures": [
-    "PC流程设计器按查看、编辑、发布和办理配置四种动作呈现已发布/草稿读面，失权或结果未知时保留输入和原操作查询。",
-    "条件人员规则支持有序条件与否则、完整assignment保留和发布上下文校验；新节点允许保存受限不完整草稿，正式发布仍严格。",
-    "MCP契约上下文增加分页prerequisites选择器，直接投影sealed compiler的能力与任务声明，不代替目标或角色验收。"
-  ],
-  "fixes": [
-    "Connected Dev保留字段位置、原configurationRunId/causeCode与拒绝分类，避免对需要修配置、查原运行或TEST部署的问题一律建议重跑。",
-    "生产回退明确使用已发布配置和真实数据；补齐V1到V2业务迁移、PC流程授权及原结果恢复的单源资料。",
-    "条件规则排序按钮提供稳定可访问名称，同批更新CLI模板精确BOM。"
-  ],
-  "affectedUsers": [
-    "维护V2应用和PC流程设计/办理配置的开发者与管理员。",
-    "使用CLI/MCP开展连接开发、声明检查和业务迁移的团队。"
-  ],
-  "upgradeSteps": [
-    "按工作区锁定版本安装完整根包组合并刷新同版本Skill；不自动迁移V1项目。",
-    "平台先消费正式contracts2.88.0、同批浏览器SDK与sealed管理前端，并完成服务端与实际角色验收，再为明确TEST环境UUID启用委托流程管理。",
-    "已有未知操作继续查询原operationId/run；生产只晋级已经验收的原TEST版本。"
-  ],
-  "knownLimitations": [
-    "SDK发行不等于平台部署或业务验收，环境开关默认空；仅安装npm包不会启用角色管理授权。",
-    "流程设计和授权管理本批仅针对PC，不扩大移动管理画布范围。",
-    "条件抄送、嵌套条件、发起自选和应用provider不在本次条件编辑范围；旧平台缺少上下文或能力时保持关闭。",
-    "测试数据回收仍仅native-data-only，复杂域与历史数据不能自动清理；语义扫描仍observe-only，不授予强制激活许可。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; no automatic V1 migration",
-    "platform": "Paired contracts2.88.0 backend and sealed admin SDK required for new workflow features"
-  },
-  "issues": [],
-  "sha256": "ddfe1d0c13e0ab47aca67b35872af4563253a6f6c768f2945e2e9d60a374db1a",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.68.0"
-}