openxiangda-skill-kit 2.0.8 → 2.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "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。

package/skills/openxiangda-v2/references/field-components.md

@@ -214,6 +214,31 @@ pnpm openxiangda check
 
 ## 移动字段呈现与分组
 
+### 应用时区与时间限制
+
+`OpenXiangdaApplication` 的可选 `timeZone="Asia/Shanghai"` 统一标准表单、详情、
+审批业务摘要、待办/通知、审计和草稿时间的展示。独立使用组件时可在
+`OpenXiangdaUiProvider` 传同一参数；不指定时保留浏览器本地时区。
+这只影响输入与展示，`datetime` / `datetime-range` 仍读写 UTC ISO instant。
+`date` / `date-range` 保留自然日期，`time` 保留无日期时间。
+
+`DateTimeField`、`DateTimeFilter`、`DateTimeValueDisplay` 和 `MobileDateTimeField`
+可显式传 `timeZone` 覆盖应用默认。日期时间输入还可传 `min` / `max`（含端点的
+ISO instant）与 `minuteStep`（1 到 60 且整除 60）。设置步长后只接受整分钟，秒和
+毫秒为零；例如 `minuteStep={15}`。服务端仍须验证最终业务窗口与授权。
+
+```tsx
+<DateTimeField field={startsAtField} value={startsAt} onChange={setStartsAt}
+  timeZone="Asia/Shanghai" minuteStep={15}
+  min="2026-09-08T01:00:00Z" max="2026-10-08T01:00:00Z" />
+```
+
+输入到夏令时不存在或重复的墙上时间时显示错误，不自动选偏移。无效时区、步长或
+上下限配置会报错。手机指定时区的日期时间使用日期/时间滚轮，最多提供当前选择前后
+各 365 天并按限制收窄；范围仍分两步确认，取消不修改原值。
+
+### 字段布局
+
 移动字段自身提供无边框输入、上下标签、行分隔和错误提示；标准表单与自定义页面使用同一
 字段组件。页面负责把相关字段组织在浅色背景上的白色分组中，不另设移动主题配置。
 

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

@@ -41,6 +41,10 @@ DataQuery 使用有界 where 条件树，支持 and/or/not。标准列表的筛
 
 ## 标准后台扩展
 
+如业务采用固定时区，在现有 `OpenXiangdaApplication` 传可选 `timeZone`，例如
+`Asia/Shanghai`。标准表单、审批摘要和各中心时间随同一 UI Provider 展示，应用无需
+修改设备时区或保存第二份时间。具体控件参数见[字段组件](field-components.md)。
+
 默认 CRUD、统一 Shell、current-user 权限和 Data Provider 都由 `openxiangda/react`
 维护；应用拥有后台信息架构声明。页面实现、路由可达、菜单可见是三个不同合同：
 
@@ -202,6 +206,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。