temp:临时备份，测试合并兼容性

2025-11-20 20:36:42 +08:00
parent 2e604e8ede
commit b9fe57c5fa
12 changed files with 1310 additions and 36 deletions
@@ -0,0 +1,125 @@
+/**
+ * Collabora Online 配置生成服务
+ *
+ * 职责：
+ * - 生成 Collabora iframe URL
+ * - 生成 WOPI access token
+ * - 构建完整的 Collabora 配置
+ *
+ * @encoding UTF-8
+ */
+
+import { COLLABORA_URL, APP_URL } from '~/config/api-config';
+import { WopiService } from './wopi.server';
+import type { CollaboraConfig } from '~/components/collabora/types';
+
+/**
+ * Collabora 配置生成参数
+ */
+export interface GenerateConfigParams {
+  fileId: string;
+  mode: 'view' | 'edit';
+  userId: string;
+  userName: string;
+}
+
+/**
+ * 生成 Collabora 配置
+ * @param params - 配置参数
+ * @returns Collabora 配置对象
+ */
+export async function generateCollaboraConfig(
+  params: GenerateConfigParams
+): Promise<CollaboraConfig> {
+  const { fileId, mode, userId, userName } = params;
+
+  // 创建 WOPI 服务实例
+  const wopiService = new WopiService();
+
+  // 生成 WOPI access token（2 小时有效期）
+  const accessToken = wopiService.generateAccessToken(
+    {
+      fileId,
+      mode,
+      userId,
+      userName,
+    },
+    7200 // 2 小时
+  );
+
+  // 构建 WOPI Src URL
+  const wopiSrc = `${APP_URL}/api/collabora/wopi/files/${encodeURIComponent(fileId)}`;
+
+  // 构建 Collabora iframe URL
+  const iframeUrl = buildCollaboraIframeUrl({
+    collaboraUrl: COLLABORA_URL,
+    wopiSrc,
+    accessToken,
+    mode,
+  });
+
+  // 提取文件名
+  const fileName = fileId.split('/').pop() || 'document.docx';
+
+  return {
+    iframeUrl,
+    accessToken,
+    fileName,
+    fileId,
+    collaboraUrl: COLLABORA_URL,
+    wopiSrc,
+    mode,
+  };
+}
+
+/**
+ * 构建 Collabora iframe URL
+ * @param params - URL 构建参数
+ * @returns Collabora iframe URL
+ */
+function buildCollaboraIframeUrl(params: {
+  collaboraUrl: string;
+  wopiSrc: string;
+  accessToken: string;
+  mode: 'view' | 'edit';
+}): string {
+  const { collaboraUrl, wopiSrc, accessToken, mode } = params;
+
+  // Collabora iframe 基础 URL
+  // fa80579 是 Collabora 的版本号标识，实际部署时可能需要调整
+  const baseUrl = `${collaboraUrl}/browser/fa80579/cool.html`;
+
+  const url = new URL(baseUrl);
+
+  // 设置 WOPI Src
+  url.searchParams.set('WOPISrc', wopiSrc);
+
+  // 设置 access token
+  url.searchParams.set('access_token', accessToken);
+
+  // 设置 token 过期时间（毫秒）
+  url.searchParams.set('access_token_ttl', '7200000'); // 2 小时
+
+  // UI 定制参数
+  const uiDefaults = [
+    'UIMode=compact',           // 紧凑模式
+    'TextRuler=false',          // 隐藏标尺
+    'TextStatusbar=false',      // 隐藏状态栏
+    'TextSidebar=false',        // 隐藏侧边栏
+    'SavedUIState=false',       // 不保存 UI 状态
+  ].join(';');
+  url.searchParams.set('ui_defaults', uiDefaults);
+
+  // 其他 UI 参数
+  url.searchParams.set('closebutton', '0');          // 隐藏关闭按钮
+  url.searchParams.set('revisionhistory', 'false');  // 禁用修订历史
+  url.searchParams.set('lang', 'zh-CN');             // 设置语言为中文
+
+  // 根据模式设置权限
+  if (mode === 'view') {
+    // 只读模式：通过 URL 参数限制权限
+    url.searchParams.set('permission', 'readonly');
+  }
+
+  return url.toString();
+}