docs(memory): 修正三处仍把已删 CAS 当活的注释

9f7d91c2 删掉了 media.Store,但有三处注释还在说"向量存在 media.Store 里"、
"直接用于 media.Store 的稠密余弦检索"——留着会让读者以为那个包还在。

- internal/memory/vector/store.go:多模态稠密空间现用于**媒体块自带向量**的
  余弦召回,不再经 media.Store。
- internal/knowledge/knowledge.go:MediaRef 注释澄清字节作为条目自带数据
  落在条目目录的 File 上(Digest 只是内容派生身份,同内存无第二份)。
- internal/memory/migrate_blockdata.go:resolver 由调用方提供(迁移命令直读
  旧 CAS 冻结布局),sha256 校验也在那一侧做,不在这里重复。

纯注释,无行为变更。全仓生产编译 GREEN;memory/knowledge/vector 包测试通过。
This commit is contained in:
JianFeeeee
2026-10-12 16:55:40 +08:00
parent c620694084
commit 937164e515
3 changed files with 10 additions and 12 deletions

View File

@ -36,13 +36,10 @@ type Knowledge struct {
Media []MediaRef `json:"-"`
}
// MediaRef 是媒体在知识条目里的一等引用。Digest 是内容 sha256(媒体存储的
// 主键),向量不在这里——它存在 media.Store 里(同一份媒体可能被多条知识
// 引用,向量只算一次、只存一份)。
//
// 与 memory/media 的 Item 刻意不共用:那边是媒体存储的内务结构(含
// OriginPath/FirstSeen 等溯源字段),这里是知识条目对外暴露的引用。
// 知识库只依赖 digest + MIME 就能完成嵌入与检索。
// MediaRef 是媒体在知识条目里的一等引用。Digest 是内容派生的媒体身份
// (与记忆块的 `MediaBlockID` 同构:同内容⇒同 Digest),但**字节不在别处**:
// 字节作为条目自带数据落在条目目录的 `File` 上(与 content.md 并列,随条目生灭)。
// 向量不入侧车——它随条目在内存/稠密缓存里按需算。
//
// 命名为 KnowledgeMediaRef 而非 MediaRef,是为了不与别的包的类型撞名。
type KnowledgeMediaRef struct {