Codex 桌宠不只会卖萌，还能把工作日志变成 AI 打工小票

Codex 桌宠“票仔”不只是桌面装饰，它关联的社区开源项目 `codex-work-receipt` 可以把本机 Codex 工作记录整理成两类可视化小票：打工小票统计会话、轮次、工具调用、Token、时长和延迟；情绪小票用打断、等待与协作节奏生成状态描述。该项目不是 OpenAI 官方功能，安装前仍应审查代码、Hook 和输出内容。

桌宠只是入口，小票才是主体

票仔是 Codex Pets 的可选扩展，负责状态展示和陪伴。生成小票并不要求安装桌宠，CLI 和 Skill 可以独立使用；桌宠本身也不负责解析日志或执行生成命令。

这种分层很合理：视觉组件保持轻量，统计逻辑由可测试的命令行工具完成，Codex Skill 负责把自然语言请求映射成命令。用户可以只用报表，不必让桌面常驻额外界面。

打工小票记录什么

打工小票面向可量化工作记录，包含会话数量、交互轮次、工具调用、Token、协作时长和使用模型。项目还计算缓存命中率、每轮效率、P50 与 P90 延迟、工作时间热力图，以及模型和工具结构。

这些数字更适合回答“今天与 Codex 协作了多少、节奏如何”，不等于产出质量或个人绩效。Token 多可能表示任务复杂，也可能是上下文冗长；工具调用多可能是深入验证，也可能是反复试错。

情绪小票不是对 Prompt 做心理分析

情绪小票使用轮次、消息、打断、响应等待和协作时长等行为指标，给一次人机协作生成状态表达。项目说明它不会读取 Prompt 或回复正文来推测用户情绪。

因此它更像对交互节奏的趣味化可视化，而非心理测量。等待时间长、打断次数多，可能来自网络、复杂任务或用户主动调整，不能直接推导真实情绪。

官方 Codex 与社区小票工具的边界

官方 OpenAI 文档将 Codex用于代码、分析、测试、自动化和长期目标等工作流。小票项目在这些工作流之外读取本地记录并生成二次统计，是社区扩展，不代表 Codex 官方计费、绩效或使用报告。

仓库采用开源许可证，并明确标注为非 OpenAI 官方社区工具。遇到数据口径、兼容性和安装问题，应查看该项目的 README、版本记录与 issue，而不是把它当作 Codex 原生承诺。

快速开始的环境要求

项目要求 Node.js 20 或更高版本，并且本机已经使用过 Codex。首次运行命令后，会选择保存方式与小票类型：自动保存或仅手动，以及 work、emotion 或 both。

npx codex-work-receipt@latest

使用 latest 会在每次解析时取得当时发布版本，方便体验但不利于可复现。团队环境更适合先检查 npm 包与仓库，再固定审核过的具体版本。

手动生成更适合初次试用

初次使用建议选择仅手动，先生成今天的小票，检查输出目录和字段，再决定是否安装自动 Hook。可以只生成打工或情绪小票，也可以同时输出。

npx codex-work-receipt@latest --today --receipt-type both
npx codex-work-receipt@latest --hours 3
npx codex-work-receipt@latest --select-session

手动模式的优势是数据读取与生成时机完全可见。确认结果符合隐私预期后，再启用自动保存。

自动模式如何工作

自动保存使用 Codex 的 Stop Hook。每轮工作结束后，它在本机静默刷新当天的 HTML、完整 JSON 和微信导入文件，不自动打开浏览器，也不常驻运行进程。

安装 Hook 后需要重启 Codex；若 Codex要求审查新 Hook，应通过 Hook 管理界面确认内容与来源。切换回手动模式只移除本项目自己的 Hook，不会删除历史小票或其他 Hook。

Hook 安装必须按代码执行来审查

Hook 会在工作流生命周期中自动执行命令，因此不能因为项目可爱或开源就直接信任。安装前检查 package scripts、写入的 Hook 配置、实际执行命令、版本固定方式和输出路径。

升级项目时重新查看变更。自动模式应只读取必要记录并写入自己的目录，不应获得额外网络、凭据或项目写权限。若组织环境禁止未批准 Hook，应使用手动生成。

Skill 让 Codex 可以自然语言开票

安装项目提供的 Skill 后，可以直接要求 Codex为今天、刚才的会话或指定时间范围生成小票。Skill 的价值是封装参数选择和结果打开，不改变统计逻辑。

