openxiangda 2.27.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 (14) hide show
  1. package/documentation/delivery.md +37 -1
  2. package/documentation/getting-started.md +7 -7
  3. package/documentation/manifest.json +5 -5
  4. package/documentation/reference/cli.md +1 -1
  5. package/documentation/reference/mcp.md +53 -0
  6. package/package.json +23 -27
  7. package/releases/2.28.0.json +37 -0
  8. package/releases/2.28.1.json +34 -0
  9. package/skills/manifest.json +1 -1
  10. package/skills/openxiangda-v2/SKILL.md +4 -4
  11. package/skills/openxiangda-v2/references/cli.md +1 -1
  12. package/skills/openxiangda-v2/references/delivery.md +37 -1
  13. package/skills/openxiangda-v2/references/getting-started.md +7 -7
  14. package/skills/openxiangda-v2/references/mcp.md +53 -0
package/documentation/delivery.md CHANGED
@@ -2,6 +2,30 @@
2
2
 
3
3
  应用开发者从工作区执行 `pnpm openxiangda`。平台负责应用版本、运行状态和恢复决定。工具链自身的 npm 发布由平台维护者负责，应用项目无需复制发包脚本或平台验证矩阵。
4
4
 
5
+ ## 按原操作自助诊断
6
+
7
+ 保留原 requestId、commandId、DeploymentRun ID 或 fileId；应用管理员可在已有
8
+ 登录工作区查询，不需要服务器账号。目标平台需提供 `application.scoped-diagnostics@1`。
9
+
10
+ ```bash
11
+ pnpm openxiangda logs --request-id <原请求ID> --json
12
+ pnpm openxiangda logs --command-id <原命令UUID> --json
13
+ pnpm openxiangda logs --file-id <受管文件UUID> --environment test --json
14
+ pnpm openxiangda logs --deployment-run-id <原RunUUID> --environment production --json
15
+ ```
16
+
17
+ requestId 默认最近一小时，结果会显示实际 from/to；跨日排查可传一对 UTC ISO
18
+ 时间 `--from` / `--to`（最多 24 小时）。其余定位器按原 ID 查，不接受时间窗口。
19
+ 默认环境是 test；production 必须显式选择。结果包含实际站点、应用、环境、观测时间、
20
+ 持久状态和是否截断，只投影允许的元数据，不返回业务正文、文件名或密钥。
21
+
22
+ `observed` 仅表示查到事实，仍需看每条状态；`not_observed` 不表示原写入没有发生；
23
+ `unavailable` 表示本次诊断暂不可用。三者都不会重放原操作。保留原 ID、输入和幂等键，
24
+ 按返回的下一步查询原回执，不创建新运行代替未知结果。文件存在不等于当前用户可下载。
25
+
26
+ 原有 `pnpm openxiangda logs [deploymentId]` 保持部署日志行为。MCP 的
27
+ `application_diagnostics` 使用同一范围和状态约定；requestId 的 from/to 必须明确提供。
28
+
5
29
  ## 测试部署
6
30
 
7
31
  源码托管仍可通过 `pnpm openxiangda source push` 提交和推送，但不是测试发布的前置步骤。
@@ -24,6 +48,17 @@ pnpm openxiangda logs <deployment-id> --json
24
48
 
25
49
  平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
26
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
+
27
62
  生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
28
63
 
29
64
  构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
@@ -34,7 +69,8 @@ pnpm openxiangda status <deployment-id> --watch
34
69
 
35
70
  网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
36
71
 
37
- 重复发布直接使用当前源码重新构建。pnpm、Docker 和平台可以自行提供构建缓存，Devkit 不维护另一套工作区摘要或候选状态。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
72
+ 新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
73
+ 该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
38
74
 
39
75
  ## 测试环境验收
40
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.27.0 skill install --force
72
- pnpm dlx openxiangda@2.27.0 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.27.0 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.27.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.27.0 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.27.0 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.27.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.27.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": "b04ee0ea45b8342345be1f501078e4754da437416228b70e7d0e5f9338e33337"
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": "69c94361f2c7e1038bb50be9875b34337d8138a923e1913d3f8ee3d5dfb2a57d"
117
+ "sha256": "29ab3c1d878af989fcc3a3198d878d6344dc00b711df898251d1c757f0531156"
118
118
  },
