1
class MemoryEntry:
2
    value              # 内容
3
    memory_type        # IDENTITY / FACT / PREFERENCE / SKILL / PROJECT / TEMP
4
    memory_layer       # EPISODIC / SEMANTIC / PROCEDURAL / IDENTITY / TEMPORARY
5
    authority          # user=1.0 / tool=0.6 / agent=0.3
6
    source             # 来源（与 authority 分离）
7
    confidence         # 0.0-1.0
8
    explicitness       # 0.0-1.0
9
    freshness          # 基于 decay_days 自动衰减
10
    retention          # freshness×0.5 + usage×0.3 + confidence×0.2
11
    provenance[]       # 来源链审计（可追溯用户原始陈述）
12
    valid_from         # 记忆生效时间
13
    valid_until        # 记忆失效时间（supersede 时自动关闭）
14
    entity             # 实体名（如 NAS、GPU、OS）
15
    field              # 属性名（如 ip、model、system）
16
    scope              # 范围隔离（如 main_pc、laptop）
17
    relation           # 实体关系（如 located_at）
18
    target             # 关系目标（如 home_network）
19
    relation_confidence
20
    identity_status    # ACTIVE / CONFIRMED / CHANGED / ARCHIVED
21
    usage_count        # 被引用次数（影响 retention）
22
    change_reason      # 变更原因
23
    supersedes         # 前任 memory_id
24
    superseded_by      # 继任者
25
    conflict_with      # 冲突条目

1
用户输入
2
  ↓
3
Assertion Parser（解析断言类型）
4
  ├── CONFIRMED    → 明确事实
5
  ├── HYPOTHETICAL → 假设，不写入
6
  ├── UNCERTAIN    → 可能/应该/觉得
7
  ├── RECALL       → 我记得
8
  ├── QUERY        → 提问，不产生 memory
9
  └── REFERENCE    → 保持，不改变
10
  ↓
11
Intent Detection（是否为更新意图）
12
  ↓
13
Authority Check（权限检查）
14
  ├── IDENTITY 保护：非 user 权限不可修改
15
  └── authority_gate 评分门控
16
  ↓
17
Conflict Detection（冲突检测）
18
  ├── scope 隔离：main_pc vs laptop 不冲突
19
  ├── score 比较：新分数 > 旧分数才允许覆盖
20
  └── 权限门控：agent 永远无法超越 user
21
  ↓
22
Decision（决策）
23
  ├── supersede        → 新值替代旧值，保留历史链
24
  ├── supersede_frozen → 用户确认覆盖 FROZEN
25
  ├── flag_conflict    → 保留双方，请求用户确认
26
  ├── reject           → 拒绝写入
27
  └── no_op            → 无操作
28
  ↓
29
Memory Write（写入）
30
  ├── provenance 自动传播（继承旧链 + 追加新条目）
31
  ├── memory_layer/scope/entity 继承
32
  └── valid_until 自动关闭旧版本

1
class MemoryQueryPlanner:
2
    # 检测查询意图
3
    intents = {
4
        "WHOAMI":      "我是/我的"       → IDENTITY 层权重提升
5
        "HOWTO":       "怎么/如何/安装"   → PROCEDURAL 层权重提升
6
        "FACT_LOOKUP": "是什么/是多少"    → SEMANTIC 层权重提升
7
        "DIAGNOSE":    "为什么/报错/失败" → EPISODIC 层权重提升
8
        "TEMPORAL":    "什么时候/历史/之前" → EPISODIC 层权重提升
9
    }
10

11
    # 检索评分
12
    retrieval_score = (
13
        0.35 × keyword_match
14
      + 0.25 × authority
15
      + 0.15 × freshness
16
      + 0.15 × scope_match
17
      + 0.10 × layer_priority
18
    )
19

20
    # Token 预算控制
21
    budget = {
22
        IDENTITY: 1000, SEMANTIC: 3000,
23
        PROCEDURAL: 2000, EPISODIC: 1000, TEMPORARY: 500
24
    }
25
    # 按意图动态调整