openxiangda 2.59.1 → 2.59.3-http.0

package/releases/2.28.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.28.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.28.0：应用原操作自助诊断",
+  "summary": "应用管理员通过现有工作区查询原请求、持久命令、部署和受管文件的脱敏事实，减少依赖平台人员登录服务器定位问题的情况。",
+  "newFeatures": [
+    "logs 增加 request-id、command-id、deployment-run-id、file-id 四种互斥定位器，MCP 提供相同范围的 application_diagnostics 只读工具。",
+    "结果显示实际站点、应用、环境、时间窗口及观测时间；SDK 校验查询与响应关联，只保留受支持的元数据。"
+  ],
+  "fixes": [
+    "明确区分已观测、未观测和诊断暂不可用；未知结果不再被解释成原操作未执行，也不会触发换键重放。"
+  ],
+  "affectedUsers": [
+    "需要按原操作 ID 自助排查发布、工作流和文件状态的 OpenXiangda 2.0 应用管理员及开发者。"
+  ],
+  "upgradeSteps": [
+    "应用消费 openxiangda@2.28.0 并更新锁文件；使用已有工作区开发者登录，不需要服务器账号。",
+    "平台应提供 application.scoped-diagnostics@1；查询默认使用 test，生产环境需显式传 --environment production。",
+    "保留原操作 ID。request-id 默认查询最近一小时，也可传一对 UTC from/to，窗口最多 24 小时；其他定位器不接受时间窗口。"
+  ],
+  "knownLimitations": [
+    "诊断受应用管理权限和当前租户、环境约束；普通应用服务凭据不因此获得管理权限。",
+    "每次最多返回 50 条事实，可能标记截断；不返回业务正文、文件名、原始日志或密钥。",
+    "未观测不表示原写入未发生，已观测不表示业务验收完成。暂不可用时保留原键与输入，按提示继续查询。",
+    "此次新增能力不改变共享 Native 编译器摘要；公开包发行与实际站点部署分别验证。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "新诊断入口要求 application.scoped-diagnostics@1.0.0 或兼容 1.x；原 logs [deploymentId] 和未使用此能力的应用保持原行为。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "80c18512f5cb76850e738b9e802261af68e27f6582b3f686781da7c9d4367c2a",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.0"
+}

package/releases/2.28.1.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.28.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.28.1：后端镜像原制品上传恢复",
+  "summary": "上传中断后保留原 OCI 镜像，普通 deploy 重试直接从平台已有偏移或 ready 回执恢复，减少重建和重复传输。",
+  "newFeatures": [],
+  "fixes": [
+    "已导出的后端镜像不会再因为上传失败或响应丢失被立即删除；相同输入重试保持原摘要，已封存候选不再依赖 Docker 重建。",
+    "缓存绑定当前站点、租户、用户、应用环境和实际构建上下文，包含未提交源码；恢复前验证全部 blob，使用跨进程租约阻止重复上传。"
+  ],
+  "affectedUsers": [
+    "通过平台登录态分块上传后端镜像的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "应用消费 openxiangda@2.28.1 并更新锁文件。上传中断时保留工作区输入，恢复网络或登录后重复原 deploy 命令。",
+    "无需平台数据库迁移，也无需手工寻找 BuildKit 历史或镜像上传会话。"
+  ],
+  "knownLimitations": [
+    "最多保留 8 个候选、总预留空间 8 GiB、24 小时；平台单镜像上限超过 8 GiB 时继续原临时上传路径。缓存过期或被预算清理后需要重新构建。",
+    "源码、身份、环境、配置或工具版本变化会形成新候选；恢复原镜像不重新求值远程 FROM/RUN 输入。",
+    "本机上下文校验有 100000 条目、8 GiB、60 秒预算；构建期间源码变化会拒绝上传，需要保存完成后重试。",
+    "真实 Docker 导出及故障恢复、隔离的传输协议和发行门禁分别验证，不代表任何客户应用已发布或通过业务验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "复用既有 backendImageUpload 协议和 auth/whoami，不新增远端上传状态或服务器账号要求。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "762fa08d9c2818264ed9b65383f1ec60ad6bc4236978ee07cf0c19cdce45ad16",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.1"
+}