119
119
  {
120
120
  "id": "upgrading",
@@ -126,13 +126,13 @@
126
126
  "id": "cli",
127
127
  "title": "CLI 命令参考",
128
128
  "file": "reference/cli.md",
129
- "sha256": "63b50ae974d2bf82eab32e05666ae5c500318b484d3cee96a3930d59bc020a63"
129
+ "sha256": "c3803d06724b6879788d695fc3a9a5a9894299dc50fde5bad58d8320ea4ba32e"
130
130
  },
131
131
  {
132
132
  "id": "mcp",
133
133
  "title": "MCP 配置与工具参考",
134
134
  "file": "reference/mcp.md",
135
- "sha256": "47379c8235995547fd674fb438759cdbbbd72e54c6ed446cedf1aacff0047b74"
135
+ "sha256": "23a4da755e482f96e520d98f7527052c60bfb9727b48827a661e0f0eaf8ea838"
136
136
  }
137
137
  ]
138
138
  }
package/documentation/reference/cli.md CHANGED
@@ -15,7 +15,7 @@
15
15
  | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
16
16
  | `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
17
17
  | `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
18
- | `pnpm openxiangda logs` | 只读 | 查询最近或指定部署日志 |
18
+ | `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
19
19
  | `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
20
20
  | `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |
21
21
  | `pnpm openxiangda start` | 远端变更 | 从当前不可变版本启动应用环境 |
package/documentation/reference/mcp.md CHANGED
@@ -561,6 +561,59 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
561
561
  }
562
562
  ```
563
563
 
564
+ ## application_diagnostics
565
+
566
+ 查询应用原操作事实。在当前应用和明确环境内只读查询 requestId、commandId、deploymentRunId 或 fileId。requestId 必须传成对 UTC from/to，最多 24 小时；其余类型不传窗口。未观测到不表示未执行，禁止据此换键重放。
567
+
568
+ - 只读：是
569
+ - 可替换文件或改变远端状态：否
570
+ - 幂等：否
571
+
572
+ 输入参数：
573
+
574
+ ```json
575
+ {
576
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
577
+ "type": "object",
578
+ "properties": {
579
+ "environment": {
580
+ "default": "test",
581
+ "description": "目标环境；默认 test，production 必须明确选择",
582
+ "type": "string",
583
+ "enum": [
584
+ "test",
585
+ "production"
586
+ ]
587
+ },
588
+ "kind": {
589
+ "type": "string",
590
+ "enum": [
591
+ "requestId",
592
+ "commandId",
593
+ "deploymentRunId",
594
+ "fileId"
595
+ ]
596
+ },
597
+ "id": {
598
+ "type": "string",
599
+ "minLength": 1,
600
+ "maxLength": 128
601
+ },
602
+ "from": {
603
+ "type": "string"
604
+ },
605
+ "to": {
606
+ "type": "string"
607
+ }
608
+ },
609
+ "required": [
610
+ "kind",
611
+ "id"
612
+ ],
613
+ "additionalProperties": false
614
+ }
615
+ ```
616
+
564
617
  ## cancel_deployment
565
618
 
566
619
  取消未激活部署。仅在用户授权且平台 recovery.cancelAllowed 为真时取消；激活后的运行不能取消。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openxiangda",
