openxiangda-skill-kit 2.0.10 → 2.0.12
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.0.
|
|
3
|
+
"version": "2.0.12",
|
|
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.4.
|
|
20
|
+
"openxiangda-devkit-core": "2.4.2"
|
|
21
21
|
},
|
|
22
22
|
"devDependencies": {
|
|
23
23
|
"tsx": "4.23.12",
|
|
@@ -41,6 +41,28 @@ DataQuery 使用有界 where 条件树，支持 and/or/not。标准列表的筛
|
|
|
41
41
|
|
|
42
42
|
## 标准后台扩展
|
|
43
43
|
|
|
44
|
+
### 未保存内容的离开保护
|
|
45
|
+
|
|
46
|
+
自定义表单可在 `OpenXiangdaApplication` 内调用
|
|
47
|
+
`useUnsavedChangesGuard({ when, message? })`。`when` 包含未保存表单、正在提交或
|
|
48
|
+
结果尚不确定的状态；成功后清除，组件卸载时自动注销。多个表单由应用入口统一汇总，
|
|
49
|
+
不需要应用创建路由或拦截 document 点击。
|
|
50
|
+
|
|
51
|
+
```tsx
|
|
52
|
+
useUnsavedChangesGuard({
|
|
53
|
+
when: !result && (hasDraft || pending || hasUnresolvedIntent),
|
|
54
|
+
message: '会议尚未提交完成，离开将丢失当前填写内容。',
|
|
55
|
+
});
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
站内使用 React Router 的 `Link` 或 `navigate`，前进/后退与程序跳转使用同一确认框。
|
|
59
|
+
确认框打开时保留第一次目标，取消后继续原地编辑。刷新、关闭和文档跳转使用浏览器
|
|
60
|
+
原生提示，其文案和是否展示受浏览器限制。保存成功可在状态清除后的 effect 中跳转。
|
|
61
|
+
该 hook 只保护导航，不持久化草稿或恢复提交回执；业务数据仍由各自既有能力负责。
|
|
62
|
+
不要直接调用 `history.pushState` 或修改路由内部状态。
|
|
63
|
+
|
|
64
|
+
### 应用时区
|
|
65
|
+
|
|
44
66
|
如业务采用固定时区，在现有 `OpenXiangdaApplication` 传可选 `timeZone`，例如
|
|
45
67
|
`Asia/Shanghai`。标准表单、审批摘要和各中心时间随同一 UI Provider 展示，应用无需
|
|
46
68
|
修改设备时区或保存第二份时间。具体控件参数见[字段组件](field-components.md)。
|
|
@@ -62,6 +62,8 @@ AppSpec 随开发持续维护：测试发布前补齐总纲、关联变更与验
|
|
|
62
62
|
|
|
63
63
|
`dev` 监听本机回环地址，页面通过同源代理访问平台测试数据。浏览器不持久化平台凭据。终端和页面显示当前环境；只有生产环境时会持续提示生产数据风险。开发数据写入仍是远端真实写入，按任务范围操作。
|
|
64
64
|
|
|
65
|
+
前端启动使用根目录 `dev:web`。声明了后端的应用同时运行配置的 `backend.root` 包内的 `dev`，无需增加根目录 `dev:server`；纯前端应用只启动 Web 和代理。已有前端测试版本后，可以启用本地 Nest 联调，不必先构建或发布后端镜像。平台返回的活动应用版本和开发会话绑定本次联调，环境版本变化导致会话不一致时，停止后重新运行 `dev`。
|
|
66
|
+
|
|
65
67
|
纯 CRUD 修改优先使用标准模型、字段和页面；跨模型事务或外部副作用再选择后端。角色、行和字段权限在平台执行。详见[开发流程](development.md)、[模型与标准 CRUD](application-foundation.md)和[按需后端](backend.md)。
|
|
66
68
|
|
|
67
69
|
## 应用源码
|