codex-work-receipt 0.3.0

package/README.en.md

@@ -0,0 +1,167 @@
+# Codex Work Receipt
+
+<p align="center">
+  <a href="./README.md">中文</a> · <strong>English</strong>
+</p>
+
+<p align="center">
+  <strong>Turn local Codex activity into a work receipt you can keep and share.</strong><br>
+  One command · Local-first · Chinese & English · Three themes · Mobile QR import
+</p>
+
+<p align="center">
+  <img alt="Node.js 20+" src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white">
+  <img alt="Local first" src="https://img.shields.io/badge/data-local--first-17231F">
+  <img alt="Privacy first" src="https://img.shields.io/badge/privacy-no%20prompts%20or%20code-42CDA7">
+</p>
+
+<p align="center">
+  <img src="docs/images/readme-hero.jpg" alt="Three Codex Work Receipt themes" width="920">
+</p>
+
+The tool reads timestamps and numerical metadata from local Codex sessions. Generated receipts do not contain prompts, responses, source code, project paths, or file names.
+
+## Sponsor
+
+<p align="center">
+  <a href="https://modelflare.dev/">
+    <img src="docs/images/sponsors/modelflare-logo.png" alt="ModelFlare Logo" width="72">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://modelflare.dev/"><strong>ModelFlare</strong></a><br>
+  <a href="https://modelflare.dev/">modelflare.dev</a><br>
+  <sub>Stable access to leading AI model APIs at a very low cost, with developer-friendly pricing, transparent billing, and clear usage visibility.</sub>
+</p>
+
+## Receipt themes
+
+<table>
+  <tr>
+    <td align="center"><strong>Classic</strong></td>
+    <td align="center"><strong>Vintage Diner</strong></td>
+    <td align="center"><strong>Night Payroll</strong></td>
+  </tr>
+  <tr>
+    <td><img src="docs/images/receipts/receipt-classic.jpg" alt="Classic work receipt" width="320"></td>
+    <td><img src="docs/images/receipts/receipt-diner.jpg" alt="Vintage diner work receipt" width="320"></td>
+    <td><img src="docs/images/receipts/receipt-payroll.jpg" alt="Night payroll work receipt" width="320"></td>
+  </tr>
+</table>
+
+## Quick start
+
+Requires Node.js 20+ and local Codex session records.
+
+```bash
+npx codex-work-receipt@latest --latest --lang en
+```
+
+Summarize all Codex activity from today in your local timezone:
+
+```bash
+npx codex-work-receipt@latest --today --lang en
+```
+
+Outputs are written to `./codex-work-receipt-output/` by default.
+
+## Desktop-to-mobile flow
+
+```text
+Local Codex sessions
+  → run one command
+  → generate an HTML receipt and data QR code
+  → scan from the companion mini program
+  → change themes, save, and share
+```
+
+The companion mini program supports QR import, local history, themes, and image export. Scan the official mini-program code with WeChat, then scan the adjacent data QR code to import the current receipt.
+
+## Ask Codex directly
+
+Install the AI Work Receipt skill once:
+
+```bash
+npx codex-work-receipt@latest --install-skill --lang en
+```
+
+Then ask Codex naturally:
+
+> Create an AI work receipt for my latest Codex session.
+
+> Generate today's AI work receipt with the diner theme.
+
+Codex will select the correct mode and theme, run the CLI, and open the generated page. You can also invoke `$ai-work-receipt` explicitly.
+
+The skill is installed at `~/.agents/skills/ai-work-receipt/` and does not modify the current repository. Restart Codex if the current session does not detect it.
+
+## Features
+
+- Latest-session and today summaries
+- Complete Chinese and English receipt copy
+- Three visual receipt themes
+- Turns, user messages, tool calls, interruptions, Tokens, duration, and models
+- Playful AI work points, job titles, and reviews
+- Versioned `cwr1` QR payload for mobile import
+- Local JSON snapshots and deduplicated history
+- Installable Codex skill for natural-language generation
+- No prompt, response, code, path, or file-name export
+
+## Common options
+
+```bash
+npx codex-work-receipt@latest --latest --lang en --theme diner
+npx codex-work-receipt@latest --latest --lang en --no-open
+npx codex-work-receipt@latest --today --lang en --timezone Asia/Shanghai --output ./my-receipt.html
+```
+
+Run `npx codex-work-receipt@latest --help` for the full option list.
+
+## Privacy
+
+- Reads `~/.codex/sessions/**/*.jsonl` by default
+- Extracts event types, timestamps, model names, and numerical statistics only
+- Does not store prompts, responses, source code, project paths, or file names
+- Does not send session data over the network while running
+- Saves HTML and structured history locally
+
+See [docs/privacy.md](docs/privacy.md) and [docs/data-schema.md](docs/data-schema.md).
+
+## Open-source boundary
+
+This repository contains the desktop CLI, receipt renderer, QR data protocol, tests, and documentation. It does not contain the companion mini-program source code or server implementation.
+
+## Local development
+
+```bash
+git clone https://github.com/a-bai-2026/ai-work-receipt.git
+cd codex-work-receipt
+npm install
+npm test
+npm run receipt -- --latest
+```
+
+Please read [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md) before contributing. Never submit real Codex sessions.
+
+## Roadmap
+
+- More receipt themes
+- Cursor and WorkBuddy data sources
+- Cross-tool activity reports
+- Weekly and monthly AI work archives
+- More parser fixtures and end-to-end compatibility tests
+
+## License and disclaimer
+
+- The desktop source code in this repository is licensed under [GNU GPL v3](LICENSE) (`GPL-3.0-only`)
+- Modified or redistributed versions must continue to comply with GPLv3 and provide the corresponding source code
+- GPLv3 applies only to the desktop project in this repository; it does not cover the companion mini program, backend services, or other independent products
+- This is an unofficial community project and is not affiliated with or endorsed by OpenAI
+- Codex and other product names belong to their respective owners
+
+---
+
+<p align="center">
+  <strong>If the receipt made you smile, consider leaving a Star.</strong>
+</p>

