codex-work-receipt 0.7.1 → 0.7.3

package/CHANGELOG.md

@@ -1,10 +1,25 @@
 # Changelog
 
-## 0.7.1 - 2026-07-19
+## 0.7.3
+
+- Codex 会话日志改为分块逐行解析，避免超大 `.jsonl` 在转成单个 JavaScript 字符串时触发 V8 长度上限。
+- 会话行解析后立即丢弃 Prompt、回复、图片和工具输出，只在内存中保留统计所需的时间、事件、模型与 Token 字段。
+- 单行异常过大时带文件路径和行号跳过；文件读取失败时补充路径与体积，便于定位具体日志。
+- 本地 `history.jsonl` 改为逐条写入，避免历史增长后形成同类的大字符串拼接风险。
+- 小票生成或票仔安装成功后在终端展示开源仓库地址，并用对应的中英文文案邀请用户为项目点 Star。
+- 修正 npm 包的 repository、homepage 和 issues 地址，使其统一指向 `a-bai-2026/codex-work-receipt`。
+
+## 0.7.2
+
+- 修复同一 Codex 会话存在多份 append-only 日志修订时生成重复 canonical factId、导致小程序云端入库拒绝的问题。
+- cwr2 manifest 输出前新增 factId 唯一性防线，避免无效二维码进入扫码链路。
+- “最近 N 小时”在交互选择、终端输出和 HTML 中明确标记为私人滚动摘要，并提示其不参与 AI 供销社统计。
+
+## 0.7.1
 
 - 修正 HTML 长图导出：PNG 只保留完整小票和微信小程序码，不再包含数据二维码或分片数据码。
 
-## 0.7.0 - 2026-07-19
+## 0.7.0
 
 - 新增 Codex 原生桌宠“票仔 · AI 小票工”，提供夜班绿票风格的核心状态与左右移动动画，并支持通过 `--install-pet`、`--uninstall-pet` 和 `--install-companion` 安装管理。
 - AI 打工小票 Skill 新增“票仔，开今天的票”等自然语言入口。

package/README.en.md

@@ -54,6 +54,8 @@ Summarize the last 3 hours:
 npx codex-work-receipt@latest --hours 3 --lang en
 ```
 
+“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
@@ -99,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

@@ -54,6 +54,8 @@ npx codex-work-receipt@latest --today
 npx codex-work-receipt@latest --hours 3
 ```
 
+“最近 N 小时”是滚动摘要，只用于查看和保存私人历史，不参与 AI 供销社的去重统计。需要进入供销社时，请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。
+
 网页和结构数据默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键保存只包含完整小票和微信小程序码的高清长图，数据二维码不会进入图片。也可以继续使用 `--latest`、`--today` 等非交互参数，详见 [CLI 使用文档](docs/cli.md)。
 
 ## 直接跟 Codex 说
@@ -99,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:
 

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 个自然日（含今天）：
 

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/docs/privacy.en.md

@@ -10,6 +10,8 @@ AI Work Receipt reads Codex sessions, computes metrics, and renders receipts loc
 - Event types, timestamps, model names, and numerical metadata
 - Metrics such as turns, tool calls, Tokens, duration, and interruptions
 
+Session logs are parsed locally in bounded chunks, one JSONL row at a time. After each row is parsed, only fields needed for metrics remain in memory; prompts, responses, images, and tool output are discarded from the in-memory statistics representation.
+
 ## What receipts exclude
 
 - Prompts and response text

package/docs/privacy.md

@@ -10,6 +10,8 @@ AI 打工小票在本机读取 Codex 会话，并在本机完成统计和渲染
 - 提取事件类型、时间、模型名称和数字统计
 - 计算轮次、工具调用、Token、时长和中断次数等指标
 
+会话日志会在本机分块逐行解析。每行解析后只保留统计所需字段，Prompt、回复、图片和工具输出不会保留在内存统计对象中。
+
 ## 不会写入小票什么
 
 - Prompt 和回复正文

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "codex-work-receipt",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "type": "module",
   "description": "Generate a privacy-first Codex work receipt from local session metadata.",
   "author": "a-bai-2026",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/a-bai-2026/ai-work-receipt.git"
+    "url": "git+https://github.com/a-bai-2026/codex-work-receipt.git"
   },
