openxiangda 2.18.8 → 2.18.10

package/releases/2.15.0.json

@@ -0,0 +1,40 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.15.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.15.0：CRUD 复用 Data API 引导与 Nest 路由门禁",
+  "summary": "为普通 CRUD 补齐浏览器端 Data API 正面路径文档与 Nest 启用决策表，并在 check/dev 拒绝未绑定已声明 operation 的应用 controller 路由，使数据增删改查默认回到平台统一接口。",
+  "newFeatures": [
+    "开发资料新增「自定义页面消费平台数据」：createNativeResourceClient 的列表/详情/写入/删除/上传用法、expectedRevision 乐观锁、transactNativeData 幂等事务与 batchAggregateNativeResources 服务端聚合。",
+    "需求与开发流程新增「判定是否真的需要 Nest 后端」决策表，工作区 AGENTS 模板与按需后端资料同步指向；只有真实外部副作用或无法声明的跨资源不变量才启用 Nest。",
+    "devkit check/dev 新增应用 controller operation 门禁：未以 `@OpenXiangdaOperation(appOperations.具名操作)` 绑定已声明 operation 的路由返回 `OPENXIANGDA_NEST_CONTROLLER_OPERATION_REQUIRED`，手写契约字面量返回 `OPENXIANGDA_NEST_OPERATION_CONTRACT_MUST_BE_DECLARED`。"
+  ],
+  "fixes": [
+    "修复交付流程简化后 CLI 黑盒仍期望已删除的 DELIVERY_GIT_COMMIT_REQUIRED 的问题；黑盒改为断言 AppSpec 章节门禁，verify:affected 恢复可用。"
+  ],
+  "affectedUsers": [
+    "所有 OpenXiangda 2.0 应用开发者和 AI 辅助开发会话；新指引让列表、表单、详情、删除优先复用平台 Data API 与事务守卫。",
+    "维护含自写 Nest controller 的既有应用：升级后 check 会要求绑定已声明 operation 或移除该路由。"
+  ],
+  "upgradeSteps": [
+    "将应用精确依赖升级到 openxiangda 2.15.0，刷新项目 Skill 与工作区指引后运行 check。",
+    "对报 `OPENXIANGDA_NEST_CONTROLLER_OPERATION_REQUIRED` 的路由：普通 CRUD 改用 createNativeResourceClient 或标准 CRUD 页面；真实业务动作先在 openxiangda.config.ts 声明 operation（capability kind: 'backend'），再绑定 `@OpenXiangdaOperation(appOperations.具名操作)`。",
+    "按 development#backend-decision 决策表复查既有后端使用面，完成 check、test、build 后按常规测试发布流程验证。"
+  ],
+  "knownLimitations": [
+    "门禁是静态判定：已声明 operation 但方法体仍只转发普通 CRUD 的 controller 不会被拒绝；该层由设计评审与后续 AppSpec 能力复用清单兜底。",
+    "类级别 @OpenXiangdaOperation 绑定不被接受，需要逐路由方法绑定同一生成契约。",
+    "文档与门禁不替代目标环境的真实角色、浏览器和性能验收。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v2"
+    ],
+    "platform": "不要求平台服务端变更；已有应用升级后 check 行为变化见升级步骤。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "issues": [],
+  "sha256": "45fe1d3ad3b0a04d8ec4b3f657a201dee14823576fe8b48a369a92f7d0c9e029",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.15.0"
+}

