codex-work-receipt 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.9.0
+
+- 新增缓存命中率、每轮 Token / 输出 Token / 工具调用 / 完成耗时等效率指标。
+- 新增首 Token 与整轮耗时的 P50 / P90 分位数，以及按本地时区生成的 24 小时工作热力图。
+- 新增模型使用轮次和脱敏工具类别结构；解析器不保留原始工具名、调用参数、命令或工具输出。
+- HTML 与本地完整 JSON 展示详细效率洞察；微信 `cwr1` / `cwr2` 紧凑载荷保持不变，继续兼容现有小程序。
+- HTML 赞助商下方新增“更多小票功能”，集中展示生成范围、自动 / 手动模式、Skill 与票仔的 12 条常用命令，并支持一键复制。
+- 功能命令区采用独立的浅色纸张样式，记忆展开状态，适配桌面和移动端，并继续排除在长图导出范围之外。
+
 ## 0.8.0
 
 - 首次交互式运行新增“自动保存 / 仅手动”选择；显式范围命令继续保持非交互兼容。
@@ -11,7 +20,7 @@
 - 数据二维码降级为可选单码：只有完整载荷能放进安全 QR version 时才显示扫码入口，不再生成或轮播新的 multipart 二维码。
 - 保留 `cwr1`、`cwr2` 和历史 `cwr2p` 解码兼容；二维码容量不足不再阻止 HTML、JSON、导入文件或本地历史生成。
 - 修复 HTML 长图导出时文字节点被固化宽高后发生的数值换行与错位问题。
-- 更新 HTML 工具栏并新增响应式侧栏，集中展示 GitHub、更新日志和赞助伙伴入口；这些网页控件不会进入导出图片。
+- 更新 HTML 工具栏并新增响应式侧栏，改善主题切换、长图导出和相关信息浏览体验；这些网页控件不会进入导出图片。
 - 更新中英文 CLI、手机导入、协议、隐私和 Codex Skill 文档。
 
 ## 0.7.4

package/README.en.md

@@ -20,7 +20,7 @@
   <img src="docs/images/readme-hero.jpg" alt="Three Codex Work Receipt themes" width="920">
 </p>
 
-Codex Work Receipt summarizes turns, tool calls, Tokens, duration, and models, then turns them into playful AI work points, a job title, and a review. Receipts never include prompts, responses, source code, project paths, or file names.
+Codex Work Receipt summarizes turns, tool calls, Tokens, duration, and models. It also reports cache hit rate, per-turn efficiency, P50 / P90 latency, a work-time heatmap, and model/tool structure, then turns the result into playful AI work points, a job title, and a review. Receipts never include prompts, responses, source code, project paths, file names, tool arguments, or tool output.
 
 The cwr2 protocol creates stable privacy-safe facts for each session and calendar day, allowing overlapping today, last-seven-days, and this-week receipts to be deduplicated. Every receipt also produces one `.cwr.json` WeChat import file. Scan import appears only when the complete payload fits in one data QR code.
 
@@ -56,7 +56,7 @@ 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, structured data, and the WeChat import file are written to `./codex-work-receipt-output/` by default. The page can download its `.cwr.json` file and save a high-resolution PNG containing only the full receipt and WeChat mini-program code. See the [CLI guide](docs/cli.en.md).
+HTML, structured data, and the WeChat import file are written to `./codex-work-receipt-output/` by default. The page can download its `.cwr.json` file and save a high-resolution PNG containing only the full receipt and WeChat mini-program code. A “More receipt features” section below the sponsor provides 12 copyable commands for receipt ranges, automatic mode, the Codex skill, and Ticket Buddy. The web controls stay out of the exported image. See the [CLI guide](docs/cli.en.md).
 
 ## Automatic saving or manual only
 

package/README.md

@@ -20,7 +20,7 @@
   <img src="docs/images/readme-hero.jpg" alt="Codex AI 打工小票三种主题效果" width="920">
 </p>
 
-它会统计 Codex 会话中的轮次、工具调用、Token、时长和模型，生成带有 AI 工分、今日工种和点评的小票。不会把 Prompt、回复正文、代码、项目路径或文件名写入小票。
+它会统计 Codex 会话中的轮次、工具调用、Token、时长和模型，并提供缓存命中率、每轮效率、P50 / P90 延迟、工作时间热力图、模型与工具结构，生成带有 AI 工分、今日工种和点评的小票。不会把 Prompt、回复正文、代码、项目路径、文件名、工具参数或工具输出写入小票。
 
 cwr2 协议按“会话 × 自然日”生成稳定的脱敏事实。今日、近 7 日和本周小票即使范围重叠，接收端也能识别相同工作。每张小票还会生成一个 `.cwr.json` 微信导入文件；只有完整数据能放进一个二维码时，网页才额外提供扫码导入。
 
@@ -56,7 +56,7 @@ npx codex-work-receipt@latest --hours 3
 
 “最近 N 小时”是滚动摘要，只用于查看和保存私人历史，不参与 AI 供销社的去重统计。需要进入供销社时，请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。
 
-网页、结构数据和微信导入文件默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键下载 `.cwr.json`，也可以保存只包含完整小票和微信小程序码的高清长图。数据二维码不会进入图片。详见 [CLI 使用文档](docs/cli.md)。
+网页、结构数据和微信导入文件默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键下载 `.cwr.json`，也可以保存只包含完整小票和微信小程序码的高清长图。赞助商下方的“更多小票功能”还提供 12 条常用命令及复制按钮，帮助用户发现不同统计范围、自动模式、Skill 和票仔。数据二维码和网页功能区不会进入图片。详见 [CLI 使用文档](docs/cli.md)。
 
 ## 自动保存或仅手动
 

package/docs/data-schema.en.md

@@ -12,12 +12,26 @@ The full receipt schema is currently version `2`; rolling-hour summaries remain
 - `generated_at`: generation time
 - `source`: data source, selected `scope`, and collector version
 - `period`: actual activity times, timezone, and `range_start_date` / `range_end_date` calendar boundaries
-- `stats`: turns, messages, tools, Tokens, duration, and related metrics
+- `stats`: turns, messages, tools, Tokens, duration, and detailed local efficiency insights
 - `presentation`: default theme, language-neutral `work_profile`, localized role, review, and AI work points
 - `privacy`: explicit declaration of excluded sensitive content
 
 The `id` remains stable for the same session, day, or calendar-boundary pair. Regeneration updates the record rather than creating duplicate history. `source.snapshot_hash` detects metric changes.
 
+### Detailed local efficiency insights
+
+`stats.insights` in the full JSON contains:
+
+- `cache_hit_rate`: `cached_input_tokens / input_tokens`, or `0` when input is zero
+- `per_turn`: total Tokens, output Tokens, tool calls, and average completion duration per completed turn
+- `latency_ms.first_token`: sample count plus P50 and P90 first-token latency
+- `latency_ms.turn`: sample count plus P50 and P90 completed-turn duration
+- `activity_by_hour`: 24 hourly buckets in the receipt timezone; each completed or interrupted turn adds one
+- `model_usage`: completed-turn counts attributed to each model
+- `tool_usage`: privacy-safe category counts for terminal, file editing, browser, research, media, multi-agent, planning, integrations, and other tools
+
+Percentiles use linear interpolation between adjacent samples and are rounded to milliseconds. Tool classification retains only stable categories, not raw tool names, arguments, commands, or output.
+
 ## WeChat import file
 
 Each run writes a `*.cwr.json` file beside the HTML:
@@ -37,6 +51,8 @@ Each run writes a `*.cwr.json` file beside the HTML:
 
 `payload` is exactly the compact structure obtained after decoding a QR payload. `integrity.digest` is a full SHA-256 over canonical payload JSON. It detects corruption but is not a source signature. The mini program must treat every file as untrusted input, enforce a size limit, validate versions, fields, numeric bounds, unique fact IDs, manifests, and content hashes, then persist atomically only after confirmation.
 
+To preserve compatibility with existing mini programs, `stats.insights` currently stays in the local full JSON and HTML and is not added to the compact `cwr1` / `cwr2` payload. The compact payload continues to carry the existing accounting metrics.
+
 Canonicalization recursively sorts every object's keys using JavaScript's default string order (UTF-16 code units), preserves array order, uses JSON primitive types, and emits no whitespace or trailing newline. Calculate SHA-256 over the resulting UTF-8 bytes. Use the digest in `docs/fixtures/cwr-file-v1.json` to cross-check another implementation.
 
 A cross-repository compatibility fixture is available at `docs/fixtures/cwr-file-v1.json`.

package/docs/data-schema.md

@@ -12,12 +12,26 @@
 - `generated_at`：生成时间
 - `source`：数据来源、`scope` 统计范围和采集器版本
 - `period`：实际活动起止时间、时区，以及 `range_start_date` / `range_end_date` 自然日边界
-- `stats`：轮次、消息、工具、Token、时长等统计
+- `stats`：轮次、消息、工具、Token、时长，以及本地详细效率洞察
 - `presentation`：默认主题、语言无关的 `work_profile`、本地化工种、点评和 AI 工分
 - `privacy`：明确声明不包含的敏感内容
 
 同一个会话、同一天或同一组自然日边界的 `id` 保持稳定；重复生成会更新该记录。`source.snapshot_hash` 用于识别统计内容是否发生变化。
 
+### 本地详细效率洞察
+
+完整 JSON 的 `stats.insights` 包含：
+
+- `cache_hit_rate`：`cached_input_tokens / input_tokens`，输入为零时记为 `0`
+- `per_turn`：按已完成轮次计算的总 Token、输出 Token、工具调用和平均完成耗时
+- `latency_ms.first_token`：首 Token 延迟的样本数、P50 和 P90
+- `latency_ms.turn`：已完成整轮耗时的样本数、P50 和 P90
+- `activity_by_hour`：按小票时区统计的 24 个小时槽；每个完成或中断轮次计一次
+- `model_usage`：模型对应的完成轮次数量
+- `tool_usage`：脱敏工具类别及数量，包括终端、文件编辑、浏览器、检索、媒体、多代理、规划、外部集成和其他类别
+
+百分位使用相邻样本线性插值后取整。工具分类只保留稳定类别，不保留原始工具名、参数、命令或输出。
+
 ## 微信导入文件
 
 每次生成都会在 HTML 旁边写入一个 `*.cwr.json`：
@@ -37,6 +51,8 @@
 
 `payload` 与二维码解压后的精简结构完全相同。`integrity.digest` 是对规范化 payload JSON 计算的完整 SHA-256，用于发现损坏，但不是来源签名。小程序必须把文件视为不可信输入，限制文件大小，校验版本、字段、数值范围、factId 唯一性、manifest 和 content hash，并在用户确认后原子入库。
 
+为保持现有小程序兼容，`stats.insights` 当前只存在于本地完整 JSON 和 HTML，不进入 `cwr1` / `cwr2` 精简载荷。精简载荷继续携带原有记账统计。
+
 规范化规则是：递归按 JavaScript 默认字符串排序（UTF-16 code unit 顺序）排列每个对象的键，保持数组元素顺序，使用 JSON 原始类型，不添加空白或换行，再对生成的 UTF-8 字节计算 SHA-256。兼容实现可用 `docs/fixtures/cwr-file-v1.json` 的 digest 做交叉验证。
 
 兼容测试夹具见 `docs/fixtures/cwr-file-v1.json`。

package/docs/privacy.en.md

@@ -7,10 +7,10 @@ AI Work Receipt reads Codex sessions, computes metrics, and renders receipts loc
 ## What it reads
 
 - `~/.codex/sessions/**/*.jsonl` by default
-- Event types, timestamps, model names, and numerical metadata
-- Metrics such as turns, tool calls, Tokens, duration, and interruptions
+- Event types, timestamps, model names, privacy-safe tool categories, and numerical metadata
+- Metrics such as turns, tool calls, Tokens, duration, interruptions, cache hit rate, latency percentiles, and hourly distribution
 
-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.
+Session logs are parsed locally in bounded chunks, one JSONL row at a time. Raw tool names are immediately mapped to stable categories. Prompts, responses, images, raw tool names, tool arguments, commands, and tool output are discarded from the in-memory statistics representation.
 
 ## What receipts exclude
 

package/docs/privacy.md

@@ -7,10 +7,10 @@ AI 打工小票在本机读取 Codex 会话，并在本机完成统计和渲染
 ## 会读取什么
 
 - 默认读取 `~/.codex/sessions/**/*.jsonl`
-- 提取事件类型、时间、模型名称和数字统计
-- 计算轮次、工具调用、Token、时长和中断次数等指标
+- 提取事件类型、时间、模型名称、脱敏工具类别和数字统计
+- 计算轮次、工具调用、Token、时长、中断次数、缓存命中率、延迟分位与小时分布等指标
 
-会话日志会在本机分块逐行解析。每行解析后只保留统计所需字段，Prompt、回复、图片和工具输出不会保留在内存统计对象中。
+会话日志会在本机分块逐行解析。每行解析后只保留统计所需字段；工具名会立即映射为稳定类别。Prompt、回复、图片、原始工具名、工具参数、命令和工具输出不会保留在内存统计对象中。
 
 ## 不会写入小票什么
 

package/package.json

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

package/src/cli.mjs

@@ -77,10 +77,11 @@ function enableAuto(options) {
   });
   startAutomaticRun(result.config);
   printAutomaticEnabled(result, options.locale);
+  printOpenSourcePrompt("receipt", options.locale);
   return result;
 }
 
