codex-work-receipt 0.9.0 → 0.10.1

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.10.1
+
+- 修复宽屏 HTML 报告中“更多小票功能”向左覆盖小票主体的问题，展开面板现在与赞助商卡片保持中心对齐并随视口自适应宽度。
+- 中小屏提前切换为单栏文档流，四个功能 Tab 改为两行展示；手机端命令列表改为单列，避免横向遮挡和拥挤。
+
+## 0.10.0
+
+- 新增 `--custom-range`、`--from` 和 `--to`，支持自定义完整自然日或精确到时分的统计区间。
+- 自定义自然日继续生成 cwr2 规范事实；精确时间区间使用不参与供销社统计的兼容 cwr1 私人摘要。
+- 新增 `--select-session`、`--select-project` 和 `--project <directory>`，支持交互选择会话、项目或直接按项目目录筛选。
+- 项目仓库地址与路径立即转换为本机加盐的匿名身份，不写入 HTML、历史或微信导入文件。
+- HTML“更多小票功能”扩展为 15 条命令，并按时间范围、会话与项目、自动模式、票仔扩展四个可访问 Tab 展示。
+- 命令 Tab 记忆选择状态，支持键盘切换、桌面双列和移动端横向导航，继续排除在长图导出之外。
+- 修复自动模式合并相邻 Stop 触发时丢失原始触发时间、可能导致跨午夜小票写入错误日期的问题。
+
 ## 0.9.0
 
 - 新增缓存命中率、每轮 Token / 输出 Token / 工具调用 / 完成耗时等效率指标。

package/README.en.md

@@ -36,7 +36,7 @@ The cwr2 protocol creates stable privacy-safe facts for each session and calenda
 
 ## Quickstart
 
-Requires Node.js 20+ and local Codex session records. No clone is required. The first interactive run asks whether to save automatically or use manual-only mode. Manual mode then offers today, the last 3 hours, the last 7 days, this week, or a specific session:
+Requires Node.js 20+ and local Codex session records. No clone is required. The first interactive run asks whether to save automatically or use manual-only mode. Manual mode can generate by time range, a selected session, or a selected project:
 
 ```bash
 npx codex-work-receipt@latest --lang en
@@ -54,9 +54,19 @@ 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.
+“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, a specific session, or custom whole calendar dates 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. 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).
+Interactively choose a session, project, or custom range:
+
+```bash
+npx codex-work-receipt@latest --select-session --lang en
+npx codex-work-receipt@latest --select-project --lang en
+npx codex-work-receipt@latest --custom-range --lang en
+```
+
+Advanced use can pass `--project <directory>`, `--from <start>`, and `--to <end>` directly. Whole calendar-date ranges produce cwr2 canonical facts; exact date-time ranges are private cwr1 summaries.
+
+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. “More receipt features” provides 15 copyable commands organized into tabs for time ranges, sessions and projects, automation, and Ticket Buddy extensions. 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

@@ -36,7 +36,7 @@ cwr2 协议按“会话 × 自然日”生成稳定的脱敏事实。今日、
 
 ## Quickstart
 
-需要 Node.js 20 或更高版本，并且本机已经使用过 Codex。无需克隆仓库。首次交互式运行会先让你选择“自动保存”或“仅手动”；选择手动后，再选择“今天 / 最近 3 小时 / 近 7 日 / 本周 / 指定会话”：
+需要 Node.js 20 或更高版本，并且本机已经使用过 Codex。无需克隆仓库。首次交互式运行会先让你选择“自动保存”或“仅手动”；选择手动后，可以按时间、指定会话或指定项目生成小票：
 
 ```bash
 npx codex-work-receipt@latest