package/releases/2.16.0.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.16.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.16.0：相机图片直传与声明一次写对",
+  "summary": "浏览器托管上传按 maxPixels 契约预检并自动降采样超限图片，声明校验放宽可推导默认值、报错附带可复制片段，新增声明速查主题与事务快照/幂等冲突助手。",
+  "newFeatures": [
+    "资源与匿名托管上传通道读取上传计划发布的 maxPixels，超限图片本地降采样后重新发起上传；旧平台无契约时回退 40MP 保护阈值。",
+    "openxiangda/nest 新增 optionSnapshot、userSnapshot、departmentSnapshot、resourceSnapshot 快照值助手与 isIdempotencyConflict 冲突判定，事务写快照字段不再手工拼形状。",
+    "新增 declarations-cheatsheet 中文主题（入口 Skill 已路由）：按错误码到规则到正确片段组织全部隐式声明规则，并附两模型起步骨架。"
+  ],
+  "fixes": [
+    "number.integer 允许可选 precision 位数并拒绝 scale 小数位；number.decimal 精度报错附带合法示例，resource-ref 缺 source、平台保留能力与 AI 写操作副作用报错的补救文本直接携带正确片段。",
+    "audit.read 支持 true 声明糖自动绑定资源读能力；CRUD 视图 list/form/detail 省略 model 时继承视图模型。",
+    "业务验收报告性能条目的报错逐字段定位，指出缺失字段名与最少实义字符要求。"
+  ],
+  "affectedUsers": [
+    "所有在表单中上传手机照片或长截图的 OpenXiangda 2.0 应用用户与开发者。",
+    "首次编写 openxiangda.config.ts 声明、在 Nest 事务中写 option/user/resource-ref 字段的开发者与 AI 工作流。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.16.0 并刷新项目 Skill；普通 CRUD 与既有声明无需修改。",
+    "新的图片字段上传自动获得像素预检；配合已修复 maxPixels 契约的平台（100MP 上限）效果最佳，旧平台自动回退压缩保护。",
+    "后端事务代码可选用新的快照值助手与 isIdempotencyConflict 复核模式，参见 backend 文档快照写入与幂等冲突两节。"
+  ],
+  "knownLimitations": [
+    "前端压缩依赖浏览器 createImageBitmap；极旧的浏览器跳过预检，由服务端明确错误兜底。",
+    "操作通道（operation-managed）上传不自动改写业务文件内容，超限时返回带尺寸的 PIXEL_LIMIT_EXCEEDED，由调用方自行压缩。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v2"
+    ],
+    "platform": "maxPixels 契约与 100MP 处理上限需要配套平台版本；旧平台通过 40MP 回退阈值继续工作。V1 引擎保持独立。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "issues": [],
+  "sha256": "55687eb0915b5a1d2743f4b3c5aa54d7a3dbfad91b467cc9f80be10995aa83f5",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.16.0"
+}

package/releases/2.17.0.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.17.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.17.0：一行声明生成用户端标准面",
+  "summary": "CRUD 视图声明 user: true 即可为普通用户生成“我的记录 + 提交”标准页面（桌面与移动双端），自动接线能力与登录落地，简单 CRUD 应用开箱即有完整用户端闭环。",
+  "newFeatures": [
+    "resource-records / resource-submit 两种用户标准路由：`/my/<资源代码>` 列表与 `/my/<资源代码>/submit` 提交（移动端 `/m/` 前缀），能力分别绑定资源 read / create。",
+    "“我的记录”标准组件：默认仅展示当前登录用户创建的记录（created_by 过滤）、分页、行详情抽屉与提交入口；提交页复用标准生成表单。",
+    "首个启用资源自动成为登录落地页与根路径；多资源用 user: { home: true } 显式指定；声明式 /home 占位仍可覆盖。"
+  ],
+  "fixes": [
+    "GenericResourceQuery 新增显式 createdBy 过滤映射 created_by 系统字段，不放宽其他系统字段查询。"
+  ],
+  "affectedUsers": [
+    "为普通登录用户提供提交与查询的简单 CRUD 应用开发者。",
+    "使用 openxiangda 2.16 及以下的应用升级后行为零变化（未声明 user 面不受影响）。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.17.0 并刷新项目 Skill。",
+    "在需要用户端的 CRUD 视图上追加 user: true；如需自定义用户端体验，继续用自定义页面覆盖即可。",
+    "行级强隔离仍按数据与权限文档声明 dataPolicies；“仅本人”列表是展示过滤。"
+  ],
+  "knownLimitations": [
+    "“我的记录”的本人过滤是查询层展示过滤，非服务端授权边界。",
+    "详情抽屉按声明字段只读渲染，暂不支持在用户端编辑已有记录（可继续用自定义页面）。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v2"
+    ],
+    "platform": "无需平台配合变更；路由与能力契约向后兼容。V1 引擎保持独立。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "issues": [],
+  "sha256": "5656c1f523a25d37770bed992d352dc372f3e08f5ce8ca25394443d448d25870",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.17.0"
+}

