openxiangda-skill-kit 2.3.7 → 2.3.9

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.7",
3
+ "version": "2.3.9",
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.20.0"
20
+ "openxiangda-devkit-core": "2.20.2"
21
21
  },
22
22
  "devDependencies": {
23
23
  "tsx": "4.23.12",
@@ -174,7 +174,7 @@ import 'openxiangda/mobile/styles.css';
174
174
 
175
175
  PC 抽屉提供“全屏 / 新开页面 / 关闭”。全屏保留当前表单;新开页面先暂存,再通过草稿 ID 恢复,内容不放入 URL。移动录入使用平台移动字段的分组行式布局、简单标题和底部操作,不放“返回列表”或桌面输入控件;草稿箱和恢复确认使用底部弹层。
176
176
 
177
- 自定义表单可从 `openxiangda/react` 使用 `createResourceFormDraftClient(resourceCode, mode, recordId?, viewCode?)`,提供 `list/save/remove/submit`。命名视图只能恢复和提交属于当前视图的草稿;所有视图仍共用每人每个模型 20 份的上限。`save` 使用草稿 ID、expectedRevision 和可编辑字段值;`submit` 消费现有 DataTransactionOperation,不另建 CRUD 后端。此能力需要平台的 authenticated-form-drafts SQL 迁移及对应服务端版本,平台未升级时界面会明确显示暂存失败并保留输入。
177
+ 自定义表单可从 `openxiangda/react` 使用 `createResourceFormDraftClient(resourceCode, mode, recordId?, viewCode?)`,提供 `list/save/remove/submit`。命名视图只能恢复和提交属于当前视图的草稿;所有视图仍共用每人每个模型 20 份的上限。`save` 使用草稿 ID、expectedRevision 和可编辑字段值;若表单声明了 `draftState`,还可单独传入受版本化 Schema 约束的 `state`,用于正文编辑模式、范本选择和变量快照等工作区状态。`state` 不会成为 Data API 字段、工作流事实或生成表单控件;`list` 会返回当前有效 Schema 及 digest,声明撤销、收窄或版本/digest 不匹配会稳定失败而不会静默丢字段。`submit` 消费现有 DataTransactionOperation,不另建 CRUD 后端。此能力需要平台的 authenticated-form-drafts SQL 迁移及对应服务端版本,平台未升级时界面会明确显示暂存失败并保留输入。
178
178
 
179
179
  ## 列表排序声明 {#sortable-fields}
180
180
 
@@ -41,6 +41,14 @@ SDK 继承当前环境与身份,平台沿用发起人或既有超级管理员
41
41
  `items/nextCursor`,分页与多次流程的选择规则见[前端](frontend.md)。找回后使用原
42
42
  `receipt/poll/surface`;查询不重放提交、不生成第二份命令状态。
43
43
 
44
+ 自定义表单页若先用 `createResourceFormDraftClient` 保存认证草稿,并由 Named Action
45
+ 提交业务记录和流程,则在同一次 `OpenXiangdaBusinessProcessService.commit` 中传入
46
+ `formDraft: { resourceCode, id, expectedRevision, mode, recordId?, viewCode? }`。草稿必须
47
+ 与 `workflow.subject.fromOperation` 指向的 create/update 操作完全同资源、同模式和同
48
+ 记录;平台按当前真实用户、应用与环境锁定 revision,在业务写入和 durable command
49
+ 同一事务中消费。失败或未知结果时不要先删草稿,也不要换幂等键;使用原
50
+ `idempotencyKey` 重放或读取 `receipt/poll`。成功后也不要再做 best-effort 删除。
51
+
44
52
  自定义 operation 的 capability 必须先在 `authz.capabilities` 以
45
53
  `kind: 'backend'` 声明,再由 operation 和允许调用它的角色共同引用。普通资源 CRUD
46
54
  能力仍由编译器生成,不写入显式 capability catalog。