-  "homepage": "https://github.com/a-bai-2026/ai-work-receipt#readme",
+  "homepage": "https://github.com/a-bai-2026/codex-work-receipt#readme",
   "bugs": {
-    "url": "https://github.com/a-bai-2026/ai-work-receipt/issues"
+    "url": "https://github.com/a-bai-2026/codex-work-receipt/issues"
   },
   "license": "GPL-3.0-only",
   "keywords": [

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,8 @@ 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 { printOpenSourcePrompt } from "./core/open-source.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";
@@ -81,6 +82,7 @@ async function main() {
       console.log("请重启 Codex，打开 Settings > Pets，点击 Refresh 后选择“票仔 · AI 小票工”。");
       console.log("输入 /pet 唤醒票仔；以后可以说：票仔，开今天的票。");
     }
+    printOpenSourcePrompt("pet", options.locale);
     return;
   }
   if (options.uninstallPet) {
@@ -145,6 +147,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,8 +160,12 @@ 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("小程序码：尚未配置，页面使用明确占位符");
   }
+  printOpenSourcePrompt("receipt", options.locale);
   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/open-source.mjs

@@ -0,0 +1,43 @@
+export const OPEN_SOURCE_REPOSITORY_URL = "https://github.com/a-bai-2026/codex-work-receipt";
+
+const PROMPTS = {
+  "zh-CN": {
+    receipt: {
+      label: "开源项目",
+      message: "如果你也喜欢这个 AI 小票工具，欢迎来 GitHub 给我点个 Star ⭐",
+    },
+    pet: {
+      label: "票仔开源地址",
+      message: "如果你也喜欢票仔，欢迎来 GitHub 给我点个 Star ⭐",
+    },
+  },
+  en: {
+    receipt: {
+      label: "Open-source project",
+      message: "If you enjoy AI Work Receipt, a GitHub Star would mean a lot ⭐",
+    },
+    pet: {
+      label: "Ticket Buddy source",
+      message: "If you enjoy Ticket Buddy, a GitHub Star would mean a lot ⭐",
+    },
+  },
+};
+
+export function getOpenSourcePrompt(kind = "receipt", locale = "zh-CN") {
+  const normalizedLocale = locale === "en" ? "en" : "zh-CN";
+  const localized = PROMPTS[normalizedLocale];
+  const copy = localized[kind] || localized.receipt;
+  return {
+    url: OPEN_SOURCE_REPOSITORY_URL,
+    label: copy.label,
+    message: copy.message,
+    separator: normalizedLocale === "en" ? ": " : "：",
+  };
+}
+
+export function printOpenSourcePrompt(kind, locale, writeLine = console.log) {
+  const prompt = getOpenSourcePrompt(kind, locale);
+  writeLine("");
+  writeLine(`${prompt.label}${prompt.separator}${prompt.url}`);
+  writeLine(prompt.message);
+}

package/src/core/presentation.mjs

@@ -147,6 +147,7 @@ const RECEIPT_COPY = {
     placeholderValue: "待接入",
     placeholderAria: "小程序码待接入",
     transferNote: "数据码只包含时间、轮次、Token和工具调用等统计，不包含Prompt、回复正文、代码、项目路径或文件名。",
+    rollingSummaryNotice: "最近 {hours} 小时属于滚动摘要，只保存到私人历史，不参与 AI 供销社统计。需要统计时请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。",
     privacy: "结构数据同时保存在本机，未来可以批量导入小程序历史记录。",
   },
   en: {
@@ -221,6 +222,7 @@ const RECEIPT_COPY = {
     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.",
   },
 };
@@ -273,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/receipt-record.mjs

@@ -155,11 +155,13 @@ export function persistReceiptRecord(record, outputHtmlPath, requestedDataDir =
   }
   const history = [...deduplicated.values()]
     .sort((left, right) => String(left.period?.end_at).localeCompare(String(right.period?.end_at)));
-  fs.writeFileSync(
-    path.join(dataDir, "history.jsonl"),
-    history.length ? `${history.map((item) => JSON.stringify(item)).join("\n")}\n` : "",
-    "utf8",
-  );
+  const historyPath = path.join(dataDir, "history.jsonl");
+  const historyDescriptor = fs.openSync(historyPath, "w");
+  try {
+    for (const item of history) fs.writeSync(historyDescriptor, `${JSON.stringify(item)}\n`, null, "utf8");
+  } finally {
+    fs.closeSync(historyDescriptor);
+  }
 
   const companionPath = /\.html?$/i.test(outputHtmlPath)
     ? outputHtmlPath.replace(/\.html?$/i, ".json")

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