package/releases/2.17.1.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.17.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.17.1：用户标准面共享契约闭合修复",
+  "summary": "共享编译器接受并校验生成式用户标准面的路由契约，2.17.0 声明 user 面的应用可完整通过本地校验与部署；生成码分隔符统一为点号。",
+  "newFeatures": [
+    "生成码分隔符统一为点号（user.资源码.records / user.资源码.submit），与设备路由码一致。"
+  ],
+  "fixes": [
+    "修复 2.17.0 中 user 声明触发 NATIVE_CODE_INVALID / NATIVE_CONTRACT_CLOSURE_MISMATCH：共享校验器按配置事实（资源存在、能力等于 read/create、码与路径形状）校验并并入用户标准路由，配置 bundle 不变，旧平台无需升级。",
+    "生成码统一为 user.资源码.records / user.资源码.submit，符合稳定码模式。"
+  ],
+  "affectedUsers": [
+    "使用 openxiangda 2.17.0 并声明 user 用户面的应用开发者。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.17.1 后重新运行 check 与部署。"
+  ],
+  "knownLimitations": [
+    "“我的记录”的本人过滤仍是查询层展示过滤，非服务端授权边界。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v2"
+    ],
+    "platform": "无平台配合要求；配置与契约 bundle 对既有平台保持可部署。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "issues": [],
+  "sha256": "365186221004ce60f596db55dca2b53bf9d2d89695956b80daa7b3b4cd028af2",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.17.1"
+}

package/releases/2.18.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.18.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.18.0：用户标准面闭合修复、列表可排序声明与发布提效",
+  "summary": "共享编译器完成用户标准面契约闭合校验；模块列表视图新增 sortableFields 排序声明（GAP-MODULE-001）；发布验证按浏览器字节分级并收窄浏览器证据指纹，纯工具链补丁不再触发浏览器矩阵。",
+  "newFeatures": [
+    "列表视图新增 sortableFields：与 filterFields/searchableFields 同构声明可排序列；defaultSort.field 保持隐式可排序，重复容忍；引用未声明字段报编译错误；低层 data.resources 语义不变。",
+    "发布提效：验证计划按“浏览器应用实际加载的字节”分级（根包前端入口/contracts 浏览器入口），共享校验器等 Node 侧改动不再触发浏览器矩阵；浏览器阶段缓存指纹只包含浏览器捆绑包，devkit-core 等候选的字节变化不再使浏览器证据失效（候选版本仍由规范化锁覆盖）。"
+  ],
+  "fixes": [
+    "修复 2.17.0 中 user 声明触发 NATIVE_CODE_INVALID / NATIVE_CONTRACT_CLOSURE_MISMATCH：共享校验器按配置事实校验并并入用户标准路由，配置 bundle 不变，旧平台无需升级。",
+    "生成码统一为 user.资源码.records / user.资源码.submit，符合稳定码模式。"
+  ],
+  "affectedUsers": [
+    "使用 openxiangda 2.17.0 并声明 user 用户面的应用开发者。",
+    "从 data.resources 迁移到模块化声明、需要列表列头排序能力的应用（如数智工会 szgh-v2）。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.18.0 后重新运行 check 与部署。",
+    "模块化迁移的列表排序用 sortableFields 声明，与既有低层声明逐字段对齐。"
+  ],
+  "knownLimitations": [
+    "“我的记录”的本人过滤仍是查询层展示过滤，非服务端授权边界。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v2"
+    ],
+    "platform": "无平台配合要求；配置与契约 bundle 对既有平台保持可部署。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "issues": [],
+  "sha256": "c5744c1cdd46e8922615d1b3bff521e072108906882a25c4d0f75f93f869c4af",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.0"
+}

