token省流助手:在 Agent 对话前压缩上下文,节省 Token

前言

长对话、大块代码和冗长提示词会迅速占满上下文窗口,单次请求消耗的 Token 也会水涨船高。常见做法是手动删历史、截断粘贴内容,或拆成多轮任务,既费时间又容易丢掉关键信息。下面介绍 SkillHub 社区 Skill「token省流助手」,在 Agent 侧对用户输入与上下文做智能压缩,把单次对话长度压下来,从而减轻推理开销并延长可用窗口。

这是什么

token省流助手-最多节省70%token(坐标 @user_29dc410e/token-saver-qclaw)是 SkillHub 上分类为 ai-agent 的社区 Skill,当前版本 v1.0.1,发布者为 user_29dc410e(页面标注作者为 super paul)。官方将其定位为 token 智能省流助手:自动对用户输入文本、代码片段、对话内容进行智能压缩,降低单次对话与上下文长度,从而节省模型推理开销、延长对话窗口、提升响应速度并降低 Token 消耗。标签 requires_api_key=false,表示按 SkillHub 元数据无需额外配置 API Key。

核心功能

依据官方简介,已核实的能力如下:

  1. 智能压缩输入:对用户输入文本、代码片段、对话内容进行处理,在保留语义的前提下缩短长度。
  2. 省流区间:官方说明可节省约 20%–70% Token(实际比例取决于原文长度与内容类型,页面未给出固定算法细节)。
  3. 面向 Agent 工作流:归类为 ai-agent,设计目标是嵌入支持 SKILL.md 的 Agent 环境,在对话链路中自动生效,而非单独提供一个需自行调用的 HTTP 接口文档。

SkillHub 统计(以抓取资料为准):评分 100000,下载 16466,安装 55。

安装与启用

Skill 遵循通用 SKILL.md 格式。SkillHub 推荐两种方式:用 CLI 安装到当前 Agent 的 skills 目录,或把安装提示词交给支持 Skill 的 AI 客户端由其按文档完成安装。

1、安装 SkillHub CLI(若尚未安装)

先检查是否已有 CLI:

command -v skillhub && skillhub --version

未安装时,可按 SkillHub 安装文档执行完整安装(含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

完整步骤与优先源配置见:https://skillhub.cn/install/skillhub.md。

2、安装本 Skill 到对应目录

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录,否则默认会装到 ./skills/,Agent 可能无法加载。

skillhub install @user_29dc410e/token-saver-qclaw --dir <你的 skills 目录>

常用客户端 skills 路径(来自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

OpenClaw 及 QClaw、EasyClaw 等变体通常也有各自的 skills 目录,以当前环境为准。

3、通过 AI 安装(官方页面提示)

SkillHub 页面提供的提示词为:请根据 https://skillhub.cn/install/skillhub.md,安装 @user_29dc410e/token-saver-qclaw。将上述内容发给已接入 Skill 能力的 AI,由其按文档完成安装与目录校验。

安装后按你所用客户端的要求重启或刷新 Agent,使 Skill 被加载。公开资料未单独列出 Cursor 与 Claude Code 在启用逻辑上的差异,除 skills 目录路径不同外,其余以各客户端对 SKILL.md 的通用支持为准。

典型用法

官方简介描述的是自动行为:Skill 启用后,对用户输入文本、代码片段、对话内容进行智能压缩,无需在资料中另行查阅独立 CLI 子命令或配置文件名。

可复现的用法步骤可以归纳为:

  1. 按上一节将 @user_29dc410e/token-saver-qclaw 安装到当前 Agent 的 skills 目录并启用。
  2. 在照常进行对话、粘贴代码或携带较长上下文的前提下使用该 Agent;压缩由 Skill 在链路中处理。
  3. 对比启用前后单次请求的上下文长度或账单 Token(若你的环境有统计),观察是否落在官方所述 20%–70% 区间内。

资料中未提供官方示例仓库、固定提示词模板或压缩前后对照样例,本文不展开未核实操作。

适用场景与注意

适合谁

  • 经常向 Agent 粘贴大段代码、日志或文档,上下文容易顶满的用户。
  • 希望在不明显改写作习惯的前提下,降低 Token 消耗、拉长可继续对话的空间的开发者。

限制与注意

  • 压缩比例标称为 20%–70%,属于区间而非保证值;极短输入或高度结构化内容,节省可能不明显。
  • 任何有损压缩都可能弱化细节;涉及精确字面(版本号、路径、配置项)的任务,启用后仍应核对关键字段是否完整。
  • 本 Skill 为 community 来源,行为以 SKILL.md 与 SkillHub 页面说明为准;升级版本时注意查看 v1.0.1 之后的变更说明(若商店有更新)。

结尾

token省流助手把「减 Token」从手工删上下文,变成 Agent 侧可加载的 ai-agent Skill:自动压缩文本、代码与对话内容,无需 API Key(按 SkillHub 标签)。若你正在 SkillHub 上选型省流类能力,可从官方页面与坐标 @user_29dc410e/token-saver-qclaw 入手安装验证。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye