Skill: tryxin/agent-quantizer (version 1.0.2)

--- name: agent-quantizer description: OpenClaw 全栈优化工具包 — Token 统计、上下文压缩、Prompt 精简、僵尸会话清理、心跳检测、Cron 审计、模型分级路由、Skill 分类管理 user-invocable: true version: 2.1.0 --- # Agent Quantizer > 不改模型，不改代码。从调用侧省 Token、省钱、省时间。 跨实例部署的 OpenClaw 运维优化层。通过 Token 治理、上下文压缩、缓存策略和资源审计，让系统在长期运行中始终保持高效、干净、可控。 --- ## 工作原理 ``` 用户请求 → Agent Quantizer 优化层 ├── 缓存命中？→ 直接返回 ├── 上下文过长？→ 智能压缩 ├── Prompt 冗余？→ 自动精简 └── 未命中 → 正常调用，结果回写缓存 ``` --- ## 功能清单 ### 1. Token 统计与扫描 追踪所有会话的 Token 消耗，识别高消耗热点。 ```bash # 查看所有 session 的 token 排行 bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh stats # 扫描超过阈值的 session（默认 100K） bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh scan bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh scan 50000 ``` **输出内容：** 每个 session 的 Input/Output/CacheRead/Total tokens、文件大小、行数、最后修改时间。 ### 2. 上下文压缩 当对话历史逼近上下文窗口上限时，自动压缩以释放空间。 ```bash # 滑动窗口压缩（零 API 消耗，保留 session 头 + 最近 20 条消息） bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh compress <session_key> --window # AI 摘要压缩（提示 agent 使用上下文感知压缩） bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh compress <session_key> --ai ``` > `session_key` 支持部分匹配，输入 session ID 前几位即可。 ### 3. Prompt 精简 移除 Prompt 文件中的冗余指令、连续空行和尾部空白。 ```bash bash ~/.openclaw/skills/agent-quantizer/scripts/quantize.sh trim <文件路径> ``` **处理规则：** - 合并连续空行为单个空行 - 移除空注释行（`#` 或 `//` 后面无内容） - 去除行尾空白 - 自动创建 `.bak` 备份 ### 4. 僵尸会话清理 识别并回收长期不活跃的会话资源。 ```bash # 预览模式（不实际删除） bash ~/.openclaw/skills/agent-quantizer/scripts/clean-zombies.sh 7 --dry-run # 清理 7 天未活动的会话 bash ~/.openclaw/skills/agent-quantizer/scripts/clean-zombies.sh 7 # 自定义天数 bash ~/.openclaw/skills/agent-quantizer/scripts/clean-zombies.sh 30 ``` **安全机制：** - 清理前自动备份到 `.zombie-backup/` 目录 - 跳过 `sessions.json` 中标记为活跃的 session - 恢复方式：`cp .zombie-backup/<backup> <session_file>` ### 5. 心跳空转检测 检查 HEARTBEAT.md 是否在空转消耗 API 配额。 ```bash bash ~/.openclaw/skills/agent-quantizer/scripts/check-heartbeat.sh ``` **检测维度：** - 文件是否为空或仅有注释 - 可执行内容行数占比 - 是否包含 placeholder 内容（nothing、skip、TODO） - 给出三级状态：🟢 OK / 🟡 WARNING / 🔴 CRITICAL ### 6. Cron 任务审计 检查定时任务是否存在冗余、高频执行或配置冲突。 ```bash bash ~/.openclaw/skills/agent-quantizer/scripts/audit-cron.sh ``` **检测规则：** - 每分钟级别的任务 → 标记为极高频 - 5 分钟内间隔 → 警告确认必要性 - 重复 cron 表达式 → 冗余检测 - sessionTarget 与 payload.kind 不匹配 → 配置冲突 - 禁用任务 → 建议清理 ### 7. 模型分级配置 查看当前模型配置，给出分层路由建议。 ```bash bash ~/.openclaw/skills/agent-quantizer/scripts/setup-models.sh ``` **分析内容：** 当前 provider 列表、各模型参数（context window、max tokens、reasoning、cost）、主模型标识、分层策略建议。 ### 8. Skill 分类与整理 扫描已安装的 Skill，分析完整性和组织方式。 ```bash bash ~/.openclaw/skills/agent-quantizer/scripts/organize-skills.sh ``` **检测内容：** User skills vs System skills 数量统计、按类别分组（design/data/devops/integration/media/content/meta）、缺失 SKILL.md 的 skill、无脚本的纯提示词 skill、总容量统计。 --- ## 缓存系统 独立的缓存层，用于减少重复工具调用。 ```bash # 查询缓存（返回 JSON） bash ~/.openclaw/skills/agent-quantizer/scripts/cache.sh get "<查询内容>" <类别> # 写入缓存 bash ~/.openclaw/skills/agent-quantizer/scripts/cache.sh set "<查询内容>" "<结果>" <类别> <TTL秒> # 缓存统计 bash ~/.openclaw/skills/agent-quantizer/scripts/cache.sh stats # 清空缓存 bash ~/.openclaw/skills/agent-quantizer/scripts/cache.sh flush ``` | 类别 | 默认 TTL | 适用场景 | |------|----------|----------| | `tool` | 30 分钟 | 天气、汇率等半实时数据 | | `knowledge` | 24 小时 | 百科、定义等稳定信息 | | `realtime` | 5 分钟 | 新闻等快速变化内容 | | `general` | 1 小时 | 其他通用查询 | **返回格式：** `{"status":"HIT"|"MISS", "value":"...", "age_seconds":N}` --- ## 快捷命令 直接用自然语言触发，支持中文： | 用户说 | 对应操作 | |--------|----------| | "查看 token 消耗" / "token 统计" | `quantize.sh stats` | | "扫描高消耗" | `quantize.sh scan` | | "压缩上下文" | `quantize.sh compress` | | "缓存统计" | `quantize.sh cache stats` | | "清空缓存" | `quantize.sh cache flush` | | "清理僵尸 session" | `clean-zombies.sh` | | "检查 heartbeat" | `check-heartbeat.sh` | | "检查 cron" | `audit-cron.sh` | | "整理 skill" | `organize-skills.sh` | --- ## 文件结构 ``` ~/.openclaw/skills/agent-quantizer/ ├── SKILL.md # 本文件 └── scripts/ ├── quantize.sh # 主入口（stats / scan / compress / trim / cache） ├── cache.sh # 缓存系统（get / set / stats / flush） ├── clean-zombies.sh # 僵尸会话清理 ├── check-heartbeat.sh # 心跳空转检测 ├── audit-cron.sh # Cron 任务审计 ├── setup-models.sh # 模型分级配置 └── organize-skills.sh # Skill 分类整理 ``` --- ## 安全说明 - 所有脚本仅读取本地文件，不向外部发送数据 - 僵尸清理前自动备份到 `.zombie-backup/`，支持回滚 - 缓存数据存储在 `~/.openclaw/agent-quantizer-cache/`，仅本地文件系统 - Prompt 精简自动创建 `.bak` 备份，原文件可恢复 - 不修改任何系统配置文件、环境变量或认证凭据 - 所有脚本遵循 `set -euo pipefail`，异常立即终止


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal:  | SkillSpector:  ()