package/releases/2.18.1.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.18.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.18.1：用户标准面落地页渲染修复",
+  "summary": "修复 2.18.0 中声明 user 用户面的应用整页渲染为空白的问题：运行时清单校验器把“根入口别名资源 records 路由”的编译器形状误判为路径冲突。本版让运行时接受该形状并新增浏览器验收覆盖。",
+  "newFeatures": [],
+  "fixes": [
+    "修复 OPENXIANGDA_ROUTE_MANIFEST_INVALID 导致用户标准面应用空白：rootEntry 直接别名资源 records 路由（登录落地即“我的记录”）时，校验器现在允许根入口别名恰好一条标准路由对；认证路径与其它任何落地路径冲突仍然拒绝。",
+    "修复别名落地页的双端切换失效：根入口别名路由对时，设备协商由该路由对承担投影，不再与静态根对产生等特异性双匹配。",
+    "浏览器验收新增 user-surface.e2e：覆盖别名清单挂载、本人过滤列表、提交表单与双端切换；为验收 mock 平台补齐单条记录读取端点（native/data/{code}/records/{id}）。"
+  ],
+  "affectedUsers": [
+    "使用 openxiangda 2.18.0 并在 CRUD 视图声明 user 用户面的应用开发者（应用此前表现为登录后整页空白）。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.18.1 后重新运行 check 与部署；无需平台配合升级。"
+  ],
+  "knownLimitations": [
+    "“我的记录”的本人过滤仍是查询层展示过滤，非服务端授权边界（与 2.18.0 相同）。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无平台配合要求；契约与配置 bundle 字节不变。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "sha256": "80e7d6fe82cf1b0475e15509aa9fda386cc03764fc69a352cef6bc9ea461bb9f",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.1"
+}

package/releases/2.18.10.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.18.10",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.18.10：随包技能/文档同步自建中心指南",
+  "summary": "openxiangda-skill-kit 随包技能与文档与源文档再同步：携带「自建待办与消息中心 UI」指南与 2.18.9 标准中心视觉重构说明；无代码行为变化。",
+  "newFeatures": [],
+  "fixes": [
+    "openxiangda-skill-kit 打包内容与源文档再同步：修复随包技能/文档滞后于「自建待办与消息中心 UI」指南与 2.18.9 标准中心视觉重构说明的问题。"
+  ],
+  "affectedUsers": [
+    "通过 skill-kit 安装随包技能与文档的应用开发者与 AI 会话。"
+  ],
+  "upgradeSteps": [
+    "随 2.18.10 列车一起发布；应用无需单独升级，引用 openxiangda 2.18.9 及配套版本即可。"
+  ],
+  "knownLimitations": [
+    "本列车无独立代码变更；功能变更记录见 2.18.9 发布说明，两列车一并发布。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无平台配合要求。",
+    "v1": "V1 工作区不受影响。"
+  },
+  "sha256": "62fba20895d127dc14f81ddac0445eac22957a0e8dadca1556957bb65834869c",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.10"
+}

package/releases/2.18.2.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.18.2",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.18.2：模块模型级详情路由声明（GAP-MODULE-002）",
+  "summary": "模块化声明支持资源级详情路由绑定（detailRouteCode），模型声明未知属性 fail-closed；devkit-core 2.15.0 携带投影实现，根包为依赖传播版本。",
+  "newFeatures": [
+    "AppDataModelDeclaration 新增 detailRouteCode（desktop/mobile route code）：模块化声明可表达 Workflow 详情接管消费的资源级详情路由绑定，materializeApplicationModules 完整透传到输出资源；低层 data.resources[].detailRouteCode 语义与既有校验（user surface、单动态参数、read capability 对齐）不变。",
+    "模型声明上的未知属性不再被静默丢弃：投影输出 APP_MODEL_KEY_UNKNOWN 错误 diagnostic（指向 `modules[i].models[j].<key>`）并使编译失败。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "从 data.resources 迁移到模块化声明、需要资源详情路由由 Workflow 详情接管的应用（如数智工会 szgh-v2）。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.18.2（openxiangda-devkit-core 2.15.0）后重新运行 check 与部署。"
+  ],
+  "knownLimitations": [
+    "detailRouteCode 校验沿用既有资源级规则；本次不改变共享纯校验器字节，configuration-compatibility/v2 的 validatorDigest 不变。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无平台配合要求；contracts 共享校验器字节不变。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "sha256": "029cced498e869e301d49a73a900beffb80a3b5c3183c34c8fb341f81853539a",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.2"
+}