@@ -5,6 +5,17 @@ import path from "node:path";
 
 import { rowDate } from "../lib/time.mjs";
 
+const READ_CHUNK_BYTES = 256 * 1024;
+const MAX_JSONL_ROW_BYTES = 64 * 1024 * 1024;
+const TAIL_HASH_BYTES = 4096;
+const TOKEN_KEYS = [
+  "input_tokens",
+  "cached_input_tokens",
+  "output_tokens",
+  "reasoning_output_tokens",
+  "total_tokens",
+];
+
 function walkJsonlFiles(directory, accumulator = []) {
   if (!fs.existsSync(directory)) return accumulator;
   for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
@@ -15,27 +26,183 @@ function walkJsonlFiles(directory, accumulator = []) {
   return accumulator;
 }
 
-function readJsonl(filePath) {
+function shortString(value, maximumLength = 512) {
+  return typeof value === "string" && value.length <= maximumLength ? value : null;
+}
+
+function finiteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
+function compactTokenUsage(value) {
+  if (!value || typeof value !== "object") return null;
+  const usage = {};
+  for (const key of TOKEN_KEYS) {
+    const amount = finiteNumber(value[key]);
+    if (amount !== null) usage[key] = amount;
+  }
+  return Object.keys(usage).length ? usage : null;
+}
+
+function compactPayload(rowType, value) {
+  if (!value || typeof value !== "object") return null;
+  const payload = {};
+  for (const key of ["completed_at", "started_at", "timestamp"]) {
+    const timestamp = shortString(value[key], 128);
+    if (timestamp !== null) payload[key] = timestamp;
+  }
+
+  const payloadType = shortString(value.type, 128);
+  if (payloadType !== null) payload.type = payloadType;
+
+  if (rowType === "session_meta") {
+    const sessionId = shortString(value.session_id);
+    const fallbackId = shortString(value.id);
+    if (sessionId !== null) payload.session_id = sessionId;
+    if (fallbackId !== null) payload.id = fallbackId;
+  } else if (rowType === "turn_context") {
+    const model = shortString(value.model);
+    if (model !== null) payload.model = model;
+  } else if (rowType === "event_msg") {
+    const durationMs = finiteNumber(value.duration_ms);
+    const firstTokenMs = finiteNumber(value.time_to_first_token_ms);
+    if (durationMs !== null) payload.duration_ms = durationMs;
+    if (firstTokenMs !== null) payload.time_to_first_token_ms = firstTokenMs;
+    const totalTokenUsage = compactTokenUsage(value.info?.total_token_usage);
+    if (totalTokenUsage) payload.info = { total_token_usage: totalTokenUsage };
+  }
+
+  return Object.keys(payload).length ? payload : null;
+}
+
+function compactRow(value, sourceLine) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  const row = { __sourceLine: sourceLine };
+  const timestamp = shortString(value.timestamp, 128);
+  const type = shortString(value.type, 128);
+  if (timestamp !== null) row.timestamp = timestamp;
+  if (type !== null) row.type = type;
+  const payload = compactPayload(type, value.payload);
+  if (payload) row.payload = payload;
+  return row;
+}
+
+function formatByteSize(value) {
+  const bytes = Math.max(0, Number(value || 0));
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
+  return `${bytes} B`;
+}
+
+function appendTail(current, chunk) {
+  if (chunk.length >= TAIL_HASH_BYTES) return Buffer.from(chunk.subarray(chunk.length - TAIL_HASH_BYTES));
+  const combined = Buffer.concat([current, chunk]);
+  return combined.length > TAIL_HASH_BYTES
+    ? Buffer.from(combined.subarray(combined.length - TAIL_HASH_BYTES))
+    : combined;
+}
+
+function sessionReadError(file, error) {
+  return new Error(
+    `无法读取 Codex 会话：${file.filePath}（${formatByteSize(file.size)}）：${error.message}`,
+    { cause: error },
+  );
+}
+
+function readJsonl(file) {
   const rows = [];
-  const source = fs.readFileSync(filePath, "utf8");
-  for (const [lineIndex, line] of source.split("\n").entries()) {
-    if (!line.trim()) continue;
-    try {
-      rows.push({ ...JSON.parse(line), __sourceLine: lineIndex + 1 });
-    } catch {
-      console.warn(`跳过无法解析的记录：${path.basename(filePath)}:${lineIndex + 1}`);
+  const buffer = Buffer.allocUnsafe(READ_CHUNK_BYTES);
+  const lineParts = [];
+  let lineBytes = 0;
+  let lineIndex = 0;
+  let offset = 0;
+  let tail = Buffer.alloc(0);
+  let skippingOversizedLine = false;
+  let fileDescriptor = null;
+
+  const resetLine = () => {
+    lineParts.length = 0;
+    lineBytes = 0;
+    skippingOversizedLine = false;
+  };
+
+  const appendLinePart = (part) => {
+    lineBytes += part.length;
+    if (skippingOversizedLine) return;
+    if (lineBytes > MAX_JSONL_ROW_BYTES) {
+      skippingOversizedLine = true;
+      lineParts.length = 0;
+      return;
+    }
+    if (part.length) lineParts.push(Buffer.from(part));
+  };
+
+  const finishLine = (finalPart = Buffer.alloc(0)) => {
+    lineIndex += 1;
+    const totalBytes = lineBytes + finalPart.length;
+    if (skippingOversizedLine || totalBytes > MAX_JSONL_ROW_BYTES) {
+      console.warn(
+        `跳过过大的 Codex 记录：${file.filePath}:${lineIndex}（${formatByteSize(totalBytes)}）`,
+      );
+      resetLine();
+      return;
+    }
+
+    const lineBuffer = lineParts.length
+      ? Buffer.concat([...lineParts, finalPart], totalBytes)
+      : finalPart;
+    const line = lineBuffer.toString("utf8").replace(/\r$/, "");
+    if (line.trim()) {
+      try {
+        const compact = compactRow(JSON.parse(line), lineIndex);
+        if (compact) rows.push(compact);
+      } catch {
+        console.warn(`跳过无法解析的记录：${file.filePath}:${lineIndex}`);
+      }
     }
+    resetLine();
+  };
+
+  try {
+    fileDescriptor = fs.openSync(file.filePath, "r");
+    const snapshotBytes = Math.max(0, Number(file.size || 0));
+    while (offset < snapshotBytes) {
+      const requestedBytes = Math.min(buffer.length, snapshotBytes - offset);
+      const bytesRead = fs.readSync(fileDescriptor, buffer, 0, requestedBytes, offset);
+      if (!bytesRead) break;
+      const chunk = buffer.subarray(0, bytesRead);
+      tail = appendTail(tail, chunk);
+      offset += bytesRead;
+
+      let start = 0;
+      let newlineIndex = chunk.indexOf(10, start);
+      while (newlineIndex !== -1) {
+        finishLine(chunk.subarray(start, newlineIndex));
+        start = newlineIndex + 1;
+        newlineIndex = chunk.indexOf(10, start);
+      }
+      appendLinePart(chunk.subarray(start));
+    }
+    if (lineBytes || skippingOversizedLine) finishLine();
+  } catch (error) {
+    throw sessionReadError(file, error);
+  } finally {
+    if (fileDescriptor !== null) fs.closeSync(fileDescriptor);
   }
-  return { rows, source };
+
+  return {
+    rows,
+    byteLength: offset,
+    tailHash: crypto.createHash("sha256").update(tail).digest("hex"),
+  };
 }
 
 function sessionFromFile(file) {
-  const { rows, source } = readJsonl(file.filePath);
+  const { rows, byteLength, tailHash } = readJsonl(file);
   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,
@@ -45,8 +212,8 @@ function sessionFromFile(file) {
     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"),
+      byte_length: byteLength,
+      tail_hash: tailHash,
     },
     startAt: timestamps[0] || fallbackDate,
     endAt: timestamps.at(-1) || fallbackDate,
@@ -57,7 +224,14 @@ function codexSessionFiles() {
   const codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
   const sessionsDirectory = path.join(codexHome, "sessions");
   const files = walkJsonlFiles(sessionsDirectory)
-    .map((filePath) => ({ filePath, modifiedAt: fs.statSync(filePath).mtimeMs }))
+    .map((filePath) => {
+      try {
+        const stats = fs.statSync(filePath);
+        return { filePath, modifiedAt: stats.mtimeMs, size: stats.size };
+      } catch (error) {
+        throw sessionReadError({ filePath, size: 0 }, error);
+      }
+    })
     .sort((left, right) => right.modifiedAt - left.modifiedAt);
   if (!files.length) throw new Error(`没有在 ${sessionsDirectory} 找到 Codex 会话记录`);
   return files;
@@ -69,6 +243,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 +291,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 +311,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);
@@ -493,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;
@@ -569,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>