codex-work-receipt 0.6.1 → 0.7.1

package/src/core/args.mjs

@@ -7,13 +7,16 @@ Codex AI Work Receipt
 Usage:
   npx codex-work-receipt@latest
   npx codex-work-receipt@latest --latest --lang en
+  npx codex-work-receipt@latest --hours 3 --lang en
   npx codex-work-receipt@latest --today --lang en
   npx codex-work-receipt@latest --range last-7-days --lang en
   npx codex-work-receipt@latest --range this-week --lang en
   npx codex-work-receipt@latest --install-skill --lang en
+  npx codex-work-receipt@latest --install-companion --lang en
 
 Options:
-  --range <name>              Range: latest, today, last-7-days, this-week
+  --range <name>              Range: latest, last-hours, today, last-7-days, this-week
+  --hours <number>            Summarize the last 1-168 hours
   --latest                    Summarize the latest active Codex session (default)
   --today                     Summarize all Codex activity from today
   --session <id>              Summarize one specific Codex session
@@ -23,6 +26,9 @@ Options:
   --output <file>             Set the generated HTML path
   --data-dir <directory>      Set the local structured-history directory
   --install-skill             Install the natural-language Codex skill
+  --install-pet               Install the Codex pet only
+  --uninstall-pet             Remove the installed Codex pet
+  --install-companion         Install both the skill and Codex pet
   --no-open                   Do not open the browser after generation
   --help                      Show help
 ` : `
@@ -31,13 +37,16 @@ Codex AI 打工小票
 用法：
   npx codex-work-receipt@latest
   npx codex-work-receipt@latest --latest
+  npx codex-work-receipt@latest --hours 3
   npx codex-work-receipt@latest --today
   npx codex-work-receipt@latest --range last-7-days
   npx codex-work-receipt@latest --range this-week
   npx codex-work-receipt@latest --install-skill
+  npx codex-work-receipt@latest --install-companion
 
 选项：
-  --range <name>              统计范围：latest、today、last-7-days、this-week
+  --range <name>              统计范围：latest、last-hours、today、last-7-days、this-week
+  --hours <number>            统计最近 1～168 小时
   --latest                    统计最近活跃的 Codex 会话（默认）
   --today                     统计本地时区今天发生的全部 Codex 活动
   --session <id>              统计指定的 Codex 会话
@@ -47,6 +56,9 @@ Codex AI 打工小票
   --output <file>             指定生成的 HTML 文件，默认写入 ./codex-work-receipt-output/
   --data-dir <directory>      指定本地结构数据目录
   --install-skill             安装可通过自然语言调用的 Codex Skill
