openxiangda 2.0.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/documentation/delivery.md +2 -0
  2. package/documentation/getting-started.md +4 -4
  3. package/documentation/manifest.json +3 -3
  4. package/package.json +27 -22
  5. package/releases/2.1.0.json +44 -0
  6. package/skills/manifest.json +1 -1
  7. package/skills/openxiangda-v2/SKILL.md +4 -4
  8. package/skills/openxiangda-v2/references/delivery.md +2 -0
  9. package/skills/openxiangda-v2/references/getting-started.md +4 -4
package/documentation/delivery.md CHANGED
@@ -21,6 +21,8 @@ pnpm openxiangda logs <deployment-id> --json
21
21
 
22
22
  默认目标为 `test`，平台内部标识为 `preproduction`。只读预览不生成构建产物、不上传制品、不提交 DeploymentRun；因此预览成功不能证明代码已通过检查。正式检查使用本地完整校验，再通过目标平台的 `configurationCompatibility` 核对同源规则、密钥、已有物理模型和登录提供方等只读条件；失败时停止后续步骤。只有启用了自定义 Nest 后端的应用才需要构建后端镜像及对应 Docker 环境。
23
23
 
24
+ 平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
25
+
24
26
  生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
25
27
 
26
28
  构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
package/documentation/getting-started.md CHANGED
@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
11
11
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
12
12
 
13
13
  ```bash
14
- pnpm dlx openxiangda@2.0.1 skill install --force
15
- pnpm dlx openxiangda@2.0.1 auth status --base-url <平台地址> --json
16
- pnpm dlx openxiangda@2.0.1 login --base-url https://platform.example.com
17
- pnpm dlx openxiangda@2.0.1 create my-app --base-url https://platform.example.com
14
+ pnpm dlx openxiangda@2.1.0 skill install --force
15
+ pnpm dlx openxiangda@2.1.0 auth status --base-url <平台地址> --json
16
+ pnpm dlx openxiangda@2.1.0 login --base-url https://platform.example.com
17
+ pnpm dlx openxiangda@2.1.0 create my-app --base-url https://platform.example.com
18
18
  cd my-app
19
19
  pnpm openxiangda context --json
20
20
  pnpm openxiangda dev
package/documentation/manifest.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schemaVersion": "openxiangda.documentation/v1",
3
- "version": "2.0.1",
3
+ "version": "2.1.0",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "8821ba34fc5f9f01572178136ae2602db5ee106644b1bd637ca80e065389a41f"
9
+ "sha256": "fe1ea2bb3653ab4c2b166e71d7138a9a6c4d2d6d84f3576b790cd04b32db22af"
10
10
  },
11
11
  {
12
12
  "id": "product-design",
@@ -96,7 +96,7 @@
96
96
  "id": "delivery",
97
97
  "title": "部署、生产晋级与恢复",
98
98
  "file": "delivery.md",
99
- "sha256": "361cf6a12a27155647d863b2ac39aeb57b6e6b5454ced6c13d3540891202a4fc"
99
+ "sha256": "e2a225019925ffa4855156e7dbde1a70c50a38804e7c0b206e1fbf81008ec078"
100
100
  },
101
101
  {
102
102
  "id": "upgrading",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openxiangda",
3
- "version": "2.0.1",
3
+ "version": "2.1.0",
4
4
  "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -58,13 +58,13 @@
58
58
  "antd-mobile": "5.42.3",
59
59
  "dayjs": "1.11.18",
60
60
  "docx-preview": "0.3.7",
61
- "openxiangda-cli": "2.0.1",
62
- "openxiangda-contracts": "2.0.0",
63
- "openxiangda-devkit-core": "2.0.0",
61
+ "openxiangda-cli": "2.1.0",
62
+ "openxiangda-contracts": "2.1.0",
63
+ "openxiangda-devkit-core": "2.1.0",
64
64
  "openxiangda-legacy": "npm:openxiangda@1.0.268",
65
- "openxiangda-mcp": "2.0.0",
66
- "openxiangda-nest": "2.0.0",
67
- "openxiangda-skill-kit": "2.0.0",
65
+ "openxiangda-mcp": "2.0.1",
66
+ "openxiangda-nest": "2.0.1",
67
+ "openxiangda-skill-kit": "2.0.1",
68
68
  "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
69
69
  },
70
70
  "peerDependencies": {
@@ -130,18 +130,21 @@
130
130
  },
131
131
  "openxiangdaRelease": {
132
132
  "schemaVersion": "openxiangda.release-notes/v1",
133
- "version": "2.0.1",
134
- "title": "OpenXiangda pnpm 工作区识别修复",
133
+ "version": "2.1.0",
134
+ "title": "OpenXiangda 平台托管应用镜像上传",
135
135
  "status": "reviewed",
136
- "summary": "修复独立安装的统一入口进入 pnpm 工作区时无法找到项目 CLI 的问题，继续严格使用该项目锁定的同代引擎。",
136
+ "summary": "应用 Nest 后端在本机构建为 OCI 镜像后，通过平台登录态分片上传。平台负责应用归属校验、镜像存储和运行时拉取，开发者无需取得平台维护者个人镜像仓库的推送权限。",
137
137
  "newFeatures": [
138
- "本次为 2.0.0 的修复发布，没有新增应用能力。"
138
+ "发现并优先使用平台 backendImageUpload 能力，导出 linux/amd64 OCI 镜像并上传有界分片。",
139
+ "上传前校验本地镜像大小和摘要，复用已完成的镜像回执，并恢复分片传输中断。"
139
140
  ],
140
141
  "fixes": [
141
- "从 pnpm 符号链接指向的真实包目录解析 openxiangda-cli，避免 WORKSPACE_ENGINE_DEPENDENCY_MISSING。"
142
+ "启用平台上传后，应用部署不再依赖开发者对平台维护者镜像仓库的推送权限。",
143
+ "Docker classic image store 不支持 OCI 导出时，返回明确的 builder 配置指引。"
142
144
  ],
143
145
  "affectedUsers": [
144
- "使用全局或独立安装的统一入口维护 pnpm 工作区的开发者。"
146
+ "声明可选 Nest 后端并通过 CLI 或 MCP 部署的 OpenXiangda 2.0 应用开发者。",
147
+ "维护共享应用运行时及平台镜像存储的平台管理员。"
145
148
  ],
146
149
  "compatibility": {
147
150
  "node": ">=24",
@@ -150,22 +153,24 @@
150
153
  "v2"
151
154
  ],
152
155
  "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
153
- "platformPolicy": "没有新增平台能力要求，部署仍执行目标平台预检。",
154
- "backendBuild": "Nest 镜像继续由开发者电脑上的 Docker 构建。",
156
+ "platformPolicy": "平台托管上传需要匹配的后端、Registry 和网关发布，并启用 backendImageUpload；旧平台继续使用既有构建合同。",
157
+ "backendBuild": "可选 Nest 后端仍在开发者电脑上使用 Docker Buildx 构建，需要支持 OCI exporter 的 builder。",
155
158
  "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
156
159
  },
157
160
  "upgradeSteps": [
158
- "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.0.1。",
159
- "在项目及其子目录运行 openxiangda version --json，核对工作区代际、项目引擎版本和解析来源。",
160
- "需要更新 V2 项目依赖时运行 openxiangda update install --target workspace，检查锁文件并完成项目验收。"
161
+ "平台管理员先按部署运行手册准备镜像存储与凭据，再部署匹配的后端和网关。",
162
+ "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.1.0。",
163
+ "更新 V2 项目锁定的工具链并刷新项目资料，核对平台上传能力后运行项目的 openxiangda deploy。"
161
164
  ],
162
165
  "knownLimitations": [
163
- "独立入口更新不会自动升级项目锁定的工具链，也不会迁移 V1 应用。",
164
- "已发布的 2.0.0 保持不可变；本修复不代表平台部署或业务验收已完成。"
166
+ "当前仅支持 linux/amd64 单平台 OCI 镜像；默认单镜像上限为 1Gi，由平台配置控制。",
167
+ "已声明但未启用的平台上传能力会阻止部署，避免回退到个人镜像仓库推送。",
168
+ "镜像保留与垃圾回收由平台运维单独管理；现有版本仍可能需要历史镜像进行部署或回滚。",
169
+ "托管镜像开始使用后，后端回滚必须保留 Registry、持久卷、凭据和网关读取路由。"
165
170
  ],
166
171
  "issues": [],
167
- "sha256": "6bba13f70a956b58412da587fc9d7b50dd279fea809eae2461dd3515321a83dd",
168
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.0.1"
172
+ "sha256": "d7f6a21ddc37b3d2439350bf17f5f4575192168944dc33efb15460f7d1854aff",
173
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.1.0"
169
174
  },
170
175
  "scripts": {
171
176
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.1.0.json ADDED
@@ -0,0 +1,44 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.1.0",
4
+ "title": "OpenXiangda 平台托管应用镜像上传",
5
+ "status": "reviewed",
6
+ "summary": "应用 Nest 后端在本机构建为 OCI 镜像后，通过平台登录态分片上传。平台负责应用归属校验、镜像存储和运行时拉取，开发者无需取得平台维护者个人镜像仓库的推送权限。",
7
+ "newFeatures": [
8
+ "发现并优先使用平台 backendImageUpload 能力，导出 linux/amd64 OCI 镜像并上传有界分片。",
9
+ "上传前校验本地镜像大小和摘要，复用已完成的镜像回执，并恢复分片传输中断。"
10
+ ],
11
+ "fixes": [
12
+ "启用平台上传后，应用部署不再依赖开发者对平台维护者镜像仓库的推送权限。",
13
+ "Docker classic image store 不支持 OCI 导出时，返回明确的 builder 配置指引。"
14
+ ],
15
+ "affectedUsers": [
16
+ "声明可选 Nest 后端并通过 CLI 或 MCP 部署的 OpenXiangda 2.0 应用开发者。",
17
+ "维护共享应用运行时及平台镜像存储的平台管理员。"
18
+ ],
19
+ "compatibility": {
20
+ "node": ">=24",
21
+ "workspaceGenerations": [
22
+ "v1",
23
+ "v2"
24
+ ],
25
+ "v1Policy": "V1 应用保持原代际、版本锁定与登录绑定。",
26
+ "platformPolicy": "平台托管上传需要匹配的后端、Registry 和网关发布，并启用 backendImageUpload；旧平台继续使用既有构建合同。",
27
+ "backendBuild": "可选 Nest 后端仍在开发者电脑上使用 Docker Buildx 构建，需要支持 OCI exporter 的 builder。",
28
+ "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
29
+ },
30
+ "upgradeSteps": [
31
+ "平台管理员先按部署运行手册准备镜像存储与凭据，再部署匹配的后端和网关。",
32
+ "在 Node.js 24 环境安装统一入口：npm install -g openxiangda@2.1.0。",
33
+ "更新 V2 项目锁定的工具链并刷新项目资料，核对平台上传能力后运行项目的 openxiangda deploy。"
34
+ ],
35
+ "knownLimitations": [
36
+ "当前仅支持 linux/amd64 单平台 OCI 镜像；默认单镜像上限为 1Gi，由平台配置控制。",
37
+ "已声明但未启用的平台上传能力会阻止部署，避免回退到个人镜像仓库推送。",
38
+ "镜像保留与垃圾回收由平台运维单独管理；现有版本仍可能需要历史镜像进行部署或回滚。",
39
+ "托管镜像开始使用后，后端回滚必须保留 Registry、持久卷、凭据和网关读取路由。"
40
+ ],
41
+ "issues": [],
42
+ "sha256": "d7f6a21ddc37b3d2439350bf17f5f4575192168944dc33efb15460f7d1854aff",
43
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.1.0"
44
+ }
package/skills/manifest.json CHANGED
@@ -4,7 +4,7 @@
4
4
  {
5
5
  "name": "openxiangda-v2",
6
6
  "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
7
- "sha256": "ed347cba6d08ce24ac83ecac078b579aa9b9f02088b7a0a99327a5ba3556f1cf"
7
+ "sha256": "3f1a2044254680d480e72ad0fb524967ed471a8c44bb9b0c2b9f226d7e834f43"
8
8
  }
9
9
  ]
10
10
  }
package/skills/openxiangda-v2/SKILL.md CHANGED
@@ -18,10 +18,10 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
18
18
  未创建工作区时使用本 Skill 随根包发布的精确版本：
19
19
 
20
20
  ```bash
