openxiangda-skill-kit 2.3.19 → 2.3.21

package/package.json

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

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

@@ -15,7 +15,7 @@
 | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
 | `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
 | `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
-| `pnpm openxiangda logs` | 只读 | 查询最近或指定部署日志 |
+| `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
 | `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
 | `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |
 | `pnpm openxiangda start` | 远端变更 | 从当前不可变版本启动应用环境 |

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

@@ -2,6 +2,30 @@
 
 应用开发者从工作区执行 `pnpm openxiangda`。平台负责应用版本、运行状态和恢复决定。工具链自身的 npm 发布由平台维护者负责，应用项目无需复制发包脚本或平台验证矩阵。
 
+## 按原操作自助诊断
+
+保留原 requestId、commandId、DeploymentRun ID 或 fileId；应用管理员可在已有
+登录工作区查询，不需要服务器账号。目标平台需提供 `application.scoped-diagnostics@1`。
+
+```bash
+pnpm openxiangda logs --request-id <原请求ID> --json
+pnpm openxiangda logs --command-id <原命令UUID> --json
+pnpm openxiangda logs --file-id <受管文件UUID> --environment test --json
+pnpm openxiangda logs --deployment-run-id <原RunUUID> --environment production --json
+```
+
+requestId 默认最近一小时，结果会显示实际 from/to；跨日排查可传一对 UTC ISO
+时间 `--from` / `--to`（最多 24 小时）。其余定位器按原 ID 查，不接受时间窗口。
+默认环境是 test；production 必须显式选择。结果包含实际站点、应用、环境、观测时间、
+持久状态和是否截断，只投影允许的元数据，不返回业务正文、文件名或密钥。
+
+`observed` 仅表示查到事实，仍需看每条状态；`not_observed` 不表示原写入没有发生；
+`unavailable` 表示本次诊断暂不可用。三者都不会重放原操作。保留原 ID、输入和幂等键，
+按返回的下一步查询原回执，不创建新运行代替未知结果。文件存在不等于当前用户可下载。
+
+原有 `pnpm openxiangda logs [deploymentId]` 保持部署日志行为。MCP 的
+`application_diagnostics` 使用同一范围和状态约定；requestId 的 from/to 必须明确提供。
+
 ## 测试部署
 
 源码托管仍可通过 `pnpm openxiangda source push` 提交和推送，但不是测试发布的前置步骤。
@@ -24,6 +48,17 @@ pnpm openxiangda logs <deployment-id> --json
 
 平台启用镜像上传后，`deploy` 在本机用 Docker Buildx 导出 OCI 镜像，再使用当前平台登录态分片上传。开发者只需应用部署权限，无需登录平台管理员的镜像仓库或取得推送凭据。已完成的镜像层按摘要复用，中断后重新执行同一条部署命令可恢复上传；平台核验镜像完整性后才进入应用发布。尚未升级的旧平台保留其原镜像构建合同；新平台已声明上传能力但未启用时，命令会明确报告平台配置缺失。
 
+上传失败后，本机保留原 OCI 制品，错误的 `details` 包含候选 ID、原 digest、失效时间及脱敏原因码。
+恢复网络或登录后，在原工作区执行同一条 `pnpm openxiangda deploy`：相同构建输入、账号、平台、
+应用和环境会校验原制品并从平台保存的偏移继续；即使 Docker 暂时不可用也能恢复已经构建的镜像。
+完成响应丢失时同样查询原摘要的 ready 回执。源码（包括未提交文件）、权限主体或目标变化会创建新候选，
+不会冒充原上传。上传鉴权仍在平台执行；本地缓存不授予部署权限。
+
+缓存保留最多 24 小时、8 个候选、总预算 8 GiB；空间不足时仅回收未被使用的旧候选。
+仅当平台单镜像上限不超过 8 GiB 时启用本地恢复，较大的平台配额保留原上传路径，不降低平台允许的镜像大小。
+缓存和登录凭据分开，位于本机用户私有目录。过期或已经回收的候选需重新构建；已有 DeploymentRun
+的未知结果仍查询原运行，镜像上传恢复不会重新发起已提交的部署。
+
 生成的不可变 AppVersion 绑定前端、可选后端、配置契约和制品摘要。默认提交后持续跟踪同一运行，直到平台成功、失败或取消，最多观察 15 分钟。`--no-wait` 只提交，适用于已有状态跟踪器的自动化；此时返回运行 ID 不代表部署完成。
 
 构建、上传及平台执行都会显示当前阶段和耗时，长步骤每 10 秒反馈一次。平台的准备、部署、切换和健康检查状态来自原运行。观察超时或连接中断不会取消部署或重建候选，使用下面的命令继续跟踪：
@@ -34,7 +69,8 @@ pnpm openxiangda status <deployment-id> --watch
 
 网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
 
-重复发布直接使用当前源码重新构建。pnpm、Docker 和平台可以自行提供构建缓存，Devkit 不维护另一套工作区摘要或候选状态。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
+新的发布使用当前源码构建；尚未完成的同输入镜像上传可复用上述短期原制品缓存。
+该缓存不保存部署状态，平台仍唯一拥有 DeploymentRun。提交响应不确定时使用原 DeploymentRun 的 status/logs 和 recovery 继续处理。
 
 ## 测试环境验收
 

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

@@ -561,6 +561,59 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 }
 ```
 
+## application_diagnostics
+
+查询应用原操作事实。在当前应用和明确环境内只读查询 requestId、commandId、deploymentRunId 或 fileId。requestId 必须传成对 UTC from/to，最多 24 小时；其余类型不传窗口。未观测到不表示未执行，禁止据此换键重放。
+
+- 只读：是
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "kind": {
+      "type": "string",
+      "enum": [
+        "requestId",
+        "commandId",
+        "deploymentRunId",
+        "fileId"
+      ]
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "from": {
+      "type": "string"
+    },
+    "to": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "kind",
+    "id"
+  ],
+  "additionalProperties": false
+}
+```
+
 ## cancel_deployment
 
 取消未激活部署。仅在用户授权且平台 recovery.cancelAllowed 为真时取消；激活后的运行不能取消。