codex-work-receipt 0.3.0

package/src/cli.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import QRCode from "qrcode";
+
+import { parseArgs, printHelp } from "./core/args.mjs";
+import { collectMetrics } from "./core/metrics.mjs";
+import { encodeReceiptPayload } from "./core/qr-payload.mjs";
+import { buildReceiptRecord, persistReceiptRecord } from "./core/receipt-record.mjs";
+import { installCodexSkill } from "./core/skill-installer.mjs";
+import { formatNumber } from "./lib/time.mjs";
+import { loadCodexSessions } from "./parsers/codex.mjs";
+import { renderHtml } from "./renderers/html.mjs";
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const PROJECT_DIR = path.dirname(SCRIPT_DIR);
+const DEFAULT_OUTPUT_DIR = path.join(process.cwd(), "codex-work-receipt-output");
+const DEFAULT_MINIPROGRAM_CODE = path.join(PROJECT_DIR, "assets", "miniprogram-code.png");
+
+function mimeTypeForImage(filePath) {
+  const extension = path.extname(filePath).toLowerCase();
+  if (extension === ".png") return "image/png";
+  if (extension === ".jpg" || extension === ".jpeg") return "image/jpeg";
+  if (extension === ".webp") return "image/webp";
+  if (extension === ".svg") return "image/svg+xml";
+  throw new Error(`不支持的小程序码图片格式：${extension || "未知"}`);
+}
+
+function imageAsDataUrl(filePath) {
+  if (!filePath || !fs.existsSync(filePath)) return null;
+  return `data:${mimeTypeForImage(filePath)};base64,${fs.readFileSync(filePath).toString("base64")}`;
+}
+
+function openFile(filePath) {
+  const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+  const args = process.platform === "win32" ? ["/c", "start", "", filePath] : [filePath];
+  const child = spawn(command, args, { detached: true, stdio: "ignore" });
+  child.unref();
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  if (options.help) {
+    printHelp(options.locale);
+    return;
+  }
+  if (options.installSkill) {
+    const installed = installCodexSkill({ projectDir: PROJECT_DIR });
+    if (options.locale === "en") {
+      console.log(`AI Work Receipt skill installed: ${installed.targetDir}`);
+      console.log("You can now ask Codex: Create an AI work receipt for my latest session.");
+      console.log("Restart Codex if the current session does not detect the new skill.");
+    } else {
+      console.log(`AI 打工小票 Skill 已安装：${installed.targetDir}`);
+      console.log("以后可以直接对 Codex 说：给刚刚这次工作开一张 AI 打工小票。");
+      console.log("如果当前会话没有识别到新 Skill，请重启 Codex 后再试。");
+    }
+    return;
+  }
+
+  const sessions = loadCodexSessions(options.mode);
+  const metrics = collectMetrics(sessions, options.mode, options.timezone);
+  const record = buildReceiptRecord(metrics, options.theme, options.locale);
+  const qrPayload = encodeReceiptPayload(record);
+  const dataQrDataUrl = await QRCode.toDataURL(qrPayload, {
+    errorCorrectionLevel: "M",
+    margin: 2,
+    width: 360,
+    color: { dark: "#171713", light: "#ffffff" },
+  });
+
+  const requestedOutput = options.output || path.join(DEFAULT_OUTPUT_DIR, `codex-receipt-${options.mode}.html`);
+  const outputFile = path.resolve(/\.html?$/i.test(requestedOutput) ? requestedOutput : `${requestedOutput}.html`);
+  fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+
+  const miniProgramCodeDataUrl = imageAsDataUrl(DEFAULT_MINIPROGRAM_CODE);
+
+  fs.writeFileSync(
+    outputFile,
+    renderHtml({ record, dataQrDataUrl, miniProgramCodeDataUrl }),
+    "utf8",
+  );
+  const persisted = persistReceiptRecord(record, outputFile, options.dataDir);
+
+  if (options.locale === "en") {
+    console.log(`Generated HTML: ${outputFile}`);
+    console.log(`Structured data: ${persisted.companionPath}`);
+    console.log(`Local history: ${persisted.receiptPath}`);
+    console.log(`Stats: ${record.stats.completed_turns} turns · ${formatNumber(record.stats.tokens.total_tokens, options.locale)} Tokens · ${record.stats.tool_calls} tool calls`);
+    console.log(`Data QR: ${qrPayload.length} characters · schema v${record.schema_version}`);
+    if (!miniProgramCodeDataUrl) console.log("Mini-program code: not configured; using the explicit placeholder");
+  } else {
+    console.log(`已生成网页：${outputFile}`);
+    console.log(`结构数据：${persisted.companionPath}`);
+    console.log(`本地历史：${persisted.receiptPath}`);
+    console.log(`统计：${record.stats.completed_turns} 轮 · ${formatNumber(record.stats.tokens.total_tokens, options.locale)} Token · ${record.stats.tool_calls} 次工具调用`);
+    console.log(`数据二维码：${qrPayload.length} 字符 · schema v${record.schema_version}`);
+    if (!miniProgramCodeDataUrl) console.log("小程序码：尚未配置，页面使用明确占位符");
+  }
+  if (options.open) openFile(outputFile);
+}
+
+main().catch((error) => {
+  console.error(`生成失败：${error.message}`);
+  process.exitCode = 1;
+});

