codex-work-receipt 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 
-## 0.7.0 - 2026-07-19
+## 0.7.2
+
+- 修复同一 Codex 会话存在多份 append-only 日志修订时生成重复 canonical factId、导致小程序云端入库拒绝的问题。
+- cwr2 manifest 输出前新增 factId 唯一性防线，避免无效二维码进入扫码链路。
+- “最近 N 小时”在交互选择、终端输出和 HTML 中明确标记为私人滚动摘要，并提示其不参与 AI 供销社统计。
+
+## 0.7.1
+
+- 修正 HTML 长图导出：PNG 只保留完整小票和微信小程序码，不再包含数据二维码或分片数据码。
+
+## 0.7.0
 
 - 新增 Codex 原生桌宠“票仔 · AI 小票工”，提供夜班绿票风格的核心状态与左右移动动画，并支持通过 `--install-pet`、`--uninstall-pet` 和 `--install-companion` 安装管理。
 - AI 打工小票 Skill 新增“票仔，开今天的票”等自然语言入口。

package/README.en.md

@@ -24,6 +24,16 @@ Codex Work Receipt summarizes turns, tool calls, Tokens, duration, and models, t
 
 Version `0.6.0` uses the cwr2 protocol to create stable privacy-safe facts for each session and calendar day. Overlapping today, last-seven-days, and this-week receipts can be deduplicated by the receiver, and oversized payloads are automatically split into reorderable multipart QR codes that rotate one at a time in the HTML so the camera never sees multiple data codes at once.
 
+## Meet Ticket Buddy
+
+<p align="center">
+  <a href="docs/codex-pet.en.md"><img src="docs/images/codex-pet-showcase.png" alt="Ticket Buddy in idle, working, needs-input, ready, and failed states" width="920"></a>
+</p>
+
+<p align="center">
+  <sub>Ticket Buddy changes expression as Codex becomes idle, runs a task, needs input, finishes, or gets blocked. Select the image for setup and state details.</sub>
+</p>
+
 ## Quickstart
 
 Requires Node.js 20+ and local Codex session records. No clone required; choose today, the last 3 hours, the last 7 days, this week, or a specific session:
@@ -44,7 +54,9 @@ Summarize the last 3 hours:
 npx codex-work-receipt@latest --hours 3 --lang en
 ```
 
-HTML and structured data are written to `./codex-work-receipt-output/` by default. The generated page can save a high-resolution PNG containing the full receipt and QR import stub. Non-interactive options such as `--latest` and `--today` remain available; see the [CLI guide](docs/cli.en.md).
+“Last N hours” is a rolling summary for private history only. It does not participate in AI Work Cooperative deduplicated accounting. Use today, this week, the last seven days, or a specific session when you want accountable canonical facts.
+
+HTML and structured data are written to `./codex-work-receipt-output/` by default. The generated page can save a high-resolution PNG containing only the full receipt and WeChat mini-program code; data QR codes are excluded. Non-interactive options such as `--latest` and `--today` remain available; see the [CLI guide](docs/cli.en.md).
 
 ## Ask Codex directly
 
@@ -89,9 +101,9 @@ The desktop page generates one or more privacy-safe data QR codes. The companion
 ## Sponsor
 
 <p align="center">
-  <a href="https://modelflare.dev/"><img src="docs/images/sponsors/modelflare-logo.png" alt="ModelFlare Logo" width="56"></a><br>
-  <a href="https://modelflare.dev/"><strong>ModelFlare</strong></a> · <a href="https://modelflare.dev/">modelflare.dev</a><br>
-  <sub>Helping independent developers access leading AI model APIs reliably and at a very low cost, so they can quickly build their own products with advanced model capabilities.</sub>
+  <a href="https://modelflare.dev/sign-up?partner=OB9YXNSEEGOL"><img src="docs/images/sponsors/modelflare-logo.png" alt="ModelFlare Logo" width="56"></a><br>
+  <a href="https://modelflare.dev/sign-up?partner=OB9YXNSEEGOL"><strong>ModelFlare</strong></a> · <a href="https://modelflare.dev/sign-up?partner=OB9YXNSEEGOL">modelflare.dev</a><br>
+  <sub>Affordable and reliable access to leading AI model APIs, helping independent developers validate ideas faster and turn them into real products.</sub>
 </p>
 
 ## License

package/README.md

@@ -24,6 +24,16 @@
 
 `0.6.0` 使用 cwr2 协议，按“会话 × 自然日”生成稳定的脱敏事实。今日、近 7 日和本周小票即使范围重叠，接收端也能识别相同工作；数据过大时会自动生成多张可重组的分片二维码，并在 HTML 中逐张自动轮播，避免镜头同时识别多个数据码。
 
+## 认识票仔
+
+<p align="center">
+  <a href="docs/codex-pet.md"><img src="docs/images/codex-pet-showcase.png" alt="票仔 AI 小票工的待机、打工、等待确认、完成和失败状态" width="920"></a>
+</p>
+
+<p align="center">
+  <sub>票仔会跟随 Codex 的空闲、执行、等待确认、完成和失败状态切换表情。点击图片查看安装与状态说明。</sub>
+</p>
+
 ## Quickstart
 
 需要 Node.js 20 或更高版本，并且本机已经使用过 Codex。无需克隆仓库，运行后选择“今天 / 最近 3 小时 / 近 7 日 / 本周 / 指定会话”：
@@ -44,7 +54,9 @@ npx codex-work-receipt@latest --today
 npx codex-work-receipt@latest --hours 3
 ```
 