@@ -54,9 +54,19 @@ npx codex-work-receipt@latest --today
 npx codex-work-receipt@latest --hours 3
 ```
 
-“最近 N 小时”是滚动摘要，只用于查看和保存私人历史，不参与 AI 供销社的去重统计。需要进入供销社时，请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。
+“最近 N 小时”是滚动摘要，只用于查看和保存私人历史，不参与 AI 供销社的去重统计。需要进入供销社时，请生成“今日 / 本周 / 近 7 日 / 指定会话 / 自定义完整自然日”小票。
 
-网页、结构数据和微信导入文件默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键下载 `.cwr.json`，也可以保存只包含完整小票和微信小程序码的高清长图。赞助商下方的“更多小票功能”还提供 12 条常用命令及复制按钮，帮助用户发现不同统计范围、自动模式、Skill 和票仔。数据二维码和网页功能区不会进入图片。详见 [CLI 使用文档](docs/cli.md)。
+交互选择会话、项目或自定义区间：
+
+```bash
+npx codex-work-receipt@latest --select-session
+npx codex-work-receipt@latest --select-project
+npx codex-work-receipt@latest --custom-range
+```
+
+也可以使用 `--project <目录>`、`--from <开始>` 和 `--to <结束>` 直接指定。完整自然日区间生成 cwr2 规范事实；精确到时分的区间属于私人 cwr1 摘要。
+
+网页、结构数据和微信导入文件默认保存在 `./codex-work-receipt-output/`。生成的网页支持一键下载 `.cwr.json`，也可以保存只包含完整小票和微信小程序码的高清长图。赞助商下方的“更多小票功能”提供 15 条可复制命令，并按“时间范围 / 会话与项目 / 自动模式 / 票仔扩展”分 Tab 展示。数据二维码和网页功能区不会进入图片。详见 [CLI 使用文档](docs/cli.md)。
 
 ## 自动保存或仅手动
 

package/docs/cli.en.md

@@ -22,7 +22,7 @@ The first interactive run asks you to choose:
 - `Automatic saving`: quietly refresh today's receipt and `.cwr.json` WeChat import file whenever a Codex turn stops
 - `Manual only`: generate only when you run the command or ask Ticket Buddy
 
-After choosing manual-only mode, choose all activity today, the last 3 hours, the last 7 calendar days, this week, or a specific recent session. Session choices include their time range, turns, tool calls, and model for identification. Explicit range flags such as `--today` and `--latest` never trigger mode setup.
+After choosing manual-only mode, choose today, the last 3 hours, the last 7 calendar days, this week, a custom range, a recent session, or a recent project. Session choices show their time range, turns, tool calls, and model; project choices show a local project name, latest activity, and session count. Explicit range flags such as `--today` and `--latest` never trigger mode setup.
 
 ## Automatic saving
 
@@ -89,6 +89,38 @@ Monday through now:
 npx codex-work-receipt@latest --range this-week --lang en
 ```
 
+## Custom ranges, sessions, and projects
+
+Interactively choose whole calendar dates or an exact date-time range:
+
+```bash
+npx codex-work-receipt@latest --custom-range --lang en
+```
+
+You can also pass boundaries directly. A date-only end is inclusive; exact date-time input uses the half-open interval `[start, end)`:
+
+```bash
+npx codex-work-receipt@latest --from 2026-07-01 --to 2026-07-15 --lang en
+npx codex-work-receipt@latest --from 2026-07-23T09:00 --to 2026-07-23T18:30 --lang en
+```
+
+Whole calendar dates produce cwr2 canonical facts and can participate in cooperative deduplication. Exact time ranges can cut through a calendar day, so they produce compatible private cwr1 summaries instead.
+
+Interactively choose a recent session or project:
+
+```bash
+npx codex-work-receipt@latest --select-session --lang en
+npx codex-work-receipt@latest --select-project --lang en
+```
+
+After selecting a project, choose today, the last 3 hours, the last 7 days, this week, or a custom range. Advanced use can pass a local directory and combine it with any range:
+
+```bash
+npx codex-work-receipt@latest --project ./my-project --today --lang en
+```
+
+Project names appear only in the terminal selector. Repository URLs and paths are immediately replaced with a locally salted anonymous identity and never enter HTML, history, or WeChat import files.
+
 ## Language and themes
 
 Generate a Chinese receipt:
@@ -148,11 +180,17 @@ npx codex-work-receipt@latest --latest --lang en --no-open
 
 | Option | Description |
 | --- | --- |
-| `--range <name>` | `latest`, `last-hours`, `today`, `last-7-days`, or `this-week` |
+| `--range <name>` | `latest`, `last-hours`, `custom-range`, `today`, `last-7-days`, or `this-week` |
 | `--hours <number>` | Summarize the last 1-168 hours |
+| `--custom-range` | Interactively choose custom calendar dates or an exact time range |
+| `--from <value>` | Set the custom start date or date-time |
+| `--to <value>` | Set the custom end date or date-time |
 | `--latest` | Summarize the latest active Codex session; default mode |
 | `--today` | Summarize activity from today in the selected timezone |
 | `--session <id>` | Summarize one specific Codex session |
+| `--select-session` | Interactively choose a recent Codex session |
+| `--project <directory>` | Limit the receipt to one local project directory |
+| `--select-project` | Interactively choose a recent project and range |
 | `--timezone <name>` | Set an IANA timezone such as `Asia/Shanghai` |
 | `--lang <name>` | `zh-CN` (default) or `en` |
 | `--theme <name>` | `classic`, `diner`, or `payroll` |

