@pactor-app/skills 1.24.0

package/prd-to-app/references/mock-data-routes.md

@@ -0,0 +1,66 @@
+# mock 数据路由模板
+
+页面 DSL 的 http 数据源统一入口：`app/api/data/[...path]/route.ts`。目标：原型阶段零后端依赖；接真实后端时只改这一层，页面 yaml 不动。
+
+## 命名约定
+
+- **单段路径**：`/api/data/projects`、`/api/data/project-members`——列表/选项类一律单段 kebab-case
+- **禁止** `/api/data/project/members` 这种两段写法：`[...path]` 会把第二段当详情 id 解析（`project/detail?id=members`），踩过的坑
+- 详情：`/api/data/<resource>/<code|id>`；子资源：`/api/data/<resource>/<code>/<sub>`
+- 数据源 url 与页面 id 语义对应：`project-list` 页 → `/api/data/projects`
+
+## 路由模板
+
+```ts
+// app/api/data/[...path]/route.ts
+/**
+ * 页面数据接口（mock）：页面 DSL 的 http 数据源统一入口。
+ * 接入真实后端时改写 ROUTE_TABLE 的实现（或调整 baseUrl 直连后端）。
+ */
+
+/** 单段路径 → mock handler */
+const ROUTE_TABLE: Record<string, (params: Record<string, unknown>) => unknown> = {
+  projects: (params) => filterProjects(params),   // mock 函数就近定义或放 src/server/mocks/
+  "project-members": () => PROJECT_MEMBERS,
+};
+
+/** 详情：<resource>/<id> */
+const DETAIL_TABLE: Record<string, (id: string) => unknown> = {
+  projects: (code) => PROJECTS.find((p) => p.code === code) ?? null,
+};
+
+export async function GET(
+  request: Request,
+  context: { params: Promise<{ path: string[] }> },
+) {
+  const { path } = await context.params;
+  const params = Object.fromEntries(new URL(request.url).searchParams.entries());
+
+  if (path.length === 1) {
+    const handler = ROUTE_TABLE[path[0]!];
+    if (!handler) return Response.json({ error: `未知数据接口: /api/data/${path.join("/")}` }, { status: 404 });
+    return Response.json(handler(params) ?? null);
+  }
+  if (path.length === 2) {
+    const handler = DETAIL_TABLE[path[0]!];
+    if (!handler) return Response.json({ error: "未知详情接口" }, { status: 404 });
+    return Response.json(handler(path[1]!) ?? null);
+  }
+  return Response.json({ error: "不支持的接口路径" }, { status: 404 });
+}
+```
+
+注意：`context.params` 的具体类型以目标项目的 Next 版本为准（Next 15+ 为 Promise）。
+
+## mock 数据要求
+
+- 字段名与线框图「区域说明/字段说明」逐一对齐，不臆造字段
+- 每类数据至少覆盖：正常多条、触发告警/特殊态的条目（如「待填密钥」）、以及空态可被演示（如筛选到无结果）
+- 筛选参数在 handler 内真实过滤（列表页筛选闭环依赖它），不是返回全量
+- 选项类接口（如下拉的操作人列表）单独注册单段路径，页面 `options: ${data.xxx}` 绑定
+
+## 替换为真实接口
+
+1. 直接把 ROUTE_TABLE handler 改为 `fetch` 真实后端（服务端转发，带鉴权头）
+2. 或调整 pactor 数据源 baseUrl 直连后端，`/api/data/*` 层整体退役
+页面 yaml 的 dataSources 声明两种方案下都无需改动——这就是必须 `type: http` 的原因。

package/prd-to-app/references/page-templates.md

