前言¶
和 AI 協作久了,常見摩擦不是模型不夠聰明,而是上下文一斷就「失憶」:上週踩過的坑、已經糾偏過的結論、驗證過的配置,新會話裏又要從頭講一遍。有人靠每次粘貼筆記或項目裏的 MEMORY.md 頂着用,能緩解,但維護成本高,也容易和對話裏新產生的經驗脫節。
下面介紹 SkillHub 上的 AI Agent記憶系統(@user_7db0c006/agent-local-memory-keeper)。它把「記經驗、召回、去重糾錯」做成 Agent Skill:對話裏出現值得沉澱的內容時自動入庫,需要時用自然語言語義召回,數據以本地爲主,並帶版本與衝突處理機制。
這是什麼¶
AI Agent記憶系統 是社區發佈的 ai-agent 類 Skill,當前版本 v5.2.1,發佈者爲 user_7db0c006(SkillHub 頁面標註作者爲「路人甲」)。SkillHub 標籤爲 requires_api_key=false,即不強制要求單獨配置 API Key 才能安裝使用。
一句話定位:給 AI 的全自動跨會話長期記憶——你照常聊天,由 Skill 指導 Agent 在合適時機沉澱、整理、糾錯與召回;適合用戶抱怨「反覆忘事 / 重複提問 / 結論過時」,或明確要求記住、召回、糾正、遷移記憶時使用。
官方入口:
- API 頁:https://api.skillhub.cn/user_7db0c006/agent-local-memory-keeper
- SkillHub 頁:https://www.skillhub.cn/skills/user_7db0c006/agent-local-memory-keeper
(截至 2026-10-19,SkillHub 顯示評分 100000、下載約 29009 次。)
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面描述,按機制拆開說明。
自動沉澱,無需每次喊「記一下」¶
對話中出現踩坑、糾偏、驗證過的結論時,Skill 會驅動 Agent 自動沉澱入庫,不要求你每次手動說「記一下」。這與純靠用戶維護的靜態記憶文件相比,更貼近「從真實協作里長出來的經驗」。
庫內整理:去重、糾錯、歸檔與衝突仲裁¶
記憶庫側會做 自動去重、糾錯、歸檔聚類;新舊結論衝突時會 檢測並仲裁、將舊結論標舊。另有 定期自檢自愈,官方表述爲全程零維護取向(具體節奏與規則以 Skill 內 SKILL.md 爲準)。
自然語言語義召回(本地中文模型)¶
需要歷史經驗時,可以說類似「找一下之前關於 XX 的」;中文換說法也能語義召回。召回側說明爲 本地中文模型,離線可用、數據不出本機,適合對數據出境或外網依賴敏感的環境。
版本、軟失效與時間點回溯¶
過時結論支持 軟失效、可撤銷;每條記憶帶 版本歷史、可回滾;並支持按時間點回溯「當時爲真」的結論狀態,便於排查「爲什麼上次和這次說法不一樣」。
安全與兜底¶
官方列出的安全設計包括:
- 整理時 只歸檔、不靜默刪除
- 敏感信息自動攔截隔離
- 召回引擎 降級必告警,並附修復路徑
可主動干預的操作¶
除自動流程外,可用自然語言觸發干預,例如:
- 「幫我一鍵配好」
- 「這條結論作廢」
- 「備份一下記憶庫」
另:簡介中提到 投資類結論支持從 DuckDB 復算校驗(適用邊界以 Skill 內說明爲準)。
安裝與啓用¶
SkillHub 官方安裝指引見 SkillHub 安裝與優先源配置。頁面上的安裝提示爲:按該文檔安裝 @user_7db0c006/agent-local-memory-keeper。
1、檢查或安裝 skillhub CLI¶
先確認本機是否已有 skillhub:
command -v skillhub && skillhub --version
未安裝時,可用官方腳本(完整安裝含 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
2、安裝到當前 Agent 的 skills 目錄¶
安裝技能時 必須 用 --dir 指向當前 Agent 識別的 skills 目錄;否則默認會裝到 ./skills/,Agent 可能讀不到。官方文檔列出的常用路徑示例:
| 環境 | skills 目錄(示例) |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
在對應目錄下執行安裝(將 <skills 目錄> 換成你的實際路徑):
skillhub install user_7db0c006/agent-local-memory-keeper --dir <skills 目錄>
也可先把 SkillHub 頁面上的提示發給當前 AI,讓其按 skillhub.md 完成安裝;座標寫法爲 @user_7db0c006/agent-local-memory-keeper,與 CLI 的 user_7db0c006/agent-local-memory-keeper 對應同一技能。
3、啓用後¶
安裝到正確目錄後,按你所用 Client 的慣例 重啓或重新加載 Agent,使新 Skill 被加載。首次使用若本地召回模型或目錄未就緒,可對照 Skill 說明使用「幫我一鍵配好」類指令完成初始化(細節以 Skill 包內文檔爲準)。
典型用法¶
官方沒有單獨的長篇教程,用法主要體現在 對話意圖 與 Skill 觸發的場景上,可復現的示例如下。
日常協作(自動記)
正常描述問題、排錯過程和最終驗證結果即可;當出現踩坑、糾偏或已驗證結論時,由 Skill 驅動沉澱,無需固定口令。
主動召回
找一下之前關於 [主題] 的結論
可用不同中文表述同一意圖,依賴本地語義召回。
糾正與作廢
這條結論作廢
用於將錯誤或過時條目軟失效,並保留版本軌跡。
運維類
備份一下記憶庫
幫我一鍵配好
分別對應備份與快速配置場景。
投資類校驗(若你的記憶庫含相關結構化數據)
按 Skill 說明從 DuckDB 復算校驗投資結論——僅在 Skill 文檔聲明的範圍內使用。
適用場景與注意¶
更適合誰
- 長期在同一機器、同一 Agent 上做多會話開發或運維,希望經驗跨會話保留
- 需要 本地優先、離線召回,減少記憶內容反覆上傳雲端
- 結論會演進,需要 衝突檢測、標舊、版本回滾 而不是單文件覆蓋
使用上要注意
- 安裝路徑錯誤是最常見「裝了但沒用」的原因,務必
--dir到當前 Client 的 skills 目錄。 - 自動沉澱依賴對話裏是否出現可識別的「經驗信號」;極隱晦的上下文仍可能需要你點明一次。
- 敏感信息雖有攔截隔離設計,仍應避免在對話中主動寫入密鑰、令牌等;與任何記憶方案一樣,源頭剋制比事後清理更可靠。
- 召回引擎降級時官方承諾告警並給出修復路徑,出現相關提示時應先按 Skill 內指引處理,再依賴記憶召回做關鍵決策。
結尾¶
AI Agent記憶系統 把長期記憶從「人手維護筆記」推進到「對話自動沉澱 + 本地語義召回 + 去重糾錯與版本治理」,並強調防靜默刪除與召回降級告警。若你正在爲跨會話失憶或結論過時頭疼,可以從 SkillHub 安裝 @user_7db0c006/agent-local-memory-keeper 試起。
- SkillHub:https://www.skillhub.cn/skills/user_7db0c006/agent-local-memory-keeper
- API:https://api.skillhub.cn/user_7db0c006/agent-local-memory-keeper