메뉴
mcMemory (mcm) - 分层记忆管理系统。命令以 "mcm" 开头。项目记忆支持 L1-L4 层级，个人记忆支持 L1-L3 层级。存储于 ~/.claude/mcMemories/。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | mcMemory |
| description | mcMemory (mcm) - 分层记忆管理系统。命令以 "mcm" 开头。项目记忆支持 L1-L4 层级，个人记忆支持 L1-L3 层级。存储于 ~/.claude/mcMemories/。 |
| allowed-tools | ["Bash","Read","Write","Grep"] |
分层记忆管理系统。项目记忆支持 L1-L4，个人全局记忆支持 L1-L3。
存储路径:
~/.claude/mcMemories/(原~/.claude/memory/)
| 命令 | 功能 | 入口 |
|---|---|---|
mcmInit | 初始化项目/个人记忆 | commands/init.sh |
mcmSync | 增量同步已有记忆 | commands/sync.sh |
mcmLoad <名称> | 加载记忆到当前会话上下文 | commands/load.sh |
mcmSearch <关键词> | 全文搜索记忆（--score 按 BM25×权重排序） | commands/search.sh |
mcmList | 列出所有已注册记忆 | commands/list.sh |
mcmStatus | 记忆健康总览；--drift 100 点评分（v3.3） | commands/status.sh |
mcmDelete <名称> | 删除记忆（移至回收站） | commands/delete.sh |
mcmUpdate <名称> | 更新记忆元数据 | commands/update.sh |
mcmExport <名称> | 导出记忆为归档 | commands/export.sh |
mcmImport <文件> | 从归档导入记忆 | commands/import.sh |
mcmRestore <条目> | 从回收站恢复 | commands/restore.sh |
mcmEmptyTrash | 清空回收站 | commands/empty-trash.sh |
mcmAutoInject | 一键开启/关闭/暂停自动注入 | commands/auto-inject.sh |
mcmInjectLog [--tail N] | 查看自动注入事件日志 | commands/inject-log.sh |
mcmJournal <文本> | 一行命令追加会话笔记（PreCompact 时归档为 L3 chunk） | commands/journal.sh |
mcmDoctor [--fix] | 健康检查 + 自动迁移脏 tag 目录 + 占位 chunk 报告 | commands/doctor.sh |
mcmMark <名称> | 标注 chunk 来源/证据等级（source/evidence → BM25 权重） | commands/mark.sh |
mcmLedger <子命令> | 会话决策日志：add/list/resolve/show 结构化决策/待办/阻断 | commands/ledger.sh |
mcmRemote <子命令> | git 远程共享：init/add/list/remove/device | commands/remote.sh |
mcmPush | 提交并推送记忆到 git remote | commands/push.sh |
mcmPull | 拉取并合并，冲突不静默 | commands/pull.sh |
--global - 对全局个人记忆操作（而非项目记忆）--json - 机器可读 JSON 输出（list / search / status / ledger 支持）--scope - 作用域：project（默认）或 user--help - 显示帮助信息本 skill 提供 3 个 Hook 脚本实现自动记忆注入：
| Hook 事件 | 脚本 | 功能 |
|---|---|---|
SessionStart | hooks/session-start.sh | 新会话自动加载项目 L1 + auto 全局 L3 |
UserPromptSubmit | hooks/prompt-submit.sh | 智能提取关键词，检索相关记忆注入 |
PreCompact | hooks/pre-compact.sh | 上下文压缩前保存会话摘要 |
一键开启:
mcmAutoInject on # 当前项目启用
mcmAutoInject on --scope user # 全局启用
mcmAutoInject status # 查看状态
mcmAutoInject off # 关闭
# 临时暂停（不改 settings.json，到点自动恢复）
mcmAutoInject pause 30m # 暂停 30 分钟
mcmAutoInject pause 2h # 暂停 2 小时
mcmAutoInject resume # 立即取消
# 全局停止（无条件 kill-switch，需显式取消）
mcmAutoInject stop # 全局停止所有注入
mcmAutoInject unstop # 取消全局停止
# 查看注入日志（哪些记忆在什么时间被注入、得分、关键词）
mcmInjectLog # 最近 20 条
mcmInjectLog --tail 50
mcmInjectLog --json
注入策略:
final_score = bm25 × source_w × evidence_w，per memory 取 best evidence wins。source: user=1.0/agent=0.7/system=0.5，evidence: validated=1.0/observed=0.85/hypothesis=0.6。AI 浓缩内容默认 agent/observed=0.595 折扣防幻觉；mcmMark --source user --evidence validated 提升已验证知识至 1.0INJECT_BM25_MIN_SCORE（默认 0，即任何正分；可调）mcmInjectLog 查看注入历史~/.claude/mcMemories/
├── projects/ # 项目记忆（L1-L4）
│ ├── index.md # 项目总索引
│ ├── {tag}/ # 按标签分组的项目目录（自由标签）
│ │ └── <project-name>/
│ │ ├── summary.md # L1
│ │ ├── index.md # L2
│ │ ├── hash.json # 文件哈希（相对路径 key）
│ │ ├── chunks/ # L3
│ │ │ └── .claude/ # L4 device registry（.claude/l4/<device>.json）
├── global/ # 个人全局记忆（L1-L3）
│ ├── index.md
│ ├── auto/ # 自动加载型
│ └── on_demand/ # 关键词触发型
└── .trash/ # 回收站
| 层级 | 内容 | 说明 |
|---|---|---|
| L1 | 项目文件夹 | 项目名 + 简介 |
| L2 | 大纲索引 | 标题 + 标签 + 摘要句 + 行号范围 |
| L3 | 浓缩内容 | 从原始文件 AI 浓缩的核心内容（chunks/*.md） |
| L4 | 原始链接 | 指向源文件的引用（仅项目，device-keyed JSON registry） |
.sh 文件，直接 source lib/core.sh.trash/ 而非永久删除CHUNK_SPLIT_THRESHOLD (默认 200 行) 的源文件按 ## 标题自动拆分为多个 chunk重要: 当
mcmInit或mcmSync完成后，如果 chunk 文件包含[待AI补充：浓缩内容]占位符，Claude 应执行以下流程：
chunks/ 目录中每个包含占位符的 chunk 文件source_file 字段找到对应源文件Read 工具读取源文件完整内容[待AI补充：浓缩内容] 占位符Edit 工具原地更新 chunk 文件source: agent / evidence: observed（0.595 折扣防幻觉）。若该 chunk 内容来自用户明确确认的决策，可改标 source: user / evidence: validated 提升其在自动注入中的权重：
mcmMark <名称> --source user --evidence validated # 整个记忆所有 chunk
mcmMark <名称> --chunk 1_ARCHITECTURE --evidence validated # 仅指定 chunk
evidence: hypothesis（0.6）以降低注入优先级。自动注入模式（推荐）:
mcmAutoInject on 一次配置 Hook手动模式:
mcmList 了解可用记忆auto 标签的全局记忆，自动调用 mcmLoad --layer L3 加载浓缩内容mcmLoad 加载相关记忆mcmSearch 检索相关记忆再回答重要: 在会话过程中，当出现以下情况时，Claude 应主动追加到
.claude/session_notes.md：
触发写入的场景:
推荐方式（v2.4+）: 使用 mcmJournal 一行命令，免去 Write 工具的门槛：
mcmJournal "决策: 用 BM25 替换 sqrt(n) 归一化；原因: 后者无理论依据"
mcmJournal "Bug fix: prompt_submit_inject 永不注入；根因: score 二次过滤"
echo -e "决策 A\n决策 B" | mcmJournal --stdin # 多行
mcmJournal --show # 查看当前笔记
或直接 Write .claude/session_notes.md 添加结构化条目：
## <简短标题>
**决策**: <一句话描述>
**原因**: <为什么这样做>
**涉及文件**: <相关文件路径>
pre-compact.sh hook 会在压缩前自动:
.claude/session_notes.mdchunks/session_YYYYMMDD_HHMMSS.md）.claude/session_notes.md 以备下次会话这样不会丢失跨会话的决策上下文，且可在
mcmSearch中检索到。
当用户调用 mcmXxx 时，执行对应的 commands/xxx.sh。
公共函数位于 lib/core.sh (v2.0)，各命令通过 source 加载。
版本: v4.0 | git 远程记忆共享（mcmRemote/mcmPush/mcmPull） | L4 device-keyed registry（弃软链） | .gitignore 派生分离 + .gitattributes merge=union | SessionStart ff-only auto-pull | 会话决策日志 ledger | drift 100 点评分 | 证据/来源分层 | mcmMark | op-log | STOP kill-switch | doctor canary | BM25 注入 | NDJSON 事件总线 | 2026-07-09