@@ -0,0 +1,274 @@
+# 页面 YAML 模板
+
+三类常用页面模板。占位符：`{{kebab-id}}` 页面 id、`{{页面标题}}`、`{{模块名}}`、`{{resource}}` 数据接口名（单段，见 mock-data-routes.md）。DSL 语法细节以 pactor skill 与 packages/ui 当前导出为准。
+
+## 列表页（筛选 + 表格/卡片 + 操作列）
+
+```yaml
+dsl: "1.0"
+page:
+  id: {{kebab-id}}
+  title: {{页面标题}}
+  name: {{camelName}}
+  description: {{模块名}} / {{页面标题}}
+state:
+  keyword: ""
+  status: ""
+  statusChip: all
+dataSources:
+  list:
+    type: http
+    autoLoad: true
+    request:
+      method: GET
+      url: /api/data/{{resource}}
+      params:
+        keyword: ${state.keyword}
+        status: ${state.status}
+body:
+  type: Page
+  children:
+    - type: Breadcrumb
+      props:
+        items:
+          - label: {{模块名}}
+          - label: {{页面标题}}
+    - type: Flex
+      props: { align: baseline, gap: middle }
+      children:
+        - type: Typography
+          props: { variant: h3, text: {{页面标题}} }
+        - type: Typography
+          props: { variant: muted, text: 页面副标题（取自线框图说明文字） }
+    # 搜索栏：Form(layout: inline) 包裹，字段 name 绑定；查询 submit: true，重置 form.setValues
+    - type: Card
+      children:
+        - type: Form
+          props: { name: filter, layout: inline }
+          children:
+            - type: Input
+              props: { name: keyword, placeholder: 搜索关键词 }
+            - type: Select
+              props:
+                name: status
+                placeholder: 状态
+                options: ${data.list.filters.status}   # 选项也可由接口下发
+                allowClear: true
+            - type: Button
+              props: { text: 查询, variant: primary, submit: true }
+            - type: Button
+              props: { text: 重置 }
+              events:
+                onClick:
+                  - action: form.setValues
+                    params: { form: filter, values: { keyword: "", status: "" } }
+                  - action: setState
+                    params: { keyword: "", status: "" }
+                  - action: reload
+                    params: { dataSource: list }
+          events:
+            onSubmit:
+              - action: setState
+                params:
+                  keyword: ${event.keyword}
+                  status: ${event.status}
+              - action: reload
+                params: { dataSource: list }
+    # 即点即生效的快筛行（ChipFilter）不是表单，可独立于 Form 之外绑 state
+    - type: Flex
+      props: { align: center, gap: small }
+      children:
+        - type: Text
+          props: { text: 状态, strong: true }
+        - type: ChipFilter
+          props:
+            mode: single
+            value: ${state.statusChip}
+            items: ${data.list.filters.status}
+          events:
+            onChange:
+              - action: setState
+                params: { statusChip: ${event} }
+              - action: reload
+                params: { dataSource: list }
+    # 列表主体：表格（或卡片网格，见 component-mapping.md）
+    - type: Table
+      props:
+        columns: ${data.list.columns}
+        dataSource: ${data.list.items}
+      events:
+        onRowClick:
+          - action: router.push
+            params: { path: "/{{resource}}/${event.code}" }
+```
+
+要点：
+
+- 搜索栏（关键词 + 下拉筛选 + 查询/重置）走 `Form layout: inline`：字段 `name` 绑定，查询按钮 `submit: true`，`onSubmit` 中 `setState` + `reload`；重置 = `form.setValues` 清空 + `setState` 复位 + `reload`
+- 即点即生效的筛选（ChipFilter 快筛行）没有提交语义，不是表单，仍可独立绑 state、onChange 即 reload
+- 表格操作列按钮样式统一 `Button variant: link`（编辑/删除/详情等），不混用 text/default 或 TextLink
+- 「新建」→ `router.push` 到表单页（或弹窗表单）；操作列「编辑」与「新建」指向**同一个表单**（同一路由页或同一弹窗），唯一区别是编辑以行数据预填：路由页用 `initialValues: ${data.detail}`，弹窗/内嵌面板用 `form.setValues` 写入行数据
+- 空态、加载态不手写，组件内置；但线框图有空态文案时用 props 覆盖
+
+## 详情页（面包屑 + 描述列表 + Tab/分区）
+
+```yaml
+dsl: "1.0"
+page:
+  id: {{kebab-id}}
+  title: {{页面标题}}
+  name: {{camelName}}
+dataSources:
+  detail:
+    type: http
+    autoLoad: true
+    request:
+      method: GET
+      url: /api/data/{{resource}}/${route.params.code}   # 路径参数经 route 注入
+body:
+  type: Page
+  children:
+    - type: Breadcrumb
+      props:
+        items:
+          - label: {{模块名}}
+          - { label: {{列表页标题}}, href: /{{resource}} }
+          - label: ${data.detail.name}
+    - type: Descriptions
+      props:
+        title: 基本信息
+        items: ${data.detail.fields}
+    # 线框图为 Tab 时用 Tabs；为纵向分区时用多个 Card + Descriptions 顺序排布
+    - type: Tabs
+      props:
+        items:
+          - { key: overview, label: 概览 }
+          - { key: changes, label: 变更记录 }
+      children: []   # 各 Tab 内容按线框图分区填充
+```
+
+要点：
+
+- 路径参数（`/projects/:code`）经 `${route.params.code}` 拼进 url
+- 头部操作（启用/停用、编辑、删除）按线框图摆放在标题行右侧，点击后确认弹窗 + 操作成功 message + reload
+
+## 表单页（新增/编辑：校验 + 提交闭环）
+
+```yaml
+dsl: "1.0"
+page:
+  id: {{kebab-id}}
+  title: {{页面标题}}
+  name: {{camelName}}
+state:
+  submitting: false
+dataSources:
+  detail:   # 编辑页预填；新增页删除本数据源
+    type: http
+    autoLoad: true
+    request:
+      method: GET
+      url: /api/data/{{resource}}/${route.params.code}
+body:
+  type: Page
+  children:
+    - type: Breadcrumb
+      props:
+        items:
+          - label: {{模块名}}
+          - { label: {{列表页标题}}, href: /{{resource}} }
+          - label: {{页面标题}}
+    - type: Form
+      props:
+        initialValues: ${data.detail}   # 新增页省略
+      children:
+        # 字段按线框图分区；required / 校验规则照抄线框图字段说明
+        - type: Input
+          props: { name: name, label: 名称, required: true }
+      events:
+        onSubmit:
+          - action: setState
+            params: { submitting: true }
+          - action: http.post            # mock 阶段可指向 /api/data/{{resource}}
+            params:
+              url: /api/data/{{resource}}
+              body: ${event}
+          - action: message
+            params: { messageType: success, text: 保存成功 }
+          - action: router.push
+            params: { path: /{{resource}} }
+```
+
+要点：
+
+- 提交中禁用按钮（`submitting` state），失败分支 `messageType: error` 提示
+- 新增/编辑**共用同一表单**（同一路由页或同一弹窗），按 `${route.params.code}` 是否存在区分（`if` 动作分支）；编辑仅比新建多一步预填：`initialValues: ${data.detail}`
+- 取消按钮 → `router.back` 或返回列表页
+
+## 内嵌表单面板（列表/树旁的编辑表单、弹窗/抽屉表单）
+
+凡「字段 + 校验 + 提交」结构（如树右侧的配置面板、行编辑弹窗）一律 `Form` 包裹，不要散放 `Input` + `setState` 攒草稿：
+
+```yaml
+- type: Card
+  props: { title: {{面板标题}} }
+  children:
+    - type: Form
+      props:
+        name: edit            # 多表单共存时命名，form.setValues 按名寻址
+      children:
+        - type: Input
+          props:
+            name: name
+            label: 名称
+            rules:
+              - { required: true, message: 请输入名称 }
+        - type: RadioGroup
+          props:
+            name: type
+            label: 类型
+            options:
+              - { label: 目录, value: DIRECTORY }
+              - { label: 页面, value: PAGE }
+        # 条件字段显隐依赖其他字段的实时值：经 onValuesChange 镜像到 state 后用 when
+        - type: Select
+          when: ${state.fType == 'PAGE'}
+          props:
+            name: pageEntry
+            label: 页面入口
+            options: ${data.pages}
+            rules:
+              - { required: true, message: 页面入口必选 }
+        - type: Flex
+          props: { justify: end, gap: middle }
+          children:
+            - type: Button
+              props: { text: 取消 }
+              events:
+                onClick:
+                  - action: form.setValues    # 重置为初始/空值
+                    params: { form: edit, values: { name: "", type: DIRECTORY } }
+            - type: Button
+              props: { text: 保存, variant: primary, submit: true }
+      events:
+        onValuesChange:         # event 为本次变化的字段集；镜像到 state 供 when 条件显隐（其他字段变化时保持原值）
+          - action: setState
+            params: { fType: "${event.type != null ? event.type : state.fType}" }
+        onSubmit:               # 仅在校验通过后触发，values 经 ${event.<field>} 读取
+          - action: message
+            params: { messageType: success, text: 已保存 }
+          - action: reload
+            params: { dataSource: list }
+```
+
+要点：
+
+- 点击列表行 / 树节点回填表单：`onClick` 里用 `form.setValues` 动作（`params: { form: <表单名>, values: {...} }`），不要把字段 `value` 绑到 `${state.x}` 再用 setState 同步
+- 校验交给字段 `rules`，提交按钮 `submit: true`；校验失败由 Form 就地展示错误，不再写 `if` + `message` 手工校验链
+- 提交参数是整表 values：`${event}` 或 `${event.<field>}`；提交成功后 values 也可经 `${form.<field>}` 读取
+
+## 通用约定
+
+- 页面 id kebab-case，与 sitemap.yaml 注册一致；文件按模块分目录存放 `src/server/yaml/<模块>/{{kebab-id}}.yaml`（见 project-structure.md）
+- 表达式：`${state.x}` / `${data.x}` / `${route.params.x}` / `${event}`；支持 `.length`、比较、`&&`/`||`、三元
+- 任何「点击后请求并刷新」的交互都是同一闭环：`setState`（可选）→ http/service 调用 → `reload dataSource` / `router.push`

package/prd-to-app/references/project-structure.md

@@ -0,0 +1,89 @@
+# 目标项目目录结构约定
+
+基于 `pnpm create pactor-app`（next-app 模板）扩展。加 ✅ 的是模板自带，➕ 的是本流程新增/改造。
+
+```
+<project>/
+├── app/
+│   ├── [[...slug]]/            ✅ pactor 动态路由承载页（不改）
+│   ├── api/
+│   │   ├── 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）
+│   ├── globals.css             ✅ 全局样式（皮肤导入处）
+│   ├── layout.tsx              ✅ 根布局（自定义页面 CSS 在这里挂载）
+│   └── theme.css               ✅ 主题令牌（样式移植的主战场）
+├── src/
+│   ├── pactor/
+│   │   ├── config.ts           ✅ pactor 运行时配置（sitemapSources / baseUrl / pageEndpoint）
+│   │   └── App.tsx             ✅ 客户端入口（SitemapApp 接线、注册自定义组件/动作处）
+│   └── server/
+│       ├── sitemap.ts          ➕ 递归收集 yaml/ 模块子目录建 id→路径索引、按会话裁剪（只加过滤，不拼接业务字段）
+│       └── yaml/
+│           ├── sitemap.yaml    ✅ 布局 DSL：app / auth / layouts / pages / menus
+│           └── <模块>/         ➕ 页面按 PRD 模块分目录存放（如 user/ order/ project/）
+│               └── <id>.yaml      每页一个文件，页面 id = 文件名（不含 .yaml）
+└── package.json
+```
+
+## sitemap.yaml 骨架
+
+```yaml
+# 页面 DSL 按模块分目录存放：yaml/<模块>/<id>.yaml，页面 id = 文件名；
+# src/server/sitemap.ts 递归收集各模块目录建 id→路径索引；
+# lazy: true 不随 sitemap 内联下发，客户端经 /api/public/pages/{id} 懒加载
+id: site
+resourceType: sitemap
+version: 1
+dslVersion: "1.0"
+app: { name: <产品名，取自 PRD> }
+layout: admin
+auth: { loginPath: /login }
+
+pages:
+  - { id: login, path: /login, title: 登录, version: 1, public: true }
+  - { id: dashboard, path: /, title: 仪表盘, version: 1, lazy: true }
+  # 每个 PRD 页面一条：id kebab-case、path 与线框图「页面路径」一致、lazy: true
+  - { id: project-list, path: /projects, title: 项目, version: 1, lazy: true }
+  - { id: project-detail, path: /projects/:code, title: 项目详情, version: 1, lazy: true }
+
+menus:
+  # 菜单分组与 PRD 模块树一一对应；详情/编辑页 hidden: true + activeMenu 指向列表项
+  - id: assets
+    type: group
+    title: 资源管理
+    icon: database
+    order: 2
+    children:
+      - { id: projects, type: page, pageId: project-list, title: 项目 }
+      - { id: project-detail, type: page, pageId: project-detail, title: 项目详情, hidden: true, activeMenu: projects }
+
+layouts:
+  admin:
+    dsl: "1.0"
+    body: # 管理端外壳（侧边导航 + PageOutlet），模板自带，按需调整
+  login:
+    dsl: "1.0"
+    body: # 登录页布局（居中单栏），与原产品登录页结构对齐
+```
+
+## 约定
+
+- 页面按 PRD 模块树分目录：`yaml/<模块>/<id>.yaml`（如 `yaml/user/user-list.yaml`）；模块目录名用 kebab-case 英文域，按 PRD 模块树划分（如 user / order / report）
+- 页面 id kebab-case，= 文件名（不含 `.yaml`）；`pages:` 注册、`menus:` 引用、文件名三者一致
+- 模板自带的 `yaml/pages/*.page.yaml` 平铺写法仅适合页面极少的 demo；模块 ≥2 或页面 >5 时一律按模块分目录（模板目录可整体替换）
+- 列表/详情/编辑成组路径：`/projects`、`/projects/:code`、`/projects/:code/edit`、`/projects/new`
+- 详情/编辑页不进菜单（`hidden: true`），用 `activeMenu` 保持列表菜单高亮
+- 菜单图标仅一级菜单配置（目录 group 与「首页」这类独立页面项都要配），用 pactor Icon 白名单 kebab-case 名；二级及以下菜单项一律不配图标
+- 登录/注册页 `public: true` + `layout: login`；其余默认需登录
+- `src/server/sitemap.ts` 只按会话过滤（public/permission），不要在代码里拼接业务字段——数据归 yaml
+- 懒加载页面端点放 `app/api/public/pages/[id]/route.ts`；框架缺省请求 `/api/pages/{id}`，因此**必须**在 `src/pactor/config.ts` 显式配置并传给 SitemapApp，否则客户端请求错路径：
+
+```ts
+// src/pactor/config.ts
+export const pageEndpoint = (pageId: string) => `/api/public/pages/${pageId}`;
+
+// src/pactor/App.tsx
+<SitemapApp ... pageEndpoint={pageEndpoint} />
+```

