openxiangda 2.20.3 → 2.21.0

package/releases/2.1.1.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.1.1",
+  "title": "OpenXiangda 应用源码托管",
+  "status": "reviewed",
+  "summary": "私有化平台通过共享 Forgejo 管理应用源码。创建应用时自动初始化私有仓库并推送代码，应用管理员自动获得仓库管理权限，开发者使用长期 Git 凭据。",
+  "newFeatures": [
+    "既有 PLATFORM_ADMIN 自动获得共享 Git 服务全部已有和新建仓库的管理权限。",
+    "source resolve/clone 支持仅凭平台与仓库 URL、使用当前登录态读取源码，不安装或执行应用脚本。",
+    "新增 source status、source setup 和 source push 命令，支持初始化恢复和已有工作区接入。",
+    "创建应用后自动提交并推送初始源码，通过系统凭据管理器保存个人 Git 凭据。",
+    "配套平台支持首次部署前浏览源码及最近提交，并核验部署关联的提交已经推送。"
+  ],
+  "fixes": [
+    "应用源码可直接保留在平台托管仓库中，减少对开发者个人 Git 服务的依赖。",
+    "显式导入保留原 origin 为 external-source，初始化重试保留已有未提交修改，冲突推送不覆盖远端提交。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda 2.0 创建应用或接入平台源码仓库的开发者。",
+    "维护内部私有化平台和应用管理员权限的平台管理员。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
+    "platformPolicy": "自动源码托管需要匹配的平台后端、管理前端和网关，并配置 OPENXIANGDA_SOURCE_*；未启用的站点保持原创建行为。",
+    "gitCredential": "支持 macOS Keychain、Windows Git Credential Manager，以及 Linux 已安装的 Git Credential Manager 或 libsecret。",
+    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
+  },
+  "upgradeSteps": [
+    "平台管理员配置共享 Forgejo、源码入口和专用凭据派生密钥，部署匹配的平台版本；长期保留密钥及 Git 数据。",
+    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.1.1。",
+    "更新 V2 工作区工具链；新应用自动接入，已有应用运行 openxiangda source setup --import 接入。",
+    "完成修改后运行 openxiangda source push -m 描述，再按现有检查和部署流程交付。"
+  ],
+  "knownLimitations": [
+    "当前仅同步应用管理员新增授权，不同步撤销或删除。",
+    "导入推送当前分支，不自动迁移全部历史分支、标签及 LFS 对象。",
+    "制品仍在本地构建；提交存在性核验不构成服务端构建证明。",
+    "新源码功能不依赖 Studio；Studio 旧代码移除属于独立后续工作。"
+  ],
+  "issues": [],
+  "sha256": "f7341eb21e1489c684ee03eed31568063dfad01bfe345f914552bd51b7357f84",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.1.1"
+}

package/releases/2.10.0.json

@@ -0,0 +1,42 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.10.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.10.0：通知已读回执基础能力",
+  "summary": "浏览器与 Nest SDK 增加通知投递详情、已读回执缓存和单次刷新接口，应用通过平台消息与投递标识使用钉钉已读查询。",
+  "newFeatures": [
+    "浏览器与 Nest SDK 同步提供 getNotificationMessage、getDingTalkCardReadReceipt 和 refreshDingTalkCardReadReceipt，并公开对应类型。",
+    "配套平台保存卡片查询标识，持久化单投递查询任务，区分已读、未读、未知、不可查询和查询失败。",
+    "配套平台通用化钉钉卡片发送、查询及总预算，并按资源配置准备和投递并发。"
+  ],
+  "fixes": [
+    "配套平台将钉钉 HTTP 403 QpsLimitForApi 识别为可退避重试的限流响应，保留创建请求结果未知时的既有处理边界。"
+  ],
+  "affectedUsers": [
+    "需要查询钉钉卡片已读状态或使用平台通知 SDK 的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎和已有应用不变。",
+    "platformPolicy": "已读接口需要匹配的平台后端、通知回执追加迁移，以及通知读取和内容读取权限。",
+    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
+  },
+  "upgradeSteps": [
+    "先部署匹配的平台后端及追加迁移，按实际钉钉额度配置统一的发送、查询和总预算。",
+    "将应用精确依赖升级到 openxiangda 2.10.0，更新锁文件，并通过标准检查。",
+    "使用平台消息 ID 和投递 ID 查询缓存或请求一次刷新；应用负责选择消息、分组和后续业务轮询。",
+    "在测试环境验证实际投递和已读回执，再使用同一应用候选晋级生产。"
+  ],
+  "knownLimitations": [
+    "一次上游查询针对一个 processQueryKey 下最多 20 名收件人；本版本不提供跨消息批量查询或自动全量轮询。",
+    "历史投递没有保存查询标识时返回不可查询，不能推断为未读；查询遵循钉钉提供方的 24 小时窗口。",
+    "包发布、平台部署与真实消息验收分别记录；本版本不会自动补发历史失败或未知通知。"
+  ],
+  "issues": [],
+  "sha256": "a1be367ab9c5de6b66ec8dd02724af71611183d99ddb9dae861e6253c58875df",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.10.0"
+}

