openxiangda-skill-kit 2.3.19 → 2.3.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.3.19",
+  "version": "2.3.20",
   "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.26.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` 提交和推送，但不是测试发布的前置步骤。

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 为真时取消；激活后的运行不能取消。