openxiangda-skill-kit 2.3.114 → 2.3.115

package/package.json

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

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

@@ -16,7 +16,7 @@
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |
 | `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
 | `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
-| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
+| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态，可只读预览原运行流程例外 |
 | `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
 | `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
 | `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |

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

@@ -95,6 +95,46 @@ OPENXIANGDA_BACKEND_IMAGE_CACHE=false pnpm openxiangda deploy
 pnpm openxiangda status <deployment-id> --watch
 ```
 
+原运行因 `WORKFLOW_DESIGNER_EXCEPTIONS_ACKNOWLEDGEMENT_REQUIRED` 失败时，支持
+`deployment.workflow-adoption-preview` 的平台可只读检查冻结候选的真实例外：
+
+```bash
+pnpm openxiangda status <deployment-id> --workflow-exceptions --json
+```
+
+必须指定原 Run ID，不能与 `--watch` 合用。结果绑定原包、AppVersion、attempt、当前 Head
+和候选流程版本；例外列表有上限，`truncated=true` 不代表已看完。
+该命令不会写画布草稿、确认例外、重试或另建部署。`activationPermission=not-granted`
+明确表示预览没有授予激活许可。旧平台能力缺失时保留原运行并报告缺口。
+当前没有通过此命令确认例外或转换旧实例事实的能力；不要给 retry 塞未支持的确认字段。
+
+若应用仍锁定旧 SDK，统一 launcher 可能继续选择旧引擎。不要为诊断改应用依赖或冻结候选。
+可在应用目录之外建立独立诊断目录，安装发行回执指定的精确 `openxiangda-devkit-core` 版本
+（该版本须包含 `deploymentWorkflowPreview`），使用以下公开服务接口；不使用 `latest`。
+把脚本保存为该诊断目录下的 `preview.mjs`，运行 `node preview.mjs <原工作区绝对路径> <原Run ID>`：
+
+```js
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { OpenXiangdaDeveloperSession, workspaceSessionPath, OpenXiangdaControlPlaneClient } from 'openxiangda-devkit-core';
+const [rootInput, runId] = process.argv.slice(2);
+if (!rootInput || !runId) throw new Error('需要原工作区和原 Run ID');
+const root = resolve(rootInput);
+const link = JSON.parse(await readFile(join(root, '.openxiangda/link.json'), 'utf8'));
+if (typeof link.appCode !== 'string' || typeof link.baseUrl !== 'string') throw new Error('工作区绑定无效');
+const session = await OpenXiangdaDeveloperSession.load({ sessionPath: workspaceSessionPath(root) });
+if (!session) throw new Error('需要原工作区的平台登录会话');
+session.assertPlatform(link.baseUrl);
+const client = new OpenXiangdaControlPlaneClient({ baseUrl: session.baseUrl, tokenProvider: session });
+console.log(JSON.stringify(await client.deploymentWorkflowPreview(link.appCode, runId), null, 2));
+```
+
+此路径不加载应用 CLI 或源码配置、不重建候选，也不改应用 package/lock/seal。
+认证沿用官方工作区会话及平台绑定检查；如 token 到期，会话组件仍按原规则刷新凭据。
+它只做原身份核验、能力检查及原 Run GET；平台尚未支持时明确失败，不回退为重新部署。
+
+
+
 网络响应不确定时先查询原运行，不凭本地输出创建重复部署。平台部署成功后，仍需执行真实角色的业务验收。
 
 新的发布使用当前源码准备前端与配置，后端按实际输入复用或构建；同输入镜像可复用上述短期原制品缓存。