package/README.md

@@ -0,0 +1,244 @@
+# Codex AI 打工小票
+
+<p align="center">
+  <strong>中文</strong> · <a href="./README.en.md">English</a>
+</p>
+
+<p align="center">
+  <strong>把本机 Codex 的工作记录，开成一张可以带走的 AI 打工小票。</strong><br>
+  一行命令 · 完全本地 · 中英双语 · 三种主题 · 扫码传到手机
+</p>
+
+<p align="center">
+  <img alt="Node.js 20+" src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white">
+  <img alt="Local first" src="https://img.shields.io/badge/data-local--first-17231F">
+  <img alt="Privacy first" src="https://img.shields.io/badge/privacy-no%20prompts%20or%20code-42CDA7">
+</p>
+
+<p align="center">
+  <img src="docs/images/readme-hero.jpg" alt="Codex AI 打工小票三种主题效果" width="920">
+</p>
+
+<p align="center">
+  只读取本机 Codex 会话中的时间和数字统计。<br>
+  不会把 Prompt、回复正文、代码、项目路径或文件名写入小票。
+</p>
+
+## 赞助商
+
+<p align="center">
+  <a href="https://modelflare.dev/">
+    <img src="docs/images/sponsors/modelflare-logo.png" alt="ModelFlare Logo" width="72">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://modelflare.dev/"><strong>ModelFlare</strong></a><br>
+  <a href="https://modelflare.dev/">modelflare.dev</a><br>
+  <sub>让个人开发者也能以很低的成本稳定接入前沿 AI 模型 API，价格友好、计费透明、用量清晰可见。</sub>
+</p>
+
+## 三种小票主题
+
+<table>
+  <tr>
+    <td align="center"><strong>经典白票</strong></td>
+    <td align="center"><strong>复古粉票</strong></td>
+    <td align="center"><strong>夜班绿票</strong></td>
+  </tr>
+  <tr>
+    <td><img src="docs/images/receipts/receipt-classic.jpg" alt="AI 打工小票经典白票" width="320"></td>
+    <td><img src="docs/images/receipts/receipt-diner.jpg" alt="AI 打工小票复古粉票" width="320"></td>
+    <td><img src="docs/images/receipts/receipt-payroll.jpg" alt="AI 打工小票夜班绿票" width="320"></td>
+  </tr>
+</table>
+
+三种主题只改变视觉表达，不改变统计口径。生成网页后也可以即时切换主题。
+
+## 30 秒快速开始
+
+需要 Node.js 20 或更高版本，并且本机已经使用过 Codex。
+
+不需要克隆仓库，统计最近一次会话并自动打开小票：
+
+```bash
+npx codex-work-receipt@latest --latest
+```
+
+汇总本地时区今天发生的全部 Codex 活动：
+
+```bash
+npx codex-work-receipt@latest --today
+```
+
+生成英文版小票：
+
+```bash
+npx codex-work-receipt@latest --latest --lang en
+```
+
+生成结果默认保存在：
+
+```text
+./codex-work-receipt-output/
+├── codex-receipt-latest.html
+└── codex-receipt-latest.json
+```
+
+## 从电脑到手机
+
+```text
+Codex 本地会话
+  ↓
+运行一行命令
+  ↓
+生成 AI 打工小票网页和数据二维码
+  ↓
+在配套小程序中扫码导入
+  ↓
+换模板、保存图片、分享
+```
+
+配套小程序已经支持扫码导入、本地历史、主题切换和保存图片。微信扫码即可进入配套小程序，再扫描旁边的数据二维码导入当前小票。
+
+数据二维码只携带版本化的脱敏统计，不携带图片和原始会话。桌面端与小程序端分别根据同一份结构数据渲染小票。
+
+## 直接跟 Codex 说
+
+只需安装一次 AI 打工小票 Skill：
+
+```bash
+npx codex-work-receipt@latest --install-skill
+```
+
+以后可以直接对 Codex 说：
+
+> 给刚刚这次工作开一张 AI 打工小票。
+
+> 生成我今天的 AI 打工小票，使用复古粉票。
+
+> 用英文生成刚刚这次工作的 AI 打工小票。
+
+Codex 会自动判断 `--latest` 或 `--today`、选择主题、执行命令并打开生成的网页。也可以通过 `$ai-work-receipt` 显式调用。
+
+Skill 安装在用户目录 `~/.agents/skills/ai-work-receipt/`，不会写入当前代码仓库；如果当前会话没有识别到，请重启 Codex。
+
+## 它能做什么
+
+- 统计最近一次 Codex 会话，或汇总今天的全部活动
+- 生成经典白票、复古粉票、夜班绿票三种主题
+- 支持中文和英文两套完整小票文案
+- 统计会话、轮次、用户消息、工具调用和中断次数
+- 展示 Token、缓存输入、AI 工作时长和模型
+- 根据工作量生成娱乐化的 AI 工分、今日工种和点评
+- 生成可供配套小程序扫描的 `cwr1` 数据二维码
+- 在本机保存结构 JSON 和去重后的历史记录
+- 安装可通过自然语言触发的 Codex Skill
+- 全程不上传 Prompt、回复、代码或项目路径
+
+## 常用命令
+
+选择默认主题：
+
+```bash
+npx codex-work-receipt@latest --latest --theme diner
+```
+
+仅生成文件，不自动打开浏览器：
+
+```bash
+npx codex-work-receipt@latest --latest --no-open
+```
+
+指定时区和输出路径：
+
+```bash
+npx codex-work-receipt@latest --today \
+  --timezone Asia/Shanghai \
+  --output ./my-receipt.html
+```
+
+可用参数：
+
+| 参数 | 说明 |
+| --- | --- |
+| `--latest` | 统计最近活跃的 Codex 会话，默认模式 |
+| `--today` | 汇总指定时区今天发生的 Codex 活动 |
+| `--timezone <name>` | 指定 IANA 时区，例如 `Asia/Shanghai` |
+| `--lang <name>` | `zh-CN`（默认）或 `en` |
+| `--theme <name>` | `classic`、`diner` 或 `payroll` |
+| `--output <file>` | 指定 HTML 输出路径 |
+| `--data-dir <directory>` | 指定本地结构历史目录 |
+| `--install-skill` | 将 AI 打工小票 Skill 安装到当前用户的 Codex |
+| `--no-open` | 生成后不自动打开浏览器 |
+
+## 本地保存的数据
+
+每次运行会生成或更新：
+
+- `codex-work-receipt-output/codex-receipt-*.html`：可切换主题的小票网页
+- `codex-work-receipt-output/codex-receipt-*.json`：当前小票的版本化结构数据
+- `~/.codex-work-receipt/receipts/*.json`：本机历史快照
+- `~/.codex-work-receipt/latest.json`：最近生成的一张小票
+- `~/.codex-work-receipt/history.jsonl`：去重后的本地历史，方便未来批量迁移
+
+数据结构和二维码协议见 [docs/data-schema.md](docs/data-schema.md)。
+
+## 隐私设计
+
+- 默认只读取 `~/.codex/sessions/**/*.jsonl`
+- 只提取事件类型、时间、模型名称和数字统计
+- 不保存 Prompt、回复正文、代码、项目路径或文件名
+- 运行期间不向网络发送会话数据
+- HTML、结构 JSON 和历史记录全部保存在本机
+- 二维码等同于一份可扫描的数据文件，请只向信任的人展示
+
+更完整的隐私说明见 [docs/privacy.md](docs/privacy.md)。
+
+## 当前限制
+
+- 暂不统计修改文件数和代码行数，避免在不同工具调用方式下产生误导
+- `--today` 默认扫描最近 72 小时有变动的会话文件，再按事件日期筛选
+- 当前只支持 Codex；Cursor、WorkBuddy 等数据源仍在规划中
+- 网页端不直接导出图片，移动端渲染和保存由配套小程序完成
+
+## 本地开发
+
+```bash
+git clone https://github.com/a-bai-2026/ai-work-receipt.git
+cd codex-work-receipt
+npm install
+npm test
+npm run receipt -- --latest
+```
+
+贡献前请阅读：
+
+- [CONTRIBUTING.md](CONTRIBUTING.md)
+- [SECURITY.md](SECURITY.md)
+- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+
+测试数据必须是人工构造或彻底脱敏的 fixture，禁止提交真实 Codex 会话。
+
+## Roadmap
+
+- 增加更多可传播的小票主题
+- 支持 Cursor、WorkBuddy 等 AI 工作工具
+- 完善跨工具的统一数据结构
+- 支持周报、月报和长期 AI 工作档案
+- 改进 Codex 不同版本的日志兼容性和端到端测试
+
+## 许可与声明
+
+- 本仓库中的电脑端源码采用 [GNU GPL v3](LICENSE)（`GPL-3.0-only`）许可
+- 修改或分发本项目时，必须继续遵守 GPLv3 并提供相应源码
+- GPLv3 仅适用于本仓库中的电脑端项目，不覆盖配套小程序、后台服务或其他独立产品
+- 本项目是非 OpenAI 官方社区工具，与 OpenAI 无隶属或背书关系
+- Codex、Cursor、WorkBuddy 及相关名称和商标归各自权利人所有
+
+---
+
+<p align="center">
+  <strong>如果这张小票让你觉得有点意思，欢迎点一个 Star。</strong><br>
+  让每一次 AI 打工，都留下一张可以带走的记录。
+</p>