package/prd-to-app/references/theme-and-style.md

@@ -0,0 +1,41 @@
+# 主题与样式移植指南
+
+目标：生成项目与原产品**看起来是同一个产品**——令牌、深浅色、自定义 CSS、换肤能力全部对齐。样式不一致是验收不通过项，不是优化项。
+
+## 1. 提取原产品设计令牌
+
+从原产品代码（globals.css / tailwind 配置 / 主题文件）提取语义令牌，逐项写入生成项目的 `app/theme.css`：
+
+- 必查令牌：`--background` `--foreground` `--card` `--primary` `--secondary` `--muted` `--accent` `--border` `--destructive` 及各自 `-foreground`，`--radius`
+- **深浅色两份**：`:root:not([data-pactor-theme='dark'])` 与 `[data-pactor-theme='dark']` 都要覆盖，漏一份验收必挂
+- 原产品用的字体、阴影、侧栏宽度等也一并记录并移植
+
+提取方法：浏览器 DevTools 读取原产品 computed 值，或直接抄其 css 变量定义；禁止凭感觉调色。
+
+## 2. 页面级自定义 CSS 完整移植
+
+原产品的页面级样式（典型：登录页渐变背景 + 磨砂卡片）必须**原样复制**并在 `app/layout.tsx` 挂载（在 `@pactor-app/ui/styles.css` 之后导入，后加载者胜出）。
+
+常见教训：页面级 CSS「文件已复制」但没在 layout.tsx 挂载，样式静默丢失。**挂载后必须浏览器打开对应页面目检**，不以文件存在为完成标准。
+
+## 3. 换肤能力对齐
+
+原产品支持多套皮肤时：
+
+- 每套皮肤一个 CSS 文件（如 `public/skins/<key>.css`），内容是同名语义令牌的覆盖（含深色变体）
+- 皮肤经 `<link rel="stylesheet" data-pactor-skin>` 在 ui styles 之后加载；首屏用 layout.tsx 内联脚本同步注入避免闪烁，运行时换肤「新 link 加载完成再移除旧 link」
+- 换肤入口（ThemeSwitcher 之类）放在与原产品一致的位置（如侧栏底部/用户菜单）
+- 皮肤数量、名称、缺省皮肤与原产品一致
+- 图表组件随肤切换是库内建能力（`useChartTheme` 监听皮肤 link 变化），无需额外处理；验收时确认图表颜色随换肤变化
+
+## 4. DSL 侧样式红线
+
+- 组件自定义一律 `className` + 语义令牌：`bg-(--muted)`、`text-(--muted-foreground)`、`border-(--border)`
+- **禁止写死色值**（`#xxx`、`rgb(...)`）——深浅色与换肤会破
+- 间距优先组件 props（`gap: small/middle/large`），避免散落的 margin 工具类
+
+## 5. 样式验收（并入 acceptance-checklist）
+
+- 与原产品同页面并排对比：背景、卡片、主色按钮、文字层级无明显色差
+- 深浅色各切一次：无白边、无死色、无对比度异常
+- 每套皮肤切一次：全站（含图表）随肤变化