package/docs/cli.md

@@ -22,7 +22,7 @@ npx codex-work-receipt@latest
 - `自动保存`：Codex 每完成一轮工作，就静默刷新今天的小票和 `.cwr.json` 微信导入文件
 - `仅手动`：只有执行命令或告诉票仔时才生成
 
-选择仅手动后，命令行会继续让你选择今天全部活动、最近 3 小时、最近 7 个自然日、本周，或最近的某个具体会话。选择具体会话时会展示起止时间、轮次、工具调用和模型，帮助辨认。显式使用 `--today`、`--latest` 等范围参数时不会触发模式问答。
+选择仅手动后，命令行会继续让你选择今天、最近 3 小时、最近 7 个自然日、本周、自定义区间、具体会话或具体项目。选择会话时会展示起止时间、轮次、工具调用和模型；选择项目时会展示本地项目名、最近活动和会话数量。显式使用 `--today`、`--latest` 等范围参数时不会触发模式问答。
 
 ## 自动保存
 
@@ -89,6 +89,38 @@ npx codex-work-receipt@latest --range last-7-days
 npx codex-work-receipt@latest --range this-week
 ```
 
+## 自定义区间、会话与项目
+
+交互选择自定义自然日或精确时间区间：
+
+```bash
+npx codex-work-receipt@latest --custom-range
+```
+
+也可以直接传入边界。日期格式的结束日包含在统计中；时间格式使用半开区间 `[开始, 结束)`：
+
+```bash
+npx codex-work-receipt@latest --from 2026-07-01 --to 2026-07-15
+npx codex-work-receipt@latest --from 2026-07-23T09:00 --to 2026-07-23T18:30
+```
+
+完整自然日范围生成 cwr2 规范事实，可以参与供销社去重统计。精确到时分的范围可能截断自然日，因此生成兼容的私人 cwr1 摘要，不参与供销社统计。
+
+交互选择最近会话或项目：
+
+```bash
+npx codex-work-receipt@latest --select-session
+npx codex-work-receipt@latest --select-project
+```
+
+项目选择后可以继续选择今日、最近 3 小时、最近 7 日、本周或自定义区间。高级用法可以通过本地目录直接指定项目，并与任意范围组合：
+
+```bash
+npx codex-work-receipt@latest --project ./my-project --today
+```
+
+项目名称只用于终端选择；仓库地址或路径会立即转换为本机加盐的匿名项目身份，不会写入 HTML、历史记录或微信导入文件。
+
 ## 语言与主题
 
 生成英文小票：
@@ -148,11 +180,17 @@ npx codex-work-receipt@latest --latest --no-open
 
 | 参数 | 说明 |
 | --- | --- |
-| `--range <name>` | `latest`、`last-hours`、`today`、`last-7-days` 或 `this-week` |
+| `--range <name>` | `latest`、`last-hours`、`custom-range`、`today`、`last-7-days` 或 `this-week` |
 | `--hours <number>` | 统计最近 1～168 小时；等价于 `last-hours` 范围 |
+| `--custom-range` | 交互选择自定义日期或精确时间区间 |
+| `--from <value>` | 自定义开始日期或时间 |
+| `--to <value>` | 自定义结束日期或时间 |
 | `--latest` | 统计最近活跃的 Codex 会话，默认模式 |
 | `--today` | 汇总指定时区今天发生的 Codex 活动 |
 | `--session <id>` | 统计指定的 Codex 会话 |
+| `--select-session` | 交互选择最近的 Codex 会话 |
+| `--project <directory>` | 只统计指定的本地项目目录 |
+| `--select-project` | 交互选择最近项目及统计范围 |
 | `--timezone <name>` | 指定 IANA 时区，例如 `Asia/Shanghai` |
 | `--lang <name>` | `zh-CN`（默认）或 `en` |
 | `--theme <name>` | `classic`、`diner` 或 `payroll` |

package/docs/codex-skill.en.md

@@ -38,7 +38,7 @@ After installation, ask Codex:
 
 > Create a Chinese receipt for my latest session.
 
-Codex will choose a specific session, the last 1-168 hours, today, the last seven days, or this week, plus the language and theme, then run the CLI and open the generated page. “The last few hours” defaults to three hours.
+Codex will choose a specific session, the current or selected project, a custom date/time range, the last 1-168 hours, today, the last seven days, or this week, plus the language and theme, then run the CLI and open the generated page. “The last few hours” defaults to three hours.
 
 If another Codex task is still running and you want the receipt immediately, start a separate local Codex chat. A message sent to the active chat may steer the current run or wait in its queue, depending on Follow-up behavior.
 

package/docs/codex-skill.md

@@ -38,7 +38,7 @@ Skill 会安装到：
 
 > 用英文生成刚刚这次工作的 AI 打工小票。
 
-Codex 会根据表达选择单次会话、最近 1～168 小时、今天、近七日或本周，以及语言和主题，然后执行命令并打开生成的网页。“最近几个小时”默认统计最近 3 小时。
+Codex 会根据表达选择单次会话、当前或指定项目、自定义日期/时间、最近 1～168 小时、今天、近七日或本周，以及语言和主题，然后执行命令并打开生成的网页。“最近几个小时”默认统计最近 3 小时。
 
 “最近 N 小时”生成的是只用于私人历史的滚动摘要，不进入 AI 供销社；如果用户明确希望参与供销社统计，应改用今日、本周、近七日或指定会话范围。
 

package/docs/data-schema.en.md

@@ -2,7 +2,7 @@
 
 <p><a href="./data-schema.md">中文</a> · <strong>English</strong> · <a href="../README.en.md">Back to README</a></p>
 
-The full receipt schema is currently version `2`; rolling-hour summaries remain on compatible version `1`. Each run saves both the full local record and a privacy-safe WeChat import file.
+The full receipt schema is currently version `2`; rolling-hour and custom exact-time summaries remain on compatible version `1`. Custom whole-calendar-date ranges use version `2`. Each run saves both the full local record and a privacy-safe WeChat import file.
 
 ## Main fields
 
@@ -10,7 +10,7 @@ The full receipt schema is currently version `2`; rolling-hour summaries remain
 - `locale`: desktop receipt language, `zh-CN` or `en`
 - `id`: anonymous ID derived from the metrics snapshot
 - `generated_at`: generation time
-- `source`: data source, selected `scope`, and collector version
+- `source`: data source, selected `scope`, `range_kind`, optional `filter_kind`, and collector version
 - `period`: actual activity times, timezone, and `range_start_date` / `range_end_date` calendar boundaries
 - `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
