前言¶
长对话、大块代码和冗长提示词会迅速占满上下文窗口,单次请求消耗的 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。
- SkillHub 页面:https://www.skillhub.cn/skills/user_29dc410e/token-saver-qclaw
- 官方地址:https://api.skillhub.cn/user_29dc410e/token-saver-qclaw
核心功能¶
依据官方简介,已核实的能力如下:
- 智能压缩输入:对用户输入文本、代码片段、对话内容进行处理,在保留语义的前提下缩短长度。
- 省流区间:官方说明可节省约 20%–70% Token(实际比例取决于原文长度与内容类型,页面未给出固定算法细节)。
- 面向 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 子命令或配置文件名。
可复现的用法步骤可以归纳为:
- 按上一节将
@user_29dc410e/token-saver-qclaw安装到当前 Agent 的 skills 目录并启用。 - 在照常进行对话、粘贴代码或携带较长上下文的前提下使用该 Agent;压缩由 Skill 在链路中处理。
- 对比启用前后单次请求的上下文长度或账单 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 入手安装验证。