package/SECURITY.md

@@ -0,0 +1,7 @@
+# Security
+
+Codex Work Receipt 默认只读取本机 Codex 会话元数据，不发起网络请求。
+
+请不要在公开 Issue 中粘贴真实会话、Prompt、代码、API Key 或本地路径。安全问题请通过仓库的私密安全报告渠道提交。
+
+配套小程序源码、微信 AppID 配置、AppSecret、后台代码和任何服务端密钥都不得提交到本仓库。公开的小程序码图片可以作为产品入口单独配置，但不代表小程序源码属于本项目的一部分。

package/assets/README.md

@@ -0,0 +1,11 @@
+# Assets
+
+配套小程序的正式微信小程序码固定保存在：
+
+```text
+assets/miniprogram-code.png
+```
+
+它会随发布包内置，是配套小程序的公开入口素材，不包含小程序源码、AppID、密钥或后台配置。项目不提供自定义替换参数。
+
+如果发布包中暂时没有这张图片，网页会显示明确的“待接入”占位符，不会生成伪造的小程序码。

package/docs/data-schema.md

@@ -0,0 +1,25 @@
+# Receipt data schema
+
+当前结构版本为 `1`。每次生成都会在本机保存一份结构记录。
+
+主要字段：
+
+- `schema_version`：结构版本
+- `locale`：当前桌面小票语言，支持 `zh-CN` 和 `en`
+- `id`：根据统计快照生成的匿名ID
+- `generated_at`：生成时间
+- `source`：数据来源和统计范围
+- `period`：开始、结束和时区
+- `stats`：轮次、消息、工具、Token、时长等统计
+- `presentation`：默认主题、语言无关的 `work_profile`、本地化工种、点评和 AI 工分
+- `privacy`：明确声明不包含的敏感内容
+
+同一个最近会话、或同一天的 `id` 保持稳定；重复生成会更新该记录，而不是不断制造重复历史。`source.snapshot_hash` 用于识别统计内容是否发生变化。
+
+二维码使用精简字段，并采用以下格式：
+
+```text
+cwr1.<checksum>.<deflateRaw(JSON) 的 Base64URL>
+```
+
+二维码中的 `presentation.compensation` 为娱乐化 AI 工分，不代表真实 API 费用。为兼容当前中文小程序，二维码中的展示文案继续使用中文，同时通过精简字段 `l` 和 `r` 携带桌面语言及工种语义 ID；英文 HTML 和本地 JSON 不受影响。小程序应先检查前缀和校验值，再解析数据。未来结构升级通过 `v` 字段兼容。