package/releases/2.29.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.29.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.29.0：金额提交后的声明式生命周期",
+  "summary": "模型可以声明金额提交后的合法状态变化、子记录履行状态和父记录锁定状态；编译时检查规则，平台在原 Native 写入和激活边界执行一致性保护。",
+  "newFeatures": [
+    "模型与 DataResource 增加可选 decimalReservationLifecycle，复用现有额度字段映射并派生 data.decimal-reservation-lifecycle@1.0.0。",
+    "应用编译器、平台纯编译器和 JSON Schema 同步支持有界声明；未知状态、重复或自身状态边、缺少 reserve 动作及锁定状态可新预留在发布前拒绝。"
+  ],
+  "fixes": [
+    "为已 committed 子记录的正常履行更新提供受约束的原 Data API 路径，继续保护金额、币种和主子关系。"
+  ],
+  "affectedUsers": [
+    "使用主子记录精确金额预留，且需要在审批提交金额后继续履行、关闭或解锁的 OpenXiangda 2.0 应用。"
+  ],
+  "upgradeSteps": [
+    "先确认目标平台支持 data.decimal-reservation-lifecycle@1.0.0，再安装 openxiangda@2.29.0 并更新锁文件。",
+    "在模型显式声明合法状态边、已履行子状态和锁定父状态；继续通过已授权 Data API update/transaction 与 expectedRevision 更新。",
+    "本能力不需要新增数据库迁移；新版本激活会检查现有关闭父记录，不自动改写历史状态。"
+  ],
+  "knownLimitations": [
+    "状态声明不授予资源、字段或行权限；reserved/released 子记录仍须走原受管审批或重新提交。",
+    "终止或作废不自动代表履行，也不会释放 committed 金额。每类最多 64 条边，两个状态集合各 1–16 项。",
+    "未声明的资源保留严格保护；回滚到不支持本能力的服务器前须停用依赖新声明的入口。",
+    "公开包发行与目标平台部署、应用适配及业务验收分别记录；包安装成功不代表目标环境具备运行能力。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "显式声明才要求 data.decimal-reservation-lifecycle@1.0.0；共享 Native validator 随新契约更新，按目标预检结果配套升级平台。",
+    "v1": "独立 V1 引擎和未声明生命周期的资源不受运行行为变更影响。"
+  },
+  "sha256": "967c751ef6dd40ae7e593bebef5ac48e94ad366272b6622702e05a89338fb021",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.29.0"
+}

package/releases/2.29.1.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.29.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.29.1：镜像上传失败的准确恢复指引",
+  "summary": "镜像上传因存储额度被拒绝时，保留安全额度数据并指向平台受管清理，停止立即重复请求；原候选仍可在处理后恢复。",
+  "newFeatures": [],
+  "fixes": [
+    "候选恢复错误保留真实 causeCode，额度拒绝只投影应用占用字节、镜像数、应用预算、本次请求字节和固定恢复标识，不再丢失可用于平台排查的安全数据。",
+    "额度不足不再误导重新登录或修复网络，也不会立即重试同一准入；登录、权限、网络及未知失败分别提供对应指引。",
+    "保留原候选 ID、镜像摘要、失效时间和恢复租约，处理后相同输入可继续原摘要上传。"
+  ],
+  "affectedUsers": [
+    "通过平台登录态上传后端镜像的 OpenXiangda 2.0 应用开发者与平台支持人员。"
+  ],
+  "upgradeSteps": [
+    "尚有待恢复原候选时，先保持原 SDK、源码、账号和目标，完成原上传后再升级；工具版本参与候选身份。",
+    "新的开发工作消费 openxiangda@2.29.1 并更新锁文件。额度错误先请平台核实受管保留与清理，再显式重试原 deploy 命令。无需平台数据库迁移。"
+  ],
+  "knownLimitations": [
+    "错误详情只包含服务器实际提供的安全字段，不能据此假定额度已经恢复或判断未提供的全局、租户预算。",
+    "retryable=false 表示额度需先处理；原候选仍受 24 小时、8 个候选、8 GiB 的既有本地保留界限约束。",
+    "本次不修改平台预算或镜像退休策略，不执行客户应用部署；客户现场计费和受保护引用仍须独立核实。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "复用现有镜像上传响应，缺少额度数据的旧平台不会被补造数据。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "057a446ac3871147ca22a80b059bf13c2510a341de93798e0326259c553bb382",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.29.1"
+}

