@pactor-app/skills 1.34.0 → 1.40.0

package/pactor-prd/references/page-templates.md

@@ -1,12 +1,12 @@
 # 页面 YAML 模板
 
-常用页面模板。占位符：`{{kebab-id}}` 页面 id、`{{页面标题}}`、`{{模块名}}`、`{{resource}}` 数据接口名（单段，见 mock-data-routes.md）、`{{实体名}}` 业务实体中文名。DSL 语法细节以 `pactor-dsl` skill 与 packages/ui 当前导出为准。
+常用页面模板。占位符：`{{kebab-id}}` 页面 id、`{{页面标题}}`、`{{模块名}}`、`{{resource}}` 数据接口名（单段，见 data-api.md）、`{{实体名}}` 业务实体中文名。DSL 语法细节以 `pactor-dsl` skill 与 packages/ui 当前导出为准。
 
 **数据列表页（搜索 + 表格 + 新建/编辑）默认套用「数据列表标准模型」**；仅当新建/编辑是独立路由表单页时才用轻量变体。
 
 ## 数据列表标准模型（搜索 Form + 表格 + 抽屉新建/编辑）
 
-从成熟实现提取的完整闭环：搜索过滤、新建/编辑共用抽屉表单（分区 + 条件显隐 + 预填）、操作列 link 按钮。**完整可拷贝的骨架文件：`template/src/server/yaml/models/data-list.yaml`**（已注册进模板 sitemap 的可运行示例，菜单「页面骨架 / 数据列表」直接预览；复制后替换页面信息、字段、接口名与文案即可，配套 mock 为 `template/src/pactor/mocks/data-list-mock.ts`）。结构照抄，字段按线框图替换：
+从成熟实现提取的完整闭环：搜索过滤、新建/编辑共用抽屉表单（分区 + 条件显隐 + 预填）、操作列 link 按钮。**完整可拷贝的骨架文件：`template/src/server/yaml/models/data-list.yaml`**（已注册进模板 sitemap 的可运行示例，菜单「页面骨架 / 数据列表」直接预览；复制后替换页面信息、字段、接口名与文案即可）。结构照抄，字段按线框图替换：
 
 ```yaml
 dsl: "1.0"
@@ -27,7 +27,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/{{resource}}
+      url: /api/d/{{resource}}
       params:
         keyword: ${state.keyword}
         status: ${state.status}
@@ -36,7 +36,7 @@ dataSources:
     autoLoad: false
     request:
       method: GET
-      url: /api/data/{{resource}}/${state.editingId}
+      url: /api/d/{{resource}}/${state.editingId}
 body:
   type: Page
   children:
@@ -99,7 +99,7 @@ body:
                           - action: request
                             params:
                               method: POST
-                              url: /api/data/ops/{{resource}}-save
+                              url: /api/d/ops/{{resource}}-save
                               body:
                                 id: ${state.editingId}
                                 name: ${event.name}
@@ -332,11 +332,58 @@ body:
 - **新建/编辑共用同一抽屉**：YAML 锚点 `&entityDrawer` 在「新建」按钮的 `overlay.open` 中定义（必须先出现），表格行内 `*entityDrawer` 引用；`title` 用 `${state.editingId == '' ? ... }` 三元切换；唯一区别是编辑以 `initialValues: ${data.editing}` 预填
 - **抽屉宽度 720**（`overlay.open type: drawer` 的 `width` 生效）；抽屉内分区**不用 Card**：`Text(strong) 标题 → Separator → 字段组`，多个分区重复此结构
 - **搜索栏按钮对齐**：查询/重置放进 `Field`，其 `label` 用不间断空格 U+00A0（直接敲 `" "` 普通空格可能被压缩），与左侧控件基线对齐
-- **Form 不能嵌套**（渲染原生 `<form>`，submit 冒泡）：抽屉内只用一个 Form；主从多值（如字典项）的子项编辑在**同一 Form** 内做「子 Table + 行下展开表单」，`onSubmit` 用 `if` 动作按 state 分流提交目标（子项保存走独立 ops 接口 + `reload editing`）；表达式不支持数组方法/箭头函数，子项草稿必须走 mock 接口不能前端拼
+- **Form 不能嵌套**（渲染原生 `<form>`，submit 冒泡）：抽屉内只用一个 Form；主从多值（如字典项）的子项编辑在**同一 Form** 内做「子 Table + 行下展开表单」，`onSubmit` 用 `if` 动作按 state 分流提交目标（子项保存走独立 ops 接口 + `reload editing`）；表达式不支持数组方法/箭头函数，子项草稿必须走服务端接口不能前端拼
 - **编辑预填链路**：`setState(editingId + 显隐镜像)` → `reload editing` → `overlay.open`；镜像值取自行数据（`${row.type}`），不要等 editing 接口
 - **overlay.open 阻塞到关闭**，关闭后 `reload list`；新建按钮同理（先重置 state 再 reload editing 清空）
 - **条件显隐**：`onValuesChange` 把字段值镜像到 state（`"${event.x != null ? event.x : state.x}"` 保持其他字段变化时原值），再用 `when` 控制显隐；编辑时关键字段 `disabled: ${state.editingId != ''}`
-- 空 `editingId` 时 mock 的 detail 接口须返回空对象而非 404
+- 空 `editingId` 时后端 detail 接口须返回空对象而非 404（转发层本身对 404 也回退空对象，但真实后端仍建议遵守该约定）
+
+## 登录页（Login 业务组件）
+
+登录页一律用 DSL `type: Login` 业务组件，禁止手写 Card+Form+自定义 CSS。**样板即模板工程的 `template/src/server/yaml/common/login.yaml`**（可直接运行预览），核心结构：
+
+```yaml
+body:
+  type: Login
+  props:
+    layout: split            # split(默认) / centered / brand-card / overlap / backdrop
+    authVariant: card        # 认证区容器：plain 裸表单 / card 常规卡片 / float 大悬浮卡片
+    brand:                   # 品牌区（文案取自 PRD；illustration 缺省内置插画，传 "" 隐藏）
+      name: {{产品名}}
+      title: {{品牌主标题}}
+      description: {{品牌说明}}
+    title: 登录
+    subtitle: {{副标题}}
+    submitText: 登 录
+    # registerLink / forgotLink / footer 按需添加（href 跳转或 onRegisterClick/onForgotClick 事件）
+  events:
+    onSubmit:                # values 经 ${event.username} / ${event.password} 读取
+      - id: loginResult
+        action: request
+        params:
+          method: POST
+          url: {{登录接口地址}}
+          body: { username: ${event.username}, password: ${event.password} }
+      - action: if
+        params:
+          condition: ${actions.loginResult == null || actions.loginResult.token == null}
+          then:
+            - action: message
+              params: { messageType: error, text: 用户名或密码错误 }
+      - action: if
+        params:
+          condition: ${actions.loginResult != null && actions.loginResult.token != null}
+          then:
+            - action: app.reload
+              params: { to: / }
+```
+
+要点：
+
+- **布局是产品决策**：原型未明确布局时必须向用户提问（5 种 `layout` + `brandSide`/`brandRatio`/`authVariant` 等修饰），用户不答默认 `split` + `card`；原型可判定则不提问
+- 页面布局（sitemap `layouts`）用纯 PageOutlet 外壳（模板为 `login` 布局），组件自带整页渐变、背景装饰与品牌面板，不要再套自定义背景容器
+- 可配置项权威定义见 `openspec/specs/ui-login-component` 与组件源码（`packages/ui/src/components/business/Login/`）；未配置的可选元素不渲染
+- 校验失败由组件内部 Form rules 就地提示；登录失败/成功分支在 DSL 动作链用 `if` + `message` 实现
 
 ## 列表页（轻量变体：新建/编辑跳独立表单页）
 
@@ -357,7 +404,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/{{resource}}
+      url: /api/d/{{resource}}
       params:
         keyword: ${state.keyword}
         status: ${state.status}
@@ -460,7 +507,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/{{resource}}/${route.params.code}   # 路径参数经 route 注入
+      url: /api/d/{{resource}}/${route.params.code}   # 路径参数经 route 注入
 body:
   type: Page
   children:
@@ -504,7 +551,7 @@ dataSources:
     autoLoad: true
     request:
       method: GET
-      url: /api/data/{{resource}}/${route.params.code}
+      url: /api/d/{{resource}}/${route.params.code}
 body:
   type: Page
   children:
@@ -533,9 +580,9 @@ body:
         onSubmit:
           - action: setState
             params: { submitting: true }
-          - action: http.post            # mock 阶段可指向 /api/data/{{resource}}
+          - action: http.post            # 指向 /api/d/{{resource}}（无后端时转发层返回 { ok: true }）
             params:
-              url: /api/data/{{resource}}
+              url: /api/d/{{resource}}
               body: ${event}
           - action: message
             params: { messageType: success, text: 保存成功 }

package/pactor-prd/references/project-structure.md

@@ -10,7 +10,7 @@
 │   │   ├── sitemap/route.ts           ✅ 返回 sitemap 入口数据（由 src/server/sitemap.ts 组装）
 │   │   ├── public/pages/[id]/route.ts ➕ 懒加载页面端点，返回单页 envelope（id/resourceType/version/dslVersion/schema/updatedAt）
 │   │   ├── auth/ · users/             ✅ 模板自带（演示账号，按需保留）
-│   │   └── data/[...path]/route.ts    ➕ mock 数据统一入口（见 mock-data-routes.md）
+│   │   └── d/[...parts]/route.ts      ➕ 数据统一入口（纯转发 → $NEXT_PUBLIC_API_BASE_URL；无后端返回空数据，见 data-api.md）
 │   ├── globals.css             ✅ 全局样式（皮肤导入处）
 │   ├── layout.tsx              ✅ 根布局（自定义页面 CSS 在这里挂载）
 │   └── theme.css               ✅ 主题令牌（样式移植的主战场）

package/pactor-prd/template/README.md

@@ -1,6 +1,6 @@
 # pactor-prd 模板工程
 
-可运行的参考实现：Next.js + pactor，页面全部 YAML DSL 描述（`src/server/yaml/`），数据一律 http 数据源 + mock 路由（`app/api/data/[...path]`）。
+可运行的参考实现：Next.js + pactor，页面全部 YAML DSL 描述（`src/server/yaml/`），数据一律 http 数据源，经纯转发层（`app/api/d/[...parts]`）转发到 `NEXT_PUBLIC_API_BASE_URL`；没有服务层接口时返回空数据，页面按空态渲染。
 
 ## 包含内容
 
@@ -8,7 +8,7 @@
 - **两个参考模块**：
   - `yaml/provider/`（供应商：卡片式列表 / 详情 / 新增 / 编辑）
   - `yaml/route/`（路由：卡片式列表 / 单页纵向详情 / 单页表单新增 / 编辑）
-- **完整接线**：`src/pactor/`（SitemapApp 接线、pageEndpoint、皮肤加载、自定义组件与动作）、`src/server/`（yaml 递归加载 + 会话裁剪）、`app/api/`（sitemap / public/pages / data / auth / users）
+- **完整接线**：`src/pactor/`（SitemapApp 接线、pageEndpoint、皮肤加载、自定义组件与动作）、`src/server/`（yaml 递归加载 + 会话裁剪）、`app/api/`（sitemap / public/pages / d 转发层 / auth / users）
 - **三套皮肤**：`public/skins/`（深浅色俱全），侧栏换肤入口
 
 ## 使用方式
@@ -18,8 +18,8 @@
 1. `package.json` 的 name 改为新工程名
 2. `src/server/yaml/sitemap.yaml`：app 名称、pages、menus 按 PRD 页面清单重写（保留 layouts）
 3. 保留 `common/` 公共页面按需调整；参考模块目录可保留作样板，新模块照其结构新增
-4. mock 数据在 `src/pactor/mocks/` 与 `app/api/data/[...path]/route.ts` 路由表中按新域扩展
-5. `pnpm install && pnpm dev`（端口 9011）验证
+4. 数据接口：dataSources 的 url 直接写最终接口路径（`/api/d/...`，路径即契约）；接真实后端时改 `next.config.js` 的 `API_BASE_URLS` 即可，页面 yaml 不动
+5. `pnpm install && pnpm dev`（端口 9011）验证（无后端时数据区为空态）
 
 ## 演示账号
 

package/pactor-prd/template/app/api/d/[...parts]/route.ts

@@ -0,0 +1,80 @@
+import { cookies } from "next/headers";
+
+import { serverBaseUrl } from "@/pactor/config";
+import { findUserBySession, SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+
+/**
+ * 页面数据接口统一入口（纯转发）：页面 DSL 的 http 数据源（如
+ * /api/d/providers）即服务端接口路径，本路由按相同路径、方法、查询与
+ * 请求体原样转发到 $serverBaseUrl/api/d/<parts>（src/pactor/config.ts），
+ * 并携带会话 cookie；匿名一律 401，不转发。
+ *
+ * 没有服务层接口时返回空数据（不报错）：上游不可达（连接失败）、接口
+ * 不存在（404）或返回非 JSON（如命中前端兜底的 HTML）时，GET 返回 {}、
+ * POST 返回 { ok: true }，页面按空态渲染；接真实后端只需把
+ * next.config.js 的 API_BASE_URLS 换成真实地址，页面 yaml 与本路由零改动。
+ */
+
+/** 无服务层接口时的空数据（GET → 空对象，POST → 成功占位） */
+function emptyData(request: Request): Response {
+  const isGet = request.method === "GET" || request.method === "HEAD";
+  return Response.json(isGet ? {} : { ok: true }, {
+    headers: { "cache-control": "no-store", ...corsHeaders(request) },
+  });
+}
+
+/** 原样转发：同路径、同方法、同查询、同请求体，携带会话 cookie */
+async function forward(request: Request, parts: string[]): Promise<Response> {
+  const url = new URL(request.url);
+  const target = `${serverBaseUrl}/api/d/${parts.join("/")}${url.search}`;
+  const headers = new Headers();
+  const cookie = request.headers.get("cookie");
+  if (cookie) headers.set("cookie", cookie);
+  const contentType = request.headers.get("content-type");
+  if (contentType) headers.set("content-type", contentType);
+  const init: RequestInit = { method: request.method, headers };
+  if (request.method !== "GET" && request.method !== "HEAD") {
+    init.body = await request.text();
+  }
+  let upstream: globalThis.Response;
+  try {
+    upstream = await fetch(target, init);
+  } catch {
+    return emptyData(request); // 上游不可达 → 空数据
+  }
+  const upstreamType = upstream.headers.get("content-type") ?? "";
+  if (upstream.status === 404 || !upstreamType.includes("json")) {
+    return emptyData(request); // 接口不存在 / 命中前端兜底 HTML → 空数据
+  }
+  const body = await upstream.arrayBuffer();
+  const resHeaders: Record<string, string> = {
+    "cache-control": "no-store",
+    "content-type": upstreamType,
+    ...corsHeaders(request),
+  };
+  return new Response(body, { status: upstream.status, headers: resHeaders });
+}
+
+async function handle(
+  request: Request,
+  context: RouteContext<"/api/d/[...parts]">,
+) {
+  const store = await cookies();
+  const user = findUserBySession(store.get(SESSION_COOKIE)?.value);
+  if (!user) {
+    return Response.json(
+      { error: "未登录" },
+      { status: 401, headers: corsHeaders(request) },
+    );
+  }
+
+  const { parts } = await context.params;
+  return forward(request, parts);
+}
+
+export const GET = handle;
+export const POST = handle;
+
+/** 预检（跨源带凭据 / 自定义头时） */
+export const OPTIONS = corsPreflight;

package/pactor-prd/template/app/layout.tsx

@@ -3,12 +3,10 @@ import { Geist, Geist_Mono } from "next/font/google";
 import { PactorApp } from "@/pactor/App";
 // 顺序约定：globals（本项目 tailwind 工具类 + 皮肤无关的外壳规则）→
 // ui 预建样式（同层冲突时 ui 胜出，保证其内部 base/响应式变体排序生效，
-// 如 Sidebar 的 hidden md:block）→ login.css（登录页视觉，须在 ui 之后，
-// 经 data-slot 钩子压过组件默认样式）。主题令牌由 public/skins/<skin>.css
+// 如 Sidebar 的 hidden md:block）。主题令牌由 public/skins/<skin>.css
 // 经下方内联脚本在首屏注入（link 后加载者胜出）。
 import "./globals.css";
 import "@pactor-app/ui/styles.css";
-import "./login.css";
 
 export const metadata: Metadata = {
   title: "Pactor Console",

package/pactor-prd/template/next.config.js

@@ -9,8 +9,8 @@
  * - 构建环境可设 NEXT_PUBLIC_API_BASE_URL 显式覆盖（域名不符合约定时）。
  */
 const API_BASE_URLS = {
-  /** 本地开发：dev 端口 9011 */
-  development: 'http://localhost:9011',
+  /** 本地开发：无服务层接口（转发命中前端兜底 → 返回空数据）；接本地后端时改为其地址 */
+  development: 'http://localhost:9011/backend',
   /** 测试环境：替换为实际测试环境 API 域名 */
   test: 'https://api-test.example.com',
   /** 生产环境：替换为实际生产 API 域名 */

package/pactor-prd/template/pnpm-lock.yaml

@@ -9,14 +9,14 @@ importers:
   .:
     dependencies:
       '@pactor-app/core':
-        specifier: ^1.33.0
-        version: 1.33.0
+        specifier: ^1.34.0
+        version: 1.34.0
       '@pactor-app/runtime':
-        specifier: ^1.33.0
-        version: 1.33.0(react@19.2.8)
+        specifier: ^1.34.0
+        version: 1.34.0(react@19.2.8)
       '@pactor-app/ui':
-        specifier: ^1.33.0
-        version: 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+        specifier: ^1.34.0
+        version: 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
       lucide-react:
         specifier: 1.45.0
         version: 1.45.0(react@19.2.8)
@@ -24,8 +24,8 @@ importers:
         specifier: 16.3.5
         version: 16.3.5(@babel/core@7.29.7)(@types/node@20.19.43)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
       pactor-app:
-        specifier: ^1.33.0
-        version: 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1))
+        specifier: ^1.34.0
+        version: 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1))
       react:
         specifier: 19.2.8
         version: 19.2.8
@@ -501,73 +501,73 @@ packages:
   '@oxc-project/types@0.151.0':
     resolution: {integrity: sha512-J1yXrIlNDZVzE3ada310xeAw7nH8yCAyLPuUIsjKatFPmfn5bS1oW+cM+QsGOtVWd5nhSpbwZWx/rue+r5Z+PA==}
 
-  '@pactor-app/app@1.33.0':
-    resolution: {integrity: sha512-/T3AnTgV3J9gvtwP48uSqp951GJFVt09758RyU3BQMnw3ZJXnLaqfUNMiZ6UlXkd8x32Cfpq3SqbJQRVB1fYlg==}
+  '@pactor-app/app@1.34.0':
+    resolution: {integrity: sha512-R2AqfNx1HnwF1pHPGHsGJpaHUlbCPfqUflsFaw7dkqDjTc5TuyWzl7MRHaZD1oFbIPaX+qy0fNDp9oob8E029Q==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
       react-dom: '>=18'
       react-router-dom: '>=6'
 
-  '@pactor-app/chat@1.33.0':
-    resolution: {integrity: sha512-tj3pOA8JXXDzC0jVHr1MQduAuYExP76M0AAsba55mqQ7N64fb2zJDUzMPxYiuv8z9bMr8acKpuOGi/a2tO5hEQ==}
+  '@pactor-app/chat@1.34.0':
+    resolution: {integrity: sha512-0I7enCfIbU7C0wuOQ/rUDmFKHYcVnbOjoy7Y22nn0pz8DAmqesFU5GFZc2cCf8Mt2ZKgSDB1J5TQI/bN2Qsafw==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
 
-  '@pactor-app/cli@1.33.0':
-    resolution: {integrity: sha512-x8+DLqH93Vd0Lkd2zc4stuuc+z0kp++sEnaV49LIktccKBTXNIe6q1BaF8vIX14HrPtSpTtuiMnnlwNR2Nsx/A==}
+  '@pactor-app/cli@1.34.0':
+    resolution: {integrity: sha512-IZC8jlGbozZ2IKEkwo7JzKfIW0OEVkoklSZptwKaG3SuHLKw3Iw7eFNeLwvBvswciPFoDajYQS+36/YoqC7o8Q==}
     engines: {node: '>=18'}
     hasBin: true
 
-  '@pactor-app/core@1.33.0':
-    resolution: {integrity: sha512-XTdm/f7Xom1ifPKwhpvy8WR5cVyLstAtrNAOWcJhs4AdOwYkmuk1MeznRp66Yl9bTJyzhJCEVhsZ7telb0HS6Q==}
+  '@pactor-app/core@1.34.0':
+    resolution: {integrity: sha512-ldHZIghOq3f9MIUc6764U+RdmhXp2HKUMpnjz90OfZ4I1YOgj8F3g2jZjw699kARSmLUgLj0PVonqjIUsm6k9A==}
     engines: {node: '>=18'}
 
-  '@pactor-app/expression@1.33.0':
-    resolution: {integrity: sha512-0Z3JUf3NLpEfHUhvzUunmEEZ3B+hEHTz+ATF4RpDVbBVnjmQBdwNcXw1/ybt1I9sJ3eDPOQQtejonsrCX0VzQA==}
+  '@pactor-app/expression@1.34.0':
+    resolution: {integrity: sha512-Na7rYU3PZGvQOe83OMeFcneWkLP6IkhfheB6miGvX+1L6iTh1VyuFi1fbgtsyUScSllrPA8JJYpXGMCGX+zVCg==}
     engines: {node: '>=18'}
 
-  '@pactor-app/markdown@1.33.0':
-    resolution: {integrity: sha512-C6u8wZKD4ayRZND4k6HbTz7SDiqb+Pwxwu9xYgYVwRBDugLWVBIfZGSZNThoXcJRumcP5EEsQKeIuNkXbt541g==}
+  '@pactor-app/markdown@1.34.0':
+    resolution: {integrity: sha512-dU2Z0uvj62/0S16H3J3AQld6DFzN+wV5uVkvYcFeqHN8KiUsP7ppdov9cSGVxo/3Zhk4HbReSBpihEOKyeLzgg==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
 
-  '@pactor-app/permission@1.33.0':
-    resolution: {integrity: sha512-CYfW3pfqI6bml5woxTtvlFE/l5ZBeQZe+x1mJigy3dc9gThMVdPKSc9b541RP6Km93tKOz2LK8HOhoE4SlvaxQ==}
+  '@pactor-app/permission@1.34.0':
+    resolution: {integrity: sha512-Bf4A7BTrtArg9gEnDG25xmzvDC95ffotIhZmRSt6unDj5hu1iaFJbT+TBWqERJ2/TmpIDhx4ipeSN+SOK0jvRQ==}
     engines: {node: '>=18'}
 
-  '@pactor-app/resource@1.33.0':
-    resolution: {integrity: sha512-ezcM72IFOvHdlUCnQmLiJenVX0Ij/B51hJB87nisJbrDmj3HfPKFoDr1UcRgU5aSlR/yt9Dp/TGTIF4Em7sesQ==}
+  '@pactor-app/resource@1.34.0':
+    resolution: {integrity: sha512-VNxjZqynNrETgcj2Q9z5PlHlayZXKyXmBhH1iM6ZzzoFy2cn1uoAYURCYtxS7onMotilsSt54CtthybaZHPOyw==}
     engines: {node: '>=18'}
 
-  '@pactor-app/router@1.33.0':
-    resolution: {integrity: sha512-vhtyczWSzJTe/7rcAK4LsKIdwWEP2vT21fpyNkYzcjIUOXVe2SHmPDu7bmQdW5yB5hQz0IQPkyeLI9HI4xJrcw==}
+  '@pactor-app/router@1.34.0':
+    resolution: {integrity: sha512-+0jWfZOKIZv2DUQrtES5zuQxRqRleJpNqKqo288hBLA2SP4k/Qj/GG8Yq4yy4wv9XIbjz6cxtu+Bi0g4iBmK4g==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
       react-router-dom: '>=6'
 
-  '@pactor-app/runtime@1.33.0':
-    resolution: {integrity: sha512-JZOTgoo0jeSG5+gp1bpD1Rey4ZDCwBo2IQ6w6tp5SFI9LOOsXxdg8hy2wpX1fQAuS6iO2AtVRIIWbNesghIeTg==}
+  '@pactor-app/runtime@1.34.0':
+    resolution: {integrity: sha512-lHia4xqPvKfl4/K/aklc8abfIIW1fBDnGB5L94/p21QAkZoZwO6Bs70l3zuWuc1vYL/eyQgXrmAJERCdhiNUXg==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
 
-  '@pactor-app/schema@1.33.0':
-    resolution: {integrity: sha512-2J7uvpwUUcwFB01I+xc0w18B9LWMqyL9l1B6Kog5sU/oWsn4pFcQ/bncBKYpW3UW4FVGFz5AVeyN4Rd+uPIcWQ==}
+  '@pactor-app/schema@1.34.0':
+    resolution: {integrity: sha512-2EZCgAvct7CbefmYVJHJtL6LCBoehePUPVoY1vStKQkJxzOUSESH3FCKcss8eNC0aJfa0nueu+Hnpjrgee9rEw==}
     engines: {node: '>=18'}
 
-  '@pactor-app/ui@1.33.0':
-    resolution: {integrity: sha512-mhpWWkRfKraQaPQPN1ZuTFQdb4tf/WwWdfa3ULqFf6u+lp+8b1FrsW7cNY7lbElN46e+BgobR2fG+Yy9LurJ3w==}
+  '@pactor-app/ui@1.34.0':
+    resolution: {integrity: sha512-JDg1STA/Q37o89UmWAoZ4QgiAAisJtr9cpeFZ+WJaH+WSqBtOZr89e3urCQduebCjLr1Z+F44tHy4b1uL0/SYw==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
       react-dom: '>=18'
 
-  '@pactor-app/vite-plugin@1.33.0':
-    resolution: {integrity: sha512-9bNPV95H7h0/DVv5Vc431mLUkuRGX9nnwRdhoUGdcSPkReGJrTH2866i4t8w0ODtUpZ3rD9AexgatpNBlw8NvA==}
+  '@pactor-app/vite-plugin@1.34.0':
+    resolution: {integrity: sha512-C7lZ3VemtSyRhOqmihpoGZkJnzCJ/WBiyJ5X1mcI7PYVgyh0iqaV+L7vu9V58itKuVYLo1d6XdNSVT6bUYE+Rg==}
     engines: {node: '>=18'}
     peerDependencies:
       vite: '>=5'
@@ -2529,8 +2529,8 @@ packages:
     resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==}
     engines: {node: '>=6'}
 
-  pactor-app@1.33.0:
-    resolution: {integrity: sha512-BJxBNIG40chRob0veFRAXTKkplnIipZOP4MkKJ52Udn3wYQ9srey2sAr0/S+LtjRSL0P+/rjWeTuqyoJOeVlrQ==}
+  pactor-app@1.34.0:
+    resolution: {integrity: sha512-wSJPXxRipLUbUvu+4CZJeeU6jTB1mSihSWlHMxOg8d+qvYj1W6PCydYxu9SkGPHGC2gNWMAmHA172VYZ1gHwnQ==}
     engines: {node: '>=18'}
     peerDependencies:
       react: '>=18'
@@ -3613,16 +3613,16 @@ snapshots:
 
   '@oxc-project/types@0.151.0': {}
 
-  '@pactor-app/app@1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
+  '@pactor-app/app@1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
     dependencies:
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/expression': 1.33.0
-      '@pactor-app/permission': 1.33.0
-      '@pactor-app/resource': 1.33.0
-      '@pactor-app/router': 1.33.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
-      '@pactor-app/runtime': 1.33.0(react@19.2.8)
-      '@pactor-app/schema': 1.33.0
-      '@pactor-app/ui': 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/expression': 1.34.0
+      '@pactor-app/permission': 1.34.0
+      '@pactor-app/resource': 1.34.0
+      '@pactor-app/router': 1.34.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/runtime': 1.34.0(react@19.2.8)
+      '@pactor-app/schema': 1.34.0
+      '@pactor-app/ui': 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
       react-router-dom: 7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
@@ -3632,13 +3632,13 @@ snapshots:
       - '@types/react-dom'
       - supports-color
 
-  '@pactor-app/chat@1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
+  '@pactor-app/chat@1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
     dependencies:
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/markdown': 1.33.0(@types/react@19.3.0)(react@19.2.8)
-      '@pactor-app/permission': 1.33.0
-      '@pactor-app/runtime': 1.33.0(react@19.2.8)
-      '@pactor-app/ui': 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/markdown': 1.34.0(@types/react@19.3.0)(react@19.2.8)
+      '@pactor-app/permission': 1.34.0
+      '@pactor-app/runtime': 1.34.0(react@19.2.8)
+      '@pactor-app/ui': 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
       react: 19.2.8
     transitivePeerDependencies:
       - '@date-fns/tz'
@@ -3648,22 +3648,22 @@ snapshots:
       - react-router-dom
       - supports-color
 
-  '@pactor-app/cli@1.33.0':
+  '@pactor-app/cli@1.34.0':
     dependencies:
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/expression': 1.33.0
-      '@pactor-app/schema': 1.33.0
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/expression': 1.34.0
+      '@pactor-app/schema': 1.34.0
       yaml: 2.9.1
 
-  '@pactor-app/core@1.33.0': {}
+  '@pactor-app/core@1.34.0': {}
 
-  '@pactor-app/expression@1.33.0':
+  '@pactor-app/expression@1.34.0':
     dependencies:
-      '@pactor-app/core': 1.33.0
+      '@pactor-app/core': 1.34.0
 
-  '@pactor-app/markdown@1.33.0(@types/react@19.3.0)(react@19.2.8)':
+  '@pactor-app/markdown@1.34.0(@types/react@19.3.0)(react@19.2.8)':
     dependencies:
-      '@pactor-app/core': 1.33.0
+      '@pactor-app/core': 1.34.0
       katex: 0.18.9
       react: 19.2.8
       react-markdown: 10.1.0(@types/react@19.3.0)(react@19.2.8)
@@ -3675,41 +3675,41 @@ snapshots:
       - '@types/react'
       - supports-color
 
-  '@pactor-app/permission@1.33.0':
+  '@pactor-app/permission@1.34.0':
     dependencies:
-      '@pactor-app/core': 1.33.0
+      '@pactor-app/core': 1.34.0
 
-  '@pactor-app/resource@1.33.0':
+  '@pactor-app/resource@1.34.0':
     dependencies:
-      '@pactor-app/core': 1.33.0
+      '@pactor-app/core': 1.34.0
 
-  '@pactor-app/router@1.33.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
+  '@pactor-app/router@1.34.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
     dependencies:
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/permission': 1.33.0
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/permission': 1.34.0
       react: 19.2.8
       react-router-dom: 7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
 
-  '@pactor-app/runtime@1.33.0(react@19.2.8)':
+  '@pactor-app/runtime@1.34.0(react@19.2.8)':
     dependencies:
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/expression': 1.33.0
-      '@pactor-app/schema': 1.33.0
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/expression': 1.34.0
+      '@pactor-app/schema': 1.34.0
       react: 19.2.8
 
-  '@pactor-app/schema@1.33.0':
+  '@pactor-app/schema@1.34.0':
     dependencies:
-      '@pactor-app/core': 1.33.0
+      '@pactor-app/core': 1.34.0
       ajv: 8.20.0
 
-  '@pactor-app/ui@1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
+  '@pactor-app/ui@1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)':
     dependencies:
       '@base-ui/react': 1.8.0(@date-fns/tz@1.5.0)(@types/react@19.3.0)(date-fns@4.4.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/markdown': 1.33.0(@types/react@19.3.0)(react@19.2.8)
-      '@pactor-app/permission': 1.33.0
-      '@pactor-app/router': 1.33.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
-      '@pactor-app/runtime': 1.33.0(react@19.2.8)
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/markdown': 1.34.0(@types/react@19.3.0)(react@19.2.8)
+      '@pactor-app/permission': 1.34.0
+      '@pactor-app/router': 1.34.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/runtime': 1.34.0(react@19.2.8)
       class-variance-authority: 0.7.1
       clsx: 2.1.1
       cmdk: 1.1.1(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react@19.2.8)
@@ -3734,10 +3734,10 @@ snapshots:
       - react-router-dom
       - supports-color
 
-  '@pactor-app/vite-plugin@1.33.0(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1))':
+  '@pactor-app/vite-plugin@1.34.0(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1))':
     dependencies:
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/schema': 1.33.0
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/schema': 1.34.0
       vite: 8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1)
       yaml: 2.9.1
 
@@ -5996,21 +5996,21 @@ snapshots:
 
   p-try@2.2.0: {}
 
-  pactor-app@1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1)):
-    dependencies:
-      '@pactor-app/app': 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
-      '@pactor-app/chat': 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
-      '@pactor-app/cli': 1.33.0
-      '@pactor-app/core': 1.33.0
-      '@pactor-app/expression': 1.33.0
-      '@pactor-app/markdown': 1.33.0(@types/react@19.3.0)(react@19.2.8)
-      '@pactor-app/permission': 1.33.0
-      '@pactor-app/resource': 1.33.0
-      '@pactor-app/router': 1.33.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
-      '@pactor-app/runtime': 1.33.0(react@19.2.8)
-      '@pactor-app/schema': 1.33.0
-      '@pactor-app/ui': 1.33.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
-      '@pactor-app/vite-plugin': 1.33.0(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1))
+  pactor-app@1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1)):
+    dependencies:
+      '@pactor-app/app': 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/chat': 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/cli': 1.34.0
+      '@pactor-app/core': 1.34.0
+      '@pactor-app/expression': 1.34.0
+      '@pactor-app/markdown': 1.34.0(@types/react@19.3.0)(react@19.2.8)
+      '@pactor-app/permission': 1.34.0
+      '@pactor-app/resource': 1.34.0
+      '@pactor-app/router': 1.34.0(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/runtime': 1.34.0(react@19.2.8)
+      '@pactor-app/schema': 1.34.0
+      '@pactor-app/ui': 1.34.0(@date-fns/tz@1.5.0)(@types/react-dom@19.3.0(@types/react@19.3.0))(@types/react@19.3.0)(react-dom@19.2.8(react@19.2.8))(react-router-dom@7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8))(react@19.2.8)
+      '@pactor-app/vite-plugin': 1.34.0(vite@8.3.1(@types/node@20.19.43)(jiti@2.7.0)(yaml@2.9.1))
       react: 19.2.8
       react-dom: 19.2.8(react@19.2.8)
       react-router-dom: 7.18.4(react-dom@19.2.8(react@19.2.8))(react@19.2.8)

package/pactor-prd/template/src/pactor/App.tsx

@@ -15,8 +15,9 @@ import { pactorComponents } from "./components";
  * @pactor-app/app 内置；此处只提供：sitemap 源、宿主路由
  * （pathname / navigate）、HTTP 钩子，以及页面 DSL 依赖的运行时支撑层——
  * 自定义组件（components/）与调试台自定义动作（actions.ts）。
- * 页面数据全部走 http 数据源（/api/data/*，mock 实现见 services.ts +
- * mocks/，服务端路由 app/api/data/[...parts]/route.ts 复用同一套包装层）。
+ * 页面数据全部走 http 数据源（/api/d/*），经转发层
+ *（app/api/d/[...parts]/route.ts）原样转发到 serverBaseUrl（见 config.ts）；
+ * 没有服务层接口时转发层返回空数据，页面按空态渲染。
  *
  * 登录 / 登出是普通 HTTP 调用，由 DSL 中的内置 request 动作直接表达
  *（见 src/server/yaml/ 的登录页 / 布局 DSL），无需客户端注册服务。