package/src/core/args.mjs

@@ -0,0 +1,84 @@
+export function printHelp(locale = "zh-CN") {
+  console.log(locale === "en" ? `
+Codex AI Work Receipt
+
+Usage:
+  npx codex-work-receipt@latest --latest --lang en
+  npx codex-work-receipt@latest --today --lang en
+  npx codex-work-receipt@latest --install-skill --lang en
+
+Options:
+  --latest                    Summarize the latest active Codex session (default)
+  --today                     Summarize all Codex activity from today
+  --timezone <name>           Use an IANA timezone, for example Asia/Shanghai
+  --lang <name>               Receipt language: zh-CN, en
+  --theme <name>              Default theme: classic, diner, payroll
+  --output <file>             Set the generated HTML path
+  --data-dir <directory>      Set the local structured-history directory
+  --install-skill             Install the natural-language Codex skill
+  --no-open                   Do not open the browser after generation
+  --help                      Show help
+` : `
+Codex AI 打工小票
+
+用法：
+  npx codex-work-receipt@latest --latest
+  npx codex-work-receipt@latest --today
+  npx codex-work-receipt@latest --install-skill
+
+选项：
+  --latest                    统计最近活跃的 Codex 会话（默认）
+  --today                     统计本地时区今天发生的全部 Codex 活动
+  --timezone <name>           指定 IANA 时区，例如 Asia/Shanghai
+  --lang <name>               小票语言：zh-CN、en
+  --theme <name>              默认主题：classic、diner、payroll
+  --output <file>             指定生成的 HTML 文件，默认写入 ./codex-work-receipt-output/
+  --data-dir <directory>      指定本地结构数据目录
+  --install-skill             安装可通过自然语言调用的 Codex Skill
+  --no-open                   生成后不自动打开浏览器
+  --help                      显示帮助
+`);
+}
+
+export function parseArgs(argv) {
+  const result = {
+    mode: "latest",
+    timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || "Asia/Shanghai",
+    locale: "zh-CN",
+    theme: "classic",
+    output: null,
+    dataDir: null,
+    installSkill: false,
+    open: true,
+  };
+
+  const optionsWithValues = new Map([
+    ["--timezone", "timezone"],
+    ["--lang", "locale"],
+    ["--theme", "theme"],
+    ["--output", "output"],
+    ["--data-dir", "dataDir"],
+  ]);
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const argument = argv[index];
+    if (argument === "--latest") result.mode = "latest";
+    else if (argument === "--today") result.mode = "today";
+    else if (argument === "--install-skill") result.installSkill = true;
+    else if (argument === "--no-open") result.open = false;
+    else if (argument === "--help" || argument === "-h") result.help = true;
+    else if (optionsWithValues.has(argument)) {
+      const value = argv[++index];
+      if (!value) throw new Error(`${argument} 需要提供值`);
+      result[optionsWithValues.get(argument)] = value;
+    } else throw new Error(`不认识的参数：${argument}`);
+  }
+
+  if (!new Set(["classic", "diner", "payroll"]).has(result.theme)) {
+    throw new Error(`不支持的主题：${result.theme}`);
+  }
+  if (!new Set(["zh-CN", "en"]).has(result.locale)) {
+    throw new Error(`不支持的语言：${result.locale}`);
+  }
+  return result;
+}

package/src/core/metrics.mjs

@@ -0,0 +1,149 @@
+import { dateKey, rowDate } from "../lib/time.mjs";
+import { selectWorkProfileId } from "./presentation.mjs";
+
+function zeroUsage() {
+  return {
+    input_tokens: 0,
+    cached_input_tokens: 0,
+    output_tokens: 0,
+    reasoning_output_tokens: 0,
+    total_tokens: 0,
+  };
+}
+
+function subtractUsage(after = {}, before = {}) {
+  const result = zeroUsage();
+  for (const key of Object.keys(result)) {
+    result[key] = Math.max(0, Number(after[key] || 0) - Number(before[key] || 0));
+  }
+  return result;
+}
+
+function addUsage(target, source) {
+  for (const key of Object.keys(target)) target[key] += Number(source[key] || 0);
+}
+
+function sessionTokenUsage(rows, mode, targetDate, timezone) {
+  const events = rows
+    .filter((row) => row.type === "event_msg" && row.payload?.type === "token_count")
+    .filter((row) => row.payload?.info?.total_token_usage)
+    .sort((left, right) => (rowDate(left)?.getTime() || 0) - (rowDate(right)?.getTime() || 0));
+
+  if (!events.length) return zeroUsage();
+  if (mode === "latest") return { ...zeroUsage(), ...events.at(-1).payload.info.total_token_usage };
+
+  const lastToday = events.filter((row) => {
+    const date = rowDate(row);
+    return date && dateKey(date, timezone) === targetDate;
+  }).at(-1);
+  if (!lastToday) return zeroUsage();
+
+  const baseline = events.filter((row) => {
+    const date = rowDate(row);
+    return date && dateKey(date, timezone) < targetDate;
+  }).at(-1)?.payload.info.total_token_usage || zeroUsage();
+  return subtractUsage(lastToday.payload.info.total_token_usage, baseline);
+}
+
+function calculateWorkPoints(metrics) {
+  const workMinutes = Math.ceil(metrics.workDurationMs / 60_000);
+  const outputTokenK = Number(metrics.tokens.output_tokens || 0) / 1000;
+  const reasoningTokenK = Number(metrics.tokens.reasoning_output_tokens || 0) / 1000;
+  const points =
+    60 +
+    metrics.completedTurns * 8 +
+    metrics.toolCalls * 3 +
+    outputTokenK * 1.2 +
+    reasoningTokenK * 1.8 +
+    workMinutes * 2 +
+    metrics.interruptions * 12;
+  return Math.max(0, Math.round(points));
+}
+
+export function collectMetrics(sessions, mode, timezone) {
+  const targetDate = dateKey(new Date(), timezone);
+  const scopedSessions = [];
+  const sessionIds = [];
+  const tokens = zeroUsage();
+  let completedTurns = 0;
+  let userMessages = 0;
+  let toolCalls = 0;
+  let interruptions = 0;
+  let workDurationMs = 0;
+  let totalFirstTokenMs = 0;
+  let firstTokenSamples = 0;
+  const timestamps = [];
+  const models = new Set();
+
+  for (const session of sessions) {
+    const scopedRows = mode === "latest"
+      ? session.rows
+      : session.rows.filter((row) => {
+          const date = rowDate(row);
+          return date && dateKey(date, timezone) === targetDate;
+        });
+
+    if (!scopedRows.length) continue;
+    scopedSessions.push(session);
+    sessionIds.push(session.sessionId);
+    addUsage(tokens, sessionTokenUsage(session.rows, mode, targetDate, timezone));
+
+    for (const row of scopedRows) {
+      const date = rowDate(row);
+      if (date) timestamps.push(date);
+
+      if (row.type === "turn_context" && row.payload?.model) models.add(row.payload.model);
+      if (row.type === "event_msg") {
+        const eventType = row.payload?.type;
+        if (eventType === "task_complete") {
+          completedTurns += 1;
+          workDurationMs += Number(row.payload.duration_ms || 0);
+          if (Number.isFinite(row.payload.time_to_first_token_ms)) {
+            totalFirstTokenMs += row.payload.time_to_first_token_ms;
+            firstTokenSamples += 1;
+          }
+        } else if (eventType === "user_message") userMessages += 1;
+        else if (eventType === "turn_aborted") {
+          interruptions += 1;
+          workDurationMs += Number(row.payload.duration_ms || 0);
+        }
+      }
+
+      if (
+        row.type === "response_item" &&
+        (row.payload?.type === "custom_tool_call" || row.payload?.type === "function_call")
+      ) toolCalls += 1;
+    }
+
+    const fallbackModel = [...session.rows]
+      .reverse()
+      .find((row) => row.type === "turn_context" && row.payload?.model)?.payload?.model;
+    if (fallbackModel) models.add(fallbackModel);
+  }
+
+  if (!scopedSessions.length) {
+    throw new Error(mode === "today" ? `没有找到 ${targetDate} 的 Codex 活动` : "没有找到可统计的 Codex 会话");
+  }
+
+  timestamps.sort((left, right) => left - right);
+  const metrics = {
+    mode,
+    timezone,
+    targetDate,
+    sessionIds,
+    sessionCount: scopedSessions.length,
+    startAt: timestamps[0],
+    endAt: timestamps.at(-1),
+    completedTurns,
+    userMessages,
+    toolCalls,
+    interruptions,
+    workDurationMs,
+    averageFirstTokenMs: firstTokenSamples ? totalFirstTokenMs / firstTokenSamples : 0,
+    tokens,
+    models: [...models],
+  };
+  metrics.workProfileId = selectWorkProfileId(metrics);
+  metrics.workPoints = calculateWorkPoints(metrics);
+  return metrics;
+}

