openxiangda 2.12.0 → 2.13.0

package/documentation/product-design.md

@@ -64,11 +64,11 @@ AppSpec 是唯一设计记录位置。`app.md` 是总纲与目录，详细规则
 
 页面必须记录初始加载、刷新、首次空数据、筛选无结果、错误、无权限、提交中、成功、明确失败、结果未知及并发冲突的适用性。公共状态可引用共用设计，逐页写差异；不适用时写具体理由。详细逐页检查与标准方案见[交互模式](./interaction-patterns.md)。
 
-管理后台默认只在 PC 操作，页面规格写明“后台仅 PC，移动不适用”即可，不为材料完整度扩出手机后台。只有用户端有明确手机任务时才设计对应移动页面。页面设计同时选择标准 CRUD、后台自定义页或独立 user 页；报表等专业交互应主动评估成熟组件与开源库，按[前端选型](./frontend.md#component-selection)记录选择与理由。
+页面规格依据真实用户任务说明设备范围；不以历史后台 PC 约定限制必要移动任务，也不为材料完整度增加没有使用场景的页面。页面设计同时选择标准 CRUD、后台自定义页或独立 user 页；报表等专业交互应主动评估成熟组件与开源库，按[前端选型](./frontend.md#component-selection)记录选择与理由。
 
 ## AppSpec 材料模板 {#templates}
 
-应用资料放在 `product/`（来源与 PRD）、`experience/`（旅程和逐页规格）、`design/`（视觉、权限和架构）、`reviews/`（评审）下。它们都是 `appspec/` 内单层 Markdown；不要使用嵌套页面目录。只为实际需要的材料建文件，不复制一批“已确认”示例。
+应用资料放在 `product/`（来源与 PRD）、`experience/`（旅程和逐页规格）、`design/`（视觉、权限和架构）、`reviews/`（评审）下。AppSpec 记录仍用这些目录内单层 Markdown；视觉设计包和自包含原型放在 `design/system`、`design/prototypes` 下，通过 assets 纳入评审，详见[设计工作流](./design-workflow.md)。只为实际需要的材料建文件，不复制一批“已确认”示例。
 
 设计文件采用下面的受限 YAML；按实际类型和稳定 ID 修改。`documents` 引用本文件依赖的其他设计、总纲、CAP 或 ADR，不能引用 ChangeSpec 形成计划与基线循环。正文保存详细设计；来源可在正文引用脱敏文件或 HTTPS 链接。
 
@@ -141,4 +141,4 @@ context 的 `readyForImplementation` 为真时才制定具体实现任务，把
 - [Design OS，固定提交](https://github.com/buildermethods/design-os/tree/529dedb43bfec24b2cbb128f26dd8cbc6143f754)（MIT）。
 - [Spec Kit，固定提交](https://github.com/github/spec-kit/tree/4a7341a93d944d6efe153b71da4a1adb9c2b578c)（MIT）。
 
-视觉收敛与体验检查可参考 [Impeccable](https://github.com/pbakaus/impeccable/tree/831cabee8b4bc1a2b66e5ae22003e9a19b57d464) 与 [DESIGN.md](https://github.com/google-labs-code/design.md/tree/9bf8eae67128b6cc55ad9bf86665767deb4c11cd) 的方法（Apache-2.0）。本专题不承诺这些项目的当前版本或排名，也不因案例要求增加平台功能。
+有界面影响的工作默认通过 design open / design cli 使用原版 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](./design-workflow.md)。原版运行时拥有完整设计资源和工作流；随包方法与 Craft 仅作离线参考。

package/documentation/reference/cli.md

@@ -7,6 +7,7 @@
 | `pnpm openxiangda auth` | 只读 | 只读核验指定平台授权，不登录或刷新会话 |
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
+| `pnpm openxiangda design` | 远端变更 | 打开 OpenDesign 原版并透传完整原生 CLI；写入范围由原生命令决定 |
 | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
 | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |

package/documentation/testing.md

@@ -28,7 +28,7 @@ CI、离线开发或尚未发布的候选包使用 `pnpm openxiangda check --loc
 
 Web 默认保留开发服务回环访问检查。按需 Nest 使用 `tsx --test` 发现项目中的业务测试；没有用例时只有零项测试，不能当成业务已验收。浏览器目录 `apps/web/e2e/` 起初只有编写说明，添加本应用的 `*.spec.ts` 后运行 `pnpm test:e2e`；真实角色验收绑定 AppSpec 和指定测试版本。
 
-修改资源时验证声明、实际交付端的字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。管理后台默认仅 PC，不要求移动后台验收；只有已确认的用户移动页面需要验证移动交互。用允许角色验证成功，用禁止角色验证页面、操作、行和字段边界；存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责，应用不重复搭建平台数据库测试。
+修改资源时验证声明、实际交付端的字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。按实际设计的目标设备验证交互；存在移动办理任务时验证对应移动页面，不受历史后台 PC 约定限制。用允许角色验证成功，用禁止角色验证页面、操作、行和字段边界；存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责，应用不重复搭建平台数据库测试。
 
 应用入口或导航变更必须从平台应用列表实际点击进入，再验证应用根路径、登录返回和刷新后的深链接。使用后台的应用检查 `/admin` 进入首个有权菜单、自定义页只出现一个 Shell、菜单切换与未保存保护、无权限拒绝；纯用户应用验证其声明首页，不强制增加后台。直达开发者给出的 `/home` 或报表链接通过，不能替代平台实际入口验收。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "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.3.1",
+    "openxiangda-cli": "2.4.0",
     "openxiangda-contracts": "2.11.0",
-    "openxiangda-devkit-core": "2.8.0",
+    "openxiangda-devkit-core": "2.9.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.0.16",
+    "openxiangda-mcp": "2.0.17",
     "openxiangda-nest": "2.3.2",
-    "openxiangda-skill-kit": "2.0.20",
+    "openxiangda-skill-kit": "2.1.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -132,41 +132,44 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.12.0",
+    "version": "2.13.0",
     "status": "reviewed",
-    "title": "OpenXiangda 2.12.0：平台原生数据自动化",
-    "summary": "数据事件可直接触发平台 Native 数据动作，省去应用 HTTP 接收链路；发布计划固定捕获字段与目标资源，业务效果与执行结果原子提交。",
+    "title": "OpenXiangda 2.13.0：原版 OpenDesign 设计体验",
+    "summary": "通过轻量入口直接使用 OpenDesign 原版桌面与完整 CLI，默认先设计和验证原型再实现应用；设计资源进入 AppSpec 评审摘要，PC 与移动字段支持应用作用域内的视觉设计。",
     "newFeatures": [
-      "events.subscriptions.execution 支持 native-data v1 声明式 create/update/delete，无需 Nest 应用后端。",
-      "共享编译器自动派生事件捕获字段及目标模型摘要，新增 events.native-data-actions 能力检查。"
+      "design open/status/cli 发现原版安装、连接原版动态服务并透传完整 CLI 和原版 MCP；保留参数、标准输入输出、退出码与取消。",
+      "AppSpec assets 固定设计系统和原型依赖，评审与原测试提交的资源摘要可复核。",
+      "PC Provider 接收应用主题，弹层、消息及移动字段继承应用设计作用域。",
+      "同版 Skill、CLI docs 和平台 MCP 提供原版开发流程及精选 OpenDesign 离线参考。"
     ],
     "fixes": [
-      "保留旧 Webhook 消费者与处理器契约，运维查询区分 Native 执行计划。",
-      "包含已合并的后台入口状态修复与 PC 优先开发引导，菜单缺失、无权限及未知地址分别展示。"
+      "替换与用户目标冲突的默认外观和固定设备限制，复用字段行为并允许完善整体设计。",
+      "防止原生 --cwd、--json 和 MCP 参数被享搭分发层截获，避免误运行系统同名 od。"
     ],
     "affectedUsers": [
-      "使用平台数据自动化和 OpenXiangda V2 事件订阅的应用。",
-      "平台维护者必须同步升级匹配的共享 Native 校验器；V1 业务引擎保持独立。"
+      "使用 OpenXiangda V2 开发新界面、改版和原型的应用开发者。",
+      "采用 AppSpec 原型资源评审或应用主题的 V2 工作区。"
     ],
     "upgradeSteps": [
-      "先部署支持 events.native-data-actions 1.0.0、同版共享 Native 校验器和 SQL 扩展迁移的平台后端。",
-      "将应用依赖升级到 openxiangda 2.12.0 并按普通测试发布、验收和生产晋级流程交付。",
-      "简单数据动作按 execution 显式启用，外部 Webhook 与自定义代码继续使用现有处理器。"
+      "将应用锁定的 openxiangda 升级到 2.13.0，并刷新当前版本 Skill 和工作区指引。",
+      "从 OpenDesign 官方发行页安装原版，运行 openxiangda design open；在原版中选择已有本地 Agent 或配置所需提供商。",
+      "使用 design cli --help 查看完整原生命令；将实际采用的原型及依赖交接到 AppSpec assets 后验证业务实现。"
     ],
     "knownLimitations": [
-      "首版 Native 动作仅支持明确源资源的数据事件，最多 16 个操作、每个 32 字段及 64 KiB 输入，不执行脚本、SQL 或 HTTP。",
-      "不兼容的目标模型变化会停止旧动作并报告错误；回退平台前需停用并排空 Native 动作。",
-      "按需事件不能重放从未捕获的历史；权限过滤的轻量操作历史由配套平台提供。",
-      "发行包验证不能代替客户环境的实际部署及容量测试。"
+      "macOS 桌面发现针对官方 arm64 0.22.2 验证；其他平台和源码安装使用绝对路径 OPENXIANGDA_OPENDESIGN_CLI 或 OD_BIN，未声称完成各平台桌面验收。",
+      "npm 包不包含 OpenDesign 桌面二进制；原版更新、模型登录、云媒体和连接器按原版配置与权限使用。",
+      "原版桌面导入等受授权上下文保护的操作可能需要桌面选择目录；桥接不伪造 token。",
+      "设计资源检查最多 128 文件、单文件 2 MiB、总计 8 MiB；大媒体留在原版项目并导出有界审阅产物。",
+      "原型与包验证不代表生产应用已经部署或完成实际业务验收。"
     ],
     "compatibility": {
       "node": ">=24",
-      "platform": "events.native-data-actions 1.0.0，匹配共享 Native 校验器与 Native action SQL 迁移",
-      "v1": "独立 legacy-v1 引擎，不引入兼容桥"
+      "platform": "本轮不增加平台后端接口或数据库迁移要求",
+      "v1": "保持独立 legacy-v1 引擎"
     },
     "issues": [],
-    "sha256": "ae2cf493d03c916d22f093d366ac8c7f9d8cf0d0cbc71d6ab5db99fc34617738",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.12.0"
+    "sha256": "bd50c7e044926d5d7d4f44bbe17827c2f1758f6b6e9ae258d8eb27594379ee98",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.0.0.json

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

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

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

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