openxiangda 1.0.148 → 1.0.149

package/templates/openxiangda-react-spa/AGENTS.md

@@ -124,4 +124,11 @@ import { PermissionBoundary, useAppMenus, useRuntimeBootstrap } from "openxiangd
 - 数据列表：`/view/:appType/admin/data/:formUuid`
 - 文件预览：`/view/:appType/file-preview?ticket=...`
 
+附件预览约定：
+
+- 应用代码优先使用 `AttachmentField`，或通过 React SPA PageSdk（`usePageSdk()` 返回的 `sdk`）调用 `sdk.createFileAccessTicket(bucketName, objectName, fileName, "preview", { appType })` 获取 `previewPageUrl` 后打开。
+- `previewPageUrl` 是给用户打开的页面入口；`previewUrl` / `/service/file/preview-by-ticket/:ticket` 是文件内容流，只供预览页内部 iframe、PDF、图片或视频组件加载。
+- 全局兼容入口 `/view/file-preview?ticket=...` 只有在后端能从 URL、ticket payload 或 `FILE_PREVIEW_APP_TYPE` 推导 appType 时才会被 React SPA runtime 接管。若响应头仍是 `X-OpenXiangda-Runtime-Mode: legacy`，检查 ticket 是否含 appType、URL 是否带 `appType`、runtime release 是否已激活、以及服务端兜底配置。
+- 需要自定义文件预览 UI 时，在 `src/runtime/default-page-overrides.tsx` 覆盖 `file-preview`；自定义组件仍应读取 ticket metadata 和 `/service/file/*` 接口，不要直接拼旧 view/workbench 参数。
+
 需要自定义默认页时，在 `src/runtime/default-page-overrides.tsx` 中按页面类型和 `formUuid` 注册覆盖组件。不要回到旧平台 `isRenderNav` 或 workbench 参数模型。

package/templates/openxiangda-react-spa/src/pages/defaults/FilePreviewRoutePage.tsx

@@ -1,4 +1,5 @@
-import { ExternalLink, LockKeyhole, ShieldCheck } from "lucide-react";
+import { LockKeyhole, ShieldCheck } from "lucide-react";
+import { BuiltinRouteRenderer, type BrowserRuntimeRouteResolution } from "openxiangda/runtime";
 import { useParams } from "react-router-dom";
 
 import {
@@ -6,11 +7,8 @@ import {
   resolveDefaultPageOverride,
 } from "@/runtime/default-page-overrides";
 import {
-  PageHeader,
-  Panel,
   PrimaryButton,
   StatePage,
-  StatusPill,
 } from "@/shared/ui";
 
 const servicePrefix = process.env.APP_SERVICE_PREFIX || "/service";
@@ -18,38 +16,25 @@ const servicePrefix = process.env.APP_SERVICE_PREFIX || "/service";
 export function FilePreviewRoutePage() {
   const params = useParams();
   const ticket = new URLSearchParams(window.location.search).get("ticket") || "";
-  const appType = params.appType || process.env.OPENXIANGDA_APP_TYPE || process.env.APP_TYPE || "";
+  const runtimeEntry = (window as any).__OPENXIANGDA_RUNTIME_ENTRY__;
+  const appType = params.appType || runtimeEntry?.appType || process.env.OPENXIANGDA_APP_TYPE || process.env.APP_TYPE || "";
   const Override = resolveDefaultPageOverride(defaultPageOverrides, "file-preview");
-  const previewUrl = ticket
-    ? `${servicePrefix.replace(/\/+$/, "")}/file/preview-by-ticket/${encodeURIComponent(ticket)}`
-    : "";
+  const route: BrowserRuntimeRouteResolution = {
+    appType,
+    kind: "file-preview",
+    mode: "builtin-route",
+    params: { ticket },
+    path: window.location.pathname,
+    query: { ticket },
+    runtime: {
+      renderer: "openxiangda-builtin",
+      surface: "file-preview",
+    },
+    search: window.location.search,
+  };
 
   const defaultNode = ticket ? (
-    <div className="min-w-0 space-y-5">
-      <PageHeader
-        actions={
-          <PrimaryButton onClick={() => window.open(previewUrl, "_blank", "noopener,noreferrer")}>
-            <ExternalLink size={17} />
-            新窗口打开
-          </PrimaryButton>
-        }
-        description="通过安全链接打开文件内容。若浏览器无法直接预览，可在新窗口中打开或下载。"
-        meta={
-          <>
-            <StatusPill tone="blue">文件预览</StatusPill>
-            <StatusPill tone="emerald">安全访问</StatusPill>
-          </>
-        }
-        title="文件预览"
-      />
-      <Panel className="min-h-[70vh] overflow-hidden p-0">
-        <iframe
-          className="min-h-[70vh] w-full border-0 bg-white"
-          src={previewUrl}
-          title="文件预览"
-        />
-      </Panel>
-    </div>
+    <BuiltinRouteRenderer appType={appType} route={route} servicePrefix={servicePrefix} />
   ) : (
     <StatePage
       actions={