告别 AI “金鱼记忆”！OpenViking 如何让你的 Agent 过目不忘？

你：“你好！我是小明，一个 Python 程序员，喜欢简洁的代码！”
AI：“好的，小明！很高兴认识你！”

... 5 分钟后，新的会话开始 ...

你：“你好！你还记得我吗？”
AI：“…… 您是？”

viking://
├── 🎬 session/alice-chat-001/    # 临时客厅，聊天用
├── 👤 user/alice/              # 小明的私人卧室
│   └── memories/              # 小明的储物柜
│       ├── profile.md         # 个人档案（永远最新！）
│       ├── preferences/       # 喜好库
│       ├── entities/          # 重要的人和事
│       └── events/            # 重要事件
└── 🤖 agent/my-assistant/      # 助手的书房
    └── memories/              # 助手的学习笔记
        ├── cases/            # 案例库
        └── patterns/         # 经验库

你进来聊天 → 留下一地瓜子皮（消息）→ 客厅满了
                          ↓
                       扫！地！
                          ↓
                    两阶段处理大法！

session.commit()

# 内部在做什么？
# └─ 咔嚓！把这堆聊天记录塞到 history/archive_001/ 文件夹
# └─ 立刻告诉你：好的，记录上了！

后台小哥：让我慢慢看看... 哦！小明喜欢简洁代码！
          ↓
   写进 user/alice/memories/preferences/coding.md
          ↓
   向量索引更新！下次能搜索到！

viking://session/my-chat-session/
│
├── .meta.json    📋  客厅登记表
│   ├── 创建者：小明
│   ├── 参与人：小明 + 小红
│   └── 累计谈话次数：100次！
│
├── messages.jsonl  📝 实时对话记录
│
└── history/        🗃️ 聊天档案馆
    ├── archive_001/
    │   ├── messages.jsonl
    │   ├── .abstract.md  一句话总结
    │   ├── .overview.md  详细概述
    │   └── .done         ✓ 已完成标记
    └── archive_002/

{
  "session_id": "聊天的ID",
"created_at": "什么时候开始的",
"updated_at": "最后一句话是什么时候",
"created_by_user_id": "谁开的这个房间",
"participant_user_ids": ["谁进来过"],
"participant_agent_ids": ["有什么助手进来过"],
"message_count": 10,
"commit_count": 5,
"memories_extracted": {
    "profile": 1,
    "preferences": 2,
    "total": 10
  },
"llm_token_usage": {
    "total_tokens": 20000
  }
}

用户说了一堆话 → 📥 进入 MemoryExtractor 工厂
                      ↓
            🤖  LLM 开始分析：哦！小明说他是Python专家！
                      ↓
            📦  打成候选记忆包
                      ↓
            🎯  MemoryDeduplicator 判断：和以前的记忆冲突吗？
                      ↓
            ✍️  VikingFS 写入：写入对应的目录！
                      ↓
            📊  VectorDB 更新：向量索引加上！下次能搜索！

# 偏好：简洁代码

## Summary (L0)
小明不喜欢过度设计，喜欢简洁代码

## Overview (L1)
- 每次写代码都强调简洁
- 讨厌装饰器滥用
- 喜欢函数式编程

## Content (L2)
小明说过 N次，他喜欢 Python的简洁，他的项目都是...

def is_accessible(uri: str):
    if 你是 Root 管理员：
        return True  # 随便看！

    if uri 是 public 资源或 session：
        return True  # 共享的东西

    if uri 是小明的 user/：
        return False  # 你敢进试试？

import openviking as ov
import time

# 1️⃣ 开门！
client = ov.SyncHTTPClient(url="http://localhost:1933")
client.initialize()

# 2️⃣ 小明进入客厅！开始聊天！
session = client.create_session()
session_id = session["session_id"]
print("👋 小明开了个新 session！", session_id)

# 3️⃣ 对话！说话！
dialogues = [
    {"role": "user", "content": "你好！我是小明，Python 程序员！"},
    {"role": "assistant", "content": "你好小明！"},
    {"role": "user", "content": "我喜欢简洁的代码风格！"},
    {"role": "assistant", "content": "没问题，记住了！"},
]

for message in dialogues:
    client.add_session_message(session_id, message["role"], message["content"])

# 4️⃣ 打扫卫生！commit 一下！
print("\n🗄️ 小明说：存档！")
commit_result = client.commit_session(session_id)
task_id = commit_result["task_id"]
print(f"⏳ 后台任务：{task_id}")

# 5️⃣ 等后台慢慢消化...
whileTrue:
    task_result = client.get_task(task_id)
    print(f"⏱️ 任务状态：{task_result['status']}")
    if task_result["status"] in ["completed", "failed"]:
        break
    time.sleep(1)

# 6️⃣ 看看记住了什么！
print("\n✅ 完成！来看看记住什么了！")
session_info = client.get_session(session_id)
print("记忆统计：", session_info["memories_extracted"])

# 7️⃣ 下次聊天...
print("\n🌅 第二天... 小明又来了！")
new_session = client.create_session()
print("新的会话已经自动检索并注入了小明的记忆！")