nav-stats

用途

nav-stats 是 Navigator 插件中的一个会话统计技能，用来把当前会话的效率表现量化并展示出来。它基于基线文档总量与实际加载量做对比，输出令牌节省、缓存性能、上下文占用、效率评分和预计节省时间，让 Navigator 的优化效果可被查看和分享。

主要能力

检查项目是否已初始化 Navigator（依赖 .agent/DEVELOPMENT-README.md）。
运行 scripts/session-stats.sh 输出可解析的指标：BASELINE_TOKENS、LOADED_TOKENS、TOKENS_SAVED、SAVINGS_PERCENT、EFFICIENCY_SCORE、CACHE_EFFICIENCY、CONTEXT_USAGE_PERCENT、TIME_SAVED_MINUTES。
通过 efficiency_scorer.py 按令牌节省（40 分）、缓存效率（30 分）、上下文占用（30 分）计算 0–100 的效率评分。
通过 report_formatter.py 生成 ASCII 可视化报告，包含令牌使用、缓存性能、会话指标、节省时间、含义说明和针对性建议。
当运行时状态文件包含 tier1 段时，追加一行 Tier-1 响应统计（零令牌回答次数与疑似误报数）。
根据评分、上下文占用和缓存效率阈值给出不同建议，例如低节省时检查是否加载过多文档、上下文超过 80% 时建议压缩、缓存效率低于 80% 时检查配置。

使用方式

用户说出“show my stats”“show session stats”“show metrics”“how much did I save”“efficiency report”等意图时触发。技能先确认 Navigator 已初始化，再定位插件目录并运行统计脚本；若脚本缺失会提示重新安装或更新。随后调用评分与格式化脚本生成报告并展示。资料给出的调用示例（保持原样）：

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/cache/navigator-marketplace/navigator}"
[ -d "$PLUGIN_DIR" ] || PLUGIN_DIR="$HOME/.claude/plugins/marketplaces/navigator-marketplace"

bash "$PLUGIN_DIR/scripts/session-stats.sh"

python3 "$PLUGIN_DIR/skills/nav-stats/functions/efficiency_scorer.py" \
  --tokens-saved-percent 92 \
  --cache-efficiency 100 \
  --context-usage 35

python3 "$PLUGIN_DIR/skills/nav-stats/functions/report_formatter.py" \
  --baseline 150000 \
  --loaded 12000 \
  --saved 138000 \
  --savings-percent 92 \
  --cache-efficiency 100 \
  --context-usage 35 \
  --efficiency-score 94 \
  --time-saved 42

适用场景

用户想查看当前会话的令牌节省与整体效率。
用户想确认 Navigator 是否真的带来改善，或需要可截图分享的效率报告。
用户希望根据评分与指标获得上下文管理和缓存配置方面的改进建议。

限制

不适用于刚开始的会话（少于 5 条消息）或 Navigator 尚未初始化的项目。
若用户只问某个具体指标，应直接回答，而非调用此技能。
依赖插件中存在 scripts/session-stats.sh 及两个 Python 函数脚本；缺失时无法生成报告。
Tier-1 遥测行仅在运行时状态文件含对应段且未禁用时出现。
具体安装命令、平台支持范围和收费信息资料暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制