openxiangda 2.28.0 → 2.28.1

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 +13 -1
  2. package/documentation/getting-started.md +7 -7
  3. package/documentation/manifest.json +3 -3
  4. package/package.json +21 -24
  5. package/releases/2.28.1.json +34 -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 +13 -1
  9. package/skills/openxiangda-v2/references/getting-started.md +7 -7
package/documentation/delivery.md CHANGED
@@ -48,6 +48,17 @@ pnpm openxiangda logs <deployment-id> --json
48
48
 
49
49
  平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
50
50
 
51
+ 上传失败后，本机保留原 OCI 制品，错误的 `details` 包含候选 ID、原 digest、失效时间及脱敏原因码。
52
+ 恢复网络或登录后，在原工作区执行同一条 `pnpm openxiangda deploy`：相同构建输入、账号、平台、
53
+ 应用和环境会校验原制品并从平台保存的偏移继续；即使 Docker 暂时不可用也能恢复已经构建的镜像。
54
+ 完成响应丢失时同样查询原摘要的 ready 回执。源码（包括未提交文件）、权限主体或目标变化会创建新候选，
55
+ 不会冒充原上传。上传鉴权仍在平台执行；本地缓存不授予部署权限。
56
+
57
+ 缓存保留最多 24 小时、8 个候选、总预算 8 GiB；空间不足时仅回收未被使用的旧候选。
58
+ 仅当平台单镜像上限不超过 8 GiB 时启用本地恢复，较大的平台配额保留原上传路径，不降低平台允许的镜像大小。
59
+ 缓存和登录凭据分开，位于本机用户私有目录。过期或已经回收的候选需重新构建；已有 DeploymentRun
60
+ 的未知结果仍查询原运行，镜像上传恢复不会重新发起已提交的部署。
61
+
51
62
  生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
52
63
 
53
64
  构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
@@ -58,7 +69,8 @@ pnpm openxiangda status <deployment-id> --watch
58
69
 
59
70
  网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
60
71
 
61
- 重复发布直接使用当前源码重新构建。pnpm、Docker 和平台可以自行提供构建缓存，Devkit 不维护另一套工作区摘要或候选状态。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
72
+ 新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
73
+ 该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
62
74
 
63
75
  ## 测试环境验收
64
76
 
package/documentation/getting-started.md CHANGED
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
68
68
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
69
69
 
70
70
  ```bash
71
- pnpm dlx openxiangda@2.28.0 skill install --force
72
- pnpm dlx openxiangda@2.28.0 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.28.0 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.28.0 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.28.1 skill install --force
72
+ pnpm dlx openxiangda@2.28.1 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.28.1 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.28.1 create my-app --base-url https://platform.example.com
75
75
  cd my-app
76
76
  pnpm openxiangda context --json
77
77
  pnpm openxiangda dev
@@ -174,9 +174,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
174
174
  无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
175
175
 
176
176
  ```bash
177
- pnpm dlx openxiangda@2.28.0 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.28.0 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.28.0 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.28.1 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.28.1 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.28.1 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
package/documentation/manifest.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schemaVersion": "openxiangda.documentation/v1",
3
- "version": "2.28.0",
3
+ "version": "2.28.1",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "e8be6499d3a6493926f5cd71243562a267325a0b800a511ebc31cf841ddfa08e"
9
+ "sha256": "4c1b210bbfaf06f1fd4713178ffcc134b5464b1d14ae93bf5c859f9aef5383cc"
10
10
  },
11
11
  {
12
12
  "id": "product-design",
@@ -114,7 +114,7 @@
114
114
  "id": "delivery",
115
115
  "title": "部署、生产晋级与恢复",
116
116
  "file": "delivery.md",
117
- "sha256": "fe26351024801784640c876efd3e9816294fc41b4a41fd719856e17425adc106"
117
+ "sha256": "29ab3c1d878af989fcc3a3198d878d6344dc00b711df898251d1c757f0531156"
118
118
  },