package/prd-to-app/template/README.md

@@ -0,0 +1,26 @@
+# prd-to-app 模板工程
+
+可运行的参考实现：Next.js + pactor，页面全部 YAML DSL 描述（`src/server/yaml/`），数据一律 http 数据源 + mock 路由（`app/api/data/[...path]`）。
+
+## 包含内容
+
+- **公共页面**：`yaml/common/`（login 登录页、dashboard 仪表盘）
+- **两个参考模块**：
+  - `yaml/provider/`（供应商：卡片式列表 / 详情 / 新增 / 编辑）
+  - `yaml/route/`（路由：卡片式列表 / 单页纵向详情 / 单页表单新增 / 编辑）
+- **完整接线**：`src/pactor/`（SitemapApp 接线、pageEndpoint、皮肤加载、自定义组件与动作）、`src/server/`（yaml 递归加载 + 会话裁剪）、`app/api/`（sitemap / public/pages / data / auth / users）
+- **三套皮肤**：`public/skins/`（深浅色俱全），侧栏换肤入口
+
+## 使用方式
+
+生成新项目时**整体复制本目录**作为起点（而不是从空模板开始），然后：
+
+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）验证
+
+## 演示账号
+
+见 `src/server/accounts.ts`（模板自带演示账号，按需替换）。