package/docs/mobile-import.md

@@ -0,0 +1,15 @@
+# Mobile import
+
+当前桌面网页会生成真实的数据二维码，配套小程序已经支持无服务器导入：
+
+1. 扫描固定小程序码并打开小程序。
+2. 点击“从电脑导入”。
+3. 使用小程序扫码能力扫描网页右侧的数据二维码。
+4. 校验 `cwr1` 前缀、checksum 和结构版本。
+5. 解压并解析统计数据。
+6. 写入小程序本地历史，并根据小票 ID 去重。
+7. 使用 Canvas 重新绘制选定模板并保存到手机相册。
+
+二维码不传输图片。桌面端与小程序端分别根据同一份结构数据渲染。
+
+配套小程序是独立产品，本仓库不包含其源码、AppID、后台代码或服务端密钥。

package/docs/privacy.md

@@ -0,0 +1,12 @@
+# Privacy model
+
+默认行为：
+
+- 只读取 `~/.codex/sessions/**/*.jsonl`
+- 只提取事件类型、时间和数字统计
+- 不保存 Prompt、回复正文、代码、项目路径或文件名
+- 不向网络发送数据
+- 结构数据保存在 `~/.codex-work-receipt/`
+
+二维码只包含当前小票的脱敏统计。二维码等同于一份可扫描的数据文件，请只向信任的人展示。
+

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "codex-work-receipt",
+  "version": "0.3.0",
+  "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"
+  },
+  "homepage": "https://github.com/a-bai-2026/ai-work-receipt#readme",
+  "bugs": {
+    "url": "https://github.com/a-bai-2026/ai-work-receipt/issues"
+  },
+  "license": "GPL-3.0-only",
+  "keywords": [
+    "codex",
+    "codex-skill",
+    "receipt",
+    "developer-tools",
+    "local-first",
+    "privacy"
+  ],
+  "bin": {
+    "codex-work-receipt": "src/cli.mjs"
+  },
+  "scripts": {
+    "receipt": "node src/cli.mjs",
+    "test": "node --test",
+    "check": "node --check src/cli.mjs && node --check src/core/skill-installer.mjs",
+    "prepublishOnly": "npm test && npm run check"
+  },
+  "files": [
+    "src",
+    "skills",
+    "templates",
+    "assets",
+    "docs",
+    "CHANGELOG.md",
+    "CODE_OF_CONDUCT.md",
+    "CONTRIBUTING.md",
+    "README.md",
+    "README.en.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "qrcode": "^1.5.4"
+  }
+}

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

@@ -0,0 +1,42 @@
+---
+name: ai-work-receipt
+description: Generate and open a privacy-first local AI work receipt from Codex session metadata. Use when the user asks Codex to create, regenerate, open, or locate an “AI 打工小票” or “AI work receipt” for the latest session or today, in Chinese or English, including requests for the classic, diner, or payroll theme. Do not use for real invoices, salary calculations, API billing, or non-Codex activity.
+---
+
+# AI 打工小票
+
+Use the published `codex-work-receipt` CLI as the only statistics and rendering engine. Execute the command for the user instead of merely describing it. Do not reimplement or inspect Codex session parsing yourself.
+
+## Interpret the request
+
+- Use `--latest` for “刚刚”“这次”“最近一次”“上一段工作” or an unspecified request for one receipt.
+- Use `--today` for “今天”“今日”“今天全部工作” or a daily summary.
+- Use `--theme classic` for “经典白票” or no specified theme.
+- Use `--theme diner` for “复古粉票”“粉色小票” or “diner”.
+- Use `--theme payroll` for “夜班绿票”“绿色小票” or “payroll”.
+- Add `--no-open` only when the user asks not to open the browser.
+- Add `--timezone <IANA name>` only when the user explicitly requests another timezone.
+- Use `--lang en` when the user requests English or asks for the receipt in English. Use `--lang zh-CN` otherwise.
+- If the user asks for an unsupported date range, explain that the current version supports only the latest session or today. Do not invent flags.
+
+## Execute
+
+1. Check `node --version`. Require Node.js 20 or newer. If it is missing or older, report the requirement and stop.
+2. Run from the user's current working directory:
+
+```bash
+npx --yes codex-work-receipt@latest --latest --lang zh-CN --theme classic
+```
+
+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.
+
+## Privacy and failures
+
+- Do not read, quote, summarize, or expose prompt text, response text, code, project paths, or file names from Codex sessions.
+- Do not upload session data or add custom mini-program codes. The CLI reads numerical metadata locally and uses the fixed official mini-program code.
+- If `npx` needs network permission to fetch the package, request the narrow permission needed to run it.
+- If no Codex session is found, report that the user must complete at least one Codex task locally before generating a receipt.
+- If generation fails, return the CLI error concisely and do not claim that a receipt was created.

package/skills/ai-work-receipt/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AI 打工小票"
+  short_description: "使用自然语言生成中英文 AI 打工小票并扫码导入手机"
+  default_prompt: "使用 $ai-work-receipt 给我刚刚这次 Codex 工作生成一张 AI 打工小票。"