119
119
  {
120
120
  "id": "upgrading",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openxiangda",
3
- "version": "2.28.0",
3
+ "version": "2.28.1",
4
4
  "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -60,13 +60,13 @@
60
60
  "antd-mobile": "5.42.3",
61
61
  "dayjs": "1.11.18",
62
62
  "docx-preview": "0.3.7",
63
- "openxiangda-cli": "2.5.22",
63
+ "openxiangda-cli": "2.5.23",
64
64
  "openxiangda-contracts": "2.24.0",
65
- "openxiangda-devkit-core": "2.26.0",
65
+ "openxiangda-devkit-core": "2.27.0",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
- "openxiangda-mcp": "2.0.46",
67
+ "openxiangda-mcp": "2.0.47",
68
68
  "openxiangda-nest": "2.7.1",
69
- "openxiangda-skill-kit": "2.3.20",
69
+ "openxiangda-skill-kit": "2.3.21",
70
70
  "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
71
71
  },
72
72
  "peerDependencies": {
@@ -132,40 +132,37 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.28.0",
135
+ "version": "2.28.1",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.28.0：应用原操作自助诊断",
138
- "summary": "应用管理员通过现有工作区查询原请求、持久命令、部署和受管文件的脱敏事实，减少依赖平台人员登录服务器定位问题的情况。",
139
- "newFeatures": [
140
- "logs 增加 request-id、command-id、deployment-run-id、file-id 四种互斥定位器，MCP 提供相同范围的 application_diagnostics 只读工具。",
141
- "结果显示实际站点、应用、环境、时间窗口及观测时间；SDK 校验查询与响应关联，只保留受支持的元数据。"
142
- ],
137
+ "title": "OpenXiangda 2.28.1：后端镜像原制品上传恢复",
138
+ "summary": "上传中断后保留原 OCI 镜像，普通 deploy 重试直接从平台已有偏移或 ready 回执恢复，减少重建和重复传输。",
139
+ "newFeatures": [],
143
140
  "fixes": [
144
- "明确区分已观测、未观测和诊断暂不可用；未知结果不再被解释成原操作未执行，也不会触发换键重放。"
141
+ "已导出的后端镜像不会再因为上传失败或响应丢失被立即删除；相同输入重试保持原摘要，已封存候选不再依赖 Docker 重建。",
142
+ "缓存绑定当前站点、租户、用户、应用环境和实际构建上下文，包含未提交源码；恢复前验证全部 blob，使用跨进程租约阻止重复上传。"
145
143
  ],
146
144
  "affectedUsers": [
147
- "需要按原操作 ID 自助排查发布、工作流和文件状态的 OpenXiangda 2.0 应用管理员及开发者。"
145
+ "通过平台登录态分块上传后端镜像的 OpenXiangda 2.0 应用开发者。"
148
146
  ],
149
147
  "upgradeSteps": [
150
- "应用消费 openxiangda@2.28.0 并更新锁文件；使用已有工作区开发者登录，不需要服务器账号。",
151
- "平台应提供 application.scoped-diagnostics@1；查询默认使用 test，生产环境需显式传 --environment production。",
152
- "保留原操作 ID。request-id 默认查询最近一小时，也可传一对 UTC from/to，窗口最多 24 小时；其他定位器不接受时间窗口。"
148
+ "应用消费 openxiangda@2.28.1 并更新锁文件。上传中断时保留工作区输入，恢复网络或登录后重复原 deploy 命令。",
149
+ "无需平台数据库迁移，也无需手工寻找 BuildKit 历史或镜像上传会话。"
153
150
  ],
154
151
  "knownLimitations": [
155
- "诊断受应用管理权限和当前租户、环境约束；普通应用服务凭据不因此获得管理权限。",
156
- "每次最多返回 50 条事实，可能标记截断；不返回业务正文、文件名、原始日志或密钥。",
157
- "未观测不表示原写入未发生，已观测不表示业务验收完成。暂不可用时保留原键与输入，按提示继续查询。",
158
- "此次新增能力不改变共享 Native 编译器摘要；公开包发行与实际站点部署分别验证。"
152
+ "最多保留 8 个候选、总预留空间 8 GiB、24 小时；平台单镜像上限超过 8 GiB 时继续原临时上传路径。缓存过期或被预算清理后需要重新构建。",
153
+ "源码、身份、环境、配置或工具版本变化会形成新候选；恢复原镜像不重新求值远程 FROM/RUN 输入。",
154
+ "本机上下文校验有 100000 条目、8 GiB、60 秒预算；构建期间源码变化会拒绝上传，需要保存完成后重试。",
155
+ "真实 Docker 导出及故障恢复、隔离的传输协议和发行门禁分别验证，不代表任何客户应用已发布或通过业务验收。"
159
156
  ],
160
157
  "issues": [],
161
158
  "compatibility": {
162
159
  "node": ">=24",
163
160
  "workspaceGenerations": "v2",
164
- "platform": "新诊断入口要求 application.scoped-diagnostics@1.0.0 或兼容 1.x；原 logs [deploymentId] 和未使用此能力的应用保持原行为。",
161
+ "platform": "复用既有 backendImageUpload 协议和 auth/whoami，不新增远端上传状态或服务器账号要求。",
165
162
  "v1": "独立 V1 引擎和工作区不受影响。"
166
163
  },
167
- "sha256": "80c18512f5cb76850e738b9e802261af68e27f6582b3f686781da7c9d4367c2a",
168
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.0"
164
+ "sha256": "762fa08d9c2818264ed9b65383f1ec60ad6bc4236978ee07cf0c19cdce45ad16",
165
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.1"
169
166
  },
