---
template: sheet
theme: shadcn
title: Hy-Memory 1.0 还是 2.0
subtitle: 上游已到 2.0.8，本机停在 1.2.21 —— 拿生产库副本实测后的结论
source: PyPI / GitHub / 本机隔离库验证 2026-10-29
cols: 2
---

Lead: 上游 2.0.8 于 10-28 发布。你的 1.2.21 停在 07-22，已三个月无维护。
我把生产记忆库拷了一份，在隔离端口用 2.0.8 跑通检索与写入。结论是可以切，但要带补丁清单切。

## A 结论

```callout warn 一句话
2.0 适合你，1.0 已经走到尽头。
理由不是新功能，是维护线：1.x 三个多月零发布。
兼容性我用生产库副本实测过，不是看文档推断。
```

```kv cols=2
本机 SDK: hy-memory 1.2.21
本机封装插件: hermes-hy-memory 0.2.8
上游最新: hy-memory 2.0.8
1.x 最后发布: 2026-07-22
记忆条数: 2058
本机模式: pro + chroma
提炼模型: 硅基 Xing4.0-29B
建议: 备份后切 2.0.8
```

## B 1.0 与 2.0 差在哪

| 维度 | 1.0（1.2.21） | 2.0（2.0.8） | 对你影响 |
|---|---|---|---|
| 架构定位 | DCPM 双层认知记忆 | 双系统 + 工作记忆 + 代码记忆 | 新场景你用不上 |
| 记忆分层 | L1/L2/L4/L7 | 同左，另加 governed 版本链 | 存量数据无损 |
| 检索 | legacy 读取管线 | 新增 hybrid v2 / BM25 / MMR | 需显式开开关 |
| 配置透传 | extra_body 靠本地补丁 | extra_headers/extra_body 上游内置 | 少打一个补丁 |
| 日志 | 会话原文进 INFO | 原文降到 DEBUG，可关 JSONL | 日志更干净 |
| 时间序 | 旧记忆可覆盖新记忆 | reconcile 按 memory_at 强制时序 | 事实更新更可靠 |
| 维护状态 | 冻结 | 12 天内 8 个版本 | 只能跟 2.0 |

## C 实测兼容结果（隔离库副本，10-29）

| 验证项 | 结果 | 证据 |
|---|---|---|
| 打开生产库副本 | ok | 2058 条向量，冷启 103 MB |
| 语义检索 | ok | 3 命中，0.3 s，返回 memories 三段结构 |
| 写入链路 | ok | 13.5 s，ops.add=6，成功写库 |
| 写入后内存 | warn | 205 MB → 242 MB，与 1.2.21 同量级 |
| 封装插件载荷 | ok | text/messages 与 memories 字段都对得上 |
| HTTP 接口 | ok | 8 个 /api/v1 端点齐全 |
| 提炼模型 | ok | 硅基 Xing4.0-29B 直接可用，无需补丁 |

## D 切换要补的洞

| 本地补丁 | 2.0.8 状态 | 动作 |
|---|---|---|
| LLM extra_headers / extra_body | 上游已内置 | 撤销 |
| ThreadPoolExecutor 256 降到 32 | 仍是 256 | 重打 |
| 提炼历史 0 轮（`or 5` 老 bug） | bug 仍在 | 重打 |
| embed 缓存改 array('f') | 仍存 list[float] | 重打，可选 |
| AsyncOpenAI 未关 / healthz 泄露 | embed_service 已重写 | 需重验，不能照搬 |
| search_query 透传 | 待核 | 切前核实 |

```callout err 现在就有个坑
封装插件的 ensure_venv 跑的是 pip install --upgrade hy-memory，不带版本号。
server 一挂，随手跑一次 doctor 就会静默升到 2.0.8，并冲掉全部本地补丁。
```

```callout info 建议的切换顺序
备份 db 与运行 venv，留 1.2.21 回滚包。
重打上面三个必要补丁，隔离副本复验一轮。
切生产，看 24 小时写入与内存曲线再收尾。
```