package/releases/2.18.3.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.18.3",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.18.3：xlsx 依赖镜像化，去除 SheetJS CDN 单点",
+  "summary": "openxiangda 包的 xlsx 依赖从 cdn.sheetjs.com 直链 tarball 迁移到本仓库 GitHub Release 的 vendor-mirror 镜像资产；字节与上游一致（sha256 相同）并继续由锁文件 integrity 钉住。",
+  "newFeatures": [],
+  "fixes": [
+    "消除 SheetJS 官方 CDN 单点：该直链曾在发布验证中造成 ECONNRESET 整轮报废；GitHub Release 资产端点对 CI runner 与一般网络更稳定。",
+    "依赖字节不变：镜像 tarball 与 cdn.sheetjs.com 原件 sha256 一致（8dc73fc3b00203e72d176e85b50938627c7b086e607c682e8d3c22c02bb99fe8），锁文件 integrity 保持内容可验证。"
+  ],
+  "affectedUsers": [
+    "所有安装 openxiangda 2.18.x 的应用（安装链路不再依赖 cdn.sheetjs.com 的可用性）。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.18.3 后重新安装并运行 check。"
+  ],
+  "knownLimitations": [
+    "镜像资产托管在本仓库 GitHub Release（vendor-mirror tag），仓库可用性成为新的安装依赖面。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无平台配合要求。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "sha256": "331ccad039c2fcfcca561364592d869f0cdeb749874b8ab77396b548b1984baf",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.3"
+}

package/releases/2.18.9.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.18.9",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.18.9：标准待办/消息中心视觉重构与自建中心合同收尾",
+  "summary": "修复运行时缺失基础字体导致的裸元素衬线渲染；待办中心与消息中心按统一页型重构（PC + 移动端）；nest 客户端补齐 work-center view 参数并新增应用自建待办/消息 UI 指南。",
+  "newFeatures": [
+    "OpenXiangdaPlatformClient.workflowWorkCenter 新增可选 view 参数（created/pending/handled/cc），与浏览器端合同对齐；未传时保持 status 兼容行为。",
+    "docs/frontend.md 新增「自建待办与消息中心 UI」：openxiangda/core 客户端用法、回执语义与标准路由不可接管等边界。"
+  ],
+  "fixes": [
+    "运行时在 .oxa-ui-root 补基础字体/字号/行高兜底（读取 --ant-font-family/font-size/line-height），裸元素不再继承浏览器衬线默认值，应用品牌字体自动流入标准页。",
+    "待办中心改为 layout 底 + 内容卡层次：Typography 页头、Tabs 计数徽标、middle 密度表格、移动端吸顶页头与卡片精修。",
+    "消息中心控制区单行对齐（搜索/查询/仅看未读右对齐），摘要卡图标与数字层级、未读圆点显式主色、移动卡片未读左缘条。",
+    "verify-design-workbench 改用探测的空闲临时端口，修复本机存在其他 Vite dev server（占用 5173）时设计门必失败的问题。"
+  ],
+  "affectedUsers": [
+    "使用标准待办中心/消息中心的应用及其最终用户（视觉与可读性）。",
+    "需要服务端取 created/cc 待办视图或自建中心 UI 的应用开发者。"
+  ],
+  "upgradeSteps": [
+    "应用精确依赖升级到 openxiangda 2.18.9（及配套 openxiangda-cli/openxiangda-nest）后重新 build、check 与部署。",
+    "希望标准页跟随品牌字体/字号的应用在 ui.theme 中配置 token 即可，无需其他迁移。"
+  ],
+  "knownLimitations": [
+    "Workflow 待办中心暂无渲染器替换钩子；需要完全不同呈现时按文档使用自有路由 + openxiangda/core 客户端自建。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无平台配合要求。",
+    "v1": "V1 工作区不读取该运行时，不受影响。"
+  },
+  "sha256": "7cc67dfe0aa1b7ccdd28a85fea5e149715edc03321ffc3771cd62a4356cb431a",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.9"
+}

