基于 Git Notes 的静默知识图谱记忆系统，自动持久化会话上下文、决策与偏好，无需用户干预，实现跨会话的智能连续性。
说明：
## 核心用法
GitNotesMemory 是一个面向 Claude 的**静默自动记忆系统**，利用 Git Notes 实现分支感知的持久化存储。其核心设计哲学是 **”JUST DO IT”** —— 完全在后台运行，绝不询问用户、绝不-announce 操作、绝不展示命令输出。
### 典型工作流
1. **会话启动**：自动执行 `sync –start` 加载当前分支的上下文概览（关键记忆、高频主题、记忆总数）
2. **会话中静默记录**：通过 `remember` 自动捕获用户决策（`-i h`）、偏好（`-i c/h`）、学习任务等，支持标签分类与重要性分级（c/h/n/l 四级）
3. **智能检索**：通过 `get `、`search “”` 或 `recall` 按需调取上下文
4. **会话结束**：可选执行 `sync –end` 触发维护
### 显著优点
| 优势 | 说明 |
|——|——|
| **真正的零干扰** | 严格禁止询问/宣布/展示，用户体验无感知 |
| **分支隔离+继承** | 每个 Git 分支拥有独立记忆空间，新分支自动继承 main，合并后支持 `merge-branch` 同步 |
| **智能实体提取** | 自动识别 topic/subject、#hashtag、”引号短语”、首字母大写术语等，构建知识图谱 |
| **类型自动检测** | 基于关键词识别 decision/preference/learning/task/question/progress 等 8 类记忆 |
| **进化追踪** | `evolve` 命令支持记录决策变更历史，避免信息覆盖 |
| **结构化存储** | JSON 格式内容，支持多字段决策记录（含理由、备选方案等） |
### 潜在局限性与风险
| 局限 | 说明 |
|——|——|
| **Git 依赖** | 必须在 Git 仓库内运行，非 Git 项目无法使用 |
| **路径配置** | 需正确配置 `$SKILL_PATH` 和 `$DIR`，配置错误导致失效 |
| **静默失效难察觉** | 若命令执行失败，用户和 Claude 均无法感知，可能导致”失忆” |
| **分支混淆风险** | 频繁切换分支若未及时 `sync –start`，可能加载错误上下文 |
| **重要性主观性** | `-i c/h/n/l` 分级依赖 Claude 判断，存在误判可能 |
| **隐私边界模糊** | 文档未明确说明敏感信息（密码、API key）的自动过滤机制，存在泄露风险 |
### 适合人群
– **长期项目协作**：需要跨数周/数月维持上下文连续性的开发者
– **多分支并行工作**：在 feature 分支间切换、需要隔离+合并记忆的场景
– **高上下文依赖任务**：复杂架构决策、逐步演进的系统设计讨论
### 常规风险
1. **过度记忆**：缺乏明确的存储上限与自动清理策略（仅 `-i l` 可修剪），长期项目可能累积冗余
2. **检索噪声**：实体提取的自动化可能索引过多无意义术语，降低检索精度
3. **分支遗留**：已删除的 Git 分支若未清理对应 notes，造成存储浪费
4. **Claude 幻觉干扰**：若记忆内容与当前实际代码状态脱节，可能导致基于过时信息的错误建议