21
- pnpm dlx openxiangda@2.0.1 auth status --base-url <平台地址> --json
22
- pnpm dlx openxiangda@2.0.1 login --base-url <平台地址>
23
- pnpm dlx openxiangda@2.0.1 create <应用目录> --base-url <同一平台地址>
24
- pnpm dlx openxiangda@2.0.1 skill install --force
21
+ pnpm dlx openxiangda@2.1.0 auth status --base-url <平台地址> --json
22
+ pnpm dlx openxiangda@2.1.0 login --base-url <平台地址>
23
+ pnpm dlx openxiangda@2.1.0 create <应用目录> --base-url <同一平台地址>
24
+ pnpm dlx openxiangda@2.1.0 skill install --force
25
25
  ```
26
26
 
27
27
  创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
package/skills/openxiangda-v2/references/delivery.md CHANGED
@@ -21,6 +21,8 @@ pnpm openxiangda logs <deployment-id> --json
21
21
 
22
22
  默认目标为 `test`，平台内部标识为 `preproduction`。只读预览不生成构建产物、不上传制品、不提交 DeploymentRun；因此预览成功不能证明代码已通过检查。正式检查使用本地完整校验，再通过目标平台的 `configurationCompatibility` 核对同源规则、密钥、已有物理模型和登录提供方等只读条件；失败时停止后续步骤。只有启用了自定义 Nest 后端的应用才需要构建后端镜像及对应 Docker 环境。
23
23
 
24
+ 平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
25
+
24
26
  生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
25
27
 
26
28
  构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
package/skills/openxiangda-v2/references/getting-started.md CHANGED
@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
11
11
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
12
12
 
13
13
  ```bash
14
- pnpm dlx openxiangda@2.0.1 skill install --force
15
- pnpm dlx openxiangda@2.0.1 auth status --base-url <平台地址> --json
16
- pnpm dlx openxiangda@2.0.1 login --base-url https://platform.example.com
17
- pnpm dlx openxiangda@2.0.1 create my-app --base-url https://platform.example.com
14
+ pnpm dlx openxiangda@2.1.0 skill install --force
15
+ pnpm dlx openxiangda@2.1.0 auth status --base-url <平台地址> --json
16
+ pnpm dlx openxiangda@2.1.0 login --base-url https://platform.example.com
17
+ pnpm dlx openxiangda@2.1.0 create my-app --base-url https://platform.example.com
18
18
  cd my-app
19
19
  pnpm openxiangda context --json
20
20
  pnpm openxiangda dev