3
- "version": "2.27.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.21",
64
- "openxiangda-contracts": "2.23.0",
65
- "openxiangda-devkit-core": "2.25.0",
63
+ "openxiangda-cli": "2.5.23",
64
+ "openxiangda-contracts": "2.24.0",
65
+ "openxiangda-devkit-core": "2.27.0",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
- "openxiangda-mcp": "2.0.45",
68
- "openxiangda-nest": "2.7.0",
69
- "openxiangda-skill-kit": "2.3.19",
67
+ "openxiangda-mcp": "2.0.47",
68
+ "openxiangda-nest": "2.7.1",
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,41 +132,37 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.27.0",
135
+ "version": "2.28.1",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.27.0：精确额度审批生命周期",
138
- "summary": "补齐主子记录精确金额占用的审批终态声明、原轮次事务参数及撤回修订重提接入，保持平台对金额、身份和审批事实的统一校验。",
139
- "newFeatures": [
140
- "HTTP 事件订阅可声明同资源审批的额度终态：通过继续占额，驳回或撤回释放；两侧编译器共同校验审批、资源、状态和固定迁移模式。",
141
- "Native 事务支持绑定原 reservationKey、transitionKey 和唯一子记录 update，Nest 继承已验证的事件上下文，不允许客户端自报额度迁移模式。",
142
- "提供本人 FormDraft 与 BusinessProcess update 重提组合示例，将修改正式金额、重新占额、消费草稿和生成审批命令放在同一平台事务。"
143
- ],
137
+ "title": "OpenXiangda 2.28.1：后端镜像原制品上传恢复",
138
+ "summary": "上传中断后保留原 OCI 镜像，普通 deploy 重试直接从平台已有偏移或 ready 回执恢复，减少重建和重复传输。",
139
+ "newFeatures": [],
144
140
  "fixes": [
145
- "事件终态声明参与能力使用摘要；目标必须满足 data.decimal-reservations@1.1.0，不能把仅有数据表和通用防护的旧服务端当作完整额度能力。"
141
+ "已导出的后端镜像不会再因为上传失败或响应丢失被立即删除；相同输入重试保持原摘要，已封存候选不再依赖 Docker 重建。",
142
+ "缓存绑定当前站点、租户、用户、应用环境和实际构建上下文，包含未提交源码；恢复前验证全部 blob，使用跨进程租约阻止重复上传。"
146
143
  ],
147
144
  "affectedUsers": [
148
- "需要以主记录金额约束多条子记录，并在审批通过、驳回、撤回和重提间管理额度的 OpenXiangda 2.0 应用。"
145
+ "通过平台登录态分块上传后端镜像的 OpenXiangda 2.0 应用开发者。"
149
146
  ],
150
147
  "upgradeSteps": [
151
- "应用固定 openxiangda@2.27.0，更新锁文件，重新生成契约并执行适用检查；平台同步升级匹配的公共编译器、额度实现和向前迁移。",
152
- "在实际资源和审批中声明 reserve 动作及终态订阅，先确认没有未入账的历史子记录。保留未完成请求的原幂等键和输入。",
153
- "预发验证并发超额、精确小数、权限拒绝、通过保留占额、释放一次及同记录修订重提。真实验收前保持额度入口禁用。"
148
+ "应用消费 openxiangda@2.28.1 并更新锁文件。上传中断时保留工作区输入，恢复网络或登录后重复原 deploy 命令。",
149
+ "无需平台数据库迁移，也无需手工寻找 BuildKit 历史或镜像上传会话。"
154
150
  ],
155
151
  "knownLimitations": [
156
- "普通 CRUD 不开放 released 子记录保护字段写入；修订先保存本人草稿，再通过原子 update 重提。",
157
- "作废或终止需要另行实现真实受管业务动作，签后金额变更不在首批能力内。旧轮次事件不能释放新轮次额度。",
158
- "原回执重放仍要求当前授权、有效事件租约和父记录可读性。",
159
- "公开包发行不是客户部署或业务验收，不提供应用侧浮点求和替代台账的降级路径。"
152
+ "最多保留 8 个候选、总预留空间 8 GiB、24 小时；平台单镜像上限超过 8 GiB 时继续原临时上传路径。缓存过期或被预算清理后需要重新构建。",
153
+ "源码、身份、环境、配置或工具版本变化会形成新候选；恢复原镜像不重新求值远程 FROM/RUN 输入。",
154
+ "本机上下文校验有 100000 条目、8 GiB、60 秒预算；构建期间源码变化会拒绝上传，需要保存完成后重试。",
155
+ "真实 Docker 导出及故障恢复、隔离的传输协议和发行门禁分别验证，不代表任何客户应用已发布或通过业务验收。"
160
156
  ],
161
157
  "issues": [],
162
158
  "compatibility": {
163
159
  "node": ">=24",
164
160
  "workspaceGenerations": "v2",
165
- "platform": "额度应用要求 data.decimal-reservations@1.1.0，并使用与目标平台一致的共享编译器。未启用额度的应用保持原有行为。",
161
+ "platform": "复用既有 backendImageUpload 协议和 auth/whoami，不新增远端上传状态或服务器账号要求。",
166
162
  "v1": "独立 V1 引擎和工作区不受影响。"
167
163
  },
168
- "sha256": "ff07310ebff47f32988ba6c6117f0072daca6497700c8f24ed1c10c92c081b06",
169
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.27.0"
164
+ "sha256": "762fa08d9c2818264ed9b65383f1ec60ad6bc4236978ee07cf0c19cdce45ad16",
165
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.1"
170
166
  },
171
167
  "scripts": {
172
168
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.28.0.json ADDED
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.28.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.28.0：应用原操作自助诊断",
6
+ "summary": "应用管理员通过现有工作区查询原请求、持久命令、部署和受管文件的脱敏事实，减少依赖平台人员登录服务器定位问题的情况。",
7
+ "newFeatures": [
8
+ "logs 增加 request-id、command-id、deployment-run-id、file-id 四种互斥定位器，MCP 提供相同范围的 application_diagnostics 只读工具。",
9
+ "结果显示实际站点、应用、环境、时间窗口及观测时间；SDK 校验查询与响应关联，只保留受支持的元数据。"
10
+ ],
11
+ "fixes": [
12
+ "明确区分已观测、未观测和诊断暂不可用；未知结果不再被解释成原操作未执行，也不会触发换键重放。"
13
+ ],
14
+ "affectedUsers": [
15
+ "需要按原操作 ID 自助排查发布、工作流和文件状态的 OpenXiangda 2.0 应用管理员及开发者。"
16
+ ],
17
+ "upgradeSteps": [
18
+ "应用消费 openxiangda@2.28.0 并更新锁文件；使用已有工作区开发者登录，不需要服务器账号。",
19
+ "平台应提供 application.scoped-diagnostics@1；查询默认使用 test，生产环境需显式传 --environment production。",
20
+ "保留原操作 ID。request-id 默认查询最近一小时，也可传一对 UTC from/to，窗口最多 24 小时；其他定位器不接受时间窗口。"
21
+ ],
22
+ "knownLimitations": [
23
+ "诊断受应用管理权限和当前租户、环境约束；普通应用服务凭据不因此获得管理权限。",
24
+ "每次最多返回 50 条事实，可能标记截断；不返回业务正文、文件名、原始日志或密钥。",
25
+ "未观测不表示原写入未发生，已观测不表示业务验收完成。暂不可用时保留原键与输入，按提示继续查询。",
26
+ "此次新增能力不改变共享 Native 编译器摘要；公开包发行与实际站点部署分别验证。"
27
+ ],
28
+ "issues": [],
29
+ "compatibility": {
30
+ "node": ">=24",
31
+ "workspaceGenerations": "v2",
32
+ "platform": "新诊断入口要求 application.scoped-diagnostics@1.0.0 或兼容 1.x；原 logs [deploymentId] 和未使用此能力的应用保持原行为。",
33
+ "v1": "独立 V1 引擎和工作区不受影响。"
34
+ },
35
+ "sha256": "80c18512f5cb76850e738b9e802261af68e27f6582b3f686781da7c9d4367c2a",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.0"
37
+ }
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": "629cc8417b7338841df4e44f4b9ff3f64aa4a7542d216a806a800a3214cfe0c1"
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.27.0 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.27.0 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.27.0 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.27.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/cli.md CHANGED
@@ -15,7 +15,7 @@
15
15
  | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
16
16
  | `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
17
17
  | `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
18
- | `pnpm openxiangda logs` | 只读 | 查询最近或指定部署日志 |
18
+ | `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
19
19
  | `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
