openxiangda-cli 2.0.0-alpha.104 → 2.0.0-alpha.108

package/dist/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAGzE,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF,8BAAsB,kBAAmB,SAAQ,OAAO;IACtD,MAAM,CAAC,cAAc,UAAQ;IAE7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,iCAExB;cAEa,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAS1D,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC;;;;;;;;;;;;;;IAc/C,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;IAsCpC,OAAO,CAAC,QAAQ;IAyBhB,OAAO,CAAC,gBAAgB;CAkCzB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AAGzE,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF,8BAAsB,kBAAmB,SAAQ,OAAO;IACtD,MAAM,CAAC,cAAc,UAAQ;IAE7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,iCAExB;cAEa,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAS1D,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC;;;;;;;;;;;;;;IAc/C,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;IAsCpC,OAAO,CAAC,QAAQ;IAyBhB,OAAO,CAAC,gBAAgB;CAoCzB"}

package/dist/base.js

@@ -109,6 +109,7 @@ export class OpenXiangdaCommand extends Command {
             stop: "openxiangda stop",
             rollback: "openxiangda rollback --to <app-version-id>",
             login: "openxiangda login --base-url <platform>",
+            spec: "openxiangda spec context --json",
         };
         const currentId = this.id;
         if (currentId && currentCommand[currentId])
@@ -118,6 +119,8 @@ export class OpenXiangdaCommand extends Command {
         }
         if (/DEPLOYMENT|STATUS|LOG/.test(code))
             return "openxiangda status";
+        if (/APPSPEC/.test(code))
+            return "openxiangda spec check";
         if (/DEV/.test(code))
             return "openxiangda dev";
         return "openxiangda check";

package/dist/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}

package/dist/commands/spec.d.ts

@@ -0,0 +1,34 @@
+import { OpenXiangdaCommand } from "../base.js";
+export default class Spec extends OpenXiangdaCommand {
+    static summary: string;
+    static args: {
+        action: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        title: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        risk: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        summary: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        "current-spec": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        capabilities: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        requirements: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        resources: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        actions: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<import("openxiangda-contracts").DevkitResult<unknown> | {
+        schemaVersion: string;
+        ok: boolean;
+        operation: string;
+        workspace: import("openxiangda-contracts").WorkspaceIdentity;
+        data: {} | null;
+        error: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            remediation: string;
+            nextCommand: string | null;
+        } | null;
+    }>;
+}
+//# sourceMappingURL=spec.d.ts.map

package/dist/commands/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AAWhE,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,kBAAkB;IAClD,MAAM,CAAC,OAAO,SAAiC;IAC/C,MAAM,CAAC,IAAI;;;MAMT;IACF,MAAM,CAAC,KAAK;;;;;;;;;;MAiCV;IAEI,GAAG;;;;;;;;;;;;;;CA4DV"}

package/dist/commands/spec.js