@@ -73,7 +73,7 @@ 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; it stays in private history and does not participate in AI Work Cooperative accounting. The updated mini program can still import older QR codes.
+Compact field `o` explicitly carries `latest`, `session`, `last-hours`, `custom-range`, `today`, `last-7-days`, or `this-week`. `d[0]` / `d[1]` carry exact boundaries and `d[3]` / `d[4]` carry calendar-date boundaries. Today, last-seven-days, this-week, and custom whole-calendar-date receipts use cwr2 canonical facts. `last-hours` and custom exact-time ranges may cut through a calendar day, so they use compatible cwr1 summaries to avoid colliding with session-day fact identities; they stay in private history and do not participate in AI Work Cooperative accounting. Project filtering keeps the selected time scope and transfers only filtered anonymous facts, never the project name, repository URL, or path. 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.
 

package/docs/data-schema.md

@@ -2,7 +2,7 @@
 
 <p><strong>中文</strong> · <a href="./data-schema.en.md">English</a> · <a href="../README.md">返回 README</a></p>
 
-当前完整记录结构版本为 `2`；滚动小时摘要为了兼容继续使用版本 `1`。每次生成都会在本机保存完整结构记录和一份脱敏微信导入文件。
+当前完整记录结构版本为 `2`；滚动小时和自定义精确时间摘要为了兼容继续使用版本 `1`。自定义完整自然日范围使用版本 `2`。每次生成都会在本机保存完整结构记录和一份脱敏微信导入文件。
 
 ## 主要字段
 
@@ -10,7 +10,7 @@
 - `locale`：桌面小票语言，支持 `zh-CN` 和 `en`
 - `id`：根据统计快照生成的匿名 ID
 - `generated_at`：生成时间
-- `source`：数据来源、`scope` 统计范围和采集器版本
+- `source`：数据来源、`scope` 统计范围、`range_kind` 区间精度、可选的 `filter_kind` 和采集器版本
 - `period`：实际活动起止时间、时区，以及 `range_start_date` / `range_end_date` 自然日边界
 - `stats`：轮次、消息、工具、Token、时长，以及本地详细效率洞察
 - `presentation`：默认主题、语言无关的 `work_profile`、本地化工种、点评和 AI 工分
