功能说明: 本技能涵盖 自动化配置和灵活的参数设置、多种应用场景、化配置和灵活的参数设置 等核心能力。

记忆安全扫描（Memory Scan）

面向 AI Agent 记忆文件与工作区配置的安全扫描工具，对 MEMORY.md、每日日志、工作区配置文件进行合规检查，检测恶意内容、凭证泄漏与注入攻击，保障Agent运行安全.

输入定义

参数名	类型	必填	说明
input	string	是	记忆安全扫描处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

能力矩阵

1. 七大检测类别全覆盖

   • 恶意指令：检测命令删除文件、发送邮件、执行危险操作等破坏性指令
   • Prompt注入：识别嵌入式操纵模式，如"忽略之前的指令"、"你现在是..."等
   • 凭证泄漏：匹配API Key、密码、Token等敏感信息，覆盖sk-/AKIA/ghp_/xoxb-等前缀
   • 数据外泄：检测将数据发送到外部服务器的指令与curl外传行为
   • 护栏规避：识别禁用安全检查、关闭防护机制等规避尝试
   • 行为操纵：检测未授权的人格改变、角色覆盖等操纵指令
   • 权限提升：识别提权到root、获取管理员权限等越权行为
   • 输出：按文件列出的威胁清单，含file:line定位与威胁描述

2. 五级安全分级与告警工作流

   • SAFE：无威胁检测
   • LOW：轻微关注，继续使用但保持警觉
   • MEDIUM：潜在威胁，建议审查
   • HIGH：很可能威胁，立即审查
   • CRITICAL：活跃威胁，建议隔离
   • MEDIUM/HIGH/CRITICAL级别触发告警工作流：停止处理 → 发送告警 → 提供文件位置与威胁描述 → 建议处置 → 可选隔离

