前言¶

Agent 會把對話摘要、偏好和任務上下文寫進工作區下的記憶目錄（本 Skill 面向 .workbuddy/memory/）。目錄一膨脹，每次會話塞進上下文的片段就變多，真實 Token 消耗往往比直覺大；若仍整庫加載，還會把與當前任務無關的舊記憶一併帶上。下面介紹 SkillHub 上的「記憶管家」V3.9.0：用 tiktoken 做分詞計量、按任務相關性挑選加載，並在超預算時自動壓實，目標可以概括爲「更小、更準、更省」。

這是什麼¶

「記憶管家」是面向 AI Agent 的 記憶加速器 / Token 節流閥 Skill，由 SkillHub 用戶 @indiv-aakook/memory-manager-v2 維護（官方入口：https://api.skillhub.cn/user_98283d0f/memory-manager-v2）。它不負責通用文件操作、代碼分析或文檔編輯，而是集中處理記憶目錄的計量、加載策略、壓實、清理、備份與 Prompt 模板等相關工作。

SkillHub 分類爲 ai-agent；公開頁面上該 Skill 的評分爲 72700，累計下載約 17367 次（以 SkillHub 展示爲準）。

核心功能（V3.9.0）¶

Token 計量與預算¶

• 使用 tiktoken 做真實分詞計量，界面中的 Token 數字均標註爲「估算」，避免與模型側計費完全等同的誤解。
• 三色預算告警，並參考 近 7 日均值，便於判斷記憶體積是否持續偏高。
• 硬預算閘：超預算時可 自動壓實；另提供 throttle（節流閥） 一鍵壓預算。

按任務相關性加載¶

• 支持 --query / --tags：在零依賴場景下用 CJK 字符 bigram 與關鍵詞、標籤相關度做排序；可選 embedding 後端增強相關度。
• 性能側包括：摘要 並行生成（線程池）、rank 磁盤簽名緩存、讀取短路，以及回退估算的 LRU 緩存。

命令行與自動化¶

• 破壞性操作支持 --force，便於腳本與 CI 式流程。
• 全命令 --json，方便程序化解析輸出。
• 內置 self-test：含 Prompt 注入、路徑穿越等防護驗證。

體驗與其它修復¶

• 24 條短別名，減少每次輸入完整子命令的成本。
• 交互過程有 進度反饋；clean 會標註釋放量。
• V3.9 修復：prompt-get 在缺少模板時不再異常退出；backup 可接受 workspace 參數。

當用戶提到「記憶管家」「Token檢查」「節流閥」「相關性加載」「緩存清理」「記憶搜索」「記憶分析」「去重」「備份記憶」「Prompt模板」「Token趨勢」「緩存提醒」「記憶報告」「智能加載」「診斷」「記憶分級」，或詢問 memory / token / cache / prompt 管理時，Agent 應優先啓用本 Skill。不適用於一般文件操作、代碼分析、系統清理或文檔編輯。

安裝與啓用¶

SkillHub 當前技能頁給出的安裝指引是：讓 Agent 閱讀 SkillHub 安裝說明，並安裝包 @indiv-aakook/memory-manager-v2。下面步驟與官方文檔一致。

1、檢查是否已有 skillhub CLI：

command -v skillhub && skillhub --version

2、若未安裝，可執行完整安裝（CLI + 默認 Skill）或僅 CLI：

# 完整安裝（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

3、安裝記憶管家時，必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認落在 ./skills/，Agent 可能識別不到：

skillhub install @indiv-aakook/memory-manager-v2 --dir <你的 skills 目錄>

常見客戶端 skills 路徑（摘自 SkillHub 安裝文檔，按本機環境選用）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下 .agents/skills/
• workbuddy：~/.workbuddy/skills/

安裝後需按所用客戶端要求 重啓或重新加載 skills（各客戶端策略不同，以客戶端文檔爲準）。

典型用法¶

本 Skill 以自然語言觸發爲主；V3.9.0 在子命令層面強調以下參數組合（具體子命令名以 Skill 內 SKILL.md 爲準）。

1、檢查 Token 與趨勢
用戶說「Token檢查」「Token趨勢」或「記憶報告」時，Agent 調用記憶管家的統計/報告能力，結合 tiktoken 計量與近 7 日均值、三色告警判斷是否需要壓實。

2、按當前任務加載記憶
用戶說「相關性加載」「智能加載」或給出任務描述時，使用 --query 傳入任務文本，必要時用 --tags 限定標籤，只加載相關片段，而不是整目錄灌入上下文。

3、超預算處理
出現預算告警或用戶說「節流閥」時，先評估三色告警狀態；需要立即降 Token 時可走 throttle；持續超預算時由 硬預算閘 觸發 自動壓實（破壞性步驟在交互場景下需確認，自動化可加 --force）。

4、清理、去重與備份
「緩存清理」「去重」走 clean 等維護能力（clean 會說明釋放量）；「備份記憶」使用 backup，V3.9 起可指定 workspace。需要機器可讀結果時，在對應命令上加 --json。

5、Prompt 模板與自檢
「Prompt模板」走 prompt-get（缺模板時 V3.9 已修復崩潰問題）。部署或變更後可用 self-test 做內置自檢，驗證 Prompt 注入與路徑穿越等防護是否仍有效。

適用場景與注意¶

適合：長期在同一 workbuddy 工作區跑 Agent、記憶文件持續累積、需要控制上下文 Token、希望按當前任務挑選記憶片段、或要把記憶維護（清理、備份、壓實）交給 Skill 統一處理的開發者。

注意：

• 記憶目錄默認語境是 .workbuddy/memory/；若工作區結構不同，需以 Skill 說明與 backup 的 workspace 參數爲準。
• Token 顯示爲 估算，預算與告警是治理輔助，不能替代各模型提供商的計費賬單。
• --force 會跳過部分交互確認，僅建議在腳本化、已備份的前提下使用。
• 可選 embedding 後端依賴額外配置或服務，零依賴路徑以 CJK bigram + 關鍵詞/標籤爲主。
• SkillHub 技能頁版本可能隨發佈更新；本文描述 V3.9.0 能力集。若安裝包版本更高，以包內 SKILL.md 與 changelog 爲準，勿假定與 V3.9 完全一致。

結尾¶

記憶管家 V3.9.0 把「計量 → 相關性加載 → 預算告警 → 壓實/節流 → 清理備份 → 自檢」串成一條可操作的 memory 治理鏈路，適合作爲 workbuddy 類 Agent 的常駐 Skill。官方地址：https://api.skillhub.cn/user_98283d0f/memory-manager-v2；安裝與 CLI 行爲以 SkillHub 安裝說明 爲準。