package/releases/2.2.0.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.2.0",
+  "title": "OpenXiangda 内部支持协作接入",
+  "status": "reviewed",
+  "summary": "统一入口为 V1/V2 应用开发提供内部支持协作接入，检查官方 DWS 与技能，复用精确账号，并提供授权、打开群邀请和持续案例跟进入口。",
+  "newFeatures": [
+    "新增 support status、bootstrap、login、join，应用创建和技能刷新后检查支持通道接入状态。",
+    "缺少 DWS 时安装官方稳定版 1.0.61，并安装官方完整 multi 技能；已有可用稳定版本可以复用。",
+    "增加跨 V1/V2 支持技能，涵盖平台契约咨询、源码诊断上下文、产品架构评审和已授权案例的引用跟进。",
+    "使用外置支持通道配置，按原始邀请链接打开钉钉，由用户完成加入。"
+  ],
+  "fixes": [
+    "支持接入失败或等待用户操作时保留独立状态，不改变应用创建成功结果；进度写入 stderr，保持引擎 JSON 输出。",
+    "使用保存的精确 DWS profile，不按显示姓名或列表顺序猜测账号，不切换平台或 DWS 全局登录身份。",
+    "命令发现由统一分发层维护，技能校验显式接收分发命令，保持 V2 核心与两代引擎边界。"
+  ],
+  "affectedUsers": [
+    "通过统一入口创建应用、初始化工作区或刷新技能的 V1/V2 开发者。",
+    "在内部支持通道中继续已授权平台咨询和故障排查的开发 AI。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 项目保持原代际、版本锁定与登录绑定；支持接入由统一分发入口提供。",
+    "platformPolicy": "本次工具发布不要求更新平台镜像；源码诊断仍需目标平台已启用正式源码托管并授予当前账号访问权限。",
+    "dws": "最低稳定版 1.0.61；OAuth 与加入群需要用户在官方流程中完成。",
+    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
+  },
+  "upgradeSteps": [
+    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.2.0。",
+    "运行 openxiangda support bootstrap 检查安装与完整技能；离线或 CI 初始化可使用 --skip-support，之后再恢复。",
+    "运行 openxiangda support status --json 查看实际状态；需要时执行 support login，SSH 可使用 --device。",
+    "尚不能访问支持群时运行 support join，在钉钉完成加入后重新检查状态；已有授权案例继续引用原消息跟进。"
+  ],
+  "knownLimitations": [
+    "可读取群仅证明当前账号的访问能力，不能单独证明群成员身份或组织限制；命令返回独立验证状态。",
+    "技能不会唤醒已经结束的开发任务，后台继续需要宿主实际监听或定时任务。",
+    "安装、授权和群访问依赖网络及组织配置；新的真实用户入群与双方协作须单独现场验收，替身测试不构成真人验收。",
+    "本包提供接入与协作指导，常驻支持服务及知识库由各自私有服务独立部署。"
+  ],
+  "issues": [],
+  "sha256": "638817e7e1d8c9cb99de6b9d41716828d241e31905c9bd0565cb94e43b9ee991",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.0"
+}

package/releases/2.2.1.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.2.1",
+  "title": "原生数据事件接收契约修复",
+  "status": "reviewed",
+  "summary": "修复当前平台原生数据事件在 Nest 自动化接收端的 Schema 不匹配，保持签名验证和幂等回执边界。",
+  "newFeatures": [
+    "本次为事件契约修复，不新增业务能力。"
+  ],
+  "fixes": [
+    "移除事件数据体已经退役的 capturePlanRevision 必填要求；捕获身份继续由平台不可变事件账本持有。",
+    "接收当前用户角色并集 user_union 操作人的签名事件，并同步类型与开发测试夹具。"
+  ],
+  "affectedUsers": [
+    "使用当前原生 Data API 并通过 Nest 消费数据事件的 OpenXiangda 2.0 应用。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎与应用契约不变。",
+    "platformPolicy": "适用于由不可变捕获计划驱动的当前 V2 原生事件；应用需重新部署接收端。"
+  },
+  "upgradeSteps": [
+    "将 V2 应用的 openxiangda 精确依赖升级为 2.2.1，更新锁文件并通过标准测试部署后验证事件回执。"
+  ],
+  "knownLimitations": [
+    "升级不会自动重放历史失败事件；按原事件和应用幂等标识使用平台运维操作恢复。"
+  ],
+  "issues": [],
+  "sha256": "e56c78fce73cb156731028349b67a784f3aa1bae5073fb16d0b84fafd3b4011f",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.1"
+}