package/src/core/presentation.mjs

@@ -0,0 +1,239 @@
+export const DEFAULT_LOCALE = "zh-CN";
+export const SUPPORTED_LOCALES = new Set([DEFAULT_LOCALE, "en"]);
+
+const WORK_PROFILES = {
+  "change-request-survivor": {
+    "zh-CN": {
+      title: "改需求幸存者",
+      review: "方向改了又改，但它还是把工牌戴稳了。",
+    },
+    en: {
+      title: "Change Request Survivor",
+      review: "The direction changed again and again, but the badge stayed firmly on.",
+    },
+  },
+  "toolchain-commander": {
+    "zh-CN": {
+      title: "工具链指挥官",
+      review: "今天不是在调用工具，就是在去调用工具的路上。",
+    },
+    en: {
+      title: "Toolchain Commander",
+      review: "It was either calling tools or on its way to call another one.",
+    },
+  },
+  "context-devouring-beast": {
+    "zh-CN": {
+      title: "上下文吞吐兽",
+      review: "一口气吞下大量上下文，脑内风扇疑似起飞。",
+    },
+    en: {
+      title: "Context-Devouring Beast",
+      review: "It swallowed a massive context window in one sitting. Internal fans may have achieved liftoff.",
+    },
+  },
+  "continuous-delivery-machine": {
+    "zh-CN": {
+      title: "连续交付机器",
+      review: "一轮接一轮地干活，像被塞进了自动售货机。",
+    },
+    en: {
+      title: "Continuous Delivery Machine",
+      review: "Turn after turn, it kept shipping like a vending machine stocked with deliverables.",
+    },
+  },
+  "night-shift-companion": {
+    "zh-CN": {
+      title: "深夜陪跑员工",
+      review: "人类还没下班，它也只好继续亮着屏幕。",
+    },
+    en: {
+      title: "Night Shift Companion",
+      review: "The human was still online, so the screen had no choice but to stay lit.",
+    },
+  },
+  "steady-progress-partner": {
+    "zh-CN": {
+      title: "稳定推进搭子",
+      review: "不声不响往前推，属于靠谱但不邀功的那种。",
+    },
+    en: {
+      title: "Steady Progress Partner",
+      review: "Quietly moved the work forward—the reliable type that never asks for applause.",
+    },
+  },
+  "temporary-hire": {
+    "zh-CN": {
+      title: "临时上岗小工",
+      review: "刚打完卡，还没来得及形成职场人格。",
+    },
+    en: {
+      title: "Temporary Hire",
+      review: "It just clocked in. Its workplace personality is still loading.",
+    },
+  },
+};
+
+const RECEIPT_COPY = {
+  "zh-CN": {
+    htmlLang: "zh-CN",
+    pageTitle: "Codex AI 打工小票",
+    receiptTitle: "AI 打工小票",
+    themeAria: "小票主题",
+    receiptAria: "Codex AI 打工小票",
+    themes: {
+      classic: "经典热敏",
+      diner: "餐馆结账",
+      payroll: "办公室工资条",
+    },
+    scope: {
+      latest: "最近一次会话",
+      today: "今日全部会话",
+    },
+    modelMissing: "未记录",
+    meta: {
+      date: "日期",
+      hours: "营业时段",
+      number: "小票编号",
+      timezone: "时区",
+    },
+    rows: {
+      scope: "统计范围",
+      sessions: "会话数量",
+      turns: "完成轮次",
+      messages: "用户消息",
+      tools: "工具调用",
+      tokens: "消耗 Token",
+      cachedTokens: "其中缓存输入",
+      interruptions: "被人类打断",
+      firstResponse: "平均首次响应",
+      duration: "AI 工作时长",
+    },
+    units: {
+      sessions: ["场", "场"],
+      turns: ["轮", "轮"],
+      messages: ["条", "条"],
+      tools: ["次", "次"],
+      interruptions: ["次", "次"],
+      seconds: ["秒", "秒"],
+    },
+    footerThanks: "谢谢惠顾，欢迎明天继续改需求",
+    transferAria: "传到手机导入联",
+    transferTitle: "传到手机 · LOCAL TRANSFER",
+    transferDescription: "主小票保持完整，这一联只负责打开小程序和搬运数据",
+    openMiniProgram: "1 · 打开小程序",
+    openMiniProgramHint: "微信扫码进入 AI 打工图鉴",
+    importData: "2 · 扫描导入数据",
+    importDataHint: "在小程序里点击“从电脑导入”后扫描",
+    dataQrAlt: "当前小票数据二维码",
+    miniProgramAlt: "微信小程序码",
+    placeholderLabel: "小程序码",
+    placeholderValue: "待接入",
+    placeholderAria: "小程序码待接入",
+    transferNote: "数据码只包含时间、轮次、Token和工具调用等统计，不包含Prompt、回复正文、代码、项目路径或文件名。",
+    privacy: "结构数据同时保存在本机，未来可以批量导入小程序历史记录。",
+  },
+  en: {
+    htmlLang: "en",
+    pageTitle: "Codex AI Work Receipt",
+    receiptTitle: "AI Work Receipt",
+    themeAria: "Receipt theme",
+    receiptAria: "Codex AI Work Receipt",
+    themes: {
+      classic: "Classic Thermal",
+      diner: "Vintage Diner",
+      payroll: "Office Payroll",
+    },
+    scope: {
+      latest: "Latest session",
+      today: "All sessions today",
+    },
+    modelMissing: "Not recorded",
+    meta: {
+      date: "Date",
+      hours: "Work hours",
+      number: "Receipt No.",
+      timezone: "Timezone",
+    },
+    rows: {
+      scope: "Scope",
+      sessions: "Sessions",
+      turns: "Completed turns",
+      messages: "User messages",
+      tools: "Tool calls",
+      tokens: "Tokens used",
+      cachedTokens: "Cached input",
+      interruptions: "Human interruptions",
+      firstResponse: "Average first response",
+      duration: "AI work duration",
+    },
+    units: {
+      sessions: ["session", "sessions"],
+      turns: ["turn", "turns"],
+      messages: ["message", "messages"],
+      tools: ["call", "calls"],
+      interruptions: ["time", "times"],
+      seconds: ["sec", "sec"],
+    },
+    footerThanks: "Thanks for your business. More revisions welcome tomorrow.",
+    transferAria: "Mobile transfer stub",
+    transferTitle: "TO YOUR PHONE · LOCAL TRANSFER",
+    transferDescription: "The main receipt stays intact. This stub only opens the mini program and transfers data.",
+    openMiniProgram: "1 · Open mini program",
+    openMiniProgramHint: "Scan with WeChat to open AI Work Archive",
+    importData: "2 · Import receipt data",
+    importDataHint: "Tap “从电脑导入小票” in the mini program, then scan this code",
+    dataQrAlt: "Current receipt data QR code",
+    miniProgramAlt: "WeChat mini-program code",
+    placeholderLabel: "Mini program",
+    placeholderValue: "Pending",
+    placeholderAria: "Mini-program code pending",
+    transferNote: "The data code contains only statistics such as time, turns, Tokens, and tool calls. It does not contain prompts, responses, code, project paths, or file names.",
+    privacy: "Structured data is also stored locally for future batch import into your mini-program history.",
+  },
+};
+
+const COMPENSATION_COPY = {
+  "zh-CN": {
+    latest: "本单工资",
+    today: "本日工资",
+    unit: "AI 工分",
+    note: "按轮次、工具调用、Token 和改需求次数娱乐折算，不代表真实费用。",
+  },
+  en: {
+    latest: "SHIFT PAY",
+    today: "TODAY'S PAY",
+    unit: "AI work pts",
+    note: "A playful score based on turns, tool calls, Tokens, and interruptions. Not a real charge.",
+  },
+};
+
+export function selectWorkProfileId(metrics) {
+  if (metrics.interruptions >= 3) return "change-request-survivor";
+  if (metrics.toolCalls >= 40) return "toolchain-commander";
+  if (metrics.tokens.total_tokens >= 500_000) return "context-devouring-beast";
+  if (metrics.completedTurns >= 12) return "continuous-delivery-machine";
+  if (metrics.workDurationMs >= 60 * 60 * 1000) return "night-shift-companion";
+  if (metrics.completedTurns >= 5) return "steady-progress-partner";
+  return "temporary-hire";
+}
+
+export function getWorkProfileCopy(profileId, locale = DEFAULT_LOCALE) {
+  const profile = WORK_PROFILES[profileId] || WORK_PROFILES["temporary-hire"];
+  return profile[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
+}
+
+export function getReceiptCopy(locale = DEFAULT_LOCALE) {
+  return RECEIPT_COPY[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
+}
+
+export function buildCompensation(scope, amount, locale = DEFAULT_LOCALE) {
+  const copy = COMPENSATION_COPY[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
+  return {
+    label: scope === "today" ? copy.today : copy.latest,
+    amount: Number(amount || 0),
+    unit: copy.unit,
+    note: copy.note,
+    formula_version: "work_points_v1",
+  };
+}

package/src/core/qr-payload.mjs

@@ -0,0 +1,69 @@
+import crypto from "node:crypto";
+import zlib from "node:zlib";
+
+import { buildCompensation, getWorkProfileCopy } from "./presentation.mjs";
+
+export function compactReceipt(record) {
+  const profileId = record.presentation.work_profile;
+  const mobileProfile = profileId
+    ? getWorkProfileCopy(profileId, "zh-CN")
+    : { title: record.presentation.work_title, review: record.presentation.review };
+  const mobileCompensation = profileId
+    ? buildCompensation(record.source.scope, record.presentation.compensation?.amount, "zh-CN")
+    : record.presentation.compensation;
+
+  return {
+    v: record.schema_version,
+    i: record.id,
+    g: record.generated_at,
+    d: [record.period.start_at, record.period.end_at, record.period.timezone],
+    s: [
+      record.stats.session_count,
+      record.stats.completed_turns,
+      record.stats.user_messages,
+      record.stats.tool_calls,
+      record.stats.interruptions,
+      record.stats.work_duration_ms,
+      record.stats.average_first_token_ms,
+    ],
+    t: [
+      record.stats.tokens.input_tokens,
+      record.stats.tokens.cached_input_tokens,
+      record.stats.tokens.output_tokens,
+      record.stats.tokens.reasoning_output_tokens,
+      record.stats.tokens.total_tokens,
+    ],
+    m: record.stats.models,
+    l: record.locale || "zh-CN",
+    r: profileId || null,
+    p: [
+      record.presentation.default_theme,
+      mobileProfile.title,
+      mobileProfile.review,
+      mobileCompensation
+        ? [
+            mobileCompensation.label,
+            mobileCompensation.amount,
+            mobileCompensation.unit,
+            mobileCompensation.note,
+            mobileCompensation.formula_version,
+          ]
+        : null,
+    ],
+  };
+}
+
+export function encodeReceiptPayload(record) {
+  const compressed = zlib.deflateRawSync(Buffer.from(JSON.stringify(compactReceipt(record)), "utf8"));
+  const checksum = crypto.createHash("sha256").update(compressed).digest("hex").slice(0, 8);
+  return `cwr1.${checksum}.${compressed.toString("base64url")}`;
+}
+
+export function decodeReceiptPayload(payload) {
+  const [prefix, checksum, encoded] = String(payload).split(".");
+  if (prefix !== "cwr1" || !checksum || !encoded) throw new Error("无效的打工小票二维码");
+  const compressed = Buffer.from(encoded, "base64url");
+  const actual = crypto.createHash("sha256").update(compressed).digest("hex").slice(0, 8);
+  if (actual !== checksum) throw new Error("二维码数据校验失败");
+  return JSON.parse(zlib.inflateRawSync(compressed).toString("utf8"));
+}