package/prd-to-app/template/app/[[...slug]]/page.tsx

@@ -0,0 +1,7 @@
+/**
+ * 可选 catch-all：匹配全部站内路径，但渲染为空——应用本体挂在
+ * app/layout.tsx 的 PactorApp（layout 跨导航常驻，page 会被重挂载）。
+ */
+export default function CatchAllPage() {
+  return null;
+}

package/prd-to-app/template/app/api/auth/login/route.ts

@@ -0,0 +1,32 @@
+import { NextResponse } from "next/server";
+
+import { findAccount, SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+
+/** 演示登录：校验账号 → 写会话 cookie → 返回用户信息 */
+export async function POST(request: Request) {
+  const body = (await request.json().catch(() => ({}))) as {
+    username?: string;
+    password?: string;
+  };
+  const user = findAccount(body.username ?? "", body.password ?? "");
+  if (!user) {
+    return Response.json(
+      { error: "用户名或密码错误" },
+      { status: 401, headers: corsHeaders(request) },
+    );
+  }
+  const response = NextResponse.json(
+    { token: `demo-${user.id}`, user },
+    { headers: corsHeaders(request) },
+  );
+  response.cookies.set(SESSION_COOKIE, user.username, {
+    httpOnly: true,
+    sameSite: "lax",
+    path: "/",
+  });
+  return response;
+}
+
+/** 预检（跨源 POST JSON） */
+export const OPTIONS = corsPreflight;

package/prd-to-app/template/app/api/auth/logout/route.ts

@@ -0,0 +1,22 @@
+import { NextResponse } from "next/server";
+
+import { SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+
+/** 演示登出：清会话 cookie */
+export async function POST(request: Request) {
+  const response = NextResponse.json(
+    { ok: true },
+    { headers: corsHeaders(request) },
+  );
+  response.cookies.set(SESSION_COOKIE, "", {
+    httpOnly: true,
+    sameSite: "lax",
+    path: "/",
+    maxAge: 0,
+  });
+  return response;
+}
+
+/** 预检（跨源 POST JSON） */
+export const OPTIONS = corsPreflight;

package/prd-to-app/template/app/api/data/[...parts]/route.ts

@@ -0,0 +1,118 @@
+import { cookies } from "next/headers";
+
+import { findUserBySession, SESSION_COOKIE } from "@/server/accounts";
+import { corsHeaders, corsPreflight } from "@/server/cors";
+import { pactorServices } from "@/pactor/services";
+
+/**
+ * 页面数据接口（mock）：页面 DSL 的 http 数据源统一入口。
+ * URL 路径段 → 服务名映射（scripts/to-http-dsl.mjs 中的同一张表）；
+ * 接入真实后端时改写本表（或在 src/pactor/config.ts 调整 baseUrl 直连后端）。
+ *
+ * 查询参数原为 service 包装层的入参（布尔快筛在 DSL 侧是一族一个参数），
+ * 经 HTTP 序列化为字符串，此处把 'true'/'false' 还原为布尔后再复用
+ * 与客户端注册表同一套包装层（src/pactor/services.ts）。
+ * 接口侧鉴权：匿名一律 401。
+ */
+
+/** 路径段 → 服务名 */
+const ROUTE_TABLE: Record<string, string> = {
+  dashboard: "dashboard.query",
+  providers: "provider.list",
+  models: "model.list",
+  routes: "route.list",
+  clients: "client.list",
+  "client-templates": "clientTemplate.list",
+  "call-logs": "callLog.list",
+  costs: "cost.list",
+  audit: "audit.list",
+  "audit-operators": "audit.operators",
+  "ops/model-usage": "ops.modelUsage",
+  "ops/provider-usage": "ops.providerUsage",
+  "ops/client-usage": "ops.clientUsage",
+  "ops/provider-availability": "ops.availability",
+};
+
+/** 详情 / 子资源：<res>/<code|id> 或 <res>/<code>/<sub> */
+const DETAIL_TABLE: Record<string, string> = {
+  providers: "provider.detail",
+  models: "model.detail",
+  routes: "route.detail",
+  clients: "client.detail",
+  "client-templates": "clientTemplate.detail",
+  "call-logs": "callLog.detail",
+  costs: "cost.detail",
+  audit: "audit.detail",
+};
+
+const SUB_TABLE: Record<string, string> = {
+  "providers/pull-models": "provider.pullModels",
+  "client-templates/created-clients": "clientTemplate.createdClients",
+};
+
+/** 详情类服务的标识参数名（code / id） */
+const ID_PARAM: Record<string, string> = {
+  "callLog.detail": "id",
+  "cost.detail": "id",
+  "audit.detail": "id",
+};
+
+function resolveService(parts: string[]): { service: string; id?: string } | null {
+  if (parts.length === 0 || parts.length > 3) return null;
+  if (parts.length === 1 || parts.length === 2 && parts[0] === "ops") {
+    const service = ROUTE_TABLE[parts.join("/")];
+    return service ? { service } : null;
+  }
+  const [resource, id, sub] = parts;
+  if (parts.length === 3) {
+    const service = SUB_TABLE[`${resource}/${sub}`];
+    return service ? { service, id } : null;
+  }
+  const service = DETAIL_TABLE[resource];
+  return service ? { service, id } : null;
+}
+
+/** query string → 服务入参：'true'/'false' 还原为布尔，其余保持字符串 */
+function coerceParams(searchParams: URLSearchParams): Record<string, unknown> {
+  const params: Record<string, unknown> = {};
+  for (const [key, value] of searchParams.entries()) {
+    params[key] = value === "true" ? true : value === "false" ? false : value;
+  }
+  return params;
+}
+
+export async function GET(
+  request: Request,
+  context: RouteContext<"/api/data/[...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;
+  const resolved = resolveService(parts);
+  if (!resolved) {
+    return Response.json(
+      { error: `未知数据接口: /api/data/${parts.join("/")}` },
+      { status: 404, headers: corsHeaders(request) },
+    );
+  }
+
+  const params = coerceParams(new URL(request.url).searchParams);
+  if (resolved.id !== undefined) {
+    params[ID_PARAM[resolved.service] ?? "code"] = resolved.id;
+  }
+
+  const result = await pactorServices[resolved.service](params);
+  return Response.json(result ?? null, {
+    headers: { "cache-control": "no-store", ...corsHeaders(request) },
+  });
+}
+
+/** 预检（跨源带凭据 / 自定义头时） */
+export const OPTIONS = corsPreflight;