核心是结合$subscribe（记录状态变更）和$onaction（监控动作执行），前者捕获“状态变成什么样”，后者记录“谁在什么时候做了什么”，二者分工明确、互为补充，可构建轻量、可追溯、可上报的日志体系。
要监控用户的关键操作并生成状态变更日志，核心是结合 $subscribe（捕获状态变化）和 $onAction（捕获动作执行），二者分工明确、互为补充——前者记录“状态变成什么样”，后者记录“谁在什么时候做了什么”。不依赖 DevTools，也不侵入业务逻辑，就能构建轻量、可追溯、可上报的日志体系。
聚焦关键操作：用 $onAction 拦截高价值行为
$onAction 是监听用户主动触发行为的首选，比如登录、提交表单、切换主题、添加购物车等。它能精确捕获 action 名称、参数、执行结果和耗时：
- 回调中通过 name 字段识别关键 action（如
'login'、'addToCart'） - 用 args 记录输入参数（如手机号、商品 ID），注意脱敏处理敏感字段
- 在 after 钩子里记录成功结果，在 onError 中捕获失败原因
- 搭配时间戳和 store ID，形成完整事件上下文：
{ event: 'login', store: 'user', status: 'success', duration: 320 }
追踪状态影响：用 $subscribe 记录关键字段变更
$subscribe 不适合监听所有字段，但非常适合监控那些“一变就代表用户完成关键动作”的状态项，例如：
Ag Model Usage
下载
一款AI工具，主要用于使用 CodexBar CLI 本地成本使用情况，按模型汇总 Codex 或 Claude 的使用量，包括当前（最新）模型或完整的模型分解，适合需要提升相关任务效率的用户。
-
user.token变更 → 视为登录/登出事件 -
cart.items.length增加 → 视为加购成功 -
form.isSubmitted变为 true → 视为表单提交完成 - 通过比对
mutation.payload或手动快照差分，只上报关心的 key 变化
合并日志、防抖与过滤，避免噪音
真实场景中，一次点击可能触发多个 action 和状态更新。需做聚合处理提升日志质量：
- 跳过
mutation.type === 'devtools'的调试变更 - 忽略内部维护字段（如
loading、error）或临时状态（如form.dirty） - 用
setTimeout合并 300ms 内的连续变更，生成一条聚合日志 - 设置开关（如
import.meta.env.PROD）控制仅在生产环境上报
结构化上报与后续利用
日志内容建议统一格式，便于后端解析与分析：
- 必填字段：
event（语义化事件名）、storeId、timestamp、sessionId（前端生成）、userId（如有） - 可选字段：
duration（action 耗时）、payload（精简后的变更数据）、source（'user' / 'sync' / 'init'） - 上报方式：使用
sendBeacon确保页面卸载前发出；或缓存后批量提交 - 后续用途：行为漏斗分析、异常操作预警、A/B 测试归因、用户路径还原