-网页和结构数据默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键保存包含主小票和二维码导入联的高清长图。也可以继续使用 `--latest`、`--today` 等非交互参数，详见 [CLI 使用文档](docs/cli.md)。
+“最近 N 小时”是滚动摘要，只用于查看和保存私人历史，不参与 AI 供销社的去重统计。需要进入供销社时，请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。
+
+网页和结构数据默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键保存只包含完整小票和微信小程序码的高清长图，数据二维码不会进入图片。也可以继续使用 `--latest`、`--today` 等非交互参数，详见 [CLI 使用文档](docs/cli.md)。
 
 ## 直接跟 Codex 说
 
@@ -89,9 +101,9 @@ Codex 会选择统计范围和主题、执行命令并打开小票。详见 [Cod
 ## 赞助商
 
 <p align="center">
-  <a href="https://modelflare.dev/"><img src="docs/images/sponsors/modelflare-logo.png" alt="ModelFlare Logo" width="56"></a><br>
-  <a href="https://modelflare.dev/"><strong>ModelFlare</strong></a> · <a href="https://modelflare.dev/">modelflare.dev</a><br>
-  <sub>让个人开发者也可以以很低的成本、稳定地接入前沿 AI 模型的 API，借助模型能力快速构建自己的产品。</sub>
+  <a href="https://modelflare.dev/sign-up?partner=OB9YXNSEEGOL"><img src="docs/images/sponsors/modelflare-logo.png" alt="ModelFlare Logo" width="56"></a><br>
+  <a href="https://modelflare.dev/sign-up?partner=OB9YXNSEEGOL"><strong>ModelFlare</strong></a> · <a href="https://modelflare.dev/sign-up?partner=OB9YXNSEEGOL">modelflare.dev</a><br>
+  <sub>为个人开发者提供价格友好、稳定便捷的前沿 AI 模型 API 接入，帮助你更快完成原型验证，把想法变成真正可用的产品。</sub>
 </p>
 
 ## License

package/docs/cli.en.md

@@ -39,7 +39,7 @@ Summarize the last 3 hours:
 npx codex-work-receipt@latest --hours 3 --lang en
 ```
 
-`--hours` accepts an integer from 1 to 168 and filters exact timestamps, including windows that cross midnight. Rolling-hour receipts use the compatible cwr1 summary protocol and do not create cwr2 session-day canonical facts.
+`--hours` accepts an integer from 1 to 168 and filters exact timestamps, including windows that cross midnight. Rolling-hour receipts use the compatible cwr1 summary protocol, stay in private history, and do not participate in AI Work Cooperative accounting. Use today, this week, the last seven days, or a specific session for cwr2 session-day canonical facts.
 
 Last 7 calendar days, including today:
 
@@ -87,7 +87,7 @@ Default output:
 
 Default filenames include the calendar range. Latest-session and selected-session receipts include a short identifier so receipts from different dates or sessions do not overwrite one another.
 
-Open the generated HTML and click “Save full PNG” to download a high-resolution image. It includes the main receipt, mini-program code, and data QR import stub in the currently selected theme. Theme controls, the page background, and the footer note are excluded. With one data QR, the mini-program code and data code remain side by side. When cwr2 exceeds the safe capacity of one QR code, the page shows the mini-program code first and then rotates multipart data codes one at a time without desktop clicks. The full PNG still includes every numbered part so the offline payload remains complete.
+Open the generated HTML and click “Save full PNG” to download a high-resolution image. It contains only the complete main receipt and WeChat mini-program code in the currently selected theme. Data QR codes, multipart data codes, theme controls, the page background, and the footer note are excluded. The HTML page still presents data codes normally: a single code stays beside the mini-program code, while oversized cwr2 payloads rotate their parts after the mini program has been opened so they can be imported on the phone.
 
 Set a timezone and output path:
 

package/docs/cli.md

@@ -39,7 +39,7 @@ npx codex-work-receipt@latest --today
 npx codex-work-receipt@latest --hours 3
 ```
 
-`--hours` 支持 1～168 的整数，并按精确时间戳筛选，可以跨越午夜。滚动小时小票使用兼容的 cwr1 摘要协议，不会写入 cwr2 的“会话 × 自然日”规范事实。
+`--hours` 支持 1～168 的整数，并按精确时间戳筛选，可以跨越午夜。滚动小时小票使用兼容的 cwr1 摘要协议，不会写入 cwr2 的“会话 × 自然日”规范事实，只保存到私人历史，不参与 AI 供销社统计。需要进入供销社时，请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。
 
 最近 7 个自然日（含今天）：
 
@@ -87,7 +87,7 @@ npx codex-work-receipt@latest --latest --theme diner
 
 默认文件名会携带统计日期范围；最近会话和指定会话则携带短编号，避免不同日期或会话的小票互相覆盖。
 
-打开生成的 HTML 后，点击“保存完整长图”即可下载高清 PNG。图片包含主小票、小程序码和数据二维码导入联，并自动使用当前选择的主题；主题按钮、网页背景和底部说明不会进入图片。只有一个数据二维码时，小程序码与数据码继续并排展示。cwr2 数据超过单码安全容量时，网页先单独展示小程序码，随后自动逐张轮播分片数据码；用户无需在电脑上切换上一张或下一张，但仍需在小程序中收齐全部分片。完整长图为保留离线数据，会继续包含全部带序号的分片二维码。
+打开生成的 HTML 后，点击“保存完整长图”即可下载高清 PNG。图片只包含完整主小票和微信小程序码，并自动使用当前选择的主题；数据二维码、分片数据码、主题按钮、网页背景和底部说明都不会进入图片。网页本身仍会正常展示数据二维码：单码时与小程序码并排，cwr2 超出单码安全容量时则在打开小程序后自动逐张轮播分片数据码，供用户在小程序中完成导入。
 
 指定时区和输出路径：
 

package/docs/codex-pet.md

@@ -30,6 +30,8 @@ npx codex-work-receipt@latest --install-companion
 
 “最近几个小时”默认表示最近 3 小时。
 
+最近 N 小时小票是私人滚动摘要，不进入 AI 供销社；需要参与供销社统计时，请让票仔生成今日、本周、近七日或指定会话小票。
+
 ## 只安装或卸载桌宠
 
 只安装票仔：

package/docs/codex-skill.md

@@ -38,6 +38,8 @@ Skill 会安装到：
 
 Codex 会根据表达选择单次会话、最近 1～168 小时、今天、近七日或本周，以及语言和主题，然后执行命令并打开生成的网页。“最近几个小时”默认统计最近 3 小时。
 
+“最近 N 小时”生成的是只用于私人历史的滚动摘要，不进入 AI 供销社；如果用户明确希望参与供销社统计，应改用今日、本周、近七日或指定会话范围。
+
 如果当前 Codex 任务仍在运行，而你希望立刻查看小票，建议新开一个本地 Codex 会话再说“开今天的票”；在当前运行会话中发送的消息可能根据 Follow-up behavior 被用于 Steer 或 Queue。
 
 也可以通过 `$ai-work-receipt` 显式调用这个 Skill。

package/docs/data-schema.en.md

@@ -32,7 +32,9 @@ cwr2p.<transferId>.<partIndex>.<partCount>.<totalChecksum>.<partChecksum>.<chunk
 
 The mini program validates the prefix and checksum before decompressing and parsing the payload. Future schema versions use the compact `v` field for compatibility.
 
-Compact field `o` explicitly carries `latest`, `session`, `last-hours`, `today`, `last-7-days`, or `this-week`. `d[3]` and `d[4]` carry date boundaries. Today, last-seven-days, and this-week receipts continue to use cwr2 canonical facts. `last-hours` is a rolling window, so it uses the compatible cwr1 summary payload to avoid colliding with session-day fact identities. The updated mini program can still import older QR codes.
+Compact field `o` explicitly carries `latest`, `session`, `last-hours`, `today`, `last-7-days`, or `this-week`. `d[3]` and `d[4]` carry date boundaries. Today, last-seven-days, and this-week receipts continue to use cwr2 canonical facts. `last-hours` is a rolling window, so it uses the compatible cwr1 summary payload to avoid colliding with session-day fact identities; it stays in private history and does not participate in AI Work Cooperative accounting. The updated mini program can still import older QR codes.
+
+When the same Codex session has multiple append-only log revisions, the generator keeps the more complete revision. Fact IDs in a cwr2 manifest must be unique; an identity collision stops QR generation instead of emitting an invalid payload.
 
 `presentation.compensation` contains playful AI work points, not real API cost. For compatibility with the current Chinese mini program, QR display copy remains Chinese while compact fields `l` and `r` carry the desktop locale and language-neutral role ID. English HTML and local JSON remain fully localized.
 

package/docs/data-schema.md

@@ -32,7 +32,9 @@ cwr2p.<transferId>.<partIndex>.<partCount>.<totalChecksum>.<partChecksum>.<chunk
 
 小程序应检查前缀和校验值，再解压并解析数据。未来结构升级通过 `v` 字段兼容。
 
-精简字段 `o` 显式携带 `latest`、`session`、`last-hours`、`today`、`last-7-days` 或 `this-week`；`d[3]` 和 `d[4]` 携带日期边界。今日、近 7 日和本周继续使用 cwr2 canonical facts。`last-hours` 是滚动时间窗，为避免与“会话 × 自然日”事实发生身份冲突，使用兼容的 cwr1 摘要载荷。旧二维码仍可由新版小程序导入。
+精简字段 `o` 显式携带 `latest`、`session`、`last-hours`、`today`、`last-7-days` 或 `this-week`；`d[3]` 和 `d[4]` 携带日期边界。今日、近 7 日和本周继续使用 cwr2 canonical facts。`last-hours` 是滚动时间窗，为避免与“会话 × 自然日”事实发生身份冲突，使用兼容的 cwr1 摘要载荷，只进入私人历史、不参与 AI 供销社统计。旧二维码仍可由新版小程序导入。
+
+同一 Codex 会话出现多份 append-only 日志修订时，生成器只采用更完整的修订；cwr2 manifest 中的 factId 必须唯一，检测到身份冲突时不会输出可扫码二维码。
 
 `presentation.compensation` 是娱乐化 AI 工分，不代表真实 API 费用。为兼容当前中文小程序，二维码展示文案继续使用中文，并通过精简字段 `l` 和 `r` 携带桌面语言及工种语义 ID；英文 HTML 和本地 JSON 不受影响。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-work-receipt",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "description": "Generate a privacy-first Codex work receipt from local session metadata.",
   "author": "a-bai-2026",

package/skills/ai-work-receipt/SKILL.md

@@ -13,6 +13,7 @@ Use the published `codex-work-receipt` CLI as the only statistics and rendering
 - Use `--hours <N>` for “最近 N 小时”“过去 N 小时” or “近 N 小时”. Accept integers from 1 to 168.
 - Use `--hours 3` for an unspecified “最近几个小时”“过去几个小时” request.
 - Use `--hours 12` for “最近半天”.
+- Treat `--hours` receipts as rolling summaries for private history only. They do not participate in AI Work Cooperative accounting; if the user asks for an accountable cooperative receipt, use today, this week, the last seven days, or a specific session instead.
 - Use `--today` for “今天”“今日”“今天全部工作” or a daily summary.
 - Use `--range last-7-days` for “最近七天”“近 7 日” or a rolling seven-calendar-day summary.
 - Use `--range this-week` for “本周”“这周” or a Monday-to-now summary.
@@ -39,6 +40,7 @@ Replace only the mode and optional flags according to the request.
 
 3. Let the CLI open the generated HTML unless the user requested `--no-open`.
 4. On success, report the HTML path and tell the user to scan the official mini-program code first, then the adjacent data QR code.
+5. When `--hours` was used, explicitly state that the receipt is a private rolling summary and will not enter AI Work Cooperative statistics.
 
 ## Privacy and failures
 

package/src/cli.mjs

@@ -9,7 +9,7 @@ import QRCode from "qrcode";
 import { parseArgs, printHelp } from "./core/args.mjs";
 import { buildCanonicalFacts } from "./core/fact-buckets.mjs";
 import { collectMetrics } from "./core/metrics.mjs";
-import { getScopeLabel } from "./core/presentation.mjs";
+import { getRollingSummaryNotice, getScopeLabel } from "./core/presentation.mjs";
 import { encodeReceiptPayloads } from "./core/qr-payload.mjs";
 import { outputSlugForRange, resolveRange } from "./core/range.mjs";
 import { buildReceiptRecord, persistReceiptRecord } from "./core/receipt-record.mjs";
@@ -145,6 +145,9 @@ async function main() {
     console.log(record.manifest
       ? `Data QR: ${qrPayloads.length} code(s) · ${record.manifest.fact_count} canonical fact(s) · schema v${record.schema_version}`
       : `Data QR: ${qrPayloads.length} code(s) · rolling summary · schema v${record.schema_version}`);
+    if (record.source.scope === "last-hours") {
+      console.log(`Note: ${getRollingSummaryNotice(options.locale, record.source.hours)}`);
+    }
     if (!miniProgramCodeDataUrl) console.log("Mini-program code: not configured; using the explicit placeholder");
   } else {
     console.log(`已生成网页：${outputFile}`);
@@ -155,6 +158,9 @@ async function main() {
     console.log(record.manifest
       ? `数据二维码：${qrPayloads.length} 个 · ${record.manifest.fact_count} 条规范事实 · schema v${record.schema_version}`
       : `数据二维码：${qrPayloads.length} 个 · 滚动摘要 · schema v${record.schema_version}`);
+    if (record.source.scope === "last-hours") {
+      console.log(`提示：${getRollingSummaryNotice(options.locale, record.source.hours)}`);
+    }
     if (!miniProgramCodeDataUrl) console.log("小程序码：尚未配置，页面使用明确占位符");
   }
   if (options.open) openFile(outputFile);

package/src/core/fact-buckets.mjs

@@ -198,6 +198,11 @@ export function buildCanonicalFacts(sessions, range, options = {}) {
     left.local_date.localeCompare(right.local_date) || left.fact_id.localeCompare(right.fact_id)
   ));
 
+  const uniqueFactIds = new Set(facts.map((fact) => fact.fact_id));
+  if (uniqueFactIds.size !== facts.length) {
+    throw new Error("检测到重复的规范事实，请更新生成器后重新生成小票");
+  }
+
   return {
     facts,
     coverage: coverageForRange(range, sessions.scanMode || options.scanMode || "best_effort", observedAt),

package/src/core/presentation.mjs

@@ -142,10 +142,12 @@ const RECEIPT_COPY = {
     multipartRestart: "重新显示小程序码",
     dataQrAlt: "当前小票数据二维码",
     miniProgramAlt: "微信小程序码",
+    exportMiniProgramLabel: "微信扫码打开小程序",
     placeholderLabel: "小程序码",
     placeholderValue: "待接入",
     placeholderAria: "小程序码待接入",
     transferNote: "数据码只包含时间、轮次、Token和工具调用等统计，不包含Prompt、回复正文、代码、项目路径或文件名。",
+    rollingSummaryNotice: "最近 {hours} 小时属于滚动摘要，只保存到私人历史，不参与 AI 供销社统计。需要统计时请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。",
     privacy: "结构数据同时保存在本机，未来可以批量导入小程序历史记录。",
   },
   en: {
@@ -215,10 +217,12 @@ 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",
     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.",
+    rollingSummaryNotice: "The last {hours} hours is a rolling summary for private history only. It does not participate in AI Work Cooperative accounting. Use today, this week, the last seven days, or a specific session for accountable facts.",
     privacy: "Structured data is also stored locally for future batch import into your mini-program history.",
   },
 };
@@ -271,6 +275,10 @@ export function getScopeLabel(scope, locale = DEFAULT_LOCALE, hours = null) {
   return String(template).replaceAll("{hours}", String(hours || 3));
 }
 
+export function getRollingSummaryNotice(locale = DEFAULT_LOCALE, hours = null) {
+  return String(getReceiptCopy(locale).rollingSummaryNotice).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/selector.mjs

@@ -37,7 +37,9 @@ 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 3 hours" : "2. 最近 3 小时");
+    console.log(isEnglish
+      ? "2. Last 3 hours (private rolling summary; not counted by the cooperative)"
+      : "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. 选择一个具体会话");

package/src/parsers/codex.mjs

@@ -69,6 +69,38 @@ function calendarCandidates(files, startDate) {
   return files.filter((file) => file.modifiedAt >= approximateStart);
 }
 
+function revisionDominates(candidate, current) {
+  const candidateRevision = candidate.sourceRevision || {};
+  const currentRevision = current.sourceRevision || {};
+  const candidateRows = Number(candidateRevision.row_count || 0);
+  const currentRows = Number(currentRevision.row_count || 0);
+  const candidateBytes = Number(candidateRevision.byte_length || 0);
+  const currentBytes = Number(currentRevision.byte_length || 0);
+  return candidateRows >= currentRows && candidateBytes >= currentBytes
+    && (candidateRows > currentRows || candidateBytes > currentBytes);
+}
+
+function preferSession(candidate, current) {
+  if (revisionDominates(candidate, current)) return true;
+  if (revisionDominates(current, candidate)) return false;
+
+  const candidateModifiedAt = Number(candidate.modifiedAt || candidate.endAt || 0);
+  const currentModifiedAt = Number(current.modifiedAt || current.endAt || 0);
+  if (candidateModifiedAt !== currentModifiedAt) return candidateModifiedAt > currentModifiedAt;
+
+  return String(candidate.filePath || "").localeCompare(String(current.filePath || "")) > 0;
+}
+
+export function deduplicateCodexSessions(sessions) {
+  const selected = new Map();
+  for (const session of sessions) {
+    const key = `${session.identityQuality || "metadata"}:${session.sessionId}`;
+    const current = selected.get(key);
+    if (!current || preferSession(session, current)) selected.set(key, session);
+  }
+  return [...selected.values()];
+}
+
 export function loadCodexSessions(range) {
   const files = codexSessionFiles();
   let candidates = files;
@@ -85,8 +117,7 @@ export function loadCodexSessions(range) {
     scanMode = fullScan ? "full" : "best_effort";
   }
 
-  const sessions = candidates
-    .map(sessionFromFile)
+  const sessions = deduplicateCodexSessions(candidates.map(sessionFromFile))
     .sort((left, right) => right.endAt - left.endAt);
 
   if (range.scope === "latest") {
@@ -106,10 +137,10 @@ export function loadCodexSessions(range) {
 }
 
 export function listRecentCodexSessions(limit = 10) {
-  const sessions = codexSessionFiles()
+  const sessions = deduplicateCodexSessions(codexSessionFiles()
     .slice(0, Math.max(40, limit * 3))
     .map(sessionFromFile)
-    .filter((session) => session.rows.length)
+    .filter((session) => session.rows.length))
     .sort((left, right) => right.endAt - left.endAt)
     .slice(0, limit);
 

package/src/renderers/html.mjs

@@ -7,6 +7,7 @@ import {
   buildCompensation,
   DEFAULT_LOCALE,
   getReceiptCopy,
+  getRollingSummaryNotice,
   getScopeLabel,
 } from "../core/presentation.mjs";
 
@@ -71,6 +72,9 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
   const isCalendarScope = new Set(["today", "last-7-days", "this-week"]).has(record.source.scope);
   const spansMultipleDates = rangeStartDate !== rangeEndDate;
   const scopeLabel = getScopeLabel(record.source.scope, locale, record.source.hours);
+  const rollingSummaryNotice = record.source.scope === "last-hours"
+    ? getRollingSummaryNotice(locale, record.source.hours)
+    : null;
   const dateRange = spansMultipleDates
     ? `${formatDateKey(rangeStartDate, locale)}—${formatDateKey(rangeEndDate, locale)}`
     : formatDateKey(rangeEndDate, locale);
@@ -91,6 +95,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 = [
@@ -151,7 +156,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}
@@ -160,7 +165,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}
@@ -492,6 +497,13 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
       line-height: 1.65;
       text-align: center;
     }
+    .transfer-note--warning {
+      padding: 12px 14px;
+      border: 1px solid color-mix(in srgb, var(--ink) 28%, transparent);
+      background: color-mix(in srgb, var(--accent) 76%, var(--paper));
+      color: var(--ink);
+      font-weight: 700;
+    }
     .privacy {
       margin: 24px auto 0;
       max-width: 440px;
@@ -568,6 +580,7 @@ export function renderHtml({ record, dataQrDataUrl = null, dataQrDataUrls = null
         <p>${escapeHtml(copy.transferDescription)}</p>
       </header>
       ${transferVisual}
+      ${rollingSummaryNotice ? `<p class="transfer-note transfer-note--warning">${escapeHtml(rollingSummaryNotice)}</p>` : ""}
       <p class="transfer-note">${escapeHtml(copy.transferNote)}</p>
       </section>
     </div>
@@ -692,6 +705,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;
@@ -708,15 +765,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,
@@ -725,17 +784,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: {},
         });
@@ -748,6 +802,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;
       }