openxiangda-skill-kit 2.0.0-alpha.146 → 2.0.0-alpha.148

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.0.0-alpha.146",
+  "version": "2.0.0-alpha.148",
   "description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "openxiangda-devkit-core": "2.0.0-alpha.120"
+    "openxiangda-devkit-core": "2.0.0-alpha.122"
   },
   "devDependencies": {
     "tsx": "4.23.12",

package/skills/openxiangda-v2/SKILL.md

@@ -16,6 +16,7 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
+pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ auth status --base-url <平台地址> --json
 pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ login --base-url <平台地址>
 pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ create <应用目录> --base-url <同一平台地址>
 pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ skill install --force
@@ -77,3 +78,5 @@ pnpm exec openxiangda --mcp-stdio --cwd <workspace>
 只验证时运行 check/check_app；授权部署时直接 deploy/deploy_app，它已经包含检查并默认跟踪平台完成，长步骤持续反馈阶段和耗时。生产显式复用成功测试运行。观察中断用 status <运行ID> --watch 或 deployment_status.watch 继续查询原运行。登录、创建及长期 dev 使用 CLI/终端，分别记录本地验证、部署激活和真实业务验收。
 
 失败保留错误码、指针与原候选。结果不确定先查平台，不生成新的随机幂等键掩盖原运行；仅执行平台允许的恢复。升级项目后刷新资料并重启旧 MCP 连接。
+
+指定站点授权可用 `auth status --base-url <平台地址> --json` 或 MCP `authorization_status` 只读核验，无需工作区。状态为 `authorized` 才证明当前 access 被平台接受；`missing`/`platform_mismatch`/`refresh_required` 需处理会话，`unauthorized` 表示平台拒绝，`unavailable` 表示暂时无法核验，不能当成过期。查询不刷新、不打开浏览器、不修改绑定；应用管理权限需另行核验。

package/skills/openxiangda-v2/references/cli.md

@@ -4,6 +4,7 @@
 
 | 命令 | 影响 | 用途 |
 | --- | --- | --- |
+| `pnpm openxiangda auth` | 只读 | 只读核验指定平台授权，不登录或刷新会话 |
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
 | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |

package/skills/openxiangda-v2/references/delivery.md

@@ -94,3 +94,17 @@ CLI 的 `--json` 输出单个 `openxiangda.cli-result/v2` 对象；失败包含
 `OPENXIANGDA_CONFIGURATION_VALIDATOR_MISMATCH` 表示工具链与平台的校验实现不配套，应按发布说明升级对应版本；它会在构建、镜像推送和制品上传前出现。模型类型不能原地替换时，按提示设计新字段及数据转换；必需密钥缺失时配置目标环境后继续，不修改源码伪装问题已解决。
 
 MCP 的 check_app、deployment_plan、deploy_app 使用与 CLI 相同的环境与生产晋级参数规则。完整参数以[CLI](cli.md)与[MCP](mcp.md)为准。
+
+## 构建前运行配额
+
+`deploy --dry-run`（MCP `deployment_plan`）会只读查询目标 TEST 的运行配额，输出 `runtimeCapacity` 的核验时间、所需增量、各配额剩余量和缺口。`sufficient: false` 表示当前不足；`null` 表示无需新增或未核验，必须结合 `basis` 与 `capacity.checked` 阅读。专用命名空间未检查不能当成资源充足。
+
+正式 deploy 在检查脚本和镜像构建前预检；平台缺少配套能力或无法核验时明确停止。配额快照不预留资源，实际执行再次检查。已有可验证密封候选会携带摘要和幂等键，平台识别 `existing-run` 时返回原运行，不把它当作新副本；观察或恢复原运行使用 status/retry。不要为绕过配额创建新包或切换目标环境。
+
+## TEST 单副本维护替换
+
+平台配额只允许一个后端副本时，可显式选择维护替换。它会停止当前 TEST 后端，期间应用不可用；成功后激活新版本，失败时由原 DeploymentRun 恢复旧后端。恢复尚未完成时继续占用原运行，status/logs 显示恢复阶段与首个失败，不允许用新部署或取消跳过恢复。
+
+先运行 `openxiangda deploy --environment test --strategy maintenance-replace --dry-run --json` 查看前驱版本、Head revision 和停止后的容量估算，再使用相同参数去掉 `--dry-run` 提交。计划不预留资源。只有已存在、身份匹配的单副本 TEST 后端才可使用；前端应用、新应用和 production 不支持。默认仍为 rolling，不会因配额不足自动停止实例。
+
+策略属于部署幂等请求。默认维护幂等键含策略，显式幂等键不能在不同策略之间复用。已有运行通过 status/retry 恢复；持续恢复中的运行保持 preparing/maintenance-recovery-required，平台会重试恢复，恢复失败时保留原运行与错误。

package/skills/openxiangda-v2/references/getting-started.md

@@ -12,6 +12,7 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 
 ```bash
 pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ skill install --force
+pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ auth status --base-url <平台地址> --json
 pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ login --base-url https://platform.example.com
 pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ create my-app --base-url https://platform.example.com
 cd my-app
@@ -61,3 +62,5 @@ pnpm exec openxiangda --mcp-stdio --cwd <应用绝对路径>
 ```
 
 先调用 `workspace_context`，再按任务读取 `docs_read` 和当前契约。配置示例与工具参数见[MCP 参考](mcp.md)。登录、创建和长期 dev 进程继续由 CLI/终端管理。
+
+指定站点授权可用 `auth status --base-url <平台地址> --json` 或 MCP `authorization_status` 只读核验，无需工作区。状态为 `authorized` 才证明当前 access 被平台接受；`missing`/`platform_mismatch`/`refresh_required` 需处理会话，`unauthorized` 表示平台拒绝，`unavailable` 表示暂时无法核验，不能当成过期。查询不刷新、不打开浏览器、不修改绑定；应用管理权限需另行核验。

package/skills/openxiangda-v2/references/mcp.md

@@ -31,6 +31,34 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 
 工具返回相同内容的 structuredContent 与文本结果，包含 ok、operation、data 和适用的 diagnostics/nextActions。业务失败设置 isError=true；按错误码、定位和平台 recovery 决定下一步。工具协议错误同样停止当前操作。check_app 会生成文件并运行检查、测试、构建；失败后未执行的阶段标记 skipped。deploy_app 已包含完整检查，生产晋级必须传入成功的测试 DeploymentRun ID，不重新构建。详见 [校验](testing.md)与[部署](delivery.md)。
 
+## authorization_status
+
+核验平台授权。只读核验明确指定站点的当前授权；不依赖工作区，不启动登录、刷新凭据或修改绑定。authorized 不代表应用管理权限。
+
+- 只读：是
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "baseUrl": {
+      "type": "string",
+      "minLength": 1,
+      "description": "明确指定目标平台地址"
+    }
+  },
+  "required": [
+    "baseUrl"
+  ],
+  "additionalProperties": false
+}
+```
+
 ## workspace_context
 
 查看工作区。首先读取当前项目、工具链版本和绑定，不运行构建或创建远端对象。
@@ -276,7 +304,7 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 
 ## deployment_plan
 
-预览应用发布。只读预览测试部署或指定测试版本的生产晋级，不构建、上传或提交运行。
+预览应用发布。只读预览测试部署的运行配额，或指定测试版本的生产晋级；返回容量与缺口，不构建、上传或提交运行。
 
 - 只读：是
 - 可替换文件或改变远端状态：否
@@ -303,6 +331,14 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
       "type": "string",
       "minLength": 1
     },
+    "deploymentStrategy": {
+      "description": "仅 TEST；显式 maintenance-replace 允许停机替换并由平台处理失败恢复，默认 rolling",
+      "type": "string",
+      "enum": [
+        "rolling",
+        "maintenance-replace"
+      ]
+    },
     "environmentId": {
       "description": "测试环境 ID，通常由平台绑定确定",
       "type": "string"
@@ -436,6 +472,14 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
       "type": "string",
       "minLength": 1
     },
+    "deploymentStrategy": {
+      "description": "仅 TEST；显式 maintenance-replace 允许停机替换并由平台处理失败恢复，默认 rolling",
+      "type": "string",
+      "enum": [
+        "rolling",
+        "maintenance-replace"
+      ]
+    },
     "environmentId": {
       "description": "测试环境 ID，通常由平台绑定确定",
       "type": "string"