170
167
  "scripts": {
171
168
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.28.1.json ADDED
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.28.1",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.28.1：后端镜像原制品上传恢复",
6
+ "summary": "上传中断后保留原 OCI 镜像，普通 deploy 重试直接从平台已有偏移或 ready 回执恢复，减少重建和重复传输。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "已导出的后端镜像不会再因为上传失败或响应丢失被立即删除；相同输入重试保持原摘要，已封存候选不再依赖 Docker 重建。",
10
+ "缓存绑定当前站点、租户、用户、应用环境和实际构建上下文，包含未提交源码；恢复前验证全部 blob，使用跨进程租约阻止重复上传。"
11
+ ],
12
+ "affectedUsers": [
13
+ "通过平台登录态分块上传后端镜像的 OpenXiangda 2.0 应用开发者。"
14
+ ],
15
+ "upgradeSteps": [
16
+ "应用消费 openxiangda@2.28.1 并更新锁文件。上传中断时保留工作区输入，恢复网络或登录后重复原 deploy 命令。",
17
+ "无需平台数据库迁移，也无需手工寻找 BuildKit 历史或镜像上传会话。"
18
+ ],
19
+ "knownLimitations": [
20
+ "最多保留 8 个候选、总预留空间 8 GiB、24 小时；平台单镜像上限超过 8 GiB 时继续原临时上传路径。缓存过期或被预算清理后需要重新构建。",
21
+ "源码、身份、环境、配置或工具版本变化会形成新候选；恢复原镜像不重新求值远程 FROM/RUN 输入。",
22
+ "本机上下文校验有 100000 条目、8 GiB、60 秒预算；构建期间源码变化会拒绝上传，需要保存完成后重试。",
23
+ "真实 Docker 导出及故障恢复、隔离的传输协议和发行门禁分别验证，不代表任何客户应用已发布或通过业务验收。"
24
+ ],
25
+ "issues": [],
26
+ "compatibility": {
27
+ "node": ">=24",
28
+ "workspaceGenerations": "v2",
29
+ "platform": "复用既有 backendImageUpload 协议和 auth/whoami，不新增远端上传状态或服务器账号要求。",
30
+ "v1": "独立 V1 引擎和工作区不受影响。"
31
+ },
32
+ "sha256": "762fa08d9c2818264ed9b65383f1ec60ad6bc4236978ee07cf0c19cdce45ad16",
33
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.1"
34
+ }
package/skills/manifest.json CHANGED
@@ -4,7 +4,7 @@
4
4
  {
5
5
  "name": "openxiangda-v2",
6
6
  "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。",
7
- "sha256": "87568d43231b261b889782237c8bbe6f2d6237190c4f7ce74cd754e83f9336fd"
7
+ "sha256": "d292d7381a0128d1ee2b0d73a2714eb32fbe6efba6e89f9a80ff8ec32ef3492f"
8
8
  }
