openxiangda-skill-kit 2.3.128 → 2.3.129
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda-skill-kit",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.129",
|
|
4
4
|
"description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"README.md"
|
|
18
18
|
],
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"openxiangda-devkit-core": "2.71.
|
|
20
|
+
"openxiangda-devkit-core": "2.71.4"
|
|
21
21
|
},
|
|
22
22
|
"devDependencies": {
|
|
23
23
|
"tsx": "4.23.12",
|
|
@@ -298,11 +298,31 @@ await businessData.transaction({
|
|
|
298
298
|
```
|
|
299
299
|
|
|
300
300
|
引用约束：引用对象只含 `operationIndex`（0..99 的整数）与 `field: 'id'` 两个键；
|
|
301
|
-
只能指向索引更小的 create
|
|
301
|
+
只能指向索引更小的 create 操作；普通字段引用不得嵌套在数组或对象里，关联资源字段的快照见下节。违反形状报
|
|
302
302
|
`OPENXIANGDA_NATIVE_DATA_TRANSACTION_REFERENCE_INVALID`，嵌套报
|
|
303
303
|
`..._NESTED`，目标不可解析报 `..._UNRESOLVED`。任一操作失败时整个事务回滚，
|
|
304
304
|
不会留下无成员的 club。
|
|
305
305
|
|
|
306
|
+
### 关联资源字段保留快照
|
|
307
|
+
|
|
308
|
+
`resource-ref.single` 字段仍需要资源代码、显示标签和 `value`。用 Nest 的
|
|
309
|
+
`resourceSnapshot` 将前序 create 引用放在唯一受支持的快照 `value` 位置；
|
|
310
|
+
裸 UUID 引用不能代替资源字段快照：
|
|
311
|
+
|
|
312
|
+
```ts
|
|
313
|
+
import { resourceSnapshot } from 'openxiangda/nest';
|
|
314
|
+
const operations = [
|
|
315
|
+
{ operation: 'create' as const, resourceCode: 'orders', data: { name: '订单' } },
|
|
316
|
+
{ operation: 'create' as const, resourceCode: 'order-lines', data: {
|
|
317
|
+
order: resourceSnapshot('orders', { operationIndex: 0, field: 'id' }, '订单'),
|
|
318
|
+
} },
|
|
319
|
+
];
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
快照的 `resourceCode` 必须与前序 create 的资源一致。只允许既有快照元数据，
|
|
323
|
+
`value` 之外的对象、数组和 `snapshot` 中仍不接受事务引用；平台继续验证目标字段、
|
|
324
|
+
引用和实际授权。字符串 ID 的 `resourceSnapshot` 调用保持原行为，助手不提交或重试请求。
|
|
325
|
+
|
|
306
326
|
## 业务动作与普通查询 {#business-action}
|
|
307
327
|
|
|
308
328
|
`OpenXiangdaDataApiService` 按当前用户的普通资源、行和字段权限执行。具名业务动作使用 `OpenXiangdaBusinessDataApiService`：入口先检查该动作 capability，平台在精确应用和环境内以受信任后端执行，并保留发起人与动作审计。业务动作不能接受任意模型/字段/用户 ID 后不做业务校验；应用负责该动作的输入约束和业务不变量。
|