辩证唯物主义 AI 记忆系统

基于毛泽东《实践论》《矛盾论》设计的 AI 个人助手记忆系统。

核心理念

"通过实践而发现真理，又通过实践而证实真理和发展真理。" ——《实践论》

传统 AI 记忆系统只做两件事：存和取。这个系统做了五件事：

1. 矛盾驱动综合 — 新旧矛盾不覆盖，产生更高层理解
2. 认识压缩 — 事件→模式→原则→智慧，随成熟度压缩
3. 实践验证 — 信念有保质期，过期需重新验证
4. 反思层分离 — 行动层同步，反思层异步
5. 行为优先 — 观察到的行为 > 用户声明的偏好

架构

MEMORY.md / USER.md          ← § 分隔条目（人类可读，git 友好）
        ↕
MEMORY.meta.json / USER.meta.json  ← JSON sidecar（结构化元数据）
        ↕
MemoryStore                  ← 核心引擎（读写、矛盾检测、成熟度管理）

关键设计： 元数据存储在 JSON sidecar 文件中，§ 文件保持不变。frozen snapshot 机制完全不受影响。

数据结构

EntryMeta — 单条记忆的元数据

字段	含义
maturity	INCIDENT → PATTERN → PRINCIPLE → WISDOM
knowledge_type	FACT / STATE / RULE / BELIEF / MEMORY
source_kind	USER_EXPLICIT / OBSERVED / AGENT_INFERRED / ...
status	ACTIVE / CONTRADICTED / SUPERSEDED / DECAYED / SYNTHESIZED
authority / conviction / importance	三维评分（MemEX 模式）
confidence	综合置信度（带衰减）
hit_count / observed_behavior_count	行为信号

ContradictionEdge — 矛盾关系

矛盾是一等对象，不是错误。两条矛盾的记忆都保留，通过综合条目解决。

算法

衰减公式（读取时计算，不修改存储值）

decayed = confidence × (1 - rate)^days_since_update
effective = max(type_floor, maturity_floor, decayed)

成熟度晋升

阶段	条件
INCIDENT → PATTERN	hit_count ≥ 2, age ≥ 3天, confidence ≥ 0.5
PATTERN → PRINCIPLE	hit_count ≥ 5, age ≥ 7天, confidence ≥ 0.6
PRINCIPLE → WISDOM	hit_count ≥ 10, age ≥ 14天, confidence ≥ 0.7

行为优先权重

来源	默认权重
OBSERVED（观察到的行为）	0.95
USER_CORRECTION（用户纠正）	0.95
USER_EXPLICIT（用户声明）	0.90
BACKGROUND_REVIEW（后台审查）	0.60
AGENT_INFERRED（AI 推断）	0.50
DERIVED（综合推导）	0.40

使用

from tools.memory_tool import MemoryStore, memory_tool
from tools.memory_beliefs import SourceKind

store = MemoryStore()
store.load_from_disk()

# 添加记忆（带来源标记）
store.add("memory", "用户喜欢简洁回复", source_kind=SourceKind.USER_EXPLICIT)
store.add("memory", "用户在技术问题上追问细节", source_kind=SourceKind.OBSERVED)

# 查看矛盾
contradictions = store.get_contradictions("memory")

# 运行维护（衰减检查 + 晋升评估）
actions = store.run_maintenance("memory")

工具 Schema

{
  "action": "add | replace | remove | contradictions | maintenance",
  "target": "memory | user",
  "content": "...",
  "old_text": "...",
  "source_kind": "user_explicit | observed | agent_inferred | user_correction | background_review | derived",
  "contradiction_mode": "surface | filter"
}

设计来源

项目	贡献
Experience Engine	记忆压缩、噪声感知评分、试用期展示
Merkraum	信念状态机、矛盾作为一等关系、置信度衰减
MemEX	三维评分、溯源链、矛盾处理模式
毛泽东《实践论》	实践→认识→再实践的螺旋上升
毛泽东《矛盾论》	矛盾是事物发展的动力

测试

python -m pytest tests/test_memory_beliefs.py -v

34 个测试覆盖：元数据序列化、置信度衰减、成熟度晋升、行为信号、矛盾解决、集成测试。

文件结构

dialectical-memory/
├── README.md
├── tools/
│   ├── memory_beliefs.py    # 数据结构 + 纯函数（450 行）
│   └── memory_tool.py       # MemoryStore + 工具入口（900 行）
└── tests/
    └── test_memory_beliefs.py  # 测试套件（300 行）

License

MIT