9
9
  ]
10
10
  }
package/skills/openxiangda-v2/SKILL.md CHANGED
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
40
40
  未创建工作区时使用本 Skill 随根包发布的精确版本：
41
41
 
42
42
  ```bash
43
- pnpm dlx openxiangda@2.28.0 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.28.0 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.28.0 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.28.0 skill install --force
43
+ pnpm dlx openxiangda@2.28.1 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.28.1 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.28.1 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.28.1 skill install --force
47
47
  ```
48
48
 
49
49
  创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
package/skills/openxiangda-v2/references/delivery.md CHANGED
@@ -48,6 +48,17 @@ pnpm openxiangda logs <deployment-id> --json
48
48
 
49
49
  平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
50
50
 
51
+ 上传失败后，本机保留原 OCI 制品，错误的 `details` 包含候选 ID、原 digest、失效时间及脱敏原因码。
52
+ 恢复网络或登录后，在原工作区执行同一条 `pnpm openxiangda deploy`：相同构建输入、账号、平台、
53
+ 应用和环境会校验原制品并从平台保存的偏移继续；即使 Docker 暂时不可用也能恢复已经构建的镜像。
54
+ 完成响应丢失时同样查询原摘要的 ready 回执。源码（包括未提交文件）、权限主体或目标变化会创建新候选，
55
+ 不会冒充原上传。上传鉴权仍在平台执行；本地缓存不授予部署权限。
56
+
57
+ 缓存保留最多 24 小时、8 个候选、总预算 8 GiB；空间不足时仅回收未被使用的旧候选。
58
+ 仅当平台单镜像上限不超过 8 GiB 时启用本地恢复，较大的平台配额保留原上传路径，不降低平台允许的镜像大小。
59
+ 缓存和登录凭据分开，位于本机用户私有目录。过期或已经回收的候选需重新构建；已有 DeploymentRun
60
+ 的未知结果仍查询原运行，镜像上传恢复不会重新发起已提交的部署。
61
+
51
62
  生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
52
63
 
53
64
  构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
@@ -58,7 +69,8 @@ pnpm openxiangda status <deployment-id> --watch
58
69
 
59
70
  网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
60
71
 
61
- 重复发布直接使用当前源码重新构建。pnpm、Docker 和平台可以自行提供构建缓存，Devkit 不维护另一套工作区摘要或候选状态。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
72
+ 新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
73
+ 该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
62
74
 
63
75
  ## 测试环境验收
64
76
 
package/skills/openxiangda-v2/references/getting-started.md CHANGED
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
68
68
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
69
69
 
70
70
  ```bash
71
- pnpm dlx openxiangda@2.28.0 skill install --force
72
- pnpm dlx openxiangda@2.28.0 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.28.0 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.28.0 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.28.1 skill install --force
72
+ pnpm dlx openxiangda@2.28.1 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.28.1 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.28.1 create my-app --base-url https://platform.example.com
75
75
  cd my-app
76
76
  pnpm openxiangda context --json
77
77
  pnpm openxiangda dev
@@ -174,9 +174,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
174
174
  无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
175
175
 
176
176
  ```bash
177
- pnpm dlx openxiangda@2.28.0 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.28.0 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.28.0 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.28.1 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.28.1 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.28.1 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回