openxiangda 2.18.1 → 2.18.2

package/documentation/application-foundation.md

@@ -195,3 +195,20 @@ crud: [{
 ```
 
 引用未声明字段按编译错误处理；低层 `data.resources[].fields[].sortable` 语义不变。
+
+## 资源详情路由声明 {#detail-route-code}
+
+Workflow 详情接管的资源侧绑定用模型级 `detailRouteCode` 表达，desktop/mobile 各引用一条
+前端路由；投影完整透传到 `data.resources[].detailRouteCode`，低层声明语义不变：
+
+```ts
+defineDataModel({
+  code: 'venue-reservations', name: '场地预约',
+  detailRouteCode: { desktop: 'reservation-detail', mobile: 'reservation-detail-mobile' },
+  fields: [/* ... */],
+})
+```
+
+两条路由必须已声明为 user surface、只带一个有界动态记录参数，且路由 capability 覆盖资源
+read 能力；桌面路由不位于 `/m/`，移动路由必须位于 `/m/`。模型声明出现未知属性时报
+`APP_MODEL_KEY_UNKNOWN` 编译错误——声明层的拼写错误不允许被静默丢弃。

package/documentation/declarations-cheatsheet.md

@@ -11,6 +11,7 @@
 | 视图 `list`/`form`/`detail` 的 `model` 可省略（继承视图模型）；显式声明时必须与 `crud[].model` 一致 | `list: { fields: [...] }` 即可，不必写 `model` |
 | 每个模型最多 20 个命名视图；命名视图需要稳定 `code` + `name` | `crud: [{ model: 'x', code: 'x-active', name: '进行中', ... }]` |
 | 新建视图的 `form.fields` 必须覆盖全部无默认必填字段，或显式 `generated.create: false` | 检查器会列出缺失字段 |
+| Workflow 详情接管的资源路由用模型级 `detailRouteCode` 表达（desktop/mobile 各引用一条 user surface 路由） | `defineDataModel({ code: 'x', detailRouteCode: { desktop: 'x-detail', mobile: 'x-detail-mobile' }, ... })` |
 
 ## 字段声明
 

package/documentation/getting-started.md

@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.18.1 skill install --force
-pnpm dlx openxiangda@2.18.1 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.18.1 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.18.1 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.18.2 skill install --force
+pnpm dlx openxiangda@2.18.2 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.18.2 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.18.2 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -171,9 +171,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.18.1 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.18.1 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.18.1 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.18.2 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.18.2 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.18.2 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.18.1",
+  "version": "2.18.2",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "6d8d950700fa6ec2d4aab485ea5d76c673c40c0835fbce1d5ad7683388cdb80d"
+      "sha256": "e37b86058ad684660ee8849db02cc23a222d80fd0bb4a9794692eb19384cb5d4"
     },
     {
       "id": "product-design",
@@ -48,13 +48,13 @@
       "id": "declarations-cheatsheet",
       "title": "声明速查：一次写对 config",
       "file": "declarations-cheatsheet.md",
-      "sha256": "cceae7c98fff0bfb5823979b4b7116614917a55647313d931074770b3b2a8c4c"
+      "sha256": "82ba34ccb40e1e8f9163f22bb92c3ea2925a28020682f266921b22a88d9faaff"
     },
     {
       "id": "application-foundation",
       "title": "业务模型与标准 CRUD",
       "file": "application-foundation.md",
-      "sha256": "28a4d727d773800e59e348287cd38ed011498b4ecab8a5ba0d21a4efade7d64e"
+      "sha256": "dd28e08c6ebbcb2651a216649182c8c46b1ab62a2853a4cece9f041f5da2cd15"
     },
     {
       "id": "appspec",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.18.1",
+  "version": "2.18.2",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,13 +60,13 @@
     "antd-mobile": "5.42.3",
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
-    "openxiangda-cli": "2.4.9",
+    "openxiangda-cli": "2.4.10",
     "openxiangda-contracts": "2.14.1",
-    "openxiangda-devkit-core": "2.14.0",
+    "openxiangda-devkit-core": "2.15.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.0.23",
+    "openxiangda-mcp": "2.0.24",
     "openxiangda-nest": "2.4.2",
-    "openxiangda-skill-kit": "2.1.7",
+    "openxiangda-skill-kit": "2.1.8",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -132,34 +132,33 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.18.1",
+    "version": "2.18.2",
     "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}）。"
+    "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": [
-      "使用 openxiangda 2.18.0 并在 CRUD 视图声明 user 用户面的应用开发者（应用此前表现为登录后整页空白）。"
+      "从 data.resources 迁移到模块化声明、需要资源详情路由由 Workflow 详情接管的应用（如数智工会 szgh-v2）。"
     ],
     "upgradeSteps": [
-      "应用精确依赖升级到 openxiangda 2.18.1 后重新运行 check 与部署；无需平台配合升级。"
+      "应用精确依赖升级到 openxiangda 2.18.2（openxiangda-devkit-core 2.15.0）后重新运行 check 与部署。"
     ],
     "knownLimitations": [
-      "“我的记录”的本人过滤仍是查询层展示过滤，非服务端授权边界（与 2.18.0 相同）。"
+      "detailRouteCode 校验沿用既有资源级规则；本次不改变共享纯校验器字节，configuration-compatibility/v2 的 validatorDigest 不变。"
     ],
     "issues": [],
     "compatibility": {
       "node": ">=24",
       "workspaceGenerations": "v2",
-      "platform": "无平台配合要求；契约与配置 bundle 字节不变。",
+      "platform": "无平台配合要求；contracts 共享校验器字节不变。",
       "v1": "不改变 V1 运行时或应用。"
     },
-    "sha256": "80e7d6fe82cf1b0475e15509aa9fda386cc03764fc69a352cef6bc9ea461bb9f",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.1"
+    "sha256": "029cced498e869e301d49a73a900beffb80a3b5c3183c34c8fb341f81853539a",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.2"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

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/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "c6a354c36f3261ea4a6f3ee2d6372def7b1420517594e027a8635be94195bc73"
+      "sha256": "2a463b5f8d6341de76dabe93b92b31100d5770a6be4bd66753f2e166b631aece"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

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

package/skills/openxiangda-v2/references/application-foundation.md

@@ -195,3 +195,20 @@ crud: [{
 ```
 
 引用未声明字段按编译错误处理；低层 `data.resources[].fields[].sortable` 语义不变。
+
+## 资源详情路由声明 {#detail-route-code}
+
+Workflow 详情接管的资源侧绑定用模型级 `detailRouteCode` 表达，desktop/mobile 各引用一条
+前端路由；投影完整透传到 `data.resources[].detailRouteCode`，低层声明语义不变：
+
+```ts
+defineDataModel({
+  code: 'venue-reservations', name: '场地预约',
+  detailRouteCode: { desktop: 'reservation-detail', mobile: 'reservation-detail-mobile' },
+  fields: [/* ... */],
+})
+```
+
+两条路由必须已声明为 user surface、只带一个有界动态记录参数，且路由 capability 覆盖资源
+read 能力；桌面路由不位于 `/m/`，移动路由必须位于 `/m/`。模型声明出现未知属性时报
+`APP_MODEL_KEY_UNKNOWN` 编译错误——声明层的拼写错误不允许被静默丢弃。

package/skills/openxiangda-v2/references/declarations-cheatsheet.md

@@ -11,6 +11,7 @@
 | 视图 `list`/`form`/`detail` 的 `model` 可省略（继承视图模型）；显式声明时必须与 `crud[].model` 一致 | `list: { fields: [...] }` 即可，不必写 `model` |
 | 每个模型最多 20 个命名视图；命名视图需要稳定 `code` + `name` | `crud: [{ model: 'x', code: 'x-active', name: '进行中', ... }]` |
 | 新建视图的 `form.fields` 必须覆盖全部无默认必填字段，或显式 `generated.create: false` | 检查器会列出缺失字段 |
+| Workflow 详情接管的资源路由用模型级 `detailRouteCode` 表达（desktop/mobile 各引用一条 user surface 路由） | `defineDataModel({ code: 'x', detailRouteCode: { desktop: 'x-detail', mobile: 'x-detail-mobile' }, ... })` |
 
 ## 字段声明
 

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

@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.18.1 skill install --force
-pnpm dlx openxiangda@2.18.1 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.18.1 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.18.1 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.18.2 skill install --force
+pnpm dlx openxiangda@2.18.2 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.18.2 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.18.2 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -171,9 +171,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.18.1 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.18.1 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.18.1 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.18.2 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.18.2 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.18.2 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/releases/2.0.0.json

@@ -1,50 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.0.0",
-  "title": "OpenXiangda 2.0 正式版",
-  "status": "reviewed",
-  "summary": "以统一入口使用两代工作区，新应用默认采用 V2。V2 提供从需求设计到 React 应用、平台数据权限和应用交付的完整工具链。",
-  "newFeatures": [
-    "统一入口识别最近的 V1/V2 工作区，优先使用项目已安装的锁定引擎；无本地 V1 引擎的旧工作区使用随入口固定的 V1 维护引擎。",
-    "新应用默认 V2：自然语言澄清产品需求，形成产品、页面、权限和架构设计基线，确认后再制定开发计划。",
-    "V2 提供标准 PC/移动端 CRUD、字段组件、Data API 权限、流程与协作能力；默认本地 React 连接平台测试环境，Nest 后端按需使用。",
-    "提供版本识别、分代更新、随包更新说明和 V1 到 V2 的只读迁移评估。"
-  ],
-  "fixes": [
-    "全局入口切换到 V2 后，旧 V1 工作区仍由 V1 执行，不再因同名命令使用错误代际。",
-    "项目工具链升级与全局入口升级明确分开；V1 维护渠道不再改写 latest。",
-    "两代 Skill 使用独立入口，V1 安装不再覆盖统一入口或清理 V2 Skill。"
-  ],
-  "affectedUsers": [
-    "新建应用的开发者",
-    "需要继续维护 V1 工作区的开发者",
-    "从 V2 alpha 升级的现有用户"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "workspaceGenerations": [
-      "v1",
-      "v2"
-    ],
-    "v1Policy": "保持现有配置、数据、流程、登录绑定与项目工具链代际；原 V1 CLI 可继续使用其原运行环境。",
-    "platformPolicy": "V2 应用部署前按平台 capabilities 和配置验证器预检；工具版本不能代替平台实际部署版本。",
-    "backendBuild": "Nest 镜像由开发者电脑上的 Docker 构建；普通 React/Nest 连接开发不要求本地平台或数据库。",
-    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。npm 不允许把 v1/v2 作为标签。"
-  },
-  "upgradeSteps": [
-    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.0.0。",
-    "进入已有项目运行 openxiangda version --json，核对工作区代际、实际引擎和解析来源。",
-    "运行 openxiangda update check 查看本项目更新；需要升级时执行 openxiangda update install --target workspace。",
-    "检查依赖与锁文件差异，刷新本项目 Skill，并完成项目检查、测试环境和真实角色业务验收后再晋级生产。",
-    "V2 能力满足、项目仍在测试阶段且迁移成本可控时，优先建议 V1 项目采用 V2；先完成项目评估、设计确认和迁移验收。"
-  ],
-  "knownLimitations": [
-    "V1 到 V2 首期仅提供本地源码迁移评估，不读取远端业务数据，也不自动迁移应用。",
-    "源码扫描不会证明远端权限、流程和数据完整性；迁移须按项目制定映射、演练和回滚方案。",
-    "内网或离线环境可读取随包说明；联网检查失败时保留当前工具与项目。",
-    "内部支持 Agent 独立交付和验收，不随此 npm 版本自动部署。"
-  ],
-  "issues": [],
-  "sha256": "a6100370946d253328c924c19f6577bac383c4633e3650d69b7ad378486ae880",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.0.0"
-}

package/releases/2.0.1.json

@@ -1,39 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.0.1",
-  "title": "OpenXiangda pnpm 工作区识别修复",
-  "status": "reviewed",
-  "summary": "修复独立安装的统一入口进入 pnpm 工作区时无法找到项目 CLI 的问题，继续严格使用该项目锁定的同代引擎。",
-  "newFeatures": [
-    "本次为 2.0.0 的修复发布，没有新增应用能力。"
-  ],
-  "fixes": [
-    "从 pnpm 符号链接指向的真实包目录解析 openxiangda-cli，避免 WORKSPACE_ENGINE_DEPENDENCY_MISSING。"
-  ],
-  "affectedUsers": [
-    "使用全局或独立安装的统一入口维护 pnpm 工作区的开发者。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "workspaceGenerations": [
-      "v1",
-      "v2"
-    ],
-    "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
-    "platformPolicy": "没有新增平台能力要求，部署仍执行目标平台预检。",
-    "backendBuild": "Nest 镜像继续由开发者电脑上的 Docker 构建。",
-    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
-  },
-  "upgradeSteps": [
-    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.0.1。",
-    "在项目及其子目录运行 openxiangda version --json，核对工作区代际、项目引擎版本和解析来源。",
-    "需要更新 V2 项目依赖时运行 openxiangda update install --target workspace，检查锁文件并完成项目验收。"
-  ],
-  "knownLimitations": [
-    "独立入口更新不会自动升级项目锁定的工具链，也不会迁移 V1 应用。",
-    "已发布的 2.0.0 保持不可变；本修复不代表平台部署或业务验收已完成。"
-  ],
-  "issues": [],
-  "sha256": "6bba13f70a956b58412da587fc9d7b50dd279fea809eae2461dd3515321a83dd",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.0.1"
-}