@@ -73,7 +73,7 @@ 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 摘要载荷，只进入私人历史、不参与 AI 供销社统计。旧二维码仍可由新版小程序导入。
+精简字段 `o` 显式携带 `latest`、`session`、`last-hours`、`custom-range`、`today`、`last-7-days` 或 `this-week`；`d[0]` / `d[1]` 携带精确边界，`d[3]` / `d[4]` 携带自然日边界。今日、近 7 日、本周和自定义完整自然日范围使用 cwr2 canonical facts。`last-hours` 与自定义精确时间区间可能截断自然日，为避免与“会话 × 自然日”事实发生身份冲突，使用兼容的 cwr1 摘要载荷，只进入私人历史、不参与 AI 供销社统计。项目筛选沿用所选时间范围，只传输筛选后的匿名事实，不传输项目名称、仓库地址或路径。旧二维码仍可由新版小程序导入。
 
 同一 Codex 会话出现多份 append-only 日志修订时，生成器只采用更完整的修订；cwr2 manifest 中的 factId 必须唯一，检测到身份冲突时不会输出可扫码二维码。
 

package/docs/privacy.en.md

@@ -9,9 +9,12 @@ AI Work Receipt reads Codex sessions, computes metrics, and renders receipts loc
 - `~/.codex/sessions/**/*.jsonl` by default
 - 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
+- A session repository URL or working directory only when the user selects or specifies a project for local grouping
 
 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.
 
+Project filtering groups Git sessions by repository identity and non-Git sessions by working directory. The raw repository URL or path is immediately transformed with a random key that exists only on this computer. A project name appears only in the interactive terminal selector; HTML, full records, history, and WeChat import files do not store the original project name, repository URL, or path.
+
 ## What receipts exclude
 
 - Prompts and response text
@@ -23,6 +26,8 @@ Session logs are parsed locally in bounded chunks, one JSONL row at a time. Raw
 
 Generated HTML, full JSON, and privacy-safe `.cwr.json` WeChat import files are written to `codex-work-receipt-output/` by default. Deduplicated history is stored under `~/.codex-work-receipt/`. Use `--output` and `--data-dir` to change these locations.
 
+The first project-filtered run creates a permission-restricted `project-identity.key` in the local data directory. It is used only to create project identities that cannot be correlated across installations.
+
 The runtime does not upload Codex session data to a project server. The initial or updated package download performed by `npx` is a normal package-manager network request and does not contain local session data.
 
 If the user actively sends a `.cwr.json` file to a WeChat chat, that file passes through WeChat's file-transfer system. The user can then select it in the companion mini program, preview it, and save it to the anonymous account database for history recovery and canonical deduplication. The file excludes prompts, response text, source code, project paths, file names, and original session IDs. Joining AI Cooperative aggregate statistics remains a separate user choice.

package/docs/privacy.md

@@ -9,9 +9,12 @@ AI 打工小票在本机读取 Codex 会话，并在本机完成统计和渲染
 - 默认读取 `~/.codex/sessions/**/*.jsonl`
 - 提取事件类型、时间、模型名称、脱敏工具类别和数字统计
 - 计算轮次、工具调用、Token、时长、中断次数、缓存命中率、延迟分位与小时分布等指标
+- 仅在用户选择或指定项目时读取会话的仓库地址或工作目录，用于本地归组
 
 会话日志会在本机分块逐行解析。每行解析后只保留统计所需字段；工具名会立即映射为稳定类别。Prompt、回复、图片、原始工具名、工具参数、命令和工具输出不会保留在内存统计对象中。
 
+项目筛选优先按 Git 仓库身份归组，非 Git 项目按工作目录归组。原始仓库地址或路径会立即通过只存在于本机的随机密钥转换为匿名项目身份；项目名称仅出现在交互式终端列表中。HTML、完整记录、历史和微信导入文件均不保存原始项目名称、仓库地址或路径。
+
 ## 不会写入小票什么
 
 - Prompt 和回复正文
@@ -23,6 +26,8 @@ AI 打工小票在本机读取 Codex 会话，并在本机完成统计和渲染
 
 生成的 HTML、完整 JSON 和脱敏 `.cwr.json` 微信导入文件默认位于当前目录的 `codex-work-receipt-output/`，去重历史保存在 `~/.codex-work-receipt/`。可以使用 `--output` 和 `--data-dir` 修改位置。
 
