openxiangda-skill-kit 2.0.0-alpha.147 → 2.0.0-alpha.148
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.
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda-skill-kit",
|
|
3
|
-
"version": "2.0.0-alpha.
|
|
3
|
+
"version": "2.0.0-alpha.148",
|
|
4
4
|
"description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"README.md"
|
|
18
18
|
],
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"openxiangda-devkit-core": "2.0.0-alpha.
|
|
20
|
+
"openxiangda-devkit-core": "2.0.0-alpha.122"
|
|
21
21
|
},
|
|
22
22
|
"devDependencies": {
|
|
23
23
|
"tsx": "4.23.12",
|
|
@@ -94,3 +94,17 @@ CLI 的 `--json` 输出单个 `openxiangda.cli-result/v2` 对象；失败包含
|
|
|
94
94
|
`OPENXIANGDA_CONFIGURATION_VALIDATOR_MISMATCH` 表示工具链与平台的校验实现不配套，应按发布说明升级对应版本；它会在构建、镜像推送和制品上传前出现。模型类型不能原地替换时，按提示设计新字段及数据转换；必需密钥缺失时配置目标环境后继续，不修改源码伪装问题已解决。
|
|
95
95
|
|
|
96
96
|
MCP 的 check_app、deployment_plan、deploy_app 使用与 CLI 相同的环境与生产晋级参数规则。完整参数以[CLI](cli.md)与[MCP](mcp.md)为准。
|
|
97
|
+
|
|
98
|
+
## 构建前运行配额
|
|
99
|
+
|
|
100
|
+
`deploy --dry-run`（MCP `deployment_plan`）会只读查询目标 TEST 的运行配额，输出 `runtimeCapacity` 的核验时间、所需增量、各配额剩余量和缺口。`sufficient: false` 表示当前不足；`null` 表示无需新增或未核验，必须结合 `basis` 与 `capacity.checked` 阅读。专用命名空间未检查不能当成资源充足。
|
|
101
|
+
|
|
102
|
+
正式 deploy 在检查脚本和镜像构建前预检；平台缺少配套能力或无法核验时明确停止。配额快照不预留资源，实际执行再次检查。已有可验证密封候选会携带摘要和幂等键，平台识别 `existing-run` 时返回原运行，不把它当作新副本；观察或恢复原运行使用 status/retry。不要为绕过配额创建新包或切换目标环境。
|
|
103
|
+
|
|
104
|
+
## TEST 单副本维护替换
|
|
105
|
+
|
|
106
|
+
平台配额只允许一个后端副本时，可显式选择维护替换。它会停止当前 TEST 后端，期间应用不可用；成功后激活新版本，失败时由原 DeploymentRun 恢复旧后端。恢复尚未完成时继续占用原运行，status/logs 显示恢复阶段与首个失败，不允许用新部署或取消跳过恢复。
|
|
107
|
+
|
|
108
|
+
先运行 `openxiangda deploy --environment test --strategy maintenance-replace --dry-run --json` 查看前驱版本、Head revision 和停止后的容量估算，再使用相同参数去掉 `--dry-run` 提交。计划不预留资源。只有已存在、身份匹配的单副本 TEST 后端才可使用；前端应用、新应用和 production 不支持。默认仍为 rolling，不会因配额不足自动停止实例。
|
|
109
|
+
|
|
110
|
+
策略属于部署幂等请求。默认维护幂等键含策略，显式幂等键不能在不同策略之间复用。已有运行通过 status/retry 恢复；持续恢复中的运行保持 preparing/maintenance-recovery-required，平台会重试恢复，恢复失败时保留原运行与错误。
|
|
@@ -304,7 +304,7 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
|
|
|
304
304
|
|
|
305
305
|
## deployment_plan
|
|
306
306
|
|
|
307
|
-
|
|
307
|
+
预览应用发布。只读预览测试部署的运行配额，或指定测试版本的生产晋级；返回容量与缺口，不构建、上传或提交运行。
|
|
308
308
|
|
|
309
309
|
- 只读：是
|
|
310
310
|
- 可替换文件或改变远端状态：否
|
|
@@ -331,6 +331,14 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
|
|
|
331
331
|
"type": "string",
|
|
332
332
|
"minLength": 1
|
|
333
333
|
},
|
|
334
|
+
"deploymentStrategy": {
|
|
335
|
+
"description": "仅 TEST；显式 maintenance-replace 允许停机替换并由平台处理失败恢复，默认 rolling",
|
|
336
|
+
"type": "string",
|
|
337
|
+
"enum": [
|
|
338
|
+
"rolling",
|
|
339
|
+
"maintenance-replace"
|
|
340
|
+
]
|
|
341
|
+
},
|
|
334
342
|
"environmentId": {
|
|
335
343
|
"description": "测试环境 ID，通常由平台绑定确定",
|
|
336
344
|
"type": "string"
|
|
@@ -464,6 +472,14 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
|
|
|
464
472
|
"type": "string",
|
|
465
473
|
"minLength": 1
|
|
466
474
|
},
|
|
475
|
+
"deploymentStrategy": {
|
|
476
|
+
"description": "仅 TEST；显式 maintenance-replace 允许停机替换并由平台处理失败恢复，默认 rolling",
|
|
477
|
+
"type": "string",
|
|
478
|
+
"enum": [
|
|
479
|
+
"rolling",
|
|
480
|
+
"maintenance-replace"
|
|
481
|
+
]
|
|
482
|
+
},
|
|
467
483
|
"environmentId": {
|
|
468
484
|
"description": "测试环境 ID，通常由平台绑定确定",
|
|
469
485
|
"type": "string"
|