package/releases/2.2.2.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.2.2",
+  "title": "源码托管能力发现契约修复",
+  "status": "reviewed",
+  "summary": "补齐平台已提供的可选 sourceHosting 字段，修复严格预检拒绝平台能力响应的问题。",
+  "newFeatures": [
+    "本次修复已有能力声明，不要求应用使用托管仓库。"
+  ],
+  "fixes": [
+    "闭合 Schema 接受 Forgejo provider 和布尔 enabled，同时拒绝未知字段和无效类型。"
+  ],
+  "affectedUsers": [
+    "连接已提供 sourceHosting 能力字段的平台的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎与应用契约不变。",
+    "platformPolicy": "兼容包含或未包含可选源码托管能力的平台。"
+  },
+  "upgradeSteps": [
+    "将应用 openxiangda 精确依赖升级为 2.2.2，更新锁文件并重新执行正式部署预检。"
+  ],
+  "knownLimitations": [
+    "其他未知平台字段仍按闭合契约拒绝。"
+  ],
+  "issues": [],
+  "sha256": "e45a418150e90adc8658db171afe3bbfef27bb53f6521b7d3cb237decc6dca94",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.2"
+}

package/releases/2.3.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.3.0",
+  "title": "流程实例撤回期限与业务终止授权",
+  "status": "reviewed",
+  "summary": "为标准流程实例增加可选的撤回时间限制和精确业务能力终止授权，应用编译器与平台共用策略校验。",
+  "newFeatures": [
+    "流程可声明 instanceCommands，以必填时间事实限制撤回，并以同应用的精确能力授权业务管理员终止。"
+  ],
+  "fixes": [
+    "阻止未绑定时间事实、跨应用能力和未声明终止能力进入可发布应用包。"
+  ],
+  "affectedUsers": [
+    "需要限制标准流程撤回时间或授权业务角色终止流程的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎与应用契约不变。",
+    "platformPolicy": "开发与部署需要匹配的共享校验器版本。使用新策略必须由平台提供 workflow.instance-cancellation-policy 1.0.0；平台预检会拒绝不支持该能力的版本。"
+  },
+  "upgradeSteps": [
+    "将应用 openxiangda 精确依赖升级为 2.3.0，更新锁文件并刷新技能与资料。",
+    "待目标平台部署匹配版本后执行正式检查、测试发布及真实角色验收。"
+  ],
+  "knownLimitations": [
+    "新策略只作用于声明该策略的新定义，不改写既有实例固定的定义。",
+    "撤回和终止的线上执行由平台版本提供；本工具包发布不代表平台已完成部署。",
+    "驳回意见校验与 Data API 事务时钟问题不在本次工具包修复范围。"
+  ],
+  "issues": [],
+  "sha256": "134f47befeec3138041d5eb24558379135456cf2f7d437502643fc5919331ec4",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.3.0"
+}

