openxiangda 2.5.0 → 2.6.0

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "d2327918d1e82d341d62bd17343b00fe61d24fd0540ea0fdd6d5bda746571b24"
+      "sha256": "156d5177d012bd0646d65336c319171558e2ac9dffaa58ae0ee7ff22d0a0ea21"
     },
     {
       "id": "product-design",
@@ -48,13 +48,13 @@
       "id": "frontend",
       "title": "页面与标准组件扩展",
       "file": "frontend.md",
-      "sha256": "8073d6f66b994ade2e5a4e806062dfe2182fefd3b2fe695d8ebb2a176d7ae68b"
+      "sha256": "4a9797610d297a244e99c1c377e6483d6f798f7e57c4799c8e7d3d263db96714"
     },
     {
       "id": "field-components",
       "title": "字段、表单与移动控件",
       "file": "field-components.md",
-      "sha256": "b26da9fb33518203c59a154dd0117f714f3edab5a4d84936b71107c936516893"
+      "sha256": "4bb36d6b6162be84aaf95b86fabe2e44805d5f9441dc8cfa5f951c24ce6d6102"
     },
     {
       "id": "data-authz",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.5.0",
+  "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.7",
+    "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.7",
     "openxiangda-nest": "2.1.0",
-    "openxiangda-skill-kit": "2.0.9",
+    "openxiangda-skill-kit": "2.0.10",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -130,18 +132,18 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.5.0",
-    "title": "按业务记录恢复原流程命令",
+    "version": "2.6.0",
+    "title": "统一应用时区与日期时间输入",
     "status": "reviewed",
-    "summary": "浏览器和 Nest 可在重新进入详情时按业务记录查找原流程命令，继续原回执和进度查询。",
+    "summary": "应用可指定业务展示时区，标准字段、审批详情、待办、通知和审计时间统一显示，日期时间输入仍保存 UTC。",
     "newFeatures": [
-      "增加当前用户范围的流程命令分页查询，支持精确记录、流程和操作筛选，每页最多 50 条。"
+      "OpenXiangdaApplication 和 OpenXiangdaUiProvider 接受可选 timeZone；日期时间字段可覆盖时区并声明 min、max 和 minuteStep。"
     ],
     "fixes": [
-      "补齐业务记录已提交但流程事件尚未投影时，从列表重新进入详情无法定位原命令的恢复路径。"
+      "修复设备时区不同导致日期时间编辑和公共详情、中心时间不一致的问题，拒绝夏令时不存在或重复的本地时间。"
     ],
     "affectedUsers": [
-      "使用 Business Process 原子提交业务数据与流程的 V2 应用开发者。"
+      "需要固定业务时区或限制日期时间输入的 V2 应用开发者。"
     ],
     "compatibility": {
       "node": ">=24",
@@ -150,20 +152,20 @@
         "v2"
       ],
       "v1Policy": "V1 引擎和已有应用不变。",
-      "platformPolicy": "使用 Business Process 的新编译包要求 durable-command 1.1.0 和匹配的共享校验器；旧客户端继续兼容。"
+      "platformPolicy": "展示与输入能力，无新增服务端契约或数据库迁移。未配置时区和限制的应用保留设备本地行为。"
     },
     "upgradeSteps": [
-      "将应用精确依赖升级至 openxiangda 2.5.0，更新锁文件并刷新技能资料。",
-      "平台部署匹配版本后执行检查和测试发布，验证重新进入详情时恢复原命令而不重复提交。"
+      "将应用精确依赖升级至 openxiangda 2.6.0，更新锁文件并刷新技能资料。",
+      "在应用入口指定业务 timeZone，验证 PC 和移动端编辑、审批摘要与各中心显示。"
     ],
     "knownLimitations": [
-      "查询沿用原命令的发起人或既有超级管理员权限，记录读取权限不授予他人命令访问。",
-      "同一记录可能有多次流程，应用须根据业务约束选择原命令，不能任意选择第一条。",
-      "包发布、平台部署和实际业务验收分别验证。"
+      "时区只影响呈现；服务端仍须独立验证业务时间窗口和授权。",
+      "手机指定时区的日期时间滚轮提供当前选择前后各 365 天并按限制收窄；夏令时重复时间需选择其他无歧义时间。",
+      "包发布、应用部署和实际业务验收分别验证。"
     ],
     "issues": [],
-    "sha256": "35a3bd6f8f97d3261243e1c65e2876a946448c5af455f43ababf18bd8f6f3653",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.5.0"
+    "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.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": "d001775cd43ef5b66b371f41ae64f982da68ce4f84f0a9943b2bac3f27fbea63"
+      "sha256": "490bdc9d5e3cd6fed2a7ce48b04341e67d3d9e78b2a2b02f0984afee68ba17c7"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -18,10 +18,10 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.5.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.5.0 login --base-url <平台地址>
-pnpm dlx openxiangda@2.5.0 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.5.0 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/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`
 维护；应用拥有后台信息架构声明。页面实现、路由可达、菜单可见是三个不同合同：
 

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

@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.5.0 skill install --force
-pnpm dlx openxiangda@2.5.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.5.0 login --base-url https://platform.example.com
-pnpm dlx openxiangda@2.5.0 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.5.0 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.5.0 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.5.0 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 根据平台已经登记的绑定返回