openxiangda-skill-kit 2.1.5 → 2.1.8

package/package.json

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

package/skills/openxiangda-v2/references/application-foundation.md

@@ -175,3 +175,40 @@ import 'openxiangda/mobile/styles.css';
 PC 抽屉提供“全屏 / 新开页面 / 关闭”。全屏保留当前表单；新开页面先暂存，再通过草稿 ID 恢复，内容不放入 URL。移动录入使用平台移动字段的分组行式布局、简单标题和底部操作，不放“返回列表”或桌面输入控件；草稿箱和恢复确认使用底部弹层。
 
 自定义表单可从 `openxiangda/react` 使用 `createResourceFormDraftClient(resourceCode, mode, recordId?, viewCode?)`，提供 `list/save/remove/submit`。命名视图只能恢复和提交属于当前视图的草稿；所有视图仍共用每人每个模型 20 份的上限。`save` 使用草稿 ID、expectedRevision 和可编辑字段值；`submit` 消费现有 DataTransactionOperation，不另建 CRUD 后端。此能力需要平台的 authenticated-form-drafts SQL 迁移及对应服务端版本，平台未升级时界面会明确显示暂存失败并保留输入。
+
+## 列表排序声明 {#sortable-fields}
+
+模块化列表视图用 `sortableFields` 声明用户可点击列头排序的列；`defaultSort.field`
+隐式可排序，两者重复出现不报错。与 `filterFields` / `searchableFields` 同构：
+
+```ts
+crud: [{
+  model: 'venues',
+  list: {
+    fields: ['name', 'capacity'],
+    filterFields: ['capacity'],
+    searchableFields: ['name'],
+    sortableFields: ['capacity'],
+    defaultSort: { field: 'name', order: 'asc' },
+  },
+}]
+```
+
+引用未声明字段按编译错误处理；低层 `data.resources[].fields[].sortable` 语义不变。
+
+## 资源详情路由声明 {#detail-route-code}
+
+Workflow 详情接管的资源侧绑定用模型级 `detailRouteCode` 表达，desktop/mobile 各引用一条
+前端路由；投影完整透传到 `data.resources[].detailRouteCode`，低层声明语义不变：
+
+```ts
+defineDataModel({
+  code: 'venue-reservations', name: '场地预约',
+  detailRouteCode: { desktop: 'reservation-detail', mobile: 'reservation-detail-mobile' },
+  fields: [/* ... */],
+})
+```
+
+两条路由必须已声明为 user surface、只带一个有界动态记录参数，且路由 capability 覆盖资源
+read 能力；桌面路由不位于 `/m/`，移动路由必须位于 `/m/`。模型声明出现未知属性时报
+`APP_MODEL_KEY_UNKNOWN` 编译错误——声明层的拼写错误不允许被静默丢弃。

package/skills/openxiangda-v2/references/declarations-cheatsheet.md

@@ -11,6 +11,7 @@
 | 视图 `list`/`form`/`detail` 的 `model` 可省略（继承视图模型）；显式声明时必须与 `crud[].model` 一致 | `list: { fields: [...] }` 即可，不必写 `model` |
 | 每个模型最多 20 个命名视图；命名视图需要稳定 `code` + `name` | `crud: [{ model: 'x', code: 'x-active', name: '进行中', ... }]` |
 | 新建视图的 `form.fields` 必须覆盖全部无默认必填字段，或显式 `generated.create: false` | 检查器会列出缺失字段 |
+| Workflow 详情接管的资源路由用模型级 `detailRouteCode` 表达（desktop/mobile 各引用一条 user surface 路由） | `defineDataModel({ code: 'x', detailRouteCode: { desktop: 'x-detail', mobile: 'x-detail-mobile' }, ... })` |
 
 ## 字段声明
 
@@ -22,6 +23,7 @@
 | `audit.read` 可写 `true`（绑定本资源读能力）或能力数组 | `audit: { read: true }` |
 | `resource-ref.*` 必须带 `source` 来源协议 | `{ type: 'resource-ref.single', source: { kind: 'resource', resourceCode: 'repair-requests', labelField: 'title', searchFields: ['title'], pageSize: 20, loadMode: 'search' } }` |
 | `labelField` 必须指向目标资源的 `text.short` / `text.long` 字段 | 不要用流水号/选项字段当 label |
+| 列表可排序列用视图级 `sortableFields` 表达（`defaultSort.field` 隐式可排序） | `list: { sortableFields: ['capacity'], defaultSort: { field: 'name', order: 'asc' } }` |
 | 每个字段都必须带中文/业务 `label`（含子表外键与排序字段） | `{ code: 'requestId', type: 'uuid', label: '所属申请', required: true }` |
 | 子表 `subtable` 的外键是子资源的 **uuid** 字段，排序字段是**可写 number.integer** | 子资源：`{ code: 'requestId', type: 'uuid', required: true }` + `{ code: 'sortOrder', type: 'number.integer', required: true }`；父表：`subtable: { resourceCode: 'repair-items', foreignKey: 'requestId', orderField: 'sortOrder', maxRows: 20 }` |
 | 图片/附件的 `file` 限定数量与大小 | `file: { maxCount: 3, maxSizeMb: 10, accept: ['image/png', 'image/jpeg'] }` |