-function enableManual(options) {
+function enableManual(options, { showOpenSourcePrompt = true } = {}) {
   const result = configureManualMode({
     dataDir: options.dataDir,
     locale: options.locale,
@@ -88,6 +89,7 @@ function enableManual(options) {
     theme: options.theme,
   });
   printManualEnabled(result, options.locale);
+  if (showOpenSourcePrompt) printOpenSourcePrompt("receipt", options.locale);
   return result;
 }
 
@@ -191,7 +193,7 @@ async function main() {
         enableAuto(options);
         return;
       }
-      enableManual(options);
+      enableManual(options, { showOpenSourcePrompt: false });
     }
     const selected = await promptForRange({
       locale: options.locale,

package/src/core/metrics.mjs

@@ -1,4 +1,5 @@
 import { dateKey, rowDate } from "../lib/time.mjs";
+import { toolCategoryForRow } from "../lib/tool-category.mjs";
 import {
   calendarDayCount,
   isCalendarScope,
@@ -21,6 +22,83 @@ function addUsage(target, source) {
   for (const key of Object.keys(target)) target[key] += Number(source[key] || 0);
 }
 
+function increment(map, key, amount = 1) {
+  if (!key) return;
+  map.set(key, Number(map.get(key) || 0) + amount);
+}
+
+function roundedRatio(numerator, denominator, digits = 2) {
+  if (!denominator) return 0;
+  const scale = 10 ** digits;
+  return Math.round((Number(numerator || 0) / denominator) * scale) / scale;
+}
+
+function percentile(samples, quantile) {
+  if (!samples.length) return 0;
+  const sorted = [...samples].sort((left, right) => left - right);
+  const position = (sorted.length - 1) * quantile;
+  const lowerIndex = Math.floor(position);
+  const upperIndex = Math.ceil(position);
+  const lower = sorted[lowerIndex];
+  const upper = sorted[upperIndex];
+  return Math.round(lower + (upper - lower) * (position - lowerIndex));
+}
+
+function usageRows(map, keyName) {
+  return [...map.entries()]
+    .map(([name, count]) => ({ [keyName]: name, count }))
+    .sort((left, right) => right.count - left.count || left[keyName].localeCompare(right[keyName]));
+}
+
+function localHour(date, timezone) {
+  if (!date) return null;
+  const hour = Number(new Intl.DateTimeFormat("en-GB", {
+    timeZone: timezone,
+    hour: "2-digit",
+    hourCycle: "h23",
+  }).format(date));
+  return Number.isInteger(hour) && hour >= 0 && hour <= 23 ? hour : null;
+}
+
+function buildInsights({
+  tokens,
+  completedTurns,
+  toolCalls,
+  completedDurationMs,
+  firstTokenSamples,
+  turnDurationSamples,
+  activityByHour,
+  modelUsage,
+  toolUsage,
+}) {
+  const inputTokens = Math.max(0, Number(tokens.input_tokens || 0));
+  const cachedInputTokens = Math.max(0, Number(tokens.cached_input_tokens || 0));
+  return {
+    cache_hit_rate: inputTokens ? Math.min(1, roundedRatio(cachedInputTokens, inputTokens, 4)) : 0,
+    per_turn: {
+      total_tokens: roundedRatio(tokens.total_tokens, completedTurns),
+      output_tokens: roundedRatio(tokens.output_tokens, completedTurns),
+      tool_calls: roundedRatio(toolCalls, completedTurns),
+      work_duration_ms: Math.round(roundedRatio(completedDurationMs, completedTurns)),
+    },
+    latency_ms: {
+      first_token: {
+        sample_count: firstTokenSamples.length,
+        p50: percentile(firstTokenSamples, 0.5),
+        p90: percentile(firstTokenSamples, 0.9),
+      },
+      turn: {
+        sample_count: turnDurationSamples.length,
+        p50: percentile(turnDurationSamples, 0.5),
+        p90: percentile(turnDurationSamples, 0.9),
+      },
+    },
+    activity_by_hour: [...activityByHour],
+    model_usage: usageRows(modelUsage, "model"),
+    tool_usage: usageRows(toolUsage, "category"),
+  };
+}
+
 function sessionTokenUsage(rows, range) {
   const events = rows
     .filter((row) => row.type === "event_msg" && row.payload?.type === "token_count")
@@ -78,11 +156,17 @@ export function collectMetrics(sessions, range) {
   let toolCalls = 0;
   let interruptions = 0;
   let workDurationMs = 0;
+  let completedDurationMs = 0;
   let totalFirstTokenMs = 0;
   let firstTokenSamples = 0;
+  const firstTokenLatencySamples = [];
+  const turnDurationSamples = [];
   const timestamps = [];
   const activeDateKeys = new Set();
   const models = new Set();
+  const modelUsage = new Map();
+  const toolUsage = new Map();
+  const activityByHour = Array(24).fill(0);
 
   for (const session of sessions) {
     const scopedRows = isCalendarScope(range.scope) || isTimeWindowScope(range.scope)
@@ -94,40 +178,70 @@ export function collectMetrics(sessions, range) {
     sessionIds.push(session.sessionId);
     addUsage(tokens, sessionTokenUsage(session.rows, range));
 
-    for (const row of scopedRows) {
+    let activeModel = null;
+    let unattributedModelTurns = 0;
+    let sessionHasSelectedModel = false;
+    for (const row of session.rows) {
+      if (row.type === "turn_context" && row.payload?.model) activeModel = row.payload.model;
+      const selected = (!isCalendarScope(range.scope) && !isTimeWindowScope(range.scope))
+        || isDateInRange(rowDate(row), range);
+      if (!selected) continue;
       const date = rowDate(row);
       if (date) {
         timestamps.push(date);
         activeDateKeys.add(dateKey(date, range.timezone));
       }
 
-      if (row.type === "turn_context" && row.payload?.model) models.add(row.payload.model);
+      if (row.type === "turn_context" && row.payload?.model) {
+        models.add(row.payload.model);
+        sessionHasSelectedModel = true;
+      }
       if (row.type === "event_msg") {
         const eventType = row.payload?.type;
         if (eventType === "task_complete") {
+          const hasDuration = Number.isFinite(row.payload.duration_ms);
+          const durationMs = hasDuration ? Math.max(0, Number(row.payload.duration_ms)) : 0;
           completedTurns += 1;
-          workDurationMs += Number(row.payload.duration_ms || 0);
+          workDurationMs += durationMs;
+          completedDurationMs += durationMs;
+          if (hasDuration) turnDurationSamples.push(durationMs);
+          if (activeModel) {
+            models.add(activeModel);
+            sessionHasSelectedModel = true;
+            increment(modelUsage, activeModel);
+          }
+          else unattributedModelTurns += 1;
+          const hour = localHour(date, range.timezone);
+          if (hour !== null) activityByHour[hour] += 1;
           if (Number.isFinite(row.payload.time_to_first_token_ms)) {
-            totalFirstTokenMs += row.payload.time_to_first_token_ms;
+            const firstTokenMs = Math.max(0, Number(row.payload.time_to_first_token_ms));
+            totalFirstTokenMs += firstTokenMs;
             firstTokenSamples += 1;
+            firstTokenLatencySamples.push(firstTokenMs);
           }
         } else if (eventType === "user_message") userMessages += 1;
         else if (eventType === "turn_aborted") {
           interruptions += 1;
-          workDurationMs += Number(row.payload.duration_ms || 0);
+          workDurationMs += Math.max(0, Number(row.payload.duration_ms || 0));
+          const hour = localHour(date, range.timezone);
+          if (hour !== null) activityByHour[hour] += 1;
         }
       }
 
-      if (
-        row.type === "response_item" &&
-        (row.payload?.type === "custom_tool_call" || row.payload?.type === "function_call")
-      ) toolCalls += 1;
+      const toolCategory = toolCategoryForRow(row);
+      if (toolCategory) {
+        toolCalls += 1;
+        increment(toolUsage, toolCategory);
+      }
     }
 
     const fallbackModel = [...session.rows]
       .reverse()
       .find((row) => row.type === "turn_context" && row.payload?.model)?.payload?.model;
-    if (fallbackModel) models.add(fallbackModel);
+    if (fallbackModel && (!sessionHasSelectedModel || unattributedModelTurns)) {
+      models.add(fallbackModel);
+      if (unattributedModelTurns) increment(modelUsage, fallbackModel, unattributedModelTurns);
+    }
   }
 
   if (!scopedSessions.length || !timestamps.length) throw new Error(emptyRangeMessage(range));
@@ -159,6 +273,17 @@ export function collectMetrics(sessions, range) {
     tokens,
     models: [...models],
   };
+  metrics.insights = buildInsights({
+    tokens,
+    completedTurns,
+    toolCalls,
+    completedDurationMs,
+    firstTokenSamples: firstTokenLatencySamples,
+    turnDurationSamples,
+    activityByHour,
+    modelUsage,
+    toolUsage,
+  });
   metrics.workProfileId = selectWorkProfileId(metrics);
   metrics.workPoints = calculateWorkPoints(metrics);
   return metrics;

package/src/core/presentation.mjs

@@ -93,6 +93,45 @@ const RECEIPT_COPY = {
       changelogLink: "查看更新日志 →",
       sponsorLabel: "赞助伙伴",
       sponsorAlt: "ModelFlare 标志",
+      features: {
+        title: "更多小票功能",
+        countLabel: "{count} 项",
+        description: "复制命令后，在终端中运行即可。",
+        copyLabel: "复制",
+        copiedLabel: "已复制",
+        copyErrorLabel: "复制失败",
+        copiedStatus: "命令已复制到剪贴板",
+        copyErrorStatus: "无法自动复制，请手动选择命令",
+        groups: [
+          {
+            title: "生成小票",
+            commands: [
+              { label: "生成最近一次小票", args: "--latest" },
+              { label: "生成最近 3 小时小票", args: "--hours 3" },
+              { label: "生成今日小票", args: "--today" },
+              { label: "生成最近 7 天小票", args: "--range last-7-days" },
+              { label: "生成本周小票", args: "--range this-week" },
+            ],
+          },
+          {
+            title: "自动与手动",
+            commands: [
+              { label: "重新选择工作模式", args: "--setup" },
+              { label: "开启自动保存", args: "--enable-auto" },
+              { label: "切换为仅手动", args: "--disable-auto" },
+              { label: "查看自动保存状态", args: "--auto-status" },
+            ],
+          },
+          {
+            title: "票仔与对话开票",
+            commands: [
+              { label: "安装票仔和对话开票", args: "--install-companion" },
+              { label: "仅安装票仔", args: "--install-pet" },
+              { label: "仅安装对话开票", args: "--install-skill" },
+            ],
+          },
+        ],
+      },
     },
     themes: {
       classic: "经典白票",
@@ -135,6 +174,36 @@ const RECEIPT_COPY = {
       interruptions: ["次", "次"],
       seconds: ["秒", "秒"],
     },
+    insights: {
+      title: "效率与工作结构",
+      cacheHit: "缓存命中率",
+      perTurn: "每轮效率",
+      totalTokens: "总 Token",
+      outputTokens: "输出 Token",
+      toolCalls: "工具调用",
+      firstTokenLatency: "首次响应延迟",
+      turnLatency: "整轮耗时",
+      p50: "P50",
+      p90: "P90",
+      noSamples: "暂无样本",
+      heatmap: "工作时间热力图",
+      heatmapCell: "{hour}:00 · {count} 轮",
+      models: "模型结构",
+      tools: "工具结构",
+      turnsUnit: "轮",
+      callsUnit: "次",
+      toolCategories: {
+        terminal: "终端命令",
+        "file-edit": "文件编辑",
+        browser: "浏览器操作",
+        research: "检索研究",
+        media: "图像与媒体",
+        agents: "多代理协作",
+        planning: "规划与确认",
+        integrations: "外部集成",
+        other: "其他工具",
+      },
+    },
     footerThanks: "谢谢惠顾，欢迎明天继续改需求",
     transferAria: "微信小程序导入联",
     transferTitle: "导入到微信小程序",
@@ -186,6 +255,45 @@ const RECEIPT_COPY = {
       changelogLink: "View the changelog →",
       sponsorLabel: "Sponsored by",
       sponsorAlt: "ModelFlare logo",
+      features: {
+        title: "More receipt features",
+        countLabel: "{count} commands",
+        description: "Copy a command, then run it in your terminal.",
+        copyLabel: "Copy",
+        copiedLabel: "Copied",
+        copyErrorLabel: "Copy failed",
+        copiedStatus: "Command copied to the clipboard",
+        copyErrorStatus: "Could not copy automatically. Select the command manually.",
+        groups: [
+          {
+            title: "Generate receipts",
+            commands: [
+              { label: "Generate the latest receipt", args: "--latest" },
+              { label: "Generate the last 3 hours", args: "--hours 3" },
+              { label: "Generate today's receipt", args: "--today" },
+              { label: "Generate the last 7 days", args: "--range last-7-days" },
+              { label: "Generate this week's receipt", args: "--range this-week" },
+            ],
+          },
+          {
+            title: "Automatic and manual",
+            commands: [
+              { label: "Choose a working mode", args: "--setup" },
+              { label: "Enable automatic saving", args: "--enable-auto" },
+              { label: "Switch to manual only", args: "--disable-auto" },
+              { label: "Check automatic saving", args: "--auto-status" },
+            ],
+          },
+          {
+            title: "Ticket Buddy and chat commands",
+            commands: [
+              { label: "Install Ticket Buddy and chat commands", args: "--install-companion" },
+              { label: "Install Ticket Buddy only", args: "--install-pet" },
+              { label: "Install chat commands only", args: "--install-skill" },
+            ],
+          },
+        ],
+      },
     },
     themes: {
       classic: "Classic White",
@@ -228,6 +336,36 @@ const RECEIPT_COPY = {
       interruptions: ["time", "times"],
       seconds: ["sec", "sec"],
     },
+    insights: {
+      title: "Efficiency & work structure",
+      cacheHit: "Cache hit rate",
+      perTurn: "Per-turn efficiency",
+      totalTokens: "total Tokens",
+      outputTokens: "output Tokens",
+      toolCalls: "tool calls",
+      firstTokenLatency: "First-token latency",
+      turnLatency: "Full-turn duration",
+      p50: "P50",
+      p90: "P90",
+      noSamples: "No samples",
+      heatmap: "Work-time heatmap",
+      heatmapCell: "{hour}:00 · {count} turns",
+      models: "Model structure",
+      tools: "Tool structure",
+      turnsUnit: "turns",
+      callsUnit: "calls",
+      toolCategories: {
+        terminal: "Terminal",
+        "file-edit": "File editing",
+        browser: "Browser",
+        research: "Research",
+        media: "Image & media",
+        agents: "Multi-agent",
+        planning: "Planning",
+        integrations: "Integrations",
+        other: "Other tools",
+      },
+    },
     footerThanks: "Thanks for your business. More revisions welcome tomorrow.",
     transferAria: "WeChat mini-program import stub",
     transferTitle: "IMPORT INTO WECHAT",

package/src/core/receipt-record.mjs

@@ -21,6 +21,30 @@ const SCHEMA_VERSION = 2;
 const SOURCE_VERSION = "cwr2";
 const COLLECTOR_VERSION = "0.6.0";
 
+function fallbackInsights(metrics) {
+  const completedTurns = Math.max(0, Number(metrics.completedTurns || 0));
+  const ratio = (value) => completedTurns ? Number(value || 0) / completedTurns : 0;
+  const inputTokens = Math.max(0, Number(metrics.tokens?.input_tokens || 0));
+  return {
+    cache_hit_rate: inputTokens
+      ? Math.min(1, Math.max(0, Number(metrics.tokens?.cached_input_tokens || 0) / inputTokens))
+      : 0,
+    per_turn: {
+      total_tokens: ratio(metrics.tokens?.total_tokens),
+      output_tokens: ratio(metrics.tokens?.output_tokens),
+      tool_calls: ratio(metrics.toolCalls),
+      work_duration_ms: Math.round(ratio(metrics.workDurationMs)),
+    },
+    latency_ms: {
+      first_token: { sample_count: 0, p50: 0, p90: 0 },
+      turn: { sample_count: 0, p50: 0, p90: 0 },
+    },
+    activity_by_hour: Array(24).fill(0),
+    model_usage: (metrics.models || []).map((model) => ({ model, count: 0 })),
+    tool_usage: metrics.toolCalls ? [{ category: "other", count: metrics.toolCalls }] : [],
+  };
+}
+
 function fingerprintSessionIds(sessionIds) {
   return crypto.createHash("sha256").update([...sessionIds].sort().join("|")).digest("hex").slice(0, 16);
 }
@@ -29,6 +53,7 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
   const sessionFingerprint = fingerprintSessionIds(metrics.sessionIds);
   const logicalKey = buildLogicalReceiptKey(metrics);
   const summaryOnly = metrics.mode === "last-hours";
+  const insights = metrics.insights || fallbackInsights(metrics);
   const schemaVersion = summaryOnly ? 1 : SCHEMA_VERSION;
   const sourceVersion = summaryOnly ? "cwr1" : SOURCE_VERSION;
   const id = summaryOnly
@@ -41,6 +66,7 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
     tools: metrics.toolCalls,
     turns: metrics.completedTurns,
     interruptions: metrics.interruptions,
+    insights,
     scope: metrics.mode,
     rangeStartDate: metrics.rangeStartDate,
     rangeEndDate: metrics.rangeEndDate,
@@ -104,6 +130,7 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       average_first_token_ms: Math.round(metrics.averageFirstTokenMs),
       tokens: { ...metrics.tokens },
       models: [...metrics.models],
+      insights,
       receipt_work_points: metrics.workPoints,
       receipt_formula_version: "receipt_work_points_v1",
     },
@@ -120,6 +147,9 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       contains_code: false,
       contains_paths: false,
       contains_filenames: false,
+      contains_tool_names: false,
+      contains_tool_arguments: false,
+      contains_tool_output: false,
     },
   };
   if (!summaryOnly) {

package/src/lib/tool-category.mjs

@@ -0,0 +1,36 @@
+const TOOL_CATEGORIES = new Set([
+  "terminal",
+  "file-edit",
+  "browser",
+  "research",
+  "media",
+  "agents",
+  "planning",
+  "integrations",
+  "other",
+]);
+
+export function normalizeToolCategory(value) {
+  return TOOL_CATEGORIES.has(value) ? value : "other";
+}
+
+export function classifyToolName(value) {
+  const name = String(value || "").trim().toLowerCase();
+  if (!name) return "other";
+  if (/(^|[_.-])(apply[_-]?patch|edit(?:[_-]?file)?|write(?:[_-]?file)?)$/.test(name)) return "file-edit";
+  if (/browser|playwright|computer|chrome|navigate|screenshot/.test(name)) return "browser";
+  if (/web[_-]?search|search[_-]?docs|fetch[_-]?doc|openai.*docs/.test(name)) return "research";
+  if (/image|audio|video|canvas|view[_-]?image/.test(name)) return "media";
+  if (/spawn[_-]?agent|send[_-]?message|followup[_-]?task|wait[_-]?agent|collaboration/.test(name)) return "agents";
+  if (/update[_-]?plan|request[_-]?user[_-]?input|create[_-]?goal|update[_-]?goal/.test(name)) return "planning";
+  if (/exec|shell|bash|terminal|write[_-]?stdin|command/.test(name)) return "terminal";
+  if (/^mcp__|connector|plugin|slack|github|notion|linear|figma/.test(name)) return "integrations";
+  return "other";
+}
+
+export function toolCategoryForRow(row) {
+  if (row?.type !== "response_item") return null;
+  const payloadType = row.payload?.type;
+  if (payloadType !== "custom_tool_call" && payloadType !== "function_call") return null;
+  return normalizeToolCategory(row.payload?.tool_category);
+}

package/src/parsers/codex.mjs

@@ -4,6 +4,7 @@ import os from "node:os";
 import path from "node:path";
 
 import { rowDate } from "../lib/time.mjs";
+import { classifyToolName } from "../lib/tool-category.mjs";
 
 const READ_CHUNK_BYTES = 256 * 1024;
 const MAX_JSONL_ROW_BYTES = 64 * 1024 * 1024;
@@ -70,6 +71,11 @@ function compactPayload(rowType, value) {
     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 };
+  } else if (
+    rowType === "response_item" &&
+    (value.type === "custom_tool_call" || value.type === "function_call")
+  ) {
+    payload.tool_category = classifyToolName(value.name);
   }
 
   return Object.keys(payload).length ? payload : null;

package/src/renderers/html.mjs

@@ -62,6 +62,151 @@ function formatDateKey(value, locale) {
   return locale === "en" ? `${match[2]}/${match[3]}/${match[1]}` : `${match[1]}/${match[2]}/${match[3]}`;
 }
 
+function formatDecimal(value, locale, maximumFractionDigits = 1) {
+  return new Intl.NumberFormat(locale === "en" ? "en-US" : "zh-CN", {
+    maximumFractionDigits,
+  }).format(Math.max(0, Number(value || 0)));
+}
+
+function formatPercent(value, locale) {
+  return new Intl.NumberFormat(locale === "en" ? "en-US" : "zh-CN", {
+    style: "percent",
+    maximumFractionDigits: 1,
+  }).format(Math.min(1, Math.max(0, Number(value || 0))));
+}
+
+function formatSeconds(milliseconds, locale) {
+  return `${formatDecimal(Number(milliseconds || 0) / 1000, locale)}s`;
+}
+
+function renderBreakdown(items, { key, labels = {}, unit, emptyLabel, locale }) {
+  if (!items.length) return `<p class="structure-empty">${escapeHtml(emptyLabel)}</p>`;
+  const maximum = Math.max(1, ...items.map((item) => Number(item.count || 0)));
+  return items.slice(0, 6).map((item) => {
+    const name = String(item[key] || "");
+    const label = labels[name] || name;
+    const count = Math.max(0, Number(item.count || 0));
+    const width = count ? Math.max(6, Math.round((count / maximum) * 100)) : 0;
+    return `
+          <div class="structure-row">
+            <span class="structure-name" title="${escapeHtml(label)}">${escapeHtml(label)}</span>
+            <span class="structure-bar" aria-hidden="true"><i style="width:${width}%"></i></span>
+            <strong>${escapeHtml(`${formatDecimal(count, locale, 0)} ${unit}`)}</strong>
+          </div>`;
+  }).join("");
+}
+
+function renderInsights(record, copy, locale) {
+  const insights = record.stats.insights || {};
+  const perTurn = insights.per_turn || {};
+  const firstToken = insights.latency_ms?.first_token || {};
+  const turnLatency = insights.latency_ms?.turn || {};
+  const activity = Array.from({ length: 24 }, (_, hour) => Number(insights.activity_by_hour?.[hour] || 0));
+  const activityPeak = Math.max(0, ...activity);
+  const heatmapCells = activity.map((count, hour) => {
+    const strength = count && activityPeak ? 16 + Math.round((count / activityPeak) * 84) : 4;
+    const aria = copy.insights.heatmapCell
+      .replaceAll("{hour}", String(hour).padStart(2, "0"))
+      .replaceAll("{count}", formatDecimal(count, locale, 0));
+    return `<span class="heatmap-cell" style="--heat:${strength}%" role="img" aria-label="${escapeHtml(aria)}" title="${escapeHtml(aria)}"></span>`;
+  }).join("");
+  const firstTokenValue = firstToken.sample_count
+    ? `${copy.insights.p50} ${formatSeconds(firstToken.p50, locale)}`
+    : copy.insights.noSamples;
+  const firstTokenDetail = firstToken.sample_count
+    ? `${copy.insights.p90} ${formatSeconds(firstToken.p90, locale)}`
+    : "—";
+  const turnValue = turnLatency.sample_count
+    ? `${copy.insights.p50} ${formatSeconds(turnLatency.p50, locale)}`
+    : copy.insights.noSamples;
+  const turnDetail = turnLatency.sample_count
+    ? `${copy.insights.p90} ${formatSeconds(turnLatency.p90, locale)}`
+    : "—";
+  const modelItems = insights.model_usage?.length
+    ? insights.model_usage
+    : (record.stats.models || []).map((model) => ({ model, count: 0 }));
+  const toolItems = insights.tool_usage || [];
+  const modelRows = renderBreakdown(modelItems, {
+    key: "model",
+    unit: copy.insights.turnsUnit,
+    emptyLabel: copy.insights.noSamples,
+    locale,
+  });
+  const toolRows = renderBreakdown(toolItems, {
+    key: "category",
+    labels: copy.insights.toolCategories,
+    unit: copy.insights.callsUnit,
+    emptyLabel: copy.insights.noSamples,
+    locale,
+  });
+
+  return `
+      <section class="insights" aria-label="${escapeHtml(copy.insights.title)}">
+        <h2 class="insights-title">${escapeHtml(copy.insights.title)}</h2>
+        <div class="insight-metrics">
+          <div class="insight-metric">
+            <span>${escapeHtml(copy.insights.cacheHit)}</span>
+            <strong>${escapeHtml(formatPercent(insights.cache_hit_rate, locale))}</strong>
+            <small>${escapeHtml(formatNumber(record.stats.tokens.cached_input_tokens, locale))} / ${escapeHtml(formatNumber(record.stats.tokens.input_tokens, locale))}</small>
+          </div>
+          <div class="insight-metric">
+            <span>${escapeHtml(copy.insights.perTurn)}</span>
+            <strong>${escapeHtml(`${formatDecimal(perTurn.total_tokens, locale)} Token`)}</strong>
+            <small>${escapeHtml(`${formatDecimal(perTurn.output_tokens, locale)} ${copy.insights.outputTokens} · ${formatDecimal(perTurn.tool_calls, locale)} ${copy.insights.toolCalls}`)}</small>
+          </div>
+          <div class="insight-metric">
+            <span>${escapeHtml(copy.insights.firstTokenLatency)}</span>
+            <strong>${escapeHtml(firstTokenValue)}</strong>
+            <small>${escapeHtml(firstTokenDetail)}</small>
+          </div>
+          <div class="insight-metric">
+            <span>${escapeHtml(copy.insights.turnLatency)}</span>
+            <strong>${escapeHtml(turnValue)}</strong>
+            <small>${escapeHtml(turnDetail)}</small>
+          </div>
+        </div>
+        <div class="heatmap-block">
+          <h3>${escapeHtml(copy.insights.heatmap)}</h3>
+          <div class="heatmap-grid">${heatmapCells}</div>
+          <div class="heatmap-axis" aria-hidden="true"><span>00</span><span>06</span><span>12</span><span>18</span><span>23</span></div>
+        </div>
+        <div class="structure-grid">
+          <section class="structure-group">
+            <h3>${escapeHtml(copy.insights.models)}</h3>${modelRows}
+          </section>
+          <section class="structure-group">
+            <h3>${escapeHtml(copy.insights.tools)}</h3>${toolRows}
+          </section>
+        </div>
+      </section>`;
+}
+
+function renderFeatureCommands(featureCopy, locale) {
+  const languageArgument = locale === "en" ? " --lang en" : "";
+  return featureCopy.groups.map((group) => {
+    const commands = group.commands.map((item) => {
+      const command = `npx codex-work-receipt@latest ${item.args}${languageArgument}`;
+      return `
+          <li class="feature-command">
+            <strong class="feature-command__name">${escapeHtml(item.label)}</strong>
+            <div class="feature-command__action">
+              <code tabindex="0">${escapeHtml(command)}</code>
+              <button class="feature-copy-button" type="button" data-copy-command="${escapeHtml(command)}" aria-label="${escapeHtml(`${featureCopy.copyLabel}: ${item.label}`)}" title="${escapeHtml(featureCopy.copyLabel)}">
+                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg>
+                <span data-copy-label>${escapeHtml(featureCopy.copyLabel)}</span>
+              </button>
+            </div>
+          </li>`;
+    }).join("");
+    return `
+        <section class="feature-group">
+          <h4>${escapeHtml(group.title)}</h4>
+          <ul>${commands}
+          </ul>
+        </section>`;
+  }).join("");
+}
+
 export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUrl = null, transferFile = null }) {
   const locale = record.locale || DEFAULT_LOCALE;
   const copy = getReceiptCopy(locale);
@@ -114,6 +259,19 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
     successLabel: copy.downloadSuccess,
     errorLabel: copy.downloadError,
   }).replaceAll("<", "\\u003c");
+  const featureConfig = JSON.stringify({
+    copyLabel: copy.sidebar.features.copyLabel,
+    copiedLabel: copy.sidebar.features.copiedLabel,
+    copyErrorLabel: copy.sidebar.features.copyErrorLabel,
+    copiedStatus: copy.sidebar.features.copiedStatus,
+    copyErrorStatus: copy.sidebar.features.copyErrorStatus,
+  }).replaceAll("<", "\\u003c");
+  const featureCommands = renderFeatureCommands(copy.sidebar.features, locale);
+  const featureCommandCount = copy.sidebar.features.groups
+    .reduce((total, group) => total + group.commands.length, 0);
+  const featureCountLabel = copy.sidebar.features.countLabel
+    .replace("{count}", formatNumber(featureCommandCount, locale));
+  const insights = renderInsights(record, copy, locale);
   const rows = [
     receiptRow(copy.rows.scope, scopeLabel),
     receiptRow(copy.rows.sessions, formatCount(record.stats.session_count, copy.units.sessions, locale)),
@@ -312,6 +470,199 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
       font-weight: 600;
       line-height: 1.4;
     }
+    .sidebar-features {
+      --feature-ink: #282620;
+      --feature-muted: #756f65;
+      --feature-line: #c9c2b6;
+      --feature-soft-line: #ded7cc;
+      --feature-paper: #f6f2e9;
+      --feature-paper-soft: #fbfaf7;
+      --feature-command: #ece8df;
+      padding: 0;
+      overflow: hidden;
+      border-color: var(--feature-line);
+      background: var(--feature-paper);
+      color: var(--feature-ink);
+      text-align: left;
+      transition: background .15s ease, border-color .15s ease, box-shadow .15s ease;
+    }
+    .sidebar-features[open] {
+      background: var(--feature-paper-soft);
+      box-shadow: 0 10px 28px rgba(53, 48, 39, .1);
+    }
+    .sidebar-features__summary {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 8px;
+      padding: 12px;
+      cursor: pointer;
+      list-style: none;
+      user-select: none;
+      transition: background .15s ease;
+    }
+    .sidebar-features__summary::-webkit-details-marker { display: none; }
+    .sidebar-features__summary:hover { background: #eee8dc; }
+    .sidebar-features__summary .sidebar-card__title {
+      margin: 0;
+      color: var(--feature-ink);
+    }
+    .sidebar-features__summary .sidebar-card__title svg { color: var(--feature-muted); }
+    .sidebar-features__summary:focus-visible {
+      outline: 2px solid var(--feature-ink);
+      outline-offset: -3px;
+    }
+    .sidebar-features__meta {
+      display: inline-flex;
+      align-items: center;
+      gap: 5px;
+      flex-shrink: 0;
+    }
+    .sidebar-features__count {
+      color: var(--feature-muted);
+      font-family: system-ui, -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;
+      font-size: 9px;
+      white-space: nowrap;
+    }
+    .sidebar-features__chevron {
+      width: 14px;
+      height: 14px;
+      flex-shrink: 0;
+      color: var(--feature-muted);
+      transition: transform .18s ease;
+    }
+    .sidebar-features[open] .sidebar-features__chevron { transform: rotate(180deg); }
+    .sidebar-features__body {
+      padding: 0 12px 12px;
+      border-top: 1px solid var(--feature-soft-line);
+      background: var(--feature-paper-soft);
+      animation: feature-reveal .15s ease-out;
+    }
+    .sidebar-features .sidebar-features__description {
+      margin: 10px 0 12px;
+      color: var(--feature-muted);
+    }
+    .feature-group + .feature-group {
+      margin-top: 14px;
+      padding-top: 13px;
+      border-top: 1px solid var(--feature-soft-line);
+    }
+    .feature-group h4 {
+      margin: 0 0 8px;
+      color: var(--feature-muted);
+      font-family: system-ui, -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;
+      font-size: 9px;
+      font-weight: 700;
+      letter-spacing: .08em;
+      text-transform: uppercase;
+    }
+    .feature-group ul {
+      margin: 0;
+      padding: 0;
+      list-style: none;
+    }
+    .feature-command + .feature-command {
+      margin-top: 10px;
+      padding-top: 10px;
+      border-top: 1px dashed var(--feature-soft-line);
+    }
+    .feature-command__name {
+      display: block;
+      margin-bottom: 5px;
+      color: var(--feature-ink);
+      font-family: system-ui, -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;
+      font-size: 10px;
+      font-weight: 600;
+      line-height: 1.4;
+    }
+    .feature-command__action {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto;
+      gap: 5px;
+      align-items: stretch;
+    }
+    .feature-command code {
+      display: block;
+      min-width: 0;
+      padding: 6px;
+      overflow-x: auto;
+      border: 1px solid #d5cfc4;
+      border-radius: 4px;
+      background: var(--feature-command);
+      color: #34312c;
+      font-size: 9px;
+      line-height: 1.35;
+      white-space: nowrap;
+      scrollbar-width: thin;
+      scrollbar-color: #b8b0a4 transparent;
+    }
+    .feature-command code:focus-visible {
+      outline: 2px solid #81786c;
+      outline-offset: 1px;
+    }
+    .feature-copy-button {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      gap: 3px;
+      min-width: 48px;
+      padding: 5px 6px;
+      border: 1px solid #bdb5a9;
+      border-radius: 4px;
+      background: #fff;
+      color: #4c4942;
+      cursor: pointer;
+      font-family: system-ui, -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;
+      font-size: 9px;
+      font-weight: 600;
+    }
+    .feature-copy-button:hover { background: #e5dfd4; }
+    .feature-copy-button:focus-visible {
+      outline: 2px solid var(--feature-ink);
+      outline-offset: 2px;
+    }
+    .feature-copy-button svg {
+      width: 11px;
+      height: 11px;
+      flex-shrink: 0;
+    }
+    .feature-copy-button[data-state="success"] {
+      border-color: #78a782;
+      background: #eef7ef;
+      color: #276036;
+    }
+    .feature-copy-button[data-state="error"] {
+      border-color: #c88c84;
+      background: #fff1ef;
+      color: #8b3028;
+    }
+    .feature-copy-status {
+      position: absolute;
+      width: 1px;
+      height: 1px;
+      padding: 0;
+      margin: -1px;
+      overflow: hidden;
+      clip: rect(0, 0, 0, 0);
+      white-space: nowrap;
+      border: 0;
+    }
+    @keyframes feature-reveal {
+      from { opacity: 0; transform: translateY(-3px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+    @media (min-width: 1021px) {
+      .sidebar-features[open] {
+        width: 300px;
+        margin-left: -120px;
+      }
+    }
+    @media (prefers-reduced-motion: reduce) {
+      .sidebar-features,
+      .sidebar-features__summary,
+      .sidebar-features__chevron { transition: none; }
+      .sidebar-features__body { animation: none; }
+    }
     .toolbar {
       display: flex;
       width: 100%;
@@ -452,6 +803,110 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
       padding: 8px 6px;
       background: var(--accent);
     }
+    .insights-title {
+      margin: 0 0 12px;
+      font-size: 14px;
+      letter-spacing: 0;
+      text-align: center;
+    }
+    .insight-metrics {
+      display: grid;
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+      border-top: 1px solid var(--line);
+      border-left: 1px solid var(--line);
+    }
+    .insight-metric {
+      min-width: 0;
+      padding: 10px;
+      border-right: 1px solid var(--line);
+      border-bottom: 1px solid var(--line);
+    }
+    .insight-metric span,
+    .insight-metric strong,
+    .insight-metric small { display: block; }
+    .insight-metric span {
+      color: var(--muted);
+      font-size: 10px;
+      line-height: 1.35;
+    }
+    .insight-metric strong {
+      margin-top: 5px;
+      font-size: 16px;
+      line-height: 1.2;
+    }
+    .insight-metric small {
+      margin-top: 4px;
+      overflow: hidden;
+      color: var(--muted);
+      font-size: 9px;
+      line-height: 1.35;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .heatmap-block,
+    .structure-grid {
+      margin-top: 16px;
+      padding-top: 14px;
+      border-top: 1px dashed var(--line);
+    }
+    .heatmap-block h3,
+    .structure-group h3 {
+      margin: 0 0 9px;
+      color: var(--muted);
+      font-size: 10px;
+      letter-spacing: 0;
+      text-transform: uppercase;
+    }
+    .heatmap-grid {
+      display: grid;
+      grid-template-columns: repeat(24, minmax(0, 1fr));
+      gap: 2px;
+    }
+    .heatmap-cell {
+      display: block;
+      height: 22px;
+      background: color-mix(in srgb, var(--ink) var(--heat), transparent);
+    }
+    .heatmap-axis {
+      display: flex;
+      justify-content: space-between;
+      margin-top: 5px;
+      color: var(--muted);
+      font-size: 8px;
+    }
+    .structure-grid {
+      display: grid;
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+      gap: 18px;
+    }
+    .structure-group { min-width: 0; }
+    .structure-row {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) minmax(32px, .65fr) auto;
+      gap: 6px;
+      align-items: center;
+      min-width: 0;
+      padding: 4px 0;
+      font-size: 9px;
+    }
+    .structure-name {
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+    .structure-bar {
+      display: block;
+      height: 4px;
+      background: color-mix(in srgb, var(--ink) 10%, transparent);
+    }
+    .structure-bar i {
+      display: block;
+      height: 100%;
+      background: var(--ink);
+    }
+    .structure-row strong { font-size: 8px; white-space: nowrap; }
+    .structure-empty { margin: 0; color: var(--muted); font-size: 9px; }
     .verdict { text-align: center; }
     .verdict h2 { margin: 0; font-size: 22px; letter-spacing: .04em; }
     .review {
@@ -663,6 +1118,7 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
         flex: 1 1 160px;
         min-width: 0;
       }
+      .sidebar-features { flex-basis: 100%; }
     }
     @media (max-width: 420px) {
       .layout { padding-inline: 10px; }
@@ -674,6 +1130,7 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
       .meta { grid-template-columns: 1fr; }
       .meta div:nth-child(even) { text-align: left; }
       .transfer-layout { grid-template-columns: 1fr; }
+      .structure-grid { grid-template-columns: 1fr; }
       .sidebar { flex-direction: column; }
       .sidebar-card { flex-basis: auto; }
     }
@@ -713,6 +1170,10 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
       <section>${rows}</section>
       <div class="divider"></div>
 
+      ${insights}
+
+      <div class="divider"></div>
+
       <section class="verdict">
         <h2>${escapeHtml(record.presentation.work_title)}</h2>
         <p class="review">${escapeHtml(record.presentation.review)}</p>
@@ -768,12 +1229,29 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
         <span class="sidebar-sponsor__name">ModelFlare<br>modelflare.dev</span>
       </a>
     </div>
+    <details class="sidebar-card sidebar-features" data-feature-details>
+      <summary class="sidebar-features__summary">
+        <span class="sidebar-card__title">
+          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><polyline points="4 17 10 11 4 5"></polyline><line x1="12" x2="20" y1="19" y2="19"></line></svg>
+          ${escapeHtml(copy.sidebar.features.title)}
+        </span>
+        <span class="sidebar-features__meta">
+          <span class="sidebar-features__count">${escapeHtml(featureCountLabel)}</span>
+          <svg class="sidebar-features__chevron" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"></path></svg>
+        </span>
+      </summary>
+      <div class="sidebar-features__body">
+        <p class="sidebar-features__description">${escapeHtml(copy.sidebar.features.description)}</p>${featureCommands}
+        <span class="feature-copy-status" data-feature-copy-status role="status" aria-live="polite"></span>
+      </div>
+    </details>
   </aside>
   </div>
   <script>${inlineScript(DOM_TO_IMAGE_SOURCE)}</script>
   <script>
     const exportConfig = ${exportConfig};
     const transferConfig = ${transferConfig};
+    const featureConfig = ${featureConfig};
     const themes = new Set(["classic", "diner", "payroll"]);
     const buttons = [...document.querySelectorAll("[data-theme-value]")];
     function applyTheme(theme) {
@@ -787,6 +1265,75 @@ export function renderHtml({ record, dataQrDataUrl = null, miniProgramCodeDataUr
     try { savedTheme = localStorage.getItem("codex-work-receipt-theme"); } catch {}
     applyTheme(savedTheme || document.documentElement.dataset.theme);
 
+    const featureDetails = document.querySelector("[data-feature-details]");
+    if (featureDetails) {
+      try {
+        const savedFeatureState = localStorage.getItem("codex-work-receipt-features-open");
+        if (savedFeatureState === "true") featureDetails.open = true;
+        if (savedFeatureState === "false") featureDetails.open = false;
+      } catch {}
+      featureDetails.addEventListener("toggle", () => {
+        try { localStorage.setItem("codex-work-receipt-features-open", String(featureDetails.open)); } catch {}
+      });
+    }
+
+    function fallbackCopyText(value) {
+      const textarea = document.createElement("textarea");
+      textarea.value = value;
+      textarea.setAttribute("readonly", "");
+      Object.assign(textarea.style, {
+        position: "fixed",
+        left: "-10000px",
+        top: "0",
+        opacity: "0",
+        pointerEvents: "none",
+      });
+      document.body.appendChild(textarea);
+      textarea.focus();
+      textarea.select();
+      textarea.setSelectionRange(0, textarea.value.length);
+      const copied = document.execCommand("copy");
+      textarea.remove();
+      if (!copied) throw new Error("Clipboard copy was rejected");
+    }
+
+    async function copyFeatureCommand(value) {
+      if (navigator.clipboard?.writeText) {
+        try {
+          await navigator.clipboard.writeText(value);
+          return;
+        } catch {}
+      }
+      fallbackCopyText(value);
+    }
+
+    const featureCopyStatus = document.querySelector("[data-feature-copy-status]");
+    document.querySelectorAll("[data-copy-command]").forEach((button) => {
+      let resetTimer = null;
+      button.addEventListener("click", async () => {
+        const label = button.querySelector("[data-copy-label]");
+        clearTimeout(resetTimer);
+        button.disabled = true;
+        try {
+          await copyFeatureCommand(button.dataset.copyCommand || "");
+          button.dataset.state = "success";
+          if (label) label.textContent = featureConfig.copiedLabel;
+          if (featureCopyStatus) featureCopyStatus.textContent = featureConfig.copiedStatus;
+        } catch (error) {
+          console.error(error);
+          button.dataset.state = "error";
+          if (label) label.textContent = featureConfig.copyErrorLabel;
+          if (featureCopyStatus) featureCopyStatus.textContent = featureConfig.copyErrorStatus;
+        } finally {
+          button.disabled = false;
+          resetTimer = setTimeout(() => {
+            delete button.dataset.state;
+            if (label) label.textContent = featureConfig.copyLabel;
+          }, 1800);
+        }
+      });
+    });
+
     const downloadFileButton = document.getElementById("download-import-file");
     const downloadStatus = document.getElementById("download-status");
     if (downloadFileButton && downloadStatus) {