codex-work-receipt 0.4.0 → 0.6.0

package/src/core/presentation.mjs

@@ -80,11 +80,15 @@ const RECEIPT_COPY = {
     pageTitle: "Codex AI 打工小票",
     receiptTitle: "AI 打工小票",
     themeAria: "小票主题",
+    exportImage: "保存完整长图",
+    exportingImage: "正在生成…",
+    exportSuccess: "图片已保存",
+    exportError: "图片生成失败，请重试",
     receiptAria: "Codex AI 打工小票",
     themes: {
-      classic: "经典热敏",
-      diner: "餐馆结账",
-      payroll: "办公室工资条",
+      classic: "经典白票",
+      diner: "复古粉票",
+      payroll: "夜班绿票",
     },
     scope: {
       latest: "最近一次会话",
@@ -142,11 +146,15 @@ const RECEIPT_COPY = {
     pageTitle: "Codex AI Work Receipt",
     receiptTitle: "AI Work Receipt",
     themeAria: "Receipt theme",
+    exportImage: "Save full PNG",
+    exportingImage: "Rendering…",
+    exportSuccess: "Image saved",
+    exportError: "Could not generate the image. Please try again.",
     receiptAria: "Codex AI Work Receipt",
     themes: {
-      classic: "Classic Thermal",
-      diner: "Vintage Diner",
-      payroll: "Office Payroll",
+      classic: "Classic White",
+      diner: "Vintage Pink",
+      payroll: "Night Shift Green",
     },
     scope: {
       latest: "Latest session",

package/src/core/qr-payload.mjs

@@ -1,9 +1,17 @@
 import crypto from "node:crypto";
 import zlib from "node:zlib";
+import QRCode from "qrcode";
 
 import { buildCompensation, getWorkProfileCopy } from "./presentation.mjs";
 
-export function compactReceipt(record) {
+const MAX_QR_VERSION = 25;
+const MAX_MULTIPART_PARTS = 12;
+
+function checksum(value, length = 8) {
+  return crypto.createHash("sha256").update(value).digest("hex").slice(0, length);
+}
+
+function compactPresentation(record) {
   const profileId = record.presentation.work_profile;
   const scope = record.source?.scope || (record.presentation.compensation?.label === "本日工资" ? "today" : "latest");
   const mobileProfile = profileId
@@ -13,11 +21,21 @@ export function compactReceipt(record) {
     ? buildCompensation(scope, record.presentation.compensation?.amount, "zh-CN")
     : record.presentation.compensation;
 
+  return {
+    profileId,
+    scope,
+    mobileProfile,
+    mobileCompensation,
+  };
+}
+
+function compactBase(record) {
+  const presentation = compactPresentation(record);
   return {
     v: record.schema_version,
     i: record.id,
     g: record.generated_at,
-    o: scope,
+    o: presentation.scope,
     d: [
       record.period.start_at,
       record.period.end_at,
@@ -43,35 +61,206 @@ export function compactReceipt(record) {
     ],
     m: record.stats.models,
     l: record.locale || "zh-CN",
-    r: profileId || null,
+    r: presentation.profileId || null,
     p: [
       record.presentation.default_theme,
-      mobileProfile.title,
-      mobileProfile.review,
-      mobileCompensation
+      presentation.mobileProfile.title,
+      presentation.mobileProfile.review,
+      presentation.mobileCompensation
         ? [
-            mobileCompensation.label,
-            mobileCompensation.amount,
-            mobileCompensation.unit,
-            mobileCompensation.note,
-            mobileCompensation.formula_version,
+            presentation.mobileCompensation.label,
+            presentation.mobileCompensation.amount,
+            presentation.mobileCompensation.unit,
+            presentation.mobileCompensation.note,
+            presentation.mobileCompensation.formula_version,
           ]
         : null,
     ],
   };
 }
 
+function compactFact(fact) {
+  const stats = fact.stats;
+  return [
+    fact.fact_id,
+    fact.session_id,
+    fact.identity_quality,
+    fact.source_type,
+    fact.local_date,
+    fact.bucket_start_at,
+    fact.bucket_end_at,
+    fact.source_watermark_at,
+    fact.observed_at,
+    [
+      fact.source_revision.kind,
+      fact.source_revision.row_count,
+      fact.source_revision.byte_length,
+      fact.source_revision.tail_hash,
+    ],
+    fact.content_hash,
+    [
+      stats.completed_turns,
+      stats.user_messages,
+      stats.tool_calls,
+      stats.interruptions,
+      stats.work_duration_ms,
+      stats.first_token_total_ms,
+      stats.first_token_sample_count,
+      stats.input_tokens,
+      stats.cached_input_tokens,
+      stats.output_tokens,
+      stats.reasoning_output_tokens,
+      stats.total_tokens,
+      stats.token_reset_count,
+      stats.models,
+    ],
+  ];
+}
+
+export function compactReceipt(record) {
+  const compact = compactBase(record);
+  if (record.schema_version !== 2) return compact;
+
+  const coverage = record.manifest.coverage;
+  return {
+    ...compact,
+    k: record.source.logical_key,
+    h: record.source.snapshot_hash,
+    a: [
+      record.manifest.version,
+      record.manifest.fact_schema_version,
+      record.manifest.metric_schema_version,
+      record.manifest.accounting_timezone,
+      record.manifest.fact_count,
+      record.manifest.fact_ids,
+      [
+        coverage.kind,
+        coverage.scan_mode,
+        coverage.start_date || null,
+        coverage.end_date || null,
+        coverage.complete_through_date || null,
+        coverage.observed_through_at,
+      ],
+      record.manifest.manifest_hash,
+    ],
+    f: record.facts.map(compactFact),
+  };
+}
+
+function encodeCompact(prefix, compact) {
+  const compressed = zlib.deflateRawSync(Buffer.from(JSON.stringify(compact), "utf8"));
+  return `${prefix}.${checksum(compressed)}.${compressed.toString("base64url")}`;
+}
+
 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")}`;
+  return encodeCompact(record.schema_version === 2 ? "cwr2" : "cwr1", compactReceipt(record));
 }
 
-export function decodeReceiptPayload(payload) {
-  const [prefix, checksum, encoded] = String(payload).split(".");
-  if (prefix !== "cwr1" || !checksum || !encoded) throw new Error("无效的打工小票二维码");
+function qrVersion(payload) {
+  return QRCode.create(payload, { errorCorrectionLevel: "M" }).version;
+}
+
+function fitsVersion(payload, maxVersion) {
+  try {
+    return qrVersion(payload) <= maxVersion;
+  } catch {
+    return false;
+  }
+}
+
+function multipartPayload(transferId, partIndex, partCount, totalChecksum, chunk) {
+  return `cwr2p.${transferId}.${partIndex}.${partCount}.${totalChecksum}.${checksum(chunk)}.${chunk}`;
+}
+
+function maxChunkSize(singlePayload, maxVersion) {
+  const transferId = checksum(singlePayload, 12);
+  const totalChecksum = checksum(singlePayload);
+  let low = 32;
+  let high = singlePayload.length;
+
+  while (low < high) {
+    const middle = Math.ceil((low + high) / 2);
+    const candidate = multipartPayload(transferId, 12, 12, totalChecksum, singlePayload.slice(0, middle));
+    if (fitsVersion(candidate, maxVersion)) low = middle;
+    else high = middle - 1;
+  }
+  return low;
+}
+
+export function encodeReceiptPayloads(record, options = {}) {
+  const maxVersion = options.maxVersion || MAX_QR_VERSION;
+  const maxParts = options.maxParts || MAX_MULTIPART_PARTS;
+  const singlePayload = encodeReceiptPayload(record);
+  if (fitsVersion(singlePayload, maxVersion)) return [singlePayload];
+  if (!singlePayload.startsWith("cwr2.")) {
+    throw new Error("旧版小票数据超过单个二维码容量");
+  }
+
+  const chunkSize = maxChunkSize(singlePayload, maxVersion);
+  const chunks = [];
+  for (let offset = 0; offset < singlePayload.length; offset += chunkSize) {
+    chunks.push(singlePayload.slice(offset, offset + chunkSize));
+  }
+  if (chunks.length > maxParts) {
+    throw new Error(`小票数据需要 ${chunks.length} 个二维码，超过 ${maxParts} 个上限，请缩小统计范围`);
+  }
+
+  const transferId = checksum(singlePayload, 12);
+  const totalChecksum = checksum(singlePayload);
+  return chunks.map((chunk, index) => (
+    multipartPayload(transferId, index + 1, chunks.length, totalChecksum, chunk)
+  ));
+}
+
+function decodeSinglePayload(payload) {
+  const [prefix, expectedChecksum, encoded] = String(payload).split(".");
+  if ((prefix !== "cwr1" && prefix !== "cwr2") || !expectedChecksum || !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("二维码数据校验失败");
+  if (checksum(compressed) !== expectedChecksum) throw new Error("二维码数据校验失败");
   return JSON.parse(zlib.inflateRawSync(compressed).toString("utf8"));
 }
+
+export function decodeReceiptPayload(payload) {
+  return decodeSinglePayload(payload);
+}
+
+export function decodeMultipartReceiptPayloads(payloads) {
+  const parts = payloads.map((payload) => {
+    const fields = String(payload).split(".");
+    const [prefix, transferId, indexText, countText, totalChecksum, partChecksum] = fields;
+    const chunk = fields.slice(6).join(".");
+    const index = Number(indexText);
+    const count = Number(countText);
+    if (
+      prefix !== "cwr2p" || !transferId || !totalChecksum || !chunk ||
+      !Number.isInteger(index) || !Number.isInteger(count) || index < 1 || index > count || count > MAX_MULTIPART_PARTS ||
+      checksum(chunk) !== partChecksum
+    ) throw new Error("无效的分片二维码");
+    return { transferId, index, count, totalChecksum, chunk };
+  });
+  if (!parts.length) throw new Error("缺少分片二维码");
+  const first = parts[0];
+  if (parts.some((part) => (
+    part.transferId !== first.transferId || part.count !== first.count || part.totalChecksum !== first.totalChecksum
+  ))) throw new Error("分片二维码不属于同一张小票");
+  const unique = new Map(parts.map((part) => [part.index, part]));
+  if (unique.size !== first.count) throw new Error("分片二维码尚未集齐");
+  const singlePayload = [...unique.values()].sort((left, right) => left.index - right.index).map((part) => part.chunk).join("");
+  if (checksum(singlePayload) !== first.totalChecksum) throw new Error("分片二维码总校验失败");
+  return decodeSinglePayload(singlePayload);
+}
+
+export function inspectReceiptPayloadPart(payload) {
+  const fields = String(payload).split(".");
+  const [prefix, transferId, indexText, countText, totalChecksum, partChecksum] = fields;
+  const chunk = fields.slice(6).join(".");
+  if (prefix !== "cwr2p") return null;
+  const index = Number(indexText);
+  const count = Number(countText);
+  if (!transferId || !chunk || checksum(chunk) !== partChecksum || !Number.isInteger(index) || !Number.isInteger(count)) {
+    throw new Error("无效的分片二维码");
+  }
+  return { transferId, index, count, totalChecksum };
+}

package/src/core/range.mjs

@@ -91,9 +91,28 @@ export function calendarDayCount(range) {
   return count;
 }
 
-export function outputSlugForScope(scope) {
-  if (scope === "last-7-days") return "last-7-days";
-  if (scope === "this-week") return "this-week";
-  if (scope === "session") return "session";
-  return scope;
+function safeSlugSegment(value, fallback = "receipt") {
+  const normalized = String(value || "")
+    .trim()
+    .replace(/^cwr_/, "")
+    .replace(/[^a-zA-Z0-9-]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 24);
+  return normalized || fallback;
+}
+
+export function outputSlugForRange(range, receiptId = "") {
+  const scope = normalizeScope(range?.scope) || "latest";
+  const startDate = range?.startDate || range?.targetDate || "";
+  const endDate = range?.endDate || range?.targetDate || startDate;
+
+  if (scope === "today") return `today-${safeSlugSegment(endDate, "today")}`;
+  if (scope === "last-7-days" || scope === "this-week") {
+    const dateSpan = startDate === endDate ? endDate : `${startDate}-to-${endDate}`;
+    return `${scope}-${safeSlugSegment(dateSpan, scope)}`;
+  }
+  if (scope === "session") {
+    return `session-${safeSlugSegment(range?.sessionId || receiptId, "selected")}`;
+  }
+  return `latest-${safeSlugSegment(receiptId || endDate, "receipt")}`;
 }

package/src/core/receipt-record.mjs

@@ -3,28 +3,27 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
+import { canonicalStringify, sha256Hex } from "./canonical.mjs";
+import { buildLogicalReceiptKey, buildProtocolReceiptId } from "./fact-identity.mjs";
 import {
   buildCompensation,
   DEFAULT_LOCALE,
   getWorkProfileCopy,
 } from "./presentation.mjs";
 
-const SCHEMA_VERSION = 1;
-const COLLECTOR_VERSION = "0.4.0";
+const SCHEMA_VERSION = 2;
+const SOURCE_VERSION = "cwr2";
+const COLLECTOR_VERSION = "0.6.0";
 
 function fingerprintSessionIds(sessionIds) {
   return crypto.createHash("sha256").update([...sessionIds].sort().join("|")).digest("hex").slice(0, 16);
 }
 
-export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = DEFAULT_LOCALE) {
+export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = DEFAULT_LOCALE, canonical = {}) {
   const sessionFingerprint = fingerprintSessionIds(metrics.sessionIds);
-  const logicalKey = metrics.mode === "latest" || metrics.mode === "session"
-    ? `latest:${sessionFingerprint}`
-    : metrics.mode === "this-week"
-      ? `this-week:${metrics.rangeStartDate}:${metrics.timezone}`
-      : `${metrics.mode}:${metrics.rangeStartDate}:${metrics.rangeEndDate}:${metrics.timezone}`;
-  const id = `cwr_${crypto.createHash("sha256").update(logicalKey).digest("hex").slice(0, 16)}`;
-  const snapshotHash = crypto.createHash("sha256").update(JSON.stringify({
+  const logicalKey = buildLogicalReceiptKey(metrics);
+  const id = buildProtocolReceiptId(SOURCE_VERSION, logicalKey);
+  const snapshotHash = sha256Hex({
     start: metrics.startAt.toISOString(),
     end: metrics.endAt.toISOString(),
     tokens: metrics.tokens,
@@ -34,9 +33,31 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
     scope: metrics.mode,
     rangeStartDate: metrics.rangeStartDate,
     rangeEndDate: metrics.rangeEndDate,
-  })).digest("hex").slice(0, 16);
+  });
   const workProfileId = metrics.workProfileId || "temporary-hire";
   const workProfile = getWorkProfileCopy(workProfileId, locale);
+  const facts = Array.isArray(canonical.facts) ? canonical.facts : [];
+  const coverage = canonical.coverage || {
+    kind: "selected_sessions",
+    scan_mode: "none",
+    start_date: metrics.rangeStartDate,
+    end_date: metrics.rangeEndDate,
+    complete_through_date: null,
+    observed_through_at: new Date().toISOString(),
+  };
+  const manifestCore = {
+    version: 1,
+    fact_schema_version: 1,
+    metric_schema_version: 1,
+    accounting_timezone: "Asia/Shanghai",
+    fact_count: facts.length,
+    fact_ids: facts.map((fact) => fact.fact_id),
+    coverage,
+  };
+  const manifest = {
+    ...manifestCore,
+    manifest_hash: sha256Hex(canonicalStringify(manifestCore)),
+  };
 
   return {
     schema_version: SCHEMA_VERSION,
@@ -45,6 +66,7 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
     generated_at: new Date().toISOString(),
     source: {
       type: "codex",
+      version: SOURCE_VERSION,
       scope: metrics.mode,
       collector_version: COLLECTOR_VERSION,
       logical_key: logicalKey,
@@ -68,6 +90,8 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       average_first_token_ms: Math.round(metrics.averageFirstTokenMs),
       tokens: { ...metrics.tokens },
       models: [...metrics.models],
+      receipt_work_points: metrics.workPoints,
+      receipt_formula_version: "receipt_work_points_v1",
     },
     presentation: {
       default_theme: defaultTheme,
@@ -83,6 +107,8 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       contains_paths: false,
       contains_filenames: false,
     },
+    manifest,
+    facts,
   };
 }
 

package/src/core/source-revision.mjs

@@ -0,0 +1,17 @@
+export function compareSourceRevision(candidate, current) {
+  if (!current) return "newer";
+  if (!candidate) return "conflict";
+
+  const candidateRows = Number(candidate.row_count ?? candidate.rowCount ?? 0);
+  const currentRows = Number(current.row_count ?? current.rowCount ?? 0);
+  const candidateBytes = Number(candidate.byte_length ?? candidate.byteLength ?? 0);
+  const currentBytes = Number(current.byte_length ?? current.byteLength ?? 0);
+  const candidateTail = String(candidate.tail_hash ?? candidate.tailHash ?? "");
+  const currentTail = String(current.tail_hash ?? current.tailHash ?? "");
+
+  if (candidateRows === currentRows && candidateBytes === currentBytes) {
+    return candidateTail === currentTail ? "same" : "conflict";
+  }
+  if (candidateRows >= currentRows && candidateBytes >= currentBytes) return "newer";
+  return "stale";
+}

package/src/parsers/codex.mjs

@@ -1,3 +1,4 @@
+import crypto from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -20,24 +21,33 @@ function readJsonl(filePath) {
   for (const [lineIndex, line] of source.split("\n").entries()) {
     if (!line.trim()) continue;
     try {
-      rows.push(JSON.parse(line));
+      rows.push({ ...JSON.parse(line), __sourceLine: lineIndex + 1 });
     } catch {
       console.warn(`跳过无法解析的记录：${path.basename(filePath)}:${lineIndex + 1}`);
     }
   }
-  return rows;
+  return { rows, source };
 }
 
 function sessionFromFile(file) {
-  const rows = readJsonl(file.filePath);
+  const { rows, source } = readJsonl(file.filePath);
   const meta = rows.find((row) => row.type === "session_meta")?.payload || {};
+  const metadataSessionId = meta.session_id || meta.id || null;
   const timestamps = rows.map(rowDate).filter(Boolean).sort((left, right) => left - right);
   const fallbackDate = new Date(file.modifiedAt);
+  const sourceBuffer = Buffer.from(source, "utf8");
   return {
     rows,
     filePath: file.filePath,
     modifiedAt: file.modifiedAt,
-    sessionId: meta.session_id || meta.id || path.basename(file.filePath, ".jsonl"),
+    sessionId: metadataSessionId || path.basename(file.filePath, ".jsonl"),
+    identityQuality: metadataSessionId ? "metadata" : "filename_fallback",
+    sourceRevision: {
+      kind: "append-only-jsonl-v1",
+      row_count: rows.length,
+      byte_length: sourceBuffer.byteLength,
+      tail_hash: crypto.createHash("sha256").update(sourceBuffer.subarray(-4096)).digest("hex"),
+    },
     startAt: timestamps[0] || fallbackDate,
     endAt: timestamps.at(-1) || fallbackDate,
   };
@@ -62,6 +72,7 @@ function calendarCandidates(files, startDate) {
 export function loadCodexSessions(range) {
   const files = codexSessionFiles();
   let candidates = files;
+  let scanMode = "none";
 
   if (range.scope === "latest") {
     candidates = files.slice(0, 40);
@@ -69,19 +80,28 @@ export function loadCodexSessions(range) {
     const filenameMatches = files.filter((file) => path.basename(file.filePath).includes(range.sessionId));
     candidates = filenameMatches.length ? filenameMatches : files;
   } else {
-    candidates = calendarCandidates(files, range.startDate);
+    const fullScan = process.env.CODEX_WORK_RECEIPT_FULL_SCAN === "1";
+    candidates = fullScan ? files : calendarCandidates(files, range.startDate);
+    scanMode = fullScan ? "full" : "best_effort";
   }
 
   const sessions = candidates
     .map(sessionFromFile)
     .sort((left, right) => right.endAt - left.endAt);
 
-  if (range.scope === "latest") return sessions.slice(0, 1);
+  if (range.scope === "latest") {
+    const selected = sessions.slice(0, 1);
+    selected.scanMode = scanMode;
+    return selected;
+  }
   if (range.scope === "session") {
     const selected = sessions.find((session) => session.sessionId === range.sessionId);
     if (!selected) throw new Error(`没有找到指定的 Codex 会话：${range.sessionId}`);
-    return [selected];
+    const result = [selected];
+    result.scanMode = scanMode;
+    return result;
   }
+  sessions.scanMode = scanMode;
   return sessions;
 }