openxiangda-cli 2.0.0-alpha.117 → 2.0.0-alpha.119

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-cli",
-  "version": "2.0.0-alpha.117",
+  "version": "2.0.0-alpha.119",
   "description": "Thin application-level CLI for OpenXiangda 2.0.",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,10 +21,10 @@
   ],
   "dependencies": {
     "@oclif/core": "4.13.3",
-    "openxiangda-contracts": "2.0.0-alpha.56",
-    "openxiangda-devkit-core": "2.0.0-alpha.73",
-    "openxiangda-mcp": "2.0.0-alpha.73",
-    "openxiangda-skill-kit": "2.0.0-alpha.92"
+    "openxiangda-contracts": "2.0.0-alpha.58",
+    "openxiangda-devkit-core": "2.0.0-alpha.75",
+    "openxiangda-mcp": "2.0.0-alpha.75",
+    "openxiangda-skill-kit": "2.0.0-alpha.94"
   },
   "devDependencies": {
     "tsx": "4.23.12",

package/template/AGENTS.md

@@ -3,7 +3,7 @@
 - Use only the workspace-pinned CLI: `pnpm openxiangda <command>`. Never invoke a bare global `openxiangda` inside a 2.0 task.
 - `appspec/` is the optional OpenXiangda 2.0 business-intent layer. Before changing observable behavior, read the bounded index with `pnpm openxiangda spec context --json`, then select only the relevant stable ID; use no ChangeSpec for L0 work, one short ChangeSpec for L1, and add permission/rollback/concurrency detail only for L2/L3. Before close, the user—not AI—confirms `currentSpec=merged` or `not-applicable`. AppSpec is advisory and never a release gate. Never read, import or migrate 1.x `openspec/` or SDD.
 - Use Vite, React Router, Refine Core and Ant Design. Do not add Umi, ProComponents or another admin shell.
-- Keep generated admin routes and custom actions inside the platform Shell. Bind generated `appRoutes` to local operation pages with `defineAdminContributions`, and use only its typed `toolbar`, `row` and `detail` resource slots. Declare the complete editable menu with `defineAdminNavigation` and its page/group helpers; the Shell renders only generated `adminNavigation` references and permissions only filter them. Do not create another router, menu store, layout, identity provider, permission store or copied CRUD page; route/action access uses capability or `allOf`/`anyOf`, while Data/App API authorization remains server-owned.
+- Bind every generated `appRoutes` entry to its local page with `defineApplicationContributions`; desktop `admin` routes stay inside the platform Shell, while `user` routes render without an admin Shell for independent mobile/user experiences. Use only its typed `toolbar`, `row` and `detail` resource slots for generated resource actions. Declare the complete editable admin menu with `defineAdminNavigation` and its page/group helpers; the Shell renders only generated `adminNavigation` references and permissions only filter them. Do not create another router, menu store, layout, identity provider, permission store or copied CRUD page; route/action access uses capability or `allOf`/`anyOf`, while Data/App API and Workflow authorization remain server-owned.
 - Declare each resource once in `openxiangda.config.ts` with only `code`, `name`, `fields` and optional `mutationOwner`, generated/list/layout/data-policy settings. Each field owns type, label, required state, Surface flags, reference/file metadata and access. Resource codes are lower kebab-case. Use `native` for direct Data API mutations, `action`, `readonly` or `workflow` for non-Native ownership; never grant or generate Native mutation for a non-Native owner.
 - Never write resource-level `schemaVersion`, `appCode`, `schema`, `surface`, `capabilities`, `fieldPolicies` or `platform/data` modules. The compiler derives the strict DataResource, CRUD capabilities, Surface and AI Schema. The application manifest still starts with its one top-level `schemaVersion: 3`.
 - Ordinary list/get/create/update/delete, filters, export and batch operations use the platform Native Data API. Do not create Function CRUD or NestJS wrappers.
@@ -20,6 +20,6 @@
 - `option.*`, `user.*`, `department.*` and `resource-ref.*` values never collapse to scalar IDs. Single values store one labeled object and multiple values store object arrays. `resource-ref.*` JSON is not a foreign key, trusted target snapshot or automatically refreshed copy; current target state is read by `resourceCode` plus `value`. A resource source `labelField` must be `text.short` or `text.long`; `serial-number` is allowed in source search, description and snapshot fields, but not as the label. `location` accepts only exact WGS84 coordinates captured by DingTalk or browser geolocation; it has no manual input or `manual` source. Roles that consume directory-backed fields explicitly include `app:<app-code>:directory:read`.
 - Derive role grants with `resourceCapabilityCodes(appCode, resourceCode)`. Declare current-user rows only with `currentUserDataPolicy(...)`; do not invent operators, values or alternate current-user spellings.
 - Do not add compatibility aliases, migration branches or silent fallbacks for an earlier 2.0 alpha contract. Replace an incorrect contract and regenerate the application.
-- Standard Workflow and Notification Hub are optional 2.0 modules. Enable them only through the canonical `openxiangda.config.ts` declarations and generated clients; declare each Workflow launch as `standalone`, `custom-page`, `hidden-handoff` or `work-center-only`, put only self-contained standalone launch pages in navigation, and bind durable save handlers with `defineWorkflowLaunchContributions` without repeating generated titles. Never depend on temporary router location state or copy 1.x workflow/message code, tables, APIs, templates or callbacks into this workspace. Keep ordinary CRUD and application-specific state machines independent of them.
+- Standard Workflow and Notification Hub are optional 2.0 modules. Enable them only through the canonical `openxiangda.config.ts` declarations and generated clients; declare each Workflow launch as `standalone`, `custom-page`, `hidden-handoff` or `work-center-only`, put only self-contained standalone launch pages in navigation, and bind durable save handlers with `defineWorkflowLaunchContributions` without repeating generated titles. Desktop and mobile standard launch pages load the same canonical Workflow launch Surface. To replace Workflow detail, declare both desktop and mobile `detailRouteCode` values whose routes contain exactly `:instanceId`; Work Center, the application todo center and notification channels consume the platform-resolved paths, while every Surface and command remains server-authorized. Add the standard current-user todo page only with `adminApplicationTodoCenterPage()`; never query Notification Hub management APIs from a user page. Never depend on temporary router location state or copy 1.x workflow/message code, tables, APIs, templates or callbacks into this workspace. Keep ordinary CRUD and application-specific state machines independent of them.
 - Run `pnpm openxiangda check --json` after contract changes and read `data.sealedArtifact`; check never seals, and an older `.openxiangda/build/app-package.json` is not the current check result. Use `pnpm openxiangda accept --plan <file>` only for optional real preproduction identity acceptance; it never blocks delivery. Deploy with `pnpm openxiangda deploy`, inspect with `pnpm openxiangda status` and `pnpm openxiangda logs`, and use the platform rollback command rather than mutating K3s directly.
 - AI-native clients start the workspace protocol through the same pinned binary: `pnpm exec openxiangda --mcp-stdio --cwd <workspace>`. Read `openxiangda://workspace/contracts` or call `contract_describe`; for first-time menu authoring, copy `data.adminNavigationAuthoring.suggestion.expression` once into `frontend.admin.navigation` with its listed `openxiangda/config` imports, then edit that application-owned declaration. Never treat the proposal as runtime discovery. When AppSpec is enabled, also read `openxiangda://workspace/appspec` or call `appspec_context`. Require `aiCatalog` and `aiCatalogDigest` to match the normal compiler output. This is a stdio transport mode, not another application-owned server. Never write an application MCP server, Catalog file, preview store or second authorization path.

package/template/README.md

@@ -18,6 +18,14 @@ pnpm openxiangda dev
 
 字段组件、CRUD Renderer、Shell、Runtime 与 Data/Directory/File/App Client 都由 `openxiangda/react`、`openxiangda/field-kit` 和 `openxiangda/core` 统一提供，应用模板不复制这些实现。Nest 只在需要复杂事务或外部集成时增加 App API。标准客户端显式携带当前环境、使用同源 Cookie；业务代码不读取或持久化 Token、平台内部身份标识与授权结果。
 
+同一应用的自定义后台页、PC 用户页和移动用户页统一声明在
+`frontend.routes`，再用 `defineApplicationContributions(appRoutes, { pages })`
+逐项绑定本地组件并传给 `OpenXiangdaApplication`。后者是唯一的
+BrowserRouter、RuntimeBoundary、Refine、generated routes 和后台 Shell
+所有者；用户页可以拥有独立布局，但不要再建 router/Shell。要使用通用应用待办中心，
+在显式后台导航组中加入 `adminApplicationTodoCenterPage()`；平台生成
+`/admin/todos` 与 `/m/todos`，只读取当前用户的消息/待办投影并统一解析目标页面。
+
 前端一次读取当前登录用户在当前环境的完整应用角色并集和 capability。应用可在 `perspectives` 中声明工作视角；视角只投影页面、行和字段的读取范围，不改变真实身份，也不收窄新增、编辑、删除、流程与自定义动作权限。标准 Data API 自动识别视角；只有绕过标准 Data API 的自定义 Nest 查询才需要通过 `@CurrentPerspective()` 显式实现同等读取投影。字段默认继承资源 read/create/update；`access` 数组为 all-of，`false` 为明确拒绝，无权字段在提交前从 payload 删除。
 
 ```bash

package/template/apps/server/package.json

@@ -15,7 +15,7 @@
     "@nestjs/common": "11.1.29",
     "@nestjs/core": "11.1.29",
     "@nestjs/platform-fastify": "11.1.29",
-    "openxiangda": "2.0.0-alpha.31",
+    "openxiangda": "2.0.0-alpha.33",
     "reflect-metadata": "0.2.2",
     "rxjs": "7.8.2"
   },

package/template/apps/web/e2e/workflow-experience-fixture.tsx

@@ -1,11 +1,13 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
 import {
+  defineApplicationContributions,
   defineWorkflowLaunchContributions,
   OpenXiangdaApplication,
   type AdminNavigationInput,
   type AdminPagesInput,
 } from 'openxiangda/react';
+import { useParams, useSearchParams } from 'react-router-dom';
 import { appCode } from '../../../packages/contracts/src/generated.js';
 import 'openxiangda/react/styles.css';
 
@@ -13,11 +15,54 @@ const workflowDefinitions = [
   {
     code: 'purchase-approval',
     title: '采购审批',
-    launch: { mode: 'work-center-only' },
+    launch: { mode: 'standalone' },
   },
 ] as const;
 
+const detailRoutes = {
+  desktop: {
+    code: 'purchase-detail',
+    path: '/admin/operations/purchases/:instanceId',
+    label: '采购审批详情',
+    surface: 'admin',
+    tabPersistence: 'none',
+    keepAlive: 'none',
+  },
+  mobile: {
+    code: 'purchase-detail-mobile',
+    path: '/m/purchases/:instanceId',
+    label: '移动采购审批详情',
+    surface: 'user',
+    tabPersistence: 'none',
+    keepAlive: 'none',
+  },
+} as const;
+
+function CustomWorkflowDetail() {
+  const { instanceId } = useParams();
+  const [search] = useSearchParams();
+  return (
+    <div data-testid="custom-workflow-detail">
+      自定义流程详情 {instanceId} / {search.get('taskId') || 'instance'}
+    </div>
+  );
+}
+
+const applicationContributions = defineApplicationContributions(detailRoutes, {
+  pages: {
+    desktop: CustomWorkflowDetail,
+    mobile: CustomWorkflowDetail,
+  },
+});
+
 const adminPages = [
+  {
+    code: 'application:todo-center',
+    kind: 'application-todo-center',
+    path: '/admin/todos',
+    label: '待办中心',
+    navigationEligible: true,
+  },
   {
     code: 'workflow:work-center',
     kind: 'workflow-work-center',
@@ -25,6 +70,14 @@ const adminPages = [
     label: '我的审批',
     navigationEligible: true,
   },
+  {
+    code: 'workflow:purchase-approval:launch',
+    kind: 'workflow-launch',
+    path: '/admin/workflows/purchase-approval/new',
+    label: '发起采购审批',
+    navigationEligible: true,
+    workflowCode: 'purchase-approval',
+  },
   {
     code: 'workflow:task',
     kind: 'workflow-task',
@@ -47,7 +100,15 @@ const adminNavigation = [
     label: '流程中心',
     icon: 'workflow',
     order: 0,
-    items: [{ pageCode: 'workflow:work-center', label: '我的审批', order: 0 }],
+    items: [
+      { pageCode: 'application:todo-center', label: '待办中心', order: 0 },
+      { pageCode: 'workflow:work-center', label: '我的审批', order: 1 },
+      {
+        pageCode: 'workflow:purchase-approval:launch',
+        label: '发起采购审批',
+        order: 2,
+      },
+    ],
   },
 ] as const satisfies AdminNavigationInput;
 
@@ -65,8 +126,19 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
       appName="流程体验验收"
       adminNavigation={adminNavigation}
       adminPages={adminPages}
+      contributions={applicationContributions}
       resourceDefinitions={{}}
-      workflows={defineWorkflowLaunchContributions(workflowDefinitions, {})}
+      workflows={defineWorkflowLaunchContributions(workflowDefinitions, {
+        'purchase-approval': async () => ({
+          businessKey: 'PO-2026-0825',
+          dataRef: {
+            resourceCode: 'purchase-orders',
+            recordId: 'purchase-1',
+            dataRevision: '8',
+          },
+          facts: { amount: 28600, applicant: '张三' },
+        }),
+      })}
     />
   </React.StrictMode>
 );

package/template/apps/web/e2e/workflow.spec.ts

@@ -7,7 +7,21 @@ function envelope(data: unknown, code = 200) {
   return { code, message: code === 200 ? 'success' : 'forbidden', data };
 }
 
-function task(completed = false) {
+function detailNavigation(custom = false) {
+  return custom
+    ? {
+        custom: true,
+        desktopPath: `/admin/operations/purchases/${instanceId}?taskId=${taskId}`,
+        mobilePath: `/m/purchases/${instanceId}?taskId=${taskId}`,
+      }
+    : {
+        custom: false,
+        desktopPath: `/admin/tasks/${taskId}`,
+        mobilePath: `/m/tasks/${taskId}`,
+      };
+}
+
+function task(completed = false, customDetail = false) {
   return {
     schemaVersion: 'openxiangda.workflow-task/v2',
     engineVersion: '2.0',
@@ -29,16 +43,18 @@ function task(completed = false) {
     dataRef: { resourceCode: 'purchase-orders', recordId: 'purchase-1' },
     createdAt: '2026-08-25T01:00:00.000Z',
     updatedAt: '2026-08-25T01:10:00.000Z',
+    detailNavigation: detailNavigation(customDetail),
   };
 }
 
-function surface(completed = false) {
+function surface(completed = false, customDetail = false) {
   return {
     schemaVersion: 'openxiangda.workflow-surface/v2',
     protocolVersion: 'workflow_surface_v2',
     surfaceRevision: completed ? 'revision-2' : 'revision-1',
     engineVersion: '2.0',
     instanceSequence: completed ? 4 : 3,
+    detailNavigation: detailNavigation(customDetail),
     navigationTarget: {
       kind: 'resource_record',
       appCode,
@@ -72,7 +88,7 @@ function surface(completed = false) {
       startedAt: '2026-08-25T01:00:00.000Z',
       completedAt: completed ? '2026-08-25T01:12:00.000Z' : null,
     },
-    task: completed ? null : task(false),
+    task: completed ? null : task(false, customDetail),
     presentation: {
       status: { label: completed ? '已同意' : '待审批', tone: 'warning' },
       layout: 'approval_detail',
@@ -117,7 +133,7 @@ function surface(completed = false) {
             },
             refresh: ['surface', 'timeline', 'work_center'],
           },
-          ...['reject', 'return', 'transfer', 'add_assignee'].map((key) => ({
+          ...['reject', 'return', 'transfer', 'add_assignee'].map(key => ({
             key,
             kind: 'workflow_command',
             label: {
@@ -184,9 +200,87 @@ function timeline(completed = false) {
   };
 }
 
-async function mockWorkflow(page: Page, options: { forbidden?: boolean } = {}) {
+function launchSurface() {
+  return {
+    schemaVersion: 'openxiangda.workflow-launch-surface/v2',
+    protocolVersion: 'workflow_launch_surface_v2',
+    surfaceRevision: 'launch-revision-1',
+    engineVersion: '2.0',
+    appCode,
+    environmentKey: 'preproduction',
+    environmentId: 'preproduction-id',
+    workflowCode: 'purchase-approval',
+    title: '采购审批',
+    launchMode: 'standalone',
+    inputSchema: { type: 'object', properties: {} },
+    head: {
+      workflowRevision: 4,
+      definitionVersion: 1,
+      bindingVersion: 1,
+      nativeRevision: 3,
+      contractRevisionId: 'contract-revision-1',
+    },
+    paths: {
+      desktop: '/admin/workflows/purchase-approval/new',
+      mobile: '/m/workflows/purchase-approval/start',
+    },
+    prepare: {
+      method: 'POST',
+      href: '/workflow/definitions/purchase-approval/prepare-start',
+    },
+    start: {
+      method: 'POST',
+      href: '/workflow/instances',
+      idempotencyRequired: true,
+    },
+  };
+}
+
+function todoPage() {
+  return {
+    schemaVersion: 'openxiangda.application-todo-center/v2',
+    appCode,
+    environmentKey: 'preproduction',
+    view: 'pending',
+    counts: { pending: 1, informational: 2, completed: 3, unread: 1 },
+    items: [
+      {
+        messageId: '33333333-3333-4333-8333-333333333333',
+        recipientId: '44444444-4444-4444-8444-444444444444',
+        state: 'action_required',
+        interactionState: 'unread',
+        title: '设备采购申请待审批',
+        summary: '张三提交了一笔办公设备采购申请',
+        fields: [
+          { code: 'amount', label: '申请金额', value: '¥28,600' },
+          { code: 'department', label: '申请部门', value: '理学院' },
+        ],
+        actions: [{ code: 'open', label: '去处理' }],
+        sourceKind: 'PLATFORM_EVENT',
+        sourceLabel: '流程中心',
+        occurredAt: '2026-08-28T01:00:00.000Z',
+        updatedAt: '2026-08-28T01:01:00.000Z',
+        navigation: {
+          desktopPath: `/admin/operations/purchases/${instanceId}?taskId=${taskId}`,
+          mobilePath: `/m/purchases/${instanceId}?taskId=${taskId}`,
+          external: false,
+          navigationUnavailable: false,
+        },
+      },
+    ],
+    total: 1,
+    limit: 12,
+    offset: 0,
+    nextOffset: null,
+  };
+}
+
+async function mockWorkflow(
+  page: Page,
+  options: { forbidden?: boolean; customDetail?: boolean } = {}
+) {
   let completed = false;
-  await page.route('**/service/**', async (route) => {
+  await page.route('**/service/**', async route => {
     const url = new URL(route.request().url());
     const path = url.pathname;
     if (path.endsWith('/native/authz/current')) {
@@ -229,7 +323,7 @@ async function mockWorkflow(page: Page, options: { forbidden?: boolean } = {}) {
               identityScope:
                 'user-union:preproduction-id:acceptance-user:authz-1',
             },
-          }),
+          })
         ),
       });
     }
@@ -246,6 +340,71 @@ async function mockWorkflow(page: Page, options: { forbidden?: boolean } = {}) {
         body: JSON.stringify(envelope(null, 403)),
       });
     }
+    if (path.endsWith('/todos') && route.request().method() === 'GET') {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope(todoPage())),
+      });
+    }
+    if (path.includes('/todos/') && path.endsWith('/interactions')) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            accepted: true,
+            duplicate: false,
+            interactionState: 'clicked',
+          })
+        ),
+      });
+    }
+    if (
+      path.endsWith(
+        '/workflow/definitions/purchase-approval/launch-surface'
+      )
+    ) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(envelope(launchSurface())),
+      });
+    }
+    if (
+      path.endsWith(
+        '/workflow/definitions/purchase-approval/prepare-start'
+      )
+    ) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            schemaVersion: 'openxiangda.workflow-preparation/v2',
+            preparationId: 'preparation-1',
+            status: 'ready',
+            requirements: [],
+            preparationToken: 'preparation-token-1',
+            preview: { nodes: [] },
+            expiresAt: '2026-08-28T02:00:00.000Z',
+            definitionVersion: 1,
+            bindingVersion: 1,
+            inputHash: 'input-hash-1',
+          })
+        ),
+      });
+    }
+    if (
+      path.endsWith('/workflow/instances') &&
+      route.request().method() === 'POST'
+    ) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope({
+            ...surface(false, options.customDetail).instance,
+            id: instanceId,
+          })
+        ),
+      });
+    }
     if (path.endsWith('/workflow/work-center/items')) {
       return route.fulfill({
         contentType: 'application/json',
@@ -258,15 +417,25 @@ async function mockWorkflow(page: Page, options: { forbidden?: boolean } = {}) {
             total: 1,
             limit: 20,
             offset: 0,
-            items: [task(completed)],
-          }),
+            items: [task(completed, options.customDetail)],
+          })
         ),
       });
     }
     if (path.endsWith(`/workflow/tasks/${taskId}/surface`)) {
       return route.fulfill({
         contentType: 'application/json',
-        body: JSON.stringify(envelope(surface(completed))),
+        body: JSON.stringify(
+          envelope(surface(completed, options.customDetail))
+        ),
+      });
+    }
+    if (path.endsWith(`/workflow/instances/${instanceId}/surface`)) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify(
+          envelope(surface(completed, options.customDetail))
+        ),
       });
     }
     if (path.endsWith(`/workflow/instances/${instanceId}/timeline`)) {
@@ -294,22 +463,93 @@ test('renders a paged desktop work center from the current-user role union', asy
   page,
 }) => {
   await mockWorkflow(page);
-  await page.goto(
-    '/workflow-experience.e2e.html?initial=/admin/work-center'
-  );
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/work-center');
   await expect(page.getByRole('heading', { name: '审批工作台' })).toBeVisible();
   await expect(page.getByRole('link', { name: '采购申请审批' })).toBeVisible();
   await expect(page.getByText('PO-2026-0825')).toBeVisible();
 });
 
-test('renders the independent mobile task and executes only a Surface operation', async ({
+test('renders the generic desktop and mobile application todo center without a second router', async ({
   page,
 }) => {
   await mockWorkflow(page);
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/todos');
+  await expect(page.getByRole('heading', { name: '待办中心' })).toBeVisible();
+  await expect(page.getByText('设备采购申请待审批').first()).toBeVisible();
+  await expect(page.getByText('¥28,600').first()).toBeVisible();
+
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto('/workflow-experience.e2e.html?initial=/m/todos');
+  await expect(page.locator('.oxa-todo-center-mobile')).toBeVisible();
+  await page.getByRole('button', { name: '去处理' }).click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+});
+
+test('launches the same workflow from the canonical mobile Surface and follows custom detail routing', async ({
+  page,
+}) => {
+  await mockWorkflow(page, { customDetail: true });
   await page.setViewportSize({ width: 390, height: 844 });
   await page.goto(
-    `/workflow-experience.e2e.html?initial=/m/tasks/${taskId}`
+    '/workflow-experience.e2e.html?initial=/m/workflows/purchase-approval/start'
   );
+  await expect(page.locator('.oxa-workflow-submission-mobile')).toBeVisible();
+  await expect(page.getByRole('heading', { name: '采购审批' })).toBeVisible();
+  await page.getByRole('button', { name: '保存业务数据并预检' }).click();
+  await expect(page.getByRole('button', { name: '提交审批' })).toBeVisible();
+  await page.getByRole('button', { name: '提交审批' }).click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+  await expect(page).toHaveURL(
+    new RegExp(`/m/purchases/${instanceId}\\?taskId=${taskId}$`)
+  );
+});
+
+test('routes desktop and mobile work-center entries to the declared custom detail pages', async ({
+  page,
+}) => {
+  await mockWorkflow(page, { customDetail: true });
+  await page.goto('/workflow-experience.e2e.html?initial=/admin/work-center');
+  await page.getByRole('link', { name: '采购申请审批' }).click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+  await expect(page).toHaveURL(
+    new RegExp(`/admin/operations/purchases/${instanceId}\\?taskId=${taskId}$`)
+  );
+
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto('/workflow-experience.e2e.html?initial=/m/work-center');
+  await page.getByText('采购申请审批').click();
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+  await expect(page).toHaveURL(
+    new RegExp(`/m/purchases/${instanceId}\\?taskId=${taskId}$`)
+  );
+});
+
+test('redirects a direct standard task URL to the declared custom detail page', async ({
+  page,
+}) => {
+  await mockWorkflow(page, { customDetail: true });
+  await page.goto(
+    `/workflow-experience.e2e.html?initial=/admin/tasks/${taskId}`
+  );
+  await expect(page.getByTestId('custom-workflow-detail')).toContainText(
+    `${instanceId} / ${taskId}`
+  );
+});
+
+test('renders the independent mobile task and executes only a Surface operation', async ({
+  page,
+}) => {
+  await mockWorkflow(page);
+  await page.setViewportSize({ width: 390, height: 844 });
+  await page.goto(`/workflow-experience.e2e.html?initial=/m/tasks/${taskId}`);
   await expect(page.locator('.oxa-workflow-mobile-page')).toBeVisible();
   await expect(page.getByText('¥28,600')).toBeVisible();
   await expect(page.getByText('财务负责人').first()).toBeVisible();

package/template/apps/web/package.json

@@ -14,7 +14,7 @@
     "@ant-design/icons": "6.2.3",
     "@refinedev/core": "5.0.12",
     "antd": "6.4.3",
-    "openxiangda": "2.0.0-alpha.31",
+    "openxiangda": "2.0.0-alpha.33",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "react-router-dom": "7.8.2"

package/template/apps/web/src/main.tsx

@@ -1,7 +1,7 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
 import {
-  defineAdminContributions,
+  defineApplicationContributions,
   defineWorkflowLaunchContributions,
   OpenXiangdaApplication,
 } from 'openxiangda/react';
@@ -17,7 +17,7 @@ import {
 } from '../../../packages/contracts/src/generated.js';
 import 'openxiangda/react/styles.css';
 
-const adminContributions = defineAdminContributions(appRoutes, {
+const applicationContributions = defineApplicationContributions(appRoutes, {
   pages: {},
 });
 const workflowContributions = defineWorkflowLaunchContributions(
@@ -32,7 +32,7 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
       appName={appName}
       adminNavigation={adminNavigation}
       adminPages={adminPages}
-      contributions={adminContributions}
+      contributions={applicationContributions}
       perspectives={appPerspectives}
       resourceDefinitions={resourceDefinitions}
       workflows={workflowContributions}

package/template/apps/web/test/contracts.test.ts

@@ -28,8 +28,8 @@ test('clean template contains only application declarations and one React entry'
   );
   assert.match(config, /data:\s*\{\s*resources:/);
   assert.match(source, /OpenXiangdaApplication/);
-  assert.match(source, /defineAdminContributions\(appRoutes/);
-  assert.match(source, /contributions=\{adminContributions\}/);
+  assert.match(source, /defineApplicationContributions\(appRoutes/);
+  assert.match(source, /contributions=\{applicationContributions\}/);
   assert.match(source, /from 'openxiangda\/react'/);
   assert.match(source, /openxiangda\/react\/styles\.css/);
   const legacyMarkers = [

package/template/package.json

@@ -22,7 +22,7 @@
     "build": "pnpm --recursive build"
   },
   "devDependencies": {
-    "openxiangda": "2.0.0-alpha.31",
+    "openxiangda": "2.0.0-alpha.33",
     "typescript": "5.9.3"
   }
 }