前言¶
長對話、大塊代碼和冗長提示詞會迅速佔滿上下文窗口，單次請求消耗的 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 入手安裝驗證。
