openxiangda-skill-kit 2.0.7 → 2.0.9

package/package.json

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

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

@@ -34,6 +34,13 @@ operation、事件消费者、人员提供器，然后运行 `pnpm openxiangda c
 
 下方代码是接入片段，模型与角色需要在应用中显式声明。独立的完整示例由工具链维护者在新建应用中做打包验收。
 
+业务记录已创建但详情缺少原流程命令 ID 时，使用
+`OpenXiangdaBusinessProcessService.list({ resourceCode, recordId, workflowCode, operationCode })`。
+`workflowCode` 必须显式提供且属于当前 Named Action 的 `platformAccess.workflow.codes`；
+SDK 继承当前环境与身份，平台沿用发起人或既有超级管理员的命令权限。返回有界
+`items/nextCursor`，分页与多次流程的选择规则见[前端](frontend.md)。找回后使用原
+`receipt/poll/surface`；查询不重放提交、不生成第二份命令状态。
+
 自定义 operation 的 capability 必须先在 `authz.capabilities` 以
 `kind: 'backend'` 声明，再由 operation 和允许调用它的角色共同引用。普通资源 CRUD
 能力仍由编译器生成，不写入显式 capability catalog。
@@ -136,6 +143,12 @@ await bootstrapOpenXiangdaApplication(AppModule);
 
 签名事件处理器使用 `sendFromEvent()`，在声明中指定事件 data 内的收件人与文案路径，由平台验证不可变事件后解析。普通业务动作不需要平台通知管理权限。需要高级钉钉卡片时才使用已授权的管理服务和已启用通道，不能把它设为普通审批的默认依赖。
 
+事件处理器可正常注入请求作用域的通知服务或瞬态依赖。SDK 先验证签名、应用、环境、
+事件 Schema 并认领回执，再从处理器所属 Nest 模块创建本次投递的依赖作用域。
+静态单例仍由 Nest 复用；失败重试创建新作用域并保留原事件幂等键。处理器中的
+`REQUEST` 不含用户授权，不能用 `send()` 冒充具名用户动作；事件身份仅来自当前
+已验证的 `handle(event, context)` 执行，离开该执行后调用 `sendFromEvent()` 会拒绝。
+
 通知协议常量也从同一个公开入口导入：
 
 ```ts

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

@@ -202,6 +202,15 @@ renderer，但共享同一授权与命令生命周期。主决策操作固定在
 `nextPoll` 继续读取直到 `terminal`，再消费 typed command/surface。不要把 accepted 当作提交失败，
 也不要对平台端点发起未类型化的 `fetch`。
 
+从列表重新进入业务详情、尚未收到流程投影时，用
+`listBusinessProcessCommands({ resourceCode, recordId, workflowCode, operationCode })`
+查找原命令。环境由当前平台入口提供，只返回当前用户原本可读的命令。默认 20 条，
+`pageSize` 最大 50；用返回的 `nextCursor` 作为下一页的 `beforeCommandId`。
+结果按创建时间和 ID 倒序排列，不自动认定最新一条就是本次提交；按业务约束确认
+原命令后继续原 receipt/poll/surface。同一记录可能有多次流程，不能任意取首条，
+也不能为恢复 ID 再创建一次流程。此能力需要 `business-process.durable-command` 1.1.0，
+新包通过现有发布前检查核对平台版本。拥有业务记录读取权限不代表拥有他人的流程命令权限。
+
 资源用 `mutationOwner: 'native' | 'action' | 'readonly' | 'workflow'` 声明 mutation owner，
 并可用 `generated.list/detail/create/update/delete` 精确选择标准 surface。非 Native owner
 不能生成或向应用角色授予 Native mutation；零可写业务字段不能开放 create/update。