@liu_jimmy/fe-kit-cli

CLI：ai stats 查看缓存与 token 统计，ai record 在每次请求后追加一条数据。

安装

pnpm add -D @liu_jimmy/fe-kit-cli
# 或全局
pnpm add -g @liu_jimmy/fe-kit-cli

命令

ai stats

输出示例：

AI Cache Stats
--------------
Requests:    128
Cache hits:  92
Hit rate:    71.8%

Tokens used:  24,300
Tokens saved: 78,200

Cost saved: $0.39

数据来自 ~/.fe-kit/stats.json（可通过环境变量 FE_KIT_STATS_DIR 指定目录）。

ai record

在每次 Cursor / AI 请求完成后执行一次，用于更新统计。

# 一次未命中缓存的请求，消耗了 800 tokens
ai record --request --tokens-used 800

# 一次命中缓存的请求，相当于节省了 1200 tokens
ai record --request --cache-hit --tokens-saved 1200

简写：-r = --request，-c = --cache-hit。

在 Cursor 里接上「请求完成后记录」（推荐方式 B）

• 方式 B（推荐）：用 create-fe-kit 生成的项目已自带规则：AI 会在回复末尾提示你执行一次 ai record ...（命中缓存则带 --cache-hit --tokens-saved <估算>，否则 --tokens-used <估算>），你复制到终端执行即可。

• 手动：也可在需要时自己执行 ai record --request --cache-hit --tokens-saved 1200 或 ai record --request --tokens-used 500。

• 程序内记录：若在脚本里调用 compileWithCache，可同时调用：

  import { recordStats } from "@liu_jimmy/fe-kit-cli";
  const result = compileWithCache(spec, "vue", cache);
  recordStats({
    request: true,
    cacheHit: result.fromCache,
    tokensUsed: result.fromCache ? 0 : 500,
    tokensSaved: result.fromCache ? 500 : 0,
  });

Cost saved 仅作记录参考，按每百万 tokens 粗算；可选环境变量 FE_KIT_COST_PER_MILLION 调整单价。