package/releases/2.11.0.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.11.0",
+  "status": "reviewed",
+  "title": "工作区登录隔离与工具链升级指引",
+  "summary": "平台开发者会话按工作区隔离，CLI、MCP 与自动刷新共用本地会话；补齐 V1 采用 V2 的建议及 CLI、Skill、MCP 升级步骤。本版也包含主线已审查的数据事件捕获策略。",
+  "newFeatures": [
+    "login --cwd 与 auth --cwd 明确选择工作区；创建应用前可在目标目录登录，初始化保留受管会话文件。",
+    "V1 入口展示 V2 采用建议及迁移评估指引，文档说明 CLI、Skill 与 MCP 的版本刷新。",
+    "应用可用 events.capturePolicies 按资源声明 all 或 subscribed，编译为不可变的操作事件捕获计划。"
+  ],
+  "fixes": [
+    "默认登录态改为工作区 .openxiangda/session.json，停止读取旧全局会话；本地文件优先于 CI 环境凭据。",
+    "刷新、退出与 MCP 授权检查固定工作区来源，嵌套应用不会继承父应用账号，损坏或平台不符的文件不会换用其他身份。",
+    "登录文件使用原子写入、0600 权限及自动 Git 忽略，初始化不替换凭据内容。"
+  ],
+  "affectedUsers": [
+    "使用 CLI、MCP 或多个应用工作区的开发者。",
+    "从 V1 评估 V2 的用户，以及需要减少无消费者事件写入的 Native 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspacePolicy": "升级后在每个工作区重新登录；不自动复制旧全局或其他工作区的令牌。",
+    "platformPolicy": "平台登录与授权协议不变；远端检查和部署需要平台的 Native configurationCompatibility 校验器摘要与本版工具链匹配。采用 events.capturePolicies 还需要 events.capture-policy 1.0.0。"
+  },
+  "upgradeSteps": [
+    "使用项目包管理器更新并锁定 OpenXiangda 依赖，刷新 Skill 并重启 MCP 客户端。",
+    "远端检查和部署前确认工具链与平台为配套版本；出现 OPENXIANGDA_CONFIGURATION_VALIDATOR_MISMATCH 时先升级不匹配的一端，保留当前源码和候选。",
+    "已有项目在根目录运行 `openxiangda login --base-url <platform>`，再运行 `openxiangda auth status` 检查授权。",
+    "新项目先运行 `openxiangda login --cwd my-app --base-url <platform>`，然后 `openxiangda create my-app --base-url <platform>`。",
+    "CI 仅在没有本地会话文件时使用成对 OPENXIANGDA_BASE_URL 与 OPENXIANGDA_TOKEN。",
+    "采用事件捕获策略前先升级支持该能力的平台，确认事件历史要求，并完成测试环境验收后晋级同一应用版本。"
+  ],
+  "knownLimitations": [
+    "钉钉支持的 DWS 授权仍由 DWS 自己管理，不与平台会话混用。",
+    "V1 业务不会自动迁移到 V2。subscribed 不保留未声明操作的历史，恢复 all 不能补造历史事件。"
+  ],
+  "issues": [],
+  "sha256": "a6383deacc92dc3e058909c7db537e1a1bf29fc00fbb04345225c1f4f70f23c3",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.11.0"
+}

package/releases/2.12.0.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.12.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.12.0：平台原生数据自动化",
+  "summary": "数据事件可直接触发平台 Native 数据动作，省去应用 HTTP 接收链路；发布计划固定捕获字段与目标资源，业务效果与执行结果原子提交。",
+  "newFeatures": [
+    "events.subscriptions.execution 支持 native-data v1 声明式 create/update/delete，无需 Nest 应用后端。",
+    "共享编译器自动派生事件捕获字段及目标模型摘要，新增 events.native-data-actions 能力检查。"
+  ],
+  "fixes": [
+    "保留旧 Webhook 消费者与处理器契约，运维查询区分 Native 执行计划。",
+    "包含已合并的后台入口状态修复与 PC 优先开发引导，菜单缺失、无权限及未知地址分别展示。"
+  ],
+  "affectedUsers": [
+    "使用平台数据自动化和 OpenXiangda V2 事件订阅的应用。",
+    "平台维护者必须同步升级匹配的共享 Native 校验器；V1 业务引擎保持独立。"
+  ],
+  "upgradeSteps": [
+    "先部署支持 events.native-data-actions 1.0.0、同版共享 Native 校验器和 SQL 扩展迁移的平台后端。",
+    "将应用依赖升级到 openxiangda 2.12.0 并按普通测试发布、验收和生产晋级流程交付。",
+    "简单数据动作按 execution 显式启用，外部 Webhook 与自定义代码继续使用现有处理器。"
+  ],
+  "knownLimitations": [
+    "首版 Native 动作仅支持明确源资源的数据事件，最多 16 个操作、每个 32 字段及 64 KiB 输入，不执行脚本、SQL 或 HTTP。",
+    "不兼容的目标模型变化会停止旧动作并报告错误；回退平台前需停用并排空 Native 动作。",
+    "按需事件不能重放从未捕获的历史；权限过滤的轻量操作历史由配套平台提供。",
+    "发行包验证不能代替客户环境的实际部署及容量测试。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "events.native-data-actions 1.0.0，匹配共享 Native 校验器与 Native action SQL 迁移",
+    "v1": "独立 legacy-v1 引擎，不引入兼容桥"
+  },
+  "issues": [],
+  "sha256": "ae2cf493d03c916d22f093d366ac8c7f9d8cf0d0cbc71d6ab5db99fc34617738",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.12.0"
+}

package/releases/2.13.0.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.13.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.13.0：原版 OpenDesign 设计体验",
+  "summary": "通过轻量入口直接使用 OpenDesign 原版桌面与完整 CLI，默认先设计和验证原型再实现应用；设计资源进入 AppSpec 评审摘要，PC 与移动字段支持应用作用域内的视觉设计。",
+  "newFeatures": [
+    "design open/status/cli 发现原版安装、连接原版动态服务并透传完整 CLI 和原版 MCP；保留参数、标准输入输出、退出码与取消。",
+    "AppSpec assets 固定设计系统和原型依赖，评审与原测试提交的资源摘要可复核。",
+    "PC Provider 接收应用主题，弹层、消息及移动字段继承应用设计作用域。",
+    "同版 Skill、CLI docs 和平台 MCP 提供原版开发流程及精选 OpenDesign 离线参考。"
+  ],
+  "fixes": [
+    "替换与用户目标冲突的默认外观和固定设备限制，复用字段行为并允许完善整体设计。",
+    "防止原生 --cwd、--json 和 MCP 参数被享搭分发层截获，避免误运行系统同名 od。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda V2 开发新界面、改版和原型的应用开发者。",
+    "采用 AppSpec 原型资源评审或应用主题的 V2 工作区。"
+  ],
+  "upgradeSteps": [
+    "将应用锁定的 openxiangda 升级到 2.13.0，并刷新当前版本 Skill 和工作区指引。",
+    "从 OpenDesign 官方发行页安装原版，运行 openxiangda design open；在原版中选择已有本地 Agent 或配置所需提供商。",
+    "使用 design cli --help 查看完整原生命令；将实际采用的原型及依赖交接到 AppSpec assets 后验证业务实现。"
+  ],
+  "knownLimitations": [
+    "macOS 桌面发现针对官方 arm64 0.22.2 验证；其他平台和源码安装使用绝对路径 OPENXIANGDA_OPENDESIGN_CLI 或 OD_BIN，未声称完成各平台桌面验收。",
+    "npm 包不包含 OpenDesign 桌面二进制；原版更新、模型登录、云媒体和连接器按原版配置与权限使用。",
+    "原版桌面导入等受授权上下文保护的操作可能需要桌面选择目录；桥接不伪造 token。",
+    "设计资源检查最多 128 文件、单文件 2 MiB、总计 8 MiB；大媒体留在原版项目并导出有界审阅产物。",
+    "原型与包验证不代表生产应用已经部署或完成实际业务验收。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "本轮不增加平台后端接口或数据库迁移要求",
+    "v1": "保持独立 legacy-v1 引擎"
+  },
+  "issues": [],
+  "sha256": "bd50c7e044926d5d7d4f44bbe17827c2f1758f6b6e9ae258d8eb27594379ee98",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.0"
+}

package/releases/2.13.1.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.13.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.13.1：管理后台优先的应用结构规范",
+  "summary": "明确标准管理后台是 OpenXiangda 2.0 应用骨架，并规定 OpenDesign 在后台与用户端 PC/移动端的页面归属和交接边界。",
+  "newFeatures": [
+    "Skill、中文前端资料和 OpenDesign 工作流新增后台骨架优先规则。",
+    "新应用模板 AGENTS 明确后台、用户端 PC 和移动端的分层开发与验收入口。"
+  ],
+  "fixes": [
+    "禁止使用单页 HTML、iframe 或独立假后台替代标准管理后台。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda 2.0 创建应用、设计页面或维护应用模板的 AI 和开发者。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda 与 openxiangda-cli 到 2.13.1。",
+    "刷新项目 Skill，并按后台骨架优先规则重新检查页面归属和发布验收。"
+  ],
+  "knownLimitations": [
+    "本版本只更新规范、模板和发布资料，不自动改造已有应用页面。",
+    "标准审批、通知和具体业务流程仍需按应用需求声明和验收。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "本轮不增加平台后端接口或数据库迁移要求",
+    "v1": "保持独立 legacy-v1 引擎"
+  },
+  "issues": [],
+  "sha256": "3be803becc123e1cfafd76b7e217c660a78d2e62f9d3cc7092c33872a1bf07b6",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.1"
+}