@@ -0,0 +1,117 @@
+import { Args, Flags } from "@oclif/core";
+import { OpenXiangdaCommand, workspaceFlags } from "../base.js";
+const actions = [
+    "init",
+    "add-capability",
+    "new",
+    "context",
+    "check",
+    "close",
+];
+export default class Spec extends OpenXiangdaCommand {
+    static summary = "可选的 AppSpec 需求与变更辅助；不属于发布门禁";
+    static args = {
+        action: Args.string({ required: true, options: [...actions] }),
+        target: Args.string({
+            required: false,
+            summary: "capability/change id，或 context selector",
+        }),
+    };
+    static flags = {
+        ...workspaceFlags,
+        title: Flags.string({ summary: "能力或变更标题", helpValue: "<title>" }),
+        risk: Flags.string({
+            summary: "变更维护深度；默认 L1",
+            options: ["L1", "L2", "L3"],
+            helpValue: "<L1|L2|L3>",
+        }),
+        summary: Flags.string({
+            summary: "问题摘要或关闭摘要",
+            helpValue: "<text>",
+        }),
+        "current-spec": Flags.string({
+            summary: "关闭时由用户确认当前规格已合并或不适用",
+            options: ["merged", "not-applicable"],
+            helpValue: "<merged|not-applicable>",
+        }),
+        capabilities: Flags.string({
+            summary: "逗号分隔的 CAP-* 引用",
+            helpValue: "<codes>",
+        }),
+        requirements: Flags.string({
+            summary: "逗号分隔的 REQ-* 引用",
+            helpValue: "<codes>",
+        }),
+        resources: Flags.string({
+            summary: "逗号分隔的 2.0 Data Resource code",
+            helpValue: "<codes>",
+        }),
+        actions: Flags.string({
+            summary: "逗号分隔的 2.0 App API action code",
+            helpValue: "<codes>",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Spec);
+        const action = args.action;
+        if (action === "init")
+            return this.present(await this.services.appSpecInit(flags.cwd));
+        if (action === "context") {
+            return this.present(await this.services.appSpecContext(flags.cwd, args.target));
+        }
+        if (action === "check") {
+            return this.present(await this.services.appSpecCheck(flags.cwd));
+        }
+        const id = required(args.target, `APPSPEC_${action.toUpperCase().replaceAll("-", "_")}_ID_REQUIRED`);
+        if (action === "add-capability") {
+            return this.present(await this.services.appSpecAddCapability({
+                ...(flags.cwd ? { root: flags.cwd } : {}),
+                id,
+                title: required(flags.title, "APPSPEC_TITLE_REQUIRED"),
+                resources: csv(flags.resources),
+                actions: csv(flags.actions),
+            }));
+        }
+        if (action === "new") {
+            return this.present(await this.services.appSpecNew({
+                ...(flags.cwd ? { root: flags.cwd } : {}),
+                id,
+                title: required(flags.title, "APPSPEC_TITLE_REQUIRED"),
+                ...(flags.risk ? { risk: flags.risk } : {}),
+                ...(flags.summary ? { summary: flags.summary } : {}),
+                capabilities: csv(flags.capabilities),
+                requirements: csv(flags.requirements),
+                resources: csv(flags.resources),
+                actions: csv(flags.actions),
+            }));
+        }
+        if (action === "close") {
+            return this.present(await this.services.appSpecClose({
+                ...(flags.cwd ? { root: flags.cwd } : {}),
+                id,
+                ...(flags.summary ? { summary: flags.summary } : {}),
+                ...(flags["current-spec"]
+                    ? {
+                        currentSpec: flags["current-spec"],
+                    }
+                    : {}),
+            }));
+        }
+        throw new Error(`APPSPEC_ACTION_UNSUPPORTED: ${action}`);
+    }
+}
+function csv(value) {
+    return [
+        ...new Set(String(value || "")
+            .split(",")
+            .map(item => item.trim())
+            .filter(Boolean)),
+    ];
+}
+function required(value, code) {
+    const normalized = String(value || "").trim();
+    if (!normalized)
+        throw new Error(code);
+    return normalized;
+}
+//# sourceMappingURL=spec.js.map

package/dist/commands/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-cli",
-  "version": "2.0.0-alpha.104",
+  "version": "2.0.0-alpha.108",
   "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.48",
-    "openxiangda-devkit-core": "2.0.0-alpha.64",
-    "openxiangda-mcp": "2.0.0-alpha.64",
-    "openxiangda-skill-kit": "2.0.0-alpha.82"
+    "openxiangda-contracts": "2.0.0-alpha.50",
+    "openxiangda-devkit-core": "2.0.0-alpha.67",
+    "openxiangda-mcp": "2.0.0-alpha.67",
+    "openxiangda-skill-kit": "2.0.0-alpha.85"
   },
   "devDependencies": {
     "tsx": "4.23.12",

package/template/AGENTS.md

@@ -1,17 +1,20 @@
 # OpenXiangda 2.0 Application Agent Contract
 
 - 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. Do not create another router, menu, 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.
 - Declare each resource once in `openxiangda.config.ts` with only `code`, `name`, `fields` and optional 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.
 - 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.
 - Add NestJS only for a named business action that needs a cross-resource transaction, an invariant or an external side effect.
 - Every interactive business action binds `@OpenXiangdaOperation(operation)` and injects `OpenXiangdaBusinessDataApiService` or `OpenXiangdaStandardOperations`. The platform checks the action capability once at App API ingress; the trusted backend then has full Data access only to its exact application/environment while audit retains the initiating user. Do not author `authorizationJSON` or reapply the user's resource, row and field permissions inside the action.
 - A NestJS backend declares only `enabled`, `isolation: 'shared' | 'dedicated'` and `resourceProfile: 'light' | 'standard'`. Never put raw Kubernetes resources, replicas, ports or environment maps in application metadata; the platform owns capacity and scaling.
-- Use the current logged-in user and the union of that user's application roles. The generated client uses same-origin cookies and does not transmit a RoleSession header. Business code must not persist a platform Token or authorization result and must not implement a second identity path.
+- Use the current logged-in user and the union of that user's application roles. An optional declared Perspective projects only read visibility (pages, rows and fields); create/update/delete, workflows and custom actions continue to authorize against the complete union. Standard Data API calls inherit `X-OpenXiangda-Perspective` automatically. Use `@CurrentPerspective()` only when custom Nest code reads outside the standard Data API, and apply an equivalent read projection explicitly. Business code must not persist a platform Token or authorization result and must not implement a second identity path.
 - Fields inherit the resource read/create/update capabilities. Use field `access` only to tighten them; arrays are all-of and `false` is explicit deny. There is no `write` fallback.
 - Field `type` is semantic, never a hand-authored database type. The supported catalog is exactly `text.short`, `text.long`, `text.rich`, `number.integer`, `number.decimal`, `boolean`, `date`, `time`, `datetime`, `date-range`, `datetime-range`, `option.single`, `option.multiple`, `cascade.single`, `cascade.multiple`, `user.single`, `user.multiple`, `department.single`, `department.multiple`, `resource-ref.single`, `resource-ref.multiple`, `file`, `image`, `signature`, `address`, `location`, `json`, `serial-number`, `uuid` and `subtable`. The compiler alone derives PostgreSQL columns, constraints and indexes.
 - Declare every custom operation capability in `authz.capabilities` with `kind: 'backend'`, then reference that same code from the operation and its allowed roles. Generated resource CRUD capabilities do not go in this catalog.
+- Build App Operation request/response schemas with `resourceRecordSchema`, `schemaRef`, `composeJsonSchema` and `composeAppOperationSchemas` from `openxiangda/config`. They project the same Resource declaration and canonical field value protocols; never import a physical toolchain package or repeat user, department, resource-reference or managed-file schemas by hand.
 - Visitor duplicate protection uses `createVisitorReservation({ duplicateMatch: { fieldCode: submittedValue }, ... })`. `duplicateMatch` is a non-empty value map, never a field-name array, and no mutable pre-read is allowed.
 - Desktop and mobile pages share values, validation and authorization, but use separate renderers. Options, members and departments store display snapshots; resource references store direct JSON display values; attachments, images and signatures use platform-managed file references.
 - `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`.
@@ -19,4 +22,4 @@
 - 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; never 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`, and require its `aiCatalog` and `aiCatalogDigest` to match the normal compiler output. This is a stdio transport mode, not a ninth CLI command. Never write an application MCP server, Catalog file, preview store or second authorization path.
+- 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`; 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

@@ -8,13 +8,17 @@ pnpm openxiangda dev
 
 当前应用只直接依赖一个精确版本的 `openxiangda` 根包，并在 lockfile 中锁定其内部实现包。创建另一个应用时使用当前安装的 OpenXiangda 2.0 Skill 给出的精确根包版本，不使用 `latest`、`alpha` 或全局命令。
 
+`appspec/app.md` 是可选的业务意图总纲，帮助人和 AI 理解当前需求，但不是发布门禁。没有行为变化
+时不写变更；小改动最多维护一份短 ChangeSpec。按需使用
+`pnpm openxiangda spec context --json`、`spec new` 和 `spec close`，不要引入 1.x `openspec/SDD`。
+
 在 `openxiangda.config.ts` 的 `data.resources` 中只声明资源 `code`、`name`、`fields` 和可选列表/布局/数据策略。每个字段一次写完语义 `type`、`label`、`required`、列表/筛选标记、`options`/`source`/`file` 与 `access`；不要再写 `schema`、`surface`、PostgreSQL 类型、资源 capabilities、资源 fieldPolicies 或 `platform/data` 模块。编译器据此生成标准后台列表、筛选、表单、详情、审计、文件上传、独立移动端页面、Data API 查询计划和 AI Schema。
 
 成员、部门分别声明 `user.single`/`user.multiple` 和 `department.single`/`department.multiple`；同应用动态资源声明 `resource-ref.single`/`resource-ref.multiple` 及编译期固定的 `source`。这些字段都保存完整 `{label,value,...}` 显示快照，资源引用还保存 `resourceCode` 和声明的 `snapshot` 字段；查询和权限以稳定 `value` 为比较键。资源来源的 `labelField` 只能引用 `text.short` 或 `text.long`；流水号可用于搜索、描述和快照，不能作为显示标签。需要目录选择器的业务角色必须显式拥有 `app:<app-code>:directory:read` 能力。用 `resourceCapabilityCodes` 生成资源 CRUD 权限，用 `currentUserDataPolicy` 声明唯一的当前用户行规则。
 
 字段组件、CRUD Renderer、Shell、Runtime 与 Data/Directory/File/App Client 都由 `openxiangda/react`、`openxiangda/field-kit` 和 `openxiangda/core` 统一提供，应用模板不复制这些实现。Nest 只在需要复杂事务或外部集成时增加 App API。标准客户端显式携带当前环境、使用同源 Cookie；业务代码不读取或持久化 Token、平台内部身份标识与授权结果。
 
-前端一次读取当前登录用户在当前环境的完整应用角色并集和 capability 做展示保护，不提供角色选择器，也不发送 RoleSession header。服务端始终以同一角色并集权威执行操作、字段、行权限和 RLS。字段默认继承资源 read/create/update；`access` 数组为 all-of，`false` 为明确拒绝，无权字段在提交前从 payload 删除。
+前端一次读取当前登录用户在当前环境的完整应用角色并集和 capability。应用可在 `perspectives` 中声明工作视角；视角只投影页面、行和字段的读取范围，不改变真实身份，也不收窄新增、编辑、删除、流程与自定义动作权限。标准 Data API 自动识别视角；只有绕过标准 Data API 的自定义 Nest 查询才需要通过 `@CurrentPerspective()` 显式实现同等读取投影。字段默认继承资源 read/create/update；`access` 数组为 all-of，`false` 为明确拒绝，无权字段在提交前从 payload 删除。
 
 ```bash
 pnpm openxiangda check

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.17",
+    "openxiangda": "2.0.0-alpha.21",
     "reflect-metadata": "0.2.2",
     "rxjs": "7.8.2"
   },

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

@@ -0,0 +1,186 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { Button, Typography } from 'antd';
+import {
+  defineAdminContributions,
+  OpenXiangdaApplication,
+} from 'openxiangda/react';
+import type { DataFieldSurface, DataResourceSurface } from 'openxiangda/core';
+import 'openxiangda/react/styles.css';
+
+const field = (
+  label: string,
+  type: DataFieldSurface['type'] = 'text.short',
+  widget: DataFieldSurface['widget'] = 'text',
+  extra: Partial<DataFieldSurface> = {}
+): DataFieldSurface => ({
+  label,
+  type,
+  widget,
+  readCapabilities: [],
+  createCapabilities: [],
+  updateCapabilities: [],
+  ...extra,
+});
+
+const fields: DataResourceSurface['fields'] = {
+  description: field('栏目说明', 'text.long', 'textarea', {
+    section: '栏目设置',
+  }),
+  status: field('状态', 'option.single', 'select', {
+    options: [
+      { label: '启用', value: 'enabled' },
+      { label: '停用', value: 'disabled' },
+    ],
+    section: '栏目设置',
+  }),
+  name: field('栏目名称', 'text.short', 'text', { section: '栏目设置' }),
+  code: field('栏目编码', 'text.short', 'text', { section: '栏目设置' }),
+  contentType: field('内容类型', 'option.single', 'select', {
+    options: [
+      { label: '文章', value: 'article' },
+      { label: '图集', value: 'gallery' },
+    ],
+    section: '栏目设置',
+  }),
+  manager: field('栏目管理员', 'user.single', 'directory-user', {
+    section: '管理信息',
+  }),
+  facility: field('配套设施', 'option.multiple', 'multi-select', {
+    options: [
+      { label: '投影仪', value: 'projector' },
+      { label: '白板', value: 'whiteboard' },
+    ],
+    section: '管理信息',
+  }),
+  openingDay: field('开放星期', 'option.single', 'select', {
+    options: [
+      { label: '工作日', value: 'weekday' },
+      { label: '周末', value: 'weekend' },
+    ],
+    section: '管理信息',
+  }),
+};
+
+const surface: DataResourceSurface = {
+  generated: true,
+  fields,
+  list: {
+    defaultPageSize: 20,
+    searchableFields: ['name', 'code'],
+    filterFields: ['contentType', 'status', 'manager', 'facility', 'openingDay'],
+    defaultSort: { field: 'code', order: 'asc' },
+  },
+  form: {
+    layout: 'sections',
+    fieldOrder: [
+      'code',
+      'name',
+      'contentType',
+      'description',
+      'status',
+      'manager',
+      'facility',
+      'openingDay',
+    ],
+  },
+  detail: {
+    layout: 'sections',
+    fieldOrder: [
+      'code',
+      'name',
+      'contentType',
+      'description',
+      'status',
+      'manager',
+      'facility',
+      'openingDay',
+    ],
+  },
+  mobile: { enabled: true },
+};
+
+const names = [
+  '内容栏目',
+  '内容文章',
+  '内容专题',
+  '会员档案',
+  '门户轮播',
+  '工会小组',
+  '场地预约',
+  '场地不可用时段',
+  '场地档案',
+  '通知公告',
+  '活动报名',
+  '资料下载',
+];
+const resourceDefinitions = Object.fromEntries(
+  names.map((name, index) => {
+    const code = `resource-${String(index + 1).padStart(2, '0')}`;
+    return [
+      code,
+      {
+        code,
+        name,
+        capabilities: {
+          read: `app:openxiangda-application:data:${code}:read`,
+          create: `app:openxiangda-application:data:${code}:create`,
+          update: `app:openxiangda-application:data:${code}:update`,
+          delete: `app:openxiangda-application:data:${code}:delete`,
+        },
+        surface,
+      },
+    ];
+  })
+);
+
+function ContentOperationsPage() {
+  return <Typography.Title level={2}>内容业务操作</Typography.Title>;
+}
+
+const adminContributions = defineAdminContributions(
+  {
+    contentOperations: {
+      code: 'content-operations',
+      path: '/admin/operations/content',
+      label: '内容业务操作',
+      surface: 'admin',
+      navigation: 'menu',
+      capability: 'app:openxiangda-application:operations:read',
+      tabPersistence: 'session',
+      keepAlive: 'none',
+    },
+  } as const,
+  {
+    pages: { contentOperations: ContentOperationsPage },
+    resources: {
+      'resource-01': {
+        toolbar: [
+          {
+            code: 'publish-selected',
+            label: '发布选中栏目',
+            capability: 'app:openxiangda-application:operations:read',
+            render: ({ selectedRecords }) => (
+              <Button>发布选中栏目（{selectedRecords.length}）</Button>
+            ),
+          },
+        ],
+      },
+    },
+  },
+);
+
+if (location.pathname.endsWith('/resource-experience.e2e.html')) {
+  history.replaceState({}, '', '/resource-01');
+}
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <OpenXiangdaApplication
+      appCode="openxiangda-application"
+      appName="资源体验验收"
+      contributions={adminContributions}
+      resourceDefinitions={resourceDefinitions}
+    />
+  </React.StrictMode>
+);

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

@@ -21,7 +21,7 @@ const definitions = resourceDefinitions as Record<string, DeclaredResource>;
 const allCapabilities = [...capabilities] as string[];
 const runtimeBase = `/view/${appCode}`;
 
-function runtimeAuthorization(authorized: boolean) {
+function runtimeAuthorization(authorized: boolean, superAdmin = false) {
   return {
     schemaVersion: 'openxiangda.runtime-authorization/v2',
     state: 'active',
@@ -34,12 +34,24 @@ function runtimeAuthorization(authorized: boolean) {
       authzVersion: 1,
       scopeDataVersion: 'scope-1',
     },
+    subjectProfile: {
+      schemaVersion: 'openxiangda.subject-profile/v2',
+      userId: 'acceptance-user',
+      displayName: '王老师',
+      avatarUrl: null,
+      jobNumber: 'T001',
+      affiliatedDepartment: { id: 'department-1', name: '理学院' },
+    },
+    roles: [
+      { code: 'college_admin', name: '学院管理员', source: 'package' },
+      { code: 'instrument_admin', name: '仪器管理员', source: 'package' },
+    ],
     principal: {
       type: 'user_union',
       userId: 'acceptance-user',
       roleCodes: ['college_admin', 'instrument_admin'],
       capabilityCodes: authorized ? allCapabilities : [],
-      isAppSuperAdmin: false,
+      isAppSuperAdmin: superAdmin,
       identityScope: 'user-union:preproduction-id:acceptance-user:authz-1',
     },
   };
@@ -49,9 +61,14 @@ async function mockPlatform(
   page: Page,
   authorized = true,
   targetRuntimeBase = runtimeBase,
+  superAdmin = false,
 ) {
   let contextReads = 0;
-  const observed: Array<{ path: string; roleSessionId: string }> = [];
+  let avatarCompletes = 0;
+  const observed: Array<{ path: string; perspectiveCode: string }> = [];
+  await page.route('https://upload.example.test/avatar-upload', route =>
+    route.fulfill({ status: 200, body: '' })
+  );
   await page.route(`**${targetRuntimeBase}/**`, async route => {
     if (route.request().resourceType() !== 'document') return route.continue();
     const response = await route.fetch();
@@ -66,14 +83,45 @@ async function mockPlatform(
   await page.route('**/service/**', async route => {
     const url = new URL(route.request().url());
     const request = route.request();
-    const roleSessionId = request.headers()['x-openxiangda-role-session-id'] || '';
+    const perspectiveCode = request.headers()['x-openxiangda-perspective'] || '';
     if (url.pathname.endsWith('/native/authz/current')) {
       contextReads += 1;
       return route.fulfill({
         contentType: 'application/json',
         body: JSON.stringify({
           code: 200,
-          data: runtimeAuthorization(authorized),
+          data: runtimeAuthorization(authorized, superAdmin),
+        }),
+      });
+    }
+    if (url.pathname.endsWith('/native/authz/profile/avatar/initiate')) {
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify({
+          code: 200,
+          data: {
+            uploadUrl: 'https://upload.example.test/avatar-upload',
+            uploadMethod: 'put',
+            headers: { 'content-type': 'image/png' },
+            objectName: 'images/tenant/app/user/avatar.png',
+          },
+        }),
+      });
+    }
+    if (url.pathname.endsWith('/native/authz/profile/avatar/complete')) {
+      avatarCompletes += 1;
+      return route.fulfill({
+        contentType: 'application/json',
+        body: JSON.stringify({
+          code: 200,
+          data: {
+            schemaVersion: 'openxiangda.subject-profile/v2',
+            userId: 'acceptance-user',
+            displayName: '王老师',
+            avatarUrl: 'https://cdn.example.test/avatar/new.png',
+            jobNumber: 'T001',
+            affiliatedDepartment: { id: 'department-1', name: '理学院' },
+          },
         }),
       });
     }
@@ -81,7 +129,7 @@ async function mockPlatform(
       /\/native\/data-resources\/([^/]+)\/fields\/([^/]+)\/source\/query$/
     );
     if (sourceQuery) {
-      observed.push({ path: url.pathname, roleSessionId });
+      observed.push({ path: url.pathname, perspectiveCode });
       return route.fulfill({
         contentType: 'application/json',
         body: JSON.stringify({
@@ -100,7 +148,7 @@ async function mockPlatform(
       /\/native\/data\/([^/]+)\/export$/
     );
     if (exportRequest) {
-      observed.push({ path: url.pathname, roleSessionId });
+      observed.push({ path: url.pathname, perspectiveCode });
       return route.fulfill({
         status: 200,
         contentType: 'text/csv; charset=utf-8',
@@ -114,7 +162,7 @@ async function mockPlatform(
     }
     const query = url.pathname.match(/\/native\/data\/([^/]+)\/query$/);
     if (query) {
-      observed.push({ path: url.pathname, roleSessionId });
+      observed.push({ path: url.pathname, perspectiveCode });
       return route.fulfill({
         contentType: 'application/json',
         body: JSON.stringify({
@@ -133,14 +181,14 @@ async function mockPlatform(
       });
     }
     if (url.pathname.includes('/directory/')) {
-      observed.push({ path: url.pathname, roleSessionId });
+      observed.push({ path: url.pathname, perspectiveCode });
       return route.fulfill({
         contentType: 'application/json',
         body: JSON.stringify({ code: 200, data: { items: [], nextCursor: null } }),
       });
     }
     if (url.pathname.includes('/openxiangda-app-api/v2/')) {
-      observed.push({ path: url.pathname, roleSessionId });
+      observed.push({ path: url.pathname, perspectiveCode });
       return route.fulfill({
         contentType: 'application/json',
         body: JSON.stringify({ code: 200, data: { status: 'ok' } }),
@@ -157,6 +205,9 @@ async function mockPlatform(
     get contextReads() {
       return contextReads;
     },
+    get avatarCompletes() {
+      return avatarCompletes;
+    },
   };
 }
 
@@ -179,7 +230,13 @@ test('renders the compiled desktop resource contract and shared workbench', asyn
       const more = page.getByRole('button', { name: /更多筛选/ });
       await expect(more).toBeVisible();
       await more.click();
-      await expect(page.getByRole('button', { name: '收起筛选' })).toBeVisible();
+      const modal = page.getByRole('dialog', { name: '更多筛选' });
+      await expect(modal).toBeVisible();
+      await expect(modal.getByRole('button', { name: '应用筛选' })).toBeVisible();
+      await expect
+        .poll(async () => (await modal.boundingBox())?.width || 0)
+        .toBeGreaterThan(700);
+      await modal.getByRole('button', { name: '取消' }).click();
     }
     const downloadPromise = page.waitForEvent('download');
     await page.getByRole('button', { name: /导出$/ }).click();
@@ -190,6 +247,10 @@ test('renders the compiled desktop resource contract and shared workbench', asyn
   await expect(page.locator('.oxa-topbar')).toHaveCSS('height', '52px');
   await expect(page.getByText('仪器' + '资源管理')).toHaveCount(0);
   await page.locator('.oxa-current-user').click();
+  await expect(page.locator('.oxa-user-dropdown-profile')).toContainText('王老师');
+  await expect(page.locator('.oxa-user-dropdown-profile')).toContainText('理学院');
+  await expect(page.locator('.oxa-user-dropdown-roles')).toContainText('学院管理员');
+  await expect(page.locator('.oxa-user-dropdown-roles')).not.toContainText('college_admin');
   await expect(page.getByText('跟随系统', { exact: true })).toBeVisible();
   await page.getByText('深色', { exact: true }).click();
   await expect(page.locator('html')).toHaveAttribute('data-oxa-theme', 'dark');
@@ -205,7 +266,7 @@ test('opens the stable admin entry under the preproduction gateway mount', async
   await expect(page).toHaveURL(`${devRuntimeBase}/${codes[0]}`);
 });
 
-test('uses the current user role union without exposing a RoleSession header', async ({ page }) => {
+test('uses the complete current-user role union when no Perspective is selected', async ({ page }) => {
   const platform = await mockPlatform(page);
   await page.goto(`${runtimeBase}/admin`);
   if (codes.length) {
@@ -229,15 +290,121 @@ test('uses the current user role union without exposing a RoleSession header', a
     )
   );
   expect(protectedRequests.length).toBeGreaterThanOrEqual(3);
-  expect(protectedRequests.every(item => item.roleSessionId === '')).toBe(true);
+  expect(protectedRequests.every(item => item.perspectiveCode === '')).toBe(true);
   expect(platform.contextReads).toBe(1);
   await page.locator('.oxa-current-user').click();
   await expect(page.locator('.oxa-user-dropdown-roles')).toContainText(
-    'college_admin、instrument_admin'
+    '学院管理员'
+  );
+  await expect(page.locator('.oxa-user-dropdown-roles')).toContainText(
+    '仪器管理员'
+  );
+  await expect(page.locator('.oxa-user-dropdown-roles')).not.toContainText(
+    'college_admin'
   );
   await expect(page.getByText('切换应用角色', { exact: true })).toHaveCount(0);
 });
 
+test('updates the current user avatar through the platform-owned profile contract', async ({ page }) => {
+  const platform = await mockPlatform(page);
+  await page.goto(`${runtimeBase}/admin`);
+  await page.locator('.oxa-current-user').click();
+  await page.locator('.oxa-user-dropdown input[type="file"]').first().setInputFiles({
+    name: 'avatar.png',
+    mimeType: 'image/png',
+    buffer: Buffer.from(
+      '89504e470d0a1a0a0000000d49484452000000010000000108060000001f15c4890000000d49444154789c6360f8cff00000040101005fe245400000000049454e44ae426082',
+      'hex'
+    ),
+  });
+  await expect(page.getByText('头像已更新', { exact: true })).toBeVisible();
+  await expect.poll(() => platform.avatarCompletes).toBe(1);
+  await expect(page.locator('.oxa-current-user img')).toHaveAttribute(
+    'src',
+    'https://cdn.example.test/avatar/new.png'
+  );
+});
+
+test('preserves the left menu scroll position when switching resource pages', async ({ page }) => {
+  await mockPlatform(page, true, runtimeBase, true);
+  await page.goto('/resource-experience.e2e.html');
+  const scroller = page.locator('.oxa-menu-scroll');
+  await scroller.evaluate(node => {
+    const menu = node.querySelector('.oxa-menu') as HTMLElement | null;
+    if (menu) menu.style.minHeight = '1400px';
+    node.scrollTop = 240;
+    node.dispatchEvent(new Event('scroll'));
+  });
+  await expect.poll(() => scroller.evaluate(node => node.scrollTop)).toBe(240);
+  await page.locator('.oxa-sider').getByText('资料下载', { exact: true }).click();
+  await expect(page).toHaveURL('/resource-12');
+  await expect.poll(() => scroller.evaluate(node => node.scrollTop)).toBe(240);
+});
+
+test('mounts generated operation routes and typed actions in the unified Shell', async ({ page }) => {
+  await mockPlatform(page, true, runtimeBase, true);
+  await page.goto('/resource-experience.e2e.html');
+  await expect(
+    page.getByRole('button', { name: '发布选中栏目（0）' })
+  ).toBeVisible();
+  await page.locator('.oxa-sider').getByText('内容业务操作', { exact: true }).click();
+  await expect(page).toHaveURL('/admin/operations/content');
+  await expect(
+    page.getByRole('heading', { name: '内容业务操作' })
+  ).toBeVisible();
+  await expect(page.locator('.oxa-sider')).toBeVisible();
+});
+
+test('fails closed on a direct operation route without its capability', async ({ page }) => {
+  await mockPlatform(page, false, runtimeBase, false);
+  await page.goto('/resource-experience.e2e.html');
+  await page.evaluate(() => {
+    history.pushState({}, '', '/admin/operations/content');
+    window.dispatchEvent(new PopStateEvent('popstate'));
+  });
+  await expect(page.getByText('当前平台用户无此页面权限')).toBeVisible();
+  await expect(
+    page.locator('.oxa-sider').getByText('内容业务操作', { exact: true })
+  ).toHaveCount(0);
+});
+
+test('keeps platform implementation guidance out of generated forms', async ({ page }) => {
+  await mockPlatform(page, true, runtimeBase, true);
+  await page.goto('/resource-experience.e2e.html');
+  await page.getByRole('button', { name: '新增内容栏目' }).click();
+  await expect(page).toHaveURL('/resource-01/new');
+  const formLabels = page.locator('.ant-form-item-label label');
+  await expect(formLabels.first()).toBeVisible();
+  const labels = await formLabels.allTextContents();
+  expect(labels.slice(0, 2)).toEqual(['栏目编码', '栏目名称']);
+  await expect(
+    page.getByText('仅显示当前角色可编辑的字段；保存时将校验数据版本与权限范围。', {
+      exact: true,
+    })
+  ).toHaveCount(0);
+  await expect(page.getByText('当前角色不可修改此字段', { exact: true })).toHaveCount(0);
+});
+
+test('keeps primary filters compact and opens additional filters in a large modal', async ({ page }) => {
+  await mockPlatform(page, true, runtimeBase, true);
+  await page.goto('/resource-experience.e2e.html');
+  await expect(page.locator('.oxa-filter-primary-item')).toHaveCount(2);
+  await expect(
+    page.getByPlaceholder('搜索栏目名称或栏目编码')
+  ).toBeVisible();
+  const more = page.getByRole('button', { name: '更多筛选' });
+  await more.click();
+  const modal = page.getByRole('dialog', { name: '更多筛选' });
+  await expect(modal).toBeVisible();
+  await expect(modal.locator('.oxa-more-filter-field')).toHaveCount(3);
+  await expect(modal).toContainText('栏目管理员');
+  await expect(modal).toContainText('配套设施');
+  await expect(modal).toContainText('开放星期');
+  await expect
+    .poll(async () => (await modal.boundingBox())?.width || 0)
+    .toBeGreaterThan(700);
+});
+
 test('renders platform mobile controls from declared field widgets', async ({ page }) => {
   const candidate = codes
     .map(code => ({ code, definition: definitions[code] }))

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

@@ -217,6 +217,21 @@ async function mockWorkflow(page: Page, options: { forbidden?: boolean } = {}) {
               authzVersion: 1,
               scopeDataVersion: 'scope-1',
             },
+            subjectProfile: {
+              schemaVersion: 'openxiangda.subject-profile/v2',
+              userId: 'acceptance-user',
+              displayName: '王老师',
+              avatarUrl: null,
+              jobNumber: 'T001',
+              affiliatedDepartment: { id: 'department-1', name: '理学院' },
+            },
+            roles: [
+              {
+                code: 'department_manager',
+                name: '部门管理员',
+                source: 'package',
+              },
+            ],
             principal: {
               type: 'user_union',
               userId: 'acceptance-user',

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.17",
+    "openxiangda": "2.0.0-alpha.21",
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "react-router-dom": "7.8.2"

package/template/apps/web/resource-experience.e2e.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="openxiangda-runtime-base" content="/" />
+    <meta name="openxiangda-app-code" content="openxiangda-application" />
+    <meta name="openxiangda-environment" content="preproduction" />
+    <title>Resource experience acceptance</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/e2e/resource-experience-fixture.tsx"></script>
+  </body>
+</html>

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

@@ -1,19 +1,30 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
-import { OpenXiangdaApplication } from 'openxiangda/react';
+import {
+  defineAdminContributions,
+  OpenXiangdaApplication,
+} from 'openxiangda/react';
 import {
   appCode,
   appName,
+  appPerspectives,
+  appRoutes,
   resourceDefinitions,
   workflowCodes,
 } from '../../../packages/contracts/src/generated.js';
 import 'openxiangda/react/styles.css';
 
+const adminContributions = defineAdminContributions(appRoutes, {
+  pages: {},
+});
+
 ReactDOM.createRoot(document.getElementById('root')!).render(
   <React.StrictMode>
     <OpenXiangdaApplication
       appCode={appCode}
       appName={appName}
+      contributions={adminContributions}
+      perspectives={appPerspectives}
       resourceDefinitions={resourceDefinitions}
       workflows={workflowCodes}
     />

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

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

package/template/appspec/app.md

@@ -0,0 +1,36 @@
+---
+schema: openxiangda.appspec/app/v1
+app: "openxiangda-application"
+title: "OpenXiangda 应用"
+status: active
+---
+# OpenXiangda 应用
+
+AppSpec 是可选的业务意图辅助层，不是发布门禁。资源、字段、权限和动作仍以
+`openxiangda.config.ts` 与实时编译合同为准。
+
+## 业务目标
+
+<!-- 用业务语言说明应用解决的问题和可观察结果。 -->
+
+## 角色
+
+<!-- 只记录业务角色及其目标；稳定 role code 在能力规格中引用。 -->
+
+## 范围
+
+### 包含
+
+### 不包含
+
+## 能力目录
+
+<!-- 复杂业务再在 capabilities/ 下增加 CAP-*；小应用可以只维护本文件。 -->
+
+## 术语
+
+## 跨能力约束
+
+## 未确认问题
+
+- 无。

package/template/package.json

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

package/template/packages/contracts/src/generated.ts

@@ -2,6 +2,7 @@
 export const compilerContractVersion = "native-2" as const;
 export const appCode = "openxiangda-application" as const;
 export const appName = "OpenXiangda 应用" as const;
+export const appPerspectives = [] as const;
 export const resourceCodes = [] as const;
 export const resourceSurfaces = {} as const;
 export const resourceDefinitions = {} as const;
@@ -31,6 +32,7 @@ export type ResourceCode = (typeof resourceCodes)[number];
 export type Capability = (typeof capabilities)[number];
 export type AppOperation = (typeof appOperations)[keyof typeof appOperations];
 export type AppRoute = (typeof appRoutes)[keyof typeof appRoutes];
+export type AppPerspective = (typeof appPerspectives)[number];
 export type EventType = (typeof eventTypes)[number];
 export type EventSubscriptionCode = (typeof eventSubscriptionCodes)[number];
 export type EventTypesForSubscription<TCode extends EventSubscriptionCode> = never;

package/template/scripts/verify-template-budget.mjs

@@ -39,7 +39,7 @@ const agents = readFileSync(resolve(root, 'AGENTS.md'), 'utf8');
 if (!agents.includes('pnpm openxiangda')) throw new Error('TEMPLATE_AGENT_PINNED_CLI_MISSING');
 if (
   !agents.includes("union of that user's application roles") ||
-  !agents.includes('does not transmit a RoleSession header')
+  !agents.includes('Perspective projects only read visibility')
 ) {
   throw new Error('TEMPLATE_AGENT_ROLE_UNION_BOUNDARY_MISSING');
 }