前言¶

给 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