openxiangda 2.4.1 → 2.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.4.1",
+  "version": "2.6.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,16 +55,18 @@
     "README.md"
   ],
   "dependencies": {
+    "@js-temporal/polyfill": "0.5.1",
+    "@rc-component/picker": "1.10.0",
     "antd-mobile": "5.42.3",
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
-    "openxiangda-cli": "2.2.6",
-    "openxiangda-contracts": "2.4.0",
-    "openxiangda-devkit-core": "2.4.0",
+    "openxiangda-cli": "2.2.8",
+    "openxiangda-contracts": "2.5.0",
+    "openxiangda-devkit-core": "2.4.1",
     "openxiangda-legacy": "npm:openxiangda@1.0.268",
-    "openxiangda-mcp": "2.0.6",
-    "openxiangda-nest": "2.0.7",
-    "openxiangda-skill-kit": "2.0.8",
+    "openxiangda-mcp": "2.0.7",
+    "openxiangda-nest": "2.1.0",
+    "openxiangda-skill-kit": "2.0.10",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -130,17 +132,18 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.4.1",
-    "title": "事件处理器依赖作用域修复",
+    "version": "2.6.0",
+    "title": "统一应用时区与日期时间输入",
     "status": "reviewed",
-    "summary": "事件处理器可正常注入请求级通知服务，签名与回执校验后再由所属 Nest 模块解析依赖。",
-    "newFeatures": [],
+    "summary": "应用可指定业务展示时区，标准字段、审批详情、待办、通知和审计时间统一显示，日期时间输入仍保存 UTC。",
+    "newFeatures": [
+      "OpenXiangdaApplication 和 OpenXiangdaUiProvider 接受可选 timeZone；日期时间字段可覆盖时区并声明 min、max 和 minuteStep。"
+    ],
     "fixes": [
-      "修复请求级依赖使事件处理器构造函数未执行、handle 调用失败的问题。",
-      "同名 provider 严格按所属模块解析，并发投递与失败重试使用独立作用域；静态单例继续复用。"
+      "修复设备时区不同导致日期时间编辑和公共详情、中心时间不一致的问题，拒绝夏令时不存在或重复的本地时间。"
     ],
     "affectedUsers": [
-      "使用 Nest 签名事件处理器及请求级通知服务或瞬态依赖的 V2 应用开发者。"
+      "需要固定业务时区或限制日期时间输入的 V2 应用开发者。"
     ],
     "compatibility": {
       "node": ">=24",
@@ -148,20 +151,21 @@
         "v1",
         "v2"
       ],
-      "v1Policy": "V1 引擎与已有应用契约不变。",
-      "platformPolicy": "沿用 2.4.0 的 Data API 1.1.0 要求；事件签名、回执、身份与部署协议不变。"
+      "v1Policy": "V1 引擎和已有应用不变。",
+      "platformPolicy": "展示与输入能力，无新增服务端契约或数据库迁移。未配置时区和限制的应用保留设备本地行为。"
     },
     "upgradeSteps": [
-      "将应用精确依赖升级至 openxiangda 2.4.1，刷新工作区资料并重新检查。",
-      "重新发布应用后验证真实事件、通知送达、重复投递与失败恢复。"
+      "将应用精确依赖升级至 openxiangda 2.6.0，更新锁文件并刷新技能资料。",
+      "在应用入口指定业务 timeZone，验证 PC 和移动端编辑、审批摘要与各中心显示。"
     ],
     "knownLimitations": [
-      "事件作用域的 REQUEST 不含用户授权，sendFromEvent 仅在已验证的事件执行期间可用。",
-      "SDK 测试通过不代表真实平台通知送达或应用业务验收已完成。"
+      "时区只影响呈现；服务端仍须独立验证业务时间窗口和授权。",
+      "手机指定时区的日期时间滚轮提供当前选择前后各 365 天并按限制收窄；夏令时重复时间需选择其他无歧义时间。",
+      "包发布、应用部署和实际业务验收分别验证。"
     ],
     "issues": [],
