pdf-master-landing 0.0.1

package/README.md

@@ -0,0 +1,82 @@
+# PDF Master Landing
+
+PDF Master 的产品介绍页。Vite + React + TypeScript。
+
+## 与 Flutter Web 的关系
+
+落地页是站点根；Flutter Web 应用部署在 `/app/` 子路径下。
+
+集成方式：
+
+- **构建产物源**：`flutter build web --base-href /app/ --wasm --release` → `<repo>/build/web/`。
+- **同步点**：`landing/public/app/`。vite 把 `public/` 在 dev 直接 serve、在 build 拷到 `dist/`，所以一处同步两处生效。
+- **同步脚本**：`scripts/sync-flutter-web.mjs`，挂在 `predev` / `prebuild` 钩子上，自动执行。
+
+`landing/public/app/` 是构建产物，已 gitignore。
+
+## 开发
+
+```bash
+cd landing
+npm install
+
+# 第一次跑：先准备 Flutter 产物（一次构建即可，后续不用重复）
+npm run sync:app
+
+# 启动 dev server
+npm run dev          # http://localhost:5180
+```
+
+`npm run dev` 会先跑 `predev`，把现有的 `build/web/` 同步到 `public/app/`（不重新构建 Flutter）。
+如果 Flutter 代码有改动，重新跑 `npm run sync:app`。
+
+### 用 flutter run 热重载联调
+
+不想反复 `flutter build web`，可以让 Flutter 自己跑独立 dev server：
+
+```bash
+# 终端 A
+cd ..
+flutter run -d chrome --web-port 5181
+
+# 终端 B：跳过同步、走 VITE_APP_BASE 切换
+echo "VITE_APP_BASE=http://localhost:5181/" > landing/.env.local
+SKIP_FLUTTER=1 npm run dev
+```
+
+## 生产构建
+
+```bash
+npm run build        # → landing/dist/，包含 dist/app/
+```
+
+`prebuild` 钩子会先跑 `flutter build web` + 同步到 `public/app/`，然后 vite build 把整个 `public/` 拷进 `dist/`。
+
+## npm 发布与 1Panel 部署
+
+这个项目可以作为 npm 包发布，包内只暴露静态产物 `dist/` 和部署脚本。
+
+```bash
+cd landing
+npm publish
+```
+
+服务器上先把包安装到 1Panel 站点目录，再用包内 bin 把公开目录切成软链接：
+
+```bash
+cd /opt/1panel/www/sites/pdfmaster.top/index
+npm install pdf-master-landing@latest
+npx pdfmaster-deploy --target .
+```
+
+执行后，`/opt/1panel/www/sites/pdfmaster.top/index/dist` 会指向
+`node_modules/pdf-master-landing/dist`。OpenResty 当前 root 仍然是
+`/www/sites/pdfmaster.top/index/dist`，不用改 1Panel 站点配置。
+
+## 同步脚本参数
+
+```bash
+npm run sync:app             # 构建 + 同步（默认）
+npm run sync:app:no-build    # 只同步现有 build/web/，不跑 flutter
+SKIP_FLUTTER=1 ...           # 完全跳过（前端纯 UI 联调时用）
+```

