Skip to content

技能使用情况概览 ​

统计技能在哪些会话、被哪句话触发、用了多少次;默认关闭,数据只留在本机。

用途与场景 ​

  • 回答「某个技能用了多少次」「哪些技能从未使用」「某次需求由哪句话触发」。
  • 用真实调用记录做技能治理,不依赖人工回忆或模型自述。
  • 记录归 @fxri/toolkit 管理,可与任务区、技能分发共用一套工具链。

默认值 ​

项目默认
总开关关闭
采集通道hook(rule 为全局规则上报)
Agent 采集全部关闭
技能来源一方 / 第三方 / 未托管全部关闭
技能范围none
触发词 / 参数 / 结果全部不采集
网络与上传不联网、不上传
存储位置~/.toolkit/usage
轮转与保留按月轮转、保留 180 天

未开启时,Hook 即使被调用也直接退出,不写文件。本表是配置缺省值;首次执行 toolkit usage setup init 会显式启用(默认范围见「快速开始」)。

快速开始 ​

bash
toolkit usage show                     # 查看当前开关与数据目录
toolkit config set usage.enabled true  # 打开总开关(关闭用 false)
toolkit usage config origins --first-party
toolkit usage config scope --mode all
toolkit usage show stats               # 查看统计

首次使用建议直接跑 toolkit usage setup init:向导已默认启用,一路回车即按「一方 + 第三方技能、数据只留本机、规则通道、不采集明细字段」完成配置;需要收窄来源或打开触发词与参数时,再逐项调整。

命令总览 ​

命令用途
show开关、通道、配置路径、数据目录、Hook 与上传汇总(默认命令)
show stats统计与查询(--by skill|session|trigger)
setup init / setup uninstall初始化 / 停用并卸载 Hook(默认保留数据)
config channel采集通道:rule(全局规则上报)/ hook(Agent Hook)
record规则通道批量上报一批技能调用(入队即返回,按次计数,失败不阻断任务)
config set usage.enabled true|false打开 / 关闭总开关
config origins一方 / 第三方 / 未托管来源开关
config scopenone / all / include / exclude 技能范围
config capture触发词 / 参数 / 结果字段开关
config storage数据目录、轮转、保留期、单文件上限
data export / data import导出与导入事件
data dedupe / data purge / data rebuild去重、清理与索引重建
data doctor目录、索引与重复事件诊断
config upload setup / status / send(--dry-run)可选上传:默认关闭,需显式配置端点

全局规则文案由 toolkit rule compose --module usage 输出(原 usage rule 已移除)。

完整参数见 CLI 参考 · 技能使用情况,配置字段见 使用情况配置,数据边界见 隐私与数据边界, 事件结构见 事件 Schema。

边界与注意 ​

  • 历史会话无法自动补录,统计从启用时刻开始。
  • 没有 Hook 的 Agent 用 usage data import 或 usage log 补录。
  • 上传默认关闭;开启后仍需显式配置端点与认证,详见 隐私与数据边界。
  • 事件 schema 版本为 1,新增字段只增不改,详见 事件 Schema。

MIT 开源协议