-    "sha256": "f81f626e3fb91069c4f5d94da48a80400ae3fca5e3b55ab0d77e0a7c82dc7681",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.4.1"
+    "sha256": "ba11ac3a69cbd9dd27e339c1d84642af99e107ca1170f0876b8be0583abda79f",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.6.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.5.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.5.0",
+  "title": "按业务记录恢复原流程命令",
+  "status": "reviewed",
+  "summary": "浏览器和 Nest 可在重新进入详情时按业务记录查找原流程命令，继续原回执和进度查询。",
+  "newFeatures": [
+    "增加当前用户范围的流程命令分页查询，支持精确记录、流程和操作筛选，每页最多 50 条。"
+  ],
+  "fixes": [
+    "补齐业务记录已提交但流程事件尚未投影时，从列表重新进入详情无法定位原命令的恢复路径。"
+  ],
+  "affectedUsers": [
+    "使用 Business Process 原子提交业务数据与流程的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎和已有应用不变。",
+    "platformPolicy": "使用 Business Process 的新编译包要求 durable-command 1.1.0 和匹配的共享校验器；旧客户端继续兼容。"
+  },
+  "upgradeSteps": [
+    "将应用精确依赖升级至 openxiangda 2.5.0，更新锁文件并刷新技能资料。",
+    "平台部署匹配版本后执行检查和测试发布，验证重新进入详情时恢复原命令而不重复提交。"
+  ],
+  "knownLimitations": [
+    "查询沿用原命令的发起人或既有超级管理员权限，记录读取权限不授予他人命令访问。",
+    "同一记录可能有多次流程，应用须根据业务约束选择原命令，不能任意选择第一条。",
+    "包发布、平台部署和实际业务验收分别验证。"
+  ],
+  "issues": [],
+  "sha256": "35a3bd6f8f97d3261243e1c65e2876a946448c5af455f43ababf18bd8f6f3653",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.5.0"
+}

package/releases/2.6.0.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.6.0",
+  "title": "统一应用时区与日期时间输入",
+  "status": "reviewed",
+  "summary": "应用可指定业务展示时区，标准字段、审批详情、待办、通知和审计时间统一显示，日期时间输入仍保存 UTC。",
+  "newFeatures": [
+    "OpenXiangdaApplication 和 OpenXiangdaUiProvider 接受可选 timeZone；日期时间字段可覆盖时区并声明 min、max 和 minuteStep。"
+  ],
+  "fixes": [
+    "修复设备时区不同导致日期时间编辑和公共详情、中心时间不一致的问题，拒绝夏令时不存在或重复的本地时间。"
+  ],
+  "affectedUsers": [
+    "需要固定业务时区或限制日期时间输入的 V2 应用开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎和已有应用不变。",
+    "platformPolicy": "展示与输入能力，无新增服务端契约或数据库迁移。未配置时区和限制的应用保留设备本地行为。"
+  },
+  "upgradeSteps": [
+    "将应用精确依赖升级至 openxiangda 2.6.0，更新锁文件并刷新技能资料。",
+    "在应用入口指定业务 timeZone，验证 PC 和移动端编辑、审批摘要与各中心显示。"
+  ],
+  "knownLimitations": [
+    "时区只影响呈现；服务端仍须独立验证业务时间窗口和授权。",
+    "手机指定时区的日期时间滚轮提供当前选择前后各 365 天并按限制收窄；夏令时重复时间需选择其他无歧义时间。",
+    "包发布、应用部署和实际业务验收分别验证。"
+  ],
+  "issues": [],
+  "sha256": "ba11ac3a69cbd9dd27e339c1d84642af99e107ca1170f0876b8be0583abda79f",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.6.0"
+}

package/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "5ce1c45212e3f66651e1740bfa3c6686e41f0c7da950d2bc3c15bf94c09294c0"
+      "sha256": "490bdc9d5e3cd6fed2a7ce48b04341e67d3d9e78b2a2b02f0984afee68ba17c7"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -18,10 +18,10 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.4.1 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.4.1 login --base-url <平台地址>
-pnpm dlx openxiangda@2.4.1 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.4.1 skill install --force
+pnpm dlx openxiangda@2.6.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.6.0 login --base-url <平台地址>
+pnpm dlx openxiangda@2.6.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.6.0 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。

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。

package/skills/openxiangda-v2/references/getting-started.md

@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.4.1 skill install --force
-pnpm dlx openxiangda@2.4.1 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.4.1 login --base-url https://platform.example.com
-pnpm dlx openxiangda@2.4.1 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.6.0 skill install --force
+pnpm dlx openxiangda@2.6.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.6.0 login --base-url https://platform.example.com
+pnpm dlx openxiangda@2.6.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -114,9 +114,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.4.1 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.4.1 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.4.1 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.6.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.6.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.6.0 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回