Skill 同样是第三方代码与指令，需要查看其 SKILL 文件和调用脚本。确认它只执行预期命令，不上传结果、不访问额外目录，再安装到个人环境。

隐私边界以实际代码和输出为准

项目声明小票不会写入 Prompt、回复正文、代码、项目路径、文件名、工具参数和工具输出，而是使用脱敏的轮次、时长、Token、延迟与工具类别等数据。处理在本机完成。

这是一项项目方声明，使用者应抽查生成的 HTML、JSON 与 `.cwr.json`，并检查源代码实际读取字段。尤其在分享或发送到手机前，先打开结构文件确认没有意外路径、标识符或自定义工具名称。

本地处理不等于零风险

本地工具仍会读取 Codex 记录并在磁盘生成可分享文件。共享目录、云盘同步、浏览器下载和微信传输都会扩大数据边界。输出文件应按工作记录对待，不要默认公开。

团队机器还要考虑日志保留正策、员工隐私和客户项目隔离。若同一设备包含多个敏感项目，优先按会话或项目筛选，并在分享前删除不必要的维度。

输出有哪些形式

网页、结构化数据和微信导入文件默认保存在当前目录的 `codex-work-receipt-output`。自动模式则统一写入用户目录下按日期组织的 auto 文件夹。

网页可以保存打工小票或情绪小票长图，并下载 `.cwr.json`。数据足够小时可额外生成二维码；数据较大时通过微信聊天文件导入，避免把大量内容塞进二维码。

时间范围的语义需要注意

项目支持今日、近七日、本周、最近若干小时、指定会话、项目和自定义区间。“最近 N 小时”是滚动摘要，适合私人查看；自然日和指定会话则可形成稳定的脱敏事实，便于接收端去重。

比较不同小票时要保证范围一致。今天与最近 24 小时不是同一窗口，跨午夜的会话也可能被自然日拆分。不要直接把两个不同范围的 Token 或时长当作趋势。

如何正确理解 AI 工分

AI 工分和今日工种是产品化表达，不是官方评价体系。它们能增加仪式感，帮助用户回顾协作节奏，但不应被用于员工排名、工时结算或模型成本审计。

真正的成本分析还需要模型价格、缓存计费规则、账号方案和请求级；真正的产出评估则需要代码质量、测试、发布结果和业务价值。小票是观察入口，不是最终结论。

为什么这种可视化仍然有价值

长时间与 Agent 协作往往留下代码和对话，却缺少一天结束时的整体视图。把抽象日志压缩成一张票，能让用户发现自己在哪些时间段工作、哪些任务工具密集、等待和打断是否异常。

更重要的是，它把隐私最小化作为设计约束：尽量使用结构指标，不展示正文。即使不使用这个项目，这种思路也适合其他个人工作回顾工具。

安装桌宠的方式与注意点

项目提供同时安装 Skill 和桌宠的命令，也支持只安装 Pet。完成后需要重启 Codex，在 Settings 的 Pets 页面刷新并选择票仔，再用 `/pet` 唤醒。

npx codex-work-receipt@latest --install-companion
npx codex-work-receipt@latest --install-pet

这些命令会修改本地 Codex 扩展配置。执行前应检查当前版本的安装脚本；需要可回滚时先记录被修改文件和现有配置。

建议的安全试用流程

先在测试用户或非敏感项目中运行手动模式，固定包版本并检查生成文件。确认没有正文、路径和工具参数后，再安装 Skill。最后才考虑启用 Stop Hook 与桌宠。

升级时比较 package lock、安装脚本、Skill 和 Hook 变化。停用时检查 Hook 已移除，但保留或删除历史输出由用户自行决定。分享小票前再次检查图片和 JSON。

结论

Codex 票仔的有趣之处不只在桌宠，而在把本机工作记录转化为打工与情绪小票：前者量化轮次、工具、Token、时长与延迟，后者描述协作节奏。它提供手动、自动 Hook、Skill、网页和手机导入等多种使用方式。

但它是社区工具，不是 OpenAI 官方 Codex 功能。最稳妥的使用方式是先手动试用、审查代码与输出、固定版本，再决定是否安装 Hook 和桌宠；小票用于回顾与仪式感，不应被误解为官方或绩效评价。