+  --install-pet               只安装 Codex 桌宠
+  --uninstall-pet             卸载 AI 打工小票 Codex 桌宠
+  --install-companion         同时安装 Skill 和 Codex 桌宠
   --no-open                   生成后不自动打开浏览器
   --help                      显示帮助
 `);
@@ -57,12 +69,16 @@ export function parseArgs(argv) {
     mode: "latest",
     modeExplicit: false,
     sessionId: null,
+    hours: null,
     timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || "Asia/Shanghai",
     locale: "zh-CN",
     theme: "classic",
     output: null,
     dataDir: null,
     installSkill: false,
+    installPet: false,
+    uninstallPet: false,
+    installCompanion: false,
     open: true,
   };
 
@@ -73,6 +89,7 @@ export function parseArgs(argv) {
     ["--output", "output"],
     ["--data-dir", "dataDir"],
     ["--session", "sessionId"],
+    ["--hours", "hours"],
   ]);
 
   for (let index = 0; index < argv.length; index += 1) {
@@ -83,7 +100,10 @@ export function parseArgs(argv) {
     } else if (argument === "--today") {
       result.mode = "today";
       result.modeExplicit = true;
-    } else if (argument === "--range") {
+    } else if (argument === "--install-pet") result.installPet = true;
+    else if (argument === "--uninstall-pet") result.uninstallPet = true;
+    else if (argument === "--install-companion") result.installCompanion = true;
+    else if (argument === "--range") {
       const value = argv[++index];
       if (!value) throw new Error("--range 需要提供值");
       const scope = normalizeScope(value);
@@ -101,6 +121,9 @@ export function parseArgs(argv) {
       if (key === "sessionId") {
         result.mode = "session";
         result.modeExplicit = true;
+      } else if (key === "hours") {
+        result.mode = "last-hours";
+        result.modeExplicit = true;
       }
     } else throw new Error(`不认识的参数：${argument}`);
   }
@@ -111,5 +134,12 @@ export function parseArgs(argv) {
   if (!new Set(["zh-CN", "en"]).has(result.locale)) {
     throw new Error(`不支持的语言：${result.locale}`);
   }
+  if (result.hours !== null) {
+    result.hours = Number(result.hours);
+    if (!Number.isInteger(result.hours) || result.hours < 1 || result.hours > 168) {
+      throw new Error("--hours 需要 1 至 168 之间的整数");
+    }
+  }
+  if (result.mode === "last-hours" && result.hours === null) result.hours = 3;
   return result;
 }

package/src/core/fact-identity.mjs

@@ -28,12 +28,19 @@ export function buildLogicalReceiptKey(metrics) {
   if (metrics.mode === "latest" || metrics.mode === "session") {
     return `${metrics.mode}:${sessionPart}:${metrics.timezone}`;
   }
+  if (metrics.mode === "last-hours") {
+    return `last-hours:${metrics.windowHours}:${metrics.windowStartAt.toISOString()}:${metrics.windowEndAt.toISOString()}:${metrics.timezone}`;
+  }
   if (metrics.mode === "this-week") {
     return `this-week:${metrics.rangeStartDate}:${metrics.timezone}`;
   }
   return `${metrics.mode}:${metrics.rangeStartDate}:${metrics.rangeEndDate}:${metrics.timezone}`;
 }
 
+export function buildSummaryReceiptId(logicalReceiptKey) {
+  return stableId("cwr", "codex-work-receipt/receipt/v1", [logicalReceiptKey]);
+}
+
 export function buildProtocolReceiptId(sourceVersion, logicalReceiptKey) {
   return stableId("cwr2", "codex-work-receipt/receipt/v2", [sourceVersion, logicalReceiptKey]);
 }

package/src/core/metrics.mjs

@@ -1,5 +1,10 @@
 import { dateKey, rowDate } from "../lib/time.mjs";
-import { calendarDayCount, isCalendarScope, isDateInRange } from "./range.mjs";
+import {
+  calendarDayCount,
+  isCalendarScope,
+  isDateInRange,
+  isTimeWindowScope,
+} from "./range.mjs";
 import { selectWorkProfileId } from "./presentation.mjs";
 
 function zeroUsage() {
@@ -28,7 +33,8 @@ function sessionTokenUsage(rows, range) {
   for (const row of events) {
     const currentUsage = row.payload.info.total_token_usage;
     const date = rowDate(row);
-    const selected = !isCalendarScope(range.scope) || isDateInRange(date, range);
+    const selected = (!isCalendarScope(range.scope) && !isTimeWindowScope(range.scope))
+      || isDateInRange(date, range);
 
     for (const key of Object.keys(totals)) {
       const current = Math.max(0, Number(currentUsage[key] || 0));
@@ -56,6 +62,7 @@ function calculateWorkPoints(metrics) {
 }
 
 function emptyRangeMessage(range) {
+  if (range.scope === "last-hours") return `最近 ${range.hours} 小时没有找到 Codex 活动`;
   if (range.scope === "today") return `没有找到 ${range.targetDate} 的 Codex 活动`;
   if (range.scope === "last-7-days") return `没有找到 ${range.startDate} 至 ${range.endDate} 的 Codex 活动`;
   if (range.scope === "this-week") return `本周暂时没有找到 Codex 活动`;
@@ -78,7 +85,7 @@ export function collectMetrics(sessions, range) {
   const models = new Set();
 
   for (const session of sessions) {
-    const scopedRows = isCalendarScope(range.scope)
+    const scopedRows = isCalendarScope(range.scope) || isTimeWindowScope(range.scope)
       ? session.rows.filter((row) => isDateInRange(rowDate(row), range))
       : session.rows;
 
@@ -134,6 +141,9 @@ export function collectMetrics(sessions, range) {
     targetDate: range.targetDate,
     rangeStartDate,
     rangeEndDate,
+    windowStartAt: range.startAt,
+    windowEndAt: range.endAt,
+    windowHours: range.hours,
     calendarDayCount: isCalendarScope(range.scope) ? calendarDayCount(range) : 1,
     activeDayCount: Math.max(1, activeDateKeys.size),
     sessionIds,

package/src/core/pet-installer.mjs

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+export const CODEX_PET_NAME = "ai-work-receipt";
+
+export function getCodexPetHome({ homeDir = os.homedir(), codexHome = null } = {}) {
+  return path.resolve(codexHome || process.env.CODEX_HOME || path.join(homeDir, ".codex"));
+}
+
+export function getCodexPetInstallPath(options = {}) {
+  return path.join(getCodexPetHome(options), "pets", CODEX_PET_NAME);
+}
+
+export function installCodexPet({ projectDir, homeDir = os.homedir(), codexHome = null } = {}) {
+  if (!projectDir) throw new Error("安装 Pet 时缺少项目目录");
+
+  const sourceDir = path.join(projectDir, "assets", "codex-pet", CODEX_PET_NAME);
+  const sourceManifest = path.join(sourceDir, "pet.json");
+  const sourceSpritesheet = path.join(sourceDir, "spritesheet.webp");
+  if (!fs.existsSync(sourceManifest) || !fs.existsSync(sourceSpritesheet)) {
+    throw new Error(`发布包中缺少 Codex Pet：${sourceDir}`);
+  }
+
+  const targetDir = getCodexPetInstallPath({ homeDir, codexHome });
+  const targetParent = path.dirname(targetDir);
+  const stagingDir = path.join(
+    targetParent,
+    `.${CODEX_PET_NAME}.install-${process.pid}-${Date.now()}`,
+  );
+
+  fs.mkdirSync(targetParent, { recursive: true });
+  try {
+    fs.cpSync(sourceDir, stagingDir, { recursive: true });
+    fs.rmSync(targetDir, { recursive: true, force: true });
+    fs.renameSync(stagingDir, targetDir);
+  } catch (error) {
+    fs.rmSync(stagingDir, { recursive: true, force: true });
+    throw error;
+  }
+
+  return { sourceDir, targetDir };
+}
+
+export function uninstallCodexPet({ homeDir = os.homedir(), codexHome = null } = {}) {
+  const targetDir = getCodexPetInstallPath({ homeDir, codexHome });
+  const existed = fs.existsSync(targetDir);
+  fs.rmSync(targetDir, { recursive: true, force: true });
+  return { targetDir, existed };
+}

package/src/core/presentation.mjs

@@ -93,6 +93,7 @@ const RECEIPT_COPY = {
     scope: {
       latest: "最近一次会话",
       session: "指定会话",
+      "last-hours": "最近 {hours} 小时",
       today: "今日全部会话",
       "last-7-days": "最近 7 个自然日",
       "this-week": "本周全部会话",
@@ -141,6 +142,7 @@ const RECEIPT_COPY = {
     multipartRestart: "重新显示小程序码",
     dataQrAlt: "当前小票数据二维码",
     miniProgramAlt: "微信小程序码",
+    exportMiniProgramLabel: "微信扫码打开小程序",
     placeholderLabel: "小程序码",
     placeholderValue: "待接入",
     placeholderAria: "小程序码待接入",
@@ -165,6 +167,7 @@ const RECEIPT_COPY = {
     scope: {
       latest: "Latest session",
       session: "Selected session",
+      "last-hours": "Last {hours} hours",
       today: "All sessions today",
       "last-7-days": "Last 7 calendar days",
       "this-week": "All sessions this week",
@@ -213,6 +216,7 @@ const RECEIPT_COPY = {
     multipartRestart: "Show mini-program code again",
     dataQrAlt: "Current receipt data QR code",
     miniProgramAlt: "WeChat mini-program code",
+    exportMiniProgramLabel: "Scan to open the mini program",
     placeholderLabel: "Mini program",
     placeholderValue: "Pending",
     placeholderAria: "Mini-program code pending",
@@ -225,6 +229,7 @@ const COMPENSATION_COPY = {
   "zh-CN": {
     latest: "本单工资",
     session: "本单工资",
+    "last-hours": "本段工资",
     today: "本日工资",
     "last-7-days": "近七日工资",
     "this-week": "本周工资",
@@ -234,6 +239,7 @@ const COMPENSATION_COPY = {
   en: {
     latest: "SHIFT PAY",
     session: "SHIFT PAY",
+    "last-hours": "WINDOW PAY",
     today: "TODAY'S PAY",
     "last-7-days": "7-DAY PAY",
     "this-week": "THIS WEEK'S PAY",
@@ -262,6 +268,11 @@ export function getReceiptCopy(locale = DEFAULT_LOCALE) {
   return RECEIPT_COPY[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
 }
 
+export function getScopeLabel(scope, locale = DEFAULT_LOCALE, hours = null) {
+  const template = getReceiptCopy(locale).scope[scope] || getReceiptCopy(locale).scope.latest;
+  return String(template).replaceAll("{hours}", String(hours || 3));
+}
+
 export function buildCompensation(scope, amount, locale = DEFAULT_LOCALE) {
   const copy = COMPENSATION_COPY[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
   return {

package/src/core/range.mjs

@@ -3,6 +3,7 @@ import { dateKey } from "../lib/time.mjs";
 export const RECEIPT_SCOPES = new Set([
   "latest",
   "session",
+  "last-hours",
   "today",
   "last-7-days",
   "this-week",
@@ -11,6 +12,8 @@ export const RECEIPT_SCOPES = new Set([
 const SCOPE_ALIASES = new Map([
   ["latest", "latest"],
   ["session", "session"],
+  ["hours", "last-hours"],
+  ["last-hours", "last-hours"],
   ["today", "today"],
   ["7d", "last-7-days"],
   ["last-7-days", "last-7-days"],
@@ -38,7 +41,13 @@ function mondayDateKey(value) {
   return shiftDateKey(value, -daysSinceMonday);
 }
 
-export function resolveRange(scope, timezone, now = new Date(), sessionId = null) {
+function floorToMinute(value) {
+  const date = new Date(value);
+  date.setUTCSeconds(0, 0);
+  return date;
+}
+
+export function resolveRange(scope, timezone, now = new Date(), sessionId = null, hours = null) {
   const normalizedScope = normalizeScope(scope);
   if (!normalizedScope || !RECEIPT_SCOPES.has(normalizedScope)) {
     throw new Error(`不支持的统计范围：${scope}`);
@@ -47,8 +56,20 @@ export function resolveRange(scope, timezone, now = new Date(), sessionId = null
   const targetDate = dateKey(now, timezone);
   let startDate = null;
   let endDate = null;
+  let startAt = null;
+  let endAt = null;
+  let windowHours = null;
 
-  if (normalizedScope === "today") {
+  if (normalizedScope === "last-hours") {
+    windowHours = Number(hours ?? 3);
+    if (!Number.isInteger(windowHours) || windowHours < 1 || windowHours > 168) {
+      throw new Error("最近小时数必须是 1 至 168 之间的整数");
+    }
+    endAt = floorToMinute(now);
+    startAt = new Date(endAt.getTime() - windowHours * 60 * 60 * 1000);
+    startDate = dateKey(startAt, timezone);
+    endDate = dateKey(endAt, timezone);
+  } else if (normalizedScope === "today") {
     startDate = targetDate;
     endDate = targetDate;
   } else if (normalizedScope === "last-7-days") {
@@ -65,6 +86,9 @@ export function resolveRange(scope, timezone, now = new Date(), sessionId = null
     targetDate,
     startDate,
     endDate,
+    startAt,
+    endAt,
+    hours: windowHours,
     sessionId: sessionId || null,
   };
 }
@@ -73,8 +97,15 @@ export function isCalendarScope(scope) {
   return scope === "today" || scope === "last-7-days" || scope === "this-week";
 }
 
+export function isTimeWindowScope(scope) {
+  return scope === "last-hours";
+}
+
 export function isDateInRange(date, range) {
   if (!date) return false;
+  if (isTimeWindowScope(range.scope)) {
+    return date >= range.startAt && date <= range.endAt;
+  }
   if (!isCalendarScope(range.scope)) return true;
   const key = dateKey(date, range.timezone);
   return key >= range.startDate && key <= range.endDate;
@@ -107,6 +138,13 @@ export function outputSlugForRange(range, receiptId = "") {
   const endDate = range?.endDate || range?.targetDate || startDate;
 
   if (scope === "today") return `today-${safeSlugSegment(endDate, "today")}`;
+  if (scope === "last-hours") {
+    const endAt = range?.endAt instanceof Date ? range.endAt : new Date(range?.endAt || 0);
+    const endStamp = Number.isNaN(endAt.getTime())
+      ? safeSlugSegment(endDate, "window")
+      : endAt.toISOString().replace(/[-:]/g, "").slice(0, 13);
+    return `last-${Number(range?.hours || 3)}-hours-${safeSlugSegment(endStamp, "window")}`;
+  }
   if (scope === "last-7-days" || scope === "this-week") {
     const dateSpan = startDate === endDate ? endDate : `${startDate}-to-${endDate}`;
     return `${scope}-${safeSlugSegment(dateSpan, scope)}`;

package/src/core/receipt-record.mjs

@@ -4,7 +4,11 @@ import os from "node:os";
 import path from "node:path";
 
 import { canonicalStringify, sha256Hex } from "./canonical.mjs";
-import { buildLogicalReceiptKey, buildProtocolReceiptId } from "./fact-identity.mjs";
+import {
+  buildLogicalReceiptKey,
+  buildProtocolReceiptId,
+  buildSummaryReceiptId,
+} from "./fact-identity.mjs";
 import {
   buildCompensation,
   DEFAULT_LOCALE,
@@ -22,7 +26,12 @@ function fingerprintSessionIds(sessionIds) {
 export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = DEFAULT_LOCALE, canonical = {}) {
   const sessionFingerprint = fingerprintSessionIds(metrics.sessionIds);
   const logicalKey = buildLogicalReceiptKey(metrics);
-  const id = buildProtocolReceiptId(SOURCE_VERSION, logicalKey);
+  const summaryOnly = metrics.mode === "last-hours";
+  const schemaVersion = summaryOnly ? 1 : SCHEMA_VERSION;
+  const sourceVersion = summaryOnly ? "cwr1" : SOURCE_VERSION;
+  const id = summaryOnly
+    ? buildSummaryReceiptId(logicalKey)
+    : buildProtocolReceiptId(SOURCE_VERSION, logicalKey);
   const snapshotHash = sha256Hex({
     start: metrics.startAt.toISOString(),
     end: metrics.endAt.toISOString(),
@@ -33,6 +42,8 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
     scope: metrics.mode,
     rangeStartDate: metrics.rangeStartDate,
     rangeEndDate: metrics.rangeEndDate,
+    windowStartAt: metrics.windowStartAt?.toISOString() || null,
+    windowEndAt: metrics.windowEndAt?.toISOString() || null,
   });
   const workProfileId = metrics.workProfileId || "temporary-hire";
   const workProfile = getWorkProfileCopy(workProfileId, locale);
@@ -59,23 +70,24 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
     manifest_hash: sha256Hex(canonicalStringify(manifestCore)),
   };
 
-  return {
-    schema_version: SCHEMA_VERSION,
+  const record = {
+    schema_version: schemaVersion,
     locale,
     id,
     generated_at: new Date().toISOString(),
     source: {
       type: "codex",
-      version: SOURCE_VERSION,
+      version: sourceVersion,
       scope: metrics.mode,
+      hours: metrics.windowHours || null,
       collector_version: COLLECTOR_VERSION,
       logical_key: logicalKey,
       session_fingerprint: sessionFingerprint,
       snapshot_hash: snapshotHash,
     },
     period: {
-      start_at: metrics.startAt.toISOString(),
-      end_at: metrics.endAt.toISOString(),
+      start_at: (metrics.windowStartAt || metrics.startAt).toISOString(),
+      end_at: (metrics.windowEndAt || metrics.endAt).toISOString(),
       timezone: metrics.timezone,
       range_start_date: metrics.rangeStartDate,
       range_end_date: metrics.rangeEndDate,
@@ -107,9 +119,12 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       contains_paths: false,
       contains_filenames: false,
     },
-    manifest,
-    facts,
   };
+  if (!summaryOnly) {
+    record.manifest = manifest;
+    record.facts = facts;
+  }
+  return record;
 }
 
 export function persistReceiptRecord(record, outputHtmlPath, requestedDataDir = null) {

package/src/core/selector.mjs

@@ -37,21 +37,23 @@ export async function promptForRange({ locale, timezone, loadRecentSessions }) {
   try {
     console.log(isEnglish ? "\nChoose a receipt range:\n" : "\n请选择小票统计范围：\n");
     console.log(isEnglish ? "1. All activity today (recommended)" : "1. 今天全部活动（推荐）");
-    console.log(isEnglish ? "2. Last 7 calendar days" : "2. 最近 7 个自然日");
-    console.log(isEnglish ? "3. This week (Monday to now)" : "3. 本周（周一至今）");
-    console.log(isEnglish ? "4. Choose a specific session" : "4. 选择一个具体会话");
+    console.log(isEnglish ? "2. Last 3 hours" : "2. 最近 3 小时");
+    console.log(isEnglish ? "3. Last 7 calendar days" : "3. 最近 7 个自然日");
+    console.log(isEnglish ? "4. This week (Monday to now)" : "4. 本周（周一至今）");
+    console.log(isEnglish ? "5. Choose a specific session" : "5. 选择一个具体会话");
 
     const choice = await askForNumber(
       readline,
-      isEnglish ? "\nEnter 1–4 (default 1): " : "\n请输入 1–4（默认 1）：",
+      isEnglish ? "\nEnter 1–5 (default 1): " : "\n请输入 1–5（默认 1）：",
       1,
-      4,
+      5,
       1,
     );
 
     if (choice === 1) return { mode: "today", sessionId: null };
-    if (choice === 2) return { mode: "last-7-days", sessionId: null };
-    if (choice === 3) return { mode: "this-week", sessionId: null };
+    if (choice === 2) return { mode: "last-hours", sessionId: null, hours: 3 };
+    if (choice === 3) return { mode: "last-7-days", sessionId: null };
+    if (choice === 4) return { mode: "this-week", sessionId: null };
 
     const sessions = await loadRecentSessions();
     if (!sessions.length) throw new Error(isEnglish ? "No Codex sessions found" : "没有找到可选择的 Codex 会话");

package/src/renderers/html.mjs

@@ -3,7 +3,12 @@ import { createRequire } from "node:module";
 
 import { buildCode128B } from "../core/barcode.mjs";
 import { formatDate, formatDuration, formatNumber, formatTime } from "../lib/time.mjs";
-import { buildCompensation, DEFAULT_LOCALE, getReceiptCopy } from "../core/presentation.mjs";
+import {
+  buildCompensation,
+  DEFAULT_LOCALE,
+  getReceiptCopy,
+  getScopeLabel,
+} from "../core/presentation.mjs";
 
 const require = createRequire(import.meta.url);
 const DOM_TO_IMAGE_SOURCE = fs.readFileSync(require.resolve("dom-to-image-more"), "utf8");
@@ -65,7 +70,7 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
   const rangeEndDate = record.period.range_end_date || formatDateKey(record.period.end_at.slice(0, 10), "zh-CN").replaceAll("/", "-");
   const isCalendarScope = new Set(["today", "last-7-days", "this-week"]).has(record.source.scope);
   const spansMultipleDates = rangeStartDate !== rangeEndDate;
-  const scopeLabel = copy.scope[record.source.scope] || copy.scope.latest;
+  const scopeLabel = getScopeLabel(record.source.scope, locale, record.source.hours);
   const dateRange = spansMultipleDates
     ? `${formatDateKey(rangeStartDate, locale)}—${formatDateKey(rangeEndDate, locale)}`
     : formatDateKey(rangeEndDate, locale);
@@ -86,6 +91,7 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
     busyLabel: copy.exportingImage,
     successLabel: copy.exportSuccess,
     errorLabel: copy.exportError,
+    miniProgramLabel: copy.exportMiniProgramLabel,
     fileBase: `codex-work-receipt-${record.source.scope}-${spansMultipleDates ? `${rangeStartDate}-to-${rangeEndDate}` : `${rangeEndDate}-${record.id.slice(4, 12)}`}`,
   }).replaceAll("<", "\\u003c");
   const rows = [
@@ -146,7 +152,7 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
       <div class="qr-grid qr-grid--export-only" hidden>
         <div class="qr-item">
           <div class="qr-frame">${miniProgramVisual}</div>
-          <strong>${escapeHtml(copy.openMiniProgram)}</strong>
+          <strong data-export-mini-label>${escapeHtml(copy.openMiniProgram)}</strong>
           <span>${escapeHtml(copy.openMiniProgramHint)}</span>
         </div>
         ${dataQrItems}
@@ -155,7 +161,7 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
       <div class="qr-grid qr-grid--single">
         <div class="qr-item">
           <div class="qr-frame">${miniProgramVisual}</div>
-          <strong>${escapeHtml(copy.openMiniProgram)}</strong>
+          <strong data-export-mini-label>${escapeHtml(copy.openMiniProgram)}</strong>
           <span>${escapeHtml(copy.openMiniProgramHint)}</span>
         </div>
         ${dataQrItems}
@@ -687,6 +693,50 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
       }));
     }
 
+    function sanitizeExportNode(node) {
+      const multipartLiveNode = node.querySelector(".multipart-live");
+      if (multipartLiveNode) multipartLiveNode.remove();
+
+      const exportGridNode = node.querySelector(".qr-grid--export-only");
+      if (exportGridNode) {
+        exportGridNode.removeAttribute("hidden");
+        exportGridNode.style.display = "grid";
+      }
+
+      node.querySelectorAll("[data-data-qr-index]").forEach((item) => item.remove());
+      node.querySelectorAll(".qr-grid").forEach((grid) => {
+        grid.style.gridTemplateColumns = "minmax(0, 1fr)";
+        grid.style.justifyItems = "center";
+      });
+
+      const miniProgramLabel = node.querySelector("[data-export-mini-label]");
+      if (miniProgramLabel) miniProgramLabel.textContent = exportConfig.miniProgramLabel;
+      const transferDescription = node.querySelector(".transfer-heading p");
+      if (transferDescription) transferDescription.remove();
+      const transferNote = node.querySelector(".transfer-note");
+      if (transferNote) transferNote.remove();
+
+      node.querySelectorAll(".paper").forEach((paper) => {
+        paper.style.boxShadow = "none";
+      });
+    }
+
+    function createExportNode(source, paperColor) {
+      const clone = source.cloneNode(true);
+      sanitizeExportNode(clone);
+      const sourceWidth = Math.ceil(source.getBoundingClientRect().width || source.scrollWidth);
+      Object.assign(clone.style, {
+        position: "absolute",
+        left: "-100000px",
+        top: "0",
+        width: sourceWidth + "px",
+        background: paperColor,
+        pointerEvents: "none",
+      });
+      document.body.appendChild(clone);
+      return clone;
+    }
+
     function downloadImage(dataUrl, filename) {
       const link = document.createElement("a");
       link.href = dataUrl;
@@ -703,15 +753,17 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
       exportButton.disabled = true;
       exportButton.textContent = exportConfig.busyLabel;
       setExportStatus("");
+      let renderNode = null;
 
       try {
         if (document.fonts?.ready) await document.fonts.ready;
-        await waitForImages(exportNode);
-        const width = Math.ceil(exportNode.scrollWidth);
-        const height = Math.ceil(exportNode.scrollHeight);
-        const scale = Math.max(2, Math.min(3, 1500 / Math.max(1, width)));
         const paperColor = getComputedStyle(document.documentElement).getPropertyValue("--paper").trim() || "#ffffff";
-        const dataUrl = await domtoimage.toPng(exportNode, {
+        renderNode = createExportNode(exportNode, paperColor);
+        await waitForImages(renderNode);
+        const width = Math.ceil(renderNode.scrollWidth);
+        const height = Math.ceil(renderNode.scrollHeight);
+        const scale = Math.max(2, Math.min(3, 1500 / Math.max(1, width)));
+        const dataUrl = await domtoimage.toPng(renderNode, {
           width,
           height,
           scale,
@@ -720,17 +772,12 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
           cacheBust: false,
           style: { background: paperColor },
           onclone(clone) {
+            sanitizeExportNode(clone);
+            clone.style.position = "static";
+            clone.style.left = "auto";
+            clone.style.top = "auto";
+            clone.style.width = width + "px";
             clone.style.background = paperColor;
-            const multipartLiveClone = clone.querySelector(".multipart-live");
-            if (multipartLiveClone) multipartLiveClone.remove();
-            const exportGridClone = clone.querySelector(".qr-grid--export-only");
-            if (exportGridClone) {
-              exportGridClone.removeAttribute("hidden");
-              exportGridClone.style.display = "grid";
-            }
-            clone.querySelectorAll(".paper").forEach((paper) => {
-              paper.style.boxShadow = "none";
-            });
           },
           logger: {},
         });
@@ -743,6 +790,7 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
         console.error(error);
         setExportStatus(exportConfig.errorLabel, "error");
       } finally {
+        if (renderNode) renderNode.remove();
         exportButton.disabled = false;
         exportButton.textContent = exportConfig.idleLabel;
       }