package/releases/2.4.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.4.0",
+  "title": "事务接受时刻与预约时间窗口",
+  "status": "reviewed",
+  "summary": "增加绑定提交字段的时间守卫，统一在锁等待结束后使用平台数据库时间判断业务期限。",
+  "newFeatures": [
+    "operation-time 守卫可检查 create/update 中的 datetime 字段，支持正负 366 天以内的整数毫秒偏移和六种比较。"
+  ],
+  "fixes": [
+    "动态时间条件使用守卫锁及写入前校验完成后的数据库接受时刻，成功重放保持原 evaluatedAt。"
+  ],
+  "affectedUsers": [
+    "需要预约窗口、截止时间、签到时间或并发事务时间条件的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎和已有应用契约不变。",
+    "platformPolicy": "新编译的数据应用要求 Data API 1.1.0 和匹配的共享校验器；平台预检拒绝不支持该能力的目标。"
+  },
+  "upgradeSteps": [
+    "将应用精确依赖升级至 openxiangda 2.4.0，更新锁文件并刷新技能资料。",
+    "平台部署匹配版本后执行正式检查、测试发布、数据库截止和真实角色验收。"
+  ],
+  "knownLimitations": [
+    "evaluatedAt 是动态条件的接受时刻，不是最终数据库提交时刻。",
+    "字段必须是声明且可写的 datetime 字面值，不支持空值、嵌套路径或操作引用。",
+    "工具包发布不代表平台已部署或应用业务验收已通过。"
+  ],
+  "issues": [],
+  "sha256": "2c4e0bf9f880e72a454010d2590fe3ac5b2993a215473c8e29ef29e77431e42a",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.4.0"
+}

package/releases/2.4.1.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.4.1",
+  "title": "事件处理器依赖作用域修复",
+  "status": "reviewed",
+  "summary": "事件处理器可正常注入请求级通知服务，签名与回执校验后再由所属 Nest 模块解析依赖。",
+  "newFeatures": [],
+  "fixes": [
+    "修复请求级依赖使事件处理器构造函数未执行、handle 调用失败的问题。",
+    "同名 provider 严格按所属模块解析，并发投递与失败重试使用独立作用域；静态单例继续复用。"
+  ],
+  "affectedUsers": [
+    "使用 Nest 签名事件处理器及请求级通知服务或瞬态依赖的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎与已有应用契约不变。",
+    "platformPolicy": "沿用 2.4.0 的 Data API 1.1.0 要求；事件签名、回执、身份与部署协议不变。"
+  },
+  "upgradeSteps": [
+    "将应用精确依赖升级至 openxiangda 2.4.1，刷新工作区资料并重新检查。",
+    "重新发布应用后验证真实事件、通知送达、重复投递与失败恢复。"
+  ],
+  "knownLimitations": [
+    "事件作用域的 REQUEST 不含用户授权，sendFromEvent 仅在已验证的事件执行期间可用。",
+    "SDK 测试通过不代表真实平台通知送达或应用业务验收已完成。"
+  ],
+  "issues": [],
+  "sha256": "f81f626e3fb91069c4f5d94da48a80400ae3fca5e3b55ab0d77e0a7c82dc7681",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.4.1"
+}

package/releases/2.5.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.5.0",
+  "title": "按业务记录恢复原流程命令",
+  "status": "reviewed",
+  "summary": "浏览器和 Nest 可在重新进入详情时按业务记录查找原流程命令，继续原回执和进度查询。",
+  "newFeatures": [
+    "增加当前用户范围的流程命令分页查询，支持精确记录、流程和操作筛选，每页最多 50 条。"
+  ],
+  "fixes": [
+    "补齐业务记录已提交但流程事件尚未投影时，从列表重新进入详情无法定位原命令的恢复路径。"
+  ],
+  "affectedUsers": [
+    "使用 Business Process 原子提交业务数据与流程的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎和已有应用不变。",
+    "platformPolicy": "使用 Business Process 的新编译包要求 durable-command 1.1.0 和匹配的共享校验器；旧客户端继续兼容。"
+  },
+  "upgradeSteps": [
+    "将应用精确依赖升级至 openxiangda 2.5.0，更新锁文件并刷新技能资料。",
+    "平台部署匹配版本后执行检查和测试发布，验证重新进入详情时恢复原命令而不重复提交。"
+  ],
+  "knownLimitations": [
+    "查询沿用原命令的发起人或既有超级管理员权限，记录读取权限不授予他人命令访问。",
+    "同一记录可能有多次流程，应用须根据业务约束选择原命令，不能任意选择第一条。",
+    "包发布、平台部署和实际业务验收分别验证。"
+  ],
+  "issues": [],
+  "sha256": "35a3bd6f8f97d3261243e1c65e2876a946448c5af455f43ababf18bd8f6f3653",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.5.0"
+}