20
20
  | `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |
21
21
  | `pnpm openxiangda start` | 远端变更 | 从当前不可变版本启动应用环境 |
package/skills/openxiangda-v2/references/delivery.md CHANGED
@@ -2,6 +2,30 @@
2
2
 
3
3
  应用开发者从工作区执行 `pnpm openxiangda`。平台负责应用版本、运行状态和恢复决定。工具链自身的 npm 发布由平台维护者负责，应用项目无需复制发包脚本或平台验证矩阵。
4
4
 
5
+ ## 按原操作自助诊断
6
+
7
+ 保留原 requestId、commandId、DeploymentRun ID 或 fileId；应用管理员可在已有
8
+ 登录工作区查询，不需要服务器账号。目标平台需提供 `application.scoped-diagnostics@1`。
9
+
10
+ ```bash
11
+ pnpm openxiangda logs --request-id <原请求ID> --json
12
+ pnpm openxiangda logs --command-id <原命令UUID> --json
13
+ pnpm openxiangda logs --file-id <受管文件UUID> --environment test --json
14
+ pnpm openxiangda logs --deployment-run-id <原RunUUID> --environment production --json
15
+ ```
16
+
17
+ requestId 默认最近一小时，结果会显示实际 from/to；跨日排查可传一对 UTC ISO
18
+ 时间 `--from` / `--to`（最多 24 小时）。其余定位器按原 ID 查，不接受时间窗口。
19
+ 默认环境是 test；production 必须显式选择。结果包含实际站点、应用、环境、观测时间、
20
+ 持久状态和是否截断，只投影允许的元数据，不返回业务正文、文件名或密钥。
21
+
22
+ `observed` 仅表示查到事实，仍需看每条状态；`not_observed` 不表示原写入没有发生；
23
+ `unavailable` 表示本次诊断暂不可用。三者都不会重放原操作。保留原 ID、输入和幂等键，
24
+ 按返回的下一步查询原回执，不创建新运行代替未知结果。文件存在不等于当前用户可下载。
25
+
26
+ 原有 `pnpm openxiangda logs [deploymentId]` 保持部署日志行为。MCP 的
27
+ `application_diagnostics` 使用同一范围和状态约定；requestId 的 from/to 必须明确提供。
28
+
5
29
  ## 测试部署
6
30
 
7
31
  源码托管仍可通过 `pnpm openxiangda source push` 提交和推送，但不是测试发布的前置步骤。
@@ -24,6 +48,17 @@ pnpm openxiangda logs <deployment-id> --json
24
48
 
25
49
  平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
26
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
+
27
62
  生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
28
63
 
29
64
  构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
@@ -34,7 +69,8 @@ pnpm openxiangda status <deployment-id> --watch
34
69
 
35
70
  网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
36
71
 
37
- 重复发布直接使用当前源码重新构建。pnpm、Docker 和平台可以自行提供构建缓存，Devkit 不维护另一套工作区摘要或候选状态。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
72
+ 新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
73
+ 该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
38
74
 
39
75
  ## 测试环境验收
40
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.27.0 skill install --force
72
- pnpm dlx openxiangda@2.27.0 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.27.0 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.27.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.27.0 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.27.0 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.27.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/skills/openxiangda-v2/references/mcp.md CHANGED
@@ -561,6 +561,59 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
561
561
  }
562
562
  ```
563
563
 
564
+ ## application_diagnostics
565
+
566
+ 查询应用原操作事实。在当前应用和明确环境内只读查询 requestId、commandId、deploymentRunId 或 fileId。requestId 必须传成对 UTC from/to，最多 24 小时；其余类型不传窗口。未观测到不表示未执行，禁止据此换键重放。
567
+
568
+ - 只读：是
569
+ - 可替换文件或改变远端状态：否
570
+ - 幂等：否
571
+
572
+ 输入参数：
573
+
574
+ ```json
575
+ {
576
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
577
+ "type": "object",
578
+ "properties": {
579
+ "environment": {
580
+ "default": "test",
581
+ "description": "目标环境；默认 test，production 必须明确选择",
582
+ "type": "string",
583
+ "enum": [
584
+ "test",
585
+ "production"
586
+ ]
587
+ },
588
+ "kind": {
589
+ "type": "string",
590
+ "enum": [
591
+ "requestId",
592
+ "commandId",
593
+ "deploymentRunId",
594
+ "fileId"
595
+ ]
596
+ },
597
+ "id": {
598
+ "type": "string",
599
+ "minLength": 1,
600
+ "maxLength": 128
601
+ },
602
+ "from": {
603
+ "type": "string"
604
+ },
605
+ "to": {
606
+ "type": "string"
607
+ }
608
+ },
609
+ "required": [
610
+ "kind",
611
+ "id"
612
+ ],
613
+ "additionalProperties": false
614
+ }
615
+ ```
616
+
564
617
  ## cancel_deployment
565
618
 
566
619
  取消未激活部署。仅在用户授权且平台 recovery.cancelAllowed 为真时取消；激活后的运行不能取消。