技能使用情况概览
统计技能在哪些会话、被哪句话触发、用了多少次;默认关闭,数据只留在本机。
用途与场景
- 回答「某个技能用了多少次」「哪些技能从未使用」「某次需求由哪句话触发」。
- 用真实调用记录做技能治理,不依赖人工回忆或模型自述。
- 记录归
@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 scope | none / 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。