package/bin/deploy.mjs

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+function printHelp() {
+  console.log(`PDF Master landing deploy
+
+Usage:
+  pdfmaster-deploy --target <site-index-dir>
+  pdf-master-landing deploy --target <site-index-dir>
+
+Options:
+  -t, --target <dir>     Directory that owns the public dist symlink.
+  --link-name <name>     Symlink name inside target. Defaults to dist.
+  --dry-run              Print the planned link change without writing files.
+  -h, --help             Show this help.
+`);
+}
+
+function parseArgs(argv) {
+  const args = argv[0] === 'deploy' ? argv.slice(1) : argv;
+  const options = {
+    linkName: 'dist',
+    dryRun: false,
+    target: undefined,
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    const next = args[index + 1];
+
+    if (arg === '-h' || arg === '--help') {
+      options.help = true;
+      continue;
+    }
+
+    if (arg === '--dry-run') {
+      options.dryRun = true;
+      continue;
+    }
+
+    if (arg === '-t' || arg === '--target') {
+      if (!next) {
+        throw new Error(`${arg} requires a directory.`);
+      }
+      options.target = next;
+      index += 1;
+      continue;
+    }
+
+    if (arg === '--link-name') {
+      if (!next) {
+        throw new Error('--link-name requires a name.');
+      }
+      options.linkName = next;
+      index += 1;
+      continue;
+    }
+
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+
+  return options;
+}
+
+async function pathExists(value) {
+  try {
+    await fs.lstat(value);
+    return true;
+  } catch (error) {
+    if (error?.code === 'ENOENT') {
+      return false;
+    }
+    throw error;
+  }
+}
+
+function assertSafeLinkName(linkName) {
+  if (!linkName || linkName.includes('/') || linkName.includes('\\') || linkName === '.' || linkName === '..') {
+    throw new Error('--link-name must be a plain file name inside the target directory.');
+  }
+}
+
+function assertPackageInsideTarget(sourceDist, targetDir) {
+  const relative = path.relative(targetDir, sourceDist);
+  if (relative.startsWith('..') || path.isAbsolute(relative)) {
+    throw new Error(`The package dist directory is outside the deploy target.
+
+Install the npm package inside the 1Panel site directory first, then run the local bin:
+
+  cd ${targetDir}
+  npm install pdf-master-landing@latest
+  npx pdfmaster-deploy --target .
+
+Package dist:
+  ${sourceDist}
+Deploy target:
+  ${targetDir}`);
+  }
+}
+
+async function deploy(options) {
+  if (!options.target) {
+    throw new Error('--target is required.');
+  }
+
+  assertSafeLinkName(options.linkName);
+
+  const rawSourceDist = path.join(packageRoot, 'dist');
+  const sourceIndex = path.join(rawSourceDist, 'index.html');
+  const rawTargetDir = path.resolve(options.target);
+
+  if (!(await pathExists(sourceIndex))) {
+    throw new Error(`Cannot find built landing files at ${rawSourceDist}. Run npm run build before packing or publishing.`);
+  }
+
+  if (!(await pathExists(rawTargetDir))) {
+    throw new Error(`Deploy target does not exist: ${rawTargetDir}`);
+  }
+
+  const sourceDist = await fs.realpath(rawSourceDist);
+  const targetDir = await fs.realpath(rawTargetDir);
+  const linkPath = path.join(targetDir, options.linkName);
+  const tempLinkPath = path.join(targetDir, `.${options.linkName}.next-${process.pid}-${Date.now()}`);
+  const relativeSource = path.relative(path.dirname(linkPath), sourceDist);
+  const symlinkType = process.platform === 'win32' ? 'junction' : 'dir';
+
+  assertPackageInsideTarget(sourceDist, targetDir);
+
+  console.log(`PDF Master landing deploy
+Target: ${targetDir}
+Source: ${sourceDist}
+Link:   ${linkPath} -> ${relativeSource}`);
+
+  if (options.dryRun) {
+    console.log('Dry run complete. No files were changed.');
+    return;
+  }
+
+  await fs.rm(tempLinkPath, { force: true, recursive: true });
+  await fs.symlink(relativeSource, tempLinkPath, symlinkType);
+  await fs.rm(linkPath, { force: true, recursive: true });
+  await fs.rename(tempLinkPath, linkPath);
+
+  console.log('Deploy complete.');
+}
+
+try {
+  const options = parseArgs(process.argv.slice(2));
+
+  if (options.help) {
+    printHelp();
+  } else {
+    await deploy(options);
+  }
+} catch (error) {
+  console.error(error instanceof Error ? error.message : error);
+  console.error('Run pdfmaster-deploy --help for usage.');
+  process.exitCode = 1;
+}

package/dist/_diag.html

@@ -0,0 +1,159 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8" />
+  <title>Flutter Web 加载路径检测</title>
+  <style>
+    body {
+      font: 14px/1.6 -apple-system, system-ui, "PingFang SC", sans-serif;
+      max-width: 760px;
+      margin: 40px auto;
+      padding: 0 20px;
+      color: #15161a;
+    }
+    h1 { font-size: 22px; margin: 0 0 6px; }
+    h2 { font-size: 16px; margin: 32px 0 10px; }
+    p.lede { color: #5c6068; margin: 0 0 24px; }
+    table { width: 100%; border-collapse: collapse; }
+    td { padding: 10px 12px; border-bottom: 1px solid #eee; vertical-align: top; }
+    td:first-child { width: 240px; color: #5c6068; }
+    td b { color: #15161a; font-weight: 600; }
+    .yes { color: #1a7f3c; font-weight: 600; }
+    .no { color: #b3261e; font-weight: 600; }
+    code { font-family: ui-monospace, Menlo, monospace; font-size: 13px; background: #f4f4f4; padding: 1px 6px; border-radius: 4px; }
+    .verdict { margin-top: 24px; padding: 16px 18px; border-radius: 10px; }
+    .verdict.wasm { background: #e8f4ec; border: 1px solid #1a7f3c; }
+    .verdict.js   { background: #fdecea; border: 1px solid #b3261e; }
+    .verdict h2 { margin: 0 0 6px; }
+    .net { font-family: ui-monospace, Menlo, monospace; font-size: 12.5px; color: #5c6068; }
+  </style>
+</head>
+<body>
+  <h1>Flutter Web 加载路径检测</h1>
+  <p class="lede">这一页直接读浏览器 capability + 本次实际加载的脚本，告诉你跑的是 wasm 还是 JS fallback。</p>
+
+  <h2>浏览器能力</h2>
+  <table id="caps"></table>
+
+  <h2>本次实际加载</h2>
+  <table id="loaded"></table>
+
+  <div id="verdict" class="verdict"></div>
+
+  <h2>原始抓取详情</h2>
+  <pre class="net" id="raw"></pre>
+
+  <script type="module">
+    // —— 浏览器 capability ——
+    const wasmGcBytes = [0,97,115,109,1,0,0,0,1,5,1,95,1,120,0];
+    const supportsWasmGC = (() => {
+      try { return WebAssembly.validate(new Uint8Array(wasmGcBytes)); } catch { return false; }
+    })();
+    const c = document.createElement('canvas');
+    const webgl2 = c.getContext('webgl2') != null;
+    const webgl1 = !webgl2 && c.getContext('webgl') != null;
+    const webglVersion = webgl2 ? 2 : (webgl1 ? 1 : 0);
+    const crossOriginIsolated = window.crossOriginIsolated;
+    const isHttps = location.protocol === 'https:' || location.hostname === 'localhost' || location.hostname === '127.0.0.1';
+
+    const caps = [
+      ['supportsWasmGC', supportsWasmGC, 'dart2wasm 必需'],
+      ['webGLVersion', webglVersion, 'skwasm renderer 要 WebGL2，否则降到 canvaskit'],
+      ['crossOriginIsolated', crossOriginIsolated, 'COOP+COEP 头是否生效；skwasm 多线程必需'],
+      ['secure context', isHttps, 'HTTPS 或 localhost'],
+    ];
+    const capsEl = document.getElementById('caps');
+    caps.forEach(([k, v, hint]) => {
+      const ok = !!v && v !== 0;
+      const row = document.createElement('tr');
+      row.innerHTML = `<td><b>${k}</b><div style="font-size:12px;color:#888">${hint}</div></td>` +
+                      `<td><span class="${ok ? 'yes' : 'no'}">${typeof v === 'boolean' ? (v ? 'true' : 'false') : v}</span></td>`;
+      capsEl.appendChild(row);
+    });
+
+    // —— 抓 build config ——
+    const cfgRes = await fetch('/app/flutter_bootstrap.js', { cache: 'no-cache' });
+    const cfgText = await cfgRes.text();
+    const cfgMatch = cfgText.match(/_flutter\.buildConfig\s*=\s*(\{[^;]+\})/);
+    const buildConfig = cfgMatch ? JSON.parse(cfgMatch[1]) : null;
+    const builds = buildConfig?.builds ?? [];
+
+    // —— 模拟 flutter.js 选择逻辑 ——
+    const browserEngine = (() => {
+      if (navigator.vendor === 'Google Inc.' || navigator.userAgent.includes('Edg/')) return 'blink';
+      if (navigator.vendor === 'Apple Computer, Inc.') return 'webkit';
+      if (navigator.vendor === '' && navigator.userAgent.includes('Firefox')) return 'gecko';
+      return 'unknown';
+    })();
+    // flutter.js 默认 wasmAllowList: blink=true, gecko=false, webkit=false
+    const wasmAllowed = browserEngine === 'blink';
+
+    const picked = builds.find(b => {
+      if (b.compileTarget === 'dart2wasm' && !supportsWasmGC) return false;
+      if (b.renderer === 'skwasm' && (webglVersion === 0 || !wasmAllowed)) return false;
+      return true;
+    });
+
+    // —— 探测实际加载（runtime 监听） ——
+    const seen = new Set();
+    const obs = new PerformanceObserver((entries) => {
+      for (const e of entries.getEntries()) {
+        if (/main\.dart\.(wasm|mjs|js)|canvaskit\.|skwasm/.test(e.name)) {
+          seen.add(e.name.split(/[?#]/)[0].split('/').slice(-2).join('/'));
+        }
+      }
+    });
+    obs.observe({ type: 'resource', buffered: true });
+
+    // 把已有的 performance entries 也吃一遍（首次进页面之前已发生的）
+    performance.getEntriesByType('resource').forEach(e => {
+      if (/main\.dart\.(wasm|mjs|js)|canvaskit\.|skwasm/.test(e.name)) {
+        seen.add(e.name.split(/[?#]/)[0].split('/').slice(-2).join('/'));
+      }
+    });
+
+    // —— 渲染结论 ——
+    const loadedEl = document.getElementById('loaded');
+    [
+      ['browserEngine', browserEngine],
+      ['build config 优先项', picked ? `${picked.compileTarget} / ${picked.renderer}` : '<无匹配>'],
+      ['理论选中入口', picked?.mainWasmPath ?? picked?.mainJsPath ?? '-'],
+    ].forEach(([k, v]) => {
+      const row = document.createElement('tr');
+      row.innerHTML = `<td><b>${k}</b></td><td>${v}</td>`;
+      loadedEl.appendChild(row);
+    });
+
+    const verdict = document.getElementById('verdict');
+    if (picked?.compileTarget === 'dart2wasm') {
+      verdict.classList.add('wasm');
+      verdict.innerHTML = `<h2>✅ 走的是 WASM 路径</h2>` +
+        `<p>本次会加载 <code>main.dart.wasm</code> + <code>main.dart.mjs</code>，渲染器 <code>${picked.renderer}</code>。如果体感仍然慢，更可能是 Flutter 应用自身的工作量（首屏 widget 树、字体、PDF 渲染），而不是 wasm 没启用。</p>`;
+    } else if (picked) {
+      verdict.classList.add('js');
+      verdict.innerHTML = `<h2>⚠️ 走的是 JS fallback (dart2js)</h2>` +
+        `<p>本次将加载 <code>main.dart.js</code> + 渲染器 <code>${picked.renderer}</code>。原因看上方"浏览器能力"——任何一项 false 都会让 wasm 路径被淘汰。</p>` +
+        `<ul>` +
+        `<li>如果 <code>supportsWasmGC</code> false：浏览器版本不够新（Chrome 119+/Safari 18.2+/FF 120+）。</li>` +
+        `<li>如果 <code>webGLVersion</code> 是 0：硬件加速被关或者驱动有问题，skwasm 用不了 → 整套 wasm 路径被砍。</li>` +
+        `<li>如果 <code>crossOriginIsolated</code> false：服务器没配 COOP/COEP 头，skwasm 多线程会被禁。</li>` +
+        `<li>如果 <code>browserEngine</code> 是 webkit/gecko：flutter.js 默认 wasmAllowList 只允许 blink，要打开需要 <code>config.wasmAllowList</code>。</li>` +
+        `</ul>`;
+    } else {
+      verdict.classList.add('js');
+      verdict.innerHTML = `<h2>❌ build config 里没有匹配项</h2>`;
+    }
+
+    // 等几百毫秒让 flutter_bootstrap.js 真的开始加载
+    setTimeout(() => {
+      const raw = document.getElementById('raw');
+      raw.textContent = '已观测到的网络请求（资源名）：\n' +
+        Array.from(seen).sort().map(s => '  • ' + s).join('\n') +
+        '\n\nbuildConfig:\n' + JSON.stringify(buildConfig, null, 2);
+    }, 1500);
+  </script>
+
+  <h2>下一步</h2>
+  <p>访问 <code>http://localhost:5180/_diag.html</code> 即可看本机当前的判定。</p>
+</body>
+</html>

package/dist/app/.last_build_id

@@ -0,0 +1 @@
+5b8083240414b940c62baaaf71a3e977

package/dist/app/README.md

@@ -0,0 +1,49 @@
+# Web Build Notes
+
+`web/sqlite3.wasm` 与 `web/drift_worker.dart.js` 是 drift 在 Web 端跑 SQLite 必需的两份运行时资产，
+**直接入库**——版本必须与 `pubspec.lock` 里 `drift` / `sqlite3` 包对齐，统一管理省事且能避免本地版本漂移。
+
+## 升级流程
+
+升级 `drift` 或 `sqlite3` 后，按新版本号同步替换这两个文件，**与 pubspec 改动一并 commit**：
+
+```bash
+DRIFT_VERSION=$(awk '/^  drift:/,/version:/' pubspec.lock | tail -1 | tr -d ' "version:')
+SQLITE_VERSION=$(awk '/^  sqlite3:/,/version:/' pubspec.lock | tail -1 | tr -d ' "version:')
+
+curl -fsSL -o web/sqlite3.wasm \
+  "https://github.com/simolus3/sqlite3.dart/releases/download/sqlite3-${SQLITE_VERSION}/sqlite3.wasm"
+
+curl -fsSL -o web/drift_worker.dart.js \
+  "https://github.com/simolus3/drift/releases/download/drift-${DRIFT_VERSION}/drift_worker.js"
+```
+
+发布说明：
+- sqlite3：https://github.com/simolus3/sqlite3.dart/releases
+- drift：https://github.com/simolus3/drift/releases
+
+## 浏览器要求
+
+Web 端依赖 OPFS（Origin Private File System）做物理 PDF 落盘：
+- Chrome / Edge ≥ 102
+- Firefox ≥ 111
+- Safari ≥ 16
+
+低于此版本启动后第一次访问 OPFS 会抛错，文件库无法使用。
+
+## 性能小贴士
+
+按 drift 文档建议，给 dev server 加跨源隔离响应头能让 OPFS 走更快的 SharedArrayBuffer 路径：
+
+```bash
+flutter run -d chrome \
+  --web-header=Cross-Origin-Opener-Policy=same-origin \
+  --web-header=Cross-Origin-Embedder-Policy=require-corp
+```
+
+不加也能跑，只是稍慢。
+
+## 已知限制
+
+- 桌面端的 `window_manager`（窗口尺寸记忆等）在 Web 上完全跳过，由浏览器自身管理。
+- `PdfViewer.data` 进 reader 前要把整份 PDF 读进内存，>100MB 大文档会卡。

package/dist/app/assets/AssetManifest.bin

@@ -0,0 +1 @@
+

package/dist/app/assets/AssetManifest.bin.json

@@ -0,0 +1 @@
+"DQgHHWFzc2V0cy9icmFuZGluZy9hcHBfYnJhbmQucG5nDAENAQcFYXNzZXQHHWFzc2V0cy9icmFuZGluZy9hcHBfYnJhbmQucG5nBx5hc3NldHMvZm9udHMvTWlTYW5zLU1lZGl1bS50dGYMAQ0BBwVhc3NldAceYXNzZXRzL2ZvbnRzL01pU2Fucy1NZWRpdW0udHRmBx9hc3NldHMvZm9udHMvTWlTYW5zLVJlZ3VsYXIudHRmDAENAQcFYXNzZXQHH2Fzc2V0cy9mb250cy9NaVNhbnMtUmVndWxhci50dGYHIGFzc2V0cy9mb250cy9NaVNhbnMtU2VtaWJvbGQudHRmDAENAQcFYXNzZXQHIGFzc2V0cy9mb250cy9NaVNhbnMtU2VtaWJvbGQudHRmByFwYWNrYWdlcy9wZGZyeC9hc3NldHMvcGRmaXVtLndhc20MAQ0BBwVhc3NldAchcGFja2FnZXMvcGRmcngvYXNzZXRzL3BkZml1bS53YXNtByZwYWNrYWdlcy9wZGZyeC9hc3NldHMvcGRmaXVtX2NsaWVudC5qcwwBDQEHBWFzc2V0ByZwYWNrYWdlcy9wZGZyeC9hc3NldHMvcGRmaXVtX2NsaWVudC5qcwcmcGFja2FnZXMvcGRmcngvYXNzZXRzL3BkZml1bV93b3JrZXIuanMMAQ0BBwVhc3NldAcmcGFja2FnZXMvcGRmcngvYXNzZXRzL3BkZml1bV93b3JrZXIuanMHPXBhY2thZ2VzL3RvYXN0aWZpY2F0aW9uL2Fzc2V0cy9mb250cy9Ub2FzdGlmaWNhdGlvbl9pY29ucy50dGYMAQ0BBwVhc3NldAc9cGFja2FnZXMvdG9hc3RpZmljYXRpb24vYXNzZXRzL2ZvbnRzL1RvYXN0aWZpY2F0aW9uX2ljb25zLnR0Zg=="

package/dist/app/assets/FontManifest.json

@@ -0,0 +1 @@
+[{"family":"MaterialIcons","fonts":[{"asset":"fonts/MaterialIcons-Regular.otf"}]},{"family":"MiSans","fonts":[{"weight":400,"asset":"assets/fonts/MiSans-Regular.ttf"},{"weight":500,"asset":"assets/fonts/MiSans-Medium.ttf"},{"weight":600,"asset":"assets/fonts/MiSans-Semibold.ttf"}]},{"family":"packages/toastification/Toastification_icons","fonts":[{"asset":"packages/toastification/assets/fonts/Toastification_icons.ttf"}]}]