package/releases/2.29.2.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.29.2",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.29.2：退役 Studio 专属工具链",
+  "summary": "移除已停止维护的 Studio 初始化、发现与绑定接口，保留普通应用创建、连接开发、源码托管和结构化命令输出。",
+  "newFeatures": [],
+  "fixes": [
+    "CLI 不再接受 Studio Project/ProvisioningRun 初始化参数，能力发现不再输出 toolchain.studio。",
+    "通用 JSON/JSONL 事件和模板摘要绑定使用独立 CLI 契约，不再依赖已退役产品。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda 2.0 工具链的开发者；仍调用 Studio 专属参数或导出的集成需要移除这些调用。"
+  ],
+  "upgradeSteps": [
+    "更新到 openxiangda@2.29.2 并更新项目锁文件；使用普通 create、dev 和发布流程。",
+    "移除 Studio 专属参数与导出。平台端退役部署须独立完成临时 Git 凭据撤权检查，不能仅凭 SDK 升级判定现场退役完成。"
+  ],
+  "knownLimitations": [
+    "已退役的 Studio 专属导出和参数不再兼容。",
+    "本次发行不包含新的平台 Agent 运行时，不自动部署平台或应用。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "普通应用开发和共享源码托管契约保持；平台退役按独立部署前置条件执行。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "5c26d50635ca43152e96c0017a9948f5c44cbfd8aff926cc4ff0da8971a3c49c",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.29.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.30.0.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.30.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.30.0：平台条件唯一键",
+  "summary": "模型可声明条件唯一键，统一约束普通 CRUD、导入和业务事务；编译器在发布前检查规则并识别目标平台是否支持。",
+  "newFeatures": [
+    "模型与数据资源支持有界 uniqueKeys 声明，可选择精确比较、NFKC 空白折叠或 ASCII 大写，并按文本空值或单选集合限定参与记录。",
+    "两端编译器、JSON Schema、声明诊断和能力清单使用一致契约，自动要求 data.unique-keys@1.0.0。未声明的模型不增加能力要求。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要跨并发写入保障业务编号或复合字段唯一性的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "更新到 openxiangda@2.30.0 并更新锁文件；在需要唯一性的模型声明 uniqueKeys，使用当前版本的数据与权限文档。",
+    "先确认目标平台实际提供 data.unique-keys@1.0.0，再激活测试版本。历史重复或超长数据会明确拒绝激活并保留原环境。",
+    "重复写入处理 HTTP 409 和规则标识；长度超限处理 HTTP 422。避免盲目重试创建，事务失败后按原业务状态恢复。"
+  ],
+  "knownLimitations": [
+    "每资源最多 8 条、每条 1–4 个键字段和最多 4 个 AND 条件；参与比较字段归一化后最多 256 个 UTF-8 字节。",
+    "已有规则的修改、删除和所用字段替换需要平台受管迁移；连接开发不能私自改变规则。",
+    "平台升级与 SDK 发行分别验收；npm 发行不代表客户节点已经上线。跨 PostgreSQL 大版本变更须先安排归一化索引的受管重建。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "声明规则时要求 data.unique-keys@1.0.0；普通应用沿用现有能力。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "cbe1a5766e0cc0d8948d54b6d2129320b5d2fbe1e8f7120874b9f56c774b1fcb",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.30.0"
+}

package/releases/2.31.0.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.0：缓存、排队与原子配额",
+  "summary": "应用可声明热点内容缓存、全局准入、可恢复的 Native 命令和整数配额。平台承担回源保护、受理幂等与事务内分配，React 和移动端 SDK 提供等待、提交及原结果恢复。",
+  "newFeatures": [
+    "data.concurrency 由两端共享编译器验证，缓存读取声明包含权限范围、有限参数、失效依赖和回源预算。",
+    "等待准入按可信主体合并重复请求，持久命令返回原操作回执，响应丢失和页面刷新后可继续核对结果。",
+    "整数配额支持立即分配、预占、确认、释放与到期；配额、业务记录、事件和结果在同一 Native 事务提交，受管模型阻止普通 CRUD 绕过。",
+    "openxiangda/react 和 openxiangda/mobile 提供 createManagedConcurrencyClient、useManagedCommand、ManagedCommandStatus 与 ManagedCommandGate。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要缓存、排队、限量申领、预约或抢票的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级到 openxiangda@2.31.0 并更新锁文件，按 docs/managed-concurrency.md 及完整声明示例配置资源和权限。",
+    "先确认目标平台已部署 data.managed-concurrency@1.0.0 及对应 SQL migration，再激活测试版本。未启用此声明的应用沿用原路径。",
+    "上线前按目标硬件、真实权限和业务规模验证完成速率、P95/P99、回源 SQL、锁等待及恢复时间；部署和容量验收独立于 npm 发行。",
+    "停用或切换不兼容版本前停止新受理并排空非终态命令，保留历史命令、分配及回执。"
+  ],
+  "knownLimitations": [
+    "首版执行编译后的 Native 原子动作，不把任意 JS、SQL 或第三方调用纳入原子事务。",
+    "Redis 故障时暂停新准入和缓存回源；临时等待位置不承诺持久，已持久受理命令可恢复。",
+    "缓存减少内容 SQL，当前身份和权限链路仍有数据库访问；不提供公共 CDN 发布或自动全量预热。",
+    "同一配额池和主体永久去重，释放后不会自动重新报名；新一轮业务使用新的权威资源或配额池。",
+    "资源保护上限不代表生产吞吐保证；公开包升级不会自动升级客户平台。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "声明并发能力时要求 data.managed-concurrency@1.0.0；同时声明业务唯一键时还要求 data.unique-keys@1.0.0。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "6258bae64bad0db43a319ecb6886a037952e0c77410edd6a790d18b8cd470645",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.0"
+}

package/releases/2.31.1.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.1：应用业务 Agent 任务声明",
+  "summary": "应用可以在现有 AI 操作上显式声明面向普通用户的业务任务、常见问法、只读辅助能力和输入字段查询绑定。编译器把这些信息并入同一个 AppVersion AI Catalog，平台按当前用户权限发现和执行。",
+  "newFeatures": [
+    "ai.agent.visibility 区分可独立办理的 task 与任务引用的只读 support；未声明的底层 CRUD 不自动成为普通用户任务。",
+    "任务可以声明 examples、aliases、supportOperations 和 inputLookups；编译器校验辅助操作只读、引用闭合和请求字段存在。",
+    "docs/backend.md、声明速查和 OpenXiangda 2.0 Skill 提供接入流程及访客预约示例。",
+    "并发能力前端指南覆盖热点读取、申请、排队、预占确认与原结果恢复，并标明已提供 API 和待实现封装。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "希望把业务操作接入平台助手或应用 Agent 的 OpenXiangda 2.0 应用开发者。",
+    "需要实现缓存、排队或限额场景前端的应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级到 openxiangda@2.31.1 并更新锁文件，先实现完整业务操作、授权和只读辅助查询，再按 docs/backend.md 声明 ai.agent。",
+    "在测试环境运行 check 与完整输入、缺失输入、同名对象、权限不足和重复提交场景；发布应用版本后核对 AI Catalog 摘要与当前环境 Head。",
+    "平台服务端须部署支持显式业务任务发现的版本；npm 包发布本身不会升级平台或自动公开旧应用操作。",
+    "并发前端接入按 docs/managed-concurrency-frontend.md 选择模式，先核对已导出的 API 与目标平台能力。"
+  ],
+  "knownLimitations": [
+    "本次包仅增加业务任务元数据与编译校验；交互卡片资源、持久 Interaction 和 MCP Apps Host 由后续平台与应用批次交付。",
+    "现有独立 MCP Facade 的写入预览与确认协议保持原样；平台自有 Agent 的自动写入由平台执行层和权限边界负责。",
+    "旧应用的底层 CRUD 不会自动转换为普通用户任务，需应用维护者完成业务语义与辅助能力接入。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "平台业务 Agent 任务发现需配套部署支持 ai.agent 元数据的服务端版本。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "37c61ac4c9b17a8ca688cc9e1f38f4ed106754a7342e1a6aa9b2095e954a5118",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.1"
+}

package/releases/2.31.2.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.2",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.2：普通业务任务可自动执行写入",
+  "summary": "应用可为普通业务写任务显式声明免通用二次确认。用户明确要求办理且信息完整时，平台 Agent 可直接执行并返回回执；权限、版本绑定与幂等仍由平台和应用校验。",
+  "newFeatures": [
+    "backend.operations[].ai.confirmation 支持普通 write 显式选择 none；省略时仍为 required。",
+    "编译器、Catalog 契约、应用开发指南及 Skill 同步说明确认策略。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "开发预约、报修等普通业务 Agent 写任务的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级到 openxiangda@2.31.2 并更新锁文件，在业务操作的 ai 声明中按需显式设置 confirmation: 'none'。",
+    "在预发验证完整输入、缺失输入、对象歧义、无权访问和同一幂等键重放，再发布应用版本并核对 Catalog 与环境 Head。",
+    "平台 Agent 执行层须支持受管直接执行；npm 包发布本身不更新平台。"
+  ],
+  "knownLimitations": [
+    "免确认仅适用于普通 write；destructive 和 external 继续要求确认，read 不确认。",
+    "独立 MCP Facade 的预览/确认协议未在本轮改变。",
+    "交互卡片资源与持久 Interaction 仍需后续批次交付。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "需配套支持业务 Agent 受管直接执行的服务端版本。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "be6fa650ee197a3949c17aec11af97e833e70a1d8461992c3e25063c238cff1e",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.2"
+}

package/releases/2.31.3.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.3",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.3：业务 Agent 结果卡片声明",
+  "summary": "应用任务可以声明已完成操作的只读结果卡片。编译器把展示字段限制在响应 Schema 的顶层标量属性，并将声明随应用版本发布。",
+  "newFeatures": [
+    "backend.operations[].ai.agent.resultCard 支持标题和最多 8 个结果字段，并校验字段引用、类型及边界。",
+    "开发文档、速查表与 AI Skill 同步给出结果卡片示例和接入规则。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要在平台助手会话中展示预约、报修等业务回执的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda 并更新锁文件；在业务操作的 responseSchema.properties 中声明可展示的标量字段，再可选配置 agent.resultCard。",
+    "在预发验证完整业务结果、字段缺失和刷新恢复；卡片展示需要配套平台服务端与前端版本。"
+  ],
+  "knownLimitations": [
+    "本版只定义已完成业务操作的只读结果卡片；待补信息表单、持久 Interaction 与应用自定义 React Host 尚未发布。",
+    "结果卡片不改变应用权限、业务执行或既有 MCP Facade 的确认协议。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "结果卡片呈现需要配套平台 Agent 回执投影和会话前端。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "56e36516118cda6a6d2d4029dc25e593a1b4e76198279cf27cf9e58bf8dc392e",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.3"
+}

package/releases/2.31.4.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.4",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.4：业务 Agent 标准填写卡片声明",
+  "summary": "应用任务可以声明有界填写卡片；平台助手在缺少信息或业务选项有歧义时让用户续填，并将提交绑定到已发布的固定业务能力。",
+  "newFeatures": [
+    "backend.operations[].ai.agent.inputCard 支持短文本、多行文本和只读选项，编译器检查必填字段、控件类型、选项响应 Schema 和执行策略。",
+    "开发文档、声明速查表与 AI Skill 同步说明填写卡片、辅助查询和业务 handler 的接入规则。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要让普通用户在平台助手会话中补齐报修、预约等业务参数的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda 并更新锁文件；先实现有权限和幂等保障的业务操作，再为同一操作声明包含全部必填字段的 agent.inputCard。",
+    "选择控件绑定同应用只读辅助操作，响应明确声明最多 20 项的 items[{value,label}]；在预发验证刷新续填、重复提交、权限拒绝和真实业务回读。",
+    "平台服务端、Worker、数据库迁移和会话前端需要配套发布后，填写卡片才会在对话中出现。"
+  ],
+  "knownLimitations": [
+    "首版只有平台标准控件；应用自定义 React 卡片 Host/SDK 是后续独立单元。",
+    "填写卡片只适用于已显式开放、免通用二次确认的普通写任务；破坏性和外部动作仍需独立确认协议。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "填写和续接需要配套 Agent Interaction 服务、Worker、SQL 迁移与 SSE 前端。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "d025a3b8411a27ab3259f1b3272ff551b3856c9d121f4cb3bdfda9a821760b83",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.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.31.6.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.6",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.6：补充 Agent 卡片浏览器构建规范",
+  "summary": "明确自定义 Agent 卡片的浏览器独立运行要求，防止脚本构建成功但在隔离 iframe 中无法显示。",
+  "newFeatures": [],
+  "fixes": [
+    "Vite 单文件 IIFE 示例明确替换 process.env.NODE_ENV，并要求在无同源 sandbox 与 CSP 下验证卡片握手和提交消息。"
+  ],
+  "affectedUsers": [
+    "开发应用 Agent 自定义卡片的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "在卡片专用 Vite 配置中加入示例的生产环境替换，重新构建并在隔离浏览器 iframe 中验收。"
+  ],
+  "knownLimitations": [
+    "本版只补充构建文档；卡片消息桥仍为平台限定协议。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "沿用已发布的 Agent Center 卡片资源解析服务和 iframe Host。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "3e1ffae9d677ad5c0c5e70030f34067bdc76c5751afe7045a77b51d40f641cad",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.6"
+}

package/releases/2.31.7.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.7",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.7：后端受控核验所选组织人员",
+  "summary": "应用后端可在已声明的业务操作内核验所选人员，姓名、工号与部门由平台组织架构提供。",
+  "newFeatures": [
+    "增加 selected-user 目录声明和 BusinessDirectoryService.selectedUser，按声明投影组织身份字段并返回核验快照。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要管理员代录、身份纠正或针对所选组织人员执行业务操作的 V2 应用。"
+  ],
+  "upgradeSteps": [
+    "升级应用工具链，并先部署支持 directory.selected-user 1.0.0 的平台；在具体后端操作声明所需字段和目录读取权限。"
+  ],
+  "knownLimitations": [
+    "只支持同租户有效组织人员；未声明能力、无目录权限或人员不可用时明确拒绝。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "新增能力需要支持 directory.selected-user 1.0.0 的平台；既有 current-initiator 行为不变。",
+    "v1": "独立 V1 引擎不受影响。"
+  },
+  "sha256": "8843f2ad58d915c2b9158821b6640bc4453a5e0e6f6066d918fda0e9dc168ccd",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.7"
+}

package/releases/2.31.8.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.8",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.8：富文本图片与原通知投递恢复",
+  "summary": "支持具名动作的富文本托管图片，并公开按原消息查询、恢复失败投递的用户态接口。",
+  "newFeatures": [
+    "NotificationService 增加 listMessages、listDeadLetters、replayDeadLetter，固定应用环境并保留平台管理权限。"
+  ],
+  "fixes": [
+    "managedFiles 作者配置与 Native 编译支持精确 text.rich 字段，避免借用其他图片字段授权。"
+  ],
+  "affectedUsers": [
+    "使用具名动作编辑富文本或需要后台管理通知投递的 V2 应用。"
+  ],
+  "upgradeSteps": [
+    "升级工具链；富文本插图依赖对应平台编译支持，开发态已有记录上传需平台开发态附件 RLS 修复。",
+    "通知死信 messageId 过滤和来源关联需对应平台版本；管理员分别授予 read、content:read、delivery:retry 权限。"
+  ],
+  "knownLimitations": [
+    "投影阶段尚无消息时死信关联字段为空；已解决死信保持既有 not-found 响应，客户端应刷新状态。",
+    "SDK 和平台源码验证不代替目标应用实际图片上传、通知投递及权限验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "新增富文本声明和通知来源过滤需同步支持本次变更的平台；不扩大普通用户发送权限。",
+    "v1": "独立 V1 引擎不受影响。"
+  },
+  "sha256": "e30dad108c478ee6cce5a1632cbd620cbf650999c9d2fd39973482c2edb01ad9",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.8"
+}

