前言¶

給 Agent 加「長期記憶」時，常見做法是直接把對話寫進向量庫或 Markdown，檢索時再塞進上下文。這條路徑上手快，但寫入側往往缺少統一安檢：提示注入、PII、異常高頻寫入很難在落盤前攔住；上下文頂滿後，壓縮與遺忘也多半要你自己編排。

下面介紹 SkillHub 上的 墨羽 — AI Agent 安全記憶工具包（座標 @user_cac30d95/moyu，當前版本 2.10.1）。它把 MOYU 記憶層打包成通用 Skill，並附帶純 Python 工具包：強調零信任下的寫入防禦、檢索與生命週期管理；LLM 增強默認開啓，無 API Key 時會自動降級，核心記憶能力仍可離線使用。

這是什麼¶

MOYU 定位爲「安全優先的 AI Agent 記憶層」：純 Python、存儲側零外部基礎設施（Skill 簡介中的「零基礎設施」指無需自建數據庫或 Docker），以文件夾 + SQLite FTS5 等形式落地，可 pip 安裝或複製 moyu_toolkit/ 使用。

• 維護與發佈：SkillHub 社區來源，發佈者 user_cac30d95；頁面標註作者爲葉輕眠。工具包另提供 GitHub 倉庫：https://github.com/awchzh/moyu-memory
• SkillHub 分類：ai-agent；標籤 requires_api_key=false（安裝 Skill 本身不強制 API Key）
• 解決的問題：在記憶寫入、檢索、壓縮遺忘、跨會話銜接等環節內置多層防禦與自動化流水線，減少「記憶被污染、隱私落盤、上下文擠掉關鍵信息」一類風險。

核心功能¶

以下能力均來自 Skill 附帶的 SKILL.md 與官方簡介，按 6 層能力體系 歸納（防禦、記憶與檢索、知識、生命週期、學習與反思、集成）。

防禦層（11 項）¶

寫入前 內容安檢閘（v2.10.1：反混淆預處理，模式庫 613 條正則 + LLM 複覈）、PII 脫敏、寫入暴風防護、工具循環檢測、密碼驗證、完整性校驗與恢復、可選 HMAC-SHA256 記憶數字簽名（MOYU_SIGN_KEY）、用戶隔離與加密、LLM 二次安檢、訪問行爲監控等，形成默認開啓的防禦鏈。Skill 文檔對威脅覆蓋率有分級說明，並提到可用 moyu benchmark --full 復現基準測試。

記憶與檢索¶

TEMPR 多策略檢索（語義、BM25、時間、實體等，權重可配置）、本地 FastEmbed 向量化、SQLite FTS5、搜索反饋與 moyu tune 自適應調權、自動記憶提取，以及按函數積累經驗的 技能記憶（moyu skill-note）。

知識層¶

知識圖譜（LLM 增強）、工作流知識庫（Markdown 索引）、用戶畫像自動提取。

生命週期層¶

上下文壓縮與預警、任務地圖、遺忘曲線（含 LLM 審查）、記憶合併、訪問熱度（HOT/WARM/COLD）追蹤；v2.10.1 提及 可逆壓縮 CCR 與 NAS 雙腦審計補丁（以版本說明爲準）。

學習與反思、集成層¶

從糾正中學習、自我反思；醒來編排、工作記憶、跨會話橋接（~/.moyu/session_state.json）、moyu inject 標準化注入、防禦日誌等。非 Hermes 類 Agent 可在 system prompt 增加讀取 session_state.json 的說明以延續會話。

LLM 增強：重排、摘要、圖譜等默認開啓；無 Key 時按 Skill 說明自動降級，本地檢索與規則通道仍可用。

安裝與啓用¶

分兩步：先把 Skill 裝進當前 Agent 的 skills 目錄（讓模型按 SKILL.md 行事），再在本機安裝 moyu-memory CLI/庫（實際讀寫記憶）。

1. 安裝 SkillHub CLI（若尚未安裝）¶

按 https://skillhub.cn/install/skillhub.md 檢查或安裝：

command -v skillhub && skillhub --version

未安裝時可執行（完整安裝，含默認 Skill）：

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

2. 將墨羽 Skill 安裝到當前 Agent¶

安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄（裝到默認 ./skills/ 可能不會被加載）。官方頁面要求依據上述安裝文檔安裝 @user_cac30d95/moyu。

skillhub install moyu --namespace user_cac30d95 --dir <你的 skills 目錄>

常用路徑（來自 SkillHub 安裝文檔）：

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

安裝後按各客戶端要求重啓或刷新 Skill 索引。

3. 安裝 MOYU 工具包（Python）¶

Skill 內推薦的即插即用方式：

pip install moyu-memory

也可在 Skill 包內對 moyu_toolkit/ 執行 pip install -r requirements.txt 後本地調用 python3 moyu.py，適合不想走 PyPI 的場景。

可選環境變量示例（摘自 Skill 文檔）：啓用記憶簽名時設置 MOYU_SIGN_KEY；非 Hermes Agent 配置 defense_log.webhook 可接入防禦事件通知。

典型用法¶

下列命令來自 Skill 官方「快速開始」，可在本機直接復現。

交互式入門（零配置、無需 API Key）：

moyu quickstart

把檢索結果格式化爲可注入上下文的文本：

moyu inject "當前對話主題"

在 Python 中調用：

from moyu_toolkit.moyu import inject_context
inject_context("當前對話主題")

日常還可使用 moyu search <query> 檢索、moyu setup / moyu verify 做安全與完整性檢查、moyu session state 查看跨會話狀態等；完整子命令列表見 Skill 包內 SKILL.md 的「命令參考」。

適用場景與注意¶

適合誰

• 需要 Agent 持久記憶，且希望寫入路徑默認帶注入檢測、PII 處理與完整性校驗；
• 經常觸達上下文上限，希望壓縮、遺忘、合併由工具鏈自動處理；
• 希望 離線可用（本地向量與 FTS），又不排斥在有 Key 時打開 LLM 增強。

限制與注意

• 防禦鏈是分層威懾，Skill 文檔明確不是「銀彈」，複雜定向攻擊仍需結合業務審計與權限設計。
• LLM 相關能力依賴外部模型時受 Key 與網絡影響；無 Key 時按設計降級，部分圖譜/重排效果會減弱。
• SkillHub 元數據（截至抓取）：評分 100000，下載 2548；社區 Skill，升級與合規需自行跟進版本說明（當前 2.10.1）。

結尾¶

墨羽把 MOYU 的安全記憶能力封裝成可安裝的 Agent Skill，並用 pip install moyu-memory 與 moyu CLI 打通落地路徑：寫入安檢、檢索調優、生命週期與跨會話橋接在一套純 Python 工具包內完成，適合作爲自建 Agent 記憶層的起點。

• SkillHub 頁面：https://www.skillhub.cn/skills/user_cac30d95/moyu
• 官方 API 座標頁：https://api.skillhub.cn/user_cac30d95/moyu
• 安裝說明：https://skillhub.cn/install/skillhub.md