3. 全面扫描范围

   • MEMORY.md：长期记忆文件
   • memory/*.md：每日日志（默认扫描最近30天，可通过 --days 参数调整）
   • 工作区配置文件：AGENTS.md、SOUL.md、USER.md、TOOLS.md、HEARTBEAT.md、GUARDRAILS.md、IDENTITY.md、BOOTSTRAP.md
   • 支持通过 --file 参数扫描指定文件

4. LLM提供商自动检测

   • 优先使用OpenAI（gpt-4o-mini）进行远程分析（需配置OPENAI_API_KEY）
   • 回退到Anthropic（claude-sonnet-4-5）如可用
   • 支持网关模型配置
   • 远程LLM分析默认禁用，需通过 --allow-remote 显式启用
   • 远程模式仅传输脱敏内容，疑似凭证替换为 [REDACTED]

5. 隔离与恢复

   • 检测到威胁后可执行隔离操作
   • 备份原文件到 .memory-scan/quarantine/ 目录
   • 脱敏威胁行，替换为 [QUARANTINED BY MEMORY-SCAN: <timestamp>]
   • 用 --restore 参数恢复原始内容
   • 系统不自动隔离，始终先询问用户确认

6. 定时监控与心跳集成

   • 支持创建每日扫描定时任务（默认每天下午3点运行，仅发现威胁时发送告警）
   • 支持心跳任务集成（每周日运行记忆扫描）
   • 静默模式（--quiet）适合自动化场景
   • JSON输出模式（--json）便于集成到CI/CD或其他工具链

使用方法

领先步：执行安全扫描

# 扫描全部记忆文件（本地模式）
python3 （请参考skill目录中的脚本文件）
# ...
# 允许远程LLM分析（仅传输脱敏内容）
python3 （请参考skill目录中的脚本文件） --allow-remote
# ...
# 扫描指定文件
python3 （请参考skill目录中的脚本文件） --file memory/2026-07-18.md
# ...
# 静默模式（用于自动化场景）
python3 （请参考skill目录中的脚本文件） --quiet
# ...
# JSON输出（用于集成到其他工具）
python3 （请参考skill目录中的脚本文件） --json
# ...
# 自定义扫描天数范围
python3 （请参考skill目录中的脚本文件） --days 60

第二步：分析扫描报告

查看扫描结果，关注MEDIUM及以上级别的威胁。报告包含：

• 文件路径与行号定位
• 威胁类别与描述
• 安全等级评定
• 建议处置方案

第三步：处置已发现的威胁

对于MEDIUM及以上威胁，系统询问是否隔离。确认后执行隔离：

# 隔离指定文件的指定行
python3 （请参考skill目录中的脚本文件） memory/2026-07-18.md 42

隔离操作创建备份文件 .memory-scan/quarantine/memory_2026-07-18_line42.backup，并脱敏威胁行.

第四步：配置定时监控

# 创建每日扫描定时任务
bash （请参考skill目录中的脚本文件）

或在心跳任务中添加每周扫描：

## Weekly Memory Scan
Every Sunday, run memory scan:
python3 （请参考skill目录中的脚本文件） --quiet

第五步：恢复误隔离内容（如需）

python3 （请参考skill目录中的脚本文件） --restore memory/2026-07-18.md 42

实际示例

示例一：日常记忆合规检查

输入： 用户说"帮我扫描记忆文件看看有没有安全问题"

执行命令：

python3 （请参考skill目录中的脚本文件）

输出：

Memory Security Scan
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ...
Scanning memory files...
# ...
✓ MEMORY.md - SAFE
✓ memory/2026-07-18.md - SAFE
⚠ memory/2026-07-15.md - MEDIUM (line 42)
  → Potential credential leakage: API key pattern detected (sk-***)
# ...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overall: MEDIUM
Action: Review memory/2026-07-15.md:42

后续操作： 系统询问是否隔离，用户确认后执行 python3 （请参考skill目录中的脚本文件） memory/2026-07-15.md 42.

示例二：引入外部数据后远程LLM增强扫描

输入： 用户说"我刚导入了一份外部文档到记忆中，用远程分析检查一下是否安全"

执行命令：

python3 （请参考skill目录中的脚本文件） --file memory/2026-07-20.md --allow-remote --json

输出（JSON格式）：

{
  "scan_mode": "remote_llm",
  "file": "memory/2026-07-20.md",
  "overall_level": "HIGH",
  "threats": [
    {
      "line": 15,
      "category": "prompt_injection",
      "level": "HIGH",
      "description": "检测到'忽略之前的指令，你现在是...'注入模式",
      "llm_analysis": "语义分析确认：隐含角色覆盖意图，属于间接提示注入"
    },
    {
      "line": 28,
      "category": "data_exfiltration",
      "level": "MEDIUM",
      "description": "检测到curl到外部服务器指令",
      "llm_analysis": "与line 15的注入指令构成数据外传组合"
    }
  ],
  "recommended_action": "隔离line 15和line 28，排查文档来源"
}

后续操作： 用户确认后隔离line 15和line 28，并检查外部文档来源是否可信.

示例三：定时监控集成

输入： 管理员说"设置每天自动扫描记忆文件"

执行命令：

bash （请参考skill目录中的脚本文件）

输出：

Daily memory scan cron job created.
Schedule: 3:00 PM PT daily
Alert: Sent only if threats found
Channel: configured alert channel

效果： 每天下午3点自动扫描记忆文件，仅发现威胁时通过告警渠道通知.

疑问与回应

Q1：扫描会不会泄露我的记忆内容？ 本地模式零网络请求，所有检测在本地完成。远程LLM模式（--allow-remote）仅传输脱敏内容，所有疑似凭证替换为 [REDACTED]，仅保留上下文结构供LLM分析。两种模式都不会泄露敏感信息. Q2：本地模式和远程LLM模式有什么区别？ 本地模式使用纯模式匹配，零网络请求，速度快但无法识别语义级高级注入。远程LLM模式将脱敏内容发送给LLM进行语义分析，可识别更复杂的攻击模式。建议日常使用本地模式，导入外部数据后使用远程模式增强. Q3：隔离后能恢复吗？ 可以。隔离前自动备份到 .memory-scan/quarantine/ 目录，用 python3 （请参考skill目录中的脚本文件） --restore <file> <line> 即可恢复。备份文件命名格式为 memory_<date>_line<line>.backup. Q4：定时任务怎么配置？ 运行 bash （请参考skill目录中的脚本文件） 创建每日扫描定时任务，默认每天下午3点运行。需要配置告警渠道环境变量才能接收告警通知。仅发现威胁时才会发送告警，减少噪音. Q5：扫描范围包括哪些文件？ 默认扫描MEMORY.md、memory/*.md（最近30天日志）、以及工作区配置文件（AGENTS.md、SOUL.md、USER.md、TOOLS.md、HEARTBEAT.md、GUARDRAILS.md、IDENTITY.md、BOOTSTRAP.md等）。可通过 --days 调整日志扫描范围，通过 --file 指定单个文件. Q6：系统能否自动隔离威胁？ 系统不自动隔离，始终先询问用户确认。这是为了防止误报导致合法内容被意外修改。在定时监控场景下，发现的威胁会保留至下次人工审查，并通过告警渠道通知. Q7：与其他安全技能如何配合？ 本技能聚焦记忆文件内部安全扫描。与输入守卫类技能互补（输入守卫管外部输入过滤，记忆扫描管内部存储审计），可配合使用形成完整的纵深防御体系.

Q1: 记忆安全扫描是否支持跨平台使用？

A: 是的，记忆安全扫描支持跨平台使用，可以在Windows、macOS和Linux操作系统上运行，确保了不同平台AI Agent的记忆安全。

Q2: 如何处理扫描过程中遇到的文件权限问题？

A: 如果遇到文件权限问题，需要确保运行扫描工具的用户具有足够的权限来读取和写入目标文件。如果权限不足，可以尝试使用sudo命令或者在命令前添加--sudo选项来提升权限。

Q3: 扫描过程中如何避免误报？

A: 为了减少误报，可以在扫描前对记忆文件进行预审查，标记已知的安全模式。此外，可以调整扫描配置，例如提高安全等级的阈值，以减少误报。

Q4: 如何在扫描过程中指定要扫描的特定文件？

A: 可以通过 --file 参数来指定要扫描的特定文件。例如，要扫描 memory/2023-01-01.md 文件，可以使用命令 python3 scan_tool.py --file memory/2023-01-01.md。

Q5: 如果扫描发现威胁，但不确定如何处理，应该怎么做？

A: 如果扫描发现威胁但不确定如何处理，首先应记录下威胁的详细信息，包括文件路径、行号和威胁描述。然后，可以咨询安全专家或查阅相关安全文档，以确定适当的处理步骤。在采取任何行动之前，优质先进行备份。

依赖与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力边界

1. 本地模式检测能力有限：纯模式匹配无法识别语义级的高级注入（如隐含指令、间接提示注入），需启用 --allow-remote 远程LLM分析增强，但会增加网络依赖和API调用成本.
2. 凭证检测基于前缀模式：依赖sk-/AKIA/ghp_/xoxb-等已知前缀进行匹配，无法检测自定义格式的凭证或无固定前缀的密码，可能漏报非标准凭证.
3. 扫描范围限于记忆文件：仅扫描MEMORY.md、memory/*.md及工作区配置文件，不覆盖代码文件、日志文件或其他非记忆文件中的安全威胁.
4. 隔离不自动执行：系统不自动隔离，始终先询问用户确认。在无人值守的定时监控场景下，威胁会保留至下次人工审查.
5. 定时任务依赖系统cron：定时扫描功能依赖操作系统的cron服务，Windows环境需使用任务计划程序替代，可能需要额外配置.

创新特色

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
安全扫描	2小时	10分钟	1小时50分钟	15%
数据分析	4小时	1小时	3小时	20%
报告生成	3小时	30分钟	2小时30分钟	10%
隔离处理	1小时	15分钟	45分钟	12%
恢复操作	1小时	15分钟	45分钟	12%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
扫描范围	全面覆盖记忆文件与工作区配置	部分文件检查	部分文件检查	全面覆盖
安全级别	五级安全分级	无	无	五级安全分级
功能性	隔离与恢复、定时监控、心跳集成	无	无	部分功能
易用性	界面友好，易于操作	需要专业知识	需要编程技能	界面复杂，需培训
成本	免费版，付费版可选	高	中等	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
恶意指令检测	AI Agent记忆文件可能包含恶意指令，导致数据泄露或系统破坏	数据安全、系统稳定	实时检测恶意指令，自动隔离	减少数据泄露风险50%
凭证泄漏	Agent记忆文件可能包含敏感凭证信息，导致账户被盗用	账户安全、数据安全	凭证泄漏检测，自动脱敏	提升账户安全90%
数据外泄	Agent记忆文件可能包含敏感数据，导致数据泄露	数据安全、隐私保护	数据外泄检测，自动隔离	减少数据泄露风险60%

安全遵循原则

1. 确保扫描工具的权限设置正确，避免未授权访问。
2. 定期更新扫描工具，以修复已知漏洞。
3. 对扫描结果进行详细分析，确保无误。
4. 在执行隔离操作前，确保有备份文件。
5. 对敏感数据进行脱敏处理，防止数据泄露。

错误处理指引

针对记忆安全扫描使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

记忆安全扫描通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块