package/releases/2.31.9.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.9",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.9：审批凭据绑定与附件预览修复",
+  "summary": "修复登录面刷新后既有审批凭据失配，以及流程附件预览遗漏 CSRF 请求头的问题。",
+  "newFeatures": [],
+  "fixes": [
+    "工作流操作保留签发详情时的 CSRF 绑定，登录面刷新不会将已签发操作错误地改用新凭据。",
+    "流程附件元数据、封面缩略图与文件内容通过 SDK 携带所需请求头，保留实例和字段授权。",
+    "审批确认弹窗持续展示操作失败提示，便于用户了解未完成状态。"
+  ],
+  "affectedUsers": [
+    "使用任务或实例审批、流程附件预览的 V2 应用。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda 至 2.31.9 并重新构建应用，CLI 同批次更新模板依赖。",
+    "发布后核对真实审批提交、业务状态回读和封面预览；不需要修改角色权限或数据库。"
+  ],
+  "knownLimitations": [
+    "网络结果不明的写操作不会自动重试，应先查询原操作状态。",
+    "原始文件 URL 仍不代替带授权头的 SDK 文件预览，HTML 等附件的服务端隔离策略保持不变。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "沿用既有工作流 Surface、一次性命令凭据与文件授权契约，无服务端放宽。",
+    "v1": "独立 V1 引擎不受影响。"
+  },
+  "sha256": "451b5b993046436de85f8f1aefd3acdad4677efe5754969d0adb5c6c8a9758b1",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.9"
+}