+首次使用项目筛选时会在本地数据目录创建权限受限的 `project-identity.key`，只用于生成不可跨设备关联的项目匿名身份。
+
 运行期间不会把 Codex 会话数据上传到本项目的服务器。通过 `npx` 首次下载或更新 npm 包属于包管理器的正常网络请求，不包含本地会话内容。
 
 如果用户主动把 `.cwr.json` 发送到微信聊天，文件会经过微信的文件传输体系。随后用户可在配套小程序中选择该聊天文件、确认内容并保存到匿名账号数据库，用于历史恢复和规范去重。文件不会包含 Prompt、回复正文、代码、项目路径、文件名或原始会话 ID；是否参与 AI 供销社匿名统计仍由用户单独决定。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-work-receipt",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "type": "module",
   "description": "Generate a privacy-first Codex work receipt from local session metadata.",
   "author": "a-bai-2026",
@@ -27,7 +27,7 @@
   "scripts": {
     "receipt": "node src/cli.mjs",
     "test": "node --test",
-    "check": "node --check src/cli.mjs && node --check src/auto-hook.mjs && node --check src/auto-runner.mjs && node --check src/core/auto-mode.mjs && node --check src/core/generator.mjs && node --check src/core/mode-selector.mjs && node --check src/lib/files.mjs && node --check src/core/skill-installer.mjs && node --check src/core/pet-installer.mjs && node --check src/core/range.mjs",
+    "check": "node --check src/cli.mjs && node --check src/auto-hook.mjs && node --check src/auto-runner.mjs && node --check src/core/auto-mode.mjs && node --check src/core/generator.mjs && node --check src/core/mode-selector.mjs && node --check src/core/project-identity.mjs && node --check src/core/selector.mjs && node --check src/renderers/html.mjs && node --check src/parsers/codex.mjs && node --check src/lib/files.mjs && node --check src/core/skill-installer.mjs && node --check src/core/pet-installer.mjs && node --check src/core/range.mjs",
     "prepublishOnly": "npm test && npm run check"
   },
   "files": [

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

@@ -1,6 +1,6 @@
 ---
 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 or 票仔 to create, regenerate, open, or locate an “AI 打工小票”, “工票”, or “AI work receipt” for the latest session, the last few hours, today, the last seven days, or this week, in Chinese or English. Do not use for real invoices, salary calculations, API billing, or non-Codex activity.
+description: Generate and open a privacy-first local AI work receipt from Codex session metadata. Use when the user asks Codex or 票仔 to create, regenerate, open, or locate an “AI 打工小票”, “工票”, or “AI work receipt” for a session, project, custom range, recent hours, today, the last seven days, or this week, in Chinese or English. Do not use for real invoices, salary calculations, API billing, or non-Codex activity.
 ---
 
 # AI 打工小票
@@ -13,17 +13,22 @@ 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.
+- 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, a specific session, or custom whole calendar dates 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.
+- Use `--from YYYY-MM-DD --to YYYY-MM-DD` when the user gives whole start and end dates. The end date is inclusive and the receipt can produce cwr2 canonical facts.
+- Use `--from YYYY-MM-DDTHH:mm --to YYYY-MM-DDTHH:mm` when the user gives exact local times. Explain that the result is a private cwr1 summary and does not participate in cooperative accounting.
+- Use `--custom-range` when the user explicitly wants to enter a custom range interactively.
+- Use `--select-session` when the user wants to choose a recent session interactively. Use `--session <id>` only when an exact session ID is already available from the user or CLI output.
+- Add `--project .` when the user asks for the current project. Use `--select-project` when the user wants to choose among recent projects interactively. Combine a project filter with the requested time range.
 - 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 to choose interactively, run the CLI without a range flag so it can show the local selector.
+- If the user asks to choose a range interactively without specifying session or project selection, run the CLI without a range flag so it can show the complete local selector.
 - If the user asks for an unsupported custom date range, explain the available ranges and do not invent flags.
 - Treat requests addressed to “票仔” the same as direct AI work receipt requests, for example “票仔，开今天的票”.
 
@@ -36,11 +41,11 @@ Use the published `codex-work-receipt` CLI as the only statistics and rendering
 npx --yes codex-work-receipt@latest --latest --lang zh-CN --theme classic
 ```
 
-Replace only the mode and optional flags according to the request.
+Replace only the mode, optional project filter, and presentation flags according to the request.
 
 3. Let the CLI open the generated HTML unless the user requested `--no-open`.
 4. On success, report both the HTML path and the `.cwr.json` WeChat import file path. Tell the user to send the import file to WeChat File Transfer, open the official mini program, and choose “Import from chat file”. If the CLI reports that a single data QR is available, mention scanning as an optional shortcut; never instruct the user to scan multipart codes.
-5. When `--hours` was used, explicitly state that the receipt is a private rolling summary and will not enter AI Work Cooperative statistics.
+5. When `--hours` or an exact date-time custom range was used, explicitly state that the receipt is a private summary and will not enter AI Work Cooperative statistics.
 
 ## Privacy and failures
 

package/src/auto-runner.mjs

@@ -42,7 +42,7 @@ function crossesConfiguredDay(workReceiptHome, left, right) {
   return dateKey(left, timezone) !== dateKey(right, timezone);
 }
 
-function acquireLock(lockPath, pendingPath) {
+function acquireLock(lockPath, pendingPath, pendingAt = new Date()) {
   fs.mkdirSync(path.dirname(lockPath), { recursive: true });
   try {
     const descriptor = fs.openSync(lockPath, "wx");
@@ -55,12 +55,12 @@ function acquireLock(lockPath, pendingPath) {
       const age = Date.now() - fs.statSync(lockPath).mtimeMs;
       if (age > LOCK_STALE_MS) {
         fs.rmSync(lockPath, { force: true });
-        return acquireLock(lockPath, pendingPath);
+        return acquireLock(lockPath, pendingPath, pendingAt);
       }
     } catch {
       // Another worker may have released the lock between checks.
     }
-    fs.writeFileSync(pendingPath, `${new Date().toISOString()}\n`, "utf8");
+    fs.writeFileSync(pendingPath, `${pendingAt.toISOString()}\n`, "utf8");
     return false;
   }
 }
@@ -124,7 +124,7 @@ async function generateOnce({ workReceiptHome, now = new Date() }) {
 export async function runAutomaticReceipt({ workReceiptHome, now = new Date(), retryAfterCoalesce = true }) {
   const lockPath = path.join(workReceiptHome, "auto.lock");
   const pendingPath = path.join(workReceiptHome, "auto.pending");
-  if (!acquireLock(lockPath, pendingPath)) {
+  if (!acquireLock(lockPath, pendingPath, now)) {
     if (!retryAfterCoalesce) return { status: "coalesced" };
     await delay(800);
     if (fs.existsSync(lockPath)) return { status: "coalesced" };

package/src/cli.mjs

@@ -18,13 +18,19 @@ import {
 import { generateReceipt } from "./core/generator.mjs";
 import { promptForGenerationMode } from "./core/mode-selector.mjs";
 import { printOpenSourcePrompt } from "./core/open-source.mjs";
-import { getRollingSummaryNotice, getScopeLabel } from "./core/presentation.mjs";
+import { getCustomSummaryNotice, getRollingSummaryNotice, getScopeLabel } from "./core/presentation.mjs";
+import { getProjectIdentitySecret, projectDescriptorFromPath } from "./core/project-identity.mjs";
 import { encodeSingleReceiptQr } from "./core/qr-payload.mjs";
-import { promptForRange } from "./core/selector.mjs";
+import {
+  promptForCustomRange,
+  promptForProjectRange,
+  promptForRange,
+  promptForSpecificSession,
+} from "./core/selector.mjs";
 import { installCodexSkill } from "./core/skill-installer.mjs";
 import { installCodexPet, uninstallCodexPet } from "./core/pet-installer.mjs";
 import { formatNumber } from "./lib/time.mjs";
-import { listRecentCodexSessions } from "./parsers/codex.mjs";
+import { listRecentCodexProjects, listRecentCodexSessions } from "./parsers/codex.mjs";
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PROJECT_DIR = path.dirname(SCRIPT_DIR);
@@ -185,6 +191,49 @@ async function main() {
     return;
   }
 
+  if ((options.selectSession || options.selectProject || (options.mode === "custom-range" && !options.from)) && !isInteractive()) {
+    throw new Error("交互选择命令需要在终端中运行；也可以使用 --session、--project、--from 和 --to");
+  }
+
+  let projectSecret = null;
+  const ensureProjectSecret = () => {
+    projectSecret ||= getProjectIdentitySecret({ dataDir: options.dataDir });
+    return projectSecret;
+  };
+  const loadRecentProjects = () => listRecentCodexProjects(10, {
+    projectSecret: ensureProjectSecret(),
+  });
+
+  if (options.project) {
+    options.projectId = projectDescriptorFromPath(options.project, ensureProjectSecret()).projectId;
+  }
+  if (options.selectSession) {
+    const selected = await promptForSpecificSession({
+      locale: options.locale,
+      timezone: options.timezone,
+      loadRecentSessions: () => listRecentCodexSessions(10),
+    });
+    options.mode = selected.mode;
+    options.sessionId = selected.sessionId;
+    options.modeExplicit = true;
+  } else if (options.selectProject) {
+    const selected = await promptForProjectRange({
+      locale: options.locale,
+      timezone: options.timezone,
+      loadRecentProjects,
+    });
+    options.mode = selected.mode;
+    options.projectId = selected.projectId;
+    options.hours = selected.hours || options.hours;
+    options.from = selected.from || options.from;
+    options.to = selected.to || options.to;
+    options.modeExplicit = true;
+  } else if (options.mode === "custom-range" && !options.from) {
+    const selected = await promptForCustomRange({ locale: options.locale, timezone: options.timezone });
+    options.from = selected.from;
+    options.to = selected.to;
+  }
+
   if (!options.modeExplicit && isInteractive()) {
     const workReceiptHome = getWorkReceiptHome({ dataDir: options.dataDir });
     if (!readAutoConfig({ workReceiptHome })) {
@@ -199,10 +248,14 @@ async function main() {
       locale: options.locale,
       timezone: options.timezone,
       loadRecentSessions: () => listRecentCodexSessions(10),
+      loadRecentProjects,
     });
     options.mode = selected.mode;
     options.sessionId = selected.sessionId;
     options.hours = selected.hours || options.hours;
+    options.projectId = selected.projectId || options.projectId;
+    options.from = selected.from || options.from;
+    options.to = selected.to || options.to;
   }
 
   const generated = await generateReceipt(options, {
@@ -235,7 +288,7 @@ async function main() {
     console.log(`Structured data: ${persisted.companionPath}`);
     console.log(`WeChat import file: ${persisted.transferPath}`);
     console.log(`Local history: ${persisted.receiptPath}`);
-    console.log(`Range: ${getScopeLabel(record.source.scope, options.locale, record.source.hours)} · ${record.stats.session_count} session(s)`);
+    console.log(`Range: ${getScopeLabel(record.source.scope, options.locale, record.source.hours, { rangeKind: record.source.range_kind, filterKind: record.source.filter_kind })} · ${record.stats.session_count} session(s)`);
     console.log(`Stats: ${record.stats.completed_turns} turns · ${formatNumber(record.stats.tokens.total_tokens, options.locale)} Tokens · ${record.stats.tool_calls} tool calls`);
     console.log(dataQrDataUrl
       ? `Data QR: available as one code · QR version ${dataQrVersion}`
@@ -246,13 +299,16 @@ async function main() {
     if (record.source.scope === "last-hours") {
       console.log(`Note: ${getRollingSummaryNotice(options.locale, record.source.hours)}`);
     }
+    if (record.source.scope === "custom-range" && record.source.range_kind === "exact-time") {
+      console.log(`Note: ${getCustomSummaryNotice(options.locale)}`);
+    }
     if (!miniProgramCodeDataUrl) console.log("Mini-program code: not configured; using the explicit placeholder");
   } else {
     console.log(`已生成网页：${outputFile}`);
     console.log(`结构数据：${persisted.companionPath}`);
     console.log(`微信导入文件：${persisted.transferPath}`);
     console.log(`本地历史：${persisted.receiptPath}`);
-    console.log(`统计范围：${getScopeLabel(record.source.scope, options.locale, record.source.hours)} · ${record.stats.session_count} 个会话`);
+    console.log(`统计范围：${getScopeLabel(record.source.scope, options.locale, record.source.hours, { rangeKind: record.source.range_kind, filterKind: record.source.filter_kind })} · ${record.stats.session_count} 个会话`);
     console.log(`统计：${record.stats.completed_turns} 轮 · ${formatNumber(record.stats.tokens.total_tokens, options.locale)} Token · ${record.stats.tool_calls} 次工具调用`);
     console.log(dataQrDataUrl
       ? `数据二维码：可用 · 单码 · QR version ${dataQrVersion}`
@@ -263,6 +319,9 @@ async function main() {
     if (record.source.scope === "last-hours") {
       console.log(`提示：${getRollingSummaryNotice(options.locale, record.source.hours)}`);
     }
+    if (record.source.scope === "custom-range" && record.source.range_kind === "exact-time") {
+      console.log(`提示：${getCustomSummaryNotice(options.locale)}`);
+    }
     if (!miniProgramCodeDataUrl) console.log("小程序码：尚未配置，页面使用明确占位符");
   }
   printOpenSourcePrompt("receipt", options.locale);