package/releases/2.13.2.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.13.2",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.13.2：管理后台优先规范同步",
+  "summary": "将标准管理后台优先和 OpenDesign 页面归属规则同步到统一包、CLI 与 Skill 包，确保新应用开发遵循同一应用结构。",
+  "newFeatures": [
+    "统一包、CLI 和 Skill 包同步应用骨架与 OpenDesign 页面边界规范。"
+  ],
+  "fixes": [
+    "防止用户端原型、单页 HTML 或 iframe 被误当作管理后台。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda 2.0 创建应用和执行 AI 辅助开发的开发者。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda、openxiangda-cli 和 openxiangda-skill-kit 到本版本。",
+    "刷新项目 Skill 后重新执行应用结构和入口验收。"
+  ],
+  "knownLimitations": [
+    "本版本更新规范和模板，不自动改造已有应用。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "本轮不增加平台后端接口或数据库迁移要求",
+    "v1": "保持独立 legacy-v1 引擎"
+  },
+  "issues": [],
+  "sha256": "8925c3252c55e2bec1d1cdf755151777650b3ac6f8b7c82576760761dca6a786",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.2"
+}

package/releases/2.14.0.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.14.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.14.0：匿名公开预约契约闭环",
+  "summary": "为匿名公开数据读取和提交补齐固定过滤、服务端生成字段、跨资源预约规则校验与同路由多策略支持，并统一客户端、编译器和平台契约。",
+  "newFeatures": [
+    "匿名公开策略支持固定服务端过滤、服务端随机令牌生成和跨资源 schedule 校验；提交事务返回 generated 字段。",
+    "同一用户路由可以按设备或资源声明多条匿名策略，浏览器客户端以策略码隔离 bootstrap 缓存并显式协商客户端契约版本。",
+    "匿名公开客户端支持公开列表/详情读取、草稿提交回执和受控的文件、富文本及子表字段投影。"
+  ],
+  "fixes": [
+    "修复匿名公开策略把合法驼峰字段名（例如 visitDate、openAt、qrToken）按全小写稳定 code 错误拒绝的问题；JSON Schema、Devkit 和原生编译器现在使用统一字段 code 规则。",
+    "平台服务端强制应用公开过滤，匿名草稿过期时清理关联文件，并在缺少客户端版本声明时收窄 source hosting 与 OAuth 能力。"
+  ],
+  "affectedUsers": [
+    "需要在没有平台账号的情况下读取公开数据或提交草稿的 OpenXiangda 2.0 应用开发者。",
+    "使用匿名预约、服务端生成核验令牌或跨资源提交校验的应用，以及部署匹配平台服务端的运维人员。"
+  ],
+  "upgradeSteps": [
+    "先部署包含匿名公开固定过滤、生成字段和 schedule 校验的匹配平台组合，再将应用精确依赖升级到 openxiangda 2.14.0。",
+    "刷新项目 Skill 和工作区指引，重新生成契约并运行项目 check、test、build；匿名策略中的字段引用可继续使用合法驼峰命名。",
+    "在测试环境验证跨浏览器草稿隔离、幂等提交、停用前置资源拒绝和管理员核验，再使用同一测试版本晋级生产。"
+  ],
+  "knownLimitations": [
+    "schedule 首版只表达有界的预约窗口复核，不提供容量配额、取消改期、通知或审批流程；这些能力需要单独的应用变更评审。",
+    "匿名公开接口仍只接受策略声明的固定过滤和字段投影，不能由调用方动态追加筛选、排序或投影。",
+    "发行包和平台部署检查不能替代目标环境的真实角色、浏览器和性能验收。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v2"
+    ],
+    "platform": "需要匹配 OpenXiangda 2.0 匿名公开策略、固定过滤、服务端生成字段和 schedule 校验的服务端契约；V1 引擎保持独立。",
+    "v1": "不改变 V1 运行时或应用。"
+  },
+  "issues": [],
+  "sha256": "5b2dfbcf66a0e14d8619914b1d19123f84d35640978ffac4a6c2bef3e8deef8a",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.14.0"
+}

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"
+}