package/releases/2.1.0.json

@@ -1,44 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.1.0",
-  "title": "OpenXiangda 平台托管应用镜像上传",
-  "status": "reviewed",
-  "summary": "应用 Nest 后端在本机构建为 OCI 镜像后，通过平台登录态分片上传。平台负责应用归属校验、镜像存储和运行时拉取，开发者无需取得平台维护者个人镜像仓库的推送权限。",
-  "newFeatures": [
-    "发现并优先使用平台 backendImageUpload 能力，导出 linux/amd64 OCI 镜像并上传有界分片。",
-    "上传前校验本地镜像大小和摘要，复用已完成的镜像回执，并恢复分片传输中断。"
-  ],
-  "fixes": [
-    "启用平台上传后，应用部署不再依赖开发者对平台维护者镜像仓库的推送权限。",
-    "Docker classic image store 不支持 OCI 导出时，返回明确的 builder 配置指引。"
-  ],
-  "affectedUsers": [
-    "声明可选 Nest 后端并通过 CLI 或 MCP 部署的 OpenXiangda 2.0 应用开发者。",
-    "维护共享应用运行时及平台镜像存储的平台管理员。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "workspaceGenerations": [
-      "v1",
-      "v2"
-    ],
-    "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
-    "platformPolicy": "平台托管上传需要匹配的后端、Registry 和网关发布，并启用 backendImageUpload；旧平台继续使用既有构建合同。",
-    "backendBuild": "可选 Nest 后端仍在开发者电脑上使用 Docker Buildx 构建，需要支持 OCI exporter 的 builder。",
-    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
-  },
-  "upgradeSteps": [
-    "平台管理员先按部署运行手册准备镜像存储与凭据，再部署匹配的后端和网关。",
-    "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.1.0。",
-    "更新 V2 项目锁定的工具链并刷新项目资料，核对平台上传能力后运行项目的 openxiangda deploy。"
-  ],
-  "knownLimitations": [
-    "当前仅支持 linux/amd64 单平台 OCI 镜像；默认单镜像上限为 1Gi，由平台配置控制。",
-    "已声明但未启用的平台上传能力会阻止部署，避免回退到个人镜像仓库推送。",
-    "镜像保留与垃圾回收由平台运维单独管理；现有版本仍可能需要历史镜像进行部署或回滚。",
-    "托管镜像开始使用后，后端回滚必须保留 Registry、持久卷、凭据和网关读取路由。"
-  ],
-  "issues": [],
-  "sha256": "d7f6a21ddc37b3d2439350bf17f5f4575192168944dc33efb15460f7d1854aff",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.1.0"
-}

package/releases/2.1.1.json

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

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

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

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