@yyyu-star/arcade-kit 0.13.1 → 0.15.0

package/src/qr.ts

@@ -0,0 +1,259 @@
+/**
+ * 最小的二维码编码器（0.15.0，分享卡右下角的码）：只做字节模式、纠错等级 M、版本 1–10（最多 213 字节，链接够用）。
+ * 自己写而不引依赖：kit 没有运行时依赖，引一个包就进了每个游戏的 lockfile 和审阅范围；要的子集只有这么点，规范见 ISO/IEC 18004。
+ * 纯函数，不碰 DOM；画在哪、画多大由 share.ts 决定。测试用解码库把码解回原文（test/qr.test.ts）。
+ */
+
+/** size × size 的格子，true 是深色。外面的留白（4 格）不在里面，画的时候自己留 */
+export interface QrMatrix {
+  size: number;
+  version: number;
+  dark: boolean[][];
+}
+
+/** 纠错 M：每个版本的 [每块纠错码字数, 第一组块数, 第一组每块数据码字数, 第二组块数]（第二组每块多 1 个数据码字） */
+const BLOCKS_M: readonly (readonly [number, number, number, number])[] = [
+  [10, 1, 16, 0],
+  [16, 1, 28, 0],
+  [26, 1, 44, 0],
+  [18, 2, 32, 0],
+  [24, 2, 43, 0],
+  [16, 4, 27, 0],
+  [18, 4, 31, 0],
+  [22, 2, 38, 2],
+  [22, 3, 36, 2],
+  [26, 4, 43, 1],
+];
+export const QR_MAX_VERSION = BLOCKS_M.length;
+
+/** 校正图形的中心坐标（版本 2 起） */
+const ALIGN: readonly (readonly number[])[] = [[], [6, 18], [6, 22], [6, 26], [6, 30], [6, 34], [6, 22, 38], [6, 24, 42], [6, 26, 46], [6, 28, 50]];
+
+function dataCodewords(v: number): number {
+  const [, b1, d1, b2] = BLOCKS_M[v - 1]!;
+  return b1 * d1 + b2 * (d1 + 1);
+}
+
+/** 编码一段文字（UTF-8）。放不下（超过版本 10）返回 null，调用方就不画码 */
+export function qrEncode(text: string): QrMatrix | null {
+  const bytes = new TextEncoder().encode(text);
+  let version = 0;
+  for (let v = 1; v <= QR_MAX_VERSION; v++) {
+    const countBits = v < 10 ? 8 : 16;
+    if (4 + countBits + bytes.length * 8 <= dataCodewords(v) * 8) {
+      version = v;
+      break;
+    }
+  }
+  if (!version) return null;
+  const data = interleave(version, pack(bytes, version));
+  return place(version, data);
+}
+
+/** 模式指示 0100（字节）+ 长度 + 数据 + 结束符 + 补齐 */
+function pack(bytes: Uint8Array, v: number): number[] {
+  const bits: number[] = [];
+  const put = (val: number, n: number): void => {
+    for (let i = n - 1; i >= 0; i--) bits.push((val >>> i) & 1);
+  };
+  put(4, 4);
+  put(bytes.length, v < 10 ? 8 : 16);
+  for (const b of bytes) put(b, 8);
+  const cap = dataCodewords(v) * 8;
+  put(0, Math.min(4, cap - bits.length));
+  put(0, (8 - (bits.length % 8)) % 8);
+  const out: number[] = [];
+  for (let i = 0; i < bits.length; i += 8) out.push(bits.slice(i, i + 8).reduce((a, b) => (a << 1) | b, 0));
+  for (let pad = 0xec; out.length < cap / 8; pad ^= 0xec ^ 0x11) out.push(pad);
+  return out;
+}
+
+// GF(256)，本原多项式 0x11d
+function gfMul(a: number, b: number): number {
+  let r = 0;
+  for (let i = 7; i >= 0; i--) {
+    r = (r << 1) ^ ((r >>> 7) * 0x11d);
+    r ^= ((b >>> i) & 1) * a;
+  }
+  return r & 0xff;
+}
+
+/** RS 生成多项式（最高次项系数 1 省略） */
+function rsGenerator(degree: number): number[] {
+  const g = new Array<number>(degree).fill(0);
+  g[degree - 1] = 1;
+  let root = 1;
+  for (let i = 0; i < degree; i++) {
+    for (let j = 0; j < degree; j++) {
+      g[j] = gfMul(g[j]!, root) ^ (j + 1 < degree ? g[j + 1]! : 0);
+    }
+    root = gfMul(root, 2);
+  }
+  return g;
+}
+
+function rsRemainder(data: readonly number[], gen: readonly number[]): number[] {
+  const r = new Array<number>(gen.length).fill(0);
+  for (const b of data) {
+    const f = b ^ r.shift()!;
+    r.push(0);
+    gen.forEach((c, i) => (r[i] = r[i]! ^ gfMul(c, f)));
+  }
+  return r;
+}
+
+/** 分块、算纠错码、交错排列 */
+function interleave(v: number, data: readonly number[]): number[] {
+  const [ec, b1, d1, b2] = BLOCKS_M[v - 1]!;
+  const gen = rsGenerator(ec);
+  const blocks: number[][] = [];
+  let k = 0;
+  for (let i = 0; i < b1 + b2; i++) {
+    const len = d1 + (i < b1 ? 0 : 1);
+    blocks.push(data.slice(k, k + len));
+    k += len;
+  }
+  const ecs = blocks.map((b) => rsRemainder(b, gen));
+  const out: number[] = [];
+  for (let i = 0; i <= d1; i++) for (const b of blocks) if (i < b.length) out.push(b[i]!);
+  for (let i = 0; i < ec; i++) for (const e of ecs) out.push(e[i]!);
+  return out;
+}
+
+const MASKS: readonly ((x: number, y: number) => boolean)[] = [
+  (x, y) => (x + y) % 2 === 0,
+  (_x, y) => y % 2 === 0,
+  (x) => x % 3 === 0,
+  (x, y) => (x + y) % 3 === 0,
+  (x, y) => (Math.floor(x / 3) + Math.floor(y / 2)) % 2 === 0,
+  (x, y) => ((x * y) % 2) + ((x * y) % 3) === 0,
+  (x, y) => (((x * y) % 2) + ((x * y) % 3)) % 2 === 0,
+  (x, y) => (((x + y) % 2) + ((x * y) % 3)) % 2 === 0,
+];
+
+/** 画功能图形、填数据、挑罚分最低的掩码 */
+function place(version: number, data: readonly number[]): QrMatrix {
+  const size = version * 4 + 17;
+  const dark = Array.from({ length: size }, () => new Array<boolean>(size).fill(false));
+  const fixed = Array.from({ length: size }, () => new Array<boolean>(size).fill(false));
+  const set = (x: number, y: number, on: boolean): void => {
+    dark[y]![x] = on;
+    fixed[y]![x] = true;
+  };
+  for (let i = 0; i < size; i++) {
+    set(6, i, i % 2 === 0);
+    set(i, 6, i % 2 === 0);
+  }
+  for (const [cx, cy] of [[3, 3], [size - 4, 3], [3, size - 4]] as const) {
+    for (let dy = -4; dy <= 4; dy++) {
+      for (let dx = -4; dx <= 4; dx++) {
+        const x = cx + dx;
+        const y = cy + dy;
+        const d = Math.max(Math.abs(dx), Math.abs(dy));
+        if (x >= 0 && x < size && y >= 0 && y < size) set(x, y, d !== 2 && d !== 4);
+      }
+    }
+  }
+  const al = ALIGN[version - 1]!;
+  al.forEach((ay, i) =>
+    al.forEach((ax, j) => {
+      const last = al.length - 1;
+      if ((i === 0 && j === 0) || (i === 0 && j === last) || (i === last && j === 0)) return;
+      for (let dy = -2; dy <= 2; dy++) for (let dx = -2; dx <= 2; dx++) set(ax + dx, ay + dy, Math.max(Math.abs(dx), Math.abs(dy)) !== 1);
+    }),
+  );
+  formatBits(set, size, 0); // 先占位，挑好掩码再写真的
+  if (version >= 7) {
+    let rem = version;
+    for (let i = 0; i < 12; i++) rem = (rem << 1) ^ ((rem >>> 11) * 0x1f25);
+    const bits = (version << 12) | rem;
+    for (let i = 0; i < 18; i++) {
+      const on = ((bits >>> i) & 1) === 1;
+      const a = size - 11 + (i % 3);
+      const b = Math.floor(i / 3);
+      set(a, b, on);
+      set(b, a, on);
+    }
+  }
+  // 数据：从右下角起两列一组，蛇形上下走，跳过第 6 列（竖的定时线）
+  let i = 0;
+  for (let right = size - 1; right >= 1; right -= 2) {
+    if (right === 6) right = 5;
+    for (let vert = 0; vert < size; vert++) {
+      for (let j = 0; j < 2; j++) {
+        const x = right - j;
+        const y = ((right + 1) & 2) === 0 ? size - 1 - vert : vert;
+        if (!fixed[y]![x] && i < data.length * 8) {
+          dark[y]![x] = ((data[i >>> 3]! >>> (7 - (i & 7))) & 1) === 1;
+          i++;
+        }
+      }
+    }
+  }
+  let best = 0;
+  let bestScore = Infinity;
+  for (let m = 0; m < MASKS.length; m++) {
+    const trial = dark.map((row, y) => row.map((on, x) => (fixed[y]![x] ? on : on !== MASKS[m]!(x, y))));
+    formatBits((x, y, on) => (trial[y]![x] = on), size, m);
+    const s = penalty(trial);
+    if (s < bestScore) {
+      bestScore = s;
+      best = m;
+    }
+  }
+  const out = dark.map((row, y) => row.map((on, x) => (fixed[y]![x] ? on : on !== MASKS[best]!(x, y))));
+  formatBits((x, y, on) => (out[y]![x] = on), size, best);
+  return { size, version, dark: out };
+}
+
+/** 格式信息（纠错 M = 00 + 掩码号，BCH 后异或 0x5412），两份；外加那个固定的深色格 */
+function formatBits(set: (x: number, y: number, on: boolean) => void, size: number, mask: number): void {
+  const data = mask; // M 的两位是 00
+  let rem = data;
+  for (let i = 0; i < 10; i++) rem = (rem << 1) ^ ((rem >>> 9) * 0x537);
+  const bits = ((data << 10) | rem) ^ 0x5412;
+  const bit = (i: number): boolean => ((bits >>> i) & 1) === 1;
+  for (let i = 0; i <= 5; i++) set(8, i, bit(i));
+  set(8, 7, bit(6));
+  set(8, 8, bit(7));
+  set(7, 8, bit(8));
+  for (let i = 9; i < 15; i++) set(14 - i, 8, bit(i));
+  for (let i = 0; i < 8; i++) set(size - 1 - i, 8, bit(i));
+  for (let i = 8; i < 15; i++) set(8, size - 15 + i, bit(i));
+  set(8, size - 8, true);
+}
+
+/** 掩码罚分（规范的四条），越低越好扫 */
+function penalty(m: boolean[][]): number {
+  const size = m.length;
+  let score = 0;
+  const lines: boolean[][] = [];
+  for (let y = 0; y < size; y++) lines.push(m[y]!, m.map((row) => row[y]!));
+  const finderLike = /10111010000|00001011101/g;
+  for (const line of lines) {
+    let run = 1;
+    for (let i = 1; i <= size; i++) {
+      if (i < size && line[i] === line[i - 1]) run++;
+      else {
+        if (run >= 5) score += run - 2;
+        run = 1;
+      }
+    }
+    // 外面算浅色：两头各补 4 个浅格再找像定位图形的那一串
+    const s = `0000${line.map((on) => (on ? 1 : 0)).join('')}0000`;
+    score += (s.match(finderLike)?.length ?? 0) * 40;
+  }
+  let darkCount = 0;
+  for (let y = 0; y < size; y++) {
+    for (let x = 0; x < size; x++) {
+      if (m[y]![x]) darkCount++;
+      if (x + 1 < size && y + 1 < size) {
+        const c = m[y]![x];
+        if (m[y]![x + 1] === c && m[y + 1]![x] === c && m[y + 1]![x + 1] === c) score += 3;
+      }
+    }
+  }
+  const total = size * size;
+  score += Math.max(0, Math.ceil(Math.abs(darkCount * 20 - total * 10) / total) - 1) * 10;
+  return score;
+}

package/src/room.ts

@@ -18,7 +18,7 @@
  */
 import { DurableObject } from 'cloudflare:workers';
 import type { RoomEffect, RoomGame, RoomSetup } from './game.js';
-import { type Identity, KIT_HOST, meterStub, parseIdentity } from './internal.js';
+import { type Identity, KIT_HOST, LIMITED_HEADER, MISS_HEADER, meterStub, parseIdentity } from './internal.js';
 import type { MeterEnv, MeterLevel, RoomMeter } from './meter.js';
 import { ENTROPY_WORDS } from './rng.js';
 import {
@@ -60,7 +60,9 @@ export interface RoomLimits {
    * 这些重连同时算进 maxInbound，房间一生的写入总数有上限
    */
   maxJoins: number;
-  /** 没入座的连接最多几条（来看的、还没选座位的），超了 4003。入座的人不占这个数，掉线回来总能进 */
+  /**
+   * 没入座的人最多几个（来看的、还没选座位的），超了 4003。按账号算（0.14.0，以前按连接）；入座的人、房主、开打后绑过座位的人不占这个数，掉线回来总能进
+   */
   extraConnections: number;
   /** 房间最长寿命 */
   maxLifeMs: number;
@@ -311,7 +313,8 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
   private alarmToSet: number | null = null;
   private pendingInbound = 0;
   private readonly pendingBy = new Map<string, number>();
-  private readonly buckets = new WeakMap<WebSocket, { tokens: number; at: number }>();
+  /** 入站消息的令牌桶，按 userId 记（0.14.0；以前按连接，断开重连就换一个满的桶，第三轮审计） */
+  private readonly buckets = new Map<string, { tokens: number; at: number }>();
   /** 每个座位快捷短语的令牌桶（内存里；被驱逐就重置成满的，驱逐前至少空闲了一阵，本来也该满了） */
   private readonly emoteBuckets = new Map<number, { tokens: number; at: number }>();
   private emoteRateCache: EmoteRate | null = null;
@@ -389,6 +392,8 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
     }
     const me = parseIdentity(request.headers.get('x-kit-user'));
     if (!me) return new Response('no identity', { status: 401 });
+    // 猜码超了门槛（0.14.0）：自己人照常进（断线重连不受牵连），别人不管房间在不在都回 1013，说不出房间在不在
+    if (request.headers.has(LIMITED_HEADER) && !this.insider(me.userId)) return this.refuse(CLOSE.tryLater);
     const gate = await this.newcomerGate(me.userId);
     if (gate !== null) return this.refuse(gate);
     return this.entry(() => this.join(me, url.searchParams.get('cv')));
@@ -639,7 +644,8 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
     const st = this.load();
     if (!st) {
       server.close(CLOSE.noRoom, 'no room');
-      return done();
+      // 告诉 acceptJoin 这是一次"码不存在"（0.14.0，进房猜码按人、按 IP 计数）；它转给浏览器前去掉这个头
+      return new Response(null, { status: 101, webSocket: client, headers: { [MISS_HEADER]: '1' } });
     }
     if (st.ending) {
       server.close(CLOSE.roomClosed, st.ending.reason);
@@ -653,10 +659,12 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
     const seat = this.seatOf(me.userId);
     const others = this.sockets().filter((o) => o !== server && attachmentOf(o));
     const mine = others.filter((o) => attachmentOf(o)!.userId === me.userId);
-    if (seat === null) {
-      // 没入座的连接单独封顶；入座的人不占这个数，旁观的再多也挡不住座位的主人回来
-      const watching = others.filter((o) => o !== server && this.seatOf(attachmentOf(o)!.userId) === null && !mine.includes(o));
-      if (watching.length >= this.limits.extraConnections) {
+    if (seat === null && !this.ownsRoom(st, me.userId)) {
+      // 没入座的单独封顶；入座的人不占这个数，旁观的再多也挡不住座位的主人回来。
+      // 0.14.0（第三轮审计）：按账号数不按连接数（一个人开几个标签页只占一个），房主和开打后绑过座位的人（离座去看的）不占也不受这个限，
+      // 不然几个陌生账号就能占满名额，让房主的朋友连进来选座都进不来
+      const watchers = new Set(others.map((o) => attachmentOf(o)!.userId).filter((u) => u !== me.userId && this.seatOf(u) === null && !this.ownsRoom(st, u)));
+      if (watchers.size >= this.limits.extraConnections) {
         server.close(CLOSE.full, 'room full');
         return done();
       }
@@ -718,7 +726,7 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
     if (!st || !me || st.ending) return void ws.close(CLOSE.roomClosed, 'room closed');
     const bytes = typeof message === 'string' ? new TextEncoder().encode(message).byteLength : message.byteLength;
     if (bytes > this.limits.maxMessageBytes) return void ws.close(CLOSE.tooBig, 'message too big');
-    if (!this.takeToken(ws)) return void ws.close(CLOSE.policy, 'too fast');
+    if (!this.takeToken(me.userId)) return void ws.close(CLOSE.policy, 'too fast');
     const counted = this.countInbound(st, me.userId);
     if (counted === 'user') return void ws.close(CLOSE.userQuota, 'too many messages');
     if (counted === 'room') return this.closeRoom();
@@ -1600,6 +1608,17 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
     };
   }
 
+  /** 这个房间的自己人：房主、坐着的、开打后绑过座位的。猜码超限时只放他们进（0.14.0） */
+  private insider(userId: string): boolean {
+    const st = this.load();
+    return !!st && (st.host === userId || this.seatOf(userId) !== null || this.boundOf(userId) !== null);
+  }
+
+  /** 房主，或者开打后绑过座位的人：旁观名额不算他们（0.14.0） */
+  private ownsRoom(st: Persist<S>, userId: string): boolean {
+    return st.host === userId || st.owners.includes(userId);
+  }
+
   /** 这个人开打后绑定的座位（离座了也还是它）；还没开打、没坐过为 null。 */
   private boundOf(userId: string): number | null {
     const i = this.st!.owners.indexOf(userId);
@@ -1660,15 +1679,18 @@ export abstract class GameRoom<S, A, V, Env = unknown, O = unknown, E extends Ro
     this.send(ws, { t: 'error', code, ...(moveId ? { moveId } : {}) });
   }
 
-  /** 每个连接一个令牌桶（内存里；被驱逐后重置成满的，驱逐前至少空闲了一阵，本来也该满了）。 */
-  private takeToken(ws: WebSocket): boolean {
+  /**
+   * 每个人一个令牌桶（内存里；被驱逐后重置成满的，驱逐前至少空闲了一阵，本来也该满了）。
+   * 按人不按连接（0.14.0）：断开重连、多开几个标签页都还是同一个桶，刷不出新的 burst
+   */
+  private takeToken(userId: string): boolean {
     const now = Date.now();
-    const b = this.buckets.get(ws) ?? { tokens: this.limits.rateBurst, at: now };
+    const b = this.buckets.get(userId) ?? { tokens: this.limits.rateBurst, at: now };
     b.tokens = Math.min(this.limits.rateBurst, b.tokens + ((now - b.at) / 1000) * this.limits.ratePerSec);
     b.at = now;
     if (b.tokens < 1) return false;
     b.tokens -= 1;
-    this.buckets.set(ws, b);
+    this.buckets.set(userId, b);
     return true;
   }
 }

package/src/share.ts

@@ -5,7 +5,11 @@
  * - 游戏只交数据（`ShareCard`），画法统一在这里，几个游戏风格一致；kit 不认识任何游戏，名字、图标、主题色都由游戏给。
  * - 这个文件只在调用时碰 DOM，import 时不碰（房间、测试里 import 没事）；排版的算法是纯函数，测试在 test/share.test.ts。
  * - 图上只有游戏给的数据：别人的隐藏信息（没摊的底牌、手牌）游戏自己别放进来。
+ * - 右下角的二维码（0.15.0）：朋友圈里的图不能点，扫码是唯一入口。内容是运行时的 location.origin 加上 opts.url 的路径，
+ *   kit 和游戏都不写域名；编码器是 qr.ts（自己写的最小子集，不引依赖）。
+ * - 微信内置浏览器（0.15.0）：没有 navigator.share，下载链接也常常不生效，预览图改用 data: URL（blob: 的图长按经常存不下来），提示改成长按。
  */
+import { qrEncode } from './qr.js';
 
 /** 卡的尺寸：竖版 4:5，社交软件里不被裁 */
 export const CARD_W = 1080;
@@ -161,6 +165,39 @@ export function artRect(
   return [sx, sy, sw, sh, box.x + (box.w - dw) / 2, box.y + (box.h - dh) / 2, dw, dh];
 }
 
+/**
+ * 码里和分享出去的链接（0.15.0）：只认运行时的 origin，游戏给的 url 只取路径、查询和 # 后面的部分。
+ * 这样 kit 和游戏里都不写域名，单独部署的游戏（workers.dev）扫出来也是它自己
+ */
+export function shareLink(url: string, origin: string): string {
+  const u = new URL(url, `${origin}/`);
+  return `${origin}${u.pathname}${u.search}${u.hash}`;
+}
+
+/** 系统分享的文字末尾带上链接（0.15.0）：有的 App 只取 text、不取 url */
+export function shareText(text: string, link: string): string {
+  return text.includes(link) ? text : `${text} ${link}`;
+}
+
+/** 微信内置浏览器（UA 带 MicroMessenger，含企业微信） */
+export function isWeChat(ua: string): boolean {
+  return /MicroMessenger/i.test(ua);
+}
+
+/** 预览层怎么出（0.15.0）：微信里用 data: URL、提示长按、不给"保存图片"；别的浏览器照旧 */
+export function previewMode(ua: string): { dataUrl: boolean; tip: string; save: boolean } {
+  return isWeChat(ua)
+    ? { dataUrl: true, tip: '长按图片 → 发送给朋友，或保存后发朋友圈', save: false }
+    : { dataUrl: false, tip: '手机上也可以长按图片保存', save: true };
+}
+
+/** 二维码在卡上的框：白底留白 ≥ 4 格（扫码的规范要求），每格整数像素、对齐像素，截图后也清楚 */
+export const QR_BOX = 248;
+export function qrLayout(size: number, box = QR_BOX): { cell: number; pad: number } {
+  const cell = Math.max(1, Math.floor(box / (size + 8)));
+  return { cell, pad: Math.floor((box - cell * size) / 2) };
+}
+
 // ───────────── 画（只在调用时碰 DOM） ─────────────
 
 const FONT = '"PingFang SC","Hiragino Sans GB","Microsoft YaHei","Noto Sans CJK SC","Source Han Sans SC",system-ui,sans-serif';
@@ -211,9 +248,16 @@ function fitFont(ctx: CanvasRenderingContext2D, text: string, weight: string, si
   return s;
 }
 
-/** 画一张卡。canvas 不给就新建一个 1080×1350 的 */
-export async function drawShareCard(input: ShareCard, canvas?: HTMLCanvasElement): Promise<HTMLCanvasElement> {
+/**
+ * 画一张卡。canvas 不给就新建一个 1080×1350 的。link 给了（0.15.0，prepareShare 用 shareLink 算好的）就在右下角画二维码，
+ * 太长编不了码就不画
+ */
+export async function drawShareCard(input: ShareCard, canvas?: HTMLCanvasElement, link?: string): Promise<HTMLCanvasElement> {
   const c = normalizeCard(input);
+  const qr = link ? qrEncode(link) : null;
+  // 二维码的白框：右下角，压在底栏上；名场面和日期往左让
+  const qx = CARD_W - 72 - QR_BOX;
+  const qy = CARD_H - 40 - QR_BOX - 44;
   const cv = canvas ?? document.createElement('canvas');
   cv.width = CARD_W;
   cv.height = CARD_H;
@@ -302,24 +346,28 @@ export async function drawShareCard(input: ShareCard, canvas?: HTMLCanvasElement
   if (c.line) {
     ctx.fillStyle = '#ffffff';
     ctx.font = `700 50px ${FONT}`;
-    const lines = wrapLines(`“${c.line}”`, W - 2 * M - 40, (s) => ctx.measureText(s).width, 2);
-    lines.forEach((l, i) => ctx.fillText(l, W / 2, 1065 + i * 66));
+    const lw = qr ? qx - 32 - M : W - 2 * M - 40;
+    const lines = wrapLines(`“${c.line}”`, lw, (s) => ctx.measureText(s).width, 2);
+    lines.forEach((l, i) => ctx.fillText(l, qr ? M + lw / 2 : W / 2, 1065 + i * 66));
   }
 
   // 底：昵称、称号、日期
   ctx.fillStyle = 'rgba(0,0,0,0.22)';
   ctx.fillRect(0, CARD_H - 150, W, 150);
+  ctx.font = `600 38px ${FONT}`;
+  const dateRight = qr ? qx - 28 : W - M;
+  const dateLeft = dateRight - ctx.measureText(cardDate(c.date)).width;
   ctx.textAlign = 'left';
   ctx.fillStyle = '#ffffff';
   if (c.player) {
-    fitFont(ctx, c.player.name, '800', 50, W * 0.5, 32);
+    fitFont(ctx, c.player.name, '800', 50, Math.min(W * 0.5, dateLeft - 24 - M), 32);
     ctx.fillText(c.player.name, M, CARD_H - 62);
     if (c.player.badge) {
       const nw = ctx.measureText(c.player.name).width;
       ctx.font = `700 34px ${FONT}`;
       const bw = ctx.measureText(c.player.badge).width + 36;
       const bx = M + nw + 24;
-      if (bx + bw < W * 0.72) {
+      if (bx + bw < Math.min(W * 0.72, dateLeft - 16)) {
         round(ctx, bx, CARD_H - 104, bw, 54, 27);
         ctx.fillStyle = shade(c.accent, 0.75);
         ctx.fill();
@@ -331,20 +379,39 @@ export async function drawShareCard(input: ShareCard, canvas?: HTMLCanvasElement
   ctx.textAlign = 'right';
   ctx.fillStyle = 'rgba(255,255,255,0.8)';
   ctx.font = `600 38px ${FONT}`;
-  ctx.fillText(cardDate(c.date), W - M, CARD_H - 62);
+  ctx.fillText(cardDate(c.date), dateRight, CARD_H - 62);
+
+  if (qr) {
+    // 纯白底、近黑的格，不叠阴影和渐变：对比度够，手机截图压缩后照样扫得出
+    ctx.fillStyle = '#ffffff';
+    round(ctx, qx, qy, QR_BOX, QR_BOX + 44, 24);
+    ctx.fill();
+    const { cell, pad } = qrLayout(qr.size);
+    ctx.fillStyle = '#111111';
+    for (let y = 0; y < qr.size; y++) {
+      for (let x = 0; x < qr.size; x++) if (qr.dark[y]![x]) ctx.fillRect(qx + pad + x * cell, qy + pad + y * cell, cell, cell);
+    }
+    ctx.fillStyle = '#444444';
+    ctx.textAlign = 'center';
+    ctx.font = `700 28px ${FONT}`;
+    ctx.fillText('扫码来玩', qx + QR_BOX / 2, qy + QR_BOX + 22);
+  }
   return cv;
 }
 
-/** 画成 PNG */
-export async function shareCardBlob(card: ShareCard): Promise<Blob> {
-  const cv = await drawShareCard(card);
+/** 画成 PNG；link 见 drawShareCard */
+export async function shareCardBlob(card: ShareCard, link?: string): Promise<Blob> {
+  const cv = await drawShareCard(card, undefined, link);
   return new Promise((resolve, reject) => cv.toBlob((b) => (b ? resolve(b) : reject(new Error('toBlob failed'))), 'image/png'));
 }
 
 export interface ShareOptions {
-  /** 分享出去的链接：游戏地址，好友房结算带房间码 */
+  /**
+   * 分享出去的链接：游戏地址，好友房结算带房间码。只用它的路径、查询和 # 后面的部分，前面一律换成运行时的 location.origin（0.15.0），
+   * 写相对路径（`./?room=123456`）或绝对地址都行；卡上的二维码、系统分享、"复制链接"用的都是换过的这一个
+   */
   url: string;
-  /** 系统分享里的一句话，默认用卡的游戏名和大数字拼 */
+  /** 系统分享里的一句话，默认用卡的游戏名和大数字拼；末尾自动带上链接（0.15.0） */
   text?: string;
   /** 存图的文件名，默认 share.png */
   fileName?: string;
@@ -375,10 +442,13 @@ export interface PreparedShare {
  */
 export function prepareShare(card: ShareCard, opts: ShareOptions): PreparedShare {
   const name = opts.fileName ?? 'share.png';
-  const text = opts.text ?? `${card.game} · ${card.big.label} ${card.big.value}`;
+  // 没有 DOM（房间、测试里）时 location 也没有：链接照原样，画卡那一步本来就会失败
+  const link = typeof location === 'undefined' ? opts.url : shareLink(opts.url, location.origin);
+  const text = shareText(opts.text ?? `${card.game} · ${card.big.label} ${card.big.value}`, link);
+  const o: ShareOptions = { ...opts, url: link };
   let blob: Blob | null = null;
   let failed: unknown = null;
-  const ready = shareCardBlob(card).then(
+  const ready = shareCardBlob(card, link).then(
     (b) => {
       blob = b;
     },
@@ -388,8 +458,9 @@ export function prepareShare(card: ShareCard, opts: ShareOptions): PreparedShare
   );
   const attempt = (b: Blob): Promise<ShareResult> => {
     const nav = navigator as Navigator & { canShare?: (d: ShareData) => boolean };
-    if (typeof File === 'function' && typeof nav.share === 'function') {
-      const data: ShareData = { files: [new File([b], name, { type: 'image/png' })], title: card.game, text, url: opts.url };
+    // 微信里不试系统分享（没有，或者有也发不出图），直接出长按的预览
+    if (!isWeChat(nav.userAgent) && typeof File === 'function' && typeof nav.share === 'function') {
+      const data: ShareData = { files: [new File([b], name, { type: 'image/png' })], title: card.game, text, url: link };
       if (nav.canShare?.(data)) {
         // 同步调（这一行之前没有 await）：点击的激活还在
         return nav.share(data).then(
@@ -400,13 +471,13 @@ export function prepareShare(card: ShareCard, opts: ShareOptions): PreparedShare
           (e: { name?: string }) => {
             if (e?.name === 'AbortError') return 'cancelled' as const;
             // 别的错（激活过期、权限、不支持的类型）：退回预览
-            showPreview(b, name, opts);
+            showPreview(b, name, o);
             return 'preview' as const;
           },
         );
       }
     }
-    showPreview(b, name, opts);
+    showPreview(b, name, o);
     return Promise.resolve('preview');
   };
   return {
@@ -431,27 +502,36 @@ export async function shareCard(card: ShareCard, opts: ShareOptions): Promise<Sh
   return p.share();
 }
 
-/** 不支持系统分享时：预览图 + "保存图片""复制链接"；点空白处或"关闭"收起 */
+/** 不支持系统分享时：预览图 + "保存图片""复制链接"；点空白处或"关闭"收起。微信里见 previewMode */
 function showPreview(blob: Blob, name: string, opts: ShareOptions): void {
   document.getElementById(PREVIEW_ID)?.remove();
-  const url = URL.createObjectURL(blob);
+  const mode = previewMode(navigator.userAgent);
+  // 微信里不用 blob:（长按存不下来），也就不建对象 URL
+  const url = mode.dataUrl ? '' : URL.createObjectURL(blob);
   const root = document.createElement('div');
   root.id = PREVIEW_ID;
   root.setAttribute('role', 'dialog');
   root.style.cssText = `position:fixed;inset:0;z-index:${opts.zIndex ?? 11000};display:flex;flex-direction:column;align-items:center;justify-content:center;gap:16px;padding:16px;box-sizing:border-box;background:rgba(0,0,0,.72);font:600 16px ${FONT};color:#fff`;
   const close = (): void => {
     root.remove();
-    URL.revokeObjectURL(url);
+    if (url) URL.revokeObjectURL(url);
   };
   root.addEventListener('click', (e) => {
     if (e.target === root) close();
   });
   const img = document.createElement('img');
-  img.src = url;
+  if (url) img.src = url;
+  else {
+    const reader = new FileReader();
+    reader.onload = () => {
+      if (typeof reader.result === 'string') img.src = reader.result;
+    };
+    reader.readAsDataURL(blob);
+  }
   img.alt = '战绩图';
   img.style.cssText = 'max-width:min(92vw,540px);max-height:calc(100% - 140px);border-radius:16px;box-shadow:0 8px 32px rgba(0,0,0,.5)';
   const tip = document.createElement('div');
-  tip.textContent = '手机上也可以长按图片保存';
+  tip.textContent = mode.tip;
   tip.style.cssText = 'font-size:13px;opacity:.75';
   const row = document.createElement('div');
   row.style.cssText = 'display:flex;gap:12px;flex-wrap:wrap;justify-content:center';
@@ -486,7 +566,7 @@ function showPreview(blob: Blob, name: string, opts: ShareOptions): void {
     else done(false);
   });
   const shut = btn('关闭', 'share:close', close);
-  row.appendChild(save);
+  if (mode.save) row.appendChild(save);
   row.appendChild